# AWS Cloud Utilities v2
A unified command-line toolkit for AWS operations with enhanced functionality. This package consolidates various AWS management scripts into a single, powerful CLI tool.
## Prerequisites
- Python 3.x
- Boto3 library
- AWS credentials configured (e.g., via ~/.aws/credentials or environment variables)
## Installation
1. Clone this repo
2. Install the required Python packages (Pipenv in repo)
1. `pipenv sync`
## Features
- **Unified CLI**: Single command interface for all AWS operations
- **Parallel Processing**: Multi-threaded operations for improved performance
- **Rich Output**: Beautiful, formatted output with tables and colors
- **Flexible Configuration**: Support for AWS profiles, regions, and custom settings
- **Comprehensive Coverage**: Tools for cost optimization, inventory, security, logs, and more
## Installation
```bash
# Install from PyPI (when published)
pip install aws-cloud-utilities
# Install from source
git clone https://github.com/jon-the-dev/aws-cloud-tools.git
cd aws-cloud-tools/v2
pip install -e .
```
## Quick Start
```bash
# Get account information
aws-cloud-utilities account info
# List all resources in your account
aws-cloud-utilities inventory resources
# Find cheapest GPU spot instances
aws-cloud-utilities costops gpu-spots --instance-type p3.2xlarge
# Troubleshoot MySQL RDS connection issues
aws-cloud-utilities rds troubleshoot-mysql my-mysql-db
# Aggregate CloudWatch logs
aws-cloud-utilities logs aggregate --log-group /aws/lambda/my-function
# Security audit
aws-cloud-utilities security blue-team-audit
```
## Command Structure
The CLI follows a hierarchical structure similar to the AWS CLI:
```
aws-cloud-utilities [GLOBAL-OPTIONS] <service> <operation> [OPTIONS]
```
### Available Services
- **account**: Account information and management
- **costops**: Cost optimization and pricing tools
- **inventory**: Resource discovery and inventory
- **logs**: CloudWatch logs management
- **rds**: RDS management and troubleshooting
- **security**: Security auditing and tools
- **s3**: S3 bucket operations
- **iam**: IAM management and auditing
- **networking**: Network utilities
- **support**: AWS support tools
### Global Options
- `--profile`: AWS profile to use
- `--region`: AWS region
- `--output`: Output format (json, yaml, table)
- `--verbose`: Enable verbose logging
- `--debug`: Enable debug mode
## Configuration
Create a `.env` file in your project directory or home directory:
```env
AWS_PROFILE=default
AWS_DEFAULT_REGION=us-east-1
AWS_OUTPUT_FORMAT=table
WORKERS=4
```
## Development
### Setup Development Environment
```bash
# Clone the repository
git clone https://github.com/jon-the-dev/aws-cloud-tools.git
cd aws-cloud-tools/v2
# Install in development mode
pip install -e ".[dev]"
# Install pre-commit hooks
pre-commit install
```
### Running Tests
```bash
# Run all tests
pytest
# Run with coverage
pytest --cov=aws_cloud_utilities
# Run specific test file
pytest tests/test_cli.py
```
### Code Quality
```bash
# Format code
black aws_cloud_utilities tests
# Lint code
flake8 aws_cloud_utilities tests
# Type checking
mypy aws_cloud_utilities
```
## Migration from v1
If you're migrating from the original script collection, see our [Migration Guide](docs/migration.md) for detailed instructions.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Support
- [GitHub Issues](https://github.com/jon-the-dev/aws-cloud-tools/issues)
- [Documentation](https://github.com/jon-the-dev/aws-cloud-tools/tree/main/docs)
## Changelog
See [CHANGELOG.md](CHANGELOG.md) for version history and changes.
Raw data
{
"_id": null,
"home_page": null,
"name": "aws-cloud-utilities",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "Jon <jon@zer0day.net>",
"keywords": "aws, cloud, cli, utilities, devops",
"author": null,
"author_email": "Jon <jon@zer0day.net>",
"download_url": "https://files.pythonhosted.org/packages/25/19/addda70f961df7fbaa9560acc991dc8fce09113fdda445d4a8def03eb7a1/aws_cloud_utilities-2.1.2.tar.gz",
"platform": null,
"description": "# AWS Cloud Utilities v2\n\nA unified command-line toolkit for AWS operations with enhanced functionality. This package consolidates various AWS management scripts into a single, powerful CLI tool.\n\n## Prerequisites\n\n- Python 3.x\n- Boto3 library\n- AWS credentials configured (e.g., via ~/.aws/credentials or environment variables)\n\n## Installation\n\n1. Clone this repo\n2. Install the required Python packages (Pipenv in repo)\n 1. `pipenv sync`\n\n## Features\n\n- **Unified CLI**: Single command interface for all AWS operations\n- **Parallel Processing**: Multi-threaded operations for improved performance\n- **Rich Output**: Beautiful, formatted output with tables and colors\n- **Flexible Configuration**: Support for AWS profiles, regions, and custom settings\n- **Comprehensive Coverage**: Tools for cost optimization, inventory, security, logs, and more\n\n## Installation\n\n```bash\n# Install from PyPI (when published)\npip install aws-cloud-utilities\n\n# Install from source\ngit clone https://github.com/jon-the-dev/aws-cloud-tools.git\ncd aws-cloud-tools/v2\npip install -e .\n```\n\n## Quick Start\n\n```bash\n# Get account information\naws-cloud-utilities account info\n\n# List all resources in your account\naws-cloud-utilities inventory resources\n\n# Find cheapest GPU spot instances\naws-cloud-utilities costops gpu-spots --instance-type p3.2xlarge\n\n# Troubleshoot MySQL RDS connection issues\naws-cloud-utilities rds troubleshoot-mysql my-mysql-db\n\n# Aggregate CloudWatch logs\naws-cloud-utilities logs aggregate --log-group /aws/lambda/my-function\n\n# Security audit\naws-cloud-utilities security blue-team-audit\n```\n\n## Command Structure\n\nThe CLI follows a hierarchical structure similar to the AWS CLI:\n\n```\naws-cloud-utilities [GLOBAL-OPTIONS] <service> <operation> [OPTIONS]\n```\n\n### Available Services\n\n- **account**: Account information and management\n- **costops**: Cost optimization and pricing tools\n- **inventory**: Resource discovery and inventory\n- **logs**: CloudWatch logs management\n- **rds**: RDS management and troubleshooting\n- **security**: Security auditing and tools\n- **s3**: S3 bucket operations\n- **iam**: IAM management and auditing\n- **networking**: Network utilities\n- **support**: AWS support tools\n\n### Global Options\n\n- `--profile`: AWS profile to use\n- `--region`: AWS region\n- `--output`: Output format (json, yaml, table)\n- `--verbose`: Enable verbose logging\n- `--debug`: Enable debug mode\n\n## Configuration\n\nCreate a `.env` file in your project directory or home directory:\n\n```env\nAWS_PROFILE=default\nAWS_DEFAULT_REGION=us-east-1\nAWS_OUTPUT_FORMAT=table\nWORKERS=4\n```\n\n## Development\n\n### Setup Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/jon-the-dev/aws-cloud-tools.git\ncd aws-cloud-tools/v2\n\n# Install in development mode\npip install -e \".[dev]\"\n\n# Install pre-commit hooks\npre-commit install\n```\n\n### Running Tests\n\n```bash\n# Run all tests\npytest\n\n# Run with coverage\npytest --cov=aws_cloud_utilities\n\n# Run specific test file\npytest tests/test_cli.py\n```\n\n### Code Quality\n\n```bash\n# Format code\nblack aws_cloud_utilities tests\n\n# Lint code\nflake8 aws_cloud_utilities tests\n\n# Type checking\nmypy aws_cloud_utilities\n```\n\n## Migration from v1\n\nIf you're migrating from the original script collection, see our [Migration Guide](docs/migration.md) for detailed instructions.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests for new functionality\n5. Ensure all tests pass\n6. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- [GitHub Issues](https://github.com/jon-the-dev/aws-cloud-tools/issues)\n- [Documentation](https://github.com/jon-the-dev/aws-cloud-tools/tree/main/docs)\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for version history and changes.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A unified command-line toolkit for AWS operations with enhanced functionality",
"version": "2.1.2",
"project_urls": {
"Documentation": "https://github.com/jon-the-dev/aws-cloud-tools/tree/main/docs",
"Homepage": "https://github.com/jon-the-dev/aws-cloud-tools",
"Issues": "https://github.com/jon-the-dev/aws-cloud-tools/issues",
"Repository": "https://github.com/jon-the-dev/aws-cloud-tools"
},
"split_keywords": [
"aws",
" cloud",
" cli",
" utilities",
" devops"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cab6e0df974b43c2d9d827ca2db0bc4e5b3bafec40c1c26cd940c20bfa30a643",
"md5": "66edabebe20f8e7d02b7ef588d30d4ad",
"sha256": "3b5fc00b6c4b4aa881de9398019ad839c1d33f64e2c16dc09d35ce8a245e9931"
},
"downloads": -1,
"filename": "aws_cloud_utilities-2.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "66edabebe20f8e7d02b7ef588d30d4ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 130096,
"upload_time": "2025-08-19T04:40:59",
"upload_time_iso_8601": "2025-08-19T04:40:59.636844Z",
"url": "https://files.pythonhosted.org/packages/ca/b6/e0df974b43c2d9d827ca2db0bc4e5b3bafec40c1c26cd940c20bfa30a643/aws_cloud_utilities-2.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2519addda70f961df7fbaa9560acc991dc8fce09113fdda445d4a8def03eb7a1",
"md5": "8510e759092367e62265fc40f2f42c95",
"sha256": "abae730fdafde47845c79e9446ac5543274c200a69103bac9cbf158cd24cb5d9"
},
"downloads": -1,
"filename": "aws_cloud_utilities-2.1.2.tar.gz",
"has_sig": false,
"md5_digest": "8510e759092367e62265fc40f2f42c95",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 116523,
"upload_time": "2025-08-19T04:41:01",
"upload_time_iso_8601": "2025-08-19T04:41:01.039643Z",
"url": "https://files.pythonhosted.org/packages/25/19/addda70f961df7fbaa9560acc991dc8fce09113fdda445d4a8def03eb7a1/aws_cloud_utilities-2.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-19 04:41:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jon-the-dev",
"github_project": "aws-cloud-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "boto3",
"specs": [
[
">=",
"1.34.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "tabulate",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "PyYAML",
"specs": [
[
">=",
"6.0.0"
]
]
}
],
"lcname": "aws-cloud-utilities"
}
JSON
