Skip to main content

localaws

Run local Python scripts with different AWS profiles - perfect for local testing and development.

Installation

pip install localaws

Usage

Basic usage:

localaws script.py -p dev-profile

Full options:

localaws script.py --profile dev-profile --region us-west-2 --verbose

Short options:

localaws script.py -p dev-profile -r us-west-2 -v

Features

  • 🚀 Quick switch between AWS profiles for local testing
  • ✅ AWS profile validation before execution
  • 🌎 AWS region support
  • 📦 Proper Python path handling
  • 🔍 Verbose logging option
  • ❌ Clean error handling with helpful messages
  • 🔄 Cross-platform compatibility

Common Use Cases

  1. Testing AWS Lambda functions locally with different profiles:
localaws lambda_function.py -p test-profile
  1. Running scripts against different AWS environments:
localaws deploy_script.py -p staging-profile
localaws deploy_script.py -p production-profile
  1. Local development with different AWS accounts:
localaws dev_script.py -p personal-aws -r us-east-1

Requirements

  • Python 3.7+
  • boto3
  • click

Development

Clone and install in development mode:

git clone https://github.com/heysouravv/localaws.git
cd localaws
pip install -e .

Run tests:

pytest tests/

License

MIT License - See LICENSE file for details

Metadata

Release files for localaws 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localaws 0.1.1
File Size Uploaded Provenance Actions
localaws-0.1.1.tar.gz 5.1 kB Without provenance Details for localaws-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for localaws 0.1.1
File Interpreter ABI Platform Actions
localaws-0.1.1-py3-none-any.whl Python 3 none any Details for localaws-0.1.1-py3-none-any.whl

Total release size: 10.3 kB

Release files / localaws-0.1.1.tar.gz

Download URL localaws-0.1.1.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
044c56717d3f664d5665a2c174b6d30dcdd9f74c09daf8a56b71c315f4b31a82
BLAKE2b-256 checksum
How to use checksums
18e0abc33e728adc4c4370347217328903bb764bc81c90e476f83f86e44993f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.10.4

Release files / localaws-0.1.1-py3-none-any.whl

Download URL localaws-0.1.1-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9d0bdcb149d40586608407f456b6bf8de23841cf6fbd2c818e66edd89f661606
BLAKE2b-256 checksum
How to use checksums
ffce1082ac4ceed37a29d45b7e919478cdb9e2830568a657a7bce24f110fce1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.10.4

Security for localaws 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page