ergon-framework-python 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

ergon/__init__.py

@@ -1,13 +1,13 @@
-from . import connector, service, task, telemetry, utils
-from .task.manager import manager
-
-__all__ = [
-    "service",
-    "connector",
-    "task",
-    "telemetry",
-    "utils",
-    "manager",
-]
-
-__version__ = "0.1.1"
+from . import connector, service, task, telemetry, utils
+from .task.manager import manager
+
+__all__ = [
+    "service",
+    "connector",
+    "task",
+    "telemetry",
+    "utils",
+    "manager",
+]
+
+__version__ = "0.1.3"

ergon/bootstrap/src/__project__/_observability/docker-compose.telemetry.yml

@@ -1,124 +1,124 @@
-services:
-
-  ############################################################
-  # OpenTelemetry Collector
-  ############################################################
-  otel-collector:
-    image: otel/opentelemetry-collector-contrib:0.114.0
-    container_name: ergon-otel-collector
-    restart: unless-stopped
-    command: ["--config=/etc/otelcol/config.yaml"]
-    volumes:
-      - ./otel-collector-config.yaml:/etc/otelcol/config.yaml:ro
-    ports:
-      - "4317:4317"     # OTLP gRPC
-      - "4318:4318"     # OTLP HTTP
-      - "9464:9464"     # Prometheus scrape (metrics)
-    depends_on:
-      - tempo
-      - loki
-    healthcheck:
-      test: ["CMD", "wget", "--spider", "-q", "http://localhost:13133/"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - ergon-telemetry
-
-  ############################################################
-  # Loki (Logs)
-  ############################################################
-  loki:
-    image: grafana/loki:3.0.0
-    container_name: ergon-loki
-    restart: unless-stopped
-    volumes:
-      - ./loki.yaml:/etc/loki/config.yaml:ro
-      - loki-data:/loki
-    command: -config.file=/etc/loki/config.yaml
-    ports:
-      - "3100:3100"
-    healthcheck:
-      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3100/ready"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - ergon-telemetry
-
-  ############################################################
-  # Tempo (Traces)
-  ############################################################
-  tempo:
-    image: grafana/tempo:2.4.1
-    container_name: ergon-tempo
-    restart: unless-stopped
-    volumes:
-      - ./tempo.yaml:/etc/tempo/config.yaml:ro
-      - tempo-data:/var/tempo
-    command: ["-config.file=/etc/tempo/config.yaml"]
-    ports:
-      - "3200:3200"
-    healthcheck:
-      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3200/ready"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - ergon-telemetry
-
-  ############################################################
-  # Prometheus (Metrics)
-  ############################################################
-  prometheus:
-    image: prom/prometheus:latest
-    container_name: ergon-prometheus
-    restart: unless-stopped
-    volumes:
-      - ./prometheus.yaml:/etc/prometheus/prometheus.yml:ro
-      - prom-data:/prometheus
-    command:
-      - "--config.file=/etc/prometheus/prometheus.yml"
-    ports:
-      - "9090:9090"
-    depends_on:
-      - otel-collector
-    healthcheck:
-      test: ["CMD", "wget", "--spider", "-q", "http://localhost:9090/-/ready"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - ergon-telemetry
-
-  ############################################################
-  # Grafana Dashboard UI
-  ############################################################
-  grafana:
-    image: grafana/grafana:10.4.0
-    container_name: ergon-grafana
-    restart: unless-stopped
-    volumes:
-      - ./grafana.yaml:/etc/grafana/provisioning/datasources/datasources.yaml:ro
-      - grafana-data:/var/lib/grafana
-    ports:
-      - "3000:3000"
-    networks:
-      - ergon-telemetry
-
-
-############################################################
-# Volumes
-############################################################
-volumes:
-  loki-data:
-  tempo-data:
-  prom-data:
-  grafana-data:
-
-############################################################
-# Network
-############################################################
-networks:
-  ergon-telemetry:
+services:
+
+  ############################################################
+  # OpenTelemetry Collector
+  ############################################################
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:0.114.0
+    container_name: ergon-otel-collector
+    restart: unless-stopped
+    command: ["--config=/etc/otelcol/config.yaml"]
+    volumes:
+      - ./otel-collector-config.yaml:/etc/otelcol/config.yaml:ro
+    ports:
+      - "4317:4317"     # OTLP gRPC
+      - "4318:4318"     # OTLP HTTP
+      - "9464:9464"     # Prometheus scrape (metrics)
+    depends_on:
+      - tempo
+      - loki
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:13133/"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ergon-telemetry
+
+  ############################################################
+  # Loki (Logs)
+  ############################################################
+  loki:
+    image: grafana/loki:3.0.0
+    container_name: ergon-loki
+    restart: unless-stopped
+    volumes:
+      - ./loki.yaml:/etc/loki/config.yaml:ro
+      - loki-data:/loki
+    command: -config.file=/etc/loki/config.yaml
+    ports:
+      - "3100:3100"
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3100/ready"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ergon-telemetry
+
+  ############################################################
+  # Tempo (Traces)
+  ############################################################
+  tempo:
+    image: grafana/tempo:2.4.1
+    container_name: ergon-tempo
+    restart: unless-stopped
+    volumes:
+      - ./tempo.yaml:/etc/tempo/config.yaml:ro
+      - tempo-data:/var/tempo
+    command: ["-config.file=/etc/tempo/config.yaml"]
+    ports:
+      - "3200:3200"
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3200/ready"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ergon-telemetry
+
+  ############################################################
+  # Prometheus (Metrics)
+  ############################################################
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: ergon-prometheus
+    restart: unless-stopped
+    volumes:
+      - ./prometheus.yaml:/etc/prometheus/prometheus.yml:ro
+      - prom-data:/prometheus
+    command:
+      - "--config.file=/etc/prometheus/prometheus.yml"
+    ports:
+      - "9090:9090"
+    depends_on:
+      - otel-collector
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:9090/-/ready"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ergon-telemetry
+
+  ############################################################
+  # Grafana Dashboard UI
+  ############################################################
+  grafana:
+    image: grafana/grafana:10.4.0
+    container_name: ergon-grafana
+    restart: unless-stopped
+    volumes:
+      - ./grafana.yaml:/etc/grafana/provisioning/datasources/datasources.yaml:ro
+      - grafana-data:/var/lib/grafana
+    ports:
+      - "3000:3000"
+    networks:
+      - ergon-telemetry
+
+
+############################################################
+# Volumes
+############################################################
+volumes:
+  loki-data:
+  tempo-data:
+  prom-data:
+  grafana-data:
+
+############################################################
+# Network
+############################################################
+networks:
+  ergon-telemetry:
     driver: bridge

ergon/bootstrap/src/__project__/_observability/grafana.yaml

@@ -1,17 +1,17 @@
-apiVersion: 1
-
-datasources:
-  - name: Loki
-    type: loki
-    access: proxy
-    url: http://loki:3100
-
-  - name: Tempo
-    type: tempo
-    access: proxy
-    url: http://tempo:3200
-
-  - name: Prometheus
-    type: prometheus
-    access: proxy
+apiVersion: 1
+
+datasources:
+  - name: Loki
+    type: loki
+    access: proxy
+    url: http://loki:3100
+
+  - name: Tempo
+    type: tempo
+    access: proxy
+    url: http://tempo:3200
+
+  - name: Prometheus
+    type: prometheus
+    access: proxy
     url: http://prometheus:9090

ergon/bootstrap/src/__project__/_observability/loki.yaml

@@ -1,48 +1,48 @@
-auth_enabled: false
-
-server:
-  http_listen_port: 3100
-  grpc_listen_port: 9096
-
-common:
-  instance_addr: 127.0.0.1
-  path_prefix: /loki
-  storage:
-    filesystem:
-      chunks_directory: /loki/chunks
-      rules_directory: /loki/rules
-  replication_factor: 1
-  ring:
-    kvstore:
-      store: inmemory
-
-query_range:
-  results_cache:
-    cache:
-      embedded_cache:
-        enabled: true
-        max_size_mb: 100
-
-schema_config:
-  configs:
-    - from: "2024-01-01"
-      store: tsdb
-      object_store: filesystem
-      schema: v13
-      index:
-        prefix: index_
-        period: 24h
-
-pattern_ingester:
-  enabled: true
-
-compactor:
-  working_directory: /loki/boltdb-shipper-compactor
-  # shared_store: filesystem  <-- REMOVED (Invalid in Loki 3.0)
-  delete_request_store: filesystem # <-- ADDED (Required for retention)
-  retention_enabled: true 
-
-limits_config:
-  retention_period: 24h
-  allow_structured_metadata: true
+auth_enabled: false
+
+server:
+  http_listen_port: 3100
+  grpc_listen_port: 9096
+
+common:
+  instance_addr: 127.0.0.1
+  path_prefix: /loki
+  storage:
+    filesystem:
+      chunks_directory: /loki/chunks
+      rules_directory: /loki/rules
+  replication_factor: 1
+  ring:
+    kvstore:
+      store: inmemory
+
+query_range:
+  results_cache:
+    cache:
+      embedded_cache:
+        enabled: true
+        max_size_mb: 100
+
+schema_config:
+  configs:
+    - from: "2024-01-01"
+      store: tsdb
+      object_store: filesystem
+      schema: v13
+      index:
+        prefix: index_
+        period: 24h
+
+pattern_ingester:
+  enabled: true
+
+compactor:
+  working_directory: /loki/boltdb-shipper-compactor
+  # shared_store: filesystem  <-- REMOVED (Invalid in Loki 3.0)
+  delete_request_store: filesystem # <-- ADDED (Required for retention)
+  retention_enabled: true 
+
+limits_config:
+  retention_period: 24h
+  allow_structured_metadata: true
   max_query_length: 720h

ergon/bootstrap/src/__project__/_observability/otel-collector-config.yaml

@@ -1,53 +1,53 @@
-receivers:
-  otlp:
-    protocols:
-      http: 
-        endpoint: 0.0.0.0:4318
-      grpc:
-        endpoint: 0.0.0.0:4317
-
-exporters:
-  loki:
-    endpoint: http://loki:3100/loki/api/v1/push
-    labels:
-      resource:
-        service.name: "service_name"
-        service.version: "service_version"
-        ergon.task.name: "task_name"
-        ergon.task.execution.host.name: "host_name"
-      attributes:
-        level: "level"
-  
-    default_labels_enabled:
-      exporter: false
-      resource: false
-      attributes: false
-      scope: false
-
-  otlphttp/tempo:
-    endpoint: http://tempo:4318
-    tls:
-      insecure: true
-
-  prometheus:
-    endpoint: "0.0.0.0:9464"
-
-processors:
-  batch: {}
-
-service:
-  pipelines:
-    logs:
-      receivers: [otlp]
-      processors: [batch]  # ← Changed: removed "resource"
-      exporters: [loki]
-
-    traces:
-      receivers: [otlp]
-      processors: [batch]  # ← Changed: removed "resource"
-      exporters: [otlphttp/tempo]
-
-    metrics:
-      receivers: [otlp]
-      processors: [batch]
+receivers:
+  otlp:
+    protocols:
+      http: 
+        endpoint: 0.0.0.0:4318
+      grpc:
+        endpoint: 0.0.0.0:4317
+
+exporters:
+  loki:
+    endpoint: http://loki:3100/loki/api/v1/push
+    labels:
+      resource:
+        service.name: "service_name"
+        service.version: "service_version"
+        ergon.task.name: "task_name"
+        ergon.task.execution.host.name: "host_name"
+      attributes:
+        level: "level"
+  
+    default_labels_enabled:
+      exporter: false
+      resource: false
+      attributes: false
+      scope: false
+
+  otlphttp/tempo:
+    endpoint: http://tempo:4318
+    tls:
+      insecure: true
+
+  prometheus:
+    endpoint: "0.0.0.0:9464"
+
+processors:
+  batch: {}
+
+service:
+  pipelines:
+    logs:
+      receivers: [otlp]
+      processors: [batch]  # ← Changed: removed "resource"
+      exporters: [loki]
+
+    traces:
+      receivers: [otlp]
+      processors: [batch]  # ← Changed: removed "resource"
+      exporters: [otlphttp/tempo]
+
+    metrics:
+      receivers: [otlp]
+      processors: [batch]
       exporters: [prometheus]

ergon/bootstrap/src/__project__/_observability/prometheus.yaml

@@ -1,11 +1,11 @@
-global:
-  scrape_interval: 5s
-
-scrape_configs:
-  - job_name: "otel-collector"
-    static_configs:
-      - targets: ["otel-collector:9464"]
-
-  - job_name: "ergon_tasks"
-    static_configs:
+global:
+  scrape_interval: 5s
+
+scrape_configs:
+  - job_name: "otel-collector"
+    static_configs:
+      - targets: ["otel-collector:9464"]
+
+  - job_name: "ergon_tasks"
+    static_configs:
       - targets: ["otel-collector:9464"]

ergon/bootstrap/src/__project__/_observability/tempo.yaml

@@ -1,24 +1,24 @@
-server:
-  http_listen_port: 3200
-  grpc_listen_port: 9095
-
-distributor:
-  receivers:
-    otlp:
-      protocols:
-        grpc:
-        http:
-
-ingester:
-  max_block_bytes: 100_000_000
-  max_block_duration: 5m
-
-compactor:
-  compaction:
-    block_retention: 24h
-
-storage:
-  trace:
-    backend: local
-    local:
+server:
+  http_listen_port: 3200
+  grpc_listen_port: 9095
+
+distributor:
+  receivers:
+    otlp:
+      protocols:
+        grpc:
+        http:
+
+ingester:
+  max_block_bytes: 100_000_000
+  max_block_duration: 5m
+
+compactor:
+  compaction:
+    block_retention: 24h
+
+storage:
+  trace:
+    backend: local
+    local:
       path: /var/tempo/traces

ergon/bootstrap/src/__project__/main.py

@@ -1,9 +1,9 @@
-from ergon.cli import ergon
-
-
-def main():
-    ergon()
-
-
-if __name__ == "__main__":
-    main()
+from ergon.cli import ergon
+
+
+def main():
+    ergon()
+
+
+if __name__ == "__main__":
+    main()

ergon/bootstrap/src/__project__/tasks/constants.py

@@ -1,13 +1,13 @@
-from ergon.task.policies import RetryPolicy
-
-
-# ----------------------------------------
-# --- RETRY POLICY CONFIGURATION ---
-# ----------------------------------------
-def default_retry_policy():
-    return RetryPolicy(
-        max_attempts=3,
-        backoff=1,
-        backoff_multiplier=2,
-        backoff_cap=10,
-    )
+from ergon.task.policies import RetryPolicy
+
+
+# ----------------------------------------
+# --- RETRY POLICY CONFIGURATION ---
+# ----------------------------------------
+def default_retry_policy():
+    return RetryPolicy(
+        max_attempts=3,
+        backoff=1,
+        backoff_multiplier=2,
+        backoff_cap=10,
+    )

ergon/bootstrap/src/__project__/tasks/example_task/config.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from ergon import task
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from ergon import task

ergon/bootstrap/src/__project__/tasks/example_task/exceptions.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from ergon.task.exceptions import TransactionException
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from ergon.task.exceptions import TransactionException

ergon/bootstrap/src/__project__/tasks/example_task/helpers.py

@@ -1,4 +1,4 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from .. import helpers as shared
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from .. import helpers as shared

ergon/bootstrap/src/__project__/tasks/example_task/schemas.py

@@ -1,5 +1,5 @@
-# Uncomment below to use framework imports
-# ----------------------------------------
-
-# from pydantic import BaseModel
-# from .. import schemas as shared
+# Uncomment below to use framework imports
+# ----------------------------------------
+
+# from pydantic import BaseModel
+# from .. import schemas as shared

ergon/bootstrap/src/__project__/tasks/example_task/task.py

@@ -1 +1 @@
-# from ergon import task, connector
+# from ergon import task, connector