padpo/README.md
2020-08-25 17:49:55 +02:00

119 lines
3.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# padpo
[![PyPI](https://img.shields.io/pypi/v/padpo.svg)](https://pypi.python.org/pypi/padpo)
[![PyPI](https://img.shields.io/pypi/l/padpo.svg)](https://github.com/vpoulailleau/padpo/blob/master/LICENSE)
[![Travis](https://api.travis-ci.com/vpoulailleau/padpo.svg?branch=master)](https://travis-ci.com/vpoulailleau/padpo)
[![Code style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
[![Downloads](https://pepy.tech/badge/padpo)](https://pepy.tech/project/padpo)
[![Test Coverage](https://api.codeclimate.com/v1/badges/ab4759d5dc9cc7ea915e/test_coverage)](https://codeclimate.com/github/vpoulailleau/padpo/test_coverage)
[![Maintainability](https://api.codeclimate.com/v1/badges/ab4759d5dc9cc7ea915e/maintainability)](https://codeclimate.com/github/vpoulailleau/padpo/maintainability)
Linter for gettext files (*.po)
Created to help the translation of official Python docs in French: https://github.com/python/python-docs-fr
Il faut demander aux traducteurs s'ils n'ont pas de pot quand ils traduisent, maintenant ils ont `padpo`
:smile: :laughing: :stuck_out_tongue_winking_eye: :joy: (note : il était tard le soir quand j'ai trouvé le nom).
**WORK IN PROGRESS**
## License
BSD 3-clause
Pull request are welcome.
## Usage
Using the *activated virtual environment* created during the installation:
For a local input file:
```bash
padpo --input-path a_file.po
```
or for a local input directory:
```bash
padpo --input-path a_directory_containing_po_files
```
or for a pull request in python-docs-fr repository (here pull request #978)
```bash
padpo --python-docs-fr 978
```
or for a pull request in a GitHub repository (here python/python-docs-fr/pull/978)
```bash
padpo --github python/python-docs-fr/pull/978
```
![Screenshot](screenshot.png)
### Color
By default, the output is colorless, and formatted like GCC messages. You can use `-c`
or `--color` option to get a colored output.
## Installation
### Automatic installation
```bash
pip install padpo
```
### Manual installation
1. Install dependencies
```bash
poetry install
```
Note: this uses `poetry` that you can get here: https://poetry.eustace.io/docs/
2. Use virtual environment$
```bash
poetry shell
```
## Update on PyPI
`./deliver.sh`
## Changelog
### v0.8.0 (2020-08-25)
* use [`pygrammalecte`](https://github.com/vpoulailleau/pygrammalecte)
* add continuous integration
* fix #12, #13, #14, #15, #17, #18, #20
* add `--color` CLI option to get a colored output (default is colorless)
### v0.7.0 (2019-12-11)
* add `--version` CLI option to display the current version of `padpo`
* `--input-path` CLI option now accepts several paths as in
`padpo --input-path file1.po file2.po directory1 directory2` or
`padpo -i file1.po file2.po directory1 directory2`
### v0.6.0 (2019-12-9)
* check errors against defined glossaries
### v0.5.0 (2019-12-3)
* check spelling errors with grammalecte
* tag releases!
### v0.4.0 (2019-12-2)
* use poetry: https://poetry.eustace.io/docs/
* add some tests with tox and pytests
* fix some false positive issues with grammalecte