pethost 0.1.0__tar.gz

pethost-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.egg-info/
+.mypy_cache/
+.venv/
+dist/

pethost-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pethost
+
+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.

pethost-0.1.0/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.5
+Name: pethost
+Version: 0.1.0
+Summary: The Python SDK for Pethost, hosting for Docker Compose projects: deploy, read logs and requests, run commands and move files through its API.
+Project-URL: Homepage, https://pethost.dev
+Project-URL: Documentation, https://pethost.dev/docs/api/
+Project-URL: Repository, https://github.com/pethost-dev/sdk
+Project-URL: Issues, https://github.com/pethost-dev/sdk/issues
+Author: Pethost
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,client,deploy,docker,docker compose,hosting,paas,pethost,sdk
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: connectrpc<0.13,>=0.12.1
+Requires-Dist: protobuf-py<0.7,>=0.6.0
+Description-Content-Type: text/markdown
+
+# Pethost for Python
+
+The Python SDK for [Pethost](https://pethost.dev), hosting for Docker Compose projects on a
+machine of your own. It has the 13 calls of Pethost's API, the ones an agent has through its
+MCP server: read the machine and its projects, deploy, read logs and HTTP requests, run
+commands, move files. Everything is typed, there is a synchronous client and an asyncio one, and
+the whole package is generated from the API's definition, so its methods, its fields and their
+documentation are the API's own.
+
+## Install
+
+```sh
+pip install pethost
+```
+
+Python 3.10 or newer. With uv: `uv add pethost`.
+
+## A token
+
+The SDK signs in with an API token. Make one in [the panel](https://console.pethost.dev)'s
+Settings, under "API tokens", and give it to the SDK in the environment variable
+`PETHOST_TOKEN`, or as the client's first argument. A token acts as you: keep it out of your
+code and your repository.
+
+## A first program
+
+It reads the machine and its projects, then deploys to the project `notes` by writing one
+file, `/hello.txt`.
+
+```python
+from pethost import FileChange, Pethost
+
+with Pethost() as pethost:  # The token: PETHOST_TOKEN.
+    answer = pethost.get_machine()
+    machine = answer.machine
+    if machine is None:
+        raise SystemExit("the answer has no machine")
+
+    print(machine.hostname)
+    for project in answer.projects:
+        print(project.project_id)
+
+    deployed = pethost.deploy_project(
+        "notes",
+        files=[FileChange(path="/hello.txt", text="Hello from the Pethost SDK\n")],
+    )
+    for violation in deployed.violations:  # The file was refused: nothing was deployed.
+        print(violation.location, violation.violation_message)
+
+    if deployed.operation is not None:
+        print(deployed.operation.status.name)
+    if deployed.project is not None:  # The project as it is once the deploy ended.
+        print(deployed.project.url)
+```
+
+`AsyncPethost` has the same methods for asyncio:
+
+```python
+import asyncio
+
+from pethost import AsyncPethost
+
+
+async def main() -> None:
+    async with AsyncPethost() as pethost:
+        print(await pethost.get_machine())
+
+
+asyncio.run(main())
+```
+
+## Methods
+
+| Method | What it does | |
+|---|---|---|
+| `get_machine()` | Get the machine | read-only |
+| `run_machine_action(...)` | Run a machine action | destructive |
+| `get_project(project_id, ...)` | Get a project | read-only |
+| `create_project(project_id, ...)` | Create a project |  |
+| `deploy_project(project_id, ...)` | Deploy a project | destructive |
+| `list_commits(project_id, ...)` | List a project's commits | read-only |
+| `run_project_action(project_id, ...)` | Run a project action | destructive |
+| `get_operation(project_id, ...)` | Get an operation | read-only |
+| `query_http_traffic(project_id, ...)` | Query HTTP traffic | read-only |
+| `query_container_logs(project_id, ...)` | Query container logs | read-only |
+| `run_service_command(project_id, ...)` | Run a command in a service | destructive |
+| `read_path(project_id, ...)` | Read a file or directory | read-only |
+| `create_transfer(...)` | Upload or download a file | destructive |
+
+A read-only call changes nothing; a destructive one may delete or overwrite something. A
+request's fields are its method's keyword arguments, a message is a frozen dataclass of the same
+name, and each docstring is the API's own description: `help(Pethost)` and your editor show it.
+What the API calls absent is `None` where a type allows `None`, and the zero value anywhere
+else.
+
+## Errors
+
+A failed call raises a `PethostError`, and its class is the code:
+`CanceledError`, `UnknownError`, `InvalidArgumentError`, `DeadlineExceededError`, `NotFoundError`, `AlreadyExistsError`, `PermissionDeniedError`, `ResourceExhaustedError`, `FailedPreconditionError`, `AbortedError`, `OutOfRangeError`, `UnimplementedError`, `InternalError`, `UnavailableError`, `DataLossError`, `UnauthenticatedError`.
+`error.message` is prose for people. What a program branches on, beside the class, is
+`error.detail`: `ProjectBusy`, `ProjectChanged`, `MachineUnreachable`, `NoMachine`, or `None`.
+
+```python
+from pethost import NotFoundError, Pethost, PethostError
+
+with Pethost() as pethost:
+    try:
+        project = pethost.get_project("notes").project
+    except NotFoundError as error:
+        print(error.message)  # No such project: the message lists the ones there are.
+    except PethostError as error:  # Any other code.
+        print(type(error).__name__, error.message, error.detail)
+```
+
+A wrong argument the SDK sees itself, such as two members of one oneof, is Python's own
+`TypeError`, `ValueError` or `OverflowError`, raised before anything is sent.
+
+## Links
+
+- [The API's reference](https://pethost.dev/docs/api/): every call, message and field.
+- [The panel](https://console.pethost.dev): your machine, your projects and your API tokens.
+- [pethost.dev](https://pethost.dev): what Pethost is and what it costs.
+
+## Docker Compose hosting at one flat price
+
+Pethost is managed hosting for Docker Compose projects. A subscription rents one virtual machine
+that only your account uses. Pethost's software on it deploys your projects, gives them HTTPS
+addresses, keeps their request logs and backs them up every night. You run it through your
+agent or from a web panel: both show the same projects, logs and requests.
+
+- **A machine of your own:** nobody else's projects on it. No cold starts, nothing sleeps.
+  Security updates install themselves.
+- **HTTPS addresses:** anything.yourname.pethost.app at once, or your own domain with one DNS
+  record. Certificates renew themselves. A password page in front of the whole site: one
+  sentence to your agent.
+- **Deploys from GitHub:** every push deploys itself, and an earlier commit is one step back.
+- **Request logs:** every request with its status and time, the busiest paths and the error
+  rate, kept for 30 days.
+- **Nightly backups:** encrypted, stored off the machine, kept for 14 days.
+- **SSH and SFTP** into any container, and a terminal in the panel.
+- **Docker Compose, as written:** a project is a Compose file, and the same file runs anywhere
+  else Docker does. A database is one more service in it, at no extra cost.
+- **In the EU:** your data lives on your machine, and requests to your sites go straight to
+  it, never through our panel.
+
+**Pricing.** Starter is €9.99 a month for 2 vCPU, 3 GB of memory and 30 GB of SSD. Grow is
+€17.99 for 4 vCPU, 6 GB and 60 GB. Prices are without VAT. As many projects, containers and
+databases as fit: nothing is metered, and nothing is billed on top. There is no free tier.
+[See the plans](https://pethost.dev/#pricing).
+
+**Who it is for.** Solo developers and early startups who host several projects, bots or small
+apps and want one fixed monthly bill, and people who build with an AI agent and want it to
+deploy and run what it wrote. It is not for large teams whose applications need several regions
+or autoscaling: the machine is the limit.
+
+## How Pethost compares
+
+| If you use | The difference |
+|---|---|
+| [Heroku](https://pethost.dev/about/#heroku), [Render](https://pethost.dev/about/#render), [DigitalOcean App Platform](https://pethost.dev/about/#digitalocean) | There each app, worker and database is one more line on the bill. On Pethost one flat price covers the whole machine: as many projects and databases as fit, and nothing sleeps. |
+| [Railway, Fly.io](https://pethost.dev/about/#railway), [Koyeb](https://pethost.dev/about/#koyeb) | There CPU, memory and traffic are metered, so the bill moves with every busy month. On Pethost the machine is the limit: nothing is metered, nothing is billed on top. |
+| [Vercel, Netlify](https://pethost.dev/about/#vercel) | Made for front ends and serverless functions: a bot, a long-running worker or a database is another service with its own price. Pethost runs the front end, the back end and the database on one machine. |
+| [Coolify, Dokploy](https://pethost.dev/about/#coolify), [CapRover, Dokku, Easypanel](https://pethost.dev/about/#caprover) | Self-hosted: the server is yours to rent, update, secure and back up. Pethost is the machine and the panel together, looked after for you, and agents are first-class users, not an add-on. |
+| [Sliplane](https://pethost.dev/about/#sliplane) | The closest: a flat price per server. There a Compose file is converted into its own services; Pethost runs a Compose project as written. |
+| [Replit](https://pethost.dev/about/#replit) | You build and publish inside Replit, with its own agent. Pethost works with the agent you already use, and one flat price covers all your apps. |
+| [PythonAnywhere](https://pethost.dev/about/#pythonanywhere) | Python only, no Docker. Pethost runs anything Docker runs, in any language. |
+| [A VPS you set up yourself](https://pethost.dev/about/#vps) | The server is the cheap part. You still set up the proxy, DNS, certificates, backups and updates yourself, and fix them when they break. Pethost is the server with all of that done. |
+
+[About Pethost](https://pethost.dev/about/) has each comparison in full, with prices.
+
+## Questions
+
+**Which AI agents does Pethost work with?**
+Almost any agent that supports skills and MCP. The ones we tested ourselves: Claude Code, Codex,
+Cursor, ChatGPT, Gemini CLI, OpenClaw, Hermes and Pi.
+
+**What can I deploy?**
+Anything that runs in Docker: web apps, APIs, bots, workers, databases. No Dockerfile? With the
+plugin installed, your agent knows the details and writes it for you.
+
+**Do I need an agent?**
+No. The web panel does the same, and shows the same projects, logs and requests.
+
+**Can I use my own domain?**
+Yes. One DNS record, and the certificate comes by itself.
+
+**Is there a free tier?**
+No: €9.99 rents a real machine, so nothing sleeps. Cancel any time:
+[refunds and cancellation](https://pethost.dev/refunds/) has the rules.
+

pethost-0.1.0/README.md

@@ -0,0 +1,190 @@
+# Pethost for Python
+
+The Python SDK for [Pethost](https://pethost.dev), hosting for Docker Compose projects on a
+machine of your own. It has the 13 calls of Pethost's API, the ones an agent has through its
+MCP server: read the machine and its projects, deploy, read logs and HTTP requests, run
+commands, move files. Everything is typed, there is a synchronous client and an asyncio one, and
+the whole package is generated from the API's definition, so its methods, its fields and their
+documentation are the API's own.
+
+## Install
+
+```sh
+pip install pethost
+```
+
+Python 3.10 or newer. With uv: `uv add pethost`.
+
+## A token
+
+The SDK signs in with an API token. Make one in [the panel](https://console.pethost.dev)'s
+Settings, under "API tokens", and give it to the SDK in the environment variable
+`PETHOST_TOKEN`, or as the client's first argument. A token acts as you: keep it out of your
+code and your repository.
+
+## A first program
+
+It reads the machine and its projects, then deploys to the project `notes` by writing one
+file, `/hello.txt`.
+
+```python
+from pethost import FileChange, Pethost
+
+with Pethost() as pethost:  # The token: PETHOST_TOKEN.
+    answer = pethost.get_machine()
+    machine = answer.machine
+    if machine is None:
+        raise SystemExit("the answer has no machine")
+
+    print(machine.hostname)
+    for project in answer.projects:
+        print(project.project_id)
+
+    deployed = pethost.deploy_project(
+        "notes",
+        files=[FileChange(path="/hello.txt", text="Hello from the Pethost SDK\n")],
+    )
+    for violation in deployed.violations:  # The file was refused: nothing was deployed.
+        print(violation.location, violation.violation_message)
+
+    if deployed.operation is not None:
+        print(deployed.operation.status.name)
+    if deployed.project is not None:  # The project as it is once the deploy ended.
+        print(deployed.project.url)
+```
+
+`AsyncPethost` has the same methods for asyncio:
+
+```python
+import asyncio
+
+from pethost import AsyncPethost
+
+
+async def main() -> None:
+    async with AsyncPethost() as pethost:
+        print(await pethost.get_machine())
+
+
+asyncio.run(main())
+```
+
+## Methods
+
+| Method | What it does | |
+|---|---|---|
+| `get_machine()` | Get the machine | read-only |
+| `run_machine_action(...)` | Run a machine action | destructive |
+| `get_project(project_id, ...)` | Get a project | read-only |
+| `create_project(project_id, ...)` | Create a project |  |
+| `deploy_project(project_id, ...)` | Deploy a project | destructive |
+| `list_commits(project_id, ...)` | List a project's commits | read-only |
+| `run_project_action(project_id, ...)` | Run a project action | destructive |
+| `get_operation(project_id, ...)` | Get an operation | read-only |
+| `query_http_traffic(project_id, ...)` | Query HTTP traffic | read-only |
+| `query_container_logs(project_id, ...)` | Query container logs | read-only |
+| `run_service_command(project_id, ...)` | Run a command in a service | destructive |
+| `read_path(project_id, ...)` | Read a file or directory | read-only |
+| `create_transfer(...)` | Upload or download a file | destructive |
+
+A read-only call changes nothing; a destructive one may delete or overwrite something. A
+request's fields are its method's keyword arguments, a message is a frozen dataclass of the same
+name, and each docstring is the API's own description: `help(Pethost)` and your editor show it.
+What the API calls absent is `None` where a type allows `None`, and the zero value anywhere
+else.
+
+## Errors
+
+A failed call raises a `PethostError`, and its class is the code:
+`CanceledError`, `UnknownError`, `InvalidArgumentError`, `DeadlineExceededError`, `NotFoundError`, `AlreadyExistsError`, `PermissionDeniedError`, `ResourceExhaustedError`, `FailedPreconditionError`, `AbortedError`, `OutOfRangeError`, `UnimplementedError`, `InternalError`, `UnavailableError`, `DataLossError`, `UnauthenticatedError`.
+`error.message` is prose for people. What a program branches on, beside the class, is
+`error.detail`: `ProjectBusy`, `ProjectChanged`, `MachineUnreachable`, `NoMachine`, or `None`.
+
+```python
+from pethost import NotFoundError, Pethost, PethostError
+
+with Pethost() as pethost:
+    try:
+        project = pethost.get_project("notes").project
+    except NotFoundError as error:
+        print(error.message)  # No such project: the message lists the ones there are.
+    except PethostError as error:  # Any other code.
+        print(type(error).__name__, error.message, error.detail)
+```
+
+A wrong argument the SDK sees itself, such as two members of one oneof, is Python's own
+`TypeError`, `ValueError` or `OverflowError`, raised before anything is sent.
+
+## Links
+
+- [The API's reference](https://pethost.dev/docs/api/): every call, message and field.
+- [The panel](https://console.pethost.dev): your machine, your projects and your API tokens.
+- [pethost.dev](https://pethost.dev): what Pethost is and what it costs.
+
+## Docker Compose hosting at one flat price
+
+Pethost is managed hosting for Docker Compose projects. A subscription rents one virtual machine
+that only your account uses. Pethost's software on it deploys your projects, gives them HTTPS
+addresses, keeps their request logs and backs them up every night. You run it through your
+agent or from a web panel: both show the same projects, logs and requests.
+
+- **A machine of your own:** nobody else's projects on it. No cold starts, nothing sleeps.
+  Security updates install themselves.
+- **HTTPS addresses:** anything.yourname.pethost.app at once, or your own domain with one DNS
+  record. Certificates renew themselves. A password page in front of the whole site: one
+  sentence to your agent.
+- **Deploys from GitHub:** every push deploys itself, and an earlier commit is one step back.
+- **Request logs:** every request with its status and time, the busiest paths and the error
+  rate, kept for 30 days.
+- **Nightly backups:** encrypted, stored off the machine, kept for 14 days.
+- **SSH and SFTP** into any container, and a terminal in the panel.
+- **Docker Compose, as written:** a project is a Compose file, and the same file runs anywhere
+  else Docker does. A database is one more service in it, at no extra cost.
+- **In the EU:** your data lives on your machine, and requests to your sites go straight to
+  it, never through our panel.
+
+**Pricing.** Starter is €9.99 a month for 2 vCPU, 3 GB of memory and 30 GB of SSD. Grow is
+€17.99 for 4 vCPU, 6 GB and 60 GB. Prices are without VAT. As many projects, containers and
+databases as fit: nothing is metered, and nothing is billed on top. There is no free tier.
+[See the plans](https://pethost.dev/#pricing).
+
+**Who it is for.** Solo developers and early startups who host several projects, bots or small
+apps and want one fixed monthly bill, and people who build with an AI agent and want it to
+deploy and run what it wrote. It is not for large teams whose applications need several regions
+or autoscaling: the machine is the limit.
+
+## How Pethost compares
+
+| If you use | The difference |
+|---|---|
+| [Heroku](https://pethost.dev/about/#heroku), [Render](https://pethost.dev/about/#render), [DigitalOcean App Platform](https://pethost.dev/about/#digitalocean) | There each app, worker and database is one more line on the bill. On Pethost one flat price covers the whole machine: as many projects and databases as fit, and nothing sleeps. |
+| [Railway, Fly.io](https://pethost.dev/about/#railway), [Koyeb](https://pethost.dev/about/#koyeb) | There CPU, memory and traffic are metered, so the bill moves with every busy month. On Pethost the machine is the limit: nothing is metered, nothing is billed on top. |
+| [Vercel, Netlify](https://pethost.dev/about/#vercel) | Made for front ends and serverless functions: a bot, a long-running worker or a database is another service with its own price. Pethost runs the front end, the back end and the database on one machine. |
+| [Coolify, Dokploy](https://pethost.dev/about/#coolify), [CapRover, Dokku, Easypanel](https://pethost.dev/about/#caprover) | Self-hosted: the server is yours to rent, update, secure and back up. Pethost is the machine and the panel together, looked after for you, and agents are first-class users, not an add-on. |
+| [Sliplane](https://pethost.dev/about/#sliplane) | The closest: a flat price per server. There a Compose file is converted into its own services; Pethost runs a Compose project as written. |
+| [Replit](https://pethost.dev/about/#replit) | You build and publish inside Replit, with its own agent. Pethost works with the agent you already use, and one flat price covers all your apps. |
+| [PythonAnywhere](https://pethost.dev/about/#pythonanywhere) | Python only, no Docker. Pethost runs anything Docker runs, in any language. |
+| [A VPS you set up yourself](https://pethost.dev/about/#vps) | The server is the cheap part. You still set up the proxy, DNS, certificates, backups and updates yourself, and fix them when they break. Pethost is the server with all of that done. |
+
+[About Pethost](https://pethost.dev/about/) has each comparison in full, with prices.
+
+## Questions
+
+**Which AI agents does Pethost work with?**
+Almost any agent that supports skills and MCP. The ones we tested ourselves: Claude Code, Codex,
+Cursor, ChatGPT, Gemini CLI, OpenClaw, Hermes and Pi.
+
+**What can I deploy?**
+Anything that runs in Docker: web apps, APIs, bots, workers, databases. No Dockerfile? With the
+plugin installed, your agent knows the details and writes it for you.
+
+**Do I need an agent?**
+No. The web panel does the same, and shows the same projects, logs and requests.
+
+**Can I use my own domain?**
+Yes. One DNS record, and the certificate comes by itself.
+
+**Is there a free tier?**
+No: €9.99 rents a real machine, so nothing sleeps. Cancel any time:
+[refunds and cancellation](https://pethost.dev/refunds/) has the rules.
+