A Python tool for downloading files from AWS S3 bucket with configuration file support
Project description
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)
pip install atlas-aws-autodownload
From Source
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:
atlas-aws-download config.txt -o ./downloads
Python API
from atlas_aws_autodownload import aws_download
aws_download("config.txt", "./downloads")
Configuration File Format
Create a configuration file with the following format:
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
git clone https://github.com/yourusername/atlas-aws-autodownload.git
cd atlas-aws-autodownload
pip install -e ".[dev]"
Run Tests
pytest
Code Formatting
black atlas_aws_autodownload/
Type Checking
mypy atlas_aws_autodownload/
License
This project is licensed under the MIT License - see the 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:
- Check the Issues page
- Create a new issue if your problem isn't already reported
- 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file atlas_aws_autodownload-1.0.0.tar.gz.
File metadata
- Download URL: atlas_aws_autodownload-1.0.0.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa7c8bb54088c152358362382bd7e809987d5fd6f94b4ffbd9d001aac63daaf1
|
|
| MD5 |
d4c13f9e77def858ada293773a9c58d9
|
|
| BLAKE2b-256 |
372ec3fed43d5f1dac2500d4fb0815b5f496609b607be4a2787d6cb72ed7e8f6
|
File details
Details for the file atlas_aws_autodownload-1.0.0-py3-none-any.whl.
File metadata
- Download URL: atlas_aws_autodownload-1.0.0-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dc8e13cf72f8646a47cf367f79ab9e151b9f4e082a8c397f487afff0e851dadb
|
|
| MD5 |
b45e6fa58050dd077b3fbbe40f5dd7cc
|
|
| BLAKE2b-256 |
5da724f4181a9e96cfbae59f337cfeb27083d491e9c605dc1fa5a1afa12d0fdf
|