Skip to main content

Simple wrapper around AWS SAM CLI for use with LocalStack

Project description

# AWS SAM CLI for LocalStack

This project provides the samlocal command line, a simple wrapper around the [AWS SAM CLI](https://github.com/aws/aws-sam-cli) for use with [LocalStack](https://github.com/localstack/localstack).

## Installation

Simply use pip to install samlocal as a Python library on your machine:

` pip install aws-sam-cli-local `

## Usage

The samlocal command has the exact same usage as the underlying sam command. The main difference is that for commands like samlocal deploy the operations will be executed against the LocalStack endpoints (http://localhost:4566 by default) instead of real AWS endpoints.

` samlocal --help `

## Configuration

  • AWS_ENDPOINT_URL: URL at which the boto3 client can reach LocalStack, e.g. http://localhost.localstack.cloud:4566 (default: http://localhost:4566)

  • EDGE_PORT: Deprecated Port number under which the LocalStack edge service is available (default: 4566)

  • LOCALSTACK_HOSTNAME: Deprecated Host under which the LocalStack edge service is available (default: localhost)

## Change Log

  • v1.70.0: Fix regex pattern to detect ECR URLs with dashes

  • v1.69.0: Fix repo related cli options and add support to Lambdas with Image type

  • v1.68.0: Support AWS_ENDPOINT_URL for configuring the boto3.client endpoint

  • v1.67.0: Patch underlying boto3.Session.client instead of boto3.client

  • v1.55.0: Fix s3 URl detection when using a nested template

  • v1.53.1: Fix logic around local URLs for ECR image repositories

  • v1.1.0.1: Minor fix, release initial version of samlocal command

  • v1.1.0: Initial version

## License

This software library is released under the Apache License, Version 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aws-sam-cli-local-1.70.0.tar.gz (8.7 kB view details)

Uploaded Source

File details

Details for the file aws-sam-cli-local-1.70.0.tar.gz.

File metadata

  • Download URL: aws-sam-cli-local-1.70.0.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.7

File hashes

Hashes for aws-sam-cli-local-1.70.0.tar.gz
Algorithm Hash digest
SHA256 574b9d182ad551520fbd2bd030227baa57340aa93ad63d0d7c9afacfa59d5fa4
MD5 460d72a4d85aae8692063d22a064f582
BLAKE2b-256 b7479536972b9f3feec868678af0a8611c982fb7eeb3e3d29797a7439385d7d6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page