postpeer 0.1.0__tar.gz

postpeer-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,75 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.9.26"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - run: uv sync --frozen --extra dev
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy
+      - run: uv run pytest
+
+  generated:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.30.1
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.9.26"
+          python-version: "3.13"
+          enable-cache: true
+      - run: pnpm install --frozen-lockfile
+      - run: uv sync --frozen --extra dev
+      - run: pnpm generate
+      - name: Verify generated SDK is current
+        run: git diff --exit-code -- openapi.json src/postpeer/_generated src/postpeer/resources/_generated.py
+
+  package:
+    runs-on: ubuntu-latest
+    needs: [test, generated]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.9.26"
+          python-version: "3.13"
+          enable-cache: true
+      - run: uv sync --frozen --extra dev
+      - run: uv build
+      - run: uv run twine check dist/*
+      - name: Verify wheel import
+        run: |
+          uv venv --python 3.13 .wheel-venv
+          uv pip install --python .wheel-venv/bin/python dist/*.whl
+          .wheel-venv/bin/python -c "from postpeer import PostPeer, AsyncPostPeer"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/

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

@@ -0,0 +1,34 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    if: startsWith(github.event.release.tag_name, 'v')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/postpeer/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.9.26"
+          python-version: "3.13"
+          enable-cache: true
+      - run: uv sync --frozen --extra dev
+      - run: uv build
+      - run: uv run twine check dist/*
+      - name: Verify tag matches package version
+        run: |
+          PACKAGE_VERSION=$(uv run python -c "from postpeer import __version__; print(__version__)")
+          test "v${PACKAGE_VERSION}" = "${{ github.event.release.tag_name }}"
+      - uses: pypa/gh-action-pypi-publish@release/v1

postpeer-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.coverage
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+node_modules/
+.pnpm-store/

postpeer-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+- Initial official PostPeer Python SDK.
+- Synchronous and asynchronous HTTPX clients.
+- OpenAPI-generated Pydantic models and resource methods.

postpeer-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 PostPeer
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

postpeer-0.1.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: postpeer
+Version: 0.1.0
+Summary: The official Python SDK for the PostPeer API
+Project-URL: Homepage, https://postpeer.dev
+Project-URL: Documentation, https://docs.postpeer.dev
+Project-URL: Repository, https://github.com/PostPeer-API/postpeer-python
+Project-URL: Issues, https://github.com/PostPeer-API/postpeer-python/issues
+Author: PostPeer
+License: Apache-2.0
+License-File: LICENSE
+Keywords: api,postpeer,sdk,social-media
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic[email]<3,>=2
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: hatchling>=1.27; extra == 'dev'
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=6; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Requires-Dist: twine>=6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PostPeer Python SDK
+
+The official Python SDK for the [PostPeer API](https://postpeer.dev), generated
+from PostPeer's OpenAPI contract with [Hey API](https://heyapi.dev/).
+
+## Installation
+
+```bash
+pip install postpeer
+```
+
+Python 3.10 or newer is required.
+
+## Quick start
+
+```python
+from postpeer import PostPeer
+
+client = PostPeer()  # Reads POSTPEER_API_KEY
+
+post = client.posts.create(
+    content="Hello from PostPeer!",
+    platforms=[{"platform": "twitter", "accountId": "integration-id"}],
+    publish_now=True,
+)
+
+print(post.post_id)
+client.close()
+```
+
+The client can also be used as a context manager:
+
+```python
+with PostPeer(api_key="your-access-key") as client:
+    profiles = client.profiles.list()
+```
+
+## Async usage
+
+`AsyncPostPeer` has the same resources and method names:
+
+```python
+import asyncio
+
+from postpeer import AsyncPostPeer
+
+
+async def main() -> None:
+    async with AsyncPostPeer() as client:
+        posts = await client.posts.list(status="scheduled")
+        print(posts)
+
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+import httpx
+
+from postpeer import PostPeer
+
+transport = httpx.Client(http2=True)
+client = PostPeer(
+    api_key="your-access-key",
+    base_url="https://api.postpeer.dev",
+    timeout=60.0,
+    max_retries=2,
+    default_headers={"X-Application": "my-app"},
+    http_client=transport,
+)
+```
+
+Each SDK instance is isolated. An injected HTTPX client remains owned by the
+caller and is not closed by the SDK.
+
+## Resources
+
+The resource hierarchy matches the official Node.js SDK:
+
+```python
+client.health.check()
+client.health.verify_access_key()
+
+client.connect.get_oauth_url(platform="linkedin")
+client.connect.linkedin.get_selection(token="...")
+client.connect.integrations.list()
+
+client.profiles.create(name="Marketing")
+client.apps.list()
+client.notifications.list()
+client.platforms.list()
+
+client.posts.create(content="Hello", platforms=[...], publish_now=True)
+client.posts.list(status="scheduled")
+client.posts.get(post_id="...")
+client.posts.delete(post_id="...")
+client.posts.scheduled.list()
+client.posts.scheduled.cancel(post_id="...")
+
+client.media.upload(filename="image.png", mime_type="image/png")
+client.analytics.get()
+client.usage.get()
+client.pinterest.get_boards(account_id="...")
+client.tiktok.get_creator_info(account_id="...")
+client.ai.write(description="A launch announcement", platforms=["linkedin"])
+```
+
+Parameters use Python `snake_case`; the SDK serializes their OpenAPI aliases on
+the wire. Responses are validated Pydantic v2 models. All generated models and
+enums are available from `postpeer.types`.
+
+## Errors
+
+```python
+from postpeer import NotFoundError, RateLimitError
+
+try:
+    client.posts.get(post_id="missing")
+except NotFoundError as error:
+    print(error.status, error.request_id, error.message)
+except RateLimitError:
+    print("PostPeer rate limit reached")
+```
+
+The SDK exports typed API, connection, timeout, and response-validation errors.
+
+## Retries and request options
+
+GET, PUT, and DELETE requests retry transient connection failures, 408, 409,
+429, and 5xx responses by default. POST and PATCH are not automatically retried,
+because replaying an ambiguous request could publish or create a resource twice.
+
+Use `RequestOptions` for an explicit per-call override:
+
+```python
+from postpeer import RequestOptions
+
+client.posts.create(
+    content="Hello",
+    platforms=[...],
+    publish_now=True,
+    _request_options=RequestOptions(
+        timeout=30.0,
+        max_retries=2,
+        retry_non_idempotent=True,
+    ),
+)
+```
+
+## Updating generated code
+
+The OpenAPI specification and package releases are intentionally separate:
+
+```bash
+pnpm spec:fetch
+pnpm generate
+uv run ruff format .
+uv run ruff check .
+uv run mypy
+uv run pytest
+```
+
+`openapi.json`, `src/postpeer/_generated`, and
+`src/postpeer/resources/_generated.py` must be committed together. Generated
+files must not be edited manually.
+
+Hey API 0.0.24 currently generates the Pydantic models. A deterministic
+PostPeer-owned generator emits the sync and async resources until Hey API's
+Python runtime is mature enough to replace it.
+
+## Versioning
+
+PostPeer uses conservative pre-1.0 versioning. Compatible additions remain in
+`0.1.x`; a breaking SDK change moves to `0.2.0`; `1.0.0` is reserved for a
+stable public contract.

postpeer-0.1.0/README.md

@@ -0,0 +1,177 @@
+# PostPeer Python SDK
+
+The official Python SDK for the [PostPeer API](https://postpeer.dev), generated
+from PostPeer's OpenAPI contract with [Hey API](https://heyapi.dev/).
+
+## Installation
+
+```bash
+pip install postpeer
+```
+
+Python 3.10 or newer is required.
+
+## Quick start
+
+```python
+from postpeer import PostPeer
+
+client = PostPeer()  # Reads POSTPEER_API_KEY
+
+post = client.posts.create(
+    content="Hello from PostPeer!",
+    platforms=[{"platform": "twitter", "accountId": "integration-id"}],
+    publish_now=True,
+)
+
+print(post.post_id)
+client.close()
+```
+
+The client can also be used as a context manager:
+
+```python
+with PostPeer(api_key="your-access-key") as client:
+    profiles = client.profiles.list()
+```
+
+## Async usage
+
+`AsyncPostPeer` has the same resources and method names:
+
+```python
+import asyncio
+
+from postpeer import AsyncPostPeer
+
+
+async def main() -> None:
+    async with AsyncPostPeer() as client:
+        posts = await client.posts.list(status="scheduled")
+        print(posts)
+
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+import httpx
+
+from postpeer import PostPeer
+
+transport = httpx.Client(http2=True)
+client = PostPeer(
+    api_key="your-access-key",
+    base_url="https://api.postpeer.dev",
+    timeout=60.0,
+    max_retries=2,
+    default_headers={"X-Application": "my-app"},
+    http_client=transport,
+)
+```
+
+Each SDK instance is isolated. An injected HTTPX client remains owned by the
+caller and is not closed by the SDK.
+
+## Resources
+
+The resource hierarchy matches the official Node.js SDK:
+
+```python
+client.health.check()
+client.health.verify_access_key()
+
+client.connect.get_oauth_url(platform="linkedin")
+client.connect.linkedin.get_selection(token="...")
+client.connect.integrations.list()
+
+client.profiles.create(name="Marketing")
+client.apps.list()
+client.notifications.list()
+client.platforms.list()
+
+client.posts.create(content="Hello", platforms=[...], publish_now=True)
+client.posts.list(status="scheduled")
+client.posts.get(post_id="...")
+client.posts.delete(post_id="...")
+client.posts.scheduled.list()
+client.posts.scheduled.cancel(post_id="...")
+
+client.media.upload(filename="image.png", mime_type="image/png")
+client.analytics.get()
+client.usage.get()
+client.pinterest.get_boards(account_id="...")
+client.tiktok.get_creator_info(account_id="...")
+client.ai.write(description="A launch announcement", platforms=["linkedin"])
+```
+
+Parameters use Python `snake_case`; the SDK serializes their OpenAPI aliases on
+the wire. Responses are validated Pydantic v2 models. All generated models and
+enums are available from `postpeer.types`.
+
+## Errors
+
+```python
+from postpeer import NotFoundError, RateLimitError
+
+try:
+    client.posts.get(post_id="missing")
+except NotFoundError as error:
+    print(error.status, error.request_id, error.message)
+except RateLimitError:
+    print("PostPeer rate limit reached")
+```
+
+The SDK exports typed API, connection, timeout, and response-validation errors.
+
+## Retries and request options
+
+GET, PUT, and DELETE requests retry transient connection failures, 408, 409,
+429, and 5xx responses by default. POST and PATCH are not automatically retried,
+because replaying an ambiguous request could publish or create a resource twice.
+
+Use `RequestOptions` for an explicit per-call override:
+
+```python
+from postpeer import RequestOptions
+
+client.posts.create(
+    content="Hello",
+    platforms=[...],
+    publish_now=True,
+    _request_options=RequestOptions(
+        timeout=30.0,
+        max_retries=2,
+        retry_non_idempotent=True,
+    ),
+)
+```
+
+## Updating generated code
+
+The OpenAPI specification and package releases are intentionally separate:
+
+```bash
+pnpm spec:fetch
+pnpm generate
+uv run ruff format .
+uv run ruff check .
+uv run mypy
+uv run pytest
+```
+
+`openapi.json`, `src/postpeer/_generated`, and
+`src/postpeer/resources/_generated.py` must be committed together. Generated
+files must not be edited manually.
+
+Hey API 0.0.24 currently generates the Pydantic models. A deterministic
+PostPeer-owned generator emits the sync and async resources until Hey API's
+Python runtime is mature enough to replace it.
+
+## Versioning
+
+PostPeer uses conservative pre-1.0 versioning. Compatible additions remain in
+`0.1.x`; a breaking SDK change moves to `0.2.0`; `1.0.0` is reserved for a
+stable public contract.

postpeer-0.1.0/openapi-python.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('@hey-api/openapi-python').UserConfig} */
+export default {
+  input: './openapi.json',
+  output: {
+    path: './src/postpeer/_generated',
+  },
+  plugins: ['pydantic'],
+};