Document changes and release 0.6.17

bash completion: make command list dynamic

Use "gbp --list-cmds" so we don't have to hardcode the available
commands and get support for the RPM ones as they show up.

Unify doc strings a bit

since they now show up with --list-cmds

Allow to list all available commands

gbp: add --version option

Closes: #758909

Improve error messages on formatting errors

Make it easier for the user to detect misformated replacement strings in
config files and command line options.

buildpackage: Make debian-tag message configurable

New config option --git-debian-tag-msg allows for the specification of
the message format string for signed debian-tags.

When left unset, the default debian-tag-msg format is still:

    %(pkg)s Debian release %(version)s

Signed-off-by: Kamal Mostafa <kamal@whence.com>

dch: Only modify the mainttrailer when --git-author is in use

Use better variable name

It's a boolean indicating wether we fetch the author information from
git not the author information itself.

Git-Dch: Ignore

Brown paper bag, please

Gbp-Dch: Ignore

Make sure we fixup the changelog trailer with newer devscripts

We don't change any mainttrailer options if already given.

Thanks: James McCoy for the detailed explanation
Closes: #740566

Document changes and release 0.6.16

Remove all other log handlers when capturing logs

This avoids spurious error messages during test runs.

linkeList: turn the bug printouts to debug level

We don't take any action anyway so no need to confuse users.

Introduce git-buildpackage-rpm

Currently only including "gbp import-srpm"

import-srpm: add 'vendor' config option

Intended to represent the distribution vendor (e.g. 'Debian').
Currently, this can be used in tag format strings.

NOTE: the vendor name is converted to lowercase when used in tag names.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Pass --no-pristine-tar to SRPM compnent tests

to avoid pristine-tar showing up in the matched branches

Introduce git-import-srpm tool

Initial version of the git-import-srpm: a tool for importing source
rpms.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>
Signed-off-by: Ed Bartosh <eduard.bartosh@intel.com>

Add gbp specific tempfile module

Minimal initial implementation that only adds tempdir parent directory
creation.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>
Signed-off-by: Olev Kartau <olev.kartau@intel.com>

Introduce rpm helpers

Implements a new gbp.rpm module that contains functionality for e.g.
parsing and editing spec files, reading src.rpm files rpm-specific
packaging policy etc.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>
Signed-off-by: Ed Bartosh <eduard.bartosh@intel.com>
Signed-off-by: Zhang Qiang <qiang.z.zhang@intel.com>
Signed-off-by: Huang Hao <hao.h.huang@intel.com>

Make pychecker happy

We don't use the class variable anywhere

UpstreamSource: move version guessing logic to PkgPolicy

PkgPolicy is more logical context, for example if guessing version from
a plain filename and not a real file.

Also, changes guess_version() to always return a tuple to simplify
checking its return value.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>
Conflicts:
gbp/pkg/__init__.py

Change UpstreamSource to have PkgPolicy

The UpstreamSource class now gets a PkgPolicy in it's initialization.
Also, introduces new DebiaUpstreamSource class which is taken in use in
the scripts.

The PkgPolicy is not yet used for anything in UpstreamSource.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

UpstreamSource.guess_version: don't check for directories

Directories are not recognized anyway, if guess_version() is called for
non-existent sources. And, parse_archive_filename() works fine for
directory names, too.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

UpstreamSource/guess_version: detect more compression formats

By utilizing the parse_archive_filename() function that detects e.g.
"alias suffixes" such as 'tgz'.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Fix typos

Move get_compression() out of pkg.PkgPolicy class

Renames the function to parse_archive_filename() and changes it's
return values. Filename parsing is merely generic functionality, not
tied to any packaging policy.

The function now returns the base name of the file (that is, filename
without, archive and compression extensions), archive format and
compression method. Adds supported archive formats 'tar' and 'zip' and
file extension aliases, e.g. 'tgz'.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: document common options in one place

Move the documentation of command line options common to all tools into
one file. This unifies the manpage documentation and should make its
maintenance easier. Also, this change adds missing options to several
manpages.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: cosmetic reformat of git-dch manpage sgml source

Makes the sgml source more readable. Fix indentation, tab to space, wrap
lines.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: cosmetic reformat of pq manpage sgml source

