comparison docs/installation_win_old.rst @ 6554:2c3d30095d5e

gearbox: replace paster with something TurboGears2-ish that still works with the Pylons stack This is a step towards moving away from the Pylons stack to TurboGears2, but still independent of it. Some notes from the porting - it could perhaps be the missing(?) documentation for migrating from paster to gearbox: Note: 'gearbox' without parameters will crash - specify '-h' to get started testing. Replace paster summary = 'yada yada' with the first line of the docstring of the Command class ... or override get_description. Note: All newlines in the docstring will be collapsed and mangle the long help text. Grouping of commands is not possible. Standard commands (for development) can't be customized under the same name or hidden. (Like for paster, the conceptual model also assumes that the sub-command naming is namespaced so commands from other packages won't conflict.) The usage help is fully automated from the declared options. For all deprecated Commands, replace paster hidden = True with gearbox deprecated = True Note: config_file, takes_config_file, min_args and max_args are not available / relevant. The gearbox parser is customized by overriding get_parser - there is nothing like paster update_parser. Gearbox is using argparse instead of optparse ... but argparse add_argument is mostly backwards compatible with optparse add_option. Instead of overriding command or run as in paster, override take_action in gearbox. The parsed arguments are passed to take_action, not available on the command instance. Paster BadCommand is not available and must be handled manually, terminating with sys.exit(1). There is no standard make-config command in gearbox. Paster appinstall has been replaced by the somewhat different setup_app module in gearbox. There is still no clean way to pass parameters to SetupAppCommand and it relies on websetup and other apparently unnecessary complexity. Instead, implement setup-db from scratch. Minor change by Thomas De Schampheleire: add gearbox logging configuration. Because we use logging.config.fileConfig(.inifile) during gearbox command execution, the logging settings need to be correct and contain a block for gearbox logging itself. Otherwise, errors in command processing are not even visible and the command exits silently.
author Mads Kiilerich <madski@unity3d.com>
date Tue, 25 Oct 2016 21:32:24 +0200
parents 8075ec3d0233
children 213085032127
comparison
equal deleted inserted replaced
6553:e9ac5698281d 6554:2c3d30095d5e
202 You have to use the same Visual Studio 2008 command prompt as Step7, so 202 You have to use the same Visual Studio 2008 command prompt as Step7, so
203 if you closed it reopen it following the same commands (including the 203 if you closed it reopen it following the same commands (including the
204 "activate" one). When ready, just type:: 204 "activate" one). When ready, just type::
205 205
206 cd C:\Kallithea\Bin 206 cd C:\Kallithea\Bin
207 paster make-config Kallithea production.ini 207 TODO make-config Kallithea production.ini
208 208
209 Then, you must edit production.ini to fit your needs (network address and 209 Then, you must edit production.ini to fit your needs (network address and
210 port, mail settings, database, whatever). I recommend using NotePad++ 210 port, mail settings, database, whatever). I recommend using NotePad++
211 (free) or similar text editor, as it handles well the EndOfLine 211 (free) or similar text editor, as it handles well the EndOfLine
212 character differences between Unix and Windows 212 character differences between Unix and Windows
213 (http://notepad-plus-plus.org/) 213 (http://notepad-plus-plus.org/)
214 214
215 For the sake of simplicity lets run it with the default settings. After 215 For the sake of simplicity lets run it with the default settings. After
216 your edits (if any), in the previous Command Prompt, type:: 216 your edits (if any), in the previous Command Prompt, type::
217 217
218 paster setup-db production.ini 218 gearbox setup-db -c production.ini
219 219
220 .. warning:: This time a *new* database will be installed. You must 220 .. warning:: This time a *new* database will be installed. You must
221 follow a different process to later :ref:`upgrade <upgrade>` 221 follow a different process to later :ref:`upgrade <upgrade>`
222 to a newer Kallithea version. 222 to a newer Kallithea version.
223 223
237 ^^^^^^^^^^^^^^^^^^^^^^^^^^^ 237 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
238 238
239 In the previous command prompt, being in the C:\\Kallithea\\Bin folder, 239 In the previous command prompt, being in the C:\\Kallithea\\Bin folder,
240 just type:: 240 just type::
241 241
242 paster serve production.ini 242 gearbox serve -c production.ini
243 243
244 Open yout web server, and go to http://127.0.0.1:5000 244 Open yout web server, and go to http://127.0.0.1:5000
245 245
246 It works!! :-) 246 It works!! :-)
247 247