Metadata-Version: 2.4
Name: aws-profiler
Version: 1.0.0
Summary: A CLI tool to list AWS profiles and check their credential status
Home-page: https://github.com/AgentGino/aws-profiler
Author: AgentGino
Author-email: himakar@qwik.tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: boto3>=1.26.0
Requires-Dist: tabulate>=0.9.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AWS Profiler

A command-line tool to list all AWS profiles and check their credential status.

## Features

- 📋 Lists all AWS profiles from `~/.aws/credentials` and `~/.aws/config`
- 🔍 Retrieves account information for each profile
- ✅ Checks if credentials are active or expired
- 📊 Displays results in a formatted table
- 📈 Provides summary statistics

## Installation

### Install from source

```bash
pip install -e .
```

### Install from PyPI (when published)

```bash
pip install aws-profiler
```

## Usage

After installation, run the tool:

```bash
aws-profiler
```

The tool will scan your AWS configuration files and display a table with:

- Profile name
- Account ID
- User/Role name
- Credential type (User/Role)
- Status (Active/Expired/Error)

## Example Output

```
AWS Profiler
================================================================================

Found 3 profile(s)

Checking profile: default... [Active]
Checking profile: staging... [Active]
Checking profile: production... [Expired]

+-------------+--------------+------------+------+----------+
| Profile     | Account ID   | User/Role  | Type | Status   |
+=============+==============+============+======+==========+
| default     | 123456789012 | admin      | User | Active   |
+-------------+--------------+------------+------+----------+
| staging     | 234567890123 | dev-role   | Role | Active   |
+-------------+--------------+------------+------+----------+
| production  | N/A          | N/A        | N/A  | Expired  |
+-------------+--------------+------------+------+----------+

Summary: 2 active, 1 expired, 0 error/no credentials
```

## Status Values

- **Active**: Credentials are valid and working
- **Expired**: Token or credentials have expired
- **No Credentials**: Profile exists but no credentials are configured
- **Error**: Other authentication or authorization errors

## License

MIT License

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
