Skip to main content

Efficiently manage github classroom assignments from the command line.

Project description

DOI

PyPI PyPI - Downloads codecov

Documentation Status Code style: black

Why ABC Classroom

Many of us teaching data science are using GitHub Classroom as a way to teach students both git and GitHub skills and also potentially collaboration skills that align with open source software development best practices. However there are many steps associated with using GitHub classroom to manage a class.

Abc-Classroom contains a suite of command-line utilities that make it easier to manage a class of students using GitHub classroom by:

  1. Making it easier to create template assignment directories that are directly connected to your classroom organization
  2. Making it easier to update those assignments and
  3. (still under development) making it easier to clone all student assignments for grading.

We are currently using nbgrader in our workflow and are thus building this tool out to support the use of nbgrader as well.

Install abc-classroom

abc-classroom is under significant development currently. We are occasionally pushing updates to pypi and plan to push it to conda-forge in the near future.

For now, install from PyPi using:

$ pip install abc-classroom

Or to get the most current updates, clone this repo and run:

$ pip install -e .

to install the development version.

Use Abc-classroom

Because this is a command line set of tools, you will need to ensure that abc-classroom is installed in the active environment that you are using for your class.

Active Maintainers / Developers

Leah Wasser Leah Wasser

How to Contribute

We welcome contributions to abc-classroom as we are developing it and beyond! Please be sure to check out our contributing guidelines for more information about submitting pull requests or changes to abc-classroom.

License & Citation

BSD-3

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

abc-classroom-0.0.12.tar.gz (21.6 kB view hashes)

Uploaded Source

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