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 gitcalendarThere are two options of running the script:
- Rename gitlab-config.ini.example to
gitlab-config.iniand 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 -hAfter 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 sdistYou can build a wheel with the following command:
python setup.py bdistPlease 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.