potodo

Python Build status Contributions welcome PyPI

What is it ?

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 example

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

Development setup

Create a virtual environment

python3 -m venv venv

Activate it

source venv/bin/activate

Install the dev requirements

pip install -r requirements-dev.txt

Install the pre-commit hook

pre-commit install

Install potodo in a development version

pip install -e .

Release History

v0.21.0
- A nice new README
v0.20.0
- New exclude behavior with gitignore style matching !
v0.19.2
- Dropped cache_args to simplify cache functionality
v0.19.1
- Fixed a bug of division by 0
- Replaced Travis-ci tests with github actions
v0.19.0
- Fixed windows support
v0.17.3
- Fixed a math error where the completion %age of a folder was wrong
- Fixes on the .potodoignore file
v0.17.0
- Added tests
- Fixed bug where github would rate limit your IP address
- Fixed argument errors
- Added -l --matching-files Which will print the path of files matching your arguments
v0.16.0
- Args passed to potodo are now cached as well ! This allows for a better control of what is cached !
- The ignore file now works as the .gitignore does. Add a venv/ in your .potodoignore for example :)
v0.15.0
- Potodo now supports .potodoignore files ! You can finally ignore the venv you made 🎉
v0.14.3
- Added cache versioning to avoid errors when cache changes, for example if files are moved between potodo versions.
v0.14.2
- Nothing new, just code moved around ! Thanks for sticking around 🎉
v0.14.1
- Added --only-reserved option to display only reserved filed
- Added --reserved-dates to display when a file was reserved
- Added cache to cache pofiles to speedup the reading process
- Added logging for verbosity
- Added interactive option with --interactive
- Added contributors in the readme
< v0.14.1
- Base version

Contributing

Fork it (https://github.com/afpy/potdo/fork)
Create your feature branch (git checkout -b feature/fooBar

/!\ Don't forget to bump the version in potodo/__init__.py when you're pushing your changes to your branch

Commit your changes (git commit -am 'Add some fooBar')
Push to the branch (git push origin feature/fooBar)
Create a new Pull Request

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.21.2

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.21.2
File	Size	Uploaded
potodo-0.21.2.tar.gz	27.3 kB	Apr 12, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for potodo 0.21.2
File	Interpreter	ABI	Platform	Reset
potodo-0.21.2-py3-none-any.whl 16.2 kB Apr 12, 2022	Python 3	none	any	Details

Total release size: 43.5 kB

Release files / potodo-0.21.2.tar.gz

Download URL	potodo-0.21.2.tar.gz
Size	27.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`2e0ccdcffed5affbdc1e737a4a6648049a48ba500e61dad86ba7e7404e6398d7`
BLAKE2b-256 checksum How to use checksums	`feb2d9e92cc830056c0a63d24765396d581845075dee01001b7e4a17c1390129`
Upload date	Apr 12, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.6.0 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.63.0 CPython/3.9.12`

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

Download URL	potodo-0.21.2-py3-none-any.whl
Size	16.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5d6ae85dcb80468c0d953152b19315e76dcb7cfb8692254abb9a024e9af2b97c`
BLAKE2b-256 checksum How to use checksums	`70091e6559d3f856e86898eb26f2c80741298750de3b5bf725b1bb333b80bb5e`
Upload date	Apr 12, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.6.0 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.63.0 CPython/3.9.12`