AWS SAM CLI 🐿 is a CLI tool for local development and testing of Serverless applications
Clone or download
Permalink
Failed to load latest commit information.
.github SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
docs docs: Update usage.rst to render code inline (#661) Sep 17, 2018
media SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
requirements fix: conditionally install enum34 based on python version (#671) Sep 18, 2018
samcli fix: Update test format for Nodejs8.10 runtime. (#662) Sep 17, 2018
tests fix(path): change windows style path to unix (#633) Sep 10, 2018
.coveragerc SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
.flake8 SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
.gitignore `sam logs` CLI command implementation (#530) Jul 11, 2018
.pylintrc SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
.travis.yml feat(Python3): Build support for Python3.6 (#478) Jun 14, 2018
CODE_OF_CONDUCT.md Adding standard files (#335) Mar 22, 2018
CONTRIBUTING.md docs: Add more details on Contributing through PR (#481) Jun 14, 2018
DESIGN.rst docs: change indentation on DESIGN.rst (#535) Jul 5, 2018
DEVELOPMENT_GUIDE.rst docs: Adding a note directing Windows users to use pipenv (#606) Aug 7, 2018
LICENSE SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
MANIFEST.in feat(generate-event): Added support for 50+ events (#612) Aug 10, 2018
Makefile SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
NOTICE SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
README.rst fix(docs): fixed macOS name (#651) Sep 7, 2018
pytest.ini SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
setup.cfg SAM CLI Refresh πŸŽ‰ (#383) May 8, 2018
setup.py chore: Version bump and update setup.py to include Python3.6 (#483) Jun 18, 2018
tox.ini feat(Python3): Build support for Python3.6 (#478) Jun 14, 2018

README.rst

SAM CLI (Beta)

Build Status Apache-2.0 Contributers GitHub-release PyPI version

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

  • [ ] Python Versions support
    • [x] Python 2.7
    • [x] Python 3.6
  • [ ] Supported AWS Lambda Runtimes
    • [x] nodejs
    • [x] nodejs4.3
    • [x] nodejs6.10
    • [x] nodejs8.10
    • [x] java8
    • [x] python2.7
    • [x] python3.6
    • [x] go1.x
    • [ ] dotnetcore1.0
    • [x] dotnetcore2.0
    • [x] dotnetcore2.1
  • [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] java8
    • [x] python2.7
    • [x] python3.6
    • [x] go1.x
    • [x] dotnetcore1.0
    • [x] dotnetcore2.0

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.