Makes the sgml source more readable. Fix indentation, tab to space, wrap
lines.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: cosmetic reformat of import-dsc manpage sgml source

Makes the sgml source more readable. Fix indentation, tab to space, wrap
lines.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: cosmetic reformat of import-orig manpage sgml source

Makes the sgml source more readable. Fix indentation, tab to space, wrap
lines.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: change option argument names to uppercase in buildpackage man

For the sake of consistency.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: cosmetic reformat of buildpackage manpage sgml source

In order to make the sgml source more readable. Fix indentation, tab to
space, wrap lines.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

buildpackage: Also print tag name when tagging the Debian release

Based on a patch by Kamal Mostafa

docs: more flexible version parsing in Makefile

Add dash to the list of valid version characters.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: document the --customizations option of gbp dch

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: document the --interactive option of gbp-import-orig

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: document the --git-[no-]submodules option

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: document the --color-scheme option

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: sgml syntax fix, add missing semicolons

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: reference buildpackage and pq in the gbp (supercommand) manpage

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: hyperlink references to other manpages

Change references to other gbp manpages to linked refs so that we get
hyperlinks in the html manpages.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: add some missing commas to manpages

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Document changes and release 0.6.15

Revert "Determine build_dir upfront"

This reverts commit b2549fac19f2d666552291a4fcf2020ca0570834.

Document changes and release 0.6.14

Improve error reporting on hooks

Make it obvious that a hook failed and not a gbp internal function

Improve error reporting on failed commands

Make it more clear if the command exited with non zero exit status.
Also don't report the command line twice.

Closes: #748248

Determine build_dir upfront

so it's available to all hooks

pq: Try harder to cleanup after a failed patch

If we fail to apply the patch the tree is left in a dirty state
so reset to the last head. This avoids irritating errors like:

gbp:error: Failed to apply 'debian/patches/poison+remember_trash': Failed to commit tree: fatal: invalid date format: 1998/03/21

following files would be overwritten by checkout:
doc/hosts.nntp.5
innd/art.c
innd/innd.h
innd/rc.c
Please, commit your changes or stash them before you can switch branches.
Aborting

Thanks: Marco d'Itri for the repo to debug this

pq: Print proper error message if we fail to apply the tree

e.g. instead of

gbp:error: Failed to apply 'debian/patches/poison+remember_trash'

we now have

gbp:error: Failed to apply 'debian/patches/poison+remember_trash': Failed to commit tree: fatal: invalid date format: 1998/03/21

Documnt that the patches must apply without fuzz

Fix comitter vs committer typos

Thanks: Sandro Tosi
Closes: #748339

Handle version format errors more gracefully

So far if a package claimed to be non native but the version number
didn't contain a '-' we failed like:

  Traceback (most recent call last):
    File "/usr/bin/gbp", line 9, in <module>
      load_entry_point('gbp==0.6.13', 'console_scripts', 'gbp')()
    File "/usr/lib/python2.7/dist-packages/gbp/scripts/supercommand.py", line 82, in supercommand
      return module.main(args)
    File "/usr/lib/python2.7/dist-packages/gbp/scripts/buildpackage.py", line 541, in main
      output_dir)
    File "/usr/lib/python2.7/dist-packages/gbp/scripts/buildpackage.py", line 96, in prepare_upstream_tarball
      upstream_tree = git_archive_build_orig(repo, cp, output_dir, options)
    File "/usr/lib/python2.7/dist-packages/gbp/scripts/buildpackage.py", line 270, in git_archive_build_orig
      upstream_tree = get_upstream_tree(repo, cp, options)
    File "/usr/lib/python2.7/dist-packages/gbp/scripts/buildpackage.py", line 245, in get_upstream_tree
      cp['Upstream-Version'])
    File "/usr/lib/python2.7/dist-packages/gbp/deb/git.py", line 107, in version_to_tag
      return format % dict(version=DebianGitRepository._sanitize_version(version))
    File "/usr/lib/python2.7/dist-packages/gbp/deb/git.py", line 122, in _sanitize_version
      return version.replace('~', '_').replace(':', '%')

It shouldn't be like that.

gbp pq: document --force

