marqetive-lib 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

marqetive_lib-0.1.6.dist-info/METADATA

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: marqetive-lib
+Version: 0.1.6
+Summary: Modern Python utilities for web APIs
+Keywords: api,utilities,web,http,marqetive
+Requires-Python: >=3.12
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Provides-Extra: dev
+Provides-Extra: docs
+Requires-Dist: aiofiles (>=24.0.0)
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: mkdocs (>=1.5.0) ; extra == "docs"
+Requires-Dist: mkdocs-material (>=9.5.0) ; extra == "docs"
+Requires-Dist: mkdocstrings[python] (>=0.30.1) ; extra == "docs"
+Requires-Dist: pydantic (>=2.0.0)
+Requires-Dist: pyright (>=1.1.0) ; extra == "dev"
+Requires-Dist: pytest (>=9.0.0) ; extra == "dev"
+Requires-Dist: pytest-asyncio (>=1.3.0) ; extra == "dev"
+Requires-Dist: pytest-cov (>=7.0.0) ; extra == "dev"
+Requires-Dist: ruff (>=0.14.4) ; extra == "dev"
+Requires-Dist: tweepy (>=4.16.0,<5.0.0)
+Project-URL: Documentation, https://marqetive-lib.readthedocs.io
+Project-URL: Homepage, https://github.com/yourusername/marqetive-lib
+Project-URL: Issues, https://github.com/yourusername/marqetive-lib/issues
+Project-URL: Repository, https://github.com/yourusername/marqetive-lib
+Description-Content-Type: text/markdown
+
+# MarqetiveLib
+
+Modern Python library for social media platform integrations - Simple, type-safe, and async-ready.
+
+## Supported Platforms
+
+- **Twitter/X** - Post tweets, upload media, manage threads
+- **LinkedIn** - Share updates, upload images and videos
+- **Instagram** - Create posts with media via Graph API
+- **TikTok** - Upload and publish videos
+
+## Features
+
+- **Unified API**: Single interface for all social media platforms
+- **Async-First**: Built for modern async Python applications
+- **Type-Safe**: Full type hints and Pyright compliance
+- **Auto Token Refresh**: Factory handles OAuth token lifecycle automatically
+- **Media Upload**: Progress tracking for large file uploads
+- **Retry Logic**: Exponential backoff with jitter for transient failures
+- **Well Tested**: Comprehensive test coverage
+
+## Installation
+
+```bash
+pip install marqetive
+```
+
+Or with Poetry:
+
+```bash
+poetry add marqetive
+```
+
+## Quick Start
+
+```python
+import asyncio
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+
+async def main():
+    # Create credentials for your platform
+    credentials = AuthCredentials(
+        platform="twitter",
+        access_token="your_access_token",
+        refresh_token="your_refresh_token"
+    )
+
+    # Get authenticated client (auto-refreshes token if expired)
+    client = await get_client(credentials)
+
+    # Use client as async context manager
+    async with client:
+        request = PostCreateRequest(content="Hello from MarqetiveLib!")
+        post = await client.create_post(request)
+        print(f"Posted! ID: {post.platform_id}")
+
+asyncio.run(main())
+```
+
+## Platform Examples
+
+### Twitter
+
+```python
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+
+credentials = AuthCredentials(
+    platform="twitter",
+    access_token="your_access_token",
+    refresh_token="your_refresh_token"  # Optional, for token refresh
+)
+
+client = await get_client(credentials)
+async with client:
+    # Text post
+    post = await client.create_post(PostCreateRequest(content="Hello Twitter!"))
+
+    # Post with media
+    post = await client.create_post(PostCreateRequest(
+        content="Check out this image!",
+        media_paths=["/path/to/image.jpg"]
+    ))
+```
+
+### LinkedIn
+
+```python
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+
+credentials = AuthCredentials(
+    platform="linkedin",
+    access_token="your_access_token",
+    user_id="urn:li:person:your_person_id"  # Required for LinkedIn
+)
+
+client = await get_client(credentials)
+async with client:
+    post = await client.create_post(PostCreateRequest(
+        content="Excited to share this update!"
+    ))
+```
+
+### Instagram
+
+```python
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+
+credentials = AuthCredentials(
+    platform="instagram",
+    access_token="your_access_token",
+    user_id="your_instagram_business_account_id"  # Required
+)
+
+client = await get_client(credentials)
+async with client:
+    # Instagram requires media for posts
+    post = await client.create_post(PostCreateRequest(
+        content="Beautiful day! #photography",
+        media_paths=["/path/to/photo.jpg"]
+    ))
+```
+
+### TikTok
+
+```python
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+
+credentials = AuthCredentials(
+    platform="tiktok",
+    access_token="your_access_token",
+    additional_data={"open_id": "your_open_id"}  # Required for TikTok
+)
+
+client = await get_client(credentials)
+async with client:
+    post = await client.create_post(PostCreateRequest(
+        content="Check out this video!",
+        media_paths=["/path/to/video.mp4"]
+    ))
+```
+
+## Using Custom OAuth Credentials
+
+```python
+from marqetive import PlatformFactory, AuthCredentials, PostCreateRequest
+
+# Create factory with your OAuth app credentials
+factory = PlatformFactory(
+    twitter_client_id="your_client_id",
+    twitter_client_secret="your_client_secret",
+    linkedin_client_id="your_linkedin_client_id",
+    linkedin_client_secret="your_linkedin_client_secret"
+)
+
+credentials = AuthCredentials(
+    platform="twitter",
+    access_token="user_access_token",
+    refresh_token="user_refresh_token"
+)
+
+# Get client with automatic token refresh
+client = await factory.get_client(credentials)
+async with client:
+    post = await client.create_post(PostCreateRequest(content="Hello!"))
+```
+
+## Progress Tracking for Media Uploads
+
+```python
+def progress_callback(operation: str, progress: int, total: int, message: str | None):
+    percent = (progress / total) * 100 if total > 0 else 0
+    print(f"{operation}: {percent:.1f}% - {message or ''}")
+
+client = await get_client(credentials, progress_callback=progress_callback)
+async with client:
+    post = await client.create_post(PostCreateRequest(
+        content="Uploading video...",
+        media_paths=["/path/to/large_video.mp4"]
+    ))
+```
+
+## Error Handling
+
+```python
+from marqetive import get_client, AuthCredentials, PostCreateRequest
+from marqetive.core.exceptions import (
+    PlatformError,
+    PlatformAuthError,
+    RateLimitError,
+    MediaUploadError
+)
+
+try:
+    client = await get_client(credentials)
+    async with client:
+        post = await client.create_post(request)
+except PlatformAuthError as e:
+    print(f"Authentication failed: {e}")
+    # Token may need refresh or reconnection
+except RateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after} seconds")
+except MediaUploadError as e:
+    print(f"Media upload failed: {e}")
+except PlatformError as e:
+    print(f"Platform error: {e}")
+```
+
+## Requirements
+
+- Python 3.12+
+- httpx >= 0.28.1
+- pydantic >= 2.0.0
+- tweepy >= 4.16.0
+- aiofiles >= 24.0.0
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/your-org/marqetive-lib.git
+cd marqetive-lib
+
+# Install Poetry if you haven't already
+curl -sSL https://install.python-poetry.org | python3 -
+
+# Install dependencies
+poetry install --with dev,docs
+
+# Activate virtual environment
+poetry shell
+```
+
+### Running Tests
+
+```bash
+# Run tests
+poetry run pytest
+
+# Run tests with coverage
+poetry run pytest --cov=src/marqetive --cov-report=term-missing
+
+# Run platform-specific tests
+poetry run pytest tests/platforms/test_twitter.py
+```
+
+### Code Quality
+
+```bash
+# Lint code with Ruff
+poetry run ruff check .
+
+# Format code with Ruff
+poetry run ruff format .
+
+# Type check with Pyright
+poetry run pyright src/
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+

