Skip to main content

Python bindings for the codePost API

Project description

codePost API Python SDK

Gitter chat Build Status Coverage Status

This package provides a Python library to conveniently access the codePost API from any application or script written in the Python language.

You can learn more about codePost, the best tool for educational code feedback, or check out the documentation for powerful, best-in-class REST API that this Python SDK allows you to control.

You can also dive in directly with the codePost API Python SDK cheatsheet.


This section provides a quick overview of how to install the library and getting started, for more complete information, you can reference our First Steps with the codePost API Python SDK.

  1. This codePost API Python SDK is available on the Python package manager PyPi, and can be installed from all usual sources, such as with pip:
    sudo pipenv install codepost
    You can also install the package just for your account (pip install --user codepost) or using a tool such as pipenv which will install the library in a virtual environment (pipenv install codepost).
  2. Once you've import the codepost package, you need to configure it with the API key you've obtained from your Settings page (for other means of setting the API key, read here):
    import codepost
  3. You can then directly access the codePost objects:
    course = codepost.course.list_available(name="CS101", period="Spring 2020")[0]
    assignment = course.assignments.by_name("Hello World")
    submissions = assignment.list_submissions()
    for submission in submissions:
        print("{student},{grade}", student="+".join(submission.students), grade=submission.grade)
    to print the grades of all submissions of the assignment "Hello World" of the course CS101 in Spring 2020.


The codePost API Python SDK is under active development. At this time, we are welcoming all issues, suggestions and feature requests. Please either post a GitHub issue on this repository, or join our Gitter channel to ask a question.

Running tests

To start developing, install pipenv, then install all dependencies (including development dependencies, with the flag --dev) for this project:

git clone
cd codepost-python
pipenv install --dev

Run all tests on all supported versions of Python which you have locally installed:

make test

Run all tests for a specific Python version (modify -e according to your Python target):

pipenv run tox -e py37

Run all tests in a single file for a specific Python version:

pipenv run tox -e py37 -- tests/util/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codepost-0.3.2.tar.gz (37.1 kB view hashes)

Uploaded Source

Built Distribution

codepost-0.3.2-py3-none-any.whl (50.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page