Metadata-Version: 2.1
Name: awsnap
Version: 0.0.3
Summary: AWSnap: an AWS Utility to help manage your projects and sso sessions.
Home-page: https://github.com/aphexlog/AWSnap
License: MIT
Author: Aaron West
Author-email: aphexlog@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: aws-cdk-lib (>=2.126.0,<3.0.0)
Requires-Dist: boto3 (>=1.34.36,<2.0.0)
Requires-Dist: boto3-stubs (>=1.34.36,<2.0.0)
Requires-Dist: gitpython (>=3.1.41,<4.0.0)
Requires-Dist: setuptools (>=69.0.3,<70.0.0)
Project-URL: Repository, https://github.com/aphexlog/AWSnap
Description-Content-Type: text/markdown

# AWSnap: AWS SSO Utility

[![PyPI version](https://badge.fury.io/py/awsnap.svg)](https://badge.fury.io/py/awsnap)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

AWSnap is a simple and effective tool for managing AWS Single Sign-On (SSO). Tailored for both developers and administrators, AWSnap offers an easy way to streamline your AWS SSO process, including running custom shell commands with specific profiles and exporting temporary AWS credentials.

## Features

- **Easy Integration**: Seamlessly integrate with existing AWS infrastructure.
- **Secure Authentication**: Enhance security with robust SSO capabilities.
- **Customizable**: Extend and adapt AWSnap to suit your specific needs.
- **Run Custom Commands**: Execute shell commands with AWS profiles and export temporary credentials in memory.
- **Temporary AWS Credentials**: Access temporary AWS credentials specific to a profile, securely available in memory.

## Installation

You can install AWSnap via pip:

```bash
pip install awsnap
```

## Usage

Getting started with AWSnap is easy:

To generate temporary AWS credentials for a specific profile:
```bash
awsnap -p <profile_name>
```
This will generate temporary AWS credentials for the specified profile and store them in the ~/.aws/credentials file.

To open your AWS console in a browser session:
```bash
awsnap <your_command_here> --profile <profile_name> --console
```

To get help:
```bash
awsnap --help
```
or
```bash
go see a therapist.
```

The project is available on [pypip](https://pypi.org/project/awsnap/).

## Contributing

Contributions are welcome! Check out the [issues](https://github.com/aphexlog/AWSnap/issues) or submit a pull request.

## License

AWSnap is released under the [MIT License](https://github.com/aphexlog/AWSnap/blob/main/LICENSE).

---

Feel free to reach out with questions, suggestions, or just to say hello. Happy coding!

## Contact Information
- **Author**: Aaron West
- **Email**: aphexlog@gmail.com

---

Thank you for your interest in AWSnap! Follow the project on [GitHub](https://github.com/aphexlog/AWSnap) for the latest updates...

