phlo-postgres 0.1.0__py3-none-any.whl

phlo_postgres/__init__.py

@@ -0,0 +1,7 @@
+"""Postgres service plugin package."""
+
+from phlo_postgres.plugin import PostgresServicePlugin
+from phlo_postgres.settings import PostgresSettings, get_settings
+
+__all__ = ["PostgresServicePlugin", "PostgresSettings", "get_settings"]
+__version__ = "0.1.0"

phlo_postgres/exporter_service.yaml

@@ -0,0 +1,39 @@
+name: postgres-exporter
+description: Prometheus exporter for PostgreSQL metrics
+category: observability
+default: false
+profile: observability
+
+image: quay.io/prometheuscommunity/postgres-exporter:v0.15.0
+
+depends_on:
+  - postgres
+
+compose:
+  restart: unless-stopped
+  labels:
+    phlo.metrics.enabled: "true"
+    phlo.metrics.port: "postgres-exporter:9187"
+    phlo.metrics.path: "/metrics"
+  environment:
+    DATA_SOURCE_NAME: postgresql://${POSTGRES_USER:-phlo}:${POSTGRES_PASSWORD:-phlo}@postgres:5432/${POSTGRES_DB:-phlo}?sslmode=disable
+  ports:
+    - "${POSTGRES_EXPORTER_PORT:-9187}:9187"
+  healthcheck:
+    test:
+      [
+        "CMD",
+        "wget",
+        "--quiet",
+        "--tries=1",
+        "--spider",
+        "http://localhost:9187/metrics",
+      ]
+    interval: 10s
+    timeout: 5s
+    retries: 5
+
+env_vars:
+  POSTGRES_EXPORTER_PORT:
+    default: 9187
+    description: Postgres exporter metrics port

phlo_postgres/plugin.py

@@ -0,0 +1,47 @@
+"""Postgres service plugin."""
+
+from __future__ import annotations
+
+from importlib import resources
+from typing import Any
+
+import yaml
+from phlo.plugins import PluginMetadata, ServicePlugin
+
+
+class PostgresServicePlugin(ServicePlugin):
+    """Service plugin for Postgres."""
+
+    @property
+    def metadata(self) -> PluginMetadata:
+        return PluginMetadata(
+            name="postgres",
+            version="0.1.0",
+            description="PostgreSQL database for metadata and operational storage",
+            author="Phlo Team",
+            tags=["core", "database", "postgres"],
+        )
+
+    @property
+    def service_definition(self) -> dict[str, Any]:
+        service_path = resources.files("phlo_postgres").joinpath("service.yaml")
+        return yaml.safe_load(service_path.read_text(encoding="utf-8"))
+
+
+class PostgresExporterServicePlugin(ServicePlugin):
+    """Service plugin for Postgres Prometheus exporter."""
+
+    @property
+    def metadata(self) -> PluginMetadata:
+        return PluginMetadata(
+            name="postgres-exporter",
+            version="0.1.0",
+            description="Prometheus exporter for PostgreSQL metrics",
+            author="Phlo Team",
+            tags=["observability", "metrics", "postgres"],
+        )
+
+    @property
+    def service_definition(self) -> dict[str, Any]:
+        service_path = resources.files("phlo_postgres").joinpath("exporter_service.yaml")
+        return yaml.safe_load(service_path.read_text(encoding="utf-8"))

phlo_postgres/service.yaml

@@ -0,0 +1,60 @@
+name: postgres
+description: PostgreSQL database for metadata and operational storage
+category: core
+default: true
+
+image: postgres:16-alpine
+
+compose:
+  restart: unless-stopped
+  labels:
+    phlo.metrics.enabled: "false"
+    phlo.grafana.datasource: "true"
+    phlo.grafana.datasource.type: "postgres"
+    phlo.grafana.datasource.name: "PostgreSQL"
+    phlo.grafana.datasource.url: "postgres:5432"
+    phlo.grafana.datasource.database: "${POSTGRES_DB:-phlo}"
+  environment:
+    POSTGRES_USER: ${POSTGRES_USER:-phlo}
+    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-phlo}
+    POSTGRES_DB: ${POSTGRES_DB:-phlo}
+    # SSL/TLS
+    POSTGRES_SSL_MODE: ${POSTGRES_SSL_MODE:-prefer}
+  ports:
+    - "${POSTGRES_PORT:-5432}:5432"
+  volumes:
+    - ./volumes/postgres:/var/lib/postgresql/data
+    - ./volumes/postgres-certs:/var/lib/postgresql/certs:ro
+  healthcheck:
+    test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-phlo}"]
+    interval: 10s
+    timeout: 5s
+    retries: 10
+
+env_vars:
+  POSTGRES_USER:
+    default: phlo
+    description: PostgreSQL username
+  POSTGRES_PASSWORD:
+    default: phlo
+    description: PostgreSQL password
+    secret: true
+  POSTGRES_DB:
+    default: phlo
+    description: PostgreSQL database name
+  POSTGRES_PORT:
+    default: 5432
+    description: PostgreSQL host port
+  # SSL/TLS
+  POSTGRES_SSL_MODE:
+    default: "prefer"
+    description: "SSL mode: disable, allow, prefer, require, verify-ca, verify-full"
+  POSTGRES_SSL_CERT_FILE:
+    default: ""
+    description: "Path to SSL certificate file"
+  POSTGRES_SSL_KEY_FILE:
+    default: ""
+    description: "Path to SSL private key file"
+  POSTGRES_SSL_CA_FILE:
+    default: ""
+    description: "Path to SSL CA certificate file"

