S3 Bucket CLI

A simple Python CLI tool to upload, delete, restore, and view files in an S3 bucket.

1. Prerequisites

1. Python (3.8+ recommended)
2. pip (for installing Python packages)
3. AWS Account with permissions to access the S3 bucket (see AWS documentation for setting up IAM users, access keys, etc.)
4. (Optional) AWS CLI - not strictly required, but helpful for verification.

2. AWS Setup

• Log in to your AWS Console.
• Go to IAM (Identity and Access Management).
• Create (or use) a user with the AmazonS3FullAccess policy (or a custom policy that at least allows reading/writing to the S3 bucket in question).
• Generate Access Key ID and Secret Access Key for this user.

3. Local Environment Setup

1. Clone or download this repository.

2. Create a .env file (or use .env-example and rename it) in the project root with the following format:

   AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY_ID
   AWS_SECRET_ACCESS_KEY=YOUR_SECRET_ACCESS_KEY
   AWS_REGION=us-east-1
   S3_BUCKET_NAME=your-bucket-name
   LOCAL_BUCKET_PATH=bucket-path
   CLOUDFRONT_DISTRIBUTION_IDS=ID1,ID2
   

   Replace with your actual credentials and bucket name. Keep the .env file secret.

3. Install dependencies:

   pip install -r requirements.txt

4. Usage

From the command line in the same directory as bucket_cli.py, you can run:

• Upload a single file:

  python bucket_cli.py upload index.html

• Delete a single file:

  python bucket_cli.py delete index.html

• Upload all files in the local bucket folder:

  python bucket_cli.py upload .

• Download all bucket files into the local bucket folder:

  python bucket_cli.py restore .

Note: All bucket files will be in the LOCAL_BUCKET_PATH folder