lazycloud-shared 0.0.0__tar.gz

lazycloud_shared-0.0.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: lazycloud-shared
+Version: 0.0.0
+Summary: Boundary-safe shared primitives and HTTP payloads for the compute platform.
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2025.1.31
+Requires-Dist: croniter>=6.2.4
+Requires-Dist: pydantic<3,>=2.8

lazycloud_shared-0.0.0/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "lazycloud-shared"
+version = "0.0.0"
+description = "Boundary-safe shared primitives and HTTP payloads for the compute platform."
+requires-python = ">=3.10"
+dependencies = [
+    "certifi>=2025.1.31",
+    "croniter>=6.2.4",
+    "pydantic>=2.8,<3",
+]
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+shared = ["py.typed"]

lazycloud_shared-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lazycloud_shared-0.0.0/src/lazycloud_shared.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: lazycloud-shared
+Version: 0.0.0
+Summary: Boundary-safe shared primitives and HTTP payloads for the compute platform.
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2025.1.31
+Requires-Dist: croniter>=6.2.4
+Requires-Dist: pydantic<3,>=2.8

lazycloud_shared-0.0.0/src/lazycloud_shared.egg-info/SOURCES.txt

@@ -0,0 +1,151 @@
+pyproject.toml
+src/lazycloud_shared.egg-info/PKG-INFO
+src/lazycloud_shared.egg-info/SOURCES.txt
+src/lazycloud_shared.egg-info/dependency_links.txt
+src/lazycloud_shared.egg-info/requires.txt
+src/lazycloud_shared.egg-info/top_level.txt
+src/shared/__init__.py
+src/shared/app_identity.py
+src/shared/app_lifecycle.py
+src/shared/app_slug.py
+src/shared/autoscaler_state.py
+src/shared/autoscaling.py
+src/shared/aws_connections.py
+src/shared/billing_accounts.py
+src/shared/billing_plans.py
+src/shared/billing_quotes.py
+src/shared/billing_rate_card.py
+src/shared/bytes_transport.py
+src/shared/cache_records.py
+src/shared/callbacks.py
+src/shared/capacity.py
+src/shared/checkpoints.py
+src/shared/compute_enrollment.py
+src/shared/compute_fleet.py
+src/shared/compute_policy.py
+src/shared/container_requests.py
+src/shared/containers.py
+src/shared/contracts.py
+src/shared/cron.py
+src/shared/custom_domains.py
+src/shared/deployment_records.py
+src/shared/deployment_settings.py
+src/shared/deployment_subdomains.py
+src/shared/deployments.py
+src/shared/enums.py
+src/shared/env.py
+src/shared/errors.py
+src/shared/events.py
+src/shared/external_identity.py
+src/shared/function_payloads.py
+src/shared/gpu.py
+src/shared/http_headers.py
+src/shared/http_transport.py
+src/shared/identity.py
+src/shared/lifecycle.py
+src/shared/logs.py
+src/shared/managed_runtime_integrity.py
+src/shared/mounts.py
+src/shared/objects.py
+src/shared/paths.py
+src/shared/payments.py
+src/shared/process_liveness.py
+src/shared/provider_config.py
+src/shared/py.typed
+src/shared/queue_messages.py
+src/shared/resources.py
+src/shared/routing.py
+src/shared/runtime_paths.py
+src/shared/scheduling.py
+src/shared/secrets.py
+src/shared/serialization.py
+src/shared/shell_protocol.py
+src/shared/signals.py
+src/shared/source_cache_cleanup.py
+src/shared/task_context.py
+src/shared/tasks.py
+src/shared/timestamps.py
+src/shared/transport_retry.py
+src/shared/urls.py
+src/shared/usage.py
+src/shared/usage_query.py
+src/shared/volumes.py
+src/shared/worker_events.py
+src/shared/workload_config.py
+src/shared/workload_keys.py
+src/shared/workspace_storage.py
+src/shared/http/__init__.py
+src/shared/http/apps.py
+src/shared/http/artifacts.py
+src/shared/http/aws_connections.py
+src/shared/http/base.py
+src/shared/http/billing.py
+src/shared/http/callbacks.py
+src/shared/http/client_manifests.py
+src/shared/http/collections.py
+src/shared/http/compute.py
+src/shared/http/compute_policy.py
+src/shared/http/concurrency.py
+src/shared/http/custom_domains.py
+src/shared/http/deployments.py
+src/shared/http/device_auth.py
+src/shared/http/endpoint_forwarding.py
+src/shared/http/endpoints.py
+src/shared/http/errors.py
+src/shared/http/functions.py
+src/shared/http/gateway.py
+src/shared/http/gateway_tasks.py
+src/shared/http/images.py
+src/shared/http/objects.py
+src/shared/http/observability.py
+src/shared/http/operations.py
+src/shared/http/pods.py
+src/shared/http/pricing.py
+src/shared/http/provider_nodes.py
+src/shared/http/secrets.py
+src/shared/http/shells.py
+src/shared/http/source_cache_cleanup.py
+src/shared/http/storage.py
+src/shared/http/stubs.py
+src/shared/http/system.py
+src/shared/http/task_payload.py
+src/shared/http/tasks.py
+src/shared/http/usage.py
+src/shared/http/users.py
+src/shared/http/volumes.py
+src/shared/http/workspace_changes.py
+src/shared/http/workspaces.py
+src/shared/image_building/__init__.py
+src/shared/image_building/authoring.py
+src/shared/image_building/constants.py
+src/shared/image_building/context.py
+src/shared/image_building/credentials.py
+src/shared/image_building/planning.py
+src/shared/image_building/records.py
+src/shared/image_building/requirements.py
+src/shared/realtime/__init__.py
+src/shared/realtime/contracts.py
+src/shared/realtime/streams.py
+tests/test_autoscaling_semantics.py
+tests/test_billing_quotes.py
+tests/test_common_stubs.py
+tests/test_common_utilities.py
+tests/test_custom_domains.py
+tests/test_deployment_subdomains.py
+tests/test_execution_contracts.py
+tests/test_fleet_contracts.py
+tests/test_gpu_contract.py
+tests/test_http_json_boundaries.py
+tests/test_http_transport_tls.py
+tests/test_identity_contracts.py
+tests/test_image_building_credentials.py
+tests/test_memory_eviction_policy.py
+tests/test_mounts.py
+tests/test_process_liveness.py
+tests/test_serialization.py
+tests/test_shell_protocol.py
+tests/test_storage_contracts.py
+tests/test_transport_retry.py
+tests/test_urls.py
+tests/test_usage_contracts.py
+tests/test_workload_defaults.py

