askpablos-api 0.1.0__tar.gz

askpablos_api-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fawad Ali
+
+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.

askpablos_api-0.1.0/PKG-INFO

@@ -0,0 +1,255 @@
+Metadata-Version: 2.4
+Name: askpablos-api
+Version: 0.1.0
+Summary: Professional Python client for the AskPablos proxy API service
+Author-email: Fawad Ali <fawadstar6@gmail.com>
+Maintainer-email: Fawad Ali <fawadstar6@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/fawadss1/askpablos-api
+Project-URL: Documentation, https://askpablos-api.readthedocs.io
+Project-URL: Repository, https://github.com/fawadss1/askpablos-api
+Project-URL: Bug Tracker, https://github.com/fawadss1/askpablos-api/issues
+Keywords: proxy,api,web-scraping,browser,http-client,askpablos
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Internet :: Proxy Servers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: mypy>=0.900; extra == "dev"
+Requires-Dist: pre-commit>=2.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=4.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
+Requires-Dist: myst-parser>=0.15; extra == "docs"
+Dynamic: license-file
+
+# AskPablos API Client
+[![PyPI Version](https://img.shields.io/pypi/v/askpablos-api.svg)](https://pypi.python.org/pypi/askpablos-api)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/askpablos-api.svg)](https://pypi.python.org/pypi/askpablos-api)
+
+A simple Python client for making GET requests through the AskPablos proxy API service. This library provides a clean and easy-to-use interface for fetching web pages and APIs through the AskPablos proxy infrastructure.
+
+## Features
+
+- 🔐 **Secure Authentication**: HMAC-SHA256 signature-based authentication
+- 🌐 **Proxy Support**: Route requests through rotating proxies
+- 🤖 **Browser Integration**: Support for JavaScript-heavy websites
+- 🛡️ **Error Handling**: Comprehensive exception handling
+- 📊 **Logging**: Built-in logging support for debugging
+- 🎯 **Simple Interface**: GET-only requests for clean API
+
+## Installation
+
+```bash
+pip install askpablos-api
+```
+
+## Quick Start
+
+```python
+from askpablos_api import AskPablos
+
+# Initialize the client
+client = AskPablos(
+    api_key="your_api_key",
+    secret_key="your_secret_key"
+)
+
+# Make a simple GET request
+response = client.get("https://httpbin.org/ip")
+print(response)
+```
+
+## Authentication
+
+The AskPablos API uses HMAC-SHA256 signature-based authentication. You only need:
+
+1. **API Key**: Your unique API identifier
+2. **Secret Key**: Your private key for signing requests
+
+```python
+from askpablos_api import AskPablos
+
+client = AskPablos(
+    api_key="your_api_key",
+    secret_key="your_secret_key"
+)
+```
+
+## Usage Examples
+
+### Basic GET Requests
+
+```python
+# Simple GET request
+response = client.get("https://example.com")
+
+# GET with query parameters
+response = client.get(
+    "https://api.example.com/users",
+    params={"page": 1, "limit": 10}
+)
+
+# GET with custom headers
+response = client.get(
+    "https://api.example.com/data",
+    headers={"Authorization": "Bearer token123"}
+)
+```
+
+### Advanced Options
+
+```python
+# Use browser automation for JavaScript-heavy sites
+response = client.get(
+    "https://spa-website.com",
+    browser=True
+)
+
+# Disable proxy rotation
+response = client.get(
+    "https://example.com",
+    rotate_proxy=False
+)
+
+# Custom user agent and cookies
+response = client.get(
+    "https://example.com",
+    user_agent="Mozilla/5.0 (Custom Bot)",
+    cookies={"session": "abc123"}
+)
+
+# Custom timeout
+response = client.get(
+    "https://slow-website.com",
+    timeout=60
+)
+```
+
+### Error Handling
+
+```python
+from askpablos_api import (
+    AskPablos, 
+    AuthenticationError, 
+    APIConnectionError, 
+    ResponseError
+)
+
+try:
+    client = AskPablos(api_key="", secret_key="")
+except AuthenticationError as e:
+    print(f"Authentication failed: {e}")
+
+try:
+    response = client.get("https://example.com")
+except APIConnectionError as e:
+    print(f"Connection failed: {e}")
+except ResponseError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+### Logging
+
+```python
+from askpablos_api import configure_logging
+import logging
+
+# Enable debug logging
+configure_logging(level=logging.DEBUG)
+
+client = AskPablos(api_key="...", secret_key="...")
+response = client.get("https://example.com")  # This will be logged
+```
+
+## API Reference
+
+### AskPablos Class
+
+The main interface for the API client.
+
+#### Constructor
+
+```python
+AskPablos(api_key: str, secret_key: str)
+```
+
+**Parameters:**
+- `api_key` (str): Your API key from the AskPablos dashboard
+- `secret_key` (str): Your secret key for HMAC signing
+
+#### Methods
+
+##### get()
+
+```python
+get(url, params=None, headers=None, browser=False, rotate_proxy=True, timeout=30, **options)
+```
+
+Send a GET request through the AskPablos proxy.
+
+**Parameters:**
+- `url` (str): Target URL to fetch
+- `params` (dict, optional): URL query parameters
+- `headers` (dict, optional): Custom headers
+- `browser` (bool, optional): Use browser automation (default: False)
+- `rotate_proxy` (bool, optional): Enable proxy rotation (default: True)
+- `timeout` (int, optional): Request timeout in seconds (default: 30)
+- `**options`: Additional options like user_agent, cookies, etc.
+
+**Returns:** Dictionary containing the API response
+
+### Exception Classes
+
+- `AskPablosError` - Base exception class
+- `AuthenticationError` - Authentication-related errors
+- `APIConnectionError` - Connection and network errors
+- `ResponseError` - API response errors
+
+## Response Format
+
+All successful requests return a dictionary with:
+
+```python
+{
+    "status_code": 200,
+    "headers": {"content-type": "text/html", ...},
+    "content": "Response body content",
+    "url": "Final URL after redirects",
+    "proxy_used": "proxy.example.com:8080",
+    "time_taken": 1.23
+}
+```
+
+## Requirements
+
+- Python 3.9+
+- requests >= 2.25.0
+
+## License
+
+This project is licensed under the MIT License.
+
+## Support
+
+For support and questions:
+- Email: fawadstar6@gmail.com

askpablos_api-0.1.0/README.md

@@ -0,0 +1,211 @@
+# AskPablos API Client
+[![PyPI Version](https://img.shields.io/pypi/v/askpablos-api.svg)](https://pypi.python.org/pypi/askpablos-api)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/askpablos-api.svg)](https://pypi.python.org/pypi/askpablos-api)
+
+A simple Python client for making GET requests through the AskPablos proxy API service. This library provides a clean and easy-to-use interface for fetching web pages and APIs through the AskPablos proxy infrastructure.
+
+## Features
+
+- 🔐 **Secure Authentication**: HMAC-SHA256 signature-based authentication
+- 🌐 **Proxy Support**: Route requests through rotating proxies
+- 🤖 **Browser Integration**: Support for JavaScript-heavy websites
+- 🛡️ **Error Handling**: Comprehensive exception handling
+- 📊 **Logging**: Built-in logging support for debugging
+- 🎯 **Simple Interface**: GET-only requests for clean API
+
+## Installation
+
+```bash
+pip install askpablos-api
+```
+
+## Quick Start
+
+```python
+from askpablos_api import AskPablos
+
+# Initialize the client
+client = AskPablos(
+    api_key="your_api_key",
+    secret_key="your_secret_key"
+)
+
+# Make a simple GET request
+response = client.get("https://httpbin.org/ip")
+print(response)
+```
+
+## Authentication
+
+The AskPablos API uses HMAC-SHA256 signature-based authentication. You only need:
+
+1. **API Key**: Your unique API identifier
+2. **Secret Key**: Your private key for signing requests
+
+```python
+from askpablos_api import AskPablos
+
+client = AskPablos(
+    api_key="your_api_key",
+    secret_key="your_secret_key"
+)
+```
+
+## Usage Examples
+
+### Basic GET Requests
+
+```python
+# Simple GET request
+response = client.get("https://example.com")
+
+# GET with query parameters
+response = client.get(
+    "https://api.example.com/users",
+    params={"page": 1, "limit": 10}
+)
+
+# GET with custom headers
+response = client.get(
+    "https://api.example.com/data",
+    headers={"Authorization": "Bearer token123"}
+)
+```
+
+### Advanced Options
+
+```python
+# Use browser automation for JavaScript-heavy sites
+response = client.get(
+    "https://spa-website.com",
+    browser=True
+)
+
+# Disable proxy rotation
+response = client.get(
+    "https://example.com",
+    rotate_proxy=False
+)
+
+# Custom user agent and cookies
+response = client.get(
+    "https://example.com",
+    user_agent="Mozilla/5.0 (Custom Bot)",
+    cookies={"session": "abc123"}
+)
+
+# Custom timeout
+response = client.get(
+    "https://slow-website.com",
+    timeout=60
+)
+```
+
+### Error Handling
+
+```python
+from askpablos_api import (
+    AskPablos, 
+    AuthenticationError, 
+    APIConnectionError, 
+    ResponseError
+)
+
+try:
+    client = AskPablos(api_key="", secret_key="")
+except AuthenticationError as e:
+    print(f"Authentication failed: {e}")
+
+try:
+    response = client.get("https://example.com")
+except APIConnectionError as e:
+    print(f"Connection failed: {e}")
+except ResponseError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+### Logging
+
+```python
+from askpablos_api import configure_logging
+import logging
+
+# Enable debug logging
+configure_logging(level=logging.DEBUG)
+
+client = AskPablos(api_key="...", secret_key="...")
+response = client.get("https://example.com")  # This will be logged
+```
+
+## API Reference
+
+### AskPablos Class
+
+The main interface for the API client.
+
+#### Constructor
+
+```python
+AskPablos(api_key: str, secret_key: str)
+```
+
+**Parameters:**
+- `api_key` (str): Your API key from the AskPablos dashboard
+- `secret_key` (str): Your secret key for HMAC signing
+
+#### Methods
+
+##### get()
+
+```python
+get(url, params=None, headers=None, browser=False, rotate_proxy=True, timeout=30, **options)
+```
+
+Send a GET request through the AskPablos proxy.
+
+**Parameters:**
+- `url` (str): Target URL to fetch
+- `params` (dict, optional): URL query parameters
+- `headers` (dict, optional): Custom headers
+- `browser` (bool, optional): Use browser automation (default: False)
+- `rotate_proxy` (bool, optional): Enable proxy rotation (default: True)
+- `timeout` (int, optional): Request timeout in seconds (default: 30)
+- `**options`: Additional options like user_agent, cookies, etc.
+
+**Returns:** Dictionary containing the API response
+
+### Exception Classes
+
+- `AskPablosError` - Base exception class
+- `AuthenticationError` - Authentication-related errors
+- `APIConnectionError` - Connection and network errors
+- `ResponseError` - API response errors
+
+## Response Format
+
+All successful requests return a dictionary with:
+
+```python
+{
+    "status_code": 200,
+    "headers": {"content-type": "text/html", ...},
+    "content": "Response body content",
+    "url": "Final URL after redirects",
+    "proxy_used": "proxy.example.com:8080",
+    "time_taken": 1.23
+}
+```
+
+## Requirements
+
+- Python 3.9+
+- requests >= 2.25.0
+
+## License
+
+This project is licensed under the MIT License.
+
+## Support
+
+For support and questions:
+- Email: fawadstar6@gmail.com

askpablos_api-0.1.0/askpablos_api/__init__.py

@@ -0,0 +1,28 @@
+"""
+askpablos_api
+
+A Python client library for interacting with the AskPablos proxy API service.
+"""
+
+from .core import AskPablos
+from .client import ProxyClient
+from .exceptions import (
+    AskPablosError,
+    AuthenticationError,
+    APIConnectionError,
+    ResponseError
+)
+from .utils import configure_logging
+
+__version__ = "0.1.0"
+
+# Set up default exports
+__all__ = [
+    "AskPablos",
+    "ProxyClient",
+    "AskPablosError",
+    "AuthenticationError",
+    "APIConnectionError",
+    "ResponseError",
+    "configure_logging",
+]