robotframework-tracer 0.2.1__tar.gz → 0.2.3__tar.gz

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: robotframework-tracer
-Version: 0.2.1
+Version: 0.2.3
 Summary: OpenTelemetry distributed tracing for Robot Framework
 Author: Robot Framework Tracer Contributors
 License: Apache-2.0
@@ -108,9 +108,23 @@ docker run -d --name jaeger \
 ### 2. Run your tests with the listener
 
 ```bash
+# Basic usage (uses default endpoint localhost:4318)
 robot --listener robotframework_tracer.TracingListener tests/
+
+# With environment variables (recommended for custom endpoints)
+export OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4318/v1/traces
+export OTEL_SERVICE_NAME=my-tests
+robot --listener robotframework_tracer.TracingListener tests/
+
+# With inline options (colon-separated key=value pairs)
+robot --listener "robotframework_tracer.TracingListener:service_name=my-tests:capture_logs=true" tests/
+
+# With custom endpoint (URL colons are automatically handled)
+robot --listener "robotframework_tracer.TracingListener:endpoint=http://jaeger:4318/v1/traces:service_name=my-tests" tests/
 ```
 
+> **Note:** Robot Framework splits listener arguments on `:`. Use colons to separate options. URLs containing `://` are automatically reconstructed.
+
 ### 3. View traces
 
 Open http://localhost:16686 in your browser to see your test traces in Jaeger UI.

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/README.md

@@ -71,9 +71,23 @@ docker run -d --name jaeger \
 ### 2. Run your tests with the listener
 
 ```bash
+# Basic usage (uses default endpoint localhost:4318)
 robot --listener robotframework_tracer.TracingListener tests/
+
+# With environment variables (recommended for custom endpoints)
+export OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4318/v1/traces
+export OTEL_SERVICE_NAME=my-tests
+robot --listener robotframework_tracer.TracingListener tests/
+
+# With inline options (colon-separated key=value pairs)
+robot --listener "robotframework_tracer.TracingListener:service_name=my-tests:capture_logs=true" tests/
+
+# With custom endpoint (URL colons are automatically handled)
+robot --listener "robotframework_tracer.TracingListener:endpoint=http://jaeger:4318/v1/traces:service_name=my-tests" tests/
 ```
 
+> **Note:** Robot Framework splits listener arguments on `:`. Use colons to separate options. URLs containing `://` are automatically reconstructed.
+
 ### 3. View traces
 
 Open http://localhost:16686 in your browser to see your test traces in Jaeger UI.

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "robotframework-tracer"
-version = "0.2.1"
+version = "0.2.3"
 description = "OpenTelemetry distributed tracing for Robot Framework"
 readme = "README.md"
 requires-python = ">=3.8"

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/src/robotframework_tracer/listener.py

@@ -1,14 +1,15 @@
+import platform
+import sys
+
+import robot
 from opentelemetry import trace
 from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter as HTTPExporter
-from opentelemetry.sdk.resources import Resource, SERVICE_NAME, SERVICE_VERSION
+from opentelemetry.propagate import inject
+from opentelemetry.sdk.resources import SERVICE_NAME, Resource
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
-from opentelemetry.sdk.trace.sampling import TraceIdRatioBased, ParentBased
+from opentelemetry.sdk.trace.sampling import ParentBased, TraceIdRatioBased
 from opentelemetry.semconv.resource import ResourceAttributes
-from opentelemetry.propagate import inject
-import platform
-import sys
-import robot
 
 from .config import TracerConfig
 from .span_builder import SpanBuilder
@@ -37,57 +38,20 @@ class TracingListener:
 
     ROBOT_LISTENER_API_VERSION = 3
 
-    def __init__(
-        self,
-        endpoint=None,
-        service_name=None,
-        protocol=None,
-        capture_arguments=None,
-        max_arg_length=None,
-        capture_logs=None,
-        sample_rate=None,
-        span_prefix_style=None,
-        log_level=None,
-        max_log_length=None,
-    ):
+    def __init__(self, *args, **kwargs):
         """Initialize the tracing listener.
 
-        Args:
-            endpoint: OTLP endpoint URL
-            service_name: Service name for traces
-            protocol: Protocol (http or grpc)
-            capture_arguments: Whether to capture keyword arguments
-            max_arg_length: Maximum length for arguments
-            capture_logs: Whether to capture log messages
-            sample_rate: Sampling rate (0.0-1.0)
-            span_prefix_style: Span prefix style (none, text, emoji)
-            log_level: Minimum log level to capture (DEBUG, INFO, WARN, ERROR)
-            max_log_length: Maximum length for log messages
+        Accepts arguments in multiple formats:
+        - Environment variables (recommended): OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME
+        - Keyword arguments: endpoint=..., service_name=...
+        - RF listener args: key=value pairs (comma-separated)
+
+        Note: Robot Framework splits listener arguments on ':' which breaks URLs.
+        This listener automatically reconstructs URLs that were split.
         """
