django-ratelimit-middleware 0.1.1

A simple Django middleware for rate limiting by IP or user

django-ratelimit-middleware

🌟 Overview

Django Rate Limit Middleware is a simple, lightweight Django middleware for rate limiting requests based on user identity or IP address.
It helps prevent abuse, brute force attacks, and excessive traffic with minimal configuration.

✨ Features

• 🔑 Supports anonymous and authenticated users
• ⏱ Configurable request count and time window
• 🧠 Uses Django’s cache framework
• 🪶 Lightweight, dependency-free

📦 Installation

pip install django-ratelimit-middleware

⚙️ Configuration

Add to your MIDDLEWARE:

MIDDLEWARE = [
    ...
    "django_ratelimit_middleware.middleware.RateLimitMiddleware",
]

Add settings:

RATE_LIMIT_REQUESTS = 100       # Number of requests allowed
RATE_LIMIT_WINDOW = 60          # Window in seconds

🚀 Usage

After installation and config, all views are automatically rate-limited.
Example response when exceeding the limit:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

🧪 Running Tests

pytest

📊 Coverage

Coverage reports are uploaded to Codecov

🤝 Contributing

Contributions are welcome! 🎉

See CONTRIBUTING.md for details.

📌 Roadmap

• Custom rate limit strategies (e.g., per endpoint)
• Redis backend example
• Admin dashboard for monitoring blocked IPs
• Configurable responses (JSON, HTML)
• Turnstile feature

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement.
In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
Use at your own risk.

👨‍💻 Author

Maintained with ❤️ by K3y5tr0k3.