localstack-core 4.5.1.dev34__tar.gz → 4.10.1.dev4__tar.gz

localstack_core-4.10.1.dev4/CODEOWNERS

@@ -0,0 +1,256 @@
+######################
+###  CODE OWNERS   ###
+######################
+
+# CODEOWNERS
+/CODEOWNERS @dominikschubert @alexrashed
+
+# README / Docs
+/docs/ @thrau @HarshCasper
+/README.md @HarshCasper
+/CODE_OF_CONDUCT.md @HarshCasper
+/LICENSE.txt @HarshCasper @alexrashed
+
+# Docker
+/bin/docker-entrypoint.sh @thrau @alexrashed
+/.dockerignore @alexrashed
+/Dockerfile* @alexrashed @silv-io
+
+# Git, Pipelines, GitHub config
+/.github @alexrashed @dfangl @dominikschubert @silv-io @k-a-il
+/.test_durations @silv-io @k-a-il
+/.git-blame-ignore-revs @alexrashed @thrau
+/bin/release-dev.sh @thrau @alexrashed
+/bin/release-helper.sh @thrau @alexrashed
+
+# Python project, packaging, and dependencies
+/pyproject.toml @alexrashed @silv-io @k-a-il @bentsku @sannya-singal
+/requirements-*.txt @alexrashed @silv-io @k-a-il @bentsku @sannya-singal
+/.pre-commit-config.yaml @alexrashed @silv-io @k-a-il @bentsku @sannya-singal
+
+# ASF
+/localstack-core/localstack/aws/ @thrau
+/tests/unit/aws/ @thrau
+# ASF parsers and serializers
+/localstack-core/localstack/aws/protocol @alexrashed
+# left empty (without owner) because the generated APIs belong to the specific service owners
+# you can overwrite this for single services afterwards
+/localstack-core/localstack/aws/api/
+
+# CLI
+/localstack-core/localstack/cli/ @thrau @alexrashed
+/tests/unit/cli/ @thrau @alexrashed
+/tests/cli/ @thrau @alexrashed
+
+# Plugins
+/localstack-core/localstack/plugins.py @thrau
+/localstack-core/localstack/config.py @thrau
+/tests/unit/services/test_internal.py @thrau
+
+# Extensions
+/localstack-core/localstack/extensions/ @thrau
+
+# Container utils
+/localstack-core/localstack/utils/container_utils/ @dfangl @dominikschubert
+/localstack-core/localstack/utils/docker_utils.py @dfangl @dominikschubert
+/tests/unit/test_docker_utils.py @dfangl @dominikschubert
+/tests/unit/test_dockerclient.py @dfangl @dominikschubert
+
+# Package Installers
+/localstack-core/localstack/packages/ @alexrashed
+/localstack-core/localstack/services/kinesis/packages.py @alexrashed
+
+# DNS server
+/localstack-core/localstack/dns @simonrw @dfangl
+
+# HTTP framework
+/localstack-core/localstack/http/ @thrau
+/tests/unit/http_/ @thrau
+
+# Runtime
+/localstack-core/localstack/runtime/ @thrau
+
+# Logging
+/localstack-core/localstack/logging/ @dfangl @alexrashed @dominikschubert
+
+# Stores
+/localstack-core/localstack/services/stores.py @viren-nadkarni
+/tests/unit/test_stores.py @viren-nadkarni
+
+# Analytics client
+/localstack-core/localstack/utils/analytics/ @thrau
+/tests/unit/utils/analytics/ @thrau
+
+# Snapshot testing
+/localstack-core/localstack/testing/snapshots/ @dominikschubert @steffyP
+/localstack-core/localstack/testing/pytest/ @dominikschubert
+
+# Scenario testing
+/localstack-core/localstack/testing/scenario/ @dominikschubert @steffyP
+
+# Bootstrap tests
+/tests/bootstrap @simonrw
+/localstack-core/localstack/testing/pytest/container.py @dominikschubert @simonrw
+
+# Test Selection
+/localstack-core/localstack/testing/testselection @dominikschubert @alexrashed @silv-io
+
+######################
+### SERVICE OWNERS ###
+######################
+# DO NOT modify anything below!
+# Everything below is _autogenerated_ and any manual changes will be overwritten.
+
+
+# acm
+/localstack-core/localstack/aws/api/acm/ @alexrashed
+/localstack-core/localstack/services/acm/ @alexrashed
+/tests/aws/services/acm/ @alexrashed
+
+# apigateway
+/localstack-core/localstack/aws/api/apigateway/ @bentsku @cloutierMat
+/localstack-core/localstack/services/apigateway/ @bentsku @cloutierMat
+/tests/aws/services/apigateway/ @bentsku @cloutierMat
+/tests/unit/services/apigateway/ @bentsku @cloutierMat
+
+# cloudcontrol
+/localstack-core/localstack/aws/api/cloudcontrol/ @simonrw
+/tests/aws/services/cloudcontrol/ @simonrw
+
+# cloudformation
+/localstack-core/localstack/aws/api/cloudformation/ @simonrw @pinzon @dominikschubert
+/localstack-core/localstack/services/cloudformation/ @simonrw @pinzon @dominikschubert
+/tests/aws/services/cloudformation/ @simonrw @pinzon @dominikschubert
+/tests/unit/services/cloudformation/ @simonrw @pinzon @dominikschubert
+
+# cloudwatch
+/localstack-core/localstack/aws/api/cloudwatch/ @pinzon @steffyP
+/localstack-core/localstack/services/cloudwatch/ @pinzon @steffyP
+/tests/aws/services/cloudwatch/ @pinzon @steffyP
+/tests/unit/services/cloudwatch/ @pinzon @steffyP
+
+# dynamodb
+/localstack-core/localstack/aws/api/dynamodb/ @viren-nadkarni @giograno
+/localstack-core/localstack/services/dynamodb/ @viren-nadkarni @giograno
+/tests/aws/services/dynamodb/ @viren-nadkarni @giograno
+/tests/unit/services/dynamodb/ @viren-nadkarni @giograno
+
+# ec2
+/localstack-core/localstack/aws/api/ec2/ @viren-nadkarni @macnev2013
+/localstack-core/localstack/services/ec2/ @viren-nadkarni @macnev2013
+/tests/aws/services/ec2/ @viren-nadkarni @macnev2013
+
+# ecr
+/localstack-core/localstack/services/ecr/ @dfangl
+
+# es
+/localstack-core/localstack/aws/api/es/ @alexrashed @silv-io
+/localstack-core/localstack/services/es/ @alexrashed @silv-io
+/tests/aws/services/es/ @alexrashed @silv-io
+
+# events
+/localstack-core/localstack/aws/api/events/ @maxhoheiser @bentsku
+/localstack-core/localstack/services/events/ @maxhoheiser @bentsku
+/tests/aws/services/events/ @maxhoheiser @bentsku
+/tests/unit/services/events/ @maxhoheiser @bentsku
+
+# firehose
+/localstack-core/localstack/aws/api/firehose/ @pinzon
+/localstack-core/localstack/services/firehose/ @pinzon
+/tests/aws/services/firehose/ @pinzon
+
+# iam
+/localstack-core/localstack/aws/api/iam/ @dfangl @pinzon
+/localstack-core/localstack/services/iam/ @dfangl @pinzon
+/tests/aws/services/iam/ @dfangl @pinzon
+
+# kms
+/localstack-core/localstack/aws/api/kms/ @sannya-singal
+/localstack-core/localstack/services/kms/ @sannya-singal
+/tests/aws/services/kms/ @sannya-singal
+/tests/unit/services/kms/ @sannya-singal
+
+# lambda
+/localstack-core/localstack/aws/api/lambda_/ @joe4dev @dominikschubert @dfangl @gregfurman
+/localstack-core/localstack/services/lambda_/ @joe4dev @dominikschubert @dfangl @gregfurman
+/tests/aws/services/lambda_/ @joe4dev @dominikschubert @dfangl @gregfurman
+/tests/unit/services/lambda_/ @joe4dev @dominikschubert @dfangl @gregfurman
+
+# logs
+/localstack-core/localstack/aws/api/logs/ @pinzon @steffyP
+/localstack-core/localstack/services/logs/ @pinzon @steffyP
+/tests/aws/services/logs/ @pinzon @steffyP
+/tests/unit/services/logs/ @pinzon @steffyP
+
+# opensearch
+/localstack-core/localstack/aws/api/opensearch/ @alexrashed @silv-io
+/localstack-core/localstack/services/opensearch/ @alexrashed @silv-io
+/tests/aws/services/opensearch/ @alexrashed @silv-io
+/tests/unit/services/opensearch/ @alexrashed @silv-io
+
+# pipes
+/localstack-core/localstack/aws/api/pipes/ @tiurin @gregfurman @joe4dev
+
+# route53
+/localstack-core/localstack/aws/api/route53/ @giograno
+/localstack-core/localstack/services/route53/ @giograno
+/tests/aws/services/route53/ @giograno
+
+# route53resolver
+/localstack-core/localstack/aws/api/route53resolver/ @macnev2013 @sannya-singal
+/localstack-core/localstack/services/route53resolver/ @macnev2013 @sannya-singal
+/tests/aws/services/route53resolver/ @macnev2013 @sannya-singal
+
+# s3
+/localstack-core/localstack/aws/api/s3/ @bentsku @k-a-il
+/localstack-core/localstack/services/s3/ @bentsku @k-a-il
+/tests/aws/services/s3/ @bentsku @k-a-il
+/tests/unit/services/s3/ @bentsku @k-a-il
+
+# s3control
+/localstack-core/localstack/aws/api/s3control/ @bentsku
+/localstack-core/localstack/services/s3control/ @bentsku
+/tests/aws/services/s3control/ @bentsku
+
+# secretsmanager
+/localstack-core/localstack/aws/api/secretsmanager/ @macnev2013
+/localstack-core/localstack/services/secretsmanager/ @macnev2013
+/tests/aws/services/secretsmanager/ @macnev2013
+
+# ses
+/localstack-core/localstack/aws/api/ses/ @viren-nadkarni
+/localstack-core/localstack/services/ses/ @viren-nadkarni
+/tests/aws/services/ses/ @viren-nadkarni
+
+# sns
+/localstack-core/localstack/aws/api/sns/ @bentsku @baermat
+/localstack-core/localstack/services/sns/ @bentsku @baermat
+/tests/aws/services/sns/ @bentsku @baermat
+/tests/unit/services/sns/ @bentsku @baermat
+
+# sqs
+/localstack-core/localstack/aws/api/sqs/ @thrau @baermat @gregfurman
+/localstack-core/localstack/services/sqs/ @thrau @baermat @gregfurman
+/tests/aws/services/sqs/ @thrau @baermat @gregfurman
+/tests/unit/services/sqs/ @thrau @baermat @gregfurman
+
+# ssm
+/localstack-core/localstack/aws/api/ssm/ @viren-nadkarni @dominikschubert
+/localstack-core/localstack/services/ssm/ @viren-nadkarni @dominikschubert
+/tests/aws/services/ssm/ @viren-nadkarni @dominikschubert
+
+# stepfunctions
+/localstack-core/localstack/aws/api/stepfunctions/ @dominikschubert @joe4dev @gregfurman
+/localstack-core/localstack/services/stepfunctions/ @dominikschubert @joe4dev @gregfurman
+/tests/aws/services/stepfunctions/ @dominikschubert @joe4dev @gregfurman
+/tests/unit/services/stepfunctions/ @dominikschubert @joe4dev @gregfurman
+
+# sts
+/localstack-core/localstack/aws/api/sts/ @pinzon @dfangl
+/localstack-core/localstack/services/sts/ @pinzon @dfangl
+/tests/aws/services/sts/ @pinzon @dfangl
+
+# transcribe
+/localstack-core/localstack/aws/api/transcribe/ @sannya-singal
+/localstack-core/localstack/services/transcribe/ @sannya-singal
+/tests/aws/services/transcribe/ @sannya-singal

