Metadata-Version: 2.4
Name: fluffer
Version: 0.1.0
Summary: Pre-warming helper: run preload tasks and report readiness.
Project-URL: Homepage, https://github.com/coldbricks/fluffer
Project-URL: Repository, https://github.com/coldbricks/fluffer
Project-URL: Issues, https://github.com/coldbricks/fluffer/issues
Author-email: Coldbricks <coldbricks@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: parallel,preload,ready,startup,warmup
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# fluffer

Pre-warming helper for application startup. Run a set of preload callables
(optionally in parallel) and get a readiness report covering successes and
failures.

## Install

```bash
pip install fluffer
```

## Usage

```python
from fluffer import warm

def load_config():
    return {"env": "dev"}

def connect_cache():
    return True

report = warm([load_config, connect_cache], parallel=True)
assert report.ready is True
assert len(report.tasks) == 2
```

## Roadmap

This is an early **0.1.0** release with active development planned:

- Async/await warm paths
- Timeout and cancellation per task
- Integration hooks for health endpoints

## Author

Coldbricks — coldbricks@gmail.com