lazycloud_shared-0.0.0/src/lazycloud_shared.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lazycloud_shared-0.0.0/src/lazycloud_shared.egg-info/requires.txt

@@ -0,0 +1,3 @@
+certifi>=2025.1.31
+croniter>=6.2.4
+pydantic<3,>=2.8

lazycloud_shared-0.0.0/src/lazycloud_shared.egg-info/top_level.txt

@@ -0,0 +1 @@
+shared

lazycloud_shared-0.0.0/src/shared/__init__.py

@@ -0,0 +1 @@
+"""Protocol-neutral contracts shared across LazyCloud process boundaries."""

lazycloud_shared-0.0.0/src/shared/app_identity.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+NAME = "lazycloud"
+DISPLAY_NAME = NAME.replace("-", " ").title()
+ENV_PREFIX = NAME.upper().replace("-", "_")
+_LABEL_NAME = "".join(part.capitalize() for part in NAME.replace("_", "-").split("-"))
+HOME_DIR = f".{NAME}"
+STATE_DIR = f"/var/lib/{NAME}"
+CACHE_DIR = f"{STATE_DIR}/cache"
+CACHE_PAGES_DIR = f"{CACHE_DIR}/pages"
+WORKER_BUNDLE_ROOT = f"/tmp/{NAME}-containers"
+WORKER_CHECKPOINT_ROOT = f"/tmp/{NAME}-checkpoints"
+CHECKPOINT_SIGNAL_ROOT = f"/tmp/{NAME}-checkpoint-signals"
+MANAGED_PACKAGE_ROOT = f"/tmp/{NAME}-packages"
+FUNCTION_IMAGE = f"{NAME}-function"
+ENDPOINT_IMAGE = f"{NAME}-endpoint"
+POD_IMAGE = f"{NAME}-pod"
+SHELL_IMAGE = f"{NAME}-shell"
+SHELL_LOG_PATH = f"/tmp/{NAME}-shell.log"
+AGENT_CONTAINER_TMP_PATH = f"/tmp/{NAME}"
+AGENT_CONTAINER_LOG_PATH = f"/var/log/{NAME}"
+AGENT_STATE_DIR = f"{STATE_DIR}/agent"
+AGENT_CONTAINER_DATA_PATH = f"{AGENT_STATE_DIR}/data"
+AGENT_CONTAINER_OBJECT_PATH = f"{AGENT_CONTAINER_DATA_PATH}/objects"
+AGENT_WORKER_CONFIG_PATH = f"/etc/{NAME}/worker/config.json"
+CLI_NAME = NAME
+ADMIN_CLI_NAME = f"{NAME}-admin"
+REDIS_KEY_PREFIX = NAME
+OBJECT_STORE_BUCKET = f"{NAME}-objects"
+
+WORKSPACE_BUCKET_PREFIX = "workspace"
+"""Default prefix of a workspace's own bucket.
+
+A deployment sharing an AWS account with another one overrides this, because the
+grant that reaches `workspace-*` cannot otherwise tell two deployments apart.
+"""
+DATA_STORAGE_BUCKET = f"{NAME}-data"
+OBJECT_STORE_ACCESS_KEY_ID = NAME
+OBJECT_STORE_SECRET_ACCESS_KEY = f"{NAME}-secret"
+WORKSPACE_OBJECT_BUCKET = "default"
+IMAGE_BUILD_CONTEXT_BUCKET = "build-contexts"
+CLUSTER_NAME_LABEL = f"{_LABEL_NAME}ClusterName"
+POOL_NAME_LABEL = f"{_LABEL_NAME}PoolName"
+MACHINE_ID_LABEL = f"{_LABEL_NAME}MachineId"
+DEFAULT_RESOURCE_TYPE = NAME
+EVENT_SOURCE = f"{NAME}-cluster"
+INTERNAL_WEBHOOK_FORMAT = f"{NAME}-webhook"
+METRICS_NAMESPACE = NAME.replace("-", "_")
+AGENT_NAME = f"{NAME}-agent"
+AGENT_SERVICE_DESCRIPTION = f"{DISPLAY_NAME} agent"
+AGENT_LAUNCHD_LABEL_PREFIX = f"com.{NAME}.agent"
+CONTROL_PLANE_SERVICE_NAME = f"{NAME}-api"
+CONTROL_PLANE_IMAGE = "api"
+SCHEDULER_PROCESS_NAME = f"{NAME}-scheduler"
+SCHEDULER_IMAGE = "scheduler"
+CONTAINER_WORKER_PROCESS_NAME = f"{NAME}-container-worker"
+CONTAINER_WORKER_IMAGE = "container-worker"
+CONTAINER_HELPER_PATH = f"/usr/local/bin/{NAME}-sandbox-supervisor"
+WORKER_BOOTSTRAP_PROCESS_NAME = f"{NAME}-worker-bootstrap"
+WORKER_BOOTSTRAP_IMAGE = "worker-bootstrap"
+CACHE_SERVER_PROCESS_NAME = f"{NAME}-cache-server"
+CACHE_SERVER_IMAGE = "cache-server"
+SANDBOX_COMPOSE_OVERRIDE_PATH = f"/tmp/{NAME}-docker-compose.override.yml"
+METRICS_SOURCE = NAME
+PRIVATE_RESOURCE_PREFIX = f"{NAME}-private"
+SOURCE_CACHE_DIR = f"{NAME}-source-cache"
+SOURCE_PACKAGE_BUCKET = f"{NAME}-source-packages"
+WORKSPACE_UPLOAD_BUCKETS = frozenset(
+    {WORKSPACE_OBJECT_BUCKET, SOURCE_PACKAGE_BUCKET, IMAGE_BUILD_CONTEXT_BUCKET}
+)
+
+__all__ = [
+    "ADMIN_CLI_NAME",
+    "AGENT_CONTAINER_DATA_PATH",
+    "AGENT_CONTAINER_LOG_PATH",
+    "AGENT_CONTAINER_OBJECT_PATH",
+    "AGENT_CONTAINER_TMP_PATH",
+    "AGENT_LAUNCHD_LABEL_PREFIX",
+    "AGENT_NAME",
+    "AGENT_SERVICE_DESCRIPTION",
+    "AGENT_STATE_DIR",
+    "AGENT_WORKER_CONFIG_PATH",
+    "CACHE_DIR",
+    "CACHE_PAGES_DIR",
+    "CACHE_SERVER_IMAGE",
+    "CACHE_SERVER_PROCESS_NAME",
+    "CHECKPOINT_SIGNAL_ROOT",
+    "CLI_NAME",
+    "CLUSTER_NAME_LABEL",
+    "CONTAINER_HELPER_PATH",
+    "CONTAINER_WORKER_IMAGE",
+    "CONTAINER_WORKER_PROCESS_NAME",
+    "CONTROL_PLANE_IMAGE",
+    "CONTROL_PLANE_SERVICE_NAME",
+    "DATA_STORAGE_BUCKET",
+    "DEFAULT_RESOURCE_TYPE",
+    "DISPLAY_NAME",
+    "ENDPOINT_IMAGE",
+    "ENV_PREFIX",
+    "EVENT_SOURCE",
+    "FUNCTION_IMAGE",
+    "HOME_DIR",
+    "IMAGE_BUILD_CONTEXT_BUCKET",
+    "INTERNAL_WEBHOOK_FORMAT",
+    "MACHINE_ID_LABEL",
+    "MANAGED_PACKAGE_ROOT",
+    "METRICS_NAMESPACE",
+    "METRICS_SOURCE",
+    "NAME",
+    "OBJECT_STORE_ACCESS_KEY_ID",
+    "OBJECT_STORE_BUCKET",
+    "OBJECT_STORE_SECRET_ACCESS_KEY",
+    "POD_IMAGE",
+    "POOL_NAME_LABEL",
+    "PRIVATE_RESOURCE_PREFIX",
+    "REDIS_KEY_PREFIX",
+    "SANDBOX_COMPOSE_OVERRIDE_PATH",
+    "SCHEDULER_IMAGE",
+    "SCHEDULER_PROCESS_NAME",
+    "SHELL_IMAGE",
+    "SHELL_LOG_PATH",
+    "SOURCE_CACHE_DIR",
+    "SOURCE_PACKAGE_BUCKET",
+    "STATE_DIR",
+    "WORKER_BOOTSTRAP_IMAGE",
+    "WORKER_BOOTSTRAP_PROCESS_NAME",
+    "WORKER_BUNDLE_ROOT",
+    "WORKER_CHECKPOINT_ROOT",
+    "WORKSPACE_BUCKET_PREFIX",
+    "WORKSPACE_OBJECT_BUCKET",
+    "WORKSPACE_UPLOAD_BUCKETS",
+]

