Merge branch 'master' into requirements

This commit is contained in:
David Katsandres 2021-03-17 07:42:49 -07:00 committed by GitHub
commit 6b4959c189
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 10 deletions

View File

@ -50,11 +50,23 @@ Then run from the command line:
## Configuration ## Configuration
These are the configuration parameters for the program: These are the configuration parameters for the program:
- Canvas API URL - Canvas API URL - this is the URL of your institution, for example `https://example.instructure.com`
- Canvas API key - Canvas API key - this can be created by going to Canvas and navigating to `Account` > `Settings` > `Approved Integrations` > `New Access Token`
- Canvas User ID - Canvas User ID - this can be found at `https://example.instructure.com/api/v1/users/self` in the `id` field
- Directory in which to download course information to (will be created if not present) - Directory in which to download course information to (will be created if not present)
- List of Course IDs that should be skipped - List of Course IDs that should be skipped
### Loading credentials from a file
To avoid manually entering credentials every time you run the program, you can create a `credentials.yaml` file in the same directory as the script that has the following fields:
```yaml
API_URL: < URL of your institution >
API_KEY: < API Key from Canvas >
USER_ID: < User ID from Canvas >
```
You can then run the script as normal:
`python export.py`
# Contribute # Contribute
I would love to see this script's functionality expanded and improved! I welcome all pull requests :) Thank you! I would love to see this script's functionality expanded and improved! I welcome all pull requests :) Thank you!