localstack-core 4.7.1.dev139__py3-none-any.whl → 4.10.1.dev42__py3-none-any.whl

localstack/utils/sync.py

@@ -4,7 +4,8 @@ import functools
 import threading
 import time
 from collections import defaultdict
-from typing import Callable, Literal, TypeVar
+from collections.abc import Callable
+from typing import Literal, TypeVar
 
 
 class ShortCircuitWaitException(Exception):
@@ -140,3 +141,127 @@ class SynchronizedDefaultDict(defaultdict):
     def __str__(self):
         with self._lock:
             return super().__str__()
+
+
+class Once:
+    """
+    An object that will perform an action exactly once.
+    Inspired by Golang's [sync.Once](https://pkg.go.dev/sync#Once) operation.
+
+
+    ### Example 1
+
+    Multiple threads using `Once::do` to ensure only 1 line is printed.
+
+    ```python
+    import threading
+    import time
+    import random
+
+    greet_once = Once()
+    def greet():
+        print("This should happen only once.")
+
+    greet_threads = []
+    for _ in range(10):
+        t = threading.Thread(target=lambda: greet_once.do(greet))
+        greet_threads.append(t)
+        t.start()
+
+    for t in greet_threads:
+        t.join()
+    ```
+
+
+    ### Example 2
+
+    Ensuring idemponent calling to prevent exceptions on multiple calls.
+
+    ```python
+    import os
+
+    class Service:
+        close_once: sync.Once
+
+    def start(self):
+        with open("my-service.txt) as f:
+            myfile.write("Started service")
+
+    def close(self):
+        # Ensure we only ever delete the file once on close
+        self.close_once.do(lambda: os.remove("my-service.txt"))
+
+    ```
+
+
+    """
+
+    _is_done: bool = False
+    _mu: threading.Lock = threading.Lock()
+
+    def do(self, fn: Callable[[], None]):
+        """
+        `do` calls the function `fn()` if-and-only-if `do` has never been called before.
+
+        This ensures idempotent and thread-safe execution.
+
+        If the function raises an exception, `do` considers `fn` as done, where subsequent calls are still no-ops.
+        """
+        if self._is_done:
+            return
+
+        with self._mu:
+            if not self._is_done:
+                try:
+                    fn()
+                finally:
+                    self._is_done = True
+
+
+def once_func(fn: Callable[..., T]) -> Callable[..., T | None]:
+    """
+    Wraps and returns a function that can only ever execute once.
+
+    The first call to the returned function will permanently set the result.
+    If the wrapped function raises an exception, this will be re-raised on each subsequent call.
+
+    This function can be used either as a decorator or called directly.
+
+    Direct usage:
+    ```python
+    delete_file = once_func(os.remove)
+
+    delete_file("myfile.txt")  # deletes the file
+    delete_file("myfile.txt")  # does nothing
+    ```
+
+    As a decorator:
+    ```python
+    @once_func
+    def delete_file():
+        os.remove("myfile.txt")
+
+    delete_file()  # deletes the file
+    delete_file()  # does nothing
+    ```
+    """
+    once = Once()
+
+    result, exception = None, None
+
+    def _do(*args, **kwargs):
+        nonlocal result, exception
+        try:
+            result = fn(*args, **kwargs)
+        except Exception as e:
+            exception = e
+            raise
+
+    @functools.wraps(fn)
+    def wrapper(*args, **kwargs):
+        once.do(lambda: _do(*args, **kwargs))
+        if exception is not None:
+            raise exception
+        return result
+
+    return wrapper

localstack/utils/tagging.py

@@ -1,6 +1,3 @@
-from typing import Optional
-
-
 class TaggingService:
     key_field: str
     value_field: str
@@ -17,7 +14,7 @@ class TaggingService:
 
         self.tags = {}
 
-    def list_tags_for_resource(self, arn: str, root_name: Optional[str] = None):
+    def list_tags_for_resource(self, arn: str, root_name: str | None = None):
         root_name = root_name or "Tags"
 
         result = []

localstack/utils/testutil.py

@@ -7,7 +7,8 @@ import re
 import shutil
 import tempfile
 import time
-from typing import Any, Callable, Optional
+from collections.abc import Callable
+from typing import Any
 
 from localstack.aws.api.lambda_ import Runtime
 from localstack.aws.connect import connect_externally_to, connect_to
