localstack-core 4.7.1.dev22__py3-none-any.whl → 4.7.1.dev24__py3-none-any.whl

localstack/config.py

@@ -9,7 +9,8 @@ import tempfile
 import time
 import warnings
 from collections import defaultdict
-from typing import Any, Dict, List, Mapping, Optional, Tuple, TypeVar, Union
+from collections.abc import Mapping
+from typing import Any, Optional, TypeVar, Union
 
 from localstack import constants
 from localstack.constants import (
@@ -233,7 +234,7 @@ def is_env_not_false(env_var_name: str) -> bool:
     return os.environ.get(env_var_name, "").lower().strip() not in FALSE_STRINGS
 
 
-def load_environment(profiles: str = None, env=os.environ) -> List[str]:
+def load_environment(profiles: str = None, env=os.environ) -> list[str]:
     """Loads the environment variables from ~/.localstack/{profile}.env, for each profile listed in the profiles.
     :param env: environment to load profile to. Defaults to `os.environ`
     :param profiles: a comma separated list of profiles to load (defaults to "default")
@@ -337,7 +338,7 @@ def in_docker():
             return False
     except Exception:
         pass
-    with open("/proc/1/cgroup", "rt") as ifh:
+    with open("/proc/1/cgroup") as ifh:
         content = ifh.read()
         if "docker" in content or "buildkit" in content:
             return True
@@ -348,7 +349,7 @@ def in_docker():
     # containerd does not set any specific file or config, but it does use
     # io.containerd.snapshotter.v1.overlayfs as the overlay filesystem for `/`.
     try:
-        with open("/proc/mounts", "rt") as infile:
+        with open("/proc/mounts") as infile:
             for line in infile:
                 line = line.strip()
 
@@ -603,9 +604,7 @@ class HostAndPort:
 
     def _get_unprivileged_port_range_start(self) -> int:
         try:
-            with open(
-                "/proc/sys/net/ipv4/ip_unprivileged_port_start", "rt"
-            ) as unprivileged_port_start:
+            with open("/proc/sys/net/ipv4/ip_unprivileged_port_start") as unprivileged_port_start:
                 port = unprivileged_port_start.read()
                 return int(port.strip())
         except Exception:
@@ -637,7 +636,7 @@ class HostAndPort:
         return f"HostAndPort(host={self.host}, port={self.port})"
 
 
-class UniqueHostAndPortList(List[HostAndPort]):
+class UniqueHostAndPortList(list[HostAndPort]):
     """
     Container type that ensures that ports added to the list are unique based
     on these rules:
@@ -650,7 +649,7 @@ class UniqueHostAndPortList(List[HostAndPort]):
         - Identical identical hosts and ports are de-duped
     """
 
-    def __init__(self, iterable: Union[List[HostAndPort], None] = None):
+    def __init__(self, iterable: Union[list[HostAndPort], None] = None):
         super().__init__(iterable or [])
         self._ensure_unique()
 
@@ -661,10 +660,10 @@ class UniqueHostAndPortList(List[HostAndPort]):
         if len(self) <= 1:
             return
 
-        unique: List[HostAndPort] = list()
+        unique: list[HostAndPort] = list()
 
         # Build a dictionary of hosts by port
-        hosts_by_port: Dict[int, List[str]] = defaultdict(list)
+        hosts_by_port: dict[int, list[str]] = defaultdict(list)
         for item in self:
             hosts_by_port[item.port].append(item.host)
 
@@ -696,7 +695,7 @@ class UniqueHostAndPortList(List[HostAndPort]):
 
 def populate_edge_configuration(
     environment: Mapping[str, str],
-) -> Tuple[HostAndPort, UniqueHostAndPortList]:
+) -> tuple[HostAndPort, UniqueHostAndPortList]:
     """Populate the LocalStack edge configuration from environment variables."""
     localstack_host_raw = environment.get("LOCALSTACK_HOST")
     gateway_listen_raw = environment.get("GATEWAY_LISTEN")
@@ -1448,7 +1447,7 @@ def is_collect_metrics_mode() -> bool:
     return is_env_true(ENV_INTERNAL_TEST_COLLECT_METRIC)
 
 
-def collect_config_items() -> List[Tuple[str, Any]]:
+def collect_config_items() -> list[tuple[str, Any]]:
     """Returns a list of key-value tuples of LocalStack configuration values."""
     none = object()  # sentinel object
 
@@ -1598,7 +1597,7 @@ def get_edge_url(localstack_hostname=None, protocol=None):
 
 
 class ServiceProviderConfig(Mapping[str, str]):
-    _provider_config: Dict[str, str]
+    _provider_config: dict[str, str]
     default_value: str
     override_prefix: str = "PROVIDER_OVERRIDE_"
 
@@ -1623,7 +1622,7 @@ class ServiceProviderConfig(Mapping[str, str]):
     def set_provider(self, service: str, provider: str):
         self._provider_config[service] = provider
 
-    def bulk_set_provider_if_not_exists(self, services: List[str], provider: str):
+    def bulk_set_provider_if_not_exists(self, services: list[str], provider: str):
         for service in services:
             self.set_provider_if_not_exists(service, provider)
 

localstack/deprecations.py

@@ -1,8 +1,8 @@
 # A simple module to track deprecations over time / versions, and some simple functions guiding the affected users.
 import logging
 import os
+from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Callable, List, Optional
 
 from localstack.utils.analytics import log
 
@@ -329,8 +329,8 @@ DEPRECATIONS = [
 
 
 def collect_affected_deprecations(
-    deprecations: Optional[List[EnvVarDeprecation]] = None,
-) -> List[EnvVarDeprecation]:
+    deprecations: list[EnvVarDeprecation] | None = None,
+) -> list[EnvVarDeprecation]:
     """
     Collects all deprecations which are used in the OS environ.
     :param deprecations: List of deprecations to check. Uses DEPRECATIONS list by default.
@@ -341,7 +341,7 @@ def collect_affected_deprecations(
     return [deprecation for deprecation in deprecations if deprecation.is_affected]
 
 
-def log_env_warning(deprecations: List[EnvVarDeprecation]) -> None:
+def log_env_warning(deprecations: list[EnvVarDeprecation]) -> None:
     """
     Logs warnings for the given deprecations.
     :param deprecations: list of affected deprecations to show a warning for
@@ -368,7 +368,7 @@ def log_env_warning(deprecations: List[EnvVarDeprecation]) -> None:
         log.event(event="deprecated_env_usage", payload={"deprecated_env_vars": env_vars})
 
 
-def log_deprecation_warnings(deprecations: Optional[List[EnvVarDeprecation]] = None) -> None:
+def log_deprecation_warnings(deprecations: list[EnvVarDeprecation] | None = None) -> None:
     affected_deprecations = collect_affected_deprecations(deprecations)
     log_env_warning(affected_deprecations)
 

localstack/dev/run/__main__.py

@@ -1,6 +1,6 @@
 import dataclasses
 import os
-from typing import Iterable, Tuple
+from collections.abc import Iterable
 
 import click
 from rich.rule import Rule
@@ -133,9 +133,9 @@ def run(
     mount_dependencies: bool = False,
     mount_entrypoints: bool = False,
     mount_docker_socket: bool = True,
-    env: Tuple = (),
-    volume: Tuple = (),
-    publish: Tuple = (),
+    env: tuple = (),
+    volume: tuple = (),
+    publish: tuple = (),
     entrypoint: str = None,
     network: str = None,
     local_packages: list[str] | None = None,

localstack/dev/run/paths.py

@@ -1,8 +1,8 @@
 """Utilities to resolve important paths on the host and in the container."""
 
 import os
+from collections.abc import Callable
 from pathlib import Path
-from typing import Callable, Optional, Union
 
 
 class HostPaths:
@@ -20,9 +20,9 @@ class HostPaths:
 
     def __init__(
         self,
-        workspace_dir: Union[os.PathLike, str] = None,
-        volume_dir: Union[os.PathLike, str] = None,
-        venv_dir: Union[os.PathLike, str] = None,
+        workspace_dir: os.PathLike | str = None,
+        volume_dir: os.PathLike | str = None,
+        venv_dir: os.PathLike | str = None,
     ):
         self.workspace_dir = Path(workspace_dir or os.path.abspath(os.path.join(os.getcwd(), "..")))
         self.localstack_project_dir = self.workspace_dir / "localstack"
@@ -72,7 +72,7 @@ class ContainerPaths:
     docker_entrypoint: str = "/usr/local/bin/docker-entrypoint.sh"
     localstack_supervisor: str = "/usr/local/bin/localstack-supervisor"
     localstack_source_dir: str
-    localstack_pro_source_dir: Optional[str]
+    localstack_pro_source_dir: str | None
 
     def dependency_source(self, name: str) -> str:
         """Returns path of the given source dependency in the site-packages directory."""

localstack/dns/models.py

@@ -1,6 +1,7 @@
 import dataclasses
+from collections.abc import Callable
 from enum import Enum, auto
-from typing import Callable, Protocol
+from typing import Protocol
 
 
 class RecordType(Enum):

localstack/dns/server.py

@@ -5,12 +5,13 @@ import os
 import re
 import textwrap
 import threading
+from collections.abc import Iterable
 from datetime import datetime
 from functools import cache
 from ipaddress import IPv4Address, IPv4Interface
 from pathlib import Path
 from socket import AddressFamily
-from typing import Iterable, Literal, Tuple
+from typing import Literal
 
 import psutil
 from cachetools import TTLCache, cached
@@ -90,7 +91,7 @@ THREAD_LOCAL = threading.local()
 
 # Type of the value given by DNSHandler.client_address
 # in the form (ip, port) e.g. ("127.0.0.1", 58291)
-ClientAddress = Tuple[str, int]
+ClientAddress = tuple[str, int]
 
 psutil_cache = TTLCache(maxsize=100, ttl=10)
 

localstack/http/dispatcher.py

@@ -1,5 +1,4 @@
 from json import JSONEncoder
-from typing import Type
 
 from rolo.routing.handler import Handler, ResultValue
 from rolo.routing.handler import handler_dispatcher as _handler_dispatcher
@@ -14,7 +13,7 @@ __all__ = [
 ]
 
 
-def handler_dispatcher(json_encoder: Type[JSONEncoder] = None) -> Dispatcher[Handler]:
+def handler_dispatcher(json_encoder: type[JSONEncoder] = None) -> Dispatcher[Handler]:
     """
     Replacement for ``rolo.dispatcher.handler_dispatcher`` that uses by default LocalStack's CustomEncoder for
     serializing JSON documents.

localstack/http/response.py

@@ -1,5 +1,5 @@
 from json import JSONEncoder
-from typing import Any, Type
+from typing import Any
 
 from rolo import Response as RoloResponse
 
@@ -11,7 +11,7 @@ class Response(RoloResponse):
     An HTTP Response object, which simply extends werkzeug's Response object with a few convenience methods.
     """
 
-    def set_json(self, doc: Any, cls: Type[JSONEncoder] = CustomEncoder):
+    def set_json(self, doc: Any, cls: type[JSONEncoder] = CustomEncoder):
         """
         Serializes the given dictionary using localstack's ``CustomEncoder`` into a json response, and sets the
         mimetype automatically to ``application/json``.

localstack/http/router.py

@@ -1,6 +1,6 @@
+from collections.abc import Mapping
 from typing import (
     Any,
-    Mapping,
     TypeVar,
 )
 

localstack/http/trace.py

@@ -2,7 +2,8 @@ import dataclasses
 import inspect
 import logging
 import time
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 from rolo import Response
 from rolo.gateway import ExceptionHandler, Handler, HandlerChain, RequestContext

localstack/logging/format.py

@@ -3,7 +3,7 @@
 import logging
 import re
 from functools import lru_cache
-from typing import Any, Dict
+from typing import Any
 
 from localstack.utils.numbers import format_bytes
 from localstack.utils.strings import to_bytes
@@ -173,8 +173,8 @@ class AwsTraceLoggingFormatter(TraceLoggingFormatter):
     def __init__(self):
         super().__init__()
 
-    def _copy_service_dict(self, service_dict: Dict) -> Dict:
-        if not isinstance(service_dict, Dict):
+    def _copy_service_dict(self, service_dict: dict) -> dict:
+        if not isinstance(service_dict, dict):
             return service_dict
         result = {}
         for key, value in service_dict.items():

localstack/packages/api.py

@@ -6,7 +6,7 @@ from collections import defaultdict
 from enum import Enum
 from inspect import getmodule
 from threading import RLock
-from typing import Any, Callable, Generic, List, Optional, ParamSpec, TypeVar
+from typing import Any, Callable, Generic, Optional, ParamSpec, TypeVar
 
 from plux import Plugin, PluginManager, PluginSpec  # type: ignore
 
@@ -219,7 +219,7 @@ class Package(abc.ABC, Generic[T]):
         """
         self.get_installer(version).install(target)
 
-    @functools.lru_cache()
+    @functools.lru_cache
     def get_installer(self, version: str | None = None) -> T:
         """
         Returns the installer instance for a specific version of the package.
@@ -237,7 +237,7 @@ class Package(abc.ABC, Generic[T]):
             raise NoSuchVersionException(package=self.name, version=version)
         return self._get_installer(version)
 
-    def get_versions(self) -> List[str]:
+    def get_versions(self) -> list[str]:
         """
         :return: List of all versions available for this package.
         """
@@ -262,7 +262,7 @@ class MultiPackageInstaller(PackageInstaller):
     PackageInstaller implementation which composes of multiple package installers.
     """
 
-    def __init__(self, name: str, version: str, package_installer: List[PackageInstaller]):
+    def __init__(self, name: str, version: str, package_installer: list[PackageInstaller]):
         """
         :param name: of the (multi-)package installer
         :param version: of this (multi-)package installer
@@ -317,7 +317,7 @@ class PackagesPlugin(Plugin):  # type: ignore[misc]
         self,
         name: str,
         scope: str,
-        get_package: Callable[[], Package[PackageInstaller] | List[Package[PackageInstaller]]],
+        get_package: Callable[[], Package[PackageInstaller] | list[Package[PackageInstaller]]],
         should_load: Callable[[], bool] | None = None,
     ) -> None:
         super().__init__()

localstack/packages/core.py

@@ -4,7 +4,7 @@ import re
 from abc import ABC
 from functools import lru_cache
 from sys import version_info
-from typing import Any, Optional, Tuple
+from typing import Any, Optional
 
 import requests
 
@@ -190,7 +190,7 @@ class GitHubReleaseInstaller(PermissionDownloadInstaller):
             f"https://api.github.com/repos/{github_slug}/releases/tags/{self.version}"
         )
 
