perceval-pontoon
Perceval backend for Pontoon.
Backends
The backend currently managed by this package support the next repository:
- Pontoon
Requirements
- Python >= 3.10
You will also need some other libraries for running the tool, you can find the whole list of dependencies in pyproject.toml file.
Installation
There are several ways to install perceval-pontoon on your system: packages or source code using Poetry or pip.
PyPI
perceval-pontoon can be installed using pip, a tool for installing Python packages. To do it, run the next command:
$ pip install perceval-pontoon
Source code
To install from the source code you will need to clone the repository first:
$ git clone https://github.com/bitergia-analytics/grimoirelab-perceval-pontoon
$ cd grimoirelab-perceval-pontoon
Then use pip or Poetry to install the package along with its dependencies.
Pip
To install the package from local directory run the following command:
$ pip install .
In case you are a developer, you should install perceval-pontoon in editable mode:
$ pip install -e .
Poetry
We use poetry for dependency management and packaging. You can install it following its documentation. Once you have installed it, you can install perceval-pontoon and the dependencies in a project isolated environment using:
$ poetry install
To spaw a new shell within the virtual environment use:
$ poetry shell
Example
Pontoon
Translations
To download the entities and translations provided by users from a Pontoon backend you need the URL of the server and the locales you want to obtain.
Run perceval with the Pontoon URL and the locale to fetch the entities and translations. For example:
$ perceval pontoon "https://pontoon.example.com" es
You can also specify from what date you want to obtain the translation suggestion
with --from-date and --to-date.
Locales
To obtain the list of locales available in a server, run Perceval in the following way:
$ perceval pontoon "https://pontoon.example.com" --category locale
Users actions
To obtain the actions performed by users on a Pontoon server, you need
the server's URL, a project and the sessionid cookie. To get the sessionid
cookie, log in to the Pontoon server. Then, open the browser's developer tools
and copy the sessionid cookie from the cookies store or the network requests.
Run perceval with the Pontoon URL, a project and the sessionid cookie to fetch
the actions performed by users. It is also recommended to include a from_date
parameter. For example:
$ perceval pontoon "https://pontoon.example.com" --category action \
--project amo --session-id <session_id> --from-date 2022-01-01
License
Licensed under GNU General Public License (GPL), version 3 or later.
1 maintainer
Metadata
1 maintainer
Release files for perceval-pontoon 0.3.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| perceval_pontoon-0.3.10.tar.gz | 28.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| perceval_pontoon-0.3.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.3 kB
Release files / perceval_pontoon-0.3.10.tar.gz
| Download URL | perceval_pontoon-0.3.10.tar.gz |
|---|---|
| Size | 28.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a132f0aedb59a8404b9ef7ceb902b6a9cf6aedc435438645c11db6da2a90355
|
|
BLAKE2b-256 checksum How to use checksums |
95d161ee08805f7cfb7cb31381db49769533a40b1ecc0d161fec015521035747
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1018-azure
|
Release files / perceval_pontoon-0.3.10-py3-none-any.whl
| Download URL | perceval_pontoon-0.3.10-py3-none-any.whl |
|---|---|
| Size | 19.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d0397fa34d2d008fa9f9a6def712dd38b94d6a4014bde0847c18ca5399a2559b
|
|
BLAKE2b-256 checksum How to use checksums |
7431b62dffecefb261cbd6a28da15b6b1b619d30942332777394256e78288b40
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1018-azure
|
