[[https://wiki.ubuntu.com/Novacut|Novacut Wiki Home]] > '''Release Process'''

''Note: if you have a Version Zero Dmedia library (created with Novacut 13.04 or earlier), you will have to [[http://www.youtube.com/watch?v=NOyEIab0E-U|upgrade your library to Version One.]]''

Novacut does monthly [[https://wiki.ubuntu.com/TimeBasedReleases|time-based releases]].  This forces us to keep our daily quality high, and never lets us go more than a month without delivering new code to our users.

We release on the last Thursday of the month (see the [[https://www.google.com/calendar/embed?src=5d2d5g9rta296p2dnan8hdcd94%40group.calendar.google.com|Novacut Calendar]]).  Our monthly development involves three tiers: automatic daily builds, a week long quality iteration with the pre-stable release builds, and finally the stable release.

We currently build packages for [[https://wiki.ubuntu.com/TrustyTahr/ReleaseNotes|Ubuntu 14.04 LTS]].

If you're interested in using a similar approach for your product, [[http://vimeo.com/groups/novacutartistdiaries/videos/34324748|this video shows how we do the last step of the release.]]

<<TableOfContents()>>

== Daily Builds ==

[[https://launchpad.net/~novacut/+archive/daily|ppa:novacut/daily]]

We do automated daily builds of all our components using [[https://help.launchpad.net/Packaging/SourceBuilds/Recipes|Launchpad Source Package Recipies]].  For example, here is the [[https://code.launchpad.net/~novacut/+recipe/novacut-daily|novacut-daily]] recipe.

We run our unit tests during the builds, and fail the build upon any test failure.  For an example of how to run your Python3 unit tests during a build, see the [[http://bazaar.launchpad.net/~dmedia/filestore/trunk/view/head:/debian/rules|debian/rules]] file that the [[https://launchpad.net/filestore|Dmedia FileStore]] uses.

If you have a checkout of any of our components from Launchpad, you can always run the unit tests from the source tree like this:

 {{{
./setup.py test
}}}

Please only use the Daily Builds PPA if you can tolerate some possibly serious bugs and want to help test things.

If you want to jump into day-to-day Novacut development, installing from the Daily Builds PPA is the first thing you should do, which you can do like this:

 {{{
sudo apt-add-repository ppa:novacut/daily
sudo apt-get update
sudo apt-get install novacut
}}}

== Pre-Stable Releases ==

[[https://launchpad.net/~novacut/+archive/pre-stable|ppa:novacut/pre-stable]]

The pre-stable release is made (roughly) one week before the stable release is due.  A branch from the release revision will be made for bug fixes if needed, but either way, development can immediately start in trunk for the next month's release.  So this isn't a freeze as much as a quality proccess.

The release builds differ from the daily builds in that they're built from a source code tarball rather than directly from the bzr trunk branches on Launchpad.  This week long pre-stable quality step was put in place to address 3 quality issues we had going directly from the daily builds to stable releases:

 1. Occasional Python packaging issues caused when a file was recently added to the branch but didn't get included in the source code release tarball

 2. Debian/Ubuntu packaging issues that caused problems when upgrading from the previous month's stable release

 3. Build lag meant API changes between the components could temporarily break the stable-releases PPA... now packages are copied from the Pre-Stable Releases PPA to Stable Releases PPA in one fell swoop, ensuring the needed versions all land at once

In general we recommend ''not'' adding the Pre-Stable Release PPA to your system because '''each month packages will be temporarily broken''' in this PPA as we stage the release. So if you add this PPA to help us test, you should then disable/remove this PPA till you help us test again the next month.

That said, this is how you add this PPA to help us test a staged release:

 {{{
sudo apt-add-repository ppa:novacut/pre-stable
sudo apt-get update
sudo apt-get dist-upgrade
}}}

And then do this to remove this PPA after you've helped us test:

 {{{
sudo rm /etc/apt/sources.list.d/novacut-pre-stable-precise.list
sudo apt-get update
}}}

The Pre-Stable Releases PPA is ultimately aimed at ''automated'' testing, so please use it with caution.


== Stable Releases ==

[[https://launchpad.net/~novacut/+archive/stable|ppa:novacut/stable]]

Please [[Novacut/HowToInstall|follow these instructions]] to install the Novacut stable release.

The Stable Releases PPA is meant to deliver high-quality, production-ready software to our users.  Of course, early in their development Novacut and Dmedia have only been interesting to developers, so the Stable Releases PPA has in reality been something of monthly developer preview release.

But as this starts to change, as Dmedia and Novacut become interesting for true production use, we need to raise the quality of what we deliver in the Stable Releases PPA.  We especially need to be vigilant about any issues that could cause data-loss for our users.  Having any of our apps temporarily broken because of bugs isn't something we want our users to face, but at least it's something we can fix in a timely manner.  But we can't fix data loss!