Use gitlab-ci to build API documentation and run tests

This patch series

• builds API docs based on docstrings (tidying only a couple of doc strings that were generating errors; there is lots more that could be done to improve the docstrings and other documentation could be added too)
• enables the building of the API docs automatically, hosting them on pages.debian.net
• enables running the test suite
• moves the version string inside the module so that it is available to the documentation

Comments welcome!

added 14 commits

• ac7bfd97...7f4647d6 - 7 commits from branch python-debian-team:master
• 2d4e17d6 - Move version string into module
• f3f03ec0 - Generate documentation for API
• d3ac5f31 - Tweak rst formatting in existing docstrings
• db8c99dd - Experiment with gitlab pages
• c330afe8 - Experiment with CI tests
• f024b645 - Enable tests to be run from setup.py
• 36de7f88 - Add extra info on tests and docs

Compare with previous version

added 8 commits

• 4978ee52 - Ensure unittest2 is used for Python 2
• dc35ff7b - Move version string into module
• b2ab0385 - Generate documentation for API
• 7853f652 - Tweak rst formatting in existing docstrings
• 4e3d38f5 - Experiment with gitlab pages
• 2a210a22 - Experiment with CI tests
• 35c022c8 - Enable tests to be run from setup.py
• 95a6ba1c - Add extra info on tests and docs

Compare with previous version

added 2 commits

• 1111991b - Move existing docs into rst format
• dd8896b5 - Include API docs in changelog

Compare with previous version

added 12 commits

• ed66a1ea - Move changelog docs into code
• fbc7982f - Whitespace-only changes
• 32193d99 - Call super constructor in __init__
• 5757f79e - Whitespace chagnes
• a50c9ea5 - Fix use before initialise error
• 7323a412 - Don't reuse 'change' variable across scopes
• cf11403f - Don't shadow builtin 'file'
• 5177c654 - Adopt pythonic 'not in'
• f40cd51d - Fix man page name
• aa966ae4 - Extend documentation for constructors
• d85b65bd - Add convenience method for date formatting
• 5d7c5ac9 - Add example to documentation

Compare with previous version

added 19 commits

• d854b31e - Move existing docs into rst format
• 5cff019d - Include API docs in changelog
• 0fded25a - Move changelog docs into code
• f775e9e0 - Whitespace-only changes
• d45e6674 - Call super constructor in __init__
• e1e3e45a - Whitespace chagnes
• 553dc124 - Fix use before initialise error
• 321c9ef2 - Don't reuse 'change' variable across scopes
• f01d4468 - Don't shadow builtin 'file'
• 05addabe - Adopt pythonic 'not in'
• 5a4c8391 - Fix man page name
• 5f51d558 - Extend documentation for constructors
• f5839586 - Add convenience method for date formatting
• 41932185 - Add example to documentation
• 7cc9472c - Add headers to docs
• a5764eb8 - Move deb822 documentation into code
• 5b465271 - Move constructor docs to class
• 0b8c5541 - Add docstrings to deb822 classes
• d38579db - Typo fix in docstring

Compare with previous version

added 23 commits

• acbc5ec0 - Whitespace only changes
• ebd994fd - Suppress various pylint flags
• 7bb481f9 - Small changes to make pylint happier
• 3d1b4927 - Flag doc/code contraction in validate_input
• 90159b7c - Reorder imports
• 2a98bc3a - Avoid use of vars()
• 0b93bddc - Fix tab/space in debtags
• 334b06b7 - No-change polishing from pylint
• 50fc41cb - Don't shadow builtins
• 2037f8e2 - Bugfix facet_collection
• c48640ef - PEP8 whitespace changes
• e5a7a4a8 - Drop unused variables
• e28ad81a - Whitespace only changes
• 26e4da96 - Trivial changes from pylint
• b4325812 - Whitespace only changes
• 49e02696 - Whitespace only changes
• bb009b21 - Trivial changes from pylint
• 743f6119 - Silent pylint warnings
• 128f25e0 - Trivial changes suggested by pylint
• b3e7bd7d - Fix py3 breakages with pdiff handling
• c24da639 - Silence pylint warning on builtins
• c17e4287 - Add simple pylintrc to configure tags
• 129294a9 - Whitespace only changes PEP8

Compare with previous version

unmarked as a Work In Progress

merged