remove use of Optional, restore README of the package

Author: jj22ee

sdk-extension/opentelemetry-sdk-extension-aws/README.rst

@@ -74,30 +74,6 @@ populate `resource` attributes by creating a `TraceProvider` using the `AwsEc2Re
 Refer to each detectors' docstring to determine any possible requirements for that
 detector.
 
-
-[WORK IN PROGRESS] Usage (AWS X-Ray Remote Sampler)
----------------------------------------------------
-
-
-Use the provided AWS X-Ray Remote Sampler by setting this sampler in your instrumented application:
-
-.. code-block:: python
-
-    from opentelemetry.sdk.extension.aws.trace.sampler import AwsXRayRemoteSampler
-    from opentelemetry import trace
-    from opentelemetry.sdk.resources import Resource
-    from opentelemetry.sdk.trace import TracerProvider
-    from opentelemetry.semconv.resource import ResourceAttributes
-    from opentelemetry.util.types import Attributes
-
-    resource = Resource.create(attributes={
-        ResourceAttributes.SERVICE_NAME: "myService",
-        ResourceAttributes.CLOUD_PLATFORM: "aws_ec2",
-    })
-    xraySampler = AwsXRayRemoteSampler(resource=resource, polling_interval=300)
-    trace.set_tracer_provider(TracerProvider(sampler=xraySampler))
-
-
 References
 ----------
 

sdk-extension/opentelemetry-sdk-extension-aws/src/opentelemetry/sdk/extension/aws/trace/sampler/_aws_xray_sampling_client.py

@@ -16,9 +16,11 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+from __future__ import annotations
+
 import json
 from logging import getLogger
-from typing import List, Optional
+from typing import List
 
 import requests
 
@@ -39,7 +41,7 @@ class _AwsXRaySamplingClient:
     def __init__(
         self,
         endpoint: str = DEFAULT_SAMPLING_PROXY_ENDPOINT,
-        log_level: Optional[str] = None,
+        log_level: str | None = None,
     ):
         # Override default log level
         if log_level is not None:

sdk-extension/opentelemetry-sdk-extension-aws/src/opentelemetry/sdk/extension/aws/trace/sampler/_sampling_rule.py

@@ -16,27 +16,26 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-from typing import Optional
-
+from __future__ import annotations
 
 # Disable snake_case naming style so this class can match the sampling rules response from X-Ray
 # pylint: disable=invalid-name
 class _SamplingRule:
     def __init__(
         self,
-        Attributes: Optional["dict[str, str]"] = None,
-        FixedRate: Optional[float] = None,
-        HTTPMethod: Optional[str] = None,
-        Host: Optional[str] = None,
-        Priority: Optional[int] = None,
-        ReservoirSize: Optional[int] = None,
-        ResourceARN: Optional[str] = None,
-        RuleARN: Optional[str] = None,
-        RuleName: Optional[str] = None,
-        ServiceName: Optional[str] = None,
-        ServiceType: Optional[str] = None,
-        URLPath: Optional[str] = None,
-        Version: Optional[int] = None,
+        Attributes: dict[str, str] | None = None,
+        FixedRate: float | None = None,
+        HTTPMethod: str | None = None,
+        Host: str | None = None,
+        Priority: int | None = None,
+        ReservoirSize: int | None = None,
+        ResourceARN: str | None = None,
+        RuleARN: str | None = None,
+        RuleName: str | None = None,
+        ServiceName: str | None = None,
+        ServiceType: str | None = None,
+        URLPath: str | None = None,
+        Version: int | None = None,
     ):
         self.Attributes = Attributes if Attributes is not None else {}
         self.FixedRate = FixedRate if FixedRate is not None else 0.0

sdk-extension/opentelemetry-sdk-extension-aws/src/opentelemetry/sdk/extension/aws/trace/sampler/_sampling_rule_applier.py

@@ -16,7 +16,7 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-from typing import Optional
+from __future__ import annotations
 
 # pylint: disable=no-name-in-module
 from opentelemetry.sdk.extension.aws.trace.sampler._clock import _Clock
@@ -37,8 +37,8 @@ def __init__(
         sampling_rule: _SamplingRule,
         client_id: str,
         clock: _Clock,
-        statistics: Optional[_SamplingStatisticsDocument] = None,
-        target: Optional[_SamplingTarget] = None,
+        statistics: _SamplingStatisticsDocument | None = None,
+        target: _SamplingTarget | None = None,
     ):
         self.__client_id = client_id  # pylint: disable=W0238
         self._clock = clock

sdk-extension/opentelemetry-sdk-extension-aws/src/opentelemetry/sdk/extension/aws/trace/sampler/_sampling_target.py

@@ -16,8 +16,10 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+from __future__ import annotations
+
 from logging import getLogger
-from typing import List, Optional
+from typing import List
 
 _logger = getLogger(__name__)
 
@@ -27,11 +29,11 @@
 class _SamplingTarget:
     def __init__(
         self,
-        FixedRate: Optional[float] = None,
-        Interval: Optional[int] = None,
-        ReservoirQuota: Optional[int] = None,
-        ReservoirQuotaTTL: Optional[float] = None,
-        RuleName: Optional[str] = None,
+        FixedRate: float | None = None,
+        Interval: int | None = None,
+        ReservoirQuota: int | None = None,
+        ReservoirQuotaTTL: float | None = None,
+        RuleName: str | None = None,
     ):
         self.FixedRate = FixedRate if FixedRate is not None else 0.0
         self.Interval = Interval  # can be None
@@ -43,9 +45,9 @@ def __init__(
 class _UnprocessedStatistics:
     def __init__(
         self,
-        ErrorCode: Optional[str] = None,
-        Message: Optional[str] = None,
-        RuleName: Optional[str] = None,
+        ErrorCode: str | None = None,
+        Message: str | None = None,
+        RuleName: str | None = None,
     ):
         self.ErrorCode = ErrorCode if ErrorCode is not None else ""
         self.Message = Message if ErrorCode is not None else ""
@@ -55,9 +57,9 @@ def __init__(
 class _SamplingTargetResponse:
     def __init__(
         self,
-        LastRuleModification: Optional[float],
-        SamplingTargetDocuments: Optional[List[_SamplingTarget]] = None,
-        UnprocessedStatistics: Optional[List[_UnprocessedStatistics]] = None,
+        LastRuleModification: float | None,
+        SamplingTargetDocuments: List[_SamplingTarget] | None = None,
+        UnprocessedStatistics: List[_UnprocessedStatistics] | None = None,
     ):
         self.LastRuleModification: float = (
             LastRuleModification if LastRuleModification is not None else 0.0

sdk-extension/opentelemetry-sdk-extension-aws/src/opentelemetry/sdk/extension/aws/trace/sampler/aws_xray_remote_sampler.py

@@ -16,10 +16,12 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+from __future__ import annotations
+
 import random
 from logging import getLogger
 from threading import Timer
-from typing import Optional, Sequence
+from typing import Sequence
 
 from typing_extensions import override
 
@@ -55,9 +57,9 @@ class _AwsXRayRemoteSampler(Sampler):
     def __init__(
         self,
         resource: Resource,
-        endpoint: Optional[str] = None,
-        polling_interval: Optional[int] = None,
-        log_level: Optional[str] = None,
+        endpoint: str | None = None,
+        polling_interval: int | None = None,
+        log_level: str | None = None,
     ):
         self._root = ParentBased(
             _InternalAwsXRayRemoteSampler(
@@ -71,13 +73,13 @@ def __init__(
     @override
     def should_sample(
         self,
-        parent_context: Optional["Context"],
+        parent_context: Context | None,
         trace_id: int,
         name: str,
-        kind: Optional[SpanKind] = None,
-        attributes: Optional[Attributes] = None,
-        links: Optional[Sequence["Link"]] = None,
-        trace_state: Optional["TraceState"] = None,
+        kind: SpanKind | None = None,
+        attributes: Attributes | None = None,
+        links: Sequence["Link"] | None = None,
+        trace_state: TraceState | None = None,
     ) -> "SamplingResult":
         return self._root.should_sample(
             parent_context,
@@ -114,9 +116,9 @@ class _InternalAwsXRayRemoteSampler(Sampler):
     def __init__(
         self,
         resource: Resource,
-        endpoint: Optional[str] = None,
-        polling_interval: Optional[int] = None,
-        log_level: Optional[str] = None,
+        endpoint: str | None = None,
+        polling_interval: int | None = None,
+        log_level: str | None = None,
     ):
         # Override default log level
         if log_level is not None:
@@ -164,13 +166,13 @@ def __init__(
     @override
     def should_sample(
         self,
-        parent_context: Optional["Context"],
+        parent_context: Context | None,
         trace_id: int,
         name: str,
-        kind: Optional[SpanKind] = None,
-        attributes: Optional[Attributes] = None,
-        links: Optional[Sequence["Link"]] = None,
-        trace_state: Optional["TraceState"] = None,
+        kind: SpanKind | None = None,
+        attributes: Attributes | None = None,
+        links: Sequence["Link"] | None = None,
+        trace_state: TraceState | None = None,
     ) -> "SamplingResult":
         return SamplingResult(
             decision=Decision.DROP,