atomhttp 1.0.0__py3-none-any.whl

atomhttp/utils/redirect.py

@@ -0,0 +1,107 @@
+"""
+Redirect Handler Module
+-----------------------
+Handles HTTP redirect responses for the AtomHTTP client.
+
+This module provides the RedirectHandler class which manages redirect
+following logic, including checking redirect status codes, tracking
+redirect counts, and constructing absolute URLs from relative redirect
+locations.
+"""
+
+from typing import Optional
+from urllib.parse import urlparse, urlunparse
+
+
+class RedirectHandler:
+    """
+    Handle HTTP redirect responses and manage redirect limits.
+    
+    This class tracks the number of redirects followed and provides
+    utilities for determining when to follow redirects and how to
+    construct absolute redirect URLs from relative locations.
+    
+    The handler supports standard HTTP redirect status codes:
+        - 301: Moved Permanently
+        - 302: Found (Temporary Redirect)
+        - 303: See Other
+        - 307: Temporary Redirect
+        - 308: Permanent Redirect
+    
+    Attributes:
+        max_redirects (int): Maximum number of redirects to follow
+        redirect_count (int): Current count of redirects followed
+    """
+    
+    def __init__(self, max_redirects: int = 5):
+        """
+        Initialize redirect handler with maximum redirect limit.
+        
+        Args:
+            max_redirects (int): Maximum number of redirects to follow.
+                                Defaults to 5, which is the standard for
+                                most HTTP clients.
+        """
+        self.max_redirects = max_redirects
+        self.redirect_count = 0
+    
+    def should_redirect(self, status_code: int) -> bool:
+        """
+        Determine if a status code indicates a redirect response.
+        
+        This method checks if the HTTP status code is one of the standard
+        redirect codes that should be followed automatically.
+        
+        Args:
+            status_code (int): HTTP status code from response
+            
+        Returns:
+            bool: True if status code is a redirect (301, 302, 303, 307, 308),
+                  False otherwise
+        """
+        return status_code in (301, 302, 303, 307, 308)
+    
+    def is_max_reached(self) -> bool:
+        """
+        Check if the maximum number of redirects has been reached.
+        
+        Returns:
+            bool: True if redirect_count >= max_redirects, False otherwise
+        
+        Note:
+            When this returns True, the client should stop following
+            redirects to avoid infinite loops.
+        """
+        return self.redirect_count >= self.max_redirects
+    
+    def get_redirect_url(self, location: str, original_url: str) -> str:
+        """
+        Convert a redirect location header to an absolute URL.
+        
+        The Location header in HTTP redirects may be either absolute
+        (complete URL) or relative (path only). This method resolves
+        relative locations to absolute URLs using the original request URL.
+        
+        Args:
+            location (str): The Location header value from redirect response
+            original_url (str): The original URL that was requested
+        
+        Returns:
+            str: Absolute URL to redirect to
+        """
+        # If location is already absolute, return it directly
+        if location.startswith(('http://', 'https://')):
+            return location
+        
+        # Parse the original URL to extract scheme and host
+        parsed = urlparse(original_url)
+        base = f"{parsed.scheme}://{parsed.netloc}"
+        
+        # Handle absolute path (starts with '/')
+        if location.startswith('/'):
+            return base + location
+        
+        # Handle relative path (no leading '/')
+        # Remove the last segment from the original path to get directory
+        path = parsed.path.rsplit('/', 1)[0]
+        return base + path + '/' + location

