A tool to interact with VPCs configured in AWS accounts and roles.
Project description
Offprem
Offprem will query AWS for all VPC's a profile has access to. The vpc_id, region, and associated tags of each discovered VPC is stored in a configuration file, which can then be leveraged to automatically create STS tokens and boto3 sessions.
Installation
Requires Python 3.9+:
python -m pip install offprem
Features
- Save the VPC ID and region for all VPCs an account/role has access to.
- Supports roles, and accounts with Multi-Factor Authentication enabled.
- Automatically create STS tokens and boto3 sessions to interact with VPCs.
Usage
Read the tutorial.
Local Development and Testing
Development
Development and testing should be done in a virtual environment.
$ git clone https://github.com/Fauxsys/offprem.git
$ cd offprem
$ python -m venv venv --prompt offprem
$ source venv/bin/activate
(offprem) $ python -m pip install -U pip
Install offprem locally.
(parserconfig) $ python -m pip install -e ".[test]"
Testing
You can test any changes locally with pytest.
(offprem) $ python -m pytest --cov=offprem
You can also test offprem as an installed package.
(offprem) $ python -m tox
Building a wheel
(offprem) $ python -m pip install build
(offprem) $ python -m build --wheel
There should now be a wheel in the dist
directory.
(offprem) $ ls -1 dist
offprem-0.0.2b0-py3-none-any.whl
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 Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for offprem-0.0.2b0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d80cea90bccc9e20ac920b1614d158272351523c120e2f373758031f82cbce5b |
|
MD5 | c8d8469c9d08cf530415a26e169942d4 |
|
BLAKE2b-256 | 249dd07881a4f0c7c3d8d6744280de5772fa25472339b67832464f10665c741e |