Skip to main content

AWS SAM CLI is a CLI tool for local development and testing of Serverless applications

Project description

SAM CLI (Beta)

Build Status Apache-2.0 Contributors GitHub-release PyPI version

Get it from the Snap Store

Join the SAM developers channel (#samdev) on Slack to collaborate with fellow community members and the AWS SAM team.

sam is the AWS CLI tool for managing Serverless applications written with AWS Serverless Application Model (SAM). SAM CLI can be used to test functions locally, start a local API Gateway from a SAM template, validate a SAM template, fetch logs, generate sample payloads for various event sources, and generate a SAM project in your favorite Lambda Runtime.

Main features

  • Develop and test your Lambda functions locally with sam local and Docker
  • Invoke functions from known event sources such as Amazon S3, Amazon DynamoDB, Amazon Kinesis Streams, etc.
  • Start local API Gateway from a SAM template, and quickly iterate over your functions with hot-reloading
  • Validate SAM templates
  • Get started with boilerplate Serverless Service in your chosen Lambda Runtime sam init

Get Started

Learn how to get started using the SAM CLI with these guides:

Project Status

  • [x] Python Versions support
    • [x] Python 2.7
    • [x] Python 3.6
    • [x] Python 3.7
  • [ ] Supported AWS Lambda Runtimes
    • [x] nodejs
    • [x] nodejs4.3
    • [x] nodejs6.10
    • [x] nodejs8.10
    • [x] nodejs10.x
    • [x] java8
    • [x] python2.7
    • [x] python3.6
    • [x] python3.7
    • [x] go1.x
    • [ ] dotnetcore1.0
    • [x] dotnetcore2.0
    • [x] dotnetcore2.1
    • [x] ruby2.5
    • [x] Provided
  • [x] AWS credential support
  • [x] Debugging support
  • [x] Inline Swagger support within SAM templates
  • [x] Validating SAM templates locally
  • [x] Generating boilerplate templates
    • [x] nodejs
    • [x] nodejs4.3
    • [x] nodejs6.10
    • [x] nodejs8.10
    • [x] nodejs10.x
    • [x] java8
    • [x] python2.7
    • [x] python3.6
    • [x] python3.7
    • [x] go1.x
    • [x] dotnetcore1.0
    • [x] dotnetcore2.0
    • [x] ruby2.5
    • [ ] Provided

Contributing

Contributions and feedback are welcome! Proposals and pull requests will be considered and responded to. For more information, see the CONTRIBUTING file.

A special thank you

SAM CLI uses the open source docker-lambda Docker images created by @mhart.

Project details


Release history Release notifications | RSS feed

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-0.16.0.tar.gz (247.9 kB view hashes)

Uploaded Source

Built Distributions

aws_sam_cli-0.16.0-py3-none-any.whl (351.0 kB view hashes)

Uploaded Python 3

aws_sam_cli-0.16.0-py2-none-any.whl (351.0 kB view hashes)

Uploaded Python 2

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