{marqetive_lib-0.1.5.dist-info → marqetive_lib-0.1.6.dist-info}/RECORD

@@ -30,6 +30,6 @@ marqetive/utils/media.py,sha256=Rvxw9XKU65n-z4G1bEihG3wXZBmjSDZUqClfjGFrg6k,1201
 marqetive/utils/oauth.py,sha256=LQLXpThZUe0XbSpO3dJ5oW3sPRJuKjSk3_f5_3baUzA,12095
 marqetive/utils/retry.py,sha256=lAniJLMNWp9XsHrvU0XBNifpNEjfde4MGfd5hlFTPfA,7636
 marqetive/utils/token_validator.py,sha256=dNvDeHs2Du5UyMMH2ZOW6ydR7OwOEKA4c9e-rG0f9-0,6698
-marqetive_lib-0.1.5.dist-info/METADATA,sha256=3P2xdFayfDwcCkMLSnPty2QJY5C3od4STpI-pg22-WY,7798
-marqetive_lib-0.1.5.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-marqetive_lib-0.1.5.dist-info/RECORD,,
+marqetive_lib-0.1.6.dist-info/METADATA,sha256=Xf_dBnNYwqOSf9GHJuormIVzyb1oRAJI_zQOsebTOxE,7986
+marqetive_lib-0.1.6.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+marqetive_lib-0.1.6.dist-info/RECORD,,

