Pytoolbox
Afraid of red status ? Please click on the link, sometimes this is not my fault ;-)
This module is a Toolbox for Python scripts.
Documentation: https://pytoolbox.readthedocs.org
Repository: https://github.com/davidfischer-ch/pytoolbox
This library is tested on Python 3.12 and 3.13. Python 3.11 is supported on a best-effort basis but is no longer part of the CI matrix.
The entire codebase is fully type-hinted (Python 3.10+ syntax). This means you get autocompletion, inline documentation and static analysis out of the box in editors like Sublime Text, VS Code, PyCharm, or any tool supporting PEP 484 (e.g. mypy, pyright).
What the release number stands for ?
I do my best to follow this interesting recommendation : Semantic Versioning 2.0.0
How to install it ?
Install some packages that are not handled by pip:
$ sudo apt install liblzma-dev libxml2-dev libxslt-dev libyaml-dev libz-dev $ sudo apt install ffmpeg git-core python3-dev python3-gi python3-pip screen
If planning to use the imaging extra, especially the exif classes, then you’ll have to install:
$ sudo apt install libcairo2 libcairo2-dev libexiv2-dev libgexiv2-dev libgirepository-2.0-dev
The gir1.2-gexiv2-0.10 should also be installed, maybe its already the case.
You may find useful to read PyGObject’s documentation.
If planning to use the vision feature, then you have to install some requirements for dlib:
$ sudo apt install build-essential cmake pkg-config
See https://learnopencv.com/install-dlib-on-ubuntu/ for an up-to-date procedure.
Make sure that pip is up-to-date (PIPception):
$ source /some/python3/venv/bin/active $ pip install --upgrade pip setuptools wheel
Then, you only need to run setup.py:
$ source /some/python3/venv/bin/activate $ pip install .
How to enable features/modules ?
Example:
$ python setup.py install --help Common commands: (see '--help-commands' for more) setup.py build will build the package underneath 'build/' setup.py install will install the package Global options: --verbose (-v) run verbosely (default) --quiet (-q) run quietly (turns verbosity off) --dry-run (-n) don't actually do anything --help (-h) show detailed help message --no-user-cfg ignore pydistutils.cfg in your home directory Options for 'WithExtra' command: ... --extra-all Install dependencies for All Modules. --extra-atlassian Install dependencies for Atlassian. --extra-aws Install dependencies for AWS. --extra-django Install dependencies for Django. --extra-django-filter Install dependencies for Django Filter. --extra-django-formtools Install dependencies for Django Form Tools. --extra-flask Install dependencies for Flask. --extra-imaging Install dependencies for Imaging. --extra-jinja2 Install dependencies for Jinja2. --extra-mongodb Install dependencies for MongoDB. --extra-network Install dependencies for Networking. --extra-pandas Install dependencies for Pandas. --extra-rest-framework Install dependencies for Django REST Framework. --extra-selenium Install dependencies for Selenium. --extra-smpte2022 Install dependencies for SMPTE-2022. --extra-unittest Install dependencies for Unit Test. --extra-vision Install dependencies for Vision. --extra-voluptuous Install dependencies for Voluptuous. --extra-doc Install dependencies for Pytoolbox Docs. --extra-test Install dependencies for Pytoolbox Tests. usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] or: setup.py --help [cmd1 cmd2 ...] or: setup.py --help-commands or: setup.py cmd --help $ python setup.py install --extra-smpte2022
Another way to do this, with pip:
$ pip install -e .[django,flask,mongo,smpte2022]
How to check coverage ?
$ source /some/python3/venv/bin/activate $ pip install -e .[all,test] $ flake8 pytoolbox $ pytest $ xdg-open htmlcov/index.html
Remarks:
Django 6+ is required for the django and rest_framework extras.
Django and REST framework tests run in CI on Python 3.12+.
How to use it ?
Here is an example hello.py using the cmd function provided by pytoolbox:
$ from pytoolbox.subprocess import cmd
$ print(cmd('echo Hello World!')['stdout'])
How to generate documentation ?
The documentation is generated by Sphinx. In fact most of this documentation is extracted from the docstrings of the code.
Here is the procedure:
$ source /some/python3/venv/bin/activate $ pip install -e .[docs] $ xdg-open docs/build/html/index.html
How to add it to dependencies of my own project ?
Here is an example setup.py for a project called my-cool-project:
from setuptools import setup
setup(
name='my-cool-project',
version='0.8',
author='Firstname Lastname',
author_email='author@something.com',
install_requires=['...', 'pytoolbox>=14<15', '...'],
tests_require=['...', 'pytest', '...'],
license='GPLv3',
url='https://github.com/nickname/my-cool-project',
packages=['my_cool_project'])
See pip vcs support to get further details about this.
You also need to install git-core, but it is probably already the case, at least on your development computer ;-)
2012 - 2025 David Fischer
1 maintainer
Metadata
1 maintainer
Release files for pytoolbox 14.12.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytoolbox-14.12.1.tar.gz | 262.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pytoolbox-14.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / pytoolbox-14.12.1.tar.gz
| Download URL | pytoolbox-14.12.1.tar.gz |
|---|---|
| Size | 262.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a65c9535470f08eff01c2dbbe59e335e90ede6d8e67cb12bd3d039a647759472
|
|
BLAKE2b-256 checksum How to use checksums |
87ee1f024a479759f8600237e5405881566334e2cca9b43ed9f900d56c10ee56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / pytoolbox-14.12.1-py3-none-any.whl
| Download URL | pytoolbox-14.12.1-py3-none-any.whl |
|---|---|
| Size | 914.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ac39716de11e5ea3a4feaa03f67198a6e18ec002594ddfac62686647b63090a
|
|
BLAKE2b-256 checksum How to use checksums |
0e96f85dc8ed9a0a1cff328cc9810d070dd57952b11d59651900a80e6804d4df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
