manage your student's homework

Description

assuming you have asked your students to create a repo on github to submit their homework, this script will help you efficiently clone/pull/merge all the repos in a folder, and display a summary of the status of all the repos

Installation

pip install collect-homework

Initial setup

create a folder where you want to clone all the repos
create a file named 00.ids in the folder
this file should contain the github ids of all the students, one id per line
at that point
```
collect-homework clone
```
will clone all the repos in the folder
in order to pull all the repos in the folder
```
collect-homework pull
```
you get the gist of it; type
```
 collect-homework help
```
to see all the available commands
of particular interest is the
```
collect-homework summary
```
command, which will display a one-line summary of all repos in the folder
finally you can focus on one or several students by typing e.g. (this makes sense for most commands)
```
collect-homework -s "JohnDoe JaneMartin" pull
```

handling repo names

assuming you run this command in a folder e.g. /Users/johndoe/python-homework:

then by default all the students are expected to have a repo named python-homework
if this does not match your setup, you can specify the repo name in the 00.reponame file
this one-line file should contain the name of all the repos, e.g. python-homework-2024
and if a student does not comply with that name, you can specify the repo name in the 00.ids file by writing student/the-repo instead of just student
(you can even put the complete github url instead if that's more convenient for you)

Metadata

Release files for collect-homework 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for collect-homework 0.5.0
File	Size	Uploaded
collect_homework-0.5.0.tar.gz	20.6 MB	Feb 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for collect-homework 0.5.0
File	Interpreter	ABI	Platform	Reset
collect_homework-0.5.0-py3-none-any.whl 8.1 kB Feb 11, 2026	Python 3	none	any	Details

Total release size: 20.6 MB

Release files / collect_homework-0.5.0.tar.gz

Download URL	collect_homework-0.5.0.tar.gz
Size	20.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`386f6ee94ad4c09a385e364bda03e1917449bfca1c49877d5038b3e0019de449`
BLAKE2b-256 checksum How to use checksums	`0ca04c2ac626d3ca2e22b623dac4963d99f4056100657cd5d462f635035f0c54`
Upload date	Feb 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.7`

Release files / collect_homework-0.5.0-py3-none-any.whl

Download URL	collect_homework-0.5.0-py3-none-any.whl
Size	8.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fd226abc2e91238ed8173c8c18552954f6b0826da3d88d04dc5f19cc82331217`
BLAKE2b-256 checksum How to use checksums	`dcb7b03c0c00270f4d3990c9a293c4a2ca26a7fafb883b77bb21ca64cb07d7cc`
Upload date	Feb 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.7`