atomhttp-1.0.0.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: atomhttp
+Version: 1.0.0
+Summary: Professional asynchronous HTTP client for Python — interceptors, progress tracking, FormData, Blob, concurrent requests, and full type hints
+Author-email: Abolfazl Hosseini <tryuzr@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/inject3r/atomhttp
+Project-URL: Repository, https://github.com/inject3r/atomhttp.git
+Project-URL: Documentation, https://inject3r.github.io/atomhttp
+Project-URL: Issues, https://github.com/inject3r/atomhttp/issues
+Project-URL: Changelog, https://github.com/inject3r/atomhttp/releases
+Keywords: http,client,async,await,aiohttp,rest,api,interceptor,progress,formdata
+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: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Provides-Extra: all
+Requires-Dist: aiohttp>=3.8.0; extra == "all"
+Requires-Dist: pytest>=7.0.0; extra == "all"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "all"
+Requires-Dist: pytest-cov>=4.0.0; extra == "all"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://inject3r.github.io/atomhttp/logo.jpg" alt="AtomHTTP Logo" width="350">
+</p>
+
+# AtomHTTP
+
+A professional, feature-rich asynchronous HTTP client for Python — designed for developers who need reliability, flexibility, and performance.
+
+**[Full Documentation](https://inject3r.github.io/atomhttp)** — Complete API reference, advanced guides, and examples
+
+<br/>
+
+## Features
+
+- **Full HTTP Method Support**: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS with async/await syntax
+- **Request & Response Interceptors**: Modify requests before sending and responses before returning
+- **Upload & Download Progress Tracking**: Real-time callbacks for monitoring data transfer
+- **FormData Support**: Multipart/form-data and URL-encoded form handling with file uploads
+- **Multiple Response Types**: JSON (auto-parsed), text, blob, arraybuffer, and stream
+- **Concurrent Request Helpers**: Execute multiple requests in parallel with `all()` and `spread()`
+- **Base URL Configuration**: Set a base URL once and use relative paths
+- **Automatic JSON Serialization**: No need to manually encode/decode JSON
+- **Authentication**: Basic Auth and Bearer Token support
+- **Comprehensive Error Handling**: Typed exceptions with standardized error codes
+- **Timeout & Redirect Control**: Configurable timeouts and maximum redirect limits
+- **Keep-Alive & Connection Pooling**: Reuse connections for better performance
+- **Proxy Support**: Route requests through HTTP proxies
+- **Unix Socket Path Support**: Connect via Unix domain sockets
+- **Size Limits**: Configure maximum request body and response content lengths
+- **Status Code Validation**: Custom validation functions for HTTP status codes
+- **CSRF Protection**: Built-in support for XSRF token headers
+- **Automatic Decompression**: Handles gzip and deflate compressed responses
+- **Mock Adapter for Testing**: Simulate responses without network calls
+- **Type Hints**: Full typing support for excellent IDE autocompletion
+
+## Installation
+
+```bash
+pip install atomhttp
+```
+
+With development dependencies:
+
+```bash
+pip install atomhttp[dev]
+```
+
+## Quick Start
+
+```python
+import asyncio
+from atomhttp import AtomHTTP
+
+async def main():
+    client = AtomHTTP({'baseURL': 'https://api.example.com'})
+    response = await client.get('/users')
+    print(response.status, response.data)
+    await client.close()
+
+asyncio.run(main())
+```
+
+## Documentation
+
+For complete documentation, API reference, and advanced usage examples, visit:
+
+**[https://inject3r.github.io/atomhttp](https://inject3r.github.io/atomhttp)**
+
+The documentation includes:
+
+- Detailed API reference for all classes and methods
+- Advanced usage patterns and best practices
+- Configuration options and their effects
+- Error handling strategies
+- Migration guides from other HTTP clients
+
+## Requirements
+
+- Python 3.8+
+- aiohttp 3.8.0+
+
+## Running Tests
+
+```bash
+# Run all tests with coverage
+./scripts/tests.sh
+
+# Clean test output files
+./scripts/test_clean.sh
+```
+
+## License
+
+This project is licensed under the MIT License.
+
+## Author
+
+**Abolfazl Hosseini**
+
+- Email: tryuzr@gmail.com
+- GitHub: [@inject3r](https://github.com/inject3r)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Acknowledgments
+
+- [aiohttp](https://docs.aiohttp.org/) - Async HTTP client/server framework
+- All contributors and users of this project

atomhttp-1.0.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+atomhttp/__init__.py,sha256=mJTLw2s70Z8hosMQ-IfD2whldI0WLbqczamxhylo79s,2121
+atomhttp/client.py,sha256=sHupALERyHvOCh-ZaJJJUfr8Lc2iEtbf8mLmLGP9DVo,20752
+atomhttp/adapters/__init__.py,sha256=waRdw1NYqVo7CNzboCt0zmszXy1OTXc3j0jsGUVmRg8,117
+atomhttp/adapters/http_adapter.py,sha256=kzYNGlXsEMl-LsfEcFnHZOglzPFnpuVTL4zFvX4Cjz0,4173
+atomhttp/adapters/mock_adapter.py,sha256=OxeJvqIfGMqvg_4WP_rZEL_-hna-rCtKzb_T-cUmlkk,5179
+atomhttp/auth/__init__.py,sha256=7OSniKBhYho-GvVA9gchOgf4RWwvEnT4Zi2PYkTBt7Q,108
+atomhttp/auth/basic_auth.py,sha256=iu3qnm1Yzdf3wXe_FQ73loxQaz2ctgTUUdowOOo5-54,3350
+atomhttp/auth/bearer_auth.py,sha256=8M9F_FeGKQz1Xi1pt0vaU1TF2Llcfq9d31iPFYs83Zc,3161
+atomhttp/core/__init__.py,sha256=80CeSPFTVE5EtPfoiBqXFmSQamKTMoLC81VsziuNfWA,465
+atomhttp/core/adapters.py,sha256=JxE3kTL8gXP29Kw55HQI5Qc0gxnp1uRJWiYkG4bpsRE,27054
+atomhttp/core/config.py,sha256=15Zuov_FQWj1lDj4liOkwzrbY_-cqmIzcS7IdglPUtM,7401
+atomhttp/core/defaults.py,sha256=G41lw8ynFE_Xd4lvd-O0-qkq8WYZHLH6LF5sZqN4bSw,7836
+atomhttp/core/form_data.py,sha256=VLpDYAAfo4kMA46uB5btcEsAO2hrdjnACw0kTKsfyPs,10259
+atomhttp/core/request.py,sha256=xdUozOaiHzjud8i2WFQIJNT_wWWsJQ4mBCccWQ4yPYA,10062
+atomhttp/core/response.py,sha256=6K1ROg4rGjxTm1LAfoGGJB6yR4J3ce4iiHjkxhsZ1Rk,3372
+atomhttp/errors/__init__.py,sha256=BUEU5qQcvlMeS7_ZUikZaj7829N_95H8LZygsFsg66k,246
+atomhttp/errors/http_errors.py,sha256=jpCAfVD3cfMNgbk6SGdaRsruoBA0zV-u7Xndlwdqw4Y,4775
+atomhttp/interceptors/__init__.py,sha256=djVVrsMK-mTWUTPzajBybwrHkjRQwe8ZvMOTNDdauzo,224
+atomhttp/interceptors/manager.py,sha256=I2uidox4MjEZOq76IqM2I5APW1IjjqVMUW9uoabY_wA,5466
+atomhttp/interceptors/request_interceptor.py,sha256=K8T0VbC37Z5DwTa6e_SiklGaqQZXKJxrxIvIAAFUOYA,721
+atomhttp/interceptors/response_interceptor.py,sha256=so92WxoBflIwhUv8nXP_EAHMxFI2Al1C6gmv-TLTXjA,718
+atomhttp/progress/__init__.py,sha256=pD_ea5iV-yabnro2It0iHQ3JSM17Pf6ChUiU74wNrXQ,75
+atomhttp/progress/upload_progress.py,sha256=bVu39oCZKcaoAIx2Qip4zYTf5FTRuvNcen28MfeI8zw,3465
+atomhttp/transforms/__init__.py,sha256=rO3nPoftABf3bUolztfRSluNJKtBv6-JzrprXKbIv_0,220
+atomhttp/transforms/data_serializer.py,sha256=GGT1VV-pGa2vTQliHhhjHaoq_l2eR-tECdz9QtJn8ec,3245
+atomhttp/transforms/request_transform.py,sha256=Sh9mqaz29xBMvyezA9ERwJ1yMXwQ4kRQzJRXiXxe70g,4147
+atomhttp/transforms/response_transform.py,sha256=EBUVHdDaL505CvyyyNEh7hzEznWEOMpzjP4q45HJavk,2826
+atomhttp/utils/__init__.py,sha256=tHngX0GRgmo3peV9eBaxwd3PltGgEemIHde7Fmcn7eo,226
+atomhttp/utils/cookies.py,sha256=4ore5vu48BpR6m4oijEqwvywIjWJIDcqKei5KkfzEp8,4610
+atomhttp/utils/helpers.py,sha256=RJSDuVUlKjeP9UTrfkesNbpXlkeGsp9ktym_odjbs2c,3958
+atomhttp/utils/redirect.py,sha256=yRvQfm4aHTBODbREaHeHMEzvfAINgvCp1saAdbgBP3I,3835
+atomhttp-1.0.0.dist-info/licenses/LICENSE,sha256=aCMFMZNf1JWWTFSFgxhyAMhACSjlaC_Q9vYbFMP_JH8,1073
+atomhttp-1.0.0.dist-info/METADATA,sha256=i_sGyftTTqapcNq4g7UJd1OBQANLbAX95q9nigZxUwc,5911
+atomhttp-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+atomhttp-1.0.0.dist-info/top_level.txt,sha256=Wx-x5YQAk-KfplY7qqB_kU9T2_JxXv49zVEdu7ZSQCo,9
+atomhttp-1.0.0.dist-info/RECORD,,

atomhttp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

atomhttp-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abolfazl Hosseini
+
+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.

atomhttp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+atomhttp