Skip to main content

A simple s3 analytics reporting tool

Project description


According to Wikipedia, Assarting is the act of clearing forested lands for use in agriculture or other purposes. In English land law, it was illegal to assart any part of a royal forest without permission.

In our case, assart is A simple S3 analytic reporting tool_

Note: This is an experimental project and the codebase is not yet ready for serious usage.

Getting started


Due to the experimental nature of the project, it is recommended that assart be installed into a virtual environment like so:

$ cd ~/venvs
$ python3 -m venv assartenv
$ source assartenv/bin/activate
$ pip install assart


assart utilizes the AWS Python SDK (boto3). By convention, boto3 sources your AWS credentials and default region from the following locations:

$ cat ~/.aws/credentials
aws_access_key_id = YOUR_AWS_ACCESS_KEY_ID
aws_secret_access_key = YOUR_AWS_SECRET_ACCESS_KEY

$ cat ~/.aws/config
region = us-east-1


$ assart -h
usage: assart [-h] [-u {KB,MB,GB}]

A simple S3 analytics reporting tool

optional arguments:
  -h, --help            show this help message and exit
  -u {KB,MB,GB}, --unit {KB,MB,GB}
                        Unit of Size


With your credentials configured, the program can be run like so:

$ assart

By default the program will output a list of the user's s3 buckets, and for each bucket will provide:

  • The Bucket name
  • The Creation date of the bucket
  • The Number of files in the bucket
  • The Total size of the files in the bucket
  • The Last modified date of the most recent file


The assart package is available under a permissive MIT License. Feedback and suggestions are welcome. The package can be built like so:

python sdist bdist_wheel

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

assart-0.2.0.tar.gz (3.2 kB view hashes)

Uploaded Source

Built Distribution

assart-0.2.0-py3-none-any.whl (4.2 kB view hashes)

Uploaded Python 3

Supported by

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