lazycloud_shared-0.0.0/src/shared/app_lifecycle.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class AppLifecycleState(str, Enum):
+    Active = "active"
+    Pausing = "pausing"
+    Paused = "paused"
+    Resuming = "resuming"
+    Deleting = "deleting"
+    CleanupFailed = "cleanup_failed"
+    Deleted = "deleted"
+
+
+class AppLifecycleTarget(str, Enum):
+    Active = "active"
+    Paused = "paused"
+    Deleted = "deleted"
+
+
+class AppDeploymentIntentTarget(str, Enum):
+    Active = "active"
+    Inactive = "inactive"
+    Deleted = "deleted"
+
+
+UNFINISHED_APP_LIFECYCLE_STATES = frozenset(
+    {
+        AppLifecycleState.Pausing,
+        AppLifecycleState.Resuming,
+        AppLifecycleState.Deleting,
+        AppLifecycleState.CleanupFailed,
+    }
+)
+
+
+__all__ = [
+    "UNFINISHED_APP_LIFECYCLE_STATES",
+    "AppDeploymentIntentTarget",
+    "AppLifecycleState",
+    "AppLifecycleTarget",
+]

lazycloud_shared-0.0.0/src/shared/app_slug.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import keyword
+import re
+
+APP_SLUG_PATTERN = re.compile(r"^[a-z][a-z0-9_]{0,62}$")
+
+
+def validate_app_slug(value: str) -> str:
+    slug = value.strip()
+    if not APP_SLUG_PATTERN.fullmatch(slug) or keyword.iskeyword(slug):
+        msg = (
+            "app slug must be a lowercase Python identifier segment, "
+            "start with a letter, and contain only lowercase letters, digits, or underscores"
+        )
+        raise ValueError(msg)
+    return slug
+
+
+def app_slug_from_name(value: str) -> str:
+    raw = value.strip().lower()
+    slug = re.sub(r"[^a-z0-9_]+", "_", raw).strip("_")
+    if not slug or not slug[0].isalpha():
+        slug = f"app_{slug or 'default'}"
+    if len(slug) > 63:
+        slug = slug[:63].rstrip("_")
+    if keyword.iskeyword(slug):
+        slug = f"{slug}_app"
+    return validate_app_slug(slug)
+
+
+def app_slug_or_default(value: str | None, *, default: str) -> str:
+    selected = (value or "").strip()
+    if selected:
+        return validate_app_slug(selected)
+    return app_slug_from_name(default)
+
+
+__all__ = [
+    "APP_SLUG_PATTERN",
+    "app_slug_from_name",
+    "app_slug_or_default",
+    "validate_app_slug",
+]

