playground-ls-cli 2026.3.0__tar.gz

playground_ls_cli-2026.3.0/.github/workflows/tests-cli.yml

@@ -0,0 +1,128 @@
+name: CLI Tests
+
+on:
+  workflow_dispatch:
+    inputs:
+      PYTEST_LOGLEVEL:
+        type: choice
+        description: Loglevel for PyTest
+        options:
+          - DEBUG
+          - INFO
+          - WARNING
+        default: WARNING
+      publish_to_pypi:
+        type: boolean
+        description: Publish to PyPI after tests pass
+        default: false
+  pull_request:
+    paths:
+      - '**'
+      - '!README.md'
+      - '!.gitignore'
+  push:
+    branches:
+      - main
+      - release/*
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+env:
+  PYTEST_LOGLEVEL: "${{ inputs.PYTEST_LOGLEVEL || 'WARNING' }}"
+
+permissions:
+  contents: read
+
+jobs:
+  cli-tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_PULL_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PULL_TOKEN }}
+
+      - name: Pull Docker images
+        run: |
+          docker pull localstack/localstack-pro
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          python -m pip install -e ".[test]"
+
+      - name: Run CLI smoke tests
+        run: |
+          # Sanity check CLI invocation
+          exit_code=0; DEBUG=0 localstack || exit_code=$?; [ "$exit_code" -eq "2" ]
+          exit_code=0; DEBUG=1 localstack || exit_code=$?; [ "$exit_code" -eq "2" ]
+          # Check Pro CLI plugin is loaded
+          DEBUG=1 localstack 2>&1 | grep "Advanced:" || echo "Pro commands not available (expected without auth)"
+
+      - name: Run CLI tests
+        env:
+          LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}
+        run: |
+          python -m pytest tests/cli/ \
+            --log-cli-level=${{ env.PYTEST_LOGLEVEL }} \
+            -v -s
+
+      - name: Run unit tests
+        env:
+          LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}
+        run: |
+          python -m pytest tests/unit/ \
+            --log-cli-level=${{ env.PYTEST_LOGLEVEL }} \
+            -v -s
+
+  publish:
+    if: >-
+      (github.event.inputs.publish_to_pypi == 'true' && github.ref == 'refs/heads/main') ||
+      startsWith(github.ref, 'refs/tags/v')
+    needs: cli-tests
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

playground_ls_cli-2026.3.0/.gitignore

@@ -0,0 +1,124 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# LocalStack specific
+localstack_cli/version.py
+
+# Claude
+.claude/

playground_ls_cli-2026.3.0/Makefile

@@ -0,0 +1,40 @@
+.PHONY: install test test-unit test-integration lint clean entrypoints
+
+VENV_DIR ?= .venv
+PYTHON ?= python3
+
+venv:
+	$(PYTHON) -m venv $(VENV_DIR)
+	$(VENV_DIR)/bin/pip install --upgrade pip setuptools wheel
+
+install: venv
+	$(VENV_DIR)/bin/pip install -e ".[dev]"
+	$(VENV_DIR)/bin/python -m plux entrypoints
+	$(VENV_DIR)/bin/pip install -e .
+
+test: install
+	$(VENV_DIR)/bin/pytest tests/ -v --log-cli-level=WARNING
+
+test-unit: install
+	$(VENV_DIR)/bin/pytest tests/unit/ -v --log-cli-level=WARNING
+
+test-cli: install
+	$(VENV_DIR)/bin/pytest tests/cli/ -v --log-cli-level=WARNING
+
+lint: install
+	$(VENV_DIR)/bin/ruff check localstack_cli tests
+	$(VENV_DIR)/bin/ruff format --check localstack_cli tests
+
+format: install
+	$(VENV_DIR)/bin/ruff check --fix localstack_cli tests
+	$(VENV_DIR)/bin/ruff format localstack_cli tests
+
+entrypoints: install
+	$(VENV_DIR)/bin/python -m plux entrypoints
+	@test -s plux.ini || (echo "Entrypoints not created correctly!" && exit 1)
+
+clean:
+	rm -rf $(VENV_DIR)
+	rm -rf build dist *.egg-info
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete

playground_ls_cli-2026.3.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: playground-ls-cli
+Version: 2026.3.0
+Summary: The LocalStack Command Line Interface
+Author-email: LocalStack Contributors <info@localstack.cloud>
+License-Expression: Apache-2.0
+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
+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
+Description-Content-Type: text/markdown
+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: plux>=1.14.0
+Requires-Dist: psutil>=5.4.8
+Requires-Dist: python-dotenv>=0.19.1
+Requires-Dist: pyyaml>=5.1
+Requires-Dist: rich>=12.3.0
+Requires-Dist: requests>=2.20.0
+Requires-Dist: semver>=2.10
+Requires-Dist: tabulate
+Requires-Dist: packaging
+Requires-Dist: pyotp>=2.9.0
+Requires-Dist: PyJWT[crypto]>=1.7.0
+Requires-Dist: python-dateutil>=2.8
+Requires-Dist: windows-curses; platform_system == "Windows"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4.2; extra == "test"
+Requires-Dist: pytest-httpserver>=1.1.2; extra == "test"
+Requires-Dist: pytest-tinybird>=0.5.0; extra == "test"
+Requires-Dist: boto3; extra == "test"
+Requires-Dist: jsonpatch; extra == "test"
+Requires-Dist: xmltodict; extra == "test"
+Requires-Dist: cbor2; extra == "test"
+Requires-Dist: hypercorn; extra == "test"
+Requires-Dist: flask; extra == "test"
+Requires-Dist: rolo; extra == "test"
+Provides-Extra: dev
+Requires-Dist: playground-ls-cli[test]; extra == "dev"
+Requires-Dist: libcst; extra == "dev"
+Requires-Dist: ruff>=0.3.3; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+
+# 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.
+
+## Installation
+
+```bash
+pip install localstack-cli-standalone
+```
+
+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
+```
+
+## Documentation
+
+For full documentation, visit [docs.localstack.cloud](https://docs.localstack.cloud).
+
+## License
+
+Apache License 2.0

playground_ls_cli-2026.3.0/README.md

@@ -0,0 +1,39 @@
+# 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.
+
+## Installation
+
+```bash
+pip install localstack-cli-standalone
+```
+
+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
+```
+
+## Documentation
+
+For full documentation, visit [docs.localstack.cloud](https://docs.localstack.cloud).
+
+## License
+
+Apache License 2.0

playground_ls_cli-2026.3.0/bin/localstack

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+
+import glob
+import os
+import sys
+
+PARENT_FOLDER = os.path.realpath(os.path.join(os.path.dirname(os.path.realpath(__file__)), ".."))
+venv_dir = os.path.join(PARENT_FOLDER, ".venv")
+insert_pos = min(len(sys.path), 2)
+if os.path.isdir(venv_dir):
+    for path in glob.glob(os.path.join(venv_dir, "lib/python*/site-packages")):
+        sys.path.insert(insert_pos, path)
+    sys.path.insert(insert_pos, PARENT_FOLDER)
+
+
+def main():
+    from localstack_cli.cli import main
+
+    main.main()
+
+
+if __name__ == "__main__":
+    main()

