diff --git a/CHANGELOG.md b/CHANGELOG.md index b28c2e45..14ed9f96 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -21,30 +21,30 @@ ### New Endpoint Coverage - Account Calendars (Thanks, [@dmols](https://github.com/dmols)) - - List available account calendars - - Get a single account calendar - - Update a calendar's visibility - - Update many calendars' visibility - - List all account calendars + - List available account calendars + - Get a single account calendar + - Update a calendar's visibility + - Update many calendars' visibility + - List all account calendars - Enrollments (Thanks, [@svanderwulp](https://github.com/svanderwulp)) - - Accept Course Invitation - - Reject Course Invitation + - Accept Course Invitation + - Reject Course Invitation - File (Thanks, [@bennettscience](https://github.com/bennettscience)) - - Update File + - Update File - JWTs (Thanks [@dmols](https://github.com/dmols)) - - Create JWTs - - Refresh JWTs + - Create JWTs + - Refresh JWTs - Moderation Grading (Moderation Set) - - List students selected for moderation - - Select students for moderation + - List students selected for moderation + - Select students for moderation - Query Course Events (Thanks, [@dmols](https://github.com/dmols)) - - Query by course - - Query by account + - Query by course + - Query by account - Rubrics (Thanks, [@bennettscience](https://github.com/bennettscience)) - - Create, Update, and Delete Rubric Assessments - - Create a Rubric Association + - Create, Update, and Delete Rubric Assessments + - Create a Rubric Association - Users - - Terminate all user sessions (Thanks, [@lucas-salas](https://github.com/lucas-salas)) + - Terminate all user sessions (Thanks, [@lucas-salas](https://github.com/lucas-salas)) ### General @@ -144,11 +144,11 @@ - Custom Gradebook Columns (Thanks,[@aileenpongnon](https://github.com/aileenpongnon)) - Files - - Resolve Path (Thanks,[@dsavransky](https://github.com/dsavransky)) + - Resolve Path (Thanks,[@dsavransky](https://github.com/dsavransky)) ### Bugfixes -- Fixed an issue where `Quiz.get_quiz_group` incorrectly set `course_id` to the quiz ID. (Thanks,[@hcolclou](https://github.com/hcolclou)) +- Fixed an issue where `Quiz.get_quiz_group` incorrectly set `course_id` to the quiz ID. (Thanks,[@hcolclou](https://github.com/hcolclou)) - Fixed an issue where `Course.create_external_tool` didn't accept `client_id` (LTI 1.3 support). - Fixed an issue where `Module.create_module_item` didn't (Thanks,[@aileenpongnon](https://github.com/aileenpongnon) and [@onomou](https://github.com/onomou)) - Fixed an issue where `Page.revert_to_revision` would incorrectly always set `group_id` to the page ID. Now correctly sets `group_id` or `course_id` appropriately. @@ -184,9 +184,9 @@ ### New Endpoint Coverage - Enrollment Terms - - Get a Single Enrollment Term (Thanks, [@lcamacho](https://github.com/lcamacho)) + - Get a Single Enrollment Term (Thanks, [@lcamacho](https://github.com/lcamacho)) - Files - - Resolve Path for Course (Thanks,[@dsavransky](https://github.com/dsavransky)) + - Resolve Path for Course (Thanks,[@dsavransky](https://github.com/dsavransky)) - GraphQL (Thanks,[@jonespm](https://github.com/jonespm)) - Late Policy (Thanks, [@kennygperez](https://github.com/kennygperez)) - Quiz Assignment Overrides (Thanks, [@kennygperez](https://github.com/kennygperez)) @@ -199,11 +199,11 @@ ### Deprecation Warnings - :warning: **_This is the final release with support for Python 2.7_** :warning: - - [Python 2.7 is end-of-life as of January 2020](https://www.python.org/doc/sunset-python-2/) - - Future releases of CanvasAPI will *NOT* support any version of Python 2 + - [Python 2.7 is end-of-life as of January 2020](https://www.python.org/doc/sunset-python-2/) + - Future releases of CanvasAPI will _NOT_ support any version of Python 2 - :warning: **_This is the final release with support for Python 3.4_** :warning: - - [Python 3.4 is end-of-life as of March 2019](https://www.python.org/downloads/release/python-3410/) - - Future releases of CanvasAPI will *NOT* support Python 3.4 or below + - [Python 3.4 is end-of-life as of March 2019](https://www.python.org/downloads/release/python-3410/) + - Future releases of CanvasAPI will _NOT_ support Python 3.4 or below - This is the final deprecation warning for all methods marked as deprecated in this changelog or in our documentation. They will be removed in the next release. ### Bugfixes @@ -222,7 +222,7 @@ - Assignment Extensions (Thanks, [@ljoks](https://github.com/ljoks)) - AssignmentGroup (Thanks, [@ctcuff](https://github.com/ctcuff)) - - List Assignments + - List Assignments - Authentications Log (Thanks, [@weining-li](https://github.com/weining-li)) - Brand Configs (Thanks, [@bennettscience](https://github.com/bennettscience)) - Comm Messages (Thanks, [@ljoks](https://github.com/ljoks)) @@ -256,30 +256,30 @@ ### New Endpoint Coverage - API Token scopes (Thanks, [@jrsilveti](https://github.com/jrsilveti)) - - List scopes + - List scopes - Account Notifications (Thanks, [@jrsilveti](https://github.com/jrsilveti)) - - Show a global notification - - Update a global notification + - Show a global notification + - Update a global notification - Account Reports (Thanks, [@jrsilveti](https://github.com/jrsilveti)) - - Start a report - - Status of a report - - Delete a report + - Start a report + - Status of a report + - Delete a report - Collaborations (Thanks, [@jrsilveti](https://github.com/jrsilveti)) - - List collaborations - - List members of a collaboration + - List collaborations + - List members of a collaboration - Feature Flags (Thanks, [@cat0698](https://github.com/cat0698)) - - List features - - List enabled features - - Get feature flag - - Set feature flag - - Remove feature flag + - List features + - List enabled features + - Get feature flag + - Set feature flag + - Remove feature flag - Rubric (Thanks, [@cat0698](https://github.com/cat0698)) - - Create a single rubric + - Create a single rubric ### General - Removed overzealous global enabling of `DeprecationWarning`. (Thanks, [@Screeeech](https://github.com/Screeeech)) - - *Note:* `DeprecationWarnings` are disabled by default, so you may need to run your code with `python -Wd` to see them. + - _Note:_ `DeprecationWarnings` are disabled by default, so you may need to run your code with `python -Wd` to see them. ## [0.13.0] - 2019-07-08 @@ -292,14 +292,14 @@ - Outcome Import (Thanks, [@jrsilveti](https://github.com/jrsilveti)) - Peer Reviews (Thanks, [@vutoan1245](https://github.com/vutoan1245)) - Planner (Thanks, [@weining-li](https://github.com/weining-li)) - - Planner - - Planner Notes - - Planner Overrides + - Planner + - Planner Notes + - Planner Overrides - Polls (Thanks, [@Goff-Davis](https://github.com/Goff-Davis)) - - Poll - - PollChoice - - PollSession - - PollSubmission + - Poll + - PollChoice + - PollSession + - PollSubmission - Quiz Submission Questions (Thanks, [@bradfordlynch](https://github.com/bradfordlynch)) ### General @@ -405,12 +405,12 @@ ### Deprecation Warnings - :warning: **_Dropped support for Python 3.3_** :warning: - - [Python 3.3 is end-of-life as of September 2017](https://www.python.org/dev/peps/pep-0398/#lifespan) - - Should continue to function in 3.3, but compatibility cannot be guaranteed going forward. + - [Python 3.3 is end-of-life as of September 2017](https://www.python.org/dev/peps/pep-0398/#lifespan) + - Should continue to function in 3.3, but compatibility cannot be guaranteed going forward. - Several methods in the `Course` and `Section` classes relating to assignments and submissions have been deprecated. - - Comparable methods have been implemented in the `Assignment` and `Submission` classes, as appropriate. - - The deprecated methods now include a warning in the documentation with reference to the replacement. Additionally, the deprecated methods will raise a `DeprecationWarning`. - - These methods will be removed in a future release. + - Comparable methods have been implemented in the `Assignment` and `Submission` classes, as appropriate. + - The deprecated methods now include a warning in the documentation with reference to the replacement. Additionally, the deprecated methods will raise a `DeprecationWarning`. + - These methods will be removed in a future release. - `Course.list_sections()` has been deprecated. Use `Course.get_sections()` instead. ### Bugfixes @@ -441,12 +441,12 @@ ### New Endpoint Coverage - Account - - Delete a sub account + - Delete a sub account - Grading Standards (Thanks, [@JonGuilbe](https://github.com/JonGuilbe)) - Notification Preferences (Thanks, [@a-goetz](https://github.com/a-goetz)) - - Update a preference - - Update preferences by category - - Update multiple preferences + - Update a preference + - Update preferences by category + - Update multiple preferences - Outcomes (Thanks, [@a-goetz](https://github.com/a-goetz)) - Quiz Question Groups (Thanks, [@JonGuilbe](https://github.com/JonGuilbe)) - Rubric (Thanks, [@sigurdurb](https://github.com/sigurdurb)) @@ -457,8 +457,8 @@ - For many endpoints that accept an "object id", either a CanvasAPI Object or integer ID can now be passed. (Thanks, [@a-goetz](https://github.com/a-goetz)) - Added a requester cache that remembers the last 5 requests to Canvas. It can be accessed as the attribute `_cache` of the `requester object`. (e.g. `course._requester._cache`) - Files can now be downloaded directly from the `File` object in one of two ways: (Thanks, [@DanBrink91](https://github.com/DanBrink91)) - 1. `get_contents` will directly return the contents of the file. (e.g. `file.get_contents()`) - 2. `download` will download the file and save it to the provided path. (e.g. `file.download('example.txt')`) + 1. `get_contents` will directly return the contents of the file. (e.g. `file.get_contents()`) + 2. `download` will download the file and save it to the provided path. (e.g. `file.download('example.txt')`) - Moved several methods exclusive to the API Key owner's user from the `User` class to a new class called `CurrentUser`. There is a new method in the `Canvas` class called `get_current_user` to access this object. (e.g. `canvas.get_current_user()`) (Thanks, [@DanBrink91](https://github.com/DanBrink91)) ### Bugfixes @@ -609,9 +609,9 @@ Huge thanks to [@liblit](https://github.com/liblit) for lots of issues, suggesti - Added contribution guide - Added Docker container for testing (e.g. with Jenkins) - Split requirements files into three: - - dev_requirements.txt - - tests_requirements.txt - - requirements.txt + - dev_requirements.txt + - tests_requirements.txt + - requirements.txt ### Bugfixes diff --git a/README.md b/README.md index df6d18e5..48555ded 100644 --- a/README.md +++ b/README.md @@ -13,19 +13,19 @@ CanvasAPI is a Python library for accessing Instructure’s [Canvas LMS API](htt ## Table of Contents -* [CanvasAPI](#canvasapi) - * [Table of Contents](#table-of-contents) - * [Installation](#installation) - * [Documentation](#documentation) - * [Contributing](#contributing) - * [Quickstart](#quickstart) - * [Working with Canvas Objects](#working-with-canvas-objects) - * [Course objects](#course-objects) - * [User objects](#user-objects) - * [Paginated Lists](#paginated-lists) - * [Keyword arguments](#keyword-arguments) - * [CanvasAPI Projects](#canvasapi-projects) - * [Contact Us](#contact-us) +- [CanvasAPI](#canvasapi) + - [Table of Contents](#table-of-contents) + - [Installation](#installation) + - [Documentation](#documentation) + - [Contributing](#contributing) + - [Quickstart](#quickstart) + - [Working with Canvas Objects](#working-with-canvas-objects) + - [Course objects](#course-objects) + - [User objects](#user-objects) + - [Paginated Lists](#paginated-lists) + - [Keyword arguments](#keyword-arguments) + - [CanvasAPI Projects](#canvasapi-projects) + - [Contact Us](#contact-us) ## Installation @@ -156,12 +156,12 @@ For a more detailed description of how CanvasAPI handles more complex keyword ar Since its initial release in June 2016, CanvasAPI has amassed over 100 [dependent repositories](https://github.com/ucfopen/canvasapi/network/dependents). Many of these include various tools used to enhance the Canvas experience for both instructors and students. Here are a few popular repositories that use CanvasAPI: -* [Canvas Grab](https://github.com/skyzh/canvas_grab) - * Canvas Grab is the most popular project using CanvasAPI. This tool, with one click, copies all files from Canvas LMS to local directory. CanvasAPI is used in this project to connect to a course and grab its files. -* [Clanvas](https://github.com/marklalor/clanvas) - * Clanvas is a command-line client for Canvas. It uses the already available bash commands plus some additional ones to interact with various features of Canvas from the commmand line. -* [CS221Bot](https://github.com/Person314159/cs221bot) - * CS221Bot is a Discord bot for the CPCS 221 course at University of British Columbia. CanvasAPI is used in this project to connect to and synchronize with a course and get its data, such as announcements, new assignments, and more. +- [Canvas Grab](https://github.com/skyzh/canvas_grab) + - Canvas Grab is the most popular project using CanvasAPI. This tool, with one click, copies all files from Canvas LMS to local directory. CanvasAPI is used in this project to connect to a course and grab its files. +- [Clanvas](https://github.com/marklalor/clanvas) + - Clanvas is a command-line client for Canvas. It uses the already available bash commands plus some additional ones to interact with various features of Canvas from the commmand line. +- [CS221Bot](https://github.com/Person314159/cs221bot) + - CS221Bot is a Discord bot for the CPCS 221 course at University of British Columbia. CanvasAPI is used in this project to connect to and synchronize with a course and get its data, such as announcements, new assignments, and more. If you have a project that uses CanvasAPI that you'd like to promote, please contact us! diff --git a/markdown-style.rb b/markdown-style.rb index defe4ef3..d232996b 100644 --- a/markdown-style.rb +++ b/markdown-style.rb @@ -6,4 +6,4 @@ rule 'no-trailing-punctuation', :punctuation => '.,;:!' rule 'ol-prefix', :style => 'ordered' -rule 'ul-indent', :indent => 4 +rule 'ul-indent', :indent => 2