Repository files navigation

This package provides theawslocal command, which is a thin wrapper around theawscommand line interface for use withLocalStack.

You can install theawslocal command viapip:

pip install awscli-local[ver1]

Note that the command above also installs the latest version of the underlying AWS CLI version 1 (awscli) package. Use this command if you prefer to manage your own version ofawscli (e.g.,v1/v2) and install the wrapper script only:

pip install awscli-local

Note: Automatic installation of AWS CLI version 2 is currently not supported yet (at the time of writing there is no official pypi package forv2 available), but theawslocal technically also works with AWS CLI v2 (seethis section for more details).

Theawslocal command has the same usage as theaws command. For detailed usage,please refer to the man pages ofaws help.

Instead of the following command ...

aws --endpoint-url=http://localhost:4566 kinesis list-streams

... you can simply use this:

awslocal kinesis list-streams

You can use the following environment variables for configuration:

• LOCALSTACK_HOST: Set the hostname for the localstack instance. Useful when you havelocalstack is bound to another interface (i.e. docker-machine).
• USE_SSL: Whether to usehttps endpoint URLs (required if LocalStack has been startedwithUSE_SSL=true enabled). Defaults tofalse.
• DEFAULT_REGION: Set the default region. OverridesAWS_DEFAULT_REGION environment variable.

• Please note that there is a known limitation for using thecloudformation package ... command with the AWS CLI v2. The problem is that the AWS CLI v2 isnot available as a package on pypi.org, but is instead shipped as a binary package that cannot be easily patched fromawslocal. To work around this issue, you have 2 options:

  • Downgrade to the v1 AWS CLI (this is the recommended approach)
  • There is an inofficial way to install AWS CLI v2 from sources. We do not recommend this, but it is technically possible. Also, you should install these libraries in a Python virtualenv, to avoid version clashes with other libraries on your system:

virtualenv .venv. .venv/bin/activatepip install https://github.com/boto/botocore/archive/v2.zip https://github.com/aws/aws-cli/archive/v2.zip

• v0.19: Patch botocore to skip addingdata- host prefixes to endpoint URLs
• v0.18: PassSYSTEMROOT env variable to fix "_Py_HashRandomization_Init" error on Windows
• v0.17: Remove obsolete/erroneous FORCE_V2 flag
• v0.16: Minor fix reading addressing_style in profile config
• v0.15: Fix lookup of v1/v2 AWS CLI version, apply --s3-endpoint-url only for v1
• v0.14: Quote file name for windows to allow folder names with spaces
• v0.13: Fix extra requires for newer pip versions
• v0.12: Support v1 and v2 of underlyingawscli installation
• v0.9: Add--s3-endpoint-url by default to fix "cloudformation package" command
• v0.9: Support forDEFAULT_REGION environment variable
• v0.8: Switch to using edge port for all service endpoints by default
• v0.7: Apply runtime patch to aws-cli to enable--s3-endpoint-url CloudFormation parameter
• v0.6: Startaws CLI command in-memory instead of calling external process
• v0.5: Support piping binary files to stdout; add .bat file for Windows
• v0.4: Minor fix for Python 3 compatibility
• v0.3: Add support for additional service endpoints
• v0.2: Enable SSL connections; refactor code
• v0.1: Initial release

This package can be replaced by a single bash alias, except forcloudformation package ... as this command requires an additional--s3-endpoint-url parameter:

alias awslocal="AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test AWS_DEFAULT_REGION=${DEFAULT_REGION:-$AWS_DEFAULT_REGION} aws --endpoint-url=http://${LOCALSTACK_HOST:-localhost}:4566"

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