pethost 0.2.2__tar.gz → 0.2.4__tar.gz

{pethost-0.2.2 → pethost-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pethost
-Version: 0.2.2
+Version: 0.2.4
 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/
@@ -30,7 +30,7 @@ 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
+machine of your own. It has the 14 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. It has the API's streams too, which follow an operation, the logs
 and the requests as they happen. Everything is typed, there is a synchronous client and an
@@ -110,6 +110,7 @@ asyncio.run(main())
 | `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 |
+| `set_project_alerts(project_id, ...)` | Set a project's alerts |  |
 | `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 |
@@ -188,7 +189,7 @@ around it.
 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`.
+`error.detail`: `ProjectBusy`, `ProjectChanged`, `MachineUnreachable`, `MachineUpdatePending`, `NoMachine`, or `None`.
 
 ```python
 from pethost import NotFoundError, Pethost, PethostError
@@ -263,9 +264,9 @@ agent or from a web panel: both show the same projects, logs and requests.
   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).
+€17.99 for 4 vCPU, 6 GB and 60 GB. Scale is €59 for 8 vCPU, 30 GB and 200 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

{pethost-0.2.2 → pethost-0.2.4}/README.md

@@ -1,7 +1,7 @@
 # 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
+machine of your own. It has the 14 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. It has the API's streams too, which follow an operation, the logs
 and the requests as they happen. Everything is typed, there is a synchronous client and an
@@ -81,6 +81,7 @@ asyncio.run(main())
 | `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 |
+| `set_project_alerts(project_id, ...)` | Set a project's alerts |  |
 | `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 |
@@ -159,7 +160,7 @@ around it.
 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`.
+`error.detail`: `ProjectBusy`, `ProjectChanged`, `MachineUnreachable`, `MachineUpdatePending`, `NoMachine`, or `None`.
 
 ```python
 from pethost import NotFoundError, Pethost, PethostError
@@ -234,9 +235,9 @@ agent or from a web panel: both show the same projects, logs and requests.
   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).
+€17.99 for 4 vCPU, 6 GB and 60 GB. Scale is €59 for 8 vCPU, 30 GB and 200 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

{pethost-0.2.2 → pethost-0.2.4}/pethost/__init__.py

