glabs

glabs

Command line tool to manage GitLab repositories for student assignments.

This README is the quick entry point. The full user handbook lives in the docs folder.

Why glabs

• Create assignment repositories for students or groups
• Seed repositories from starter code or custom seeding tools
• Protect branches and set access rules at scale
• Generate URLs, clone repos, and build reports

Installation

Build from source

Prerequisite: Go 1.24+

go install github.com/obcode/glabs@latest

Build from local checkout

go install .

Quickstart

1) Create main config in your home directory

File: ~/.glabs.yaml

gitlab:
  host: https://gitlab.example.org
  token: <personal-access-token>

coursesfilepath: /absolute/path/to/course-configs
courses:
  - mpd
  - vss

2) Create one course file

Example: /absolute/path/to/course-configs/mpd.yaml

mpd:
  coursepath: mpd/semester
  semesterpath: ob-26ss

  blatt01:
    assignmentpath: blatt-01
    per: student
    startercode:
      url: git@gitlab.example.org:mpd/startercode/blatt-01.git
      fromBranch: template

3) Validate config and generate repos

glabs check mpd
glabs generate mpd blatt01

Common commands

glabs check <course>
glabs generate <course> <assignment> [groups...|students...]
glabs protect <course> <assignment> [groups...|students...]
glabs clone <course> <assignment> [groups...|students...]
glabs urls <course> <assignment> [groups...|students...]
glabs report <course> <assignment> [--html|--json]

User handbook

• Getting started: docs/getting-started.md
• Configuration reference: docs/configuration.md
• Workflows and recipes: docs/workflows.md
• Command reference: docs/commands.md
• Troubleshooting: docs/troubleshooting.md
• Advanced topics: docs/advanced.md

Contributing

Issues and pull requests are welcome.

License

MIT, see LICENSE.