ratethrottle 1.0.0__tar.gz

ratethrottle-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MykeChidi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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.

ratethrottle-1.0.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: ratethrottle
+Version: 1.0.0
+Summary: Advanced rate limiting and DDoS protection for Python web applications
+Project-URL: Documentation, https://github.com/MykeChidi/ratethrottle
+Project-URL: Repository, https://github.com/MykeChidi/ratethrottle
+Project-URL: Bug Tracker, https://github.com/MykeChidi/ratethrottle/issues
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: redis
+Requires-Dist: redis>=7.0.0; extra == "redis"
+Provides-Extra: flask
+Requires-Dist: flask>=3.0.0; extra == "flask"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.129.0; extra == "fastapi"
+Requires-Dist: starlette>=0.52.0; extra == "fastapi"
+Provides-Extra: django
+Requires-Dist: django>=5.2.0; extra == "django"
+Provides-Extra: frameworks
+Requires-Dist: redis>=7.0.0; extra == "frameworks"
+Requires-Dist: flask>=3.0.0; extra == "frameworks"
+Requires-Dist: fastapi>=0.100.0; extra == "frameworks"
+Requires-Dist: starlette>=0.52.0; extra == "frameworks"
+Requires-Dist: django>=5.2.0; extra == "frameworks"
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.2.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: black>=26.0.0; extra == "dev"
+Requires-Dist: flake8>=7.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=7.0.0; extra == "dev"
+Requires-Dist: bandit>=1.9.0; extra == "dev"
+Requires-Dist: pre-commit>=4.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: types-redis>=4.5.0; extra == "dev"
+Dynamic: license-file
+
+# `RateThrottle`
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Advanced rate limiting and DDoS protection for Python web applications.**
+
+RateThrottle is a comprehensive rate limiting library that provides enterprise-level features for protecting your APIs and web applications from abuse, with built-in DDoS protection, different storage backends, multiple strategies and seamless integration with popular Python web frameworks.
+
+## ✨ Features
+
+- 🚀 **Multiple Rate Limiting Strategies**
+  - Token Bucket
+  - Leaky Bucket
+  - Fixed Window
+  - Sliding Window Log
+  
+- 🛡️ **Advanced DDoS Protection**
+  - Traffic pattern analysis
+  - Automatic suspicious activity detection
+  - Auto-blocking capabilities
+  
+- 💾 **Flexible Storage Backends**
+  - In-memory (single instance)
+  - Redis (distributed/multi-server)
+  - Easy to extend with custom backends
+  
+- 🔧 **Framework Integration**
+  - Flask
+  - FastAPI
+  - Django
+  - Starlette
+  - Generic WSGI/ASGI support
+  
+- 📊 **Monitoring & Analytics**
+  - Real-time metrics
+  - Violation tracking
+  - CLI dashboard
+  
+- ⚙️ **Configuration Management**
+  - YAML configuration files
+  - Programmatic configuration
+  - Hot-reloading support
+
+
+## 📊 Performance
+
+RateThrottle is designed for high performance:
+
+- **In-memory storage**: 100,000+ requests/second
+- **Redis storage**: 50,000+ requests/second (network dependent)
+- **Minimal overhead**: < 1ms per request check
+- **Thread-safe**: Safe for concurrent use
+- **Memory efficient**: Automatic cleanup of expired data
+
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+
+## 📮 Support
+
+- 🐛 Issues: [GitHub Issues](https://github.com/MykeChidi/ratethrottle/issues)
+- 📖 Documentation: [Full Documentation](README)
+
+---

ratethrottle-1.0.0/README.md

@@ -0,0 +1,66 @@
+# `RateThrottle`
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Advanced rate limiting and DDoS protection for Python web applications.**
+
+RateThrottle is a comprehensive rate limiting library that provides enterprise-level features for protecting your APIs and web applications from abuse, with built-in DDoS protection, different storage backends, multiple strategies and seamless integration with popular Python web frameworks.
+
+## ✨ Features
+
+- 🚀 **Multiple Rate Limiting Strategies**
+  - Token Bucket
+  - Leaky Bucket
+  - Fixed Window
+  - Sliding Window Log
+  
+- 🛡️ **Advanced DDoS Protection**
+  - Traffic pattern analysis
+  - Automatic suspicious activity detection
+  - Auto-blocking capabilities
+  
+- 💾 **Flexible Storage Backends**
+  - In-memory (single instance)
+  - Redis (distributed/multi-server)
+  - Easy to extend with custom backends
+  
+- 🔧 **Framework Integration**
+  - Flask
+  - FastAPI
+  - Django
+  - Starlette
+  - Generic WSGI/ASGI support
+  
+- 📊 **Monitoring & Analytics**
+  - Real-time metrics
+  - Violation tracking
+  - CLI dashboard
+  
+- ⚙️ **Configuration Management**
+  - YAML configuration files
+  - Programmatic configuration
+  - Hot-reloading support
+
+
+## 📊 Performance
+
+RateThrottle is designed for high performance:
+
+- **In-memory storage**: 100,000+ requests/second
+- **Redis storage**: 50,000+ requests/second (network dependent)
+- **Minimal overhead**: < 1ms per request check
+- **Thread-safe**: Safe for concurrent use
+- **Memory efficient**: Automatic cleanup of expired data
+
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+
+## 📮 Support
+
+- 🐛 Issues: [GitHub Issues](https://github.com/MykeChidi/ratethrottle/issues)
+- 📖 Documentation: [Full Documentation](README)
+
+---

ratethrottle-1.0.0/pyproject.toml

@@ -0,0 +1,142 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ratethrottle"
+version = "1.0.0"
+description = "Advanced rate limiting and DDoS protection for Python web applications"
+readme = "README.md"
+
+[author]
+name = "MykeChidi"
+
+license = {text = "MIT"}
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Security",
+]
+keywords = ["rate-limiting", "rate-limit", "throttlling", "api", "ddos", "security", "api-gateway"]
+dependencies = [
+    "pyyaml>=6.0",
+] 
+
+[project.optional-dependencies]
+redis = ["redis>=7.0.0"]
+flask = ["flask>=3.0.0"]
+fastapi = ["fastapi>=0.129.0", "starlette>=0.52.0"]
+django = ["django>=5.2.0"]
+frameworks = [
+    "redis>=7.0.0",
+    "flask>=3.0.0",
+    "fastapi>=0.100.0",
+    "starlette>=0.52.0",
+    "django>=5.2.0"
+]
+
+dev = [
+    "pytest>=9.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-asyncio>=1.2.0",
+    "pytest-mock>=3.10.0",
+    "black>=26.0.0",
+    "flake8>=7.0.0",
+    "mypy>=1.0.0",
+    "isort>=7.0.0",
+    "bandit>=1.9.0",
+    "pre-commit>=4.0.0",
+    "types-PyYAML>=6.0.0",
+    "types-redis>=4.5.0", 
+]
+
+[project.urls]
+Documentation = "https://github.com/MykeChidi/ratethrottle"
+Repository = "https://github.com/MykeChidi/ratethrottle"
+"Bug Tracker" = "https://github.com/MykeChidi/ratethrottle/issues"
+
+[project.scripts]
+ratethrottle = "ratethrottle.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["ratethrottle*"]
+exclude = ["tests*", "examples*", "docs*"]
+
+[tool.setuptools.package-data]
+ratethrottle = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ['py310', 'py311', 'py312']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+[tool.isort]
+profile = "black"
+line_length = 100
+multi_line_output = 3
+include_trailing_comma = true
+force_grid_wrap = 0
+use_parentheses = true
+ensure_newline_before_comments = true
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q --strict-markers --cov=ratethrottle --cov-report=term-missing --cov-report=html"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+[tool.coverage.run]
+source = ["ratethrottle"]
+omit = [
+    "*/tests/*",
+    "*/test_*.py",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]

ratethrottle-1.0.0/ratethrottle/__init__.py

@@ -0,0 +1,125 @@
+"""
+RateThrottle - Production-grade rate limiting and DDoS protection
+
+A comprehensive rate limiting library for Python web applications with
+enterprise features including DDoS protection, analytics, and multi-framework support.
+"""
+
+import logging
+from typing import Optional
+
+from .analytics import RateThrottleAnalytics
+from .config import ConfigManager
+from .core import RateThrottleCore, RateThrottleRule
+from .ddos import DDoSProtection
+from .helpers import create_limiter
+from .storage_backend import InMemoryStorage, StorageBackend
+
+__version__ = "1.0.0"
+__author__ = "MykeChidi"
+__license__ = "MIT"
+__all__ = [
+    # Core
+    "RateThrottleCore",
+    "RateThrottleRule",
+    "RateThrottleStatus",
+    "RateThrottleViolation",
+    # Storage
+    "StorageBackend",
+    "InMemoryStorage",
+    "RedisStorage",
+    # Middleware
+    "FlaskRateLimiter",
+    "FastAPIRateLimiter",
+    "DjangoRateLimitMiddleware",
+    "django_ratelimit",
+    "StarletteRateLimitMiddleware",
+    "WSGIRateLimitMiddleware",
+    # Config & Protection
+    "ConfigManager",
+    "DDoSProtection",
+    "RateThrottleAnalytics",
+    # Helpers
+    "create_limiter",
+]
+
+
+# Lazy imports to avoid import errors when optional dependencies are missing
+def __getattr__(name: str):
+    """Lazy import for optional components"""
+
+    if name == "RedisStorage":
+        try:
+            from .storage_backend import RedisStorage
+
+            return RedisStorage
+        except ImportError as e:
+            raise ImportError(
+                "RedisStorage requires 'redis' package. "
+                "Install it with: pip install ratethrottle[redis]"
+            ) from e
+
+    # Middleware imports
+    elif name == "FlaskRateLimiter":
+        try:
+            from .middleware import FlaskRateLimiter
+
+            return FlaskRateLimiter
+        except ImportError as e:
+            raise ImportError(
+                "FlaskRateLimiter requires 'flask' package. "
+                "Install it with: pip install ratethrottle[flask]"
+            ) from e
+
+    elif name == "FastAPIRateLimiter":
+        try:
+            from .middleware import FastAPIRateLimiter
+
+            return FastAPIRateLimiter
+        except ImportError as e:
+            raise ImportError(
+                "FastAPIRateLimiter requires 'fastapi' package. "
+                "Install it with: pip install ratethrottle[fastapi]"
+            ) from e
+
+    elif name in ["DjangoRateLimitMiddleware", "django_ratelimit"]:
+        try:
+            from .middleware import DjangoRateLimitMiddleware, django_ratelimit  # noqa
+
+            return locals()[name]
+        except ImportError as e:
+            raise ImportError(
+                "Django components require 'django' package. "
+                "Install it with: pip install ratethrottle[django]"
+            ) from e
+
+    elif name in ["StarletteRateLimitMiddleware", "WSGIRateLimitMiddleware"]:
+        from .middleware import StarletteRateLimitMiddleware, WSGIRateLimitMiddleware  # noqa
+
+        return locals()[name]
+
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+def get_version() -> str:
+    """Return the current version"""
+    return __version__
+
+
+def configure_logging(level: int = logging.INFO, handler: Optional[logging.Handler] = None):
+    """
+    Configure logging for RateThrottle
+
+    Args:
+        level: Logging level (logging.DEBUG, logging.INFO, etc.)
+        handler: Custom logging handler (default: StreamHandler)
+    """
+    logger = logging.getLogger("ratethrottle")
+    logger.setLevel(level)
+
+    if handler is None:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+        handler.setFormatter(formatter)
+
+    logger.addHandler(handler)

ratethrottle-1.0.0/ratethrottle/__main__.py

@@ -0,0 +1,23 @@
+"""
+RateThottle Module entry point.
+
+Allows you to run the package as a module.
+    python -m ratethrottle
+"""
+
+import sys
+
+
+def main():
+    """Main entry point for the package."""
+    try:
+        from .cli import main as cli_main
+
+        sys.exit(cli_main())
+    except ImportError as e:
+        print(f"Error importing CLI: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()