@@ -20,7 +21,7 @@ from localstack.utils.urls import localstack_host
 try:
     from typing import Literal
 except ImportError:
-    from typing_extensions import Literal
+    from typing import Literal
 
 import boto3
 import requests
@@ -548,7 +549,7 @@ def list_all_log_events(log_group_name: str, logs_client=None) -> list[dict]:
 def get_lambda_log_events(
     function_name,
     delay_time=DEFAULT_GET_LOG_EVENTS_DELAY,
-    regex_filter: Optional[str] = None,
+    regex_filter: str | None = None,
     log_group=None,
     logs_client=None,
 ):
@@ -596,7 +597,7 @@ def list_all_resources(
     page_function: Callable[[dict], Any],
     last_token_attr_name: str,
     list_attr_name: str,
-    next_token_attr_name: Optional[str] = None,
+    next_token_attr_name: str | None = None,
 ) -> list:
     """
     List all available resources by loading all available pages using `page_function`.

localstack/utils/threads.py

@@ -3,9 +3,9 @@ import inspect
 import logging
 import threading
 import traceback
+from collections.abc import Callable
 from concurrent.futures import Future
 from multiprocessing.dummy import Pool
-from typing import Callable, Optional
 
 LOG = logging.getLogger(__name__)
 
@@ -26,7 +26,7 @@ class FuncThread(threading.Thread):
         params=None,
         quiet=False,
         on_stop: Callable[["FuncThread"], None] = None,
-        name: Optional[str] = None,
+        name: str | None = None,
         daemon=True,
     ):
         global counter

localstack/utils/time.py

@@ -1,6 +1,6 @@
 import time
 from datetime import date, datetime, timezone, tzinfo
-from typing import Optional
+from zoneinfo import ZoneInfo
 
 TIMESTAMP_FORMAT = "%Y-%m-%dT%H:%M:%S"
 TIMESTAMP_FORMAT_TZ = "%Y-%m-%dT%H:%M:%SZ"
@@ -42,6 +42,11 @@ def epoch_timestamp() -> float:
 
 
 def parse_timestamp(ts_str: str) -> datetime:
+    """
+    Parse the incoming date string into a timezone aware datetime object
+    :param ts_str:
+    :return:
+    """
     for ts_format in [
         TIMESTAMP_FORMAT,
         TIMESTAMP_FORMAT_TZ,
@@ -49,13 +54,16 @@ def parse_timestamp(ts_str: str) -> datetime:
         TIMESTAMP_READABLE_FORMAT,
     ]:
         try:
-            return datetime.strptime(ts_str, ts_format)
+            value = datetime.strptime(ts_str, ts_format)
+            if value.tzinfo is None:
+                value = value.replace(tzinfo=ZoneInfo("UTC"))
+            return value
         except ValueError:
             pass
     raise Exception(f"Unable to parse timestamp string with any known formats: {ts_str}")
 
 
-def now(millis: bool = False, tz: Optional[tzinfo] = None) -> int:
+def now(millis: bool = False, tz: tzinfo | None = None) -> int:
     return mktime(datetime.now(tz=tz), millis=millis)
 
 

localstack/utils/urls.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 from localstack import config
 from localstack.config import HostAndPort
 
@@ -12,7 +10,7 @@ def hostname_from_url(url: str) -> str:
     return url.split("://")[-1].split("/")[0].split(":")[0]
 
 
-def localstack_host(custom_port: Optional[int] = None) -> HostAndPort:
+def localstack_host(custom_port: int | None = None) -> HostAndPort:
     """
     Determine the host and port to return to the user based on:
     - the user's configuration (e.g environment variable overrides)

localstack/version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '4.7.1.dev139'
-__version_tuple__ = version_tuple = (4, 7, 1, 'dev139')
+__version__ = version = '4.10.1.dev42'
+__version_tuple__ = version_tuple = (4, 10, 1, 'dev42')
 
 __commit_id__ = commit_id = None