Slightly improve usage output

Document changes and release 0.6.13

config: add decorator to add_option_* functions

This allows us to build an internal list of valid options and print
these.

Import command not module

This matches the function name

docs: re-enable missing manpage

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Remove tests now covered by 18_test_Config

Revert "GitRepository/add_remote_repo: fix the 'tags' argument"

Which caused an unwanted behavior of not fetching refs/heads at all --
only tags were fetched.

This reverts commit 5dd598fb8f2a9109189fad6cf631811f12ce2130

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Add minimal 'config' command

This only allows to print single config values so far.

Closes: #733470

.gitignore: ignore editor backup files

Test option parser fallbacks more thoroughly

revealing another bug where we overwrote parsed values with defaults

Closes: #733759

Document changes and release 0.6.12

Use a much simpler version to fix the command name in --help

mostly reverting e1780f0.

Closes: #742907

Document changes and release 0.6.11

Fix command output

The first line lacked the subcommand like:

$ gbp pull --help
Usage: gbp [options] - safely update a repository from remote

instead of

$ gbp pull --help
Usage: gbp pull [options] - safely update a repository from remote
           ^^^^

ComponentTestBase: use regex matching in log checking

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

pq: minor log message typo fix

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Use a temporary directory

This avoids file name collisions and weired files in the working copy.

tests: more robust check for the default urgency level of dch

The dch tool might not report it's version if it is incorrectly
compiled. Create a dummy changelog and parse it "manually" to determine
the default urgency level.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

GitRepository/add_remote_repo: fix the 'tags' argument

Explicitly use --tags in git arguments - otherwise tags might not be
fetched.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

GitRepository/get_commit_info: correctly handle file renames/copies

Use the '--no-renames' git command line option in order to prevent two
filenames per entry.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

docs: add some missing sgml closing tags

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Fix config file name

Remove incorrect docs about multiple filter options

Closes: #718536

Request verbose output on bug reports

Document changes and release 0.6.10

git-import-dsc: Document --create-missing-branches

import_dsc: Create missing debian branch with --create-missing-branches

Closes: #739888

Remove cover-min-percentage

It makes running single tests harder than necessary since it requires
the percentage also when using "nose <testname>".

config: Don't pull in config defaults twice

This would otherwise overwrite values set in the legacy config sections.

Closes: #733759

config: Don't pull in config defaults twice

This would otherwise overwrite values set in the legacy config sections.

Closes: #733759

Update copyright notice

Git-Dch: Ignore

Document changes and release 0.6.9

docs: improve docs on using upstream's git repo

The documentation on using upstream's git directly instead of tarballs
was very terse. Add a step by step guide on how to get started and
how to update to new upstream versions.

import_orig: test error paths of find_source

tests: adapt dch tests for older devscripts

Determine the default urgency level by determining the version number of
the dch tool from command line.

Signed-off-by: Markus Lehtonen <markus.lehtonen@linux.intel.com>

Change the default of cleaner to /bin/true

Running a clean command within version control by default nowadays
causes more trouble than it helps. It's unnecessary with
pbuilder/cowbuilder/sbuild and with export-dir. So change the default
from 'debuild clean' to a noop ('/bin/true').

Closes: #670624

Make parsing config file sections symmetric

Always read the legacy command's config file section prior to the
subcommand's config file section.

Until now 'gbp <subcommand>' would read '[subcommand]' as well as
'[gbp-<subcommand>]' sections while 'gbp-<subcommand>' would only read
'[gbp-<subcommand>]' sections.

Closes: #733759

Avoid backtrace on config file parse errors

"gbp buildpackage" did this already but others didn't

Closes: #733759

Depend on newer devscripts

These contain a uscan that handles repackaging at the right level and
won't let us pick up the wrong tarball name.

Closes: #635920
Thanks: gregor herrmann and all others involved

Document changes and release 0.6.8

Determine changes file name based on dpkg-buildpackage options

Closes: #732678

Run nosetest on executables too

They're all well behaved and this allows us to use doctests in them

Adjust test cases to newer devscripts

Closes: #732384

No need to document --verbose

Properly document --help instead.

Thanks: Olivier Berger for pointing this out
Closes: #731149