phlo_postgres/settings.py

@@ -0,0 +1,34 @@
+"""Postgres settings."""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from urllib.parse import quote_plus
+
+from pydantic import Field
+
+from phlo.config.base import BaseConfig
+
+
+class PostgresSettings(BaseConfig):
+    """PostgreSQL database connection and schema configuration."""
+
+    postgres_host: str = Field(default="postgres", description="PostgreSQL host")
+    postgres_port: int = Field(default=10000, description="PostgreSQL port")
+    postgres_user: str = Field(default="lake", description="PostgreSQL username")
+    postgres_password: str = Field(default="phlo", description="PostgreSQL password")
+    postgres_db: str = Field(default="lakehouse", description="PostgreSQL database name")
+    postgres_mart_schema: str = Field(
+        default="marts", description="Schema for published mart tables"
+    )
+
+    def get_postgres_connection_string(self, include_db: bool = True) -> str:
+        db_part = f"/{self.postgres_db}" if include_db else ""
+        user = quote_plus(self.postgres_user)
+        password = quote_plus(self.postgres_password)
+        return f"postgresql://{user}:{password}@{self.postgres_host}:{self.postgres_port}{db_part}"
+
+
+@lru_cache(maxsize=1)
+def get_settings() -> PostgresSettings:
+    return PostgresSettings()

phlo_postgres-0.1.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: phlo-postgres
+Version: 0.1.0
+Summary: Postgres service plugin for Phlo
+Author-email: Phlo Team <team@phlo.dev>
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/plain
+Requires-Dist: phlo>=0.1.0
+Requires-Dist: pyyaml>=6.0.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+Postgres service plugin for Phlo.

phlo_postgres-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+phlo_postgres/__init__.py,sha256=BeeQUZMLR7x-tWHfuY4hAhr9CJEZXVRO1HfCgdU3aBE,256
+phlo_postgres/exporter_service.yaml,sha256=zVey9kjH0LuAyuk1OJmvWTsAZ_aptlDUa0Z0as4l56I,921
+phlo_postgres/plugin.py,sha256=2CX_qxL1YTiQbQ0Fb6dRD3Ax1_LHPzmM33yR_eDYcvA,1487
+phlo_postgres/service.yaml,sha256=2TXkVjHDEasRuD7lKemyYx48lJJM-0H_YkpIKWs0KMg,1699
+phlo_postgres/settings.py,sha256=AEMZykCGAXQ1cwk0a33svaxrTI21iw1Ajo6-ZE5Kkac,1275
+phlo_postgres-0.1.0.dist-info/METADATA,sha256=Znh-Zf5MYXWszvavM1ldqSFylmZgDaFy900NnTJeo08,410
+phlo_postgres-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+phlo_postgres-0.1.0.dist-info/entry_points.txt,sha256=OEUFQlRmhOyhHftv5e1hE2HXNJmyp6Vx3GkmhQVAYMA,149
+phlo_postgres-0.1.0.dist-info/top_level.txt,sha256=GX2lGJKXnVVuLJpMoWstq2qFmsYtw0xHzzfE0qOf1jw,14
+phlo_postgres-0.1.0.dist-info/RECORD,,

phlo_postgres-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

phlo_postgres-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[phlo.plugins.services]
+postgres = phlo_postgres.plugin:PostgresServicePlugin
+postgres-exporter = phlo_postgres.plugin:PostgresExporterServicePlugin

phlo_postgres-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+phlo_postgres