fan-tools

What it is and what it does

fan-tools is a collection of internal utilities originally built for testing but expanded to cover async helpers, Unix operations, logging, monitoring, and backup tasks. It provides decorators for caching async and sync functions, a metaclass for lazy-initialized properties in test classes, wrappers around shell commands with async support, structured JSON logging for ELK-style systems, a Prometheus metrics server, and backup helpers for S3 and Google Cloud. The package depends on pyyaml and typing-extensions and is designed for Python 3.8+.

The toolkit is most useful for teams running internal testing infrastructure or operational scripts that need consistent patterns across projects. Its testing helpers (PropsMeta, ApiUrls, caching decorators) reduce boilerplate in test suites, while its Unix and logging modules simplify shell integration and observability. However, the package is dormant—last updated 680 days ago—so it may not receive updates for compatibility with newer Python or dependency versions.

Use it for:

• Build test fixtures with lazy-initialized connections and cached properties using PropsMeta to avoid complex setUp methods.
• Define nested API endpoint URLs in test fixtures with ApiUrls for parameterized test requests.
• Cache expensive async function results during test runs with cache_async decorator.
• Run shell commands from Python with real-time logging and error checking via asucc and succ wrappers.
• Output structured JSON logs with environment variables for ingestion into ELK or similar observability platforms.
• Expose application metrics in Prometheus format using MetricsServer with FastAPI.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A collection of internal testing utilities, async helpers, and operational tools including caching decorators, API URL builders, lazy-initialization metaclasses, Unix shell wrappers, JSON logging, metrics servers, and backup integrations.

Yes, if you are maintaining internal testing infrastructure or operational scripts that benefit from its specific patterns (lazy initialization, shell wrappers, structured logging). No, if you need active maintenance or expect compatibility updates—the package is dormant and may not adapt to future Python or dependency changes. The low install friction and permissive license make it low-risk to try, but plan for potential maintenance burden if the project evolves.

Install

fan-tools on PyPI

pip install fan-tools

uv add fan-tools

poetry add fan-tools

Installing fan-tools

Before you install

Low install friction with only two runtime dependencies (pyyaml, typing-extensions). Maintenance is dormant—last release was 680 days ago with no recent commits, though the repository remains active and the package is marked Production/Stable.

License in practice

Licensed under MIT (permissive), so you can use this package freely in commercial and open-source projects without significant legal constraints.

Quickstart

pip install fan-tools

from fan_tools.python import memoize

@memoize
def expensive_function(x):
    return x * 2

result = expensive_function(5)

Requires Python 3.8 or later; the package explicitly supports only 3.8+ and does not backport async/await or similar features to earlier versions.

Verify before relying

• Whether the package is actively maintained or if dormancy signals future incompatibility with newer Python or dependency versions.
• Real-world stability and test coverage of the backup integrations (S3, GCloud) in production environments.
• Whether all listed modules (Django middleware, DRF serializers, FastAPI metrics) are fully functional or partially deprecated.

Package facts

Evidence: fan_tools-4.4.0-py2.py3-none-any.whl

Keywords: asyncio, testing

Tags

More Software Development packages