-    @lru_cache()
+    @lru_cache
     def _get_download_url(self) -> str:
         asset_name = self._get_github_asset_name()
         # try to use a token when calling the GH API for increased API rate limits
@@ -404,7 +404,7 @@ class MavenPackageInstaller(MavenDownloadInstaller):
         super()._install(target)
 
 
-def parse_maven_package_url(package_url: str) -> Tuple[str, str, str]:
+def parse_maven_package_url(package_url: str) -> tuple[str, str, str]:
     """Example: parse_maven_package_url("pkg:maven/software.amazon.event.ruler/event-ruler@1.7.3")
     -> software.amazon.event.ruler, event-ruler, 1.7.3
     """

localstack/packages/debugpy.py

@@ -1,5 +1,3 @@
-from typing import List
-
 from localstack.packages import InstallTarget, Package, PackageInstaller
 from localstack.utils.run import run
 
@@ -8,7 +6,7 @@ class DebugPyPackage(Package["DebugPyPackageInstaller"]):
     def __init__(self) -> None:
         super().__init__("DebugPy", "latest")
 
-    def get_versions(self) -> List[str]:
+    def get_versions(self) -> list[str]:
         return ["latest"]
 
     def _get_installer(self, version: str) -> "DebugPyPackageInstaller":

localstack/packages/ffmpeg.py

