How stuyvesant-cs/ghtools works
ghtools is a command-line toolkit for replacing selected GitHub Classroom workflows: creating student assignment repositories, cloning those repositories locally, and managing organization users and team membership/access. The installed CLI and legacy scripts are parallel entry points to overlapping operations. Assignment creation and repository cloning are distinct workflows; organization and team administration are separate capability branches. Source excerpts establish several internal calls, while dispatch from the CLIs to command handlers is not shown in full, so those links are marked unverified.
Main entry points: ghtool.py Legacy CLI · cli.py Installed CLI · manage_repos.py Repository cloning · ghtool/manage_repos.py Repository cloning
Components 13
CLI entry points
- Legacy CLI
ghtool.py - Installed CLI
ghtool_project/src/ghtool/cli.py
Assignment workflows
- Assignment creation
create_assignment.py - Assignment creation
ghtool_project/src/ghtool/create_assignment.py
Organization and teams
- Organization users
manage_org.py - Organization users
ghtool_project/src/ghtool/manage_org.py - Team administration
manage_teams.py - Team administration
ghtool_project/src/ghtool/manage_teams.py
Repository cloning
- Repository cloning
manage_repos.py - Repository cloning
ghtool_project/src/ghtool/manage_repos.py
Other components
- Operator
- GitHub API
- Local Git
Connections 20
- Operator → Legacy CLI: runs
README.md - Operator → Installed CLI: runs
README.md - Legacy CLI → Assignment creation: dispatches
ghtool.py - Legacy CLI → Organization users: dispatches
ghtool.py - Legacy CLI → Team administration: dispatches
ghtool.py - Legacy CLI → Repository cloning: dispatches
ghtool.py - Installed CLI → Assignment creation: dispatches
ghtool_project/src/ghtool/cli.py - Installed CLI → Organization users: dispatches
ghtool_project/src/ghtool/cli.py - Installed CLI → Team administration: dispatches
ghtool_project/src/ghtool/cli.py - Installed CLI → Repository cloning: dispatches
ghtool_project/src/ghtool/cli.py - Assignment creation → GitHub API: creates and invites
create_assignment.py - Assignment creation → GitHub API: creates and invites
ghtool_project/src/ghtool/create_assignment.py - Organization users → GitHub API: invites users
manage_org.py - Organization users → GitHub API: invites users
ghtool_project/src/ghtool/manage_org.py - Team administration → GitHub API: manages teams
manage_teams.py - Team administration → GitHub API: manages teams
ghtool_project/src/ghtool/manage_teams.py - Repository cloning → GitHub API: lists repositories
manage_repos.py - Repository cloning → GitHub API: lists repositories
ghtool_project/src/ghtool/manage_repos.py - Repository cloning → Local Git: clones repositories
manage_repos.py - Repository cloning → Local Git: clones repositories
ghtool_project/src/ghtool/manage_repos.py