aws-cloud-utilities


Nameaws-cloud-utilities JSON
Version 2.0.0 PyPI version JSON
download
home_pageNone
SummaryA unified command-line toolkit for AWS operations with enhanced functionality
upload_time2025-07-09 01:39:57
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12
licenseMIT
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"
}
        
Elapsed time: 0.66198s