@@ -1,5 +1,4 @@
 import os
-from typing import List
 
 from localstack.packages import Package
 from localstack.packages.core import ArchiveDownloadAndExtractInstaller
@@ -21,7 +20,7 @@ class FfmpegPackage(Package["FfmpegPackageInstaller"]):
     def _get_installer(self, version: str) -> "FfmpegPackageInstaller":
         return FfmpegPackageInstaller(version)
 
-    def get_versions(self) -> List[str]:
+    def get_versions(self) -> list[str]:
         return ["7.1"]
 
 

localstack/packages/java.py

@@ -1,6 +1,5 @@
 import logging
 import os
-from typing import List
 
 import requests
 
@@ -198,7 +197,7 @@ class JavaPackage(Package[JavaPackageInstaller]):
     def __init__(self, default_version: str = DEFAULT_JAVA_VERSION):
         super().__init__(name="Java", default_version=default_version)
 
-    def get_versions(self) -> List[str]:
+    def get_versions(self) -> list[str]:
         return list(JAVA_VERSIONS.keys())
 
     def _get_installer(self, version: str) -> JavaPackageInstaller:

localstack/packages/terraform.py

@@ -1,6 +1,5 @@
 import os
 import platform
-from typing import List
 
 from localstack.packages import InstallTarget, Package
 from localstack.packages.core import ArchiveDownloadAndExtractInstaller
