hulthe/boogrocha

CLI client for chalmers group room booking service

BooGroCha

A CLI client for chalmers' group room booking system.

Features

• Book group rooms
• Integration Chalmers booking system
• Save personal settings in config file
• List available bookings for selected time
• Delete bookings
• List bookings
• Relative times for bookings
• AUR package
• Rooms sorted base on user preferences
• Option to only show rooms from preferred campus
• Integrate with Chalmers Library booking system
• Book rooms in the Johanneberg Student Union building
• Prompt for password if not set

Installation

Compile from source

Requirements

• go (>= 1.12)
• $GOPATH/bin in $PATH

Steps

$ git clone https://github.com/williamleven/BooGroCha
$ cd BooGroCha/cmd/bgc
$ go install

AUR package

Usage

Book a room

Allows for booking rooms by showing the available rooms for the given date and time.

$ bgc book <date> <time>

• <date> can be either an absolute date (YYYYMMDD, YYMMDD) or a relative date (MMDD, DD, D, today, tomorrow, monday, tuesday ...)
• <time> can be either (HH:mm-HH:mm, HH-HH, H-H, H-HH, HH-H) or aliases like lunch

The book sub-command also takes the following optional flags:

• --cid <cid> to perform the book request with a specified cid
• --campus <campus> or -c <campus> to filter the available rooms by a specified campus. (Valid campuses are J, Johanneberg, L and Lindholmen. Note that these values are not case-sensitive)
• --size <size> or -s <size> to filter the available rooms by size and will only show the rooms that are big enough. (When a size is specified the list of available rooms will also show the capacity of each room)
• --room <room> or -r <room> to try to book a specified room (the name of the room is case-insensitive) instead of letting you choose one interactively from the list of available rooms.
• --message <message> or -m <message> to add a specific message to the booking instead of asking for it interactively.

List booked rooms

$ bgc list

Delete booked rooms

$ bgc delete

Configuration

Allows the user to set parameters in a config file.

Setting a variable

$ bgc config set <variable> <value>

• <variable> can for example be cid or pass
• <value> should be the value that you want to set the variable to (NOTE: when setting the password you will be prompted for input instead of setting it directly)

Clearing a variable

$ bgc config clear <variable>

• <variable> can for example be cid or pass

Showing a variable

$ bgc config get <variable>

• <variable> can for example be cid or campus (NOTE: You cannot show the pass variable this way)