Skip to main content

groupify

groupify is a Python package for automatically creating random groups in the classroom from a classlist.

NOTE: there is currently no way to ensure that Newton and Leibniz are not in the same group. They must cooperate if necessary.

Installation

To install on Unix/Linux:

pip install groupify

To install in an IDE simply search for the package groupify and install it.

Basic examples

Example 1

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=4,
)

groupify.savefig(dirname="../figures/", fname="example_1.svg")

groupify.show()

This will generate the following groups (randomly):

example 1

Example 2

If some students are absent, you can specify them in the absent parameter to exclude them from the list of students before creating the groups.

import groupify

classlist = "sample_class.txt"

absent = [
    "Einstein",  # Busy dreaming about light
    "Feynman",  # Busy pick-locking government secrets
    "Hilbert",  # Busy trying to one-up Einstein on GR
    "Schrödinger",  # Uncertain if he's here or not – we'll exlude him to be sure
]

groupify.create(
    classlist=classlist,
    group_size=4,
    absent=absent,  # Removes them from the list before creating the groups
)

groupify.savefig(dirname="../figures/", fname="example_2.svg")

groupify.show()

This will generate the following groups (randomly):

example 2

Example 3

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=3,
)

groupify.savefig(dirname="../figures/", fname="example_3.svg")

groupify.show()

This will generate the following groups (randomly):

example 3

Example 4

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=2,
)

groupify.savefig(dirname="../figures/", fname="example_4.svg")

groupify.show()

This will generate the following groups (randomly):

example 4

Release files for groupify 0.1.19

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

Source distribution (sdist)

Source distribution for groupify 0.1.19
File Size Uploaded
groupify-0.1.19.tar.gz 5.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for groupify 0.1.19
File Interpreter ABI Platform
groupify-0.1.19-py3-none-any.whl Python 3 none any Details

Total release size: 11.6 kB

Release files / groupify-0.1.19.tar.gz

Download URL groupify-0.1.19.tar.gz
Size 5.5 kB
Tags Source
SHA-256 checksum
How to use checksums
7a2a4bc383f1acb782b8c3a4b0b115a750823e1e50d0e338ca75c59f232576f0
BLAKE2b-256 checksum
How to use checksums
0f218ca2403e0e923e4c7a75c04850a847fb0821d0c4c56630046a937c40a678
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / groupify-0.1.19-py3-none-any.whl

Download URL groupify-0.1.19-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41ad319a72325e4337b1c0cbc4b0bdaf64dcd88f82ea31c3227175cb6727ab30
BLAKE2b-256 checksum
How to use checksums
8349c249fccad38e752a88d2cedab9768b949b049c967501598583fdb9e860ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

0.1.19 This release

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page