@@ -99,6 +99,9 @@ from ._errors import (
     UnknownError,
 )
 from ._types import (
+    AlertChannelKind,
+    AlertDestination,
+    AlertStatus,
     ArchiveUpload,
     BackUpAction,
     BranchCommit,
@@ -133,12 +136,16 @@ from ._types import (
     HttpTrafficBucket,
     HttpTrafficFilter,
     HttpTrafficSummary,
+    Incident,
+    IncidentEvidence,
+    IncidentQuietReason,
     ListCommitsResponse,
     LogLine,
     Machine,
     MachineSession,
     MachineSessionKind,
     MachineUnreachable,
+    MachineUpdatePending,
     MountVolume,
     NoMachine,
     NoMachineReason,
@@ -149,6 +156,7 @@ from ._types import (
     OutputStream,
     PathDownload,
     Project,
+    ProjectAlerts,
     ProjectBusy,
     ProjectChanged,
     ProjectExtension,
@@ -175,11 +183,19 @@ from ._types import (
     ServiceSummary,
     ServicesAction,
     ServicesActionKind,
+    SetProjectAlertsResponse,
+    SiteCheck,
+    SiteCheckResult,
+    SiteCheckState,
     Snapshot,
     SpecViolation,
     SshKey,
     TailContainerLogsResponse,
     TailHttpTrafficResponse,
+    TrafficMetric,
+    TrafficRule,
+    TrafficRuleState,
+    UptimeDay,
     Volume,
     VolumeMount,
     VolumeMountedBy,
@@ -188,6 +204,9 @@ from ._types import (
 
 __all__ = [
     "AbortedError",
+    "AlertChannelKind",
+    "AlertDestination",
+    "AlertStatus",
     "AlreadyExistsError",
     "ArchiveUpload",
     "AsyncPethost",
@@ -229,6 +248,9 @@ __all__ = [
     "HttpTrafficBucket",
     "HttpTrafficFilter",
     "HttpTrafficSummary",
+    "Incident",
+    "IncidentEvidence",
+    "IncidentQuietReason",
     "InternalError",
     "InvalidArgumentError",
     "ListCommitsResponse",
@@ -237,6 +259,7 @@ __all__ = [
     "MachineSession",
     "MachineSessionKind",
     "MachineUnreachable",
+    "MachineUpdatePending",
     "MountVolume",
     "NoMachine",
     "NoMachineReason",
@@ -252,6 +275,7 @@ __all__ = [
     "Pethost",
     "PethostError",
     "Project",
+    "ProjectAlerts",
     "ProjectBusy",
     "ProjectChanged",
     "ProjectExtension",
@@ -279,15 +303,23 @@ __all__ = [
     "ServiceSummary",
     "ServicesAction",
     "ServicesActionKind",
+    "SetProjectAlertsResponse",
+    "SiteCheck",
+    "SiteCheckResult",
+    "SiteCheckState",
     "Snapshot",
     "SpecViolation",
     "SshKey",
     "TailContainerLogsResponse",
     "TailHttpTrafficResponse",
+    "TrafficMetric",
+    "TrafficRule",
+    "TrafficRuleState",
     "UnauthenticatedError",
     "UnavailableError",
     "UnimplementedError",
     "UnknownError",
+    "UptimeDay",
     "Volume",
     "VolumeMount",
     "VolumeMountedBy",

{pethost-0.2.2 → pethost-0.2.4}/pethost/_async_client.py

@@ -42,9 +42,12 @@ from pethost._types import (
     RunProjectActionResponse,
     RunServiceCommandResponse,
     ServicesAction,
+    SetProjectAlertsResponse,
+    SiteCheck,
     SshKey,
     TailContainerLogsResponse,
     TailHttpTrafficResponse,
+    TrafficRule,
     WatchOperationResponse,
 )
 from pethost._wire.v1.panel_connect import PanelServiceClient as _Wire
@@ -342,6 +345,9 @@ class AsyncPethost:
         include_secret_values: bool = False,
         snapshots_before: datetime | None = None,
         snapshots_volume: str = "",
+        incidents_before: datetime | None = None,
+        uptime_day_count: int = 0,
+        incidents_before_id: str = "",
     ) -> GetProjectResponse:
         """Get a project.
 
@@ -356,8 +362,11 @@ class AsyncPethost:
             include_secret_values: True = include env-file values (EnvironmentVariable.secret). To edit .env: read_path /.env.
             snapshots_before: Only older snapshots: the oldest create_time seen, to page back. Absent = the newest.
             snapshots_volume: Only snapshots holding this volume (Volume.snapshot_count). Empty = all.
+            incidents_before: Only incidents that opened before it: the oldest open_time seen, to page back. Absent = the newest.
+            uptime_day_count: ≤90: Project.uptime_days. 0 = none.
+            incidents_before_id: With incidents_before: the incident_id of the oldest seen, so that those that opened at the same time are not skipped.
         """
-        return _convert.get_project_response_from_wire(await self._call(self._wire.get_project, _convert.get_project_request(project_id=project_id, include_secret_values=include_secret_values, snapshots_before=snapshots_before, snapshots_volume=snapshots_volume)))
+        return _convert.get_project_response_from_wire(await self._call(self._wire.get_project, _convert.get_project_request(project_id=project_id, include_secret_values=include_secret_values, snapshots_before=snapshots_before, snapshots_volume=snapshots_volume, incidents_before=incidents_before, uptime_day_count=uptime_day_count, incidents_before_id=incidents_before_id)))
 
     async def create_project(
         self,
@@ -1409,6 +1418,37 @@ class AsyncPethost:
         """
         return _convert.run_project_action_response_from_wire(await self._call(self._wire.run_project_action, _convert.run_project_action_request(project_id=project_id, start_services=start_services, stop_services=stop_services, restart_services=restart_services, recreate_service=recreate_service, back_up=back_up, restore_snapshot=restore_snapshot, cancel_operation=cancel_operation, delete_project=delete_project, set_source=set_source, delete_volume=delete_volume, operation_id=operation_id, wait_seconds=wait_seconds)))
 
+    async def set_project_alerts(
+        self,
+        project_id: str,
+        *,
+        checks: Sequence[SiteCheck] = (),
+        remove_checks: bool = False,
+        traffic_rules: Sequence[TrafficRule] = (),
+        remove_traffic_rules: bool = False,
+        off: bool | None = None,
+        mute_minutes: int | None = None,
+    ) -> SetProjectAlertsResponse:
+        """Set a project's alerts.
+
+        Changes what Pethost watches on a project and when it tells the person: site checks (an
+        address the machine opens every minute) and traffic rules (5xx or p95 over a window), off,
+        mute. A list given replaces the project's (send Project.alerts' with your change); remove_*
+        empties it; a scalar left out stays. Service crashes and failed backups are always watched.
+        Answers with Project.alerts. Where alerts go is the person's choice in the panel's Settings →
+        Alerts (Machine.alert_channels): no tool sets it. FailedPreconditionError + MachineUpdatePending
+        = the machine's software predates alerts.
+
+        Args:
+            checks: ≤10. Given = the whole list.
+            remove_checks: True = none, not even the default check.
+            traffic_rules: ≤10. Given = the whole list.
+            remove_traffic_rules: True = none.
+            off: True = incidents are recorded, nothing is sent. Absent = stays.
+            mute_minutes: ≤10080; 0 = unmute. Incidents opened meanwhile are not sent. Absent = stays.
+        """
+        return _convert.set_project_alerts_response_from_wire(await self._call(self._wire.set_project_alerts, _convert.set_project_alerts_request(project_id=project_id, checks=checks, remove_checks=remove_checks, traffic_rules=traffic_rules, remove_traffic_rules=remove_traffic_rules, off=off, mute_minutes=mute_minutes)))
+
     async def get_operation(
         self,
         project_id: str,

{pethost-0.2.2 → pethost-0.2.4}/pethost/_client.py

@@ -41,9 +41,12 @@ from pethost._types import (
     RunProjectActionResponse,
     RunServiceCommandResponse,
     ServicesAction,
+    SetProjectAlertsResponse,
+    SiteCheck,
     SshKey,
     TailContainerLogsResponse,
     TailHttpTrafficResponse,
+    TrafficRule,
     WatchOperationResponse,
 )
 from pethost._wire.v1.panel_connect import PanelServiceClientSync as _Wire
@@ -338,6 +341,9 @@ class Pethost:
         include_secret_values: bool = False,
         snapshots_before: datetime | None = None,
         snapshots_volume: str = "",
+        incidents_before: datetime | None = None,
+        uptime_day_count: int = 0,
+        incidents_before_id: str = "",
     ) -> GetProjectResponse:
         """Get a project.
 
@@ -352,8 +358,11 @@ class Pethost:
             include_secret_values: True = include env-file values (EnvironmentVariable.secret). To edit .env: read_path /.env.
             snapshots_before: Only older snapshots: the oldest create_time seen, to page back. Absent = the newest.
             snapshots_volume: Only snapshots holding this volume (Volume.snapshot_count). Empty = all.
+            incidents_before: Only incidents that opened before it: the oldest open_time seen, to page back. Absent = the newest.
+            uptime_day_count: ≤90: Project.uptime_days. 0 = none.
+            incidents_before_id: With incidents_before: the incident_id of the oldest seen, so that those that opened at the same time are not skipped.
         """
-        return _convert.get_project_response_from_wire(self._call(self._wire.get_project, _convert.get_project_request(project_id=project_id, include_secret_values=include_secret_values, snapshots_before=snapshots_before, snapshots_volume=snapshots_volume)))
+        return _convert.get_project_response_from_wire(self._call(self._wire.get_project, _convert.get_project_request(project_id=project_id, include_secret_values=include_secret_values, snapshots_before=snapshots_before, snapshots_volume=snapshots_volume, incidents_before=incidents_before, uptime_day_count=uptime_day_count, incidents_before_id=incidents_before_id)))
 
     def create_project(
         self,
@@ -1405,6 +1414,37 @@ class Pethost:
         """
         return _convert.run_project_action_response_from_wire(self._call(self._wire.run_project_action, _convert.run_project_action_request(project_id=project_id, start_services=start_services, stop_services=stop_services, restart_services=restart_services, recreate_service=recreate_service, back_up=back_up, restore_snapshot=restore_snapshot, cancel_operation=cancel_operation, delete_project=delete_project, set_source=set_source, delete_volume=delete_volume, operation_id=operation_id, wait_seconds=wait_seconds)))
 
+    def set_project_alerts(
+        self,
+        project_id: str,
+        *,
+        checks: Sequence[SiteCheck] = (),
+        remove_checks: bool = False,
+        traffic_rules: Sequence[TrafficRule] = (),
+        remove_traffic_rules: bool = False,
+        off: bool | None = None,
+        mute_minutes: int | None = None,
+    ) -> SetProjectAlertsResponse:
+        """Set a project's alerts.
+
+        Changes what Pethost watches on a project and when it tells the person: site checks (an
+        address the machine opens every minute) and traffic rules (5xx or p95 over a window), off,
+        mute. A list given replaces the project's (send Project.alerts' with your change); remove_*
+        empties it; a scalar left out stays. Service crashes and failed backups are always watched.
+        Answers with Project.alerts. Where alerts go is the person's choice in the panel's Settings →
+        Alerts (Machine.alert_channels): no tool sets it. FailedPreconditionError + MachineUpdatePending
+        = the machine's software predates alerts.
+
+        Args:
+            checks: ≤10. Given = the whole list.
+            remove_checks: True = none, not even the default check.
+            traffic_rules: ≤10. Given = the whole list.
+            remove_traffic_rules: True = none.
+            off: True = incidents are recorded, nothing is sent. Absent = stays.
+            mute_minutes: ≤10080; 0 = unmute. Incidents opened meanwhile are not sent. Absent = stays.
+        """
+        return _convert.set_project_alerts_response_from_wire(self._call(self._wire.set_project_alerts, _convert.set_project_alerts_request(project_id=project_id, checks=checks, remove_checks=remove_checks, traffic_rules=traffic_rules, remove_traffic_rules=remove_traffic_rules, off=off, mute_minutes=mute_minutes)))
+
     def get_operation(
         self,
         project_id: str,