diff options
| author | vin <git@vineetk.net> | 2024-01-16 15:23:35 -0500 |
|---|---|---|
| committer | vin <git@vineetk.net> | 2024-01-16 15:31:04 -0500 |
| commit | 9221051daefc9f8ee5ecf31a3f6974ee3965869c (patch) | |
| tree | 7f1ba66d121bbb7b45b0befe1a747e8fed657280 /README.md | |
| parent | 102a3ef5f38a1861a98c1a0b4c5a1643006cd663 (diff) | |
update readme to the current status of the project
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 41 |
1 files changed, 37 insertions, 4 deletions
| @@ -1,11 +1,39 @@ | |||
| 1 | # aplus command line utility | 1 | # A+Attendance CLI |
| 2 | 2 | ||
| 3 | This is an cli utility initially created for students at Florida Polytechnic University to submit their aplus codes. | 3 | This is a CLI utility initially created for students at Florida Polytechnic University to submit their A+ attendance codes, but can be used for other |
| 4 | In time, we intend to generalize this utility to all universities. | 4 | universities using Canvas and A+Attendance. |
| 5 | In the meantime however, any students from other universities wishing to use the utility may change the instance_url (the main URL you see before the / when you use Canvas) variables. | 5 | |
| 6 | ## Building/Installing | ||
| 7 | |||
| 8 | To compile this program, you need `go` installed as well as need to set two | ||
| 9 | environment variables in your shell's configuration file (like `~/.profile` or it's rc file) for your Canvas instance URL and your account's API key. | ||
| 10 | |||
| 11 | ### Getting an API key | ||
| 12 | |||
| 13 | When logged into your university's Canvas site, go to Account -> Settings -> New Access Token -> (give any name or expiration date) -> store the Token somewhere. | ||
| 14 | |||
| 15 | ### Setting the Environment Variables | ||
| 16 | |||
| 17 | In your shell's configuration file, add: | ||
| 18 | ```sh | ||
| 19 | export CANVAS_INSTANCE="https://youruniversityhere.instructure.com" | ||
| 20 | export CANVAS_API_KEY="the_canvas_access_token_you_stored_somewhere" | ||
| 21 | |||
| 22 | # below not needed if go is already setup | ||
| 23 | export GOPATH=$HOME/.local/go | ||
| 24 | export GOBIN=$GOPATH/bin | ||
| 25 | export PATH=$PATH:$GOBIN | ||
| 26 | ``` | ||
| 27 | |||
| 28 | ### Installing | ||
| 29 | |||
| 30 | Simply run `go install codeberg.org/flpolyaplus/aplus@latest`. | ||
| 6 | 31 | ||
| 7 | ## Usage | 32 | ## Usage |
| 8 | 33 | ||
| 34 | ### Show help message | ||
| 35 | `aplus --help` | ||
| 36 | |||
| 9 | ### List all courses and canvas course codes | 37 | ### List all courses and canvas course codes |
| 10 | `aplus --list-all` | 38 | `aplus --list-all` |
| 11 | 39 | ||
| @@ -15,6 +43,11 @@ In the meantime however, any students from other universities wishing to use the | |||
| 15 | ### Enter code for a specified course | 43 | ### Enter code for a specified course |
| 16 | `aplus --code <code> --course <canvas_course_number>` | 44 | `aplus --code <code> --course <canvas_course_number>` |
| 17 | 45 | ||
| 46 | If no course is specified, the code is tried on all active courses. | ||
| 47 | |||
| 48 | ### Show timetable for a specified course | ||
| 49 | `aplus --timetable --course <canvas_course_number>` | ||
| 50 | |||
| 18 | ## Mirrors | 51 | ## Mirrors |
| 19 | [Codeberg](https://codeberg.org/flpolyaplus/aplus/) | 52 | [Codeberg](https://codeberg.org/flpolyaplus/aplus/) |
| 20 | 53 | ||
