marqetive-lib 0.1.0__py3-none-any.whl

marqetive_lib-0.1.0.dist-info/METADATA

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: marqetive-lib
+Version: 0.1.0
+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: License :: OSI Approved :: MIT License
+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)
+

marqetive_lib-0.1.0.dist-info/RECORD

@@ -0,0 +1,43 @@
+marqetive/__init__.py,sha256=o5Ntw1dibTu5LKbhtSe1XfNxmHIeOOdyvZ2lQMxt_Ok,3106
+marqetive/core/__init__.py,sha256=qOC6JhGjWOpj9_7umtc6VGH16ZJZE6iNDhA6iDZm8kg,113
+marqetive/core/account_factory.py,sha256=3PrkWPdeUS8K8yaMufCsc-mhNN8k_9oDUo_ltnkMSPY,7145
+marqetive/core/base_manager.py,sha256=tbuwO2QQaSup_UXMCtmETcNutzCFV0omvroUM7yHFKA,10031
+marqetive/core/client.py,sha256=GBgWzkgdMRMyoCy5dXdEFFzPne6Usp_9i0UxaG7Xd-Y,3226
+marqetive/core/progress.py,sha256=5Vyksf8YfQUVRudwDEuegcxoc0js5qbHM2SFZ6VLxHM,8593
+marqetive/core/registry.py,sha256=6BBY30qgQBUWf2av73S4E2hEx0uqM7HFn_AGPfCv3KU,8080
+marqetive/platforms/__init__.py,sha256=2rC_xqx0Xf0LJy87GcFUpQe5DeMg-cgYEI5Uv6uoM54,1339
+marqetive/platforms/base.py,sha256=y37RkSb3AGHtU-JmjxlUgbwlqG2MmF7w4MI3FATHoG4,11945
+marqetive/platforms/exceptions.py,sha256=C8H0vsICM6amtQTz1iwXjc3duFGq-M71N7QqsLElt1M,7029
+marqetive/platforms/instagram/__init__.py,sha256=dFrDIyKGdw8AsRRYb_AjW1R8PWkxqytM-nrjuAvbw0A,331
+marqetive/platforms/instagram/client.py,sha256=XuvWl0aRHdAFScjOf4x4reQWkfZXdtGKmh1lIWcj4Lc,24939
+marqetive/platforms/instagram/exceptions.py,sha256=zwTc90VbG8uz_6O5bKw68Pp53SoevLQUqPiXj4ZgThU,8983
+marqetive/platforms/instagram/factory.py,sha256=qo7kLk7IoVWGjB0hJbkQqesOveN4gidw0kUh_7SzvaM,3533
+marqetive/platforms/instagram/manager.py,sha256=ZCqdlz5DgOhKUb1n2WOviLsr4NQxfBT4KiycSRv3Q-4,3714
+marqetive/platforms/instagram/media.py,sha256=JDRFB66UlhSjAf0PFR3raGqYxtNTSd5yIZ_2xTGmZRk,21166
+marqetive/platforms/linkedin/__init__.py,sha256=r-1p9yaJO4n8wYWNtN32Quwar6eAWkF5EtFN-v2AdPg,321
+marqetive/platforms/linkedin/client.py,sha256=ddcKmVN2d0ow2abfnaNSeswRsoYREdxj-J9w711zsy0,23558
+marqetive/platforms/linkedin/exceptions.py,sha256=WHjMZ-XJnKgT6uzzi7LXqFt4lD7nSCjzMzaqtOQA3hM,9767
+marqetive/platforms/linkedin/factory.py,sha256=N8POv4vMSg1L8PYnV9-JpHgYlaa33AfeWUhh6UPkViI,4516
+marqetive/platforms/linkedin/manager.py,sha256=K_X74qenJyd5HIL3KtsKpHjQOz48uENFJabZdsXwE-Y,3984
+marqetive/platforms/linkedin/media.py,sha256=360OT1sdBuJRjuL3wJ-T1irAX5gHmcf4AwAU__cvwwA,16901
+marqetive/platforms/models.py,sha256=8NSIh-fT5gFHCvs6A5dnnsfhsklpSfNgD_ovDPVv1aY,10860
+marqetive/platforms/tiktok/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+marqetive/platforms/twitter/__init__.py,sha256=zDEslH3Y6zCnFlYaoW77bkO7j75OmABjqMf1BGh8P5M,313
+marqetive/platforms/twitter/client.py,sha256=vHaYYFNCUJJuOykmiEYBge2CM_kYqKwGdptdqGJE5Ic,20820
+marqetive/platforms/twitter/exceptions.py,sha256=aKrjUZL07KWQ8hatj5-U7UfnSTl-n8DnTgGGigYCrIY,8931
+marqetive/platforms/twitter/factory.py,sha256=JzcNaNfbi2s6BA7r4_vwpWbUpzIUMrtYSvvWY30R2O0,5266
+marqetive/platforms/twitter/manager.py,sha256=QlPrVniPbJdlt39iMi_hmDGpaMkPT7pNjjIYUre2byY,4092
+marqetive/platforms/twitter/media.py,sha256=16atvKwSukvK_YC_gIm2qsl3pmidWEBAwIfJBPG9HQo,24968
+marqetive/platforms/twitter/threads.py,sha256=xksMvYD__Cr5ZCH70nHEp1UQe_2xtOknCOcPWjhtPsw,14764
+marqetive/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+marqetive/registry_init.py,sha256=KuahtT6SZPeGReFHZznkeKCLctd_TrpwJUoCQ_igXL8,2035
+marqetive/utils/__init__.py,sha256=bSrNajbxYBSKQayrPviLz8JeGjplnyK8y_NGDtgb7yQ,977
+marqetive/utils/file_handlers.py,sha256=4TP5kmWofNTSZmlS683CM1UYP83WvRd_NubMbqtXv-g,12568
+marqetive/utils/helpers.py,sha256=8-ljhL47SremKcQO2GF8DIHOPODEv1rSioVNuSPCbec,2634
+marqetive/utils/media.py,sha256=Rvxw9XKU65n-z4G1bEihG3wXZBmjSDZUqClfjGFrg6k,12013
+marqetive/utils/oauth.py,sha256=6X8FrF4bDVqX-Jf7dAgzdUCR7zqdbAM4FjjBEGXNoaE,7913
+marqetive/utils/retry.py,sha256=lAniJLMNWp9XsHrvU0XBNifpNEjfde4MGfd5hlFTPfA,7636
+marqetive/utils/token_validator.py,sha256=pNimFr_FNJLcYGV5oADhoBjflKfEbLQ3Epwnwg_nTbg,6703
+marqetive_lib-0.1.0.dist-info/METADATA,sha256=zW6nD-GCt2z5LtWPMmhydFTvFM3ddTMSMN2gfL8ipcw,7849
+marqetive_lib-0.1.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+marqetive_lib-0.1.0.dist-info/RECORD,,

marqetive_lib-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any