Skip to main content

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:

  1. Check the 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atlas_aws_autodownload-1.0.0.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

atlas_aws_autodownload-1.0.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

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

Hashes for atlas_aws_autodownload-1.0.0.tar.gz
Algorithm Hash digest
SHA256 fa7c8bb54088c152358362382bd7e809987d5fd6f94b4ffbd9d001aac63daaf1
MD5 d4c13f9e77def858ada293773a9c58d9
BLAKE2b-256 372ec3fed43d5f1dac2500d4fb0815b5f496609b607be4a2787d6cb72ed7e8f6

See more details on using hashes here.

File details

Details for the file atlas_aws_autodownload-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for atlas_aws_autodownload-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dc8e13cf72f8646a47cf367f79ab9e151b9f4e082a8c397f487afff0e851dadb
MD5 b45e6fa58050dd077b3fbbe40f5dd7cc
BLAKE2b-256 5da724f4181a9e96cfbae59f337cfeb27083d491e9c605dc1fa5a1afa12d0fdf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page