Uploads CSV files to the Bucketeer service for processing.
First, ensure that you have Bash, cURL, Python 3.8+ and Pip installed on your system.
When that's done, clone the repository and follow the development instructions below (install script coming soon).
After it's installed, you can see the available options by running:
bucketeer_cli --help
Note that access to UCLA's Bucketeer service is limited to campus IP addresses, so off-campus users must connect to the VPN.
The SRC argument supports standard filename globbing rules. In other words, *.csv is a valid entry for the SRC argument.
There are limits to how many arguments can be sent to a command. This depends on your OS and its configuration. See this StackExchange post for more information.
Bucketeer CLI will ignore any files that do not end with .csv, so a command of bucketeer_cli *.* should be safe to run. Bucketeer CLI does not recursively search folders.
Bucketeer CLI creates a single log file in the working directory. There is no limit on how large this file can become, so the user is responsible for modifying or deleting it if it becomes too large.
It is recommended that developers create a virtual environment for local Python development. After cloning the repository, here's a quick way to get setup:
#!/bin/bash
python3 -m venv venv_bucketeer_cli
. venv_bucketeer_cli/bin/activate
pip install -e . black pytest
To run the tests:
pytest
Before pushing, make sure you format all the Python source files:
black *.py
To create a new release:
- Update the version number in
setup.py. - Push a new Git tag using the new version number:
#!/bin/bash NEW_VERSION=0.1.0 git tag -s $NEW_VERSION -m "Tagging \"$NEW_VERSION\" for release" git push origin $NEW_VERSION - Create a new release using the GitHub UI.
Feel free to use this project's issues queue to ask questions, make suggestions, or provide other feedback.