You can download the Python package from Python Package Manager and run: pip3 install instructure-dap-client. You can find the available commands in the Project description of the package manager.

To run Canvas Data 2, users must have Python 3.8, 3.9, 3.10 and the PIP package manager installed.

You can store the client credentials (Client ID and Client Secret), and the API base URL as permanent environmental variables (more secure) on your machine, thus the CLI tool will automatically invoke those when using it.

To do so, open any command-line interface (terminal), navigate to your root folder and configure the environment variables:

 OSX

1. You need to edit the file containing the environment variables, which might be different depending on the shell type you are using.
2. For example, in case you use bash shell, in a terminal tab type open ~/.bash_profile. This will open the .bash_profile with your default text editor.
3. Add the environment variables to the file opened. In a new row, type:: export DAP_API_URL=https://api-gateway.instructure.com
4. In a new row, type: export DAP_CLIENT_ID='your_canvas_data_key'
5. In a new row, type: export DAP_CLIENT_SECRET='your_canvas_data_secret'
6. Some computers may require single or double quotes around the key and secret
7. Save the file
8. Restart your terminal
9. Type printenv and press enter to check all your environment variables.

WINDOWS

1. Guide to setting environment variables
2. Path will be DAP_API_URL, DAP_CLIENT_ID and DAP_CLIENT_SECRET.
3. Key will be the associated Canvas Data 2 Key and Secret values to those paths.

Other Resources

• A short video for setting the environment variables on Mac OSX is available.
• View a video of using the CLI tool with environment variables set