@@ -20,7 +19,7 @@ class TerraformPackage(Package["TerraformPackageInstaller"]):
     def __init__(self) -> None:
         super().__init__("Terraform", TERRAFORM_VERSION)
 
-    def get_versions(self) -> List[str]:
+    def get_versions(self) -> list[str]:
         return [TERRAFORM_VERSION]
 
     def _get_installer(self, version: str) -> "TerraformPackageInstaller":

localstack/runtime/init.py

@@ -7,7 +7,6 @@ import subprocess
 import time
 from enum import Enum
 from functools import cached_property
-from typing import Dict, List, Optional
 
 from plux import Plugin, PluginManager
 
@@ -109,7 +108,7 @@ class PythonScriptRunner(ScriptRunner):
 
 
 class InitScriptManager:
-    _stage_directories: Dict[Stage, str] = {
+    _stage_directories: dict[Stage, str] = {
         Stage.BOOT: "boot.d",
         Stage.START: "start.d",
         Stage.READY: "ready.d",
@@ -117,7 +116,7 @@ class InitScriptManager:
     }
 
     script_root: str
-    stage_completed: Dict[Stage, bool]
+    stage_completed: dict[Stage, bool]
 
     def __init__(self, script_root: str):
         self.script_root = script_root
@@ -125,10 +124,10 @@ class InitScriptManager:
         self.runner_manager: PluginManager[ScriptRunner] = PluginManager(ScriptRunner.namespace)
 
     @cached_property
-    def scripts(self) -> Dict[Stage, List[Script]]:
+    def scripts(self) -> dict[Stage, list[Script]]:
         return self._find_scripts()
 
-    def get_script_runner(self, script_file: str) -> Optional[ScriptRunner]:
+    def get_script_runner(self, script_file: str) -> ScriptRunner | None:
         runners = self.runner_manager.load_all()
         for runner in runners:
             if runner.should_run(script_file):
@@ -138,7 +137,7 @@ class InitScriptManager:
     def has_script_runner(self, script_file: str) -> bool:
         return self.get_script_runner(script_file) is not None
 
-    def run_stage(self, stage: Stage) -> List[Script]:
+    def run_stage(self, stage: Stage) -> list[Script]:
         """
         Runs all scripts in the given stage.
 
@@ -188,7 +187,7 @@ class InitScriptManager:
 
         return scripts
 
-    def _find_scripts(self) -> Dict[Stage, List[Script]]:
+    def _find_scripts(self) -> dict[Stage, list[Script]]:
         scripts = {}
 
         if self.script_root is None:

localstack/runtime/shutdown.py

@@ -1,5 +1,6 @@
 import logging
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 from localstack.runtime import hooks
 from localstack.utils.functions import call_safe

localstack/services/apigateway/exporter.py

@@ -1,6 +1,5 @@
 import abc
 import json
-from typing import Type
 
 from apispec import APISpec
 
@@ -320,7 +319,7 @@ class _OpenApiOAS30Exporter(_BaseOpenApiExporter):
 
 
 class OpenApiExporter:
-    exporters: dict[str, Type[_BaseOpenApiExporter]]
+    exporters: dict[str, type[_BaseOpenApiExporter]]
 
     def __init__(self):
         self.exporters = {"swagger": _OpenApiSwaggerExporter, "oas30": _OpenApiOAS30Exporter}

localstack/services/apigateway/helpers.py

@@ -3,7 +3,7 @@ import copy
 import hashlib
 import json
 import logging
-from typing import List, Optional, TypedDict, Union
+from typing import TypedDict
 from urllib import parse as urlparse
 
 from jsonpatch import apply_patch
@@ -93,7 +93,7 @@ class OpenAPIExt:
 
 class AuthorizerConfig(TypedDict):
     authorizer: Authorizer
-    authorization_scopes: Optional[list[str]]
+    authorization_scopes: list[str] | None
 
 
 # TODO: make the CRUD operations in this file generic for the different model types (authorizes, validators, ...)
@@ -198,11 +198,11 @@ class OpenAPISpecificationResolver:
 
             return cur
 
-    def _namespaced_resolution(self, namespace: str, data: Union[dict, list]) -> Union[dict, list]:
+    def _namespaced_resolution(self, namespace: str, data: dict | list) -> dict | list:
         with self._pathctx(namespace):
             return self._resolve_references(data)
 
-    def _resolve_references(self, data) -> Union[dict, list]:
+    def _resolve_references(self, data) -> dict | list:
         if self._is_ref(data):
             return self._resolve_refpath(data["$ref"])
 
@@ -578,7 +578,7 @@ def import_api_from_openapi_spec(
 
             authorizers[security_scheme_name] = authorizer
 
-    def get_authorizer(path_payload: dict) -> Optional[AuthorizerConfig]:
+    def get_authorizer(path_payload: dict) -> AuthorizerConfig | None:
         if not (security_schemes := path_payload.get("security")):
             return None
 
@@ -605,7 +605,7 @@ def import_api_from_openapi_spec(
         rel_path = abs_path.removeprefix(base_path)
         return add_path_methods(rel_path, parts, parent_id=parent_id)
 
-    def add_path_methods(rel_path: str, parts: List[str], parent_id=""):
+    def add_path_methods(rel_path: str, parts: list[str], parent_id=""):
         rel_path = rel_path or "/"
         child_id = ApigwResourceIdentifier(account_id, region_name, parent_id, rel_path).generate()