extended-functools

Additional tools for functional programming in Python.

This project intends to offer a variety of general-purpose tools, starting with a timeout decorator, while keeping transient third-party dependencies to a minimum.

Type	Badges
PyPI
Tests
Activity
QA
Other

Installing

You can install the project from PyPI:

# For general use
pip install extended-functools

# For uv (and other package managers)
uv add extended-functools

Development

You can use whatever package manager you prefer, but the core team behind the project uses uv, and the CI scripts and Tox assume as much. This guide will assume you'll use uv. If you need more information on uv, consider reading through this guide.

It may also be a good idea to use VS Code as an IDE; the project includes a list of recommended extensions to install, which the IDE should tell you about on opening the project. Feel free to use something else if you want, though.

Setting up the development environment

You can install the project and its development dependencies by running uv install in the project directory after cloning it. After that, you should run

uv run pre-commit install

to install the pre-commit hooks, which are used to ensure commits are correctly formatted and meet the project's baseline quality standards. If the hooks need to be updated, you may run

uv run pre-commit autoupdate

to update them to the latest versions.

Contributing

This project follows semantic versioning, and uses a relaxed variant of the Git Flow workflow style, with feature branches playing a key role.

• Direct commits to main are forbidden
• The history of main is to remain linear through the use of fast-forward merges and rebasing
• Commits must be signed
• Messy PR histories are encouraged to be cleaned up before merging the PR.

More detailed information can be found in CONTRIBUTING.md.

Issues reports, feature requests, and PRs are all welcome.