Metadata-Version: 2.4
Name: atlas-aws-autodownload
Version: 1.0.0
Summary: A Python tool for downloading files from AWS S3 bucket with configuration file support
Home-page: https://github.com/yourusername/atlas-aws-autodownload
Author: Your Name
Author-email: Your Name <your.email@example.com>
Maintainer-email: Your Name <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/atlas-aws-autodownload
Project-URL: Documentation, https://github.com/yourusername/atlas-aws-autodownload#readme
Project-URL: Repository, https://github.com/yourusername/atlas-aws-autodownload.git
Project-URL: Bug Tracker, https://github.com/yourusername/atlas-aws-autodownload/issues
Keywords: aws,s3,download,boto3,atlas
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: boto3>=1.26.0
Requires-Dist: tqdm>=4.64.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Atlas AWS Auto Download

A Python tool for downloading files from AWS S3 bucket with configuration file support.

## Features

- 🔐 **Secure**: Supports AWS access keys and region configuration
- 📁 **Flexible**: Configurable S3 bucket and folder paths
- 📝 **Logging**: Comprehensive logging of all download operations
- 🚀 **Progress**: Visual progress bars for download operations
- ⚙️ **Configurable**: Simple configuration file format

## Installation

### From PyPI (Recommended)

```bash
pip install atlas-aws-autodownload
```

### From Source

```bash
git clone https://github.com/yourusername/atlas-aws-autodownload.git
cd atlas-aws-autodownload
pip install -e .
```

## Usage

### Command Line Interface

After installation, you can use the `atlas-aws-download` command:

```bash
atlas-aws-download config.txt -o ./downloads
```

### Python API

```python
from atlas_aws_autodownload import aws_download

aws_download("config.txt", "./downloads")
```

## Configuration File Format

Create a configuration file with the following format:

```text
Project:MyProject
Alias ID:my-alias
S3 Bucket:my-bucket-name
Account:my-account
Password:my-password
Region:us-east-1
Aws_access_key_id:AKIAIOSFODNN7EXAMPLE
Aws_secret_access_key:wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```

**Note**: The tool also supports `s3://` URI format in the configuration file.

## Requirements

- Python 3.7+
- boto3
- tqdm

## Development

### Setup Development Environment

```bash
git clone https://github.com/yourusername/atlas-aws-autodownload.git
cd atlas-aws-autodownload
pip install -e ".[dev]"
```

### Run Tests

```bash
pytest
```

### Code Formatting

```bash
black atlas_aws_autodownload/
```

### Type Checking

```bash
mypy atlas_aws_autodownload/
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Contributing

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

## Support

If you encounter any issues or have questions, please:

1. Check the [Issues](https://github.com/yourusername/atlas-aws-autodownload/issues) page
2. Create a new issue if your problem isn't already reported
3. Contact the maintainers at your.email@example.com

## Changelog

### Version 1.0.0
- Initial release
- Basic S3 download functionality
- Configuration file support
- Command line interface
- Progress bars and logging
