rotate-mob 0.1.0

Add your description here

Rotate

A CLI tool for mob programming rotations.

Usage

Create a rotation file template

5:00 / 5:00
Typing: Alice
Talking: Bob
Next: Charlie
Diana
Eva

Parse a rotation file to JSON

uv run parse.py < rotation.template

Convert JSON back to rotation file format

uv run parse.py < rotation.template | uv run parse.py format

Rotate the team

Move each team member up one position in the rotation, with the first person becoming last:

uv run rotate.py < rotation.template

You can chain multiple rotations:

uv run rotate.py < rotation.template | uv run rotate.py | uv run rotate.py

File Format

The rotation file format consists of:

1. First line: Timer in format elapsed / total where both values are in MM:SS format
2. Subsequent lines with colon: Position assignments in format Position: Name
3. Remaining lines: Team members without assigned positions

Requirements

• Python 3.12+
• uv package manager

Hooks

The rotate tool supports hooks that are executed when specific events occur:

1. Create a directory called .rotate/hooks/ in your project
2. Place executable scripts in this directory with names matching the event you want to hook into
3. Currently supported hooks:
   • expire: Executed when the timer expires or the daemon stops

Example hook script (.rotate/hooks/expire):

#!/bin/sh
# This hook opens the rotation file when the timer expires
echo "Opening rotation file..."
open rotation

Make sure to make your hook script executable:

chmod +x .rotate/hooks/expire