Team Formation - GitHubClassroomTestCMPUT229/manager GitHub Wiki

The manager supports the formation of teams on GitHub.

Forming Teams

Flag:

-t

Requirements:

File structure:

  • class/
    • class.txt
    • teams.txt
  • class.txt:
    • Format: <member>\n...<member>\n
  • teams.txt:
    • Format: team:\n<member>\n...\nteam:\n...

Call

classroom_manager.py <some_flags> -t <some_other_flags>

Outcome

  • The manager first parses the teams and class files to determine which students are on which teams.
  • The team definitions are stored locally as "team-defs.json" in the class/ directory.
  • Then it iterates over the teams, assigning them unique IDs within the organization and creates teams on GitHub.
  • Finally, it creates "team-defs.csv" which stores a team,team-member pair on each line.

Class Example:

<ID1>
<ID2>
...
<IDn>

Teams Example:

team:
<IDk>
...
<IDk+x>
team:
<IDm>
...
<IDm+y>

Notes:

  • Teams may be of variable length.
  • Teams may contain members of other teams.
  • Team members are listed in no particular order within the team file.
  • Students not members of any team default to being members of their own individual teams.
⚠️ **GitHub.com Fallback** ⚠️