ergon-framework-python 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

ergon/__init__.py

@@ -10,4 +10,4 @@ __all__ = [
     "manager",
 ]
 
-__version__ = "0.1.3"
+__version__ = "0.1.6"

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/connector/__init__.py

@@ -37,7 +37,9 @@ from .rabbitmq import (
     AsyncRabbitmqClient,
     AsyncRabbitMQConnector,
     AsyncRabbitmqConsumerConfig,
+    AsyncRabbitmqExchangeBinding,
     AsyncRabbitmqProducerConfig,
+    AsyncRabbitmqQueueSubscription,
     AsyncRabbitMQService,
     RabbitmqClient,
     RabbitMQConnector,
@@ -72,7 +74,9 @@ __all__ = [
     "AsyncRabbitMQService",
     "AsyncRabbitmqClient",
     "AsyncRabbitmqConsumerConfig",
+    "AsyncRabbitmqExchangeBinding",
     "AsyncRabbitmqProducerConfig",
+    "AsyncRabbitmqQueueSubscription",
     "AsyncSQSConnector",
     "AsyncSQSService",
     "Connector",

ergon/connector/ergon_platform/_client.py

@@ -1,23 +1,23 @@
-from .models import ErgonPlatformClient
-
-_ERGON_PLATFORM_IMPORT_ERROR = "Install the ergon-platform-sdk package in the same environment"
-
-
-def _get_ergon_client():
-    try:
-        from ergon_platform import ErgonClient  # type: ignore[reportMissingImports]
-    except ImportError as exc:
-        raise ImportError(_ERGON_PLATFORM_IMPORT_ERROR) from exc
-    return ErgonClient
-
-
-def create_ergon_client(config: ErgonPlatformClient):
-    ErgonClient = _get_ergon_client()
-    return ErgonClient(
-        client_id=config.client_id,
-        client_secret=config.client_secret,
-        base_url=config.base_url,
-        company_id=config.company_id,
-        timeout=config.timeout,
-        max_retries=config.max_retries,
-    )
+from .models import ErgonPlatformClient
+
+_ERGON_PLATFORM_IMPORT_ERROR = "Install the ergon-platform-sdk package in the same environment"
+
+
+def _get_ergon_client():
+    try:
+        from ergon_platform import ErgonClient  # type: ignore[reportMissingImports]
+    except ImportError as exc:
+        raise ImportError(_ERGON_PLATFORM_IMPORT_ERROR) from exc
+    return ErgonClient
+
+
+def create_ergon_client(config: ErgonPlatformClient):
+    ErgonClient = _get_ergon_client()
+    return ErgonClient(
+        client_id=config.client_id,
+        client_secret=config.client_secret,
+        base_url=config.base_url,
+        company_id=config.company_id,
+        timeout=config.timeout,
+        max_retries=config.max_retries,
+    )