Name | aws-cloud-utilities JSON |
Version |
2.0.0
JSON |
| download |
home_page | None |
Summary | A unified command-line toolkit for AWS operations with enhanced functionality |
upload_time | 2025-07-09 01:39:57 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.12 |
license | MIT |
keywords |
aws
cloud
cli
utilities
devops
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# 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.
## 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
# 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
- **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/48/12/887e3652eb430de0de9f6226efa33a4dbe9384883c2ec1ae21cc0ef44514/aws_cloud_utilities-2.0.0.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## 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# 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- **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.0.0",
"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": "b53061ccb913e28f41ef75f21d328cd070f102e6bbec0d6748ed7836936518e2",
"md5": "27f1bec21dc389741a72f41fd4a67a71",
"sha256": "425b6e58193125887f2926f6bb472e428cab383f3772ef68270d8006a602acc2"
},
"downloads": -1,
"filename": "aws_cloud_utilities-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "27f1bec21dc389741a72f41fd4a67a71",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 103101,
"upload_time": "2025-07-09T01:39:55",
"upload_time_iso_8601": "2025-07-09T01:39:55.936095Z",
"url": "https://files.pythonhosted.org/packages/b5/30/61ccb913e28f41ef75f21d328cd070f102e6bbec0d6748ed7836936518e2/aws_cloud_utilities-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4812887e3652eb430de0de9f6226efa33a4dbe9384883c2ec1ae21cc0ef44514",
"md5": "6f967b434e2716e0b8ba0a8f769cb9e3",
"sha256": "dbea001bcb7f62d73fa50bf6bce2d3685be279ad10c6f4e59cd602009025a273"
},
"downloads": -1,
"filename": "aws_cloud_utilities-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "6f967b434e2716e0b8ba0a8f769cb9e3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 87990,
"upload_time": "2025-07-09T01:39:57",
"upload_time_iso_8601": "2025-07-09T01:39:57.193801Z",
"url": "https://files.pythonhosted.org/packages/48/12/887e3652eb430de0de9f6226efa33a4dbe9384883c2ec1ae21cc0ef44514/aws_cloud_utilities-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 01:39:57",
"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,
"lcname": "aws-cloud-utilities"
}