kallithea Changeset - 451b3f9d814e

Changeset - 451b3f9d814e

Parent rev.

Child rev.

[Not reviewed]

default

0 4 0

Mads Kiilerich - 7 years ago 2018-10-29 01:07:15
mads@kiilerich.com

docs: update i18n doc after TG migration changed lang to i18n.lang and test.ini is generated

These descriptions are not elegant, but now we make them less wrong.

4 files changed with 8 insertions and 11 deletions:

docs/contributing.rst

kallithea/i18n/how_to

kallithea/tests/conftest.py

scripts/generate-ini.py

0 comments (0 inline, 0 general)

docs/contributing.rst

➞

Show inline comments

@@ @@ -90,31 +90,32 @@ by invoking ``py.test`` from the project @@
     py.test
 Note that testing on Python 2.6 also requires ``unittest2``.
 Note that on unix systems, the temporary directory (``/tmp`` or where
 ``$TMPDIR`` points) must allow executable files; Git hooks must be executable,
 and the test suite creates repositories in the temporary directory. Linux
 systems with /tmp mounted noexec will thus fail.
 You can also use ``tox`` to run the tests with all supported Python versions
 (currently Python 2.6--2.7).
 When running tests, Kallithea uses `kallithea/tests/test.ini` and populates the
 SQLite database specified there.
 When running tests, Kallithea generates a `test.ini` based on template values
 in `kallithea/tests/conftest.py` and populates the SQLite database specified
 there.
 It is possible to avoid recreating the full test database on each invocation of
 the tests, thus eliminating the initial delay. To achieve this, run the tests as::
-    gearbox serve -c kallithea/tests/test.ini --pid-file=test.pid --daemon
+    gearbox serve -c /tmp/kallithea-test-XXX/test.ini --pid-file=test.pid --daemon
     KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 py.test
     kill -9 $(cat test.pid)
 In these commands, the following variables are used::
     KALLITHEA_WHOOSH_TEST_DISABLE=1 - skip whoosh index building and tests
     KALLITHEA_NO_TMP_PATH=1 - disable new temp path for tests, used mostly for testing_vcs_operations
 You can run individual tests by specifying their path as argument to py.test.
 py.test also has many more options, see `py.test -h`. Some useful options
 are::

kallithea/i18n/how_to

➞

Show inline comments

@@ @@ -79,22 +79,19 @@ Extract the latest versions of strings f @@
 Update the PO file by doing::
     python2 setup.py update_catalog -l <new_language_code>
 Edit the new updated translation file. Repeat all steps after `init_catalog` step from
 new translation instructions
 Testing translations
 --------------------
 Edit kallithea/tests/test.ini file and set lang attribute to::
     lang=<new_language_code>
 Run Kallithea tests by executing::
 Edit `kallithea/tests/conftest.py` and set `i18n.lang` to `<new_language_code>`
 and run Kallithea tests by executing::
     py.test
 .. _Weblate: http://weblate.org/

kallithea/tests/conftest.py

➞

Show inline comments

@@ @@ -37,24 +37,25 @@ def pytest_configure(): @@
     # Disable INFO logging of test database creation, restore with NOTSET
     logging.disable(logging.INFO)
     ini_settings = {
         '[server:main]': {
             'port': '4999',
         },
         '[app:main]': {
             'app_instance_uuid': 'test',
             'show_revision_number': 'true',
             'beaker.cache.sql_cache_short.expire': '1',
             'beaker.session.secret': '{74e0cd75-b339-478b-b129-07dd221def1f}',
             #'i18n.lang': '',
         },
         '[handler_console]': {
             'formatter': 'color_formatter',
         },
         # The 'handler_console_sql' block is very similar to the one in
         # development.ini, but without the explicit 'level=DEBUG' setting:
         # it causes duplicate sqlalchemy debug logs, one through
         # handler_console_sql and another through another path.
         '[handler_console_sql]': {
             'formatter': 'color_formatter_sql',
         },
+    }

scripts/generate-ini.py

➞

Show inline comments

 #!/usr/bin/env python2
 """
 Based on kallithea/lib/paster_commands/template.ini.mako, generate
   development.ini
   kallithea/tests/test.ini
 Based on kallithea/lib/paster_commands/template.ini.mako, generate development.ini
 """
 import re
 from kallithea.lib import inifile
 # files to be generated from the mako template
 ini_files = [
     ('development.ini',
+        {
             '[server:main]': {
                 'host': '0.0.0.0',

0 comments (0 inline, 0 general)