Skip to content

S3 Bucket Uploader

Usage

example_upload_s3_bucket.sh
python scripts/upload_s3_bucket.py [-h] -b BUCKET -p PREFIX -i INPUT_DIR [-r REGION]
Upload a directory to S3 bucket.

optional arguments:
  -h, --help            show this help message and exit
  -b BUCKET, --bucket BUCKET
                        S3 bucket name.
  -p PREFIX, --prefix PREFIX
                        S3 folder prefix.
  -i INPUT_DIR, --input_dir INPUT_DIR
                        Path to local directory to upload.
  -r REGION, --region REGION
                        AWS region name.

Example

example_upload_s3_bucket.sh
python scripts/upload_s3_bucket.py --bucket="my_bucket" --prefix="recordings/" --input_dir="uploads/"

scripts.upload_s3_bucket

parse_args(args)

Utility argument parser function for S3 bucket uploader.

Parameters:

Name Type Description Default
args List[str]

List of arguments.

required

Returns:

Type Description
argparse.Namespace

Objects with arguments values as attributes.

Source code in scripts/upload_s3_bucket.py
def parse_args(args: List[str]) -> argparse.Namespace:
    """
    Utility argument parser function for S3 bucket uploader.

    Args:
        args (List[str]):
            List of arguments.

    Returns:
        argparse.Namespace:
            Objects with arguments values as attributes.
    """
    parser = argparse.ArgumentParser(
        prog="python scripts/upload_s3_bucket.py",
        description="Upload a directory to S3 bucket.",
    )

    parser.add_argument(
        "-b", "--bucket", type=str, required=True, help="S3 bucket name."
    )
    parser.add_argument(
        "-p", "--prefix", type=str, required=True, help="S3 folder prefix."
    )
    parser.add_argument(
        "-i",
        "--input_dir",
        type=str,
        required=True,
        help="Path to local directory to upload.",
    )
    parser.add_argument(
        "-r",
        "--region",
        type=str,
        default="ap-southeast-1",
        help="AWS region name.",
    )
    return parser.parse_args(args)