Potodo

Build status

PyPI

Potodo, a (almost) flawless TODO/progress listing CLI tool for po files.

Potodo is part of poutils!

Poutils (.po utils) is is a metapackage to easily install usefull Python tools to use with po files and potodo is a part of it! Go check out Poutils to discover the other useful tools for po file related translation!

Installation

pip install potodo

Usage

usage: potodo [-h] [-p path] [-e path [path ...]] [-a X] [-b X] [-f] [-o] [-n] [-c] [-j] [--exclude-fuzzy] [--exclude-reserved] [--only-reserved] [--show-reservation-dates] [--no-cache] [-i] [-l] [--version] [-v]

List and prettify the po files left to translate.

optional arguments:
  -h, --help            show this help message and exit
  -p path, --path path  execute Potodo in path
  -e path [path ...], --exclude path [path ...]
                        exclude from search
  -a X, --above X       list all TODOs above given X% completion
  -b X, --below X       list all TODOs below given X% completion
  -f, --only-fuzzy      print only files marked as fuzzys
  -o, --offline         don't perform any fetching to GitHub/online
  -n, --no-reserved     don't print info about reserved files
  -c, --counts          render list with the count of remaining entries (translate or review) rather than percentage done
  -j, --json            format output as JSON
  --exclude-fuzzy       select only files without fuzzy entries
  --exclude-reserved    select only files that aren't reserved
  --only-reserved       select only only reserved files
  --show-reservation-dates
                        show issue creation dates
  --no-cache            Disables cache (Cache is disabled when files are modified)
  -i, --interactive     Activates the interactive menu
  -l, --matching-files  Suppress normal output; instead print the name of each matching po file from which output would normally have been printed.
  --version             show program's version number and exit
  -v, --verbose         Increases output verbosity

Contributing

You can run the tests using tox locally like:

tox -p auto

before commiting.

A pre-commit hook like:

cat <<EOF > .git/hooks/pre-commit
#!/bin/sh
exec tox -s -p all
EOF

may help.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Julien Palard}
👀 💻

_Antoine
👀 💻

_{Jules Lasne (jlasne)}
👀 💻

_{Christophe Nanteuil}
👀 💻

_{Claire Revillet}
👀 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Metadata

Release files for potodo 0.19.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for potodo 0.19.4
File	Size	Uploaded
potodo-0.19.4.tar.gz	13.9 kB	Jan 28, 2021	Details

Built distribution (wheel)

Table of built distributions (wheels) for potodo 0.19.4
File	Interpreter	ABI	Platform	Reset
potodo-0.19.4-py3-none-any.whl 15.2 kB Jan 28, 2021	Python 3	none	any	Details

Total release size: 29.1 kB

Release files / potodo-0.19.4.tar.gz

Download URL	potodo-0.19.4.tar.gz
Size	13.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`194f029da631790a831cc7121c1e93e5504caf2266abae55bf4c2126ce7daa16`
BLAKE2b-256 checksum How to use checksums	`3a90e7aa0125f48541fc0cf14c649a4e2e9c28d430438b3f9fc58db915c73e06`
Upload date	Jan 28, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / potodo-0.19.4-py3-none-any.whl

Download URL	potodo-0.19.4-py3-none-any.whl
Size	15.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`383a10ec1bd10f0c80dc521852058d2bebc1782921b5a9996211535ab97e7d0c`
BLAKE2b-256 checksum How to use checksums	`30670df8c35d04ee41ca31d428099b33197ef902603d7f9baecf0de4daabcf5b`
Upload date	Jan 28, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`