unipost 0.1.0__tar.gz

unipost-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,19 @@
+name: Publish
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

unipost-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,22 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/
+      - run: mypy unipost/ --ignore-missing-imports

unipost-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.env
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.DS_Store

unipost-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: unipost
+Version: 0.1.0
+Summary: Official UniPost API client for Python
+Project-URL: Homepage, https://unipost.dev
+Project-URL: Documentation, https://unipost.dev/docs
+Project-URL: Repository, https://github.com/unipost-dev/sdk-python
+Project-URL: Issues, https://github.com/unipost-dev/sdk-python/issues
+Author-email: UniPost <hello@unipost.dev>
+License-Expression: MIT
+Keywords: api,instagram,linkedin,social-media,twitter,unipost
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: async
+Requires-Dist: httpx>=0.25.0; extra == 'async'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.25.0; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# unipost
+
+Official UniPost API client for Python.
+Post to 7 social platforms with one API call.
+
+## Installation
+
+```bash
+pip install unipost
+```
+
+For async support:
+
+```bash
+pip install unipost[async]
+```
+
+## Quick Start
+
+```python
+from unipost import UniPost
+
+# Reads UNIPOST_API_KEY from environment automatically
+client = UniPost()
+
+post = client.posts.create(
+    caption="Hello from UniPost! 🚀",
+    account_ids=["sa_twitter_xxx", "sa_linkedin_xxx"],
+)
+```
+
+## Usage
+
+### List Accounts
+
+```python
+result = client.accounts.list()
+accounts = result["data"]
+
+# Filter by platform
+twitter = client.accounts.list(platform="twitter")
+```
+
+### Create Posts
+
+```python
+# Immediate publish
+post = client.posts.create(
+    caption="Hello world!",
+    account_ids=["sa_twitter_xxx"],
+)
+
+# Scheduled
+post = client.posts.create(
+    caption="Scheduled post",
+    account_ids=["sa_twitter_xxx"],
+    scheduled_at="2026-04-28T09:00:00Z",
+)
+
+# Per-platform captions
+post = client.posts.create(
+    platform_posts=[
+        {"account_id": "sa_twitter_xxx", "caption": "Short tweet 🐦"},
+        {"account_id": "sa_linkedin_xxx", "caption": "Longer LinkedIn version..."},
+    ]
+)
+
+# Save as draft
+draft = client.posts.create(
+    caption="Work in progress",
+    account_ids=["sa_twitter_xxx"],
+    status="draft",
+)
+```
+
+### Async
+
+```python
+from unipost import AsyncUniPost
+
+async def main():
+    client = AsyncUniPost()
+    post = await client.posts.create(
+        caption="Async post!",
+        account_ids=["sa_twitter_xxx"],
+    )
+```
+
+### Webhook Verification
+
+```python
+from unipost import verify_webhook_signature
+
+is_valid = verify_webhook_signature(
+    payload=request.body,
+    signature=request.headers["X-UniPost-Signature"],
+    secret=os.environ["UNIPOST_WEBHOOK_SECRET"],
+)
+```
+
+## Error Handling
+
+```python
+from unipost import UniPost, AuthError, RateLimitError, UniPostError
+
+try:
+    post = client.posts.create(...)
+except AuthError:
+    print("API key invalid")
+except RateLimitError as e:
+    print(f"Rate limited, retry after {e.retry_after}s")
+except UniPostError as e:
+    print(f"API error: {e.status} {e.code} {e}")
+```
+
+## Type Hints
+
+Full type annotations included. Works with mypy.
+
+```python
+from unipost import Post, SocialAccount
+```
+
+## License
+
+MIT

unipost-0.1.0/README.md