-        # Build kwargs dict from provided arguments
-        kwargs = {}
-        if endpoint is not None:
-            kwargs["endpoint"] = endpoint
-        if service_name is not None:
-            kwargs["service_name"] = service_name
-        if protocol is not None:
-            kwargs["protocol"] = protocol
-        if capture_arguments is not None:
-            kwargs["capture_arguments"] = capture_arguments
-        if max_arg_length is not None:
-            kwargs["max_arg_length"] = max_arg_length
-        if capture_logs is not None:
-            kwargs["capture_logs"] = capture_logs
-        if sample_rate is not None:
-            kwargs["sample_rate"] = sample_rate
-        if span_prefix_style is not None:
-            kwargs["span_prefix_style"] = span_prefix_style
-        if log_level is not None:
-            kwargs["log_level"] = log_level
-        if max_log_length is not None:
-            kwargs["max_log_length"] = max_log_length
-
-        self.config = TracerConfig(**kwargs)
+        parsed_kwargs = self._parse_listener_args(args)
+        parsed_kwargs.update(kwargs)
+        self.config = TracerConfig(**parsed_kwargs)
 
         # Initialize OpenTelemetry with automatic resource detection
         resource_attrs = {
@@ -130,6 +94,42 @@ class TracingListener:
         self.tracer = trace.get_tracer(__name__)
         self.span_stack = []
 
+    @staticmethod
+    def _parse_listener_args(args):
+        """Parse Robot Framework listener arguments.
+
+        RF splits arguments on ':' and passes each as a separate arg.
+        Example: 'listener:endpoint=http://host:4318:service_name=test'
+        becomes args = ('endpoint=http', '//host', '4318', 'service_name=test')
+
+        This method reconstructs URLs and parses key=value pairs.
+        """
+        if not args:
+            return {}
+
+        kwargs = {}
+        i = 0
+        while i < len(args):
+            arg = args[i]
+
+            if "=" in arg:
+                key, value = arg.split("=", 1)
+                # Check if value is start of a URL that got split
+                if value in ("http", "https") and i + 1 < len(args) and args[i + 1].startswith("//"):
+                    # Reconstruct URL: scheme + :// + rest
+                    url_parts = [value]
+                    i += 1
+                    while i < len(args) and "=" not in args[i]:
+                        url_parts.append(args[i])
+                        i += 1
+                    kwargs[key.strip()] = ":".join(url_parts)
+                    continue
+                else:
+                    kwargs[key.strip()] = value.strip()
+            i += 1
+
+        return kwargs
+
     def _set_trace_context_variables(self):
         """Set Robot Framework variables with current trace context."""
         if not BUILTIN_AVAILABLE:
@@ -170,7 +170,7 @@ class TracingListener:
             if headers.get("tracestate"):
                 builtin.set_test_variable("${TRACESTATE}", headers["tracestate"])
 
-        except Exception as e:
+        except Exception:
             # Silently ignore errors to avoid breaking tests
             pass
 

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/src/robotframework_tracer/span_builder.py

@@ -1,6 +1,6 @@
-from opentelemetry import trace, baggage
-from opentelemetry.trace import Status, StatusCode
 import robot
+from opentelemetry import baggage, trace
+from opentelemetry.trace import Status, StatusCode
 
 from .attributes import AttributeExtractor, RFAttributes
 

robotframework_tracer-0.2.3/src/robotframework_tracer/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.3"

{robotframework_tracer-0.2.1 → robotframework_tracer-0.2.3}/src/robotframework_tracer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: robotframework-tracer
-Version: 0.2.1
+Version: 0.2.3
 Summary: OpenTelemetry distributed tracing for Robot Framework
 Author: Robot Framework Tracer Contributors
 License: Apache-2.0
@@ -108,9 +108,23 @@ docker run -d --name jaeger \
 ### 2. Run your tests with the listener
 
 ```bash
+# Basic usage (uses default endpoint localhost:4318)
 robot --listener robotframework_tracer.TracingListener tests/
+
+# With environment variables (recommended for custom endpoints)
+export OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4318/v1/traces
+export OTEL_SERVICE_NAME=my-tests
+robot --listener robotframework_tracer.TracingListener tests/
+
+# With inline options (colon-separated key=value pairs)
+robot --listener "robotframework_tracer.TracingListener:service_name=my-tests:capture_logs=true" tests/
+
+# With custom endpoint (URL colons are automatically handled)
+robot --listener "robotframework_tracer.TracingListener:endpoint=http://jaeger:4318/v1/traces:service_name=my-tests" tests/
 ```
 
+> **Note:** Robot Framework splits listener arguments on `:`. Use colons to separate options. URLs containing `://` are automatically reconstructed.
+
 ### 3. View traces
 
 Open http://localhost:16686 in your browser to see your test traces in Jaeger UI.

robotframework_tracer-0.2.1/src/robotframework_tracer/version.py

@@ -1 +0,0 @@
-__version__ = "0.2.1"