deluge/docs/source/devguide/packaging/launchpad-recipe.md
Calum Lind 82ecf8a416 [Docs] Reorganise and add sections from wiki
- Change the layout and contents of docs to be better organised and
  follow ideas from: https://www.divio.com/blog/documentation/
- Use markdown for non-technical documents to speed up writing.
- Added new sections and imported documents from Trac wiki.

Build fixes:

- Added a patch to fix recommonmark 0.4 and doc referencing:
    https://github.com/rtfd/recommonmark/issues/93
- Set docs build in tox to Py2.7 since there are problems with autodoc
  mocking multiple inheritance on Python 3 resulting in metaclass errors.
- Supressed warning about `modules.rst` not in the toctree by creating
  a static `modules.rst` with `:orphan:` file directive and add to git.
  Also skip creating this toc file with sphinx-apidoc in setup and tox.
- Simplified finding exported RPC and JSON API methods by adding an
  autodoc custom class directive. Removed unneeded __rpcapi.py.
2018-11-01 17:38:10 +00:00

1.4 KiB

Launchpad recipe

The launchpad build recipes are for build from source automatically to provide ubuntu packages. They are used to create daily builds of a git repo branch.

Note these don't have the same control as a creating a publishing to PPA.

Main reference: https://help.launchpad.net/Packaging/SourceBuilds/Recipes

Deluge launchpad build recipes

Recipe configuration: https://code.launchpad.net/~deluge-team/+recipes

An example for building the develop branch:

# git-build-recipe format 0.4 deb-version 2.0.0.dev{revno}+{git-commit}+{time}
lp:deluge develop
nest-part packaging lp:~calumlind/+git/lp_deluge_deb debian debian develop

There are two parts, first to get the source code branch and then the debian files for building the package.

Testing and building locally

Create a deluge.recipe file with the contents from launchpad and create the build files with git-build-recipe:

git-build-recipe --allow-fallback-to-native deluge.recipe lp_build

Setup pbuilder and build the deluge package:

sudo pbuilder build lp_build/deluge*.dsc

Alternatively to build using local files with pdebuild:

cd lp_build/deluge/deluge
pdebuild

This will allow modifying the debian files to test changes to rules or control.