forktex-cloud 0.2.3__py3-none-any.whl

forktex_cloud/bridge/persistence_defaults.py

@@ -0,0 +1,120 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of forktex-cloud.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+"""Shared auto-config defaults for persistence services.
+
+Used by the dev compose generator to auto-detect healthchecks, volumes,
+and ports for known database images.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+PERSISTENCE_DEFAULTS: dict[str, dict[str, Any]] = {
+    "postgres": {
+        "healthcheck": {
+            "test": ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER:-postgres}"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 5432,
+        "default_volume": "/var/lib/postgresql/data",
+    },
+    "mysql": {
+        "healthcheck": {
+            "test": ["CMD-SHELL", "mysqladmin ping -h localhost"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 3306,
+        "default_volume": "/var/lib/mysql",
+    },
+    "mariadb": {
+        "healthcheck": {
+            "test": ["CMD-SHELL", "healthcheck.sh --connect --innodb_initialized"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 3306,
+        "default_volume": "/var/lib/mysql",
+    },
+    "redis": {
+        "healthcheck": {
+            "test": ["CMD", "redis-cli", "ping"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 6379,
+        "default_volume": "/data",
+    },
+    "mongo": {
+        "healthcheck": {
+            "test": ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 27017,
+        "default_volume": "/data/db",
+    },
+    "qdrant": {
+        "healthcheck": {
+            "test": ["CMD-SHELL", "bash -c 'echo > /dev/tcp/localhost/6333'"],
+            "interval": "5s",
+            "timeout": "5s",
+            "retries": 10,
+        },
+        "default_port": 6333,
+        "default_volume": "/qdrant/storage",
+    },
+    "memcached": {
+        "healthcheck": {
+            "test": ["CMD-SHELL", "echo stats | nc localhost 11211 | grep pid"],
+            "interval": "30s",
+            "timeout": "10s",
+            "retries": 5,
+        },
+        "default_port": 11211,
+        "default_volume": "",
+    },
+}
+
+
+def detect_persistence_defaults(image: str) -> dict[str, Any] | None:
+    """Match image name against known persistence patterns.
+
+    Returns a dict with ``healthcheck``, ``default_port``, and ``default_volume``
+    if the image matches a known persistence engine, otherwise ``None``.
+    """
+    image_base = image.split(":")[0].split("/")[-1]
+
+    for key, defaults in PERSISTENCE_DEFAULTS.items():
+        if image_base.startswith(key):
+            return dict(defaults)
+
+    return None

forktex_cloud/client/__init__.py

@@ -0,0 +1,83 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of forktex-cloud.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+"""Typed httpx client for the ForkTex Cloud API.
+
+All response/request models come from ``forktex_cloud.client.generated``
+(emitted by the OpenAPI codegen pipeline). This module re-exports the
+commonly used ones so call sites can ``from forktex_cloud.client import X``
+without touching the ``generated`` namespace directly.
+"""
+
+from forktex_cloud.client.client import CloudAPIError, ForktexCloudClient
+from forktex_cloud.client.generated import (
+    ApiKeyCreated,
+    ApiKeyRead,
+    CapacityOrgLimits,
+    CapacityReport,
+    CapacityServers,
+    EnvironmentRead,
+    EventRead,
+    HealthRead,
+    JobResponse,
+    MeResponse,
+    OrgBrief,
+    OrgRead,
+    ProjectRead,
+    ServerDnsRead,
+    ServerRead,
+    ServerServiceRead,
+    ServerSslRead,
+    StatusResponse,
+    TokenResponse,
+    UserRead,
+    VaultGetResponse,
+    WorkspaceRead,
+)
+
+__all__ = [
+    "ForktexCloudClient",
+    "CloudAPIError",
+    "ApiKeyCreated",
+    "ApiKeyRead",
+    "CapacityOrgLimits",
+    "CapacityReport",
+    "CapacityServers",
+    "EnvironmentRead",
+    "EventRead",
+    "HealthRead",
+    "JobResponse",
+    "MeResponse",
+    "OrgBrief",
+    "OrgRead",
+    "ProjectRead",
+    "ServerDnsRead",
+    "ServerRead",
+    "ServerServiceRead",
+    "ServerSslRead",
+    "StatusResponse",
+    "TokenResponse",
+    "UserRead",
+    "VaultGetResponse",
+    "WorkspaceRead",
+]