repull-sdk 0.2.0__tar.gz

repull_sdk-0.2.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtualenvs
+.venv/
+venv/
+env/
+.python-version
+
+# Tooling caches
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+
+# Local env
+.env
+.env.local

repull_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Divanova Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

repull_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: repull-sdk
+Version: 0.2.0
+Summary: Python SDK for Repull — build vacation-rental tech in Python.
+Project-URL: Homepage, https://repull.dev
+Project-URL: Documentation, https://repull.dev/docs
+Project-URL: API Reference, https://api.repull.dev/openapi.json
+Project-URL: Source, https://github.com/ivannikolovbg/repull-python
+Project-URL: Issues, https://github.com/ivannikolovbg/repull-python/issues
+Author-email: "Divanova Inc." <hello@repull.dev>
+License: MIT
+License-File: LICENSE
+Keywords: airbnb,booking.com,channel-manager,openapi,repull,sdk,vacation-rental,vrbo
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: httpx<1,>=0.23.0
+Requires-Dist: python-dateutil<3,>=2.8.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: types-python-dateutil>=2.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Repull Python SDK
+
+> **Status:** v0.2.0 — beta. API surface stable; minor renames possible before 1.0.
+
+Typed Python client for [api.repull.dev](https://api.repull.dev) — the unified API for vacation-rental tech (50+ PMS platforms, Airbnb / Booking.com / VRBO / Plumguide channels, AI ops, white-label OAuth Connect).
+
+Async by default. Generated from OpenAPI. Fully typed (`attrs` + `httpx`).
+
+## Install
+
+The PyPI package name `repull` is reserved but not yet published. For now, install from git:
+
+```bash
+pip install git+https://github.com/ivannikolovbg/repull-python.git
+```
+
+Once published:
+
+```bash
+pip install repull
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+import asyncio
+import os
+
+from repull import AuthenticatedClient
+from repull.api.reservations import list_reservations
+
+async def main():
+    client = AuthenticatedClient(
+        base_url="https://api.repull.dev",
+        token=os.environ["REPULL_API_KEY"],
+    )
+    async with client as c:
+        page = await list_reservations.asyncio(client=c, limit=10)
+
+    for r in page.data:
+        print(r.id, r.check_in, r.check_out, r.platform)
+
+asyncio.run(main())
+```
+
+There is also a sync flavour for every endpoint — drop the `async with` and call `list_reservations.sync(...)` instead.
+
+## Authentication
+
+Every call goes through `AuthenticatedClient(token=...)`. The token is your Repull API key:
+
+- `sk_test_*` — sandbox
+- `sk_live_*` — production
+
+Get one at [repull.dev/dashboard](https://repull.dev/dashboard) → **API keys**.
+
+## What's in the SDK
+
+The client is generated tag-by-tag from the OpenAPI spec. The modules mirror the API surface:
+
+| Module | Endpoints |
+|---|---|
+| `repull.api.system` | `GET /v1/health` |
+| `repull.api.properties` | list / get properties |
+| `repull.api.reservations` | list / get / create / patch / delete reservations |
+| `repull.api.availability` | per-property calendar read + bulk write |
+| `repull.api.guests` | guest CRM list + detail |
+| `repull.api.conversations` | list threads, read & post messages |
+| `repull.api.connect` | white-label OAuth Connect — list, status, create, disconnect |
+| `repull.api.webhooks` | manage subscriptions + fire test events |
+| `repull.api.airbnb` | listings, pricing, availability, photos, messaging, reservations, reviews, sync |
+| `repull.api.booking_com` | properties, availability, content, messaging, sync |
+| `repull.api.vrbo` | listings, reservations |
+| `repull.api.plumguide` | listings, availability, pricing |
+| `repull.api.ai` | run AI operations (autorespond, smart pricing, etc.) |
+| `repull.api.billing` | view & change plan |
+
+Everything is fully typed — your editor will autocomplete every parameter and every response field.
+
+## Examples
+
+- [`examples/quickstart.py`](examples/quickstart.py) — list 10 reservations.
+- [`examples/connect_airbnb.py`](examples/connect_airbnb.py) — mint a Connect session and poll for the linked Airbnb account.
+
+Run them with a real API key:
+
+```bash
+REPULL_API_KEY=sk_live_... python examples/quickstart.py
+```
+
+## Connect (OAuth)
+
+Repull Connect lets you link a property manager's Airbnb / Booking.com account in a few lines:
+
+```python
+from repull.api.connect import create_connect_session
+from repull.models.create_connect_session_body import CreateConnectSessionBody
+
+session = await create_connect_session.asyncio(
+    client=c,
+    body=CreateConnectSessionBody(
+        redirect_url="https://yourapp.example.com/airbnb/return",
+        allowed_providers=["airbnb"],
+    ),
+)
+# Send the user to session.url
+```
+
+After the user comes back, poll `get_connect_status.asyncio(provider="airbnb", client=c)` to confirm.
+
+## Pagination
+
+Every list endpoint returns the same canonical envelope:
+
+```python
+page = await list_reservations.asyncio(client=c, limit=50)
+page.data                      # list[Reservation]
+page.pagination.next_cursor    # str | None — pass back as `cursor=`
+page.pagination.has_more       # bool — stop when False
+page.pagination.total          # int | UNSET — present when ?include_total=true
+```
+
+Loop until `pagination.has_more` is `False`, threading `pagination.next_cursor`
+back as the next call's `cursor` arg. Cursors are opaque base64 — never parse
+or construct them by hand.
+
+## Error handling
+
+By default, unexpected HTTP statuses return `None` from the high-level `.asyncio()` / `.sync()` calls. To raise instead:
+
+```python
+client = AuthenticatedClient(
+    base_url="https://api.repull.dev",
+    token=os.environ["REPULL_API_KEY"],
+    raise_on_unexpected_status=True,
+)
+```
+
+You can also call `.asyncio_detailed()` / `.sync_detailed()` to get the full `Response` (status code, headers, raw bytes, parsed body).
+
+## Regenerating the client
+
+The repo snapshots the current spec at [`openapi/v1.json`](openapi/v1.json) so codegen is fully reproducible.
+
+```bash
+# Pull a fresh spec from api.repull.dev and regenerate
+./scripts/regen.sh
+
+# Use the snapshot in openapi/v1.json without hitting the network
+./scripts/regen.sh --offline
+```
+
+You'll need [`openapi-python-client`](https://github.com/openapi-generators/openapi-python-client) on your `PATH`:
+
+```bash
+uv tool install openapi-python-client
+# or
+pipx install openapi-python-client
+```
+
+## Reference
+
+- API base: <https://api.repull.dev>
+- OpenAPI spec: <https://api.repull.dev/openapi.json>
+- Product docs: <https://repull.dev/docs>
+- Other SDKs: [`repull-sdk`](https://github.com/ivannikolovbg/repull-sdk) (TypeScript), `repull-php`, `repull-go`, `repull-ruby`, `repull-dotnet`
+
+## License
+
+MIT — see [`LICENSE`](LICENSE). The Python client is a thin auto-generated wrapper, free to use anywhere.
+
+(Note: the TypeScript SDK is licensed differently because it ships a hand-written facade plus the demo + channel-manager template. See [`repull-sdk`](https://github.com/ivannikolovbg/repull-sdk) if you need that.)
+
+---
+
+Powered by [Repull](https://repull.dev). AI features powered by [Vanio AI](https://vanio.ai).

repull_sdk-0.2.0/README.md

@@ -0,0 +1,178 @@
+# Repull Python SDK
+
+> **Status:** v0.2.0 — beta. API surface stable; minor renames possible before 1.0.
+
+Typed Python client for [api.repull.dev](https://api.repull.dev) — the unified API for vacation-rental tech (50+ PMS platforms, Airbnb / Booking.com / VRBO / Plumguide channels, AI ops, white-label OAuth Connect).
+
+Async by default. Generated from OpenAPI. Fully typed (`attrs` + `httpx`).
+
+## Install
+
+The PyPI package name `repull` is reserved but not yet published. For now, install from git:
+
+```bash
+pip install git+https://github.com/ivannikolovbg/repull-python.git
+```
+
+Once published:
+
+```bash
+pip install repull
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+import asyncio
+import os
+
+from repull import AuthenticatedClient
+from repull.api.reservations import list_reservations
+
+async def main():
+    client = AuthenticatedClient(
+        base_url="https://api.repull.dev",
+        token=os.environ["REPULL_API_KEY"],
+    )
+    async with client as c:
+        page = await list_reservations.asyncio(client=c, limit=10)
+
+    for r in page.data:
+        print(r.id, r.check_in, r.check_out, r.platform)
+
+asyncio.run(main())
+```
+
+There is also a sync flavour for every endpoint — drop the `async with` and call `list_reservations.sync(...)` instead.
+
+## Authentication
+
+Every call goes through `AuthenticatedClient(token=...)`. The token is your Repull API key:
+
+- `sk_test_*` — sandbox
+- `sk_live_*` — production
+
+Get one at [repull.dev/dashboard](https://repull.dev/dashboard) → **API keys**.
+
+## What's in the SDK
+
+The client is generated tag-by-tag from the OpenAPI spec. The modules mirror the API surface:
+
+| Module | Endpoints |
+|---|---|
+| `repull.api.system` | `GET /v1/health` |
+| `repull.api.properties` | list / get properties |
+| `repull.api.reservations` | list / get / create / patch / delete reservations |
+| `repull.api.availability` | per-property calendar read + bulk write |
+| `repull.api.guests` | guest CRM list + detail |
+| `repull.api.conversations` | list threads, read & post messages |
+| `repull.api.connect` | white-label OAuth Connect — list, status, create, disconnect |
+| `repull.api.webhooks` | manage subscriptions + fire test events |
+| `repull.api.airbnb` | listings, pricing, availability, photos, messaging, reservations, reviews, sync |
+| `repull.api.booking_com` | properties, availability, content, messaging, sync |
+| `repull.api.vrbo` | listings, reservations |
+| `repull.api.plumguide` | listings, availability, pricing |
+| `repull.api.ai` | run AI operations (autorespond, smart pricing, etc.) |
+| `repull.api.billing` | view & change plan |
+
+Everything is fully typed — your editor will autocomplete every parameter and every response field.
+
+## Examples
+
+- [`examples/quickstart.py`](examples/quickstart.py) — list 10 reservations.
+- [`examples/connect_airbnb.py`](examples/connect_airbnb.py) — mint a Connect session and poll for the linked Airbnb account.
+
+Run them with a real API key:
+
+```bash
+REPULL_API_KEY=sk_live_... python examples/quickstart.py
+```
+
+## Connect (OAuth)
+
+Repull Connect lets you link a property manager's Airbnb / Booking.com account in a few lines:
+
+```python
+from repull.api.connect import create_connect_session
+from repull.models.create_connect_session_body import CreateConnectSessionBody
+
+session = await create_connect_session.asyncio(
+    client=c,
+    body=CreateConnectSessionBody(
+        redirect_url="https://yourapp.example.com/airbnb/return",
+        allowed_providers=["airbnb"],
+    ),
+)
+# Send the user to session.url
+```
+
+After the user comes back, poll `get_connect_status.asyncio(provider="airbnb", client=c)` to confirm.
+
+## Pagination
+
+Every list endpoint returns the same canonical envelope:
+
+```python
+page = await list_reservations.asyncio(client=c, limit=50)
+page.data                      # list[Reservation]
+page.pagination.next_cursor    # str | None — pass back as `cursor=`
+page.pagination.has_more       # bool — stop when False
+page.pagination.total          # int | UNSET — present when ?include_total=true
+```
+
+Loop until `pagination.has_more` is `False`, threading `pagination.next_cursor`
+back as the next call's `cursor` arg. Cursors are opaque base64 — never parse
+or construct them by hand.
+
+## Error handling
+
+By default, unexpected HTTP statuses return `None` from the high-level `.asyncio()` / `.sync()` calls. To raise instead:
+
+```python
+client = AuthenticatedClient(
+    base_url="https://api.repull.dev",
+    token=os.environ["REPULL_API_KEY"],
+    raise_on_unexpected_status=True,
+)
+```
+
+You can also call `.asyncio_detailed()` / `.sync_detailed()` to get the full `Response` (status code, headers, raw bytes, parsed body).
+
+## Regenerating the client
+
+The repo snapshots the current spec at [`openapi/v1.json`](openapi/v1.json) so codegen is fully reproducible.
+
+```bash
+# Pull a fresh spec from api.repull.dev and regenerate
+./scripts/regen.sh
+
+# Use the snapshot in openapi/v1.json without hitting the network
+./scripts/regen.sh --offline
+```
+
+You'll need [`openapi-python-client`](https://github.com/openapi-generators/openapi-python-client) on your `PATH`:
+
+```bash
+uv tool install openapi-python-client
+# or
+pipx install openapi-python-client
+```
+
+## Reference
+
+- API base: <https://api.repull.dev>
+- OpenAPI spec: <https://api.repull.dev/openapi.json>
+- Product docs: <https://repull.dev/docs>
+- Other SDKs: [`repull-sdk`](https://github.com/ivannikolovbg/repull-sdk) (TypeScript), `repull-php`, `repull-go`, `repull-ruby`, `repull-dotnet`
+
+## License
+
+MIT — see [`LICENSE`](LICENSE). The Python client is a thin auto-generated wrapper, free to use anywhere.
+
+(Note: the TypeScript SDK is licensed differently because it ships a hand-written facade plus the demo + channel-manager template. See [`repull-sdk`](https://github.com/ivannikolovbg/repull-sdk) if you need that.)
+
+---
+
+Powered by [Repull](https://repull.dev). AI features powered by [Vanio AI](https://vanio.ai).

repull_sdk-0.2.0/examples/connect_airbnb.py

@@ -0,0 +1,44 @@
+"""Mint a Repull Connect session for Airbnb and poll for the linked account.
+
+Flow:
+  1. Create a Connect session — Repull returns a hosted `url` you redirect the
+     property manager to.
+  2. They land on `connect.repull.dev`, authorise Airbnb, and bounce back to
+     your `redirect_url`.
+  3. Poll the connection status to confirm linkage.
+
+Run with:
+    REPULL_API_KEY=sk_live_... python examples/connect_airbnb.py
+"""
+
+import asyncio
+import os
+
+from repull import AuthenticatedClient
+from repull.api.connect import create_connect_session, get_connect_status
+from repull.models.create_connect_session_body import CreateConnectSessionBody
+
+
+async def main() -> None:
+    client = AuthenticatedClient(
+        base_url="https://api.repull.dev",
+        token=os.environ["REPULL_API_KEY"],
+    )
+
+    body = CreateConnectSessionBody(
+        redirect_url="https://yourapp.example.com/airbnb/return",
+        allowed_providers=["airbnb"],
+    )
+
+    async with client as c:
+        session = await create_connect_session.asyncio(client=c, body=body)
+        print("Send the property manager to:")
+        print(f"  {session.url}")
+        print(f"  session_id={session.session_id}  expires_at={session.expires_at}")
+
+        status = await get_connect_status.asyncio(provider="airbnb", client=c)
+        print(f"Current Airbnb connection status: {status.status}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

repull_sdk-0.2.0/examples/quickstart.py

@@ -0,0 +1,43 @@
+"""Repull quick start: list your most recent reservations.
+
+Run with:
+    REPULL_API_KEY=sk_live_... python examples/quickstart.py
+"""
+import asyncio
+import os
+
+from repull import AuthenticatedClient
+from repull.api.reservations import list_reservations
+
+
+async def main() -> None:
+    client = AuthenticatedClient(
+        base_url="https://api.repull.dev",
+        token=os.environ["REPULL_API_KEY"],
+    )
+    async with client as c:
+        page = await list_reservations.asyncio(client=c, limit=10)
+
+    if page is None:
+        print("No reservations returned (check your API key).")
+        return
+
+    rows = list(page.data) if page.data else []
+    if not rows:
+        print("Page returned no rows.")
+        return
+
+    print(f"{'id':10s}  {'check_in':12s} -> {'check_out':12s}  {'platform':14s} {'status'}")
+    for r in rows:
+        # Wire fields are camelCase; the SDK exposes them as snake_case Python
+        # attributes. Anything not in the canonical schema lives on
+        # additional_properties (raw camelCase keys).
+        d = r.additional_properties
+        print(
+            f"{str(r.id):10s}  {str(r.check_in):12s} -> {str(r.check_out):12s}  "
+            f"{str(r.platform):14s} {d.get('status', '?')}"
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())