Metadata-Version: 2.0
Name: canvasgrader
Version: 1.0.2
Summary: Simple grading interface with the Canvas API
Home-page: https://github.com/mterwill/canvasgrader
Author: Matthew Terwilliger
Author-email: matt+canvasgrader@terwilligers.com
License: MIT
Keywords: canvas learning management system lms grade grades grading
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: requests

canvasgrader
============

This package provides a simple interface with the Canvas grading API to
save you the hassle of dealing with the web gradebook.

Installation
------------

.. code:: bash

    pip install canvasgrader

Usage
-----

1. Generate a new Access Token at
   ``https://<canvas-installation>/profile/settings``
2. Grab your course ID from the web interface:
   ``https://<canvas-installation>/courses/<course-id>``
3. Choose a
   `key <https://canvas.instructure.com/doc/api/file.object_ids.html>`__
   by which you want to identify students

.. code:: python

    >>> from canvasgrader import CanvasGrader
    >>> api_key = 'your access token'
    >>> canvas_grader = CanvasGrader(api_key=api_key, base_uri='umich.instructure.com',
                                     course_id=85425, id_key='sis_login_id')
    >>> assignment_id = canvas_grader.create_assignment(name='Homework 01',
                                                        points_possible=4)
    >>> canvas_grader.grade_assignment(assignment_id, {
            'mterwil': 4,
        })

Alternatively, you may place the API key in a dotfile:

.. code:: bash

    $ echo "my api key" > ~/.canvasgrader
    $ chmod 600 ~/.canvasgrader


