feu :fire:
Overview
feu (French word for "fire" 🔥) is a lightweight Python library designed to help manage Python
packages and their versions across different Python environments.
Key Features
- ✅ Check package availability: Verify if packages and modules are installed
- 🔄 Version-aware installation: Install packages with automatic version compatibility checks
- 🎯 Smart version resolution: Find the closest valid package version for your target environment (Python version, free-threadedness, OS, and CPU architecture)
- 📋 Package registry: Built-in compatibility information for popular packages (numpy, pandas, polars, torch, etc.)
- 🔍 PyPI-backed discovery: Automatically discover version compatibility from PyPI for packages that aren't in the built-in registry
- 🐙 GitHub utilities: Fetch and sort repository metadata from the GitHub API
- 🖥️ CLI tools: Command-line interface for package management tasks
- 🪶 Lightweight: Minimal dependencies (only
packagingrequired for core functionality)
Quick Example
from feu.imports import is_package_available
from feu.compat import Target, find_closest_version
from feu.version import get_package_version
# Check if a package is available
if is_package_available("numpy"):
version = get_package_version("numpy")
print(f"NumPy {version} is installed!")
# Find the closest valid version for your Python version
version = find_closest_version(
pkg_name="numpy", pkg_version="2.0.2", target=Target(python_version="3.10")
)
print(f"Closest valid version: {version}")
Why feu?
Managing Python package versions across different Python versions can be challenging. Different
Python versions support different package versions, and manually tracking compatibility can be
error-prone. feu solves this by:
- Automating version selection: Automatically finds compatible package versions for your Python environment
- Preventing installation failures: Validates versions before installation to avoid runtime errors
- Simplifying multi-version support: Makes it easy to support multiple Python versions in your projects
- Providing graceful fallbacks: Check package availability and provide alternatives when packages aren't installed
Documentation
Quick Links
Installation
We highly recommend installing
a virtual environment.
feu can be installed from pip using the following command:
pip install feu
To make the package as slim as possible, only the minimal packages required to use feu are
installed. To include all the dependencies, you can use the following command:
pip install feu[all]
Please check the get started page to see how to
install only some specific dependencies or other alternatives to install the library. The following
is the corresponding feu versions and supported dependencies.
feu |
packaging |
python |
click* |
gitpython* |
requests* |
rich* |
|---|---|---|---|---|---|---|
main |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
>=14.0.0,<16.0 |
0.8.3 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
>=14.0.0,<16.0 |
0.8.2 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
>=14.0.0,<16.0 |
0.8.1 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
>=14.0.0,<16.0 |
0.8.0 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
>=14.0.0,<16.0 |
0.7.3 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.7.2 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.7.1 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.7.0 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.6.2 |
>=21.0,<27.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.6.1 |
>=21.0,<26.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.6.0 |
>=21.0,<26.0 |
>=3.10 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.5.0 |
>=21.0,<26.0 |
>=3.10,<3.15 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
* indicates an optional dependency
older versions
feu |
packaging |
python |
click* |
gitpython* |
fire* |
requests* |
|---|---|---|---|---|---|---|
0.4.2 |
>=21.0,<26.0 |
>=3.10,<3.15 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.4.1 |
>=21.0,<26.0 |
>=3.10,<3.15 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.4.0 |
>=21.0,<26.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
>=2.30,<3.0 |
|
0.3.5 |
>=21.0,<26.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
||
0.3.4 |
>=21.0,<26.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
||
0.3.3 |
>=21.0,<26.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
>=3.1.41,<4.0 |
||
0.3.2 |
>=21.0,<25.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
|||
0.3.1 |
>=21.0,<25.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
|||
0.3.0 |
>=21.0,<25.0 |
>=3.9,<3.14 |
>=8.1,<9.0 |
|||
0.2.4 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=8.1,<9.0 |
|||
0.2.3 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=8.1,<9.0 |
|||
0.2.2 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=8.1,<9.0 |
|||
0.2.1 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=8.1,<9.0 |
|||
0.2.0 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=8.1,<9.0 |
|||
0.1.1 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=0.6.0,<1.0 |
|||
0.1.0 |
>=21.0,<25.0 |
>=3.9,<3.13 |
>=0.6.0,<1.0 |
|||
0.0.7 |
>=21.0,<25.0 |
>=3.9,<3.13 |
||||
0.0.6 |
>=21.0,<25.0 |
>=3.9,<3.13 |
||||
0.0.5 |
>=21.0,<25.0 |
>=3.9,<3.13 |
||||
0.0.4 |
>=21.0,<25.0 |
>=3.9,<3.13 |
||||
0.0.3 |
>=21.0,<25.0 |
>=3.9,<3.13 |
||||
0.0.2 |
>=22.0,<24.0 |
>=3.9,<3.13 |
||||
0.0.1 |
>=22.0,<23.3 |
>=3.9,<3.13 |
Contributing
Please check the instructions in CONTRIBUTING.md.
Suggestions and Communication
Everyone is welcome to contribute to the community. If you have any questions or suggestions, you can submit Github Issues. We will reply to you as soon as possible. Thank you very much.
API stability
:warning: While feu is in development stage, no API is guaranteed to be stable from one release to
the next. In fact, it is very likely that the API will change multiple times before a stable 1.0.0
release. In practice, this means that upgrading feu to a new version will possibly break any code
that was using the old version of feu.
License
feu is licensed under BSD 3-Clause "New" or "Revised" license available in LICENSE
file.
1 maintainer
Metadata
1 maintainer
Release files for feu 0.8.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| feu-0.8.3.tar.gz | 56.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| feu-0.8.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 149.7 kB
Release files / feu-0.8.3.tar.gz
| Download URL | feu-0.8.3.tar.gz |
|---|---|
| Size | 56.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
370abd065128c608512cc0c7886a867eb80d2f2fda86715d42d111d45e8c2593
|
|
BLAKE2b-256 checksum How to use checksums |
a134f022e330f97153e3094d7c5a0311a6083ea820b66552f9c348c431b267fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / feu-0.8.3-py3-none-any.whl
| Download URL | feu-0.8.3-py3-none-any.whl |
|---|---|
| Size | 92.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
41f350553cc0d0998eec363ae0d3c1aeea15899fb88e0be22635d8d42602d3ec
|
|
BLAKE2b-256 checksum How to use checksums |
3476bd4a6bd8094b8081e0b15ad55b14feb91b3eff1c2f5e136c822378060247
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