playground_ls_cli-2026.3.0/localstack_cli/cli/__init__.py

@@ -0,0 +1,10 @@
+from .console import console
+from .plugin import LocalstackCli, LocalstackCliPlugin
+
+name = "cli"
+
+__all__ = [
+    "console",
+    "LocalstackCli",
+    "LocalstackCliPlugin",
+]

playground_ls_cli-2026.3.0/localstack_cli/cli/console.py

@@ -0,0 +1,11 @@
+from rich.console import Console
+
+BANNER = r"""
+     __                     _______ __             __
+    / /   ____  _________ _/ / ___// /_____ ______/ /__
+   / /   / __ \/ ___/ __ `/ /\__ \/ __/ __ `/ ___/ //_/
+  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,<
+ /_____/\____/\___/\__,_/_//____/\__/\__,_/\___/_/|_|
+"""
+
+console = Console()

playground_ls_cli-2026.3.0/localstack_cli/cli/core_plugin.py

@@ -0,0 +1,12 @@
+"""Core CLI plugin that registers community CLI commands."""
+from localstack_cli.cli.plugin import LocalstackCli, LocalstackCliPlugin
+
+
+class CoreCliPlugin(LocalstackCliPlugin):
+    """Plugin that registers core CLI commands."""
+
+    name = "core"
+
+    def attach(self, cli: LocalstackCli) -> None:
+        # Core commands are already on the main group, nothing to add
+        pass

playground_ls_cli-2026.3.0/localstack_cli/cli/exceptions.py

@@ -0,0 +1,19 @@
+import typing as t
+from gettext import gettext
+
+import click
+from click import ClickException, echo
+from click._compat import get_text_stderr
+
+
+class CLIError(ClickException):
+    """A ClickException with a red error message"""
+
+    def format_message(self) -> str:
+        return click.style(f"❌ Error: {self.message}", fg="red")
+
+    def show(self, file: t.IO[t.Any] | None = None) -> None:
+        if file is None:
+            file = get_text_stderr()
+
+        echo(gettext(self.format_message()), file=file)