localstack_core-4.10.1.dev4/DOCKER.md

@@ -0,0 +1,144 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/localstack/localstack/main/docs/localstack-readme-banner.svg" alt="LocalStack - A fully functional local cloud stack">
+</p>
+
+<p align="center">
+  <a href="https://github.com/localstack/localstack/actions/workflows/aws-main.yml?query=branch%3Amain"><img alt="GitHub Actions" src="https://github.com/localstack/localstack/actions/workflows/aws-main.yml/badge.svg?branch=main"></a>
+  <a href="https://coveralls.io/github/localstack/localstack?branch=main"><img alt="Coverage Status" src="https://coveralls.io/repos/github/localstack/localstack/badge.svg?branch=main"></a>
+  <a href="https://pypi.org/project/localstack/"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/localstack?color=blue"></a>
+  <a href="https://hub.docker.com/r/localstack/localstack"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/localstack/localstack"></a>
+  <a href="https://pypi.org/project/localstack"><img alt="PyPi downloads" src="https://static.pepy.tech/badge/localstack"></a>
+  <a href="#backers"><img alt="Backers on Open Collective" src="https://opencollective.com/localstack/backers/badge.svg"></a>
+  <a href="#sponsors"><img alt="Sponsors on Open Collective" src="https://opencollective.com/localstack/sponsors/badge.svg"></a>
+  <a href="https://img.shields.io/pypi/l/localstack.svg"><img alt="PyPI License" src="https://img.shields.io/pypi/l/localstack.svg"></a>
+  <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
+  <a href="https://github.com/astral-sh/ruff"><img alt="Ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json"></a>
+  <a href="https://twitter.com/localstack"><img alt="Twitter" src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social"></a>
+</p>
+
+# What is LocalStack?
+
+[LocalStack](https://localstack.cloud) is a cloud service emulator that runs in a single container on your laptop or in your CI environment. With LocalStack, you can run your AWS applications or Lambdas entirely on your local machine without connecting to a remote cloud provider! Whether you are testing complex CDK applications or Terraform configurations, or just beginning to learn about AWS services, LocalStack helps speed up and simplify your testing and development workflow.
+
+LocalStack supports a growing number of AWS services, like AWS Lambda, S3, Dynamodb, Kinesis, SQS, SNS, and many more! You can find a comprehensive list of supported APIs on our [☑️ Feature Coverage](https://docs.localstack.cloud/user-guide/aws/feature-coverage/) page.
+
+LocalStack also provides additional features to make your life as a cloud developer easier! Check out LocalStack's [User Guides](https://docs.localstack.cloud/user-guide/) for more information.
+
+## Usage
+
+Please make sure that you have a working [Docker environment](https://docs.docker.com/get-docker/) on your machine before moving on. You can check if Docker is correctly configured on your machine by executing `docker info` in your terminal. If it does not report an error (but shows information on your Docker system), you’re good to go.
+
+### Docker CLI
+
+You can directly start the LocalStack container using the Docker CLI. This method requires more manual steps and configuration, but it gives you more control over the container settings.
+
+You can start the Docker container simply by executing the following docker run command:
+
+```console
+$ docker run --rm -it -p 4566:4566 -p 4510-4559:4510-4559 localstack/localstack
+```
+
+Create an s3 bucket with LocalStack's [`awslocal`](https://docs.localstack.cloud/user-guide/integrations/aws-cli/#localstack-aws-cli-awslocal) CLI:
+
+```
+$ awslocal s3api create-bucket --bucket sample-bucket
+$ awslocal s3api list-buckets
+```
+
+**Notes**
+
+- This command reuses the image if it’s already on your machine, i.e. it will **not** pull the latest image automatically from Docker Hub.
+
+- This command does not bind all ports that are potentially used by LocalStack, nor does it mount any volumes. When using Docker to manually start LocalStack, you will have to configure the container on your own (see [`docker-compose.yml`](https://github.com/localstack/localstack/blob/main/docker-compose.yml) and [Configuration](https://docs.localstack.cloud/references/configuration/)). This could be seen as the “expert mode” of starting LocalStack. If you are looking for a simpler method of starting LocalStack, please use the [LocalStack CLI](https://docs.localstack.cloud/getting-started/installation/#localstack-cli).
+
+### Docker Compose
+
+You can start LocalStack with [Docker Compose](https://docs.docker.com/compose/) by configuring a `docker-compose.yml file`. Currently, docker-compose version 1.9.0+ is supported.
+
+```
+version: "3.8"
+
+services:
+  localstack:
+    container_name: "${LOCALSTACK_DOCKER_NAME:-localstack-main}"
+    image: localstack/localstack
+    ports:
+      - "127.0.0.1:4566:4566"            # LocalStack Gateway
+      - "127.0.0.1:4510-4559:4510-4559"  # external services port range
+    environment:
+      # LocalStack configuration: https://docs.localstack.cloud/references/configuration/
+      - DEBUG=${DEBUG:-0}
+    volumes:
+      - "${LOCALSTACK_VOLUME_DIR:-./volume}:/var/lib/localstack"
+      - "/var/run/docker.sock:/var/run/docker.sock"
+```
+
+Start the container by running the following command:
+
+```console
+$ docker-compose up
+```
+
+Create a queue using SQS with LocalStack's [`awslocal`](https://docs.localstack.cloud/user-guide/integrations/aws-cli/#localstack-aws-cli-awslocal) CLI:
+
+```
+$ awslocal sqs create-queue --queue-name test-queue
+$ awslocal sqs list-queues
+```
+
+**Notes**
+
+- This command pulls the current nightly build from the `main` branch (if you don’t have the image locally) and **not** the latest supported version. If you want to use a specific version, set the appropriate localstack image tag at `services.localstack.image` in the `docker-compose.yml` file (for example `localstack/localstack:<version>`).
+
+- This command reuses the image if it’s already on your machine, i.e. it will **not** pull the latest image automatically from Docker Hub.
+
+- Mounting the Docker socket `/var/run/docker.sock` as a volume is required for the Lambda service. Check out the [Lambda providers](https://docs.localstack.cloud/user-guide/aws/lambda/) documentation for more information.
+
+Please note that there are a few pitfalls when configuring your stack manually via docker-compose (e.g., required container name, Docker network, volume mounts, and environment variables). We recommend using the LocalStack CLI to validate your configuration, which will print warning messages in case it detects any potential misconfigurations:
+
+```console
+$ localstack config validate
+```
+
+## Base Image Tags
+
+We do push a set of different image tags for the LocalStack Docker images. When using LocalStack, you can decide which tag you want to use.These tags have different semantics and will be updated on different occasions:
+
+- `latest` (default)
+  - This is our default tag.
+    It refers to the latest commit which has been fully tested using our extensive integration test suite.
+  - This also entails changes that are part of major releases, which means that this tag can contain breaking changes.
+  - This tag should be used if you want to stay up-to-date with the latest changes.
+- `stable`
+  - This tag refers to the latest tagged release.
+    It will be updated with every release of LocalStack.
+  - This also entails major releases, which means that this tag can contain breaking changes.
+  - This tag should be used if you want to stay up-to-date with releases, but don't necessarily need the latest and greatest changes right away.
+- `<major>` (e.g. `3`)
+  - These tags can be used to refer to the latest release of a specific major release.
+    It will be updated with every minor and patch release within this major release.
+  - This tag should be used if you want to avoid any potential breaking changes.
+- `<major>.<minor>` (e.g. `3.0`)
+  - These tags can be used to refer to the latest release of a specific minor release.
+    It will be updated with every patch release within this minor release.
+  - This tag can be used if you want to avoid any bigger changes, like new features, but still want to update to the latest bugfix release.
+- `<major>.<minor>.<patch>` (e.g. `3.0.2`)
+  - These tags can be used if you want to use a very specific release.
+    It will not be updated.
+  - This tag can be used if you really want to avoid any changes to the image (not even minimal bug fixes).
+
+## Where to get help
+
+Get in touch with the LocalStack Team to report 🐞 [issues](https://github.com/localstack/localstack/issues/new/choose),upvote 👍 [feature requests](https://github.com/localstack/localstack/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+),🙋🏽 ask [support questions](https://docs.localstack.cloud/getting-started/help-and-support/),or 🗣️ discuss local cloud development:
+
+- [LocalStack Slack Community](https://localstack.cloud/contact/)
+- [LocalStack GitHub Issue tracker](https://github.com/localstack/localstack/issues)
+- [Getting Started - FAQ](https://docs.localstack.cloud/getting-started/faq/)
+
+## License
+
+Copyright (c) 2017-2024 LocalStack maintainers and contributors.
+
+Copyright (c) 2016 Atlassian and others.
+
+This version of LocalStack is released under the Apache License, Version 2.0 (see [LICENSE](https://github.com/localstack/localstack/blob/main/LICENSE.txt)). By downloading and using this software you agree to the [End-User License Agreement (EULA)](https://github.com/localstack/localstack/blob/main/doc/end_user_license_agreement).

localstack_core-4.10.1.dev4/Dockerfile

@@ -0,0 +1,192 @@
+#
+# base: Stage which installs necessary runtime dependencies (OS packages, etc.)
+#
+FROM python:3.13.9-slim-trixie@sha256:0222b795db95bf7412cede36ab46a266cfb31f632e64051aac9806dabf840a61 AS base
+ARG TARGETARCH
+
+# Install runtime OS package dependencies
+RUN --mount=type=cache,target=/var/cache/apt \
+    apt-get update && \
+        # Install dependencies to add additional repos
+        apt-get install -y --no-install-recommends \
+            # Runtime packages (groff-base is necessary for AWS CLI help)
+            ca-certificates curl gnupg git make openssl tar pixz zip unzip groff-base iputils-ping nss-passwords procps iproute2 xz-utils libatomic1 binutils && \
+        # patch for CVE-2024-45490, CVE-2024-45491, CVE-2024-45492
+        apt-get install --only-upgrade libexpat1
+
+# Install nodejs package from the dist release server. Note: we're installing from dist binaries, and not via
+#  `apt-get`, to avoid installing `python3.11` into the image (which otherwise comes as a dependency of nodejs).
+# See https://github.com/nodejs/docker-node/blob/main/22/trixie/Dockerfile
+RUN ARCH= && dpkgArch="$(dpkg --print-architecture)" \
+  && case "${dpkgArch##*-}" in \
+    amd64) ARCH='x64';; \
+    arm64) ARCH='arm64';; \
+    *) echo "unsupported architecture"; exit 1 ;; \
+  esac \
+  # gpg keys listed at https://github.com/nodejs/node#release-keys
+  && set -ex \
+  && for key in \
+    5BE8A3F6C8A5C01D106C0AD820B1A390B168D356 \
+    DD792F5973C6DE52C432CBDAC77ABFA00DDBF2B7 \
+    CC68F5A3106FF448322E48ED27F5E38D5B0A215F \
+    8FCCA13FEF1D0C2E91008E09770F7A9A5AE15600 \
+    890C08DB8579162FEE0DF9DB8BEAB4DFCF555EF4 \
+    C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C \
+    108F52B48DB57BB0CC439B2997B01419BD92F80A \
+    A363A499291CBBC940DD62E41F10027AF002F8B0 \
+  ; do \
+      gpg --batch --keyserver hkps://keys.openpgp.org --recv-keys "$key" || \
+      gpg --batch --keyserver keyserver.ubuntu.com --recv-keys "$key" ; \
+  done \
+  && curl -LO https://nodejs.org/dist/latest-v22.x/SHASUMS256.txt \
+  && LATEST_VERSION_FILENAME=$(cat SHASUMS256.txt | grep -o "node-v.*-linux-$ARCH" | sort | uniq) \
+  && rm SHASUMS256.txt \
+  && curl -fsSLO --compressed "https://nodejs.org/dist/latest-v22.x/$LATEST_VERSION_FILENAME.tar.xz" \
+  && curl -fsSLO --compressed "https://nodejs.org/dist/latest-v22.x/SHASUMS256.txt.asc" \
+  && gpg --batch --decrypt --output SHASUMS256.txt SHASUMS256.txt.asc \
+  && grep " $LATEST_VERSION_FILENAME.tar.xz\$" SHASUMS256.txt | sha256sum -c - \
+  && tar -xJf "$LATEST_VERSION_FILENAME.tar.xz" -C /usr/local --strip-components=1 --no-same-owner \
+  && rm "$LATEST_VERSION_FILENAME.tar.xz" SHASUMS256.txt.asc SHASUMS256.txt \
+  && ln -s /usr/local/bin/node /usr/local/bin/nodejs \
+  # upgrade npm to the latest version
+  && npm upgrade -g npm \
+  # smoke tests
+  && node --version \
+  && npm --version \
+  && test ! $(which python3.9)
+
+SHELL [ "/bin/bash", "-c" ]
+ENV LANG=C.UTF-8
+
+# set workdir
+RUN mkdir -p /opt/code/localstack
+RUN mkdir /opt/code/localstack/localstack-core
+WORKDIR /opt/code/localstack/
+
+# create localstack user and filesystem hierarchy, perform some permission fixes
+RUN chmod 777 . && \
+    useradd -ms /bin/bash localstack && \
+    mkdir -p /var/lib/localstack && \
+    chmod -R 777 /var/lib/localstack && \
+    mkdir -p /usr/lib/localstack && \
+    mkdir /tmp/localstack && \
+    chmod -R 777 /tmp/localstack && \
+    touch /tmp/localstack/.marker && \
+    mkdir -p /.npm && \
+    chmod 755 /root && \
+    chmod -R 777 /.npm
+
+# install the entrypoint script
+ADD bin/docker-entrypoint.sh /usr/local/bin/
+# add the shipped hosts file to prevent performance degredation in windows container mode on windows
+# (where hosts file is not mounted) See https://github.com/localstack/localstack/issues/5178
+ADD bin/hosts /etc/hosts
+
+# expose default environment
+# Set edge bind host so localstack can be reached by other containers
+# set library path and default LocalStack hostname
+ENV USER=localstack
+ENV PYTHONUNBUFFERED=1
+
+# Install the latest version of awslocal globally
+RUN --mount=type=cache,target=/root/.cache \
+    pip3 install --upgrade awscli awscli-local requests
+
+
+#
+# builder: Stage which installs the dependencies of LocalStack Community
+#
+FROM base AS builder
+ARG TARGETARCH
+
+# Install build dependencies to base
+RUN --mount=type=cache,target=/var/cache/apt \
+    apt-get update && \
+        # Install dependencies to add additional repos
+        # g++ is a workaround to fix the JPype1 compile error on ARM Linux "gcc: fatal error: cannot execute ‘cc1plus’"
+        apt-get install -y gcc g++
+
+# upgrade python build tools
+RUN --mount=type=cache,target=/root/.cache \
+    (python -m venv .venv && . .venv/bin/activate && pip3 install --upgrade pip wheel setuptools)
+
+# add files necessary to install runtime dependencies
+ADD Makefile pyproject.toml requirements-runtime.txt ./
+# add the localstack start scripts (necessary for the installation of the runtime dependencies, i.e. `pip install -e .`)
+ADD bin/localstack bin/localstack.bat bin/localstack-supervisor bin/
+
+# Install dependencies for running the LocalStack runtime
+RUN --mount=type=cache,target=/root/.cache\
+    . .venv/bin/activate && pip3 install -r requirements-runtime.txt
+
+
+#
+# final stage: Builds upon base stage and copies resources from builder stages
+#
+FROM base
+COPY --from=builder /opt/code/localstack/.venv /opt/code/localstack/.venv
+# The build version is set in the docker-helper.sh script to be the output of setuptools_scm
+ARG LOCALSTACK_BUILD_VERSION
+
+# add project files necessary to install all dependencies
+ADD Makefile pyproject.toml ./
+# add the localstack start scripts (necessary for the installation of the runtime dependencies, i.e. `pip install -e .`)
+ADD bin/localstack bin/localstack.bat bin/localstack-supervisor bin/
+
+# add the code as late as possible
+ADD localstack-core/ /opt/code/localstack/localstack-core
+
+# Install LocalStack Community and generate the version file while doing so
+RUN --mount=type=cache,target=/root/.cache \
+    . .venv/bin/activate && \
+    SETUPTOOLS_SCM_PRETEND_VERSION_FOR_LOCALSTACK_CORE=${LOCALSTACK_BUILD_VERSION} \
+    pip install -e .[runtime]
+
+# Generate the plugin entrypoints
+RUN SETUPTOOLS_SCM_PRETEND_VERSION_FOR_LOCALSTACK_CORE=${LOCALSTACK_BUILD_VERSION} \
+    make entrypoints
+
+# Generate service catalog cache in static libs dir
+RUN . .venv/bin/activate && python3 -m localstack.aws.spec
+
+# Install packages which should be shipped by default
+RUN --mount=type=cache,target=/root/.cache \
+    --mount=type=cache,target=/var/lib/localstack/cache \
+    source .venv/bin/activate && \
+    python -m localstack.cli.lpm install \
+      lambda-runtime \
+      jpype-jsonata \
+      dynamodb-local && \
+    chown -R localstack:localstack /usr/lib/localstack && \
+    chmod -R 777 /usr/lib/localstack
+
+# link the python package installer virtual environments into the localstack venv
+RUN echo /var/lib/localstack/lib/python-packages/lib/python3.13/site-packages > localstack-var-python-packages-venv.pth && \
+    mv localstack-var-python-packages-venv.pth .venv/lib/python*/site-packages/
+RUN echo /usr/lib/localstack/python-packages/lib/python3.13/site-packages > localstack-static-python-packages-venv.pth && \
+    mv localstack-static-python-packages-venv.pth .venv/lib/python*/site-packages/
+
+# expose edge service, external service ports, and debugpy
+EXPOSE 4566 4510-4559 5678
+
+HEALTHCHECK --interval=10s --start-period=15s --retries=5 --timeout=10s CMD /opt/code/localstack/.venv/bin/localstack status services --format=json
+
+# default volume directory
+VOLUME /var/lib/localstack
+
+# mark the image version
+RUN touch /usr/lib/localstack/.community-version
+
+LABEL authors="LocalStack Contributors"
+LABEL maintainer="LocalStack Team (info@localstack.cloud)"
+LABEL description="LocalStack Docker image"
+
+# Add the build date and git hash at last (changes everytime)
+ARG LOCALSTACK_BUILD_DATE
+ARG LOCALSTACK_BUILD_GIT_HASH
+ENV LOCALSTACK_BUILD_DATE=${LOCALSTACK_BUILD_DATE}
+ENV LOCALSTACK_BUILD_GIT_HASH=${LOCALSTACK_BUILD_GIT_HASH}
+ENV LOCALSTACK_BUILD_VERSION=${LOCALSTACK_BUILD_VERSION}
+
+# define command at startup
+ENTRYPOINT ["docker-entrypoint.sh"]