Metadata-Version: 2.4
Name: canvas-sak
Version: 1.0.8
Summary: Command‑line Swiss Army Knife for Canvas LMS
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: arrow==1.2.3
Requires-Dist: beautifulsoup4==4.12.2
Requires-Dist: canvasapi
Requires-Dist: certifi==2023.7.22
Requires-Dist: charset-normalizer==3.2.0
Requires-Dist: click==8.1.3
Requires-Dist: colorama==0.4.6
Requires-Dist: idna==3.4
Requires-Dist: lxml==4.9.3
Requires-Dist: Markdown==3.4.4
Requires-Dist: markdownify==0.11.6
Requires-Dist: mosspy==1.0.9
Requires-Dist: python-dateutil==2.8.2
Requires-Dist: pytz==2023.3
Requires-Dist: requests==2.28.2
Requires-Dist: six==1.16.0
Requires-Dist: soupsieve==2.4.1
Requires-Dist: urllib3==1.26.16
Dynamic: license-file

# canvas_sak - canvas Swiss-Army-Knife
a command-line python based tool for teachers who use canvas. 

you can download from Pypi.
just `pip install canvas-sak`.

you will need to grab a "token" from your canvas account. go to the canvas webpage -> click on Account in the upper left -> click Settings -> scroll down and click the New Access Token button. you will need to put the token in a configuration file. `canvas-sak help-me-setup` will tell you how and where to create that configuration file.

some of the major functions:

* code-similarity: download program submissions and run them through stanford MOSS.
* collect-reference-info: collect high level information about student for when they later ask for letters of recommendation.
* download-submissions: the the submissions of an assignment.
* download/upload-course-content: download and upload course content as markdown files for easily reusing past courses in a way that is easy to change.
* message-students: send a canvas messages to students from the commandline
* list/set-due-dates: list and set due dates for assignments all at once

# Ignore files pattern

* canvas_sak will search for ignore patterns from the canvas_sak configuration file in the [IGNORE] section.
* if there is a `canvas-sak-ignore.lst` file in the current directory, it will use patterns in that file as well.
* canvas_sak will avoid processing files that match the ignore patterns.
* the patterns are the same format at gitignore patterns.