{localstack_core-4.7.1.dev139.dist-info → localstack_core-4.10.1.dev42.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: localstack-core
-Version: 4.7.1.dev139
+Version: 4.10.1.dev42
 Summary: The core library and runtime of LocalStack
 Author-email: LocalStack Contributors <info@localstack.cloud>
 License-Expression: Apache-2.0
@@ -9,13 +9,13 @@ Project-URL: Documentation, https://docs.localstack.cloud
 Project-URL: Repository, https://github.com/localstack/localstack.git
 Project-URL: Issues, https://github.com/localstack/localstack/issues
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Internet
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: System :: Emulators
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 License-File: LICENSE.txt
-Requires-Dist: build
+Requires-Dist: asn1crypto>=1.5.1
 Requires-Dist: click>=7.1
 Requires-Dist: cachetools>=5.0
 Requires-Dist: cryptography
@@ -29,48 +29,53 @@ Requires-Dist: pyyaml>=5.1
 Requires-Dist: rich>=12.3.0
 Requires-Dist: requests>=2.20.0
 Requires-Dist: semver>=2.10
-Requires-Dist: tailer>=0.4.1
 Provides-Extra: base-runtime
-Requires-Dist: boto3==1.40.25; extra == "base-runtime"
-Requires-Dist: botocore==1.40.25; extra == "base-runtime"
+Requires-Dist: boto3==1.40.74; extra == "base-runtime"
+Requires-Dist: botocore==1.40.74; extra == "base-runtime"
 Requires-Dist: awscrt!=0.27.1,>=0.13.14; extra == "base-runtime"
 Requires-Dist: cbor2>=5.5.0; extra == "base-runtime"
 Requires-Dist: dnspython>=1.16.0; extra == "base-runtime"
 Requires-Dist: docker>=6.1.1; extra == "base-runtime"
 Requires-Dist: jsonpatch>=1.24; extra == "base-runtime"
+Requires-Dist: jsonpointer>=3.0.0; extra == "base-runtime"
+Requires-Dist: jsonschema>=4.25.1; extra == "base-runtime"
 Requires-Dist: hypercorn>=0.14.4; extra == "base-runtime"
 Requires-Dist: localstack-twisted>=23.0; extra == "base-runtime"
 Requires-Dist: openapi-core>=0.19.2; extra == "base-runtime"
 Requires-Dist: pyopenssl>=23.0.0; extra == "base-runtime"
+Requires-Dist: python-dateutil>=2.9.0; extra == "base-runtime"
 Requires-Dist: readerwriterlock>=1.0.7; extra == "base-runtime"
 Requires-Dist: requests-aws4auth>=1.0; extra == "base-runtime"
+Requires-Dist: typing-extensions>=4.15.0; extra == "base-runtime"
 Requires-Dist: urllib3>=2.0.7; extra == "base-runtime"
 Requires-Dist: Werkzeug>=3.1.3; extra == "base-runtime"
 Requires-Dist: xmltodict>=0.13.0; extra == "base-runtime"
 Requires-Dist: rolo>=0.7; extra == "base-runtime"
 Provides-Extra: runtime
 Requires-Dist: localstack-core[base-runtime]; extra == "runtime"
-Requires-Dist: awscli==1.42.25; extra == "runtime"
+Requires-Dist: awscli==1.42.74; extra == "runtime"
 Requires-Dist: airspeed-ext>=0.6.3; extra == "runtime"
-Requires-Dist: kclpy-ext>=3.0.0; extra == "runtime"
 Requires-Dist: antlr4-python3-runtime==4.13.2; extra == "runtime"
 Requires-Dist: apispec>=5.1.1; extra == "runtime"
 Requires-Dist: aws-sam-translator>=1.15.1; extra == "runtime"
 Requires-Dist: crontab>=0.22.6; extra == "runtime"
 Requires-Dist: cryptography>=41.0.5; extra == "runtime"
+Requires-Dist: jinja2>=3.1.6; extra == "runtime"
 Requires-Dist: jpype1>=1.6.0; extra == "runtime"
-Requires-Dist: json5>=0.9.11; extra == "runtime"
 Requires-Dist: jsonpath-ng>=1.6.1; extra == "runtime"
 Requires-Dist: jsonpath-rw>=1.4.0; extra == "runtime"
-Requires-Dist: moto-ext[all]==5.1.11.post1; extra == "runtime"
+Requires-Dist: kclpy-ext>=3.0.0; extra == "runtime"
+Requires-Dist: moto-ext[all]>=5.1.12.post22; extra == "runtime"
 Requires-Dist: opensearch-py>=2.4.1; extra == "runtime"
+Requires-Dist: pydantic>=2.11.9; extra == "runtime"
 Requires-Dist: pymongo>=4.2.0; extra == "runtime"
 Requires-Dist: pyopenssl>=23.0.0; extra == "runtime"
+Requires-Dist: responses>=0.25.8; extra == "runtime"
 Provides-Extra: test
 Requires-Dist: localstack-core[runtime]; extra == "test"
 Requires-Dist: coverage[toml]>=5.5; extra == "test"
-Requires-Dist: deepdiff>=6.4.1; extra == "test"
 Requires-Dist: httpx[http2]>=0.25; extra == "test"
+Requires-Dist: json5>=0.12.1; extra == "test"
 Requires-Dist: pluggy>=1.3.0; extra == "test"
 Requires-Dist: pytest>=7.4.2; extra == "test"
 Requires-Dist: pytest-split>=0.8.0; extra == "test"
@@ -83,6 +88,7 @@ Requires-Dist: localstack-snapshot>=0.1.1; extra == "test"
 Provides-Extra: dev
 Requires-Dist: localstack-core[test]; extra == "dev"
 Requires-Dist: coveralls>=3.3.1; extra == "dev"
+Requires-Dist: deptry>=0.13.0; extra == "dev"
 Requires-Dist: Cython; extra == "dev"
 Requires-Dist: networkx>=2.8.4; extra == "dev"
 Requires-Dist: openapi-spec-validator>=0.7.1; extra == "dev"
@@ -94,5 +100,5 @@ Requires-Dist: rstr>=3.2.0; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Provides-Extra: typehint
 Requires-Dist: localstack-core[dev]; extra == "typehint"
-Requires-Dist: boto3-stubs[acm,acm-pca,amplify,apigateway,apigatewayv2,appconfig,appconfigdata,application-autoscaling,appsync,athena,autoscaling,backup,batch,ce,cloudcontrol,cloudformation,cloudfront,cloudtrail,cloudwatch,codebuild,codecommit,codeconnections,codedeploy,codepipeline,codestar-connections,cognito-identity,cognito-idp,dms,docdb,dynamodb,dynamodbstreams,ec2,ecr,ecs,efs,eks,elasticache,elasticbeanstalk,elbv2,emr,emr-serverless,es,events,firehose,fis,glacier,glue,iam,identitystore,iot,iot-data,iotanalytics,iotwireless,kafka,kinesis,kinesisanalytics,kinesisanalyticsv2,kms,lakeformation,lambda,logs,managedblockchain,mediaconvert,mediastore,mq,mwaa,neptune,opensearch,organizations,pi,pinpoint,pipes,qldb,qldb-session,rds,rds-data,redshift,redshift-data,resource-groups,resourcegroupstaggingapi,route53,route53resolver,s3,s3control,sagemaker,sagemaker-runtime,secretsmanager,serverlessrepo,servicediscovery,ses,sesv2,sns,sqs,ssm,sso-admin,stepfunctions,sts,timestream-query,timestream-write,transcribe,verifiedpermissions,wafv2,xray]; extra == "typehint"
+Requires-Dist: boto3-stubs[acm,acm-pca,amplify,apigateway,apigatewayv2,appconfig,appconfigdata,application-autoscaling,appsync,athena,autoscaling,backup,batch,ce,cloudcontrol,cloudformation,cloudfront,cloudtrail,cloudwatch,codebuild,codecommit,codeconnections,codedeploy,codepipeline,codestar-connections,cognito-identity,cognito-idp,dms,docdb,dynamodb,dynamodbstreams,ec2,ecr,ecs,efs,eks,elasticache,elasticbeanstalk,elbv2,emr,emr-serverless,es,events,firehose,fis,glacier,glue,iam,identitystore,iot,iot-data,iotanalytics,iotwireless,kafka,kinesis,kinesisanalyticsv2,kms,lakeformation,lambda,logs,managedblockchain,mediaconvert,mediastore,mq,mwaa,neptune,opensearch,organizations,pi,pinpoint,pipes,rds,rds-data,redshift,redshift-data,resource-groups,resourcegroupstaggingapi,route53,route53resolver,s3,s3control,sagemaker,sagemaker-runtime,secretsmanager,serverlessrepo,servicediscovery,ses,sesv2,sns,sqs,ssm,sso-admin,stepfunctions,sts,timestream-query,timestream-write,transcribe,verifiedpermissions,wafv2,xray]; extra == "typehint"
 Dynamic: license-file