Skip to main content

Add-on for zest.releaser for releasing qgis plugins

Project description


Add-on for zest.releaser for releasing QGIS plugins.

Zest.releaser can be extended, see its entrypoints documentation.

What we do:

  • We hook into the “release” step and create a zipfile with a version number and copy it to the current directory. You can scp it to a server afterwards.
  • In the “prerelease” and “postrelease” steps we change the version number in the (mandatory) QGIS metadata.txt file.

Note: a QGIS plugin doesn’t have a, so you’ll need to add a version.txt or version.rst or VERSION file so that zest.releaser recognizes the current directory as a releasable project and so that it can find the version number somewhere. Simply put the version number (“1.2”) by itself on the first line. A newline at the end is fine.


You’ll have to install it globally (or in a custom virtualenv) as qgis plugins normally don’t have a full python setup.

The plugin checks whether there’s a metadata.txt (lowercase) with a qgisMinimumVersion string inside it. If found, the plugin runs. Otherwise it stays out of the way. So it should be safe to install globally.


  • Reinout van Rees started this library.

Changelog of qgispluginreleaser

1.0 (2017-06-20)

  • Use the codecs package in conjunction with “utf8” to read and write files.

0.2 (2016-02-01)

  • Qgis expects zip filenames to use a dot as name/version separator instead of a dash. We now create the zipfile with a dot instead.

0.1 (2016-01-19)

  • Initial project structure created with nensskel.
  • Changing versions in metadata.txt in the prerelease/postrelease step.
  • Creating a zipfile (with version number in the filename) automatically in the release step. Note that you must answer “yes” to the “checkout a tag?” question.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for qgispluginreleaser, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size qgispluginreleaser-1.0.tar.gz (18.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page