Show More
@@ -49,10 +49,10 b' Running tests' | |||||
49 | After finishing your changes make sure all tests pass cleanly. You can run |
|
49 | After finishing your changes make sure all tests pass cleanly. You can run | |
50 | the testsuite running ``nosetest`` from the project root, or if you use tox |
|
50 | the testsuite running ``nosetest`` from the project root, or if you use tox | |
51 | run tox for python2.6-2.7 with multiple database test. When using `nosetests` |
|
51 | run tox for python2.6-2.7 with multiple database test. When using `nosetests` | |
52 |
test.ini file is used and by default it uses |
|
52 | test.ini file is used and by default it uses SQLite for tests, edit this file | |
53 | to change your testing enviroment. |
|
53 | to change your testing enviroment. | |
54 |
|
54 | |||
55 |
There's a special set of tests for push/pull operations, you can run |
|
55 | There's a special set of tests for push/pull operations, you can run them using:: | |
56 |
|
56 | |||
57 | paster serve test.ini --pid-file=test.pid --daemon |
|
57 | paster serve test.ini --pid-file=test.pid --daemon | |
58 | KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests -x kallithea/tests/other/test_vcs_operations.py |
|
58 | KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests -x kallithea/tests/other/test_vcs_operations.py |
@@ -114,7 +114,7 b' Upgrading Kallithea from Python Package ' | |||||
114 | backed up to ``my.ini.0-1``.) |
|
114 | backed up to ``my.ini.0-1``.) | |
115 |
|
115 | |||
116 |
|
116 | |||
117 |
If using a |
|
117 | If using a SQLite database, stop the Kallithea process/daemon/service, and | |
118 | then make a copy of the database file:: |
|
118 | then make a copy of the database file:: | |
119 |
|
119 | |||
120 | service kallithea stop |
|
120 | service kallithea stop |
@@ -20,10 +20,10 b' following command to do this::' | |||||
20 |
|
20 | |||
21 |
|
21 | |||
22 | Next, you need to create the databases used by Kallithea. It is recommended to |
|
22 | Next, you need to create the databases used by Kallithea. It is recommended to | |
23 |
use |
|
23 | use PostgreSQL or SQLite (default). If you choose a database other than the | |
24 |
default ensure you properly adjust the d |
|
24 | default ensure you properly adjust the database URL in your my.ini | |
25 | configuration file to use this other database. Kallithea currently supports |
|
25 | configuration file to use this other database. Kallithea currently supports | |
26 |
|
|
26 | PostgreSQL, SQLite and MySQL databases. Create the database by running | |
27 | the following command:: |
|
27 | the following command:: | |
28 |
|
28 | |||
29 | paster setup-db my.ini |
|
29 | paster setup-db my.ini | |
@@ -42,10 +42,10 b' setup process can be fully automated, ex' | |||||
42 | - The ``setup-db`` command will create all of the needed tables and an |
|
42 | - The ``setup-db`` command will create all of the needed tables and an | |
43 | admin account. When choosing a root path you can either use a new empty |
|
43 | admin account. When choosing a root path you can either use a new empty | |
44 | location, or a location which already contains existing repositories. If you |
|
44 | location, or a location which already contains existing repositories. If you | |
45 |
choose a location which contains existing repositories Kallithea will |
|
45 | choose a location which contains existing repositories Kallithea will | |
46 |
add all of the repositories at the chosen location to it |
|
46 | add all of the repositories at the chosen location to its database. | |
47 | (Note: make sure you specify the correct path to the root). |
|
47 | (Note: make sure you specify the correct path to the root). | |
48 |
- Note: the given path for |
|
48 | - Note: the given path for Mercurial_ repositories **must** be write accessible | |
49 | for the application. It's very important since the Kallithea web interface |
|
49 | for the application. It's very important since the Kallithea web interface | |
50 | will work without write access, but when trying to do a push it will |
|
50 | will work without write access, but when trying to do a push it will | |
51 | eventually fail with permission denied errors unless it has write access. |
|
51 | eventually fail with permission denied errors unless it has write access. | |
@@ -72,7 +72,7 b' functionality. To do this simply execute' | |||||
72 | This will create `rcextensions` package in the same place that your `ini` file |
|
72 | This will create `rcextensions` package in the same place that your `ini` file | |
73 | lives. With `rcextensions` it's possible to add additional mapping for whoosh, |
|
73 | lives. With `rcextensions` it's possible to add additional mapping for whoosh, | |
74 | stats and add additional code into the push/pull/create/delete repo hooks. |
|
74 | stats and add additional code into the push/pull/create/delete repo hooks. | |
75 |
For example for sending signals to build-bots such as |
|
75 | For example for sending signals to build-bots such as Jenkins. | |
76 | Please see the `__init__.py` file inside `rcextensions` package |
|
76 | Please see the `__init__.py` file inside `rcextensions` package | |
77 | for more details. |
|
77 | for more details. | |
78 |
|
78 | |||
@@ -83,7 +83,7 b' Using Kallithea with SSH' | |||||
83 | Kallithea currently only hosts repositories using http and https. (The addition |
|
83 | Kallithea currently only hosts repositories using http and https. (The addition | |
84 | of ssh hosting is a planned future feature.) However you can easily use ssh in |
|
84 | of ssh hosting is a planned future feature.) However you can easily use ssh in | |
85 | parallel with Kallithea. (Repository access via ssh is a standard "out of |
|
85 | parallel with Kallithea. (Repository access via ssh is a standard "out of | |
86 |
the box" feature of |
|
86 | the box" feature of Mercurial_ and you can use this to access any of the | |
87 | repositories that Kallithea is hosting. See PublishingRepositories_) |
|
87 | repositories that Kallithea is hosting. See PublishingRepositories_) | |
88 |
|
88 | |||
89 | Kallithea repository structures are kept in directories with the same name |
|
89 | Kallithea repository structures are kept in directories with the same name | |
@@ -485,7 +485,7 b' can be found at *kallithea.lib.hooks*.' | |||||
485 | Changing default encoding |
|
485 | Changing default encoding | |
486 | ------------------------- |
|
486 | ------------------------- | |
487 |
|
487 | |||
488 |
By default, Kallithea uses |
|
488 | By default, Kallithea uses UTF-8 encoding. | |
489 | It is configurable as `default_encoding` in the .ini file. |
|
489 | It is configurable as `default_encoding` in the .ini file. | |
490 | This affects many parts in Kallithea including user names, filenames, and |
|
490 | This affects many parts in Kallithea including user names, filenames, and | |
491 | encoding of commit messages. In addition Kallithea can detect if `chardet` |
|
491 | encoding of commit messages. In addition Kallithea can detect if `chardet` | |
@@ -756,7 +756,7 b' Some example init.d scripts can be found' | |||||
756 |
|
756 | |||
757 | .. _virtualenv: http://pypi.python.org/pypi/virtualenv |
|
757 | .. _virtualenv: http://pypi.python.org/pypi/virtualenv | |
758 | .. _python: http://www.python.org/ |
|
758 | .. _python: http://www.python.org/ | |
759 |
.. _ |
|
759 | .. _Mercurial: http://mercurial.selenic.com/ | |
760 | .. _celery: http://celeryproject.org/ |
|
760 | .. _celery: http://celeryproject.org/ | |
761 | .. _rabbitmq: http://www.rabbitmq.com/ |
|
761 | .. _rabbitmq: http://www.rabbitmq.com/ | |
762 | .. _python-ldap: http://www.python-ldap.org/ |
|
762 | .. _python-ldap: http://www.python-ldap.org/ |
General Comments 0
You need to be logged in to leave comments.
Login now