Command line tool for making classroom groups.
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
groupmaker
.gitignore
.style.yapf
LICENSE.txt
README.md
pytest.ini
setup.py
tox.ini

README.md

groupmaker

Command line tool for making classroom groups.

Students are grouped by who has worked together least frequently.

Usage

First, make a student file containing all of the students, one on each line.

Alice
Bob
Carmen

Then you can start making groups.

groupmaker [-n GROUP_SIZE] STUDENT_FILE

This will output a group file, with groups of students separated by a blank line.

Alice
Bob

Carmen

Those are your new groups!

If you want to make more groups taking into account historical pairings, keep around those group files and pass them in when you make new groups. New groups pair together people who have worked with each other least frequently in the past.

groupmaker [-n GROUP_SIZE] STUDENT_FILE [GROUPS_FILE [GROUPS_FILE ...]]

You can show a table of pairing frequencies before generating the new group with the verbose -v flag.