Metadata-Version: 2.1
Name: ghc-utils
Version: 0.1.0
Summary: utilies for github classroom
Home-page: https://github.com/aronwc/ghc_utils
Author: Aron C
Author-email: aronwc@gmail.com
License: GNU General Public License v3
Keywords: ghc_utils
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Requires-Dist: Click (==7.0)
Requires-Dist: github.py

# ghc-utils
utilities for interacting with github classroom

## Installation

`pip install ghc-utils`

## Usage

### grades

First, create a file named `students.txt` containing each student's github id, one per line.

To download all grades for an assignment named `assignment-01` from an organization name `myorg` and save it to `grades.csv`:

`ghc-utils grades -u <your_githubid> -p <your_github_password> -o <myorg> -a assignment-01 -s students.txt -g grades.csv`

```
ghc-utils grades --help
Usage: ghc-utils grades [OPTIONS]

  Download all grades for an assignment.

Options:
  -u, --username TEXT           your github username  [required]
  -p, --password TEXT           your github password  [required]
  -o, --organization TEXT       github organization name, e.g., tulane-
                                cmps2200  [required]
  -a, --assignment-prefix TEXT  assignment name prefix, e.g., assignment-01
                                [required]
  -s, --student-file PATH       text file with one student github id per line
                                [required]
  -g, --grade-file PATH         output csv file  [required]
  --help                        Show this message and exit.
```


# History

## 0.1.0 (2020-09-03)

- First release on PyPI.


