git-kahoot
Generate Kahoot quiz from commits in a git repository.
Installation
Requires Python 3.
pip install git-kahoot
Usage
Usage: git-kahoot [OPTIONS]
Generate a Kahoot quiz from commits in a git repository.
Options:
-d, --directory DIRECTORY path to git repository (default: current
directory) Specify this option multiple
times to use multiple repositories.
--since [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
only include commits since this date
--until [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
only include commits up until this date
-n, --count INTEGER RANGE number of questions (default: 20, max: 100)
-u, --username TEXT Kahoot user name [required]
-p, --password TEXT Kahoot password [required]
-t, --title TEXT title of the generated quiz (default: "Git
Commiter Quiz"
--help Show this message and exit.
Examples
Specify path to git repository using the -d option. Omitting this options will try to use the current directory.
git-kahoot --directory /my/repo
Multiple git repositories can be specfied. Commits will be selected in a round-robin fashion.
git-kahoot --directory /my/repo --directory /my/second-repo
Only include commits between a date range.
git-kahoot --directory /my/repo --since 2015-01-01 --until 2018-01-01
Set the title of the generated quiz and the number of questions.
git-kahoot --title "My glorious quiz" --count 10
Specify credentials for your Kahoot account. You will be prompted for these credentials if you omit them.
git-kahoot --username AzureDiamond --password hunter2
Development setup
Assuming Python 3, pip and virtualenv is installed, clone the repository, set up a virtualenv and install the package as editable.
git clone git@github.com:janerist/git-kahoot.git
cd git-kahoot
virtualenv -p python3 venv
. venv/bin/activate (Windows: venv/Scripts/activate)
pip install --editable .
git-kahoot