lazycloud_shared-0.0.0/src/shared/autoscaler_state.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import Field, JsonValue
+
+from shared.contracts import ContractModel
+from shared.enums import StringEnum
+from shared.timestamps import utc_now
+
+
+class AutoscalerTargetKind(StringEnum):
+    Function = "function"
+    Endpoint = "endpoint"
+    Pod = "pod"
+
+
+class AutoscalerStateRecord(ContractModel):
+    name: str
+    workspace_id: str
+    source: str
+    target_kind: AutoscalerTargetKind
+    target_id: str
+    deployment_id: str = ""
+    app_id: str = ""
+    current_count: int = 0
+    desired_count: int = 0
+    signal_name: str = ""
+    signal_value: int = 0
+    decision: str = ""
+    reason: str = ""
+    active: bool = True
+    valid: bool = True
+    lock_acquired: bool = True
+    owner_lock_key: str = ""
+    cooldown_until: datetime | None = None
+    failed_container_count: int = 0
+    error: str = ""
+    last_sample: dict[str, JsonValue] = Field(default_factory=dict)
+    last_actions: list[dict[str, JsonValue]] = Field(default_factory=list)
+    updated_at: datetime = Field(default_factory=utc_now)
+
+
+def autoscaler_state_name(target_kind: AutoscalerTargetKind, target_id: str) -> str:
+    return f"{target_kind.value}:{target_id}"
+
+
+__all__ = [
+    "AutoscalerStateRecord",
+    "AutoscalerTargetKind",
+    "autoscaler_state_name",
+]