Metadata-Version: 2.1
Name: groupify
Version: 0.1.1
Summary: Automatically generates random groups from a class list.
Home-page: https://github.com/reneaas/groupify
Author: René Alexander Ask
Author-email: rene.ask@icloud.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: matplotlib
Requires-Dist: seaborn

# `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.

## Basic examples

### Example 1

```python
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](https://raw.githubusercontent.com/reneaas/groupify/refs/heads/main/examples/figures/example_1.svg)


### Example 2

```python
import groupify

classlist = "sample_class.txt"

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

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

groupify.show()
```

This will generate the following groups (randomly):

![example 2](https://raw.githubusercontent.com/reneaas/groupify/refs/heads/main/examples/figures/example_2.svg)



### Example 3

```python
import groupify

classlist = "sample_class.txt"

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

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

groupify.show()

```

This will generate the following groups (randomly):

![example 3](https://raw.githubusercontent.com/reneaas/groupify/refs/heads/main/examples/figures/example_3.svg)

