A collection of release tools used for Koha
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Martin Renvoize a98a77c7dc
Embelish the README
1 year ago
bin Add commented lines to get_developers 1 year ago
descriptions some more proofreading fixes 9 years ago
etc More domain mappings 1 year ago
gitdm domain-map fixes 6 years ago
lib/Koha Companies domainmap update 1 year ago
reprepro Add example configuration for reprepro 9 years ago
sources.lists Add sources list for current Ubuntu release 8 years ago
templates Add manual contributors 4 years ago
README.md Embelish the README 1 year ago
announcement.eml.tt Add announcement e-mail template 9 years ago
announcement.html.tt Adding stable / major release differences 9 years ago
check_deps.sh Missed the usage line in check_deps.sh 9 years ago
debian.koha-community.org.gpg Use LXC for testing Koha installation 9 years ago
get_bugs.pl Bug 19123: Remove reference to the last release 4 years ago
get_commits.pl Fixing a nasty bug which cause commits to fail to apply 10 years ago
gitdm.config Add git statistics generation to release-tool.pl 9 years ago
httprecorder.pl Improve release test scripts 9 years ago
install-fresh.pl Improve release test scripts 9 years ago
koha-post-deploy.pl Fix licenses 9 years ago
push.sh Adding a simple shell script to handle pushing; this is very custom to my RMaint setup... modify to taste 10 years ago
release-tool.pl Fix bug # identification in get_bugs and install command for lxc 8 years ago
roll_release.sh Adding a branch parameter 10 years ago
test-release.sh Improve test release and sign tarball 9 years ago
update-bugzilla.pl Add script to update bugzilla to note bugs which are included in the latest release 9 years ago


Koha release tools

The release tools repository contains a collection of scripts to aid release mantainers and release managers in their tasks during their tenure in their respective roles.


Simply clone this repository on your development environment and copy the etc/user.example file to etc/user.yaml and update it to reflect your own details.


The most commonly used scripts can be found within the bin/ directory, but they are generally written to be run from within your koha source clone repository.


Used to check for new authors and update bugzilla prior to pushing your branch.

The script should be run from within your koha source directory.

~/release-tools/bin/koha-push updatebz ~/release-tools/bin/koha-push updatebz --range HASH..HEAD ~/release-tools/bin/koha-push updatebz --range HASH..HEAD

Upon execution it will walk through all commits that appear in your local branch but do not yet appear upstream. It will prompt you for author details if an unrecognised author/email combination is found within a commit and will update the tracked etc/dev_map.yaml and etc/sponsor_map.yaml files respectively. You should check the resultant diff before commiting and pushing an update to the release-tools repository. The script will then mark the relevant bugs as 'Pushed to X', add the relevant version to the versions released box and add your configured thankyou comment to the bug.


Used to build the release notes and report release information.

The script should be called from within your koha source directory.

~/release-tools/bin/koha-release v19.11.00..HEAD info ~/release-tools/bin/koha-release v19.11.00..HEAD notes ~/release-tools/bin/koha-release v19.11.00..HEAD notes --silent ~/release-tools/bin/koha-release v19.11.00..HEAD html misc/release_notes/release_notes_19_11_01.html

Upon execution it will walk through all commits in your given range and generate a set of release notes from their content sourcing data from the commits, bugzilla and the translation site. It will interactively ask you about author details should it find a commit with an unrecognised author, unless the --silent parameter is passed.

  • The notes command will output a markdown file.
  • The html command will read in the aforementioned markdown file and general an html file.


Used to pack and sign a release tar


This script will be deprecated soon. It is/was used to maintain the koha copy of docs/contributors.yaml and docs/history.txt.

Simply run the script from within your kohaclone and it will update the contributors.yaml file and produce a history_new.txt which you can use by comparison to update the history.txt.

Koha Logo