marqetive_lib-0.1.5.dist-info/METADATA

@@ -1,260 +0,0 @@
-Metadata-Version: 2.4
-Name: marqetive-lib
-Version: 0.1.5
-Summary: Modern Python utilities for web APIs
-Keywords: api,utilities,web,http,marqetive
-Requires-Python: >=3.12
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Internet :: WWW/HTTP
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Provides-Extra: dev
-Provides-Extra: docs
-Requires-Dist: aiofiles (>=24.0.0)
-Requires-Dist: httpx (>=0.28.1)
-Requires-Dist: mkdocs (>=1.5.0) ; extra == "docs"
-Requires-Dist: mkdocs-material (>=9.5.0) ; extra == "docs"
-Requires-Dist: mkdocstrings[python] (>=0.30.1) ; extra == "docs"
-Requires-Dist: pydantic (>=2.0.0)
-Requires-Dist: pyright (>=1.1.0) ; extra == "dev"
-Requires-Dist: pytest (>=9.0.0) ; extra == "dev"
-Requires-Dist: pytest-asyncio (>=1.3.0) ; extra == "dev"
-Requires-Dist: pytest-cov (>=7.0.0) ; extra == "dev"
-Requires-Dist: ruff (>=0.14.4) ; extra == "dev"
-Requires-Dist: tweepy (>=4.16.0,<5.0.0)
-Project-URL: Documentation, https://marqetive-lib.readthedocs.io
-Project-URL: Homepage, https://github.com/yourusername/marqetive-lib
-Project-URL: Issues, https://github.com/yourusername/marqetive-lib/issues
-Project-URL: Repository, https://github.com/yourusername/marqetive-lib
-Description-Content-Type: text/markdown
-
-# MarqetiveLib
-
-[![CI](https://github.com/yourusername/marqetive-lib/workflows/CI/badge.svg)](https://github.com/yourusername/marqetive-lib/actions)
-[![codecov](https://codecov.io/gh/yourusername/marqetive-lib/branch/main/graph/badge.svg)](https://codecov.io/gh/yourusername/marqetive-lib)
-[![PyPI version](https://badge.fury.io/py/marqetive-lib.svg)](https://badge.fury.io/py/marqetive-lib)
-[![Python versions](https://img.shields.io/pypi/pyversions/marqetive-lib.svg)](https://pypi.org/project/marqetive-lib/)
-[![License](https://img.shields.io/github/license/yourusername/marqetive-lib.svg)](https://github.com/yourusername/marqetive-lib/blob/main/LICENSE)
-[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://marqetive-lib.readthedocs.io)
-
-Modern Python utilities for web APIs - Simple, type-safe, and async-ready.
-
-## Features
-
-- **🚀 Fast and Lightweight**: Built on httpx with minimal dependencies
-- **🔒 Type-Safe**: Full type hints and Pyright compliance for better IDE support
-- **📦 Zero Learning Curve**: Intuitive API design that feels natural
-- **🧪 Well Tested**: Comprehensive test coverage (>90%)
-- **📚 Excellent Documentation**: Clear examples and detailed API reference
-- **🔄 Async/Await Support**: Built for modern async Python applications
-- **✨ Developer Friendly**: Great error messages and helpful utilities
-
-## Installation
-
-```bash
-pip install marqetive-lib
-```
-
-Or with Poetry:
-
-```bash
-poetry add marqetive-lib
-```
-
-## Quick Start
-
-```python
-import asyncio
-from marqetive_lib import APIClient
-
-async def main():
-    async with APIClient(base_url="https://api.example.com") as client:
-        # Make a GET request
-        response = await client.get("/users/1")
-        print(f"User: {response.data['name']}")
-
-        # Make a POST request
-        new_user = {"name": "John Doe", "email": "john@example.com"}
-        response = await client.post("/users", data=new_user)
-        print(f"Created user ID: {response.data['id']}")
-
-asyncio.run(main())
-```
-
-## Core Features
-
-### Simple HTTP Client
-
-```python
-from marqetive_lib import APIClient
-
-async with APIClient(base_url="https://api.example.com") as client:
-    # GET request with query parameters
-    response = await client.get("/search", params={"q": "python"})
-
-    # POST request with JSON body
-    response = await client.post("/users", data={"name": "Alice"})
-
-    # Access response details
-    print(response.status_code)  # 200
-    print(response.data)         # Parsed JSON response
-    print(response.headers)      # Response headers
-```
-
-### Utility Functions
-
-```python
-from marqetive_lib.utils import (
-    format_response,
-    parse_query_params,
-    build_query_string,
-    merge_headers
-)
-
-# Format JSON responses beautifully
-data = {"users": [{"id": 1, "name": "Alice"}]}
-print(format_response(data, pretty=True, indent=2))
-
-# Parse URL query parameters
-params = parse_query_params("https://api.com/search?q=python&page=1")
-# {'q': ['python'], 'page': ['1']}
-
-# Build query strings
-query = build_query_string({"search": "api", "limit": 10})
-# "search=api&limit=10"
-
-# Merge HTTP headers
-headers = merge_headers(
-    {"Content-Type": "application/json"},
-    {"Authorization": "Bearer token"}
-)
-```
-
-### Type-Safe Responses
-
-```python
-from marqetive_lib import APIClient
-from pydantic import BaseModel
-
-class User(BaseModel):
-    id: int
-    name: str
-    email: str
-
-async with APIClient(base_url="https://api.example.com") as client:
-    response = await client.get("/users/1")
-    user = User(**response.data)  # Automatic validation
-    print(user.name)
-```
-
-## Documentation
-
-Full documentation is available at [marqetive-lib.readthedocs.io](https://marqetive-lib.readthedocs.io)
-
-- [Getting Started Guide](https://marqetive-lib.readthedocs.io/getting-started/)
-- [API Reference](https://marqetive-lib.readthedocs.io/api/core/)
-- [Examples](https://marqetive-lib.readthedocs.io/examples/basic/)
-- [Contributing Guide](https://marqetive-lib.readthedocs.io/contributing/)
-
-## Requirements
-
-- Python 3.9+
-- httpx >= 0.27.0
-- pydantic >= 2.0.0
-
-## Development
-
-### Setup Development Environment
-
-```bash
-# Clone the repository
-git clone https://github.com/yourusername/marqetive-lib.git
-cd marqetive-lib
-
-# Install Poetry if you haven't already
-curl -sSL https://install.python-poetry.org | python3 -
-
-# Install dependencies
-poetry install --with dev,docs
-
-# Activate virtual environment
-poetry shell
-```
-
-### Running Tests
-
-```bash
-# Run tests
-poetry run pytest
-
-# Run tests with coverage
-poetry run pytest --cov=src/marqetive_lib --cov-report=term-missing
-
-# Run tests for specific Python versions
-poetry run tox
-```
-
-### Code Quality
-
-```bash
-# Lint code with Ruff
-poetry run ruff check .
-
-# Format code with Ruff
-poetry run ruff format .
-
-# Type check with Pyright
-poetry run pyright src/
-```
-
-### Building Documentation
-
-```bash
-# Serve documentation locally with live reload
-poetry run mkdocs serve
-
-# Build static documentation
-poetry run mkdocs build
-```
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on:
-
-- Code of conduct
-- Development workflow
-- Code style guidelines
-- Testing requirements
-- Pull request process
-
-## Changelog
-
-See [CHANGELOG.md](CHANGELOG.md) for a list of changes in each release.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Acknowledgments
-
-- Built with [httpx](https://www.python-httpx.org/) for HTTP requests
-- Uses [Pydantic](https://docs.pydantic.dev/) for data validation
-- Tested with [pytest](https://pytest.org/)
-- Documentation powered by [MkDocs Material](https://squidfunk.github.io/mkdocs-material/)
-
-## Support
-
-- **Documentation**: [marqetive-lib.readthedocs.io](https://marqetive-lib.readthedocs.io)
-- **Issues**: [GitHub Issues](https://github.com/yourusername/marqetive-lib/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/yourusername/marqetive-lib/discussions)
-
-## Links
-
-- **PyPI**: [pypi.org/project/marqetive-lib](https://pypi.org/project/marqetive-lib/)
-- **Source Code**: [github.com/yourusername/marqetive-lib](https://github.com/yourusername/marqetive-lib)
-- **Documentation**: [marqetive-lib.readthedocs.io](https://marqetive-lib.readthedocs.io)
-- **Changelog**: [CHANGELOG.md](CHANGELOG.md)
-