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.1.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.1-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file atlas_aws_autodownload-1.0.1.tar.gz.

File metadata

  • Download URL: atlas_aws_autodownload-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 d0f450a436f310b33cea09595b031b11442e2334e4ed6deb4494b1a9e2fd40f0
MD5 7c3efd016e7f6f4881d48b27bea7231e
BLAKE2b-256 9054bb32cad2a173e57f4f9d39a3270eee7338e3ac1c4f2e29a5b8533f735b6a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for atlas_aws_autodownload-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9a8e36428526c43bf1feb109a8b140ab47945b0f9830f19f38cf6c3118e083b3
MD5 94fb1e5da0349d06abe1d9c08b7a534d
BLAKE2b-256 a341fdd847593826a870de84b90dcf0ed7b07c0fe144b6ddc6a719b62c10311a

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