Metadata-Version: 2.5
Name: localstack
Version: 2026.8.2
Summary: The LocalStack Command Line Interface
Project-URL: Homepage, https://localstack.cloud
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
Author-email: LocalStack Contributors <info@localstack.cloud>
License-Expression: Apache-2.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: asn1crypto
Requires-Dist: cachetools>=5.0
Requires-Dist: click>=8.2.0
Requires-Dist: cryptography
Requires-Dist: dnslib>=0.9.10
Requires-Dist: dnspython>=1.16.0
Requires-Dist: docker>=6.1.1
Requires-Dist: packaging
Requires-Dist: plux>=1.16.0
Requires-Dist: psutil>=5.4.8
Requires-Dist: pyjwt[crypto]>=1.7.0
Requires-Dist: pyotp>=2.9.0
Requires-Dist: python-dateutil>=2.8
Requires-Dist: python-dotenv>=0.19.1
Requires-Dist: pyyaml>=5.1
Requires-Dist: requests>=2.20.0
Requires-Dist: rich>=12.3.0
Requires-Dist: semver>=2.10
Requires-Dist: tabulate
Requires-Dist: windows-curses; platform_system == 'Windows'
Provides-Extra: dev
Requires-Dist: boto3; extra == 'dev'
Requires-Dist: cbor2; extra == 'dev'
Requires-Dist: flask; extra == 'dev'
Requires-Dist: hypercorn; extra == 'dev'
Requires-Dist: jsonpatch; extra == 'dev'
Requires-Dist: libcst; extra == 'dev'
Requires-Dist: plux[hatchling]>=1.16.0; extra == 'dev'
Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
Requires-Dist: pytest-httpserver>=1.1.2; extra == 'dev'
Requires-Dist: pytest-tinybird>=0.5.0; extra == 'dev'
Requires-Dist: pytest>=7.4.2; extra == 'dev'
Requires-Dist: rolo; extra == 'dev'
Requires-Dist: ruff>=0.3.3; extra == 'dev'
Requires-Dist: xmltodict; extra == 'dev'
Provides-Extra: test
Requires-Dist: boto3; extra == 'test'
Requires-Dist: cbor2; extra == 'test'
Requires-Dist: flask; extra == 'test'
Requires-Dist: hypercorn; extra == 'test'
Requires-Dist: jsonpatch; extra == 'test'
Requires-Dist: pytest-httpserver>=1.1.2; extra == 'test'
Requires-Dist: pytest-tinybird>=0.5.0; extra == 'test'
Requires-Dist: pytest>=7.4.2; extra == 'test'
Requires-Dist: rolo; extra == 'test'
Requires-Dist: xmltodict; extra == 'test'
Description-Content-Type: text/markdown

# LocalStack CLI

The command-line interface for [LocalStack](https://localstack.cloud), a cloud service emulator that runs on your laptop or in your CI environment.

> [!WARNING]
> The `localstack` CLI is deprecated and will no longer receive updates. Please use the new [`lstk`](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/) CLI instead. You don't need to uninstall this one. The two can run side by side while you migrate, just don't run both against the same stack at once. See the [migration guide](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/migration/) for details.

## Installation

```bash
pip install localstack
```

Requires Docker to be installed and running.

## Usage

Start LocalStack:

```bash
localstack start
```

Check service status:

```bash
localstack status services
```

Stop LocalStack:

```bash
localstack stop
```

## Releasing

A release has two parts: publish the `localstack` package to PyPI from this repository, then build the binaries and the Homebrew formula in [localstack/localstack-cli](https://github.com/localstack/localstack-cli). Do both, otherwise binary and Homebrew users stay on the old version.

1. Create and push a version tag in this repository. Use the `vYYYY.M.PATCH` format:

   ```bash
   git tag v2026.8.2
   git push origin v2026.8.2
   ```

   The tag push triggers the GitHub Actions workflow, which runs the tests and publishes the `localstack` package to PyPI.

2. Once the new version is on [PyPI](https://pypi.org/project/localstack/), bump the pin in `requirements.txt` of [localstack/localstack-cli](https://github.com/localstack/localstack-cli) (`localstack==2026.8.2`), commit it to `main`, and push the same tag there:

   ```bash
   git tag v2026.8.2
   git push origin v2026.8.2
   ```

   The tag push builds the PyInstaller binaries and creates a draft GitHub release.

3. Publish the draft release in [localstack/localstack-cli](https://github.com/localstack/localstack-cli/releases). Publishing triggers the update of the `localstack/tap/localstack-cli` Homebrew formula.

## Documentation

For full documentation, visit [docs.localstack.cloud](https://docs.localstack.cloud).

## License

Apache License 2.0
