weblate/docs/contributing/modules.rst
Michal Čihař cc19249d77 docs: use uv as recommended tool to install Weblate
It performs better and comes with virtualenv embedded making it easier
to manage.
2024-10-15 08:43:31 +02:00

40 lines
1 KiB
ReStructuredText

Contributing to Weblate modules
===============================
Besides the main repository, Weblate consists of several Python modules. All
these follow same structure and this documentation covers them all.
For example, this covers:
* `wlc <https://github.com/WeblateOrg/wlc/>`_, Python client library, see :ref:`wlc`
* `translation-finder <https://github.com/WeblateOrg/translation-finder/>`_, used to discover translatable files in the repository
* `language-data <https://github.com/WeblateOrg/language-data/>`_, language definitions for Weblate, see :ref:`languages`
.. include:: snippets/code-guide.rst
Running tests
-------------
The tests are executed using :program:`py.test`. First you need to install test requirements:
.. code-block:: sh
uv pip install -e '.[dev]'
You can then execute the testsuite in the repository checkout:
.. code-block:: sh
py.test
.. seealso::
The CI integration is very similar to :doc:`tests`.
.. include:: snippets/pre-commit.rst
.. seealso::
:doc:`code`