Metadata-Version: 2.4
Name: teams-maker
Version: 0.0.1
Summary: Create random teams with funny names based on a list of participants
License-Expression: BSD-3-Clause
Author: Dimitri Merejkowsky
Author-email: dimitri@dmerej.info
Requires-Python: >= 3.12
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Project-URL: Repository, https://codeberg.org/your-tools/teams-maker
Description-Content-Type: text/markdown

# teams-maker

Create a list of teams with funny names from a list of participants

## Installation and usage

- Install [poetry](https://python-poetry.org/)
- Install required dependencies

```
poetry install
```

Put all the participants in a file, one per line, says in
`participants.txt`

Then run:

```
$ teams-maker participants --name-provider <PROVIDER> --team-size <TEAM_SIZE>
```

Where `<PROVIDER>` matches a file in the `teams_maker/name_providers` directory.

You'll get an output looking like this:

```text
 ---------- Team Almond ----------
Bailey
Peter
Randy
Ronald
Taylor
---------- Team Blue ----------
Christine
Jesse
Katherine
Melissa
Ryan
```

Note that some teams may have a little more or a little less than members
than `TEAM_SIZE`.

## Contributing

Before submitting a change, run the following commands:

```
poetry run invoke lint
poetry run pytest
```