@@ -0,0 +1,126 @@
+# unipost
+
+Official UniPost API client for Python.
+Post to 7 social platforms with one API call.
+
+## Installation
+
+```bash
+pip install unipost
+```
+
+For async support:
+
+```bash
+pip install unipost[async]
+```
+
+## Quick Start
+
+```python
+from unipost import UniPost
+
+# Reads UNIPOST_API_KEY from environment automatically
+client = UniPost()
+
+post = client.posts.create(
+    caption="Hello from UniPost! 🚀",
+    account_ids=["sa_twitter_xxx", "sa_linkedin_xxx"],
+)
+```
+
+## Usage
+
+### List Accounts
+
+```python
+result = client.accounts.list()
+accounts = result["data"]
+
+# Filter by platform
+twitter = client.accounts.list(platform="twitter")
+```
+
+### Create Posts
+
+```python
+# Immediate publish
+post = client.posts.create(
+    caption="Hello world!",
+    account_ids=["sa_twitter_xxx"],
+)
+
+# Scheduled
+post = client.posts.create(
+    caption="Scheduled post",
+    account_ids=["sa_twitter_xxx"],
+    scheduled_at="2026-04-28T09:00:00Z",
+)
+
+# Per-platform captions
+post = client.posts.create(
+    platform_posts=[
+        {"account_id": "sa_twitter_xxx", "caption": "Short tweet 🐦"},
+        {"account_id": "sa_linkedin_xxx", "caption": "Longer LinkedIn version..."},
+    ]
+)
+
+# Save as draft
+draft = client.posts.create(
+    caption="Work in progress",
+    account_ids=["sa_twitter_xxx"],
+    status="draft",
+)
+```
+
+### Async
+
+```python
+from unipost import AsyncUniPost
+
+async def main():
+    client = AsyncUniPost()
+    post = await client.posts.create(
+        caption="Async post!",
+        account_ids=["sa_twitter_xxx"],
+    )
+```
+
+### Webhook Verification
+
+```python
+from unipost import verify_webhook_signature
+
+is_valid = verify_webhook_signature(
+    payload=request.body,
+    signature=request.headers["X-UniPost-Signature"],
+    secret=os.environ["UNIPOST_WEBHOOK_SECRET"],
+)
+```
+
+## Error Handling
+
+```python
+from unipost import UniPost, AuthError, RateLimitError, UniPostError
+
+try:
+    post = client.posts.create(...)
+except AuthError:
+    print("API key invalid")
+except RateLimitError as e:
+    print(f"Rate limited, retry after {e.retry_after}s")
+except UniPostError as e:
+    print(f"API error: {e.status} {e.code} {e}")
+```
+
+## Type Hints
+
+Full type annotations included. Works with mypy.
+
+```python
+from unipost import Post, SocialAccount
+```
+
+## License
+
+MIT

unipost-0.1.0/examples/async_example.py

@@ -0,0 +1,24 @@
+"""Async usage with AsyncUniPost (requires httpx)."""
+
+import asyncio
+from unipost import AsyncUniPost
+
+
+async def main():
+    client = AsyncUniPost()
+
+    # List accounts
+    result = await client.accounts.list()
+    accounts = result["data"]
+    print(f"Found {len(accounts)} accounts")
+
+    if accounts:
+        # Create a post
+        post = await client.posts.create(
+            caption="Async post from Python! 🐍",
+            account_ids=[accounts[0].id],
+        )
+        print(f"Post: {post.id} ({post.status})")
+
+
+asyncio.run(main())

unipost-0.1.0/examples/per_platform.py

@@ -0,0 +1,28 @@
+"""Per-platform captions: Different copy for each platform."""
+
+from unipost import UniPost
+
+client = UniPost()
+
+post = client.posts.create(
+    platform_posts=[
+        {
+            "account_id": "sa_twitter_xxx",
+            "caption": "Short and punchy for Twitter 🐦",
+        },
+        {
+            "account_id": "sa_linkedin_xxx",
+            "caption": (
+                "I'm excited to share that we've shipped the UniPost Python SDK "
+                "— a unified API client for posting to 7 social platforms.\n\n"
+                "#DevTools #SocialMedia"
+            ),
+        },
+        {
+            "account_id": "sa_bluesky_xxx",
+            "caption": "Just shipped unipost Python SDK 🦋",
+        },
+    ]
+)
+
+print(f"Multi-platform post: {post.id}")

unipost-0.1.0/examples/quickstart.py

@@ -0,0 +1,23 @@
+"""Quick Start: Create your first post with UniPost."""
+
+from unipost import UniPost
+
+# Reads UNIPOST_API_KEY from environment automatically
+client = UniPost()
+
+# List connected accounts
+result = client.accounts.list()
+accounts = result["data"]
+print(f"Found {len(accounts)} connected accounts")
+
+if not accounts:
+    print("Connect an account first at https://app.unipost.dev")
+    exit()
+
+# Create a post
+post = client.posts.create(
+    caption="Hello from UniPost Python SDK! 🚀",
+    account_ids=[a.id for a in accounts],
+)
+
+print(f"Post created: {post.id} (status: {post.status})")

