glabs

README

glabs - GitLab-Labs

Manage GitLab for student labs from the command line

Configfiles

Main config file

Default: $HOME/.glabs.yml or whatever format viper can handle.

Contents:

gitlab:
  host: <URL of GitLab host>
  token: <personal access token>
groupsfilepath: <path where config files for groups are>
groups:
  - <basenames of groupfiles>

Example:

gitlab:
  host: https://gitlab.mydomain.nz
  token: abced871263876132jkd
groupsfilepath: $HOME/HM/labs/20WS
groups:
  - algdati
  - vss

Group config file

Contents:

<baseNameOfGroup>:
    group: <base group name>
    # if you want to generate directly in group, do not define semestergroup
    semestergroup: <subgroup of group used for this semester>
    students:
      <array of students account names>
    groups:
      <name of fst group>:
        <array of student in group>
      <name of snd group>:
        <array of student in group>
      ...
    <name of assignemnt>:
      group: <subgroup of semestergroup used for assignment>
      # also optional
      description: <project description> # optional
      per: <student|group> # generate per student (default) or per group
      startercode:
        url: <url to repo> # only via SSH atm
      # accesslevel should be guest, developer, reporter, maintainer
      # if not defined accesslevel is developer
      accesslevel: <accesslevel for students>

Example:

algdati:
  group: algdati
  semestergroup: semester/ob-20ws
  students:
    - olli
    - ob
    - obcode
  groups:
    grp01:
      - hugo
      - sandra
    grp02:
      - su
      - allen
  blatt0:
    group: blatt0
    per: group
    description: Blatt 0, Algorithmen und Datenstrukturen I, WS 20/21
    startercode:
      url: git@gitlab.lrz.de:algdati/startercode/startercodeBlatt1.git
    # accesslevel: developer # default

Usage

Manage GitLab for student assignments

Usage:
  glabs [command]

Available Commands:
  check       check group config
  generate    Generate repositories for each student.
  help        Help about any command
  show-config Show config of a group
  version     Print the version number of Glabs

Flags:
      --config string   config file (default is $HOME/.glabs.yml)
  -h, --help            help for glabs
  -v, --verbose         verbose output

Use "glabs [command] --help" for more information about a command.

Before generating check wheter all students exist or not using the command

glabs check [group]