Metadata-Version: 2.1
Name: fastapi-profiler-lite
Version: 0.1.0
Summary: Lightweight performance profiler for FastAPI applications
Home-page: https://github.com/al91liwo/fastapi-profiler
License: MIT
Keywords: fastapi,profiler,performance,monitoring,lightweight
Author: Alexander Lind
Author-email: al91liwo@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Framework :: FastAPI
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: dev
Provides-Extra: standard
Requires-Dist: fastapi (>=0.68.0)
Requires-Dist: jinja2 (>=3.1.2)
Requires-Dist: starlette (>=0.14.2)
Requires-Dist: uvicorn (>=0.14.0) ; extra == "standard" or extra == "dev"
Project-URL: Documentation, https://github.com/al91liwo/fastapi-profiler/tree/main/docs
Project-URL: Repository, https://github.com/al91liwo/fastapi-profiler
Description-Content-Type: text/markdown

# FastAPI Profiler Lite

<p align="center">
  <img src="docs/images/logo.png" alt="FastAPI Profiler Lite Logo" width="150"/>
</p>

<p align="center">
  <a href="https://pypi.org/project/fastapi-profiler-lite/"><img src="https://img.shields.io/pypi/v/fastapi-profiler-lite?color=blue" alt="PyPI version"></a>
  <a href="https://github.com/al91liwo/fastapi-profiler/blob/main/LICENSE"><img src="https://img.shields.io/github/license/al91liwo/fastapi-profiler" alt="License"></a>
  <a href="https://github.com/al91liwo/fastapi-profiler/stargazers"><img src="https://img.shields.io/github/stars/al91liwo/fastapi-profiler" alt="GitHub stars"></a>
</p>

A lightweight, zero-configuration performance profiler for FastAPI applications. Monitor your API performance in real-time without external dependencies.

<p align="center">
  <img src="docs/images/dashboard-demo.png" alt="Dashboard Demo" width="800"/>
</p>

## Why FastAPI Profiler?

Monitoring API performance shouldn't require complex setups or external services. FastAPI Profiler gives you instant visibility into your application's performance with just one line of code.

- **Instant insights** - See which endpoints are slow without complex instrumentation
- **Zero configuration** - Works out of the box with sensible defaults
- **No external dependencies** - Everything runs within your FastAPI app
- **Developer-friendly** - Designed for both development and lightweight production use

## Installation

```bash
pip install fastapi-profiler-lite
```

For more installation options, see the [Installation Guide](docs/installation.md).

## Quick Start

```python
from fastapi import FastAPI
from fastapi_profiler import Profiler

app = FastAPI()

# Add the profiler with just one line
Profiler(app)

@app.get("/")
async def read_root():
    return {"Hello": "World"}
```

That's it! Visit `/profiler` to see the performance dashboard.

## Features

- **One-line integration** - Add to any FastAPI app with minimal code
- **Real-time dashboard** - Live updates with automatic refresh
- **Response time tracking** - Measure execution time of each request
- **Endpoint analysis** - Identify your slowest and most used endpoints
- **Request filtering** - Search and sort through captured requests
- **Visual metrics** - Charts for response times and request distribution
- **Minimal overhead** - Designed to have low performance impact

## Documentation

- [Installation](docs/installation.md)
- [Configuration](docs/configuration.md)
- [Contributing](docs/contributing.md)
- [Extending](docs/extending.md)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

