mentio 0.2.1__tar.gz

mentio-0.2.1/.gitignore

@@ -0,0 +1,7 @@
+dist/
+.venv/
+__pycache__/
+*.pyc
+.ruff_cache/
+.pytest_cache/
+uv.lock

mentio-0.2.1/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.5
+Name: mentio
+Version: 0.2.1
+Summary: Python client for the Mentio API: social listening across developer platforms.
+Project-URL: Homepage, https://docs.mentio.dev/sdks/python
+Project-URL: Documentation, https://docs.mentio.dev/sdks/python
+Project-URL: Repository, https://github.com/PauGuirao/mentions
+Author: Mentio
+License-Expression: MIT
+Keywords: api client,brand monitoring,mentio,openapi,social listening
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: httpx<0.29.0,>=0.23.1
+Description-Content-Type: text/markdown
+
+# mentio
+
+Python client for the [Mentio API](https://docs.mentio.dev): social listening across Bluesky, Hacker News, Reddit, X, GitHub, Stack Overflow, DEV, YouTube, LinkedIn and news. Generated from the API's OpenAPI document and regenerated whenever the API changes, so it is always complete. Python 3.11+, sync and async, typed.
+
+```bash
+pip install mentio
+```
+
+```python
+from mentio import Mentio
+
+mentio = Mentio(api_key="mk_live_...")
+
+for mention in mentio.mentions.search(platform="reddit", relevant=True, limit=25).data:
+    print(mention.post.platform.value, mention.classification.relevance, mention.post.url)
+
+keyword = mentio.keywords.create(term="acme", kind="brand")
+mentio.mentions.update("mm_7f3a...", status="done")
+summary = mentio.analytics.summary(range_="7d", compare=True, timezone="Europe/Madrid")
+```
+
+One object, one call per endpoint, grouped by resource: `keywords`, `mentions`, `people`, `segments`, `alerts`, `channels`, `company`, `analytics`, `api_keys`, `system`. Enum-valued arguments take plain strings, instants take a `datetime`, an ISO 8601 string or epoch milliseconds, bodies take a dict, a model or their fields as keyword arguments. A non-2xx raises `MentioError` with the API's `status`, `code` and `message`. `AsyncMentio` mirrors every call for `asyncio`.
+
+The full guide is at [docs.mentio.dev/sdks/python](https://docs.mentio.dev/sdks/python).

mentio-0.2.1/README.md

@@ -0,0 +1,24 @@
+# mentio
+
+Python client for the [Mentio API](https://docs.mentio.dev): social listening across Bluesky, Hacker News, Reddit, X, GitHub, Stack Overflow, DEV, YouTube, LinkedIn and news. Generated from the API's OpenAPI document and regenerated whenever the API changes, so it is always complete. Python 3.11+, sync and async, typed.
+
+```bash
+pip install mentio
+```
+
+```python
+from mentio import Mentio
+
+mentio = Mentio(api_key="mk_live_...")
+
+for mention in mentio.mentions.search(platform="reddit", relevant=True, limit=25).data:
+    print(mention.post.platform.value, mention.classification.relevance, mention.post.url)
+
+keyword = mentio.keywords.create(term="acme", kind="brand")
+mentio.mentions.update("mm_7f3a...", status="done")
+summary = mentio.analytics.summary(range_="7d", compare=True, timezone="Europe/Madrid")
+```
+
+One object, one call per endpoint, grouped by resource: `keywords`, `mentions`, `people`, `segments`, `alerts`, `channels`, `company`, `analytics`, `api_keys`, `system`. Enum-valued arguments take plain strings, instants take a `datetime`, an ISO 8601 string or epoch milliseconds, bodies take a dict, a model or their fields as keyword arguments. A non-2xx raises `MentioError` with the API's `status`, `code` and `message`. `AsyncMentio` mirrors every call for `asyncio`.
+
+The full guide is at [docs.mentio.dev/sdks/python](https://docs.mentio.dev/sdks/python).

mentio-0.2.1/mentio/__init__.py

@@ -0,0 +1,13 @@
+"""A client library for accessing Mentio API"""
+
+from ._facade import DEFAULT_BASE_URL, AsyncMentio, Mentio, MentioError
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "DEFAULT_BASE_URL",
+    "AsyncMentio",
+    "AuthenticatedClient",
+    "Client",
+    "Mentio",
+    "MentioError",
+)