Tool that generates an ICS file from issues, milestones and iterations, of one or more GitLab projects. Only events with a due date are considered.
The script requires Python >= 3.6 and uses the libraries ics (Apache License v2.0) and python-gitlab (LGPL v3.0). You can install it from PyPi with the following command:
pip install gitcalendar
There are two options of running the script:
- Rename gitlab-config.ini.example to
gitlab-config.ini
and fit to your needs - Make sure that all wanted variables are given
- Make sure to declare your private token, a valid project or group id, and the path where your calendar files should be generated at.
Once this is done, you can run the script as follows:
gitcalendar --config <PATH OF YOUR CONFIG>
Warning! Please consider using the prior option for not leaking any access tokens
- Here, there's a need to declare the url of the gitlab instance, your private token, and at least one project or group id.
gitcalendar -u <URL> -t <PRIVATE TOKEN> -p <LIST OF PROJECT IDS> -g <LIST OF GROUP IDS>
For more options please use:
gitcalendar -h
After you cloned the repository and changed into it, you can perform the following actions.
Install with pip as follows:
pip install -e .[develop]
You can build a source package with the following command:
python setup.py sdist
You can build a wheel with the following command:
python setup.py bdist
Please see the CHANGELOG.md for notable changes.
Please see the CONTRIBUTING.md if you want to contribute.
Please see CONTRIBUTORS.md for further information about the contributors.
Please see LICENSE.md for further information about how the content is licensed.