unipost-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "unipost"
+version = "0.1.0"
+description = "Official UniPost API client for Python"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "UniPost", email = "hello@unipost.dev" }]
+keywords = ["unipost", "social-media", "api", "twitter", "linkedin", "instagram"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+async = ["httpx>=0.25.0"]
+dev = ["pytest", "pytest-asyncio", "httpx>=0.25.0", "mypy", "ruff"]
+
+[project.urls]
+Homepage = "https://unipost.dev"
+Documentation = "https://unipost.dev/docs"
+Repository = "https://github.com/unipost-dev/sdk-python"
+Issues = "https://github.com/unipost-dev/sdk-python/issues"

unipost-0.1.0/tests/test_client.py

@@ -0,0 +1,40 @@
+import os
+import pytest
+from unipost import UniPost, AsyncUniPost
+
+
+def test_requires_api_key():
+    # Ensure env var is not set
+    key = os.environ.pop("UNIPOST_API_KEY", None)
+    try:
+        with pytest.raises(ValueError, match="API key is required"):
+            UniPost()
+    finally:
+        if key:
+            os.environ["UNIPOST_API_KEY"] = key
+
+
+def test_accepts_explicit_api_key():
+    client = UniPost(api_key="up_test_xxx")
+    assert client.posts is not None
+    assert client.accounts is not None
+    assert client.media is not None
+    assert client.analytics is not None
+    assert client.connect is not None
+    assert client.users is not None
+
+
+def test_async_requires_api_key():
+    key = os.environ.pop("UNIPOST_API_KEY", None)
+    try:
+        with pytest.raises(ValueError, match="API key is required"):
+            AsyncUniPost()
+    finally:
+        if key:
+            os.environ["UNIPOST_API_KEY"] = key
+
+
+def test_async_accepts_explicit_api_key():
+    client = AsyncUniPost(api_key="up_test_xxx")
+    assert client.posts is not None
+    assert client.accounts is not None

unipost-0.1.0/tests/test_types.py

@@ -0,0 +1,30 @@
+from unipost.types import SocialAccount, Post, _from_dict
+
+
+def test_social_account_from_dict():
+    data = {
+        "id": "sa_1",
+        "platform": "twitter",
+        "account_name": "unipost",
+        "status": "active",
+        "connected_at": "2026-04-09T00:00:00Z",
+        "connection_type": "byo",
+        "unknown_field": "ignored",
+    }
+    account = _from_dict(SocialAccount, data)
+    assert account.id == "sa_1"
+    assert account.platform == "twitter"
+    assert account.account_name == "unipost"
+
+
+def test_post_from_dict():
+    data = {
+        "id": "post_1",
+        "caption": "Hello",
+        "status": "published",
+        "created_at": "2026-04-09T00:00:00Z",
+    }
+    post = _from_dict(Post, data)
+    assert post.id == "post_1"
+    assert post.caption == "Hello"
+    assert post.results == []

unipost-0.1.0/tests/test_webhook.py

@@ -0,0 +1,18 @@
+import hashlib
+import hmac
+from unipost.webhook import verify_webhook_signature
+
+
+def test_valid_signature():
+    secret = "whsec_test"
+    payload = '{"event":"post.published"}'
+    sig = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest()
+    assert verify_webhook_signature(payload=payload, signature=sig, secret=secret) is True
+
+
+def test_invalid_signature():
+    assert verify_webhook_signature(
+        payload='{"event":"post.published"}',
+        signature="0" * 64,
+        secret="whsec_test",
+    ) is False

unipost-0.1.0/unipost/__init__.py

@@ -0,0 +1,44 @@
+"""Official UniPost API client for Python."""
+
+from unipost.client import UniPost
+from unipost.async_client import AsyncUniPost
+from unipost.errors import (
+    UniPostError,
+    AuthError,
+    NotFoundError,
+    ValidationError,
+    RateLimitError,
+    PlatformError,
+    QuotaError,
+)
+from unipost.webhook import verify_webhook_signature
+from unipost.types import (
+    SocialAccount,
+    Post,
+    PlatformResult,
+    ConnectSession,
+    ManagedUser,
+    PostAnalytics,
+    AnalyticsRollup,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "UniPost",
+    "AsyncUniPost",
+    "UniPostError",
+    "AuthError",
+    "NotFoundError",
+    "ValidationError",
+    "RateLimitError",
+    "PlatformError",
+    "QuotaError",
+    "verify_webhook_signature",
+    "SocialAccount",
+    "Post",
+    "PlatformResult",
+    "ConnectSession",
+    "ManagedUser",
+    "PostAnalytics",
+    "AnalyticsRollup",
+]