Upload to Unstable

mk-sbuild installs pkgbinarymangler into the schroot.  Of of the
provided tools in pkgbinarymangler is pkgmaintainermangler.
pkgmaintainermangler is disabled by default, and enabled with
configuration.

A difference between launchpad builds of a synced package and an sbuild
is that the maintainer information will be different.

Enable pkgmaintainermangler to close this difference.

.bzr-builddeb/default.conf

@@ -1,2 +0,0 @@
-[BUILDDEB]
-native = True

.bzrignore

@@ -1,9 +0,0 @@
-/.shelf/
-/build/
-/python-build-stamp-*
-/debian/files
-/debian/ubuntu-dev-tools/
-/debian/ubuntu-dev-tools.debhelper.log
-/debian/ubuntu-dev-tools.*.debhelper
-/debian/ubuntu-dev-tools.substvars
-ubuntu_dev_tools.egg-info

.gitignore

@@ -0,0 +1,2 @@
+__pycache__
+*.egg-info

.pylintrc

@@ -0,0 +1,65 @@
+[MASTER]
+
+# A comma-separated list of package or module names from where C extensions may
+# be loaded. Extensions are loading into the active Python interpreter and may
+# run arbitrary code.
+extension-pkg-allow-list=apt_pkg
+
+# Pickle collected data for later comparisons.
+persistent=no
+
+# Use all cpus, to speed up testing
+jobs=0
+
+
+[MESSAGES CONTROL]
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifiers separated by comma (,) or put this
+# option multiple times (only on the command line, not in the configuration
+# file where it should appear only once).You can also use "--disable=all" to
+# disable everything first and then reenable specific checks. For example, if
+# you want to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use"--disable=all --enable=classes
+# --disable=W"
+disable=fixme,locally-disabled,missing-docstring,useless-option-value,
+  # TODO: Fix all following disabled checks!
+  invalid-name,
+  consider-using-with,
+  too-many-arguments,
+  too-many-branches,
+  too-many-statements,
+  too-many-locals,
+  duplicate-code,
+  too-many-instance-attributes,
+  too-many-nested-blocks,
+  too-many-lines,
+
+
+[REPORTS]
+
+# Tells whether to display a full report or only the messages
+reports=no
+
+
+[FORMAT]
+
+# Maximum number of characters on a single line.
+max-line-length=99
+
+# String used as indentation unit. This is usually "    " (4 spaces) or "\t" (1
+# tab).
+indent-string='    '
+
+
+[BASIC]
+
+# Allow variables called e, f, lp
+good-names=i,j,k,ex,Run,_,e,f,lp,me,to
+
+
+[IMPORTS]
+
+# Force import order to recognize a module as part of a third party library.
+known-third-party=debian

404main

@@ -1,176 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-#
-# Copyright 2006-2007 (C) Pete Savage <petesavage@ubuntu.com>
-# Copyright 2007 (C) Siegfried-A. Gevatter <rainct@ubuntu.com>
-# Copyright 2009 (C) Canonical Ltd. (by Colin Watson <cjwatson@ubuntu.com>)
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; either version 2
-# of the License, or (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL for more details.
-#
-# ##################################################################
-#
-# This script is used to check if a package and all its build
-# dependencies are in main or not.
-
-import subprocess
-import sys
-
-import apt_pkg
-import apt
-
-def process_deps(cache, deps):
-    """Takes a list of (build) dependencies and processes it."""
-
-    for basedep in [d.or_dependencies[0] for d in deps]:
-        if not packages.has_key(basedep.name) and basedep.name != '':
-            # Check the (build) dependencies recursively
-            find_main(cache, basedep.name)
-
-
-def get_package_version(cache, distro, pack):
-    if pack not in cache:
-        return None
-    for version in (cache[pack].candidate, cache[pack].installed):
-        if not version:
-            continue
-        for origin in version.origins:
-            if origin.archive == distro:
-                return version
-    return None
-
-
-# Cache::CompTypeDeb isn't exposed via python-apt
-def comp_type_deb(op):
-    ops = ("", "<=", ">=", "<<", ">>", "=", "!=")
-    if (op & 15) < 7:
-        return ops[op & 15]
-    return ""
-
-
-def find_main(cache, pack):
-    """Searches the dependencies and build dependencies of a package recursively
-    to determine if they are all in the 'main' component or not."""
-
-    global packages
-
-    if pack in packages:
-        return
-
-    # Retrieve information about the package
-    version = get_package_version(cache, distro, pack)
-
-    if not version:
-        packages[pack] = False
-        return
-    elif [origin for origin in version.origins if origin.component == 'main']:
-        packages[pack] = True
-        return
-    else:
-        if not packages.has_key(pack):
-            packages[pack] = False
-
-        # Retrieve package dependencies
-        process_deps(cache, version.dependencies)
-
-        # Retrieve package build dependencies. There's no handy
-        # attribute on version for this, so unfortunately we have to
-        # do a lot of messing about with apt.
-        deps = []
-        src_records = apt_pkg.SourceRecords()
-        got_src = False
-        while src_records.lookup(version.source_name):
-            if pack in src_records.binaries:
-                got_src = True
-                break
-        if got_src:
-            # pylint: disable=E1101
-            for _, all_deps in src_records.build_depends.iteritems():
-                # pylint: enable=E1101
-                for or_deps in all_deps:
-                    base_deps = []
-                    for (name, ver, op) in or_deps:
-                        base_deps.append(apt.package.BaseDependency(name, op,
-                                                                    ver, False))
-                    deps.append(apt.package.Dependency(base_deps))
-
-        process_deps(cache, deps)
-
-def usage(exit_code):
-    print 'Usage: %s <package name> [<distribution>]' % sys.argv[0]
-    sys.exit(exit_code)
-
-def main():
-
-    global packages, distro
-
-    # Check if the amount of arguments is correct
-    if len(sys.argv) > 1 and sys.argv[1] in ('help', '-h', '--help'):
-        usage(0)
-
-    if len(sys.argv) < 2 or len(sys.argv) > 3:
-        usage(1)
-
-    cache = apt.cache.Cache()
-
-    if len(sys.argv) == 3 and sys.argv[2]:
-        distro = sys.argv[2]
-        if not get_package_version(cache, distro, 'bash'):
-            print '«%s» is not a valid distribution.' % distro
-            print ('Remember that for 404main to work with a certain '
-                   'distribution it must be in your /etc/apt/sources.list '
-                   'file.')
-            sys.exit(1)
-    else:
-        cmd = ['lsb_release', '-cs']
-        process = subprocess.Popen(cmd, stdout=subprocess.PIPE)
-        distro = process.stdout.read().strip('\n')
-
-    if not get_package_version(cache, distro, sys.argv[1]):
-        print 'Can\'t find package «%s» in distribution «%s».' % \
-              (sys.argv[1], distro)
-        sys.exit(1)
-
-    print 'Checking package «%s» in distribution «%s»...' % \
-          (sys.argv[1], distro)
-
-    find_main(cache, sys.argv[1])
-
-    # True if everything checked until the point is in main
-    all_in_main = True
-
-    for package in packages:
-        if not packages[package]:
-            if all_in_main:
-                print 'The following packages aren\'t in main:'
-                all_in_main = False
-            print '  ', package
-
-    if all_in_main:
-        print ('Package «%s» and all its dependencies and build dependencies '
-               'are in main.') % sys.argv[1]
-
-if __name__ == '__main__':
-
-    # Global variable to hold the status of all packages
-    packages = {}
-
-    # Global variable to hold the target distribution
-    distro = ''
-
-    try:
-        main()
-    except KeyboardInterrupt:
-        print 'Aborted.'
-        sys.exit(1)

README.updates

@@ -1,50 +1,54 @@
-Updating the ubuntu-dev-tools package in Ubuntu
------------------------------------------------
+Updating the ubuntu-dev-tools package
+-------------------------------------
 
-Here are the steps that are recommended to take when updating the
+Here are the 10 steps that are recommended to take when updating the
 ubuntu-dev-tools package in Ubuntu.
 
-1) Make sure that there are no new revisions to the package's trunk in Bazaar:
+1)  Make sure there are no new commits to the package's master branch in git:
 
-    bzr pull lp:ubuntu-dev-tools
+    git pull
 
-2) Check to make sure that all approved merges have been merged:
+2)  Check to make sure that all approved merges have been merged:
 
     https://code.launchpad.net/ubuntu-dev-tools/+activereviews
 
-3) Make sure that there is no low lying fruit that can be fixed at:
+3)  Make sure that there is no low lying fruit that can be fixed at:
 
     https://bugs.launchpad.net/ubuntu/+source/ubuntu-dev-tools
+    https://bugs.debian.org/src:ubuntu-dev-tools
 
-4) Before uploading the package change the UNRELEASED field in the
-   debian/changelog file to the current development release.
+4)  Check that the test suite passes
 
-   If there is no UNRELEASED entry, make sure that the version for the current
-   one has not been uploaded by someone else already:
+    setup.py test
 
+5)  Before uploading the package change the UNRELEASED field in the
+    debian/changelog file to unstable. (ubuntu-dev-tools is maintained in Debian
+    and synced to Ubuntu)
+
+    If there is no UNRELEASED entry, make sure that the version for the current
+    one has not been uploaded by someone else already:
+
+    https://tracker.debian.org/pkg/ubuntu-dev-tools
     https://launchpad.net/ubuntu/+source/ubuntu-dev-tools/+publishinghistory
 
-   Using: dch -r UNRELEASED - will also set the release to the development
-   version.
+6)  Once the target release has been changed, commit it to git (where X.YY is
+    the new package version):
 
-5) Once the target release has been changed, commit it to Bazaar (where X.YY is
-   the new package version):
+    git commit -a -m "Uploaded X.YY to RELEASE."
 
-    bzr commit -m "Uploaded X.YY to RELEASE."
+7)  Create the new source package and tag the new release in git:
 
-6) Tag the new release in Bazaar:
+    gbp buildpackage -S --git-tag
 
-    bzr tag X.YY
+    For a full list of tags, please see: 'git tag -l'.  This is so we can track
+    which git commit is in which release and makes bug triaging easier.
 
-   For a full list of tags, please see: 'bzr tags'. This is so we can track
-   which Bazaar revision is in which release and makes bug triaging easier.
+8)  Upload the package to Debian with dput as normal:
 
-7) Create the new source package:
+    dput ftp-master ubuntu-dev-tools_X.YY_$arch.changes
 
-    bzr bd -S
+9)  Create a new blank entry with dch -i and mark it as UNRELEASED.
 
-8) Upload the package to Ubuntu with dput as normal:
+10) After it's been dinstalled in Debian, sync to Ubuntu:
 
-    dput ubuntu ubuntu-dev-tools_X.YY_source.changes
-
-9) Create a new blank entry with dch -i and mark it as UNRELEASED.
+    syncpackage ubuntu-dev-tools

ack-sync

@@ -1,441 +0,0 @@
-#!/usr/bin/python
-#
-# Copyright (C) 2007, Canonical Ltd.
-# Copyright (C) 2010, Benjamin Drung <bdrung@ubuntu.com>
-# Copyright (C) 2010, Stefano Rivera <stefanor@ubuntu.com>
-#
-# It was initial written by Daniel Holbach.
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-
-import csv
-import getopt
-import lazr.restfulclient
-import os
-import re
-import subprocess
-import sys
-import logging
-import glob
-import fnmatch
-
-from launchpadlib.launchpad import Launchpad
-
-from ubuntutools.config import UDTConfig
-
-COMMAND_LINE_SYNTAX_ERROR = 1
-VERSION_DETECTION_FAILED = 2
-PRIVATE_USER_EMAIL = 3
-UPLOAD_NOT_PERMITTED = 4
-
-def get_version(title):
-    m = re.search("[() ][0-9][0-9a-zA-Z.:+-~]*", title)
-    if m is None:
-        print >> sys.stderr, ("Version could not be detected. Please specify "
-                              "it with -V.")
-        sys.exit(VERSION_DETECTION_FAILED)
-    return m.group(0).strip("() ")
-
-def strip_epoch(version):
-    parts = version.split(':')
-    if len(parts) > 1:
-        del parts[0]
-    version = ':'.join(parts)
-    return version
-
-def log_call(command):
-    command = map(str, command)
-    logging.info("Running %s", " ".join(command))
-    return command
-
-def get_source(package, version, section, dist, uploader_name, uploader_email,
-               bug, key, upload):
-    if os.path.isdir("/tmpfs"):
-        workdir = "/tmpfs/ack-sync"
-    else:
-        workdir = "/tmp/ack-sync"
-    if not os.path.isdir(workdir):
-        os.makedirs(workdir)
-    os.chdir(workdir)
-
-    cmd = ["syncpackage", package, "-r", dist, "-V", version, "-b", str(bug)]
-    if section is not None:
-        cmd += ["-c", section]
-    if uploader_email is not None:
-        cmd += ["-e", uploader_email]
-    if uploader_name is not None:
-        cmd += ["-n", uploader_name]
-    if not upload:
-        cmd += ['--dont-sign',]
-    if upload and key is not None:
-        cmd += ["-k", key]
-    subprocess.check_call(cmd)
-
-    dsc_file = package + "_" + strip_epoch(version) + "fakesync1.dsc"
-    if not os.path.exists(os.path.join(workdir, dsc_file)):
-        dsc_file = package + "_" + strip_epoch(version) + ".dsc"
-    if not os.path.exists(os.path.join(workdir, dsc_file)):
-        print >> sys.stderr, ("E: Failed to find .dsc file created by "
-                              "syncpackage.")
-        sys.exit(1)
-    return dsc_file
-
-def build_source(dist, dsc_file, pbuilder, sbuild):
-    try:
-        if sbuild:
-            cmd = ["sbuild", "-d", dist, "-A", dsc_file]
-            subprocess.check_call(log_call(cmd))
-        else:
-            if not os.path.isdir("buildresult"):
-                os.makedirs("buildresult")
-            cmd = ["sudo", "-E", "DIST=" + dist, pbuilder, "--build",
-                   "--buildresult", "buildresult", dsc_file]
-            subprocess.check_call(log_call(cmd))
-    except subprocess.CalledProcessError:
-        print >> sys.stderr, "E: %s failed to build." % (dsc_file)
-        sys.exit(1)
-
-def test_install(dist, dsc_file, sbuild, lvm):
-    changes_files = glob.glob(os.path.splitext(dsc_file)[0]+"_*.changes")
-    changes_file = ""
-
-    for temp_file in changes_files:
-        if not fnmatch.fnmatch(temp_file, '*_source.changes'):
-            changes_file = temp_file
-
-    if not (os.path.isfile(changes_file)): # if no file exists at all => exit
-        print >> sys.stderr, "E: No .changes file has been generated."
-        sys.exit(1)
-
-    try:
-        cmd = ["sudo", "piuparts", "-N", "-W", "--single-changes-list",
-               "--log-level=info", "--ignore=/var/log/apt/history.log",
-               "--mirror=http://archive.ubuntu.com/ubuntu main universe "
-               "restricted multiverse", changes_file]
-        if sbuild:
-            lvm_volume = lvm + "/" + dist + "_chroot"
-            subprocess.check_call(log_call(cmd + ["--lvm-volume="+lvm_volume]))
-        else:
-            subprocess.check_call(log_call(cmd + ["--pbuilder"]))
-    except subprocess.CalledProcessError:
-        print >> sys.stderr, "E: %s failed to install. Please check log" % \
-                             (changes_file)
-
-def get_email_from_file(name):
-    filename = os.path.expanduser("~/.ack-sync-email.list")
-    if os.path.isfile(filename):
-        csvfile = open(filename)
-        csv_reader = csv.reader(csvfile)
-        for row in csv_reader:
-            if row and row[0] == name:
-                return row[1]
-    return None
-
-def unsubscribe_sponsors(launchpad, bug):
-    us = launchpad.people['ubuntu-sponsors']
-    bug.unsubscribe(person=us)
-    print "ubuntu-sponsors unsubscribed"
-
-
-def ack_sync(bug_numbers, all_package, all_version, all_section, update,
-             all_uploader_email, key, upload, lpinstance, pbuilder, sbuild, lvm,
-             piuparts, verbose=False, silent=False):
-    launchpad = Launchpad.login_with("ubuntu-dev-tools", lpinstance)
-    # TODO: use release-info (once available)
-    series = launchpad.distributions["ubuntu"].current_series
-    dist = series.name
-
-    # update pbuilder
-    if update:
-        if sbuild:
-            subprocess.call(log_call(["sbuild-update", dist]))
-        else:
-            cmd = ["sudo", "-E", "DIST=" + dist, pbuilder, "--update"]
-            subprocess.call(log_call(cmd))
-
-    for bug_number in bug_numbers:
-        bug = launchpad.bugs[bug_number]
-        uploader = bug.owner
-        uploader_name = uploader.display_name
-        if all_uploader_email is not None:
-            uploader_email = all_uploader_email
-        elif launchpad.people['ubuntumembers'] in uploader.super_teams:
-            uploader_email = uploader.name + '@ubuntu.com'
-        else:
-            try:
-                uploader_email =  uploader.preferred_email_address.email
-            except ValueError:
-                uploader_email = get_email_from_file(uploader.name)
-                if uploader_email is None:
-                    if not silent:
-                        print >> sys.stderr, ("E: Bug owner '%s' does not have "
-                                              "a public email address. Specify "
-                                              "uploader with '-e'.") % \
-                                             (uploader_name)
-                    sys.exit(PRIVATE_USER_EMAIL)
-                elif not silent:
-                    print "Taking email address from local file: " + \
-                          uploader_email
-
-        # Try to find a Ubuntu bug task, against which the package is raised.
-        for t in bug.bug_tasks:
-            if t.bug_target_name.endswith(' (Ubuntu)'):
-                task = t
-                break
-        try:
-            print "Using Ubuntu bug task: %s" % task.bug_target_name
-        except NameError:
-            # We failed, use the first task (revert to previous behavior)
-            task = bug.bug_tasks[0]
-            print ("W: Could not find bug task for a Ubuntu package."
-                   "  Using task '%s'" % task.bug_target_name)
-
-        if all_package is not None:
-            package = all_package
-        else:
-            package = task.bug_target_name.split(" ")[0]
-            if package == "ubuntu":
-                words = bug.title.split(" ")
-                # no source package was defined. Guessing that the second or
-                # third word in the title is the package name, because most
-                # titles start with "Please sync <package>" or "Sync <package>"
-                if words[0].lower() == "please":
-                    package = words[2]
-                else:
-                    package = words[1]
-        if all_version is not None:
-            version = all_version
-        else:
-            version = get_version(bug.title)
-
-        src_pkg = series.getSourcePackage(name=package)
-        if src_pkg is None:
-            print "%s is NEW in %s." % (package, dist)
-        if src_pkg is not None:
-            # TODO: Port ack-sync to use lpapicache and reduce code-duplication.
-            can_upload = None
-            try:
-                series.main_archive.checkUpload(
-                    component=src_pkg.latest_published_component_name,
-                    distroseries=series, person=launchpad.me, pocket='Release',
-                    sourcepackagename=package)
-                can_upload = True
-            except lazr.restfulclient.errors.HTTPError, e:
-                if e.response.status == 403:
-                    can_upload = False
-                elif e.response.status == 400:
-                    print ("W: Package is probably not in Ubuntu. Can't check "
-                           "upload rights.")
-                    can_upload = True
-                else:
-                    raise e
-            if not can_upload:
-                print >> sys.stderr, ("E: Sorry, you are not allowed to upload "
-                                      'package "%s" to %s.' % (package, dist))
-                sys.exit(UPLOAD_NOT_PERMITTED)
-
-        if task.assignee == None:
-            task.assignee = launchpad.me
-            print "assigned me"
-            task.lp_save()
-        if task.assignee != launchpad.me:
-            print >> sys.stderr, ("E: %s is already assigned to "
-                                  "https://launchpad.net/bugs/%i") % \
-                                 (task.assignee.display_name, bug.id)
-            sys.exit(1)
-        old_status = task.status
-        task.status = 'In Progress'
-        unsubscribe_sponsors(launchpad, bug)
-        if task.importance == "Undecided":
-            task.importance = "Wishlist"
-            print "importance set to Wishlist"
-        task.lp_save()
-
-        print "package:", package
-        print "version:", version
-        dsc_file = get_source(package, version, all_section, dist,
-                              uploader_name, uploader_email, bug_number, key,
-                              upload)
-
-        if dsc_file.endswith('fakesync1.dsc'):
-            upload = True
-
-        # extract source
-        env = os.environ
-        env['DEB_VENDOR'] = 'Ubuntu'
-        subprocess.check_call(["dpkg-source", "-x", dsc_file], env=env)
-
-        build_source(dist, dsc_file, pbuilder, sbuild)
-
-        if piuparts:
-            test_install(dist, dsc_file, sbuild, lvm)
-
-        print bug.title
-        print '%s (was %s)' % (task.status, old_status)
-        print "Uploader:", uploader_name + " <" + uploader_email + ">"
-        if upload:
-            print ("Will upload sync directly, rather than subscribing "
-                   "ubuntu-archive")
-        try:
-            raw_input('Press [Enter] to continue or [Ctrl-C] to abort.')
-        except KeyboardInterrupt:
-            continue
-
-        bug.subscribe(person=launchpad.me)
-        print "subscribed me"
-        if upload:
-            task.status = 'Fix Committed'
-            task.assignee = None
-            print "unassigned me"
-            task.lp_save()
-            changes_file = dsc_file[:-4] + "_source.changes"
-            subprocess.check_call(["dput", "ubuntu", changes_file])
-        else:
-            task.status = 'Confirmed'
-            task.assignee = None
-            print "unassigned me"
-            task.lp_save()
-            cmd = ["dpkg-architecture", "-qDEB_BUILD_ARCH"]
-            process = subprocess.Popen(cmd, stdout=subprocess.PIPE)
-            architecture = process.communicate()[0].strip()
-            content = "%s %s builds on %s. Sync request ACK'd." % \
-                      (package, version, architecture)
-            bug.newMessage(content=content, subject="ack-sync")
-            bug.subscribe(person=launchpad.people['ubuntu-archive'])
-            print "subscribed ubuntu-archive"
-
-
-def usage():
-    print """ack-sync <bug numbers>
-
-  -e,                       specify uploader email address
-  -h, --help                displays this help
-  -k, --key                 key used to sign the package (in case of sponsoring)
-      --lpinstance=<instance> Launchpad instance to connect to
-                            (default: production)
-  -l, --lvm                 lvm root dev directory, used for sbuild and piuparts
-                            default is /dev/vg
-      --no-conf             Don't read config files or environment variables
-  -p, --package=<package>   set the package
-  -P, --with-piuparts       use piuparts to check the instalability
-      --section=<section>   Debian section (one of main, contrib, non-free)
-  -s, --silent              be more silent
-  -S, --with-sbuild         use sbuild instead of pbuilder
-  -C, --pbuilder=<command>  use <command> as pbuilder
-  -u, --update              updates pbuilder before building
-  -U, --upload              upload the sync immediately rather than ACK-ing it
-                            for the archive admins
-  -v, --verbose             be more verbosive
-  -V, --version=<version>   set the version"""
-
-def main():
-    try:
-        long_opts = ["help", "key=", "lvm=", "package=", "section=", "silent",
-                     "update", "upload", "verbose", "version=", "with-sbuild",
-                     "pbuilder=", "with-piuparts", "lpinstance=", "no-conf"]
-        opts, args = getopt.gnu_getopt(sys.argv[1:], "e:hk:p:PsSC:uUvV:",
-                                       long_opts)
-    except getopt.GetoptError, e:
-        # will print something like "option -a not recognized"
-        print >> sys.stderr, str(e)
-        sys.exit(COMMAND_LINE_SYNTAX_ERROR)
-
-    upload = False
-    package = None
-    sbuild = False
-    section = None
-    silent = False
-    update = False
-    uploader_email = None
-    verbose = False
-    version = None
-    piuparts = False
-    pbuilder = None
-    lvm = "/dev/vg"
-    key = None
-    lpinstance = None
-    no_conf = False
-
-    for o, a in opts:
-        if o in ("-h", "--help"):
-            usage()
-            sys.exit()
-        elif o in ("-e"):
-            uploader_email = a
-        elif o in ("-k", "--key"):
-            key = a
-        elif o in ("--lpinstance"):
-            lpinstance = a
-        elif o in ("-l", "--lvm"):
-            lvm = a
-        elif o in ("--no-conf"):
-            no_conf = True
-        elif o in ("-p", "--package"):
-            package = a
-        elif o in ("-P", "--with-piuparts"):
-            piuparts = True
-        elif o in ("--section"):
-            section = a
-        elif o in ("-s", "--silent"):
-            silent = True
-        elif o in ("-S", "--with-sbuild"):
-            sbuild = True
-        elif o in ("-C", "--pbuilder"):
-            pbuilder = a
-        elif o in ("-u", "--update"):
-            update = True
-        elif o in ("-U", "--upload"):
-            upload = True
-        elif o in ("-v", "--verbose"):
-            verbose = True
-        elif o in ("-V", "--version"):
-            version = a
-        else:
-            assert False, "unhandled option"
-
-    if len(args) == 0:
-        if not silent:
-            print >> sys.stderr, "E: You must specify at least one bug number."
-        sys.exit(COMMAND_LINE_SYNTAX_ERROR)
-
-    bug_numbers = []
-    for arg in args:
-        try:
-            number = int(arg)
-        except:
-            if not silent:
-                print >> sys.stderr, "E: '%s' is not a valid bug number." % arg
-            sys.exit(COMMAND_LINE_SYNTAX_ERROR)
-        bug_numbers.append(number)
-
-    config = UDTConfig(no_conf)
-    if lpinstance is None:
-        lpinstance = config.get_value('LPINSTANCE')
-    if pbuilder is None and not sbuild:
-        builder = config.get_value('BUILDER')
-        if builder == 'pbuilder':
-            pbuilder = 'pbuilder'
-        elif builder == 'sbuild':
-            sbuild = True
-        else:
-            print >> sys.stderr, "E: Unsupported build-system: %s" % builder
-            sys.exit(COMMAND_LINE_SYNTAX_ERROR)
-    if not update:
-        update = config.get_value('UPDATE_BUILDER', boolean=True)
-    #TODO: Support WORKDIR
-
-    ack_sync(bug_numbers, package, version, section, update, uploader_email,
-             key, upload, lpinstance, pbuilder, sbuild, lvm, piuparts, verbose,
-             silent)
-
-if __name__ == '__main__':
-    main()

backportpackage

@@ -1,8 +1,8 @@
-#!/usr/bin/python
+#!/usr/bin/python3
 # -*- coding: utf-8 -*-
 # ##################################################################
 #
-# Copyright (C) 2010, Evan Broder <evan@ebroder.net>
+# Copyright (C) 2010-2011, Evan Broder <evan@ebroder.net>
 # Copyright (C) 2010, Benjamin Drung <bdrung@ubuntu.com>
 #
 # This program is free software; you can redistribute it and/or
@@ -18,292 +18,478 @@
 #
 # ##################################################################
 
-import optparse
+import argparse
+import glob
 import os
 import shutil
 import subprocess
 import sys
 import tempfile
+from urllib.parse import quote
 
-from launchpadlib.launchpad import Launchpad
-import lsb_release
+try:
+    import lsb_release
+except ImportError:
+    lsb_release = None
+from distro_info import DebianDistroInfo, UbuntuDistroInfo
+from httplib2 import Http, HttpLib2Error
 
-from devscripts.logger import Logger
-
-from ubuntutools.archive import UbuntuSourcePackage, DownloadError
-from ubuntutools.config import UDTConfig, ubu_email
+from ubuntutools import getLogger
+from ubuntutools.archive import DebianSourcePackage, DownloadError, UbuntuSourcePackage
 from ubuntutools.builder import get_builder
+from ubuntutools.config import UDTConfig, ubu_email
+from ubuntutools.lp.lpapicache import (
+    Distribution,
+    Launchpad,
+    PackageNotFoundException,
+    SeriesNotFoundException,
+)
+from ubuntutools.misc import codename_to_distribution, system_distribution, vendor_to_distroinfo
 from ubuntutools.question import YesNoQuestion
 
-def error(msg):
-    Logger.error(msg)
+Logger = getLogger()
+
+
+def error(msg, *args):
+    Logger.error(msg, *args)
     sys.exit(1)
 
+
 def check_call(cmd, *args, **kwargs):
-    Logger.command(cmd)
+    Logger.debug(" ".join(cmd))
     ret = subprocess.call(cmd, *args, **kwargs)
     if ret != 0:
-        error('%s returned %d.' % (cmd[0], ret))
+        error("%s returned %d.", cmd[0], ret)
 
-def parse(args):
-    usage = 'Usage: %prog [options] <source package name or .dsc URL/file>'
-    parser = optparse.OptionParser(usage)
-    parser.add_option('-d', '--destination',
-                      dest='dest_releases',
-                      default=[],
-                      action='append',
-                      help='Backport to DEST release '
-                           '(default: current release)',
-                      metavar='DEST')
-    parser.add_option('-s', '--source',
-                      dest='source_release',
-                      default=None,
-                      help='Backport from SOURCE release '
-                           '(default: devel release)',
-                      metavar='SOURCE')
-    parser.add_option('-S', '--suffix',
-                      dest='suffix',
-                      default=None,
-                      help='Suffix to append to version number '
-                           '(default: ~ppa1)',
-                      metavar='SUFFIX')
-    parser.add_option('-b', '--build',
-                      dest='build',
-                      default=False,
-                      action='store_true',
-                      help='Build the package before uploading '
-                           '(default: %default)')
-    parser.add_option('-B', '--builder',
-                      dest='builder',
-                      default=None,
-                      help='Specify the package builder (default: pbuilder)',
-                      metavar='BUILDER')
-    parser.add_option('-U', '--update',
-                      dest='update',
-                      default=False,
-                      action='store_true',
-                      help='Update the build environment before '
-                           'attempting to build')
-    parser.add_option('-u', '--upload',
-                      dest='upload',
-                      help='Specify an upload destination',
-                      metavar='UPLOAD')
-    parser.add_option('-y', '--yes',
-                      dest='prompt',
-                      default=True,
-                      action='store_false',
-                      help='Do not prompt before uploading to a PPA')
-    parser.add_option('-v', '--version',
-                      dest='version',
-                      default=None,
-                      help='Package version to backport (or verify)',
-                      metavar='VERSION')
-    parser.add_option('-w', '--workdir',
-                      dest='workdir',
-                      default=None,
-                      help='Specify a working directory '
-                           '(default: temporary dir)',
-                      metavar='WORKDIR')
-    parser.add_option('-m', '--mirror',
-                      dest='ubuntu_mirror',
-                      default=None,
-                      help='Preferred Ubuntu mirror (default: Launchpad)',
-                      metavar='INSTANCE')
-    parser.add_option('-l', '--lpinstance',
-                      dest='lpinstance',
-                      default=None,
-                      help='Launchpad instance to connect to '
-                           '(default: production)',
-                      metavar='INSTANCE')
-    parser.add_option('--no-conf',
-                      dest='no_conf',
-                      default=False,
-                      help="Don't read config files or environment variables",
-                      action='store_true')
 
-    opts, args = parser.parse_args(args)
-    if len(args) != 1:
-        parser.error('You must specify a single source package or a .dsc '
-                     'URL/path.')
-    config = UDTConfig(opts.no_conf)
-    if opts.builder is None:
-        opts.builder = config.get_value('BUILDER')
-    if not opts.update:
-        opts.update = config.get_value('UPDATE_BUILDER', boolean=True)
-    if opts.workdir is None:
-        opts.workdir = config.get_value('WORKDIR')
-    if opts.lpinstance is None:
-        opts.lpinstance = config.get_value('LPINSTANCE')
-    if opts.ubuntu_mirror is None:
-        opts.ubuntu_mirror = config.get_value('UBUNTU_MIRROR')
-    if not opts.upload and not opts.workdir:
-        parser.error('Please specify either a working dir or an upload target!')
+def parse(argv):
+    usage = "%(prog)s [options] <source package name or .dsc URL/file>"
+    parser = argparse.ArgumentParser(usage=usage)
+    parser.add_argument(
+        "-d",
+        "--destination",
+        metavar="DEST",
+        dest="dest_releases",
+        default=[],
+        action="append",
+        help="Backport to DEST release (default: current release)",
+    )
+    parser.add_argument(
+        "-s",
+        "--source",
+        metavar="SOURCE",
+        dest="source_release",
+        help="Backport from SOURCE release (default: devel release)",
+    )
+    parser.add_argument(
+        "-S",
+        "--suffix",
+        metavar="SUFFIX",
+        help="Suffix to append to version number (default: ~ppa1 when uploading to a PPA)",
+    )
+    parser.add_argument(
+        "-e",
+        "--message",
+        metavar="MESSAGE",
+        default="No-change",
+        help='Changelog message to use instead of "No-change" '
+        "(default: No-change backport to DEST.)",
+    )
+    parser.add_argument(
+        "-b",
+        "--build",
+        default=False,
+        action="store_true",
+        help="Build the package before uploading (default: %(default)s)",
+    )
+    parser.add_argument(
+        "-B",
+        "--builder",
+        metavar="BUILDER",
+        help="Specify the package builder (default: pbuilder)",
+    )
+    parser.add_argument(
+        "-U",
+        "--update",
+        default=False,
+        action="store_true",
+        help="Update the build environment before attempting to build",
+    )
+    parser.add_argument("-u", "--upload", metavar="UPLOAD", help="Specify an upload destination")
+    parser.add_argument(
+        "-k", "--key", dest="keyid", help="Specify the key ID to be used for signing."
+    )
+    parser.add_argument(
+        "--dont-sign", dest="keyid", action="store_false", help="Do not sign the upload."
+    )
+    parser.add_argument(
+        "-y",
+        "--yes",
+        dest="prompt",
+        default=True,
+        action="store_false",
+        help="Do not prompt before uploading to a PPA",
+    )
+    parser.add_argument(
+        "-v", "--version", metavar="VERSION", help="Package version to backport (or verify)"
+    )
+    parser.add_argument(
+        "-w",
+        "--workdir",
+        metavar="WORKDIR",
+        help="Specify a working directory (default: temporary dir)",
+    )
+    parser.add_argument(
+        "-r",
+        "--release-pocket",
+        default=False,
+        action="store_true",
+        help="Target the release pocket in the .changes file. "
+        "Necessary (and default) for uploads to PPAs",
+    )
+    parser.add_argument(
+        "-c", "--close", metavar="BUG", help="Bug to close in the changelog entry."
+    )
+    parser.add_argument(
+        "-m", "--mirror", metavar="URL", help="Preferred mirror (default: Launchpad)"
+    )
+    parser.add_argument(
+        "-l",
+        "--lpinstance",
+        metavar="INSTANCE",
+        help="Launchpad instance to connect to (default: production)",
+    )
+    parser.add_argument(
+        "--no-conf",
+        default=False,
+        action="store_true",
+        help="Don't read config files or environment variables",
+    )
+    parser.add_argument("package_or_dsc", help=argparse.SUPPRESS)
 
-    return opts, args
+    args = parser.parse_args(argv)
+    config = UDTConfig(args.no_conf)
+    if args.builder is None:
+        args.builder = config.get_value("BUILDER")
+    if not args.update:
+        args.update = config.get_value("UPDATE_BUILDER", boolean=True)
+    if args.workdir is None:
+        args.workdir = config.get_value("WORKDIR")
+    if args.lpinstance is None:
+        args.lpinstance = config.get_value("LPINSTANCE")
+    if args.upload is None:
+        args.upload = config.get_value("UPLOAD")
+    if args.keyid is None:
+        args.keyid = config.get_value("KEYID")
+    if not args.upload and not args.workdir:
+        parser.error("Please specify either a working dir or an upload target!")
+    if args.upload and args.upload.startswith("ppa:"):
+        args.release_pocket = True
 
-def find_release_package(launchpad, package, version, source_release):
-    ubuntu = launchpad.distributions['ubuntu']
-    archive = ubuntu.main_archive
-    series = ubuntu.getSeries(name_or_version=source_release)
-    status = 'Published'
-    for pocket in ('Updates', 'Security', 'Release'):
-        try:
-            srcpkg = archive.getPublishedSources(source_name=package,
-                                                 distro_series=series,
-                                                 pocket=pocket,
-                                                 status=status,
-                                                 exact_match=True)[0]
-            break
-        except IndexError:
-            continue
+    return args, config
+
+
+def find_release_package(mirror, workdir, package, version, source_release, config):
+    srcpkg = None
+
+    if source_release:
+        distribution = codename_to_distribution(source_release)
+        if not distribution:
+            error("Unknown release codename %s", source_release)
+        info = vendor_to_distroinfo(distribution)()
+        source_release = info.codename(source_release, default=source_release)
     else:
-        error('Unable to find package %s in release %s.' %
-              (package, source_release))
+        distribution = system_distribution()
+    mirrors = [mirror] if mirror else []
 
-    if version and version != srcpkg.source_package_version:
-        error('Requested backport of version %s but %s is at version %s.' %
-              (version, package, srcpkg.source_package_version))
+    mirrors.append(config.get_value(f"{distribution.upper()}_MIRROR"))
+
+    if not version:
+        archive = Distribution(distribution.lower()).getArchive()
+        try:
+            spph = archive.getSourcePackage(package, source_release)
+        except (SeriesNotFoundException, PackageNotFoundException) as e:
+            error("%s", str(e))
+        version = spph.getVersion()
+
+    if distribution == "Debian":
+        srcpkg = DebianSourcePackage(package, version, workdir=workdir, mirrors=mirrors)
+    elif distribution == "Ubuntu":
+        srcpkg = UbuntuSourcePackage(package, version, workdir=workdir, mirrors=mirrors)
 
     return srcpkg
 
-def find_package(launchpad, mirror, workdir, package, version, source_release):
+
+def find_package(mirror, workdir, package, version, source_release, config):
     "Returns the SourcePackage"
-    if package.endswith('.dsc'):
-        return UbuntuSourcePackage(version=version, dscfile=package,
-                                   workdir=workdir, lp=launchpad,
-                                   mirrors=[mirror])
+    if package.endswith(".dsc"):
+        # Here we are using UbuntuSourcePackage just because we don't have any
+        # "general" class that is safely instantiable (as SourcePackage is an
+        # abstract class).  None of the distribution-specific details within
+        # UbuntuSourcePackage is relevant for this use case.
+        return UbuntuSourcePackage(
+            version=version, dscfile=package, workdir=workdir, mirrors=(mirror,)
+        )
 
     if not source_release and not version:
-        source_release = launchpad.distributions['ubuntu'].current_series.name
+        info = vendor_to_distroinfo(system_distribution())
+        source_release = info().devel()
 
-    component = None
-    # If source_release is specified, then version is just for verification
-    if source_release:
-        srcpkg = find_release_package(launchpad, package, version,
-                                      source_release)
-        version = srcpkg.source_package_version
-        component = srcpkg.component_name
+    srcpkg = find_release_package(mirror, workdir, package, version, source_release, config)
+    if version and srcpkg.version != version:
+        error(
+            "Requested backport of version %s but version of %s in %s is %s",
+            version,
+            package,
+            source_release,
+            srcpkg.version,
+        )
+
+    return srcpkg
 
-    return UbuntuSourcePackage(package, version, component, workdir=workdir,
-                               lp=launchpad, mirrors=[mirror])
 
 def get_backport_version(version, suffix, upload, release):
-    backport_version = version + ('~%s1' % release)
+    distribution = codename_to_distribution(release)
+    if not distribution:
+        error("Unknown release codename %s", release)
+    if distribution == "Debian":
+        debian_distro_info = DebianDistroInfo()
+        debian_codenames = debian_distro_info.supported()
+        if release in debian_codenames:
+            release_version = debian_distro_info.version(release)
+            if not release_version:
+                error("Can't find the release version for %s", release)
+            backport_version = f"{version}~bpo{release_version}+1"
+        else:
+            error("%s is not a supported release (%s)", release, debian_codenames)
+    elif distribution == "Ubuntu":
+        series = Distribution(distribution.lower()).getSeries(name_or_version=release)
+
+        backport_version = f"{version}~bpo{series.version}.1"
+    else:
+        error("Unknown distribution «%s» for release «%s»", distribution, release)
     if suffix is not None:
         backport_version += suffix
-    elif upload and upload.startswith('ppa:'):
-        backport_version += '~ppa1'
+    elif upload and upload.startswith("ppa:"):
+        backport_version += "~ppa1"
     return backport_version
 
-def get_backport_dist(upload, release):
-    if not upload or upload == 'ubuntu':
-        return '%s-backports' % release
-    else:
+
+def get_old_version(source, release):
+    try:
+        distribution = codename_to_distribution(release)
+        archive = Distribution(distribution.lower()).getArchive()
+        pkg = archive.getSourcePackage(
+            source, release, ("Release", "Security", "Updates", "Proposed", "Backports")
+        )
+        return pkg.getVersion()
+    except (SeriesNotFoundException, PackageNotFoundException):
+        pass
+    return None
+
+
+def get_backport_dist(release, release_pocket):
+    if release_pocket:
         return release
+    return f"{release}-backports"
+
 
 def do_build(workdir, dsc, release, builder, update):
     builder = get_builder(builder)
     if not builder:
-        return
+        return None
 
     if update:
         if 0 != builder.update(release):
             sys.exit(1)
 
-    return builder.build(os.path.join(workdir, dsc),
-                         release,
-                         os.path.join(workdir, "buildresult"))
+    # builder.build is going to chdir to buildresult:
+    workdir = os.path.realpath(workdir)
+    return builder.build(os.path.join(workdir, dsc), release, os.path.join(workdir, "buildresult"))
+
 
 def do_upload(workdir, package, bp_version, changes, upload, prompt):
-    print 'Please check %s %s in file://%s carefully!' % \
-          (package, bp_version, workdir)
-    if prompt or upload == 'ubuntu':
-        question = 'Do you want to upload the package to %s' % upload
+    print(f"Please check {package} {bp_version} in file://{workdir} carefully!")
+    if prompt or upload == "ubuntu":
+        question = f"Do you want to upload the package to {upload}"
         answer = YesNoQuestion().ask(question, "yes")
         if answer == "no":
             return
 
-    check_call(['dput', upload, changes], cwd=workdir)
+    check_call(["dput", upload, changes], cwd=workdir)
 
-def do_backport(workdir, pkg, suffix, release, build, builder, update, upload,
-                prompt):
-    dirname = '%s-%s' % (pkg.source, release)
-    pkg.unpack(dirname)
+
+def orig_needed(upload, workdir, pkg):
+    """Avoid a -sa if possible"""
+    if not upload or not upload.startswith("ppa:"):
+        return True
+    ppa = upload.split(":", 1)[1]
+    user, ppa = ppa.split("/", 1)
+
+    version = pkg.version.upstream_version
+
+    http = Http()
+    for filename in glob.glob(os.path.join(workdir, f"{pkg.source}_{version}.orig*")):
+        url = (
+            f"https://launchpad.net/~{quote(user)}/+archive/{quote(ppa)}/+sourcefiles"
+            f"/{quote(pkg.source)}/{quote(pkg.version.full_version)}"
+            f"/{quote(os.path.basename(filename))}"
+        )
+        try:
+            headers = http.request(url, "HEAD")[0]
+            if headers.status != 200 or not headers["content-location"].startswith(
+                "https://launchpadlibrarian.net"
+            ):
+                return True
+        except HttpLib2Error as e:
+            Logger.debug(e)
+            return True
+    return False
+
+
+def do_backport(
+    workdir,
+    pkg,
+    suffix,
+    message,
+    close,
+    release,
+    release_pocket,
+    build,
+    builder,
+    update,
+    upload,
+    keyid,
+    prompt,
+):
+    dirname = f"{pkg.source}-{release}"
     srcdir = os.path.join(workdir, dirname)
 
-    bp_version = get_backport_version(pkg.version.full_version, suffix,
-                                      upload, release)
-    bp_dist = get_backport_dist(upload, release)
+    if os.path.exists(srcdir):
+        question = f"Working directory {srcdir} already exists. Delete it?"
+        if YesNoQuestion().ask(question, "no") == "no":
+            sys.exit(1)
+        shutil.rmtree(srcdir)
 
-    check_call(['dch',
-                '--allow-lower-version',
-                '--force-distribution',
-                '--preserve',
-                '--newversion', bp_version,
-                '--distribution', bp_dist,
-                'No-change backport to %s' % release],
-               cwd=srcdir)
-    check_call(['debuild', '--no-lintian', '-S', '-sa'], cwd=srcdir)
+    pkg.unpack(dirname)
 
-    fn_base = pkg.source + '_' + bp_version.split(':', 1)[-1]
+    bp_version = get_backport_version(pkg.version.full_version, suffix, upload, release)
+    old_version = get_old_version(pkg.source, release)
+    bp_dist = get_backport_dist(release, release_pocket)
+
+    changelog = f"{message} backport to {release}."
+    if close:
+        changelog += f" (LP: #{close})"
+    check_call(
+        [
+            "dch",
+            "--force-bad-version",
+            "--force-distribution",
+            "--preserve",
+            "--newversion",
+            bp_version,
+            "--distribution",
+            bp_dist,
+            changelog,
+        ],
+        cwd=srcdir,
+    )
+
+    cmd = ["debuild", "--no-lintian", "-S", "-nc", "-uc", "-us"]
+    if orig_needed(upload, workdir, pkg):
+        cmd.append("-sa")
+    else:
+        cmd.append("-sd")
+    if old_version:
+        cmd.append(f"-v{old_version}")
+    env = os.environ.copy()
+    # An ubuntu.com e-mail address would make dpkg-buildpackage fail if there
+    # wasn't an Ubuntu maintainer for an ubuntu-versioned package. LP: #1007042
+    env.pop("DEBEMAIL", None)
+    check_call(cmd, cwd=srcdir, env=env)
+
+    fn_base = pkg.source + "_" + bp_version.split(":", 1)[-1]
+    changes = fn_base + "_source.changes"
 
     if build:
-        if 0 != do_build(workdir, fn_base + '.dsc', release, builder, update):
+        if 0 != do_build(workdir, fn_base + ".dsc", release, builder, update):
             sys.exit(1)
+
+    # None: sign with the default signature. False: don't sign
+    if keyid is not False:
+        cmd = ["debsign"]
+        if keyid:
+            cmd.append("-k" + keyid)
+        cmd.append(changes)
+        check_call(cmd, cwd=workdir)
     if upload:
-        do_upload(workdir, pkg.source, bp_version, fn_base + '_source.changes',
-                  upload, prompt)
+        do_upload(workdir, pkg.source, bp_version, changes, upload, prompt)
 
     shutil.rmtree(srcdir)
 
-def main(args):
-    os.environ['DEB_VENDOR'] = 'Ubuntu'
+
+def main(argv):
     ubu_email()
 
-    opts, (package_or_dsc,) = parse(args[1:])
+    args, config = parse(argv[1:])
 
-    script_name = os.path.basename(sys.argv[0])
-    launchpad = Launchpad.login_anonymously(script_name, opts.lpinstance)
+    Launchpad.login_anonymously(service=args.lpinstance)
 
-    if not opts.dest_releases:
-        distinfo = lsb_release.get_distro_information()
-        try:
-            opts.dest_releases = [distinfo['CODENAME']]
-        except KeyError:
-            error('No destination release specified and unable to guess yours.')
+    if not args.dest_releases:
+        if lsb_release:
+            distinfo = lsb_release.get_distro_information()
+            try:
+                current_distro = distinfo["ID"]
+            except KeyError:
+                error("No destination release specified and unable to guess yours.")
+        else:
+            err, current_distro = subprocess.getstatusoutput("lsb_release --id --short")
+            if err:
+                error("Could not run lsb_release to retrieve distribution")
 
-    if opts.workdir:
-        workdir = os.path.expanduser(opts.workdir)
+        if current_distro == "Ubuntu":
+            args.dest_releases = [UbuntuDistroInfo().lts()]
+        elif current_distro == "Debian":
+            args.dest_releases = [DebianDistroInfo().stable()]
+        else:
+            error("Unknown distribution %s, can't guess target release", current_distro)
+
+    if args.workdir:
+        workdir = os.path.expanduser(args.workdir)
     else:
-        workdir = tempfile.mkdtemp(prefix='backportpackage-')
+        workdir = tempfile.mkdtemp(prefix="backportpackage-")
 
     if not os.path.exists(workdir):
         os.makedirs(workdir)
 
     try:
-        pkg = find_package(launchpad,
-                           opts.ubuntu_mirror,
-                           workdir,
-                           package_or_dsc,
-                           opts.version,
-                           opts.source_release)
+        pkg = find_package(
+            args.mirror, workdir, args.package_or_dsc, args.version, args.source_release, config
+        )
         pkg.pull()
 
-        for release in opts.dest_releases:
-            do_backport(workdir,
-                        pkg,
-                        opts.suffix,
-                        release,
-                        opts.build,
-                        opts.builder,
-                        opts.update,
-                        opts.upload,
-                        opts.prompt)
-    except DownloadError, e:
-        error(str(e))
+        for release in args.dest_releases:
+            do_backport(
+                workdir,
+                pkg,
+                args.suffix,
+                args.message,
+                args.close,
+                release,
+                args.release_pocket,
+                args.build,
+                args.builder,
+                args.update,
+                args.upload,
+                args.keyid,
+                args.prompt,
+            )
+    except DownloadError as e:
+        error("%s", str(e))
     finally:
-        if not opts.workdir:
+        if not args.workdir:
             shutil.rmtree(workdir)
 
-if __name__ == '__main__':
+
+if __name__ == "__main__":
     sys.exit(main(sys.argv))

bash_completion/pbuilder-dist

@@ -21,7 +21,7 @@ _pbuilder-dist()
 
     case $prev in
         build)
-            COMPREPLY=( $( compgen -o filenames -G "$cur*.dsc" ) )
+            _filedir "dsc"
             ;;
         *)
             COMPREPLY=( $( compgen -W "$options" | grep "^$cur" ) )
@@ -33,10 +33,10 @@ _pbuilder-dist()
 [ "$have" ] && _pbuilder-aliases()
 {
     local distro builder arch
-    for distro in $(ubuntu-distro-info --all; debian-distro-info --all) stable testing unstable experimental; do
+    for distro in $(ubuntu-distro-info --all; debian-distro-info --all) stable testing unstable; do
         for builder in pbuilder cowbuilder; do
             echo "$builder-$distro"
-            for arch in i386 amd64 armel; do
+            for arch in i386 amd64 armhf; do
                 echo "$builder-$distro-$arch"
             done
         done

bitesize

@@ -1,89 +0,0 @@
-#!/usr/bin/python
-"""Add 'bitesize' tag to bugs and add a comment."""
-
-# Copyright (c) 2011 Canonical Ltd.
-#
-# bitesize is free software; you can redistribute it and/or modify it
-# under the terms of the GNU General Public License as published by the
-# Free Software Foundation; either version 3, or (at your option) any
-# later version.
-#
-# bitesize is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with bitesize; see the file COPYING.  If not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301, USA.
-#
-# Authors:
-#  Daniel Holbach <daniel.holbach@canonical.com>
-
-import sys
-from optparse import OptionParser
-
-from launchpadlib.launchpad import Launchpad
-from launchpadlib.errors import HTTPError
-
-from devscripts.logger import Logger
-
-from ubuntutools.config import UDTConfig
-
-def error_out(msg):
-    Logger.error(msg)
-    sys.exit(1)
-
-def save_entry(entry):
-    try:
-        entry.lp_save()
-    except HTTPError, error:
-        error_out(error.content)
-
-def tag_bug(bug):
-    bug.tags = bug.tags + ['bitesize'] # LP: #254901 workaround
-    save_entry(bug)
-
-def main():
-    usage = "Usage: %prog <bug number>"
-    opt_parser = OptionParser(usage)
-    opt_parser.add_option("-l", "--lpinstance", metavar="INSTANCE",
-                          help="Launchpad instance to connect to "
-                               "(default: production)",
-                          dest="lpinstance", default=None)
-    opt_parser.add_option("--no-conf",
-                          help="Don't read config files or "
-                               "environment variables.",
-                          dest="no_conf", default=False, action="store_true")
-    (options, args) = opt_parser.parse_args()
-    config = UDTConfig(options.no_conf)
-    if options.lpinstance is None:
-        options.lpinstance = config.get_value("LPINSTANCE")
-    if len(args) < 1:
-        opt_parser.error("Need at least one bug number.")
-
-    launchpad = Launchpad.login_with("ubuntu-dev-tools", options.lpinstance)
-    if launchpad is None:
-        error_out("Couldn't authenticate to Launchpad.")
-
-    # check that the new main bug isn't a duplicate
-    try:
-        bug = launchpad.bugs[args[0]]
-    except HTTPError, error:
-        if error.response.status == 401:
-            error_out("Don't have enough permissions to access bug %s. %s" % \
-                      (args[0], error.content))
-        else:
-            raise
-    if 'bitesize' in bug.tags:
-        error_out("Bug is already marked as 'bitesize'.")
-    bug.newMessage(content="I'm marking this bug as 'bitesize' as it looks "
-                           "like an issue that is easy to fix and suitable "
-                           "for newcomers in Ubuntu development. If you need "
-                           "any help with fixing it, talk to me about it.")
-    bug.subscribe(person=launchpad.me)
-    tag_bug(launchpad.bugs[bug.id]) # fresh bug object, LP: #336866 workaround
-
-if __name__ == '__main__':
-    main()

check-mir

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/python3
 #
 # Check components of build dependencies and warn about universe/multiverse
 # ones, for a package destined for main/restricted
@@ -21,65 +21,116 @@
 # this program; if not, write to the Free Software Foundation, Inc.,
 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
-import apt
-import sys
+# pylint: disable=invalid-name
+# pylint: enable=invalid-name
+
+"""Check if any of a package's build or binary dependencies are in universe or multiverse.
+
+Run this inside an unpacked source package
+"""
+
+import argparse
 import os.path
+import sys
+
+import apt
+
 
 def check_support(apt_cache, pkgname, alt=False):
-    '''Check if pkgname is in main or restricted.
+    """Check if pkgname is in main or restricted.
 
     This prints messages if a package is not in main/restricted, or only
     partially (i. e. source in main, but binary in universe).
-    '''
+    """
     if alt:
-        prefix = '  ... alternative ' + pkgname
+        prefix = "  ... alternative " + pkgname
     else:
-        prefix = ' * ' + pkgname
+        prefix = " * " + pkgname
 
-    try:
+    prov_packages = apt_cache.get_providing_packages(pkgname)
+    if pkgname in apt_cache:
         pkg = apt_cache[pkgname]
-    except KeyError:
-        print >> sys.stderr, prefix, 'does not exist (pure virtual?)'
+
+    # If this is a virtual package, iterate through the binary packages that
+    # provide this, and ensure they are all in Main. Source packages in and of
+    # themselves cannot provide virtual packages, only binary packages can.
+    elif len(prov_packages) > 0:
+        supported, unsupported = [], []
+        for pkg in prov_packages:
+            candidate = pkg.candidate
+            if candidate:
+                section = candidate.section
+                if section.startswith("universe") or section.startswith("multiverse"):
+                    unsupported.append(pkg.name)
+                else:
+                    supported.append(pkg.name)
+
+        if len(supported) > 0:
+            msg = "is a virtual package, which is provided by the following "
+            msg += "candidates in Main: " + " ".join(supported)
+            print(prefix, msg)
+        elif len(unsupported) > 0:
+            msg = "is a virtual package, but is only provided by the "
+            msg += "following non-Main candidates: " + " ".join(unsupported)
+            print(prefix, msg, file=sys.stderr)
+            return False
+        else:
+            msg = "is a virtual package that exists but is not provided by "
+            msg += "package currently in the archive. Proceed with caution."
+            print(prefix, msg, file=sys.stderr)
+            return False
+
+    else:
+        print(prefix, "does not exist", file=sys.stderr)
         return False
 
     section = pkg.candidate.section
-    if section.startswith('universe') or section.startswith('multiverse'):
+    if section.startswith("universe") or section.startswith("multiverse"):
         # check if the source package is in main and thus will only need binary
         # promotion
         source_records = apt.apt_pkg.SourceRecords()
         if not source_records.lookup(pkg.candidate.source_name):
-            print >> sys.stderr, 'ERROR: Cannot lookup source package for', \
-                                 pkg.name
-            print prefix, 'package is in', section.split('/')[0]
+            print("ERROR: Cannot lookup source package for", pkg.name, file=sys.stderr)
+            print(prefix, "package is in", section.split("/")[0])
             return False
         src = apt.apt_pkg.TagSection(source_records.record)
-        if (src['Section'].startswith('universe') or
-            src['Section'].startswith('multiverse')):
-            print prefix, 'binary and source package is in', \
-                  section.split('/')[0]
+        if src["Section"].startswith("universe") or src["Section"].startswith("multiverse"):
+            print(prefix, "binary and source package is in", section.split("/")[0])
             return False
-        else:
-            print prefix, 'is in', section.split('/')[0] + ', but its source', \
-                  pkg.candidate.source_name, \
-                  ('is already in main; file an ubuntu-archive bug for '
-                   'promoting the current preferred alternative')
-            return True
+
+        print(
+            prefix,
+            "is in",
+            section.split("/")[0] + ", but its source",
+            pkg.candidate.source_name,
+            "is already in main; file an ubuntu-archive bug for "
+            "promoting the current preferred alternative",
+        )
+        return True
 
     if alt:
-        print prefix, 'is already in main; consider preferring it'
+        print(prefix, "is already in main; consider preferring it")
 
     return True
 
+
 def check_build_dependencies(apt_cache, control):
-    print 'Checking support status of build dependencies...'
+    print("Checking support status of build dependencies...")
 
     any_unsupported = False
 
-    for field in ('Build-Depends', 'Build-Depends-Indep'):
+    for field in ("Build-Depends", "Build-Depends-Indep"):
         if field not in control.section:
             continue
         for or_group in apt.apt_pkg.parse_src_depends(control.section[field]):
             pkgname = or_group[0][0]
+
+            # debhelper-compat is expected to be a build dependency of every
+            # package, so it is a red herring to display it in this report.
+            # (src:debhelper is in Ubuntu Main anyway)
+            if pkgname == "debhelper-compat":
+                continue
+
             if not check_support(apt_cache, pkgname):
                 # check non-preferred alternatives
                 for altpkg in or_group[1:]:
@@ -90,22 +141,23 @@ def check_build_dependencies(apt_cache, control):
 
     return any_unsupported
 
+
 def check_binary_dependencies(apt_cache, control):
     any_unsupported = False
 
-    print '\nChecking support status of binary dependencies...'
+    print("\nChecking support status of binary dependencies...")
     while True:
         try:
-            control.next()
+            next(control)
         except StopIteration:
             break
 
-        for field in ('Depends', 'Pre-Depends', 'Recommends'):
+        for field in ("Depends", "Pre-Depends", "Recommends"):
             if field not in control.section:
                 continue
-            for or_group in apt.apt_pkg.parse_depends(control.section[field]):
+            for or_group in apt.apt_pkg.parse_src_depends(control.section[field]):
                 pkgname = or_group[0][0]
-                if pkgname.startswith('$'):
+                if pkgname.startswith("$"):
                     continue
                 if not check_support(apt_cache, pkgname):
                     # check non-preferred alternatives
@@ -117,27 +169,35 @@ def check_binary_dependencies(apt_cache, control):
 
     return any_unsupported
 
+
 def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.parse_args()
     apt_cache = apt.Cache()
 
-    if not os.path.exists('debian/control'):
-        print >> sys.stderr, ('debian/control not found. You need to run '
-                              'this tool in a source package directory')
+    if not os.path.exists("debian/control"):
+        print(
+            "debian/control not found. You need to run this tool in a source package directory",
+            file=sys.stderr,
+        )
         sys.exit(1)
 
     # get build dependencies from debian/control
-    control = apt.apt_pkg.TagFile(open('debian/control'))
-    control.next()
+    control = apt.apt_pkg.TagFile(open("debian/control", encoding="utf-8"))
+    next(control)
 
     unsupported_build_deps = check_build_dependencies(apt_cache, control)
     unsupported_binary_deps = check_binary_dependencies(apt_cache, control)
 
     if unsupported_build_deps or unsupported_binary_deps:
-        print ('\nPlease check https://wiki.ubuntu.com/MainInclusionProcess if '
-               'this source package needs to get into in main/restricted, or '
-               'reconsider if the package really needs above dependencies.')
+        print(
+            "\nPlease check https://wiki.ubuntu.com/MainInclusionProcess if "
+            "this source package needs to get into in main/restricted, or "
+            "reconsider if the package really needs above dependencies."
+        )
     else:
-        print 'All dependencies are supported in main or restricted.'
+        print("All dependencies are supported in main or restricted.")
 
-if __name__ == '__main__':
+
+if __name__ == "__main__":
     main()

check-symbols

@@ -29,21 +29,55 @@
 # * nm (from binutils)
 
 DISTRO=$(lsb_release -c -s)
-VERSION=$(apt-cache madison "$1" | grep -- "$DISTRO"'/.*Sources$' | awk '{print $3}')
-PACKAGES=$(apt-cache showsrc "$1" | grep-dctrl -s Binary -F Version "$VERSION" | sed 's/Binary\:\ //g;s/\,//g' | sort -u)
 DEBLINE=""
 DEBUG=False
 
-if [[ -z $1 ]]; then
-    echo "Missing argument: source package name."
-    exit 1
+usage() {
+    prog=$(basename $0)
+    cat <<EOF
+Usage: $prog [options] source-package [DEBDIR]
+
+Get a diff of the exported symbols of all .so files in every binary package of
+package the source package. The source package will be found in DEBDIR, defaulting to /var/cache/pbuilder/result.
+
+Options:
+  -h, --help  show this help message and exit
+EOF
+    exit $1
+}
+
+PACKAGE=""
+DEBDIR="/var/cache/pbuilder/result"
+POSITION=0
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -h|--help)
+            usage 0
+            ;;
+        -*)
+            usage 1
+            ;;
+        *)
+            if [ $POSITION -eq 0 ]; then
+                PACKAGE="$1"
+            elif [ $POSITION -eq 1 ]; then
+                DEBDIR="$1"
+            else
+                echo "Too many arguments." >&2
+                usage 1
+            fi
+            POSITION=$(($POSITION+1))
+    esac
+    shift
+done
+
+if [ $POSITION -eq 0 ]; then
+    echo "Missing argument: source package name." >&2
+    usage 1
 fi
 
-if [[ -z $2 ]]; then
-    DEBDIR="/var/cache/pbuilder/result"
-else
-    DEBDIR="$2"
-fi
+VERSION=$(apt-cache madison "$PACKAGE" | grep -- "$DISTRO"'/.*Sources$' | awk '{print $3}')
+PACKAGES=$(apt-cache showsrc "$PACKAGE" | grep-dctrl -s Binary -F Version "$VERSION" | sed 's/Binary\:\ //g;s/\,//g' | sort -u)
 
 if [ `id -u` != "0" ]
 then
@@ -67,7 +101,7 @@ do
 done
 
 if [[ -z $DEBLINE ]]; then
-    echo "Package doesn't exist: $1."
+    echo "Package doesn't exist: $PACKAGE."
     exit 1
 fi
 

data/debian.csv

@@ -1,14 +0,0 @@
-version,codename,series,created,release,eol
-1.1,Buzz,buzz,1993-08-16,1996-06-17,1997-06-05
-1.2,Rex,rex,1996-06-17,1996-12-12,1998-06-05
-1.3,Bo,bo,1996-12-12,1997-06-05,1999-03-09
-2.0,Hamm,hamm,1997-06-05,1998-07-24,2000-03-09
-2.1,Slink,slink,1998-07-24,1999-03-09,2000-10-30
-2.2,Potato,potato,1999-03-09,2000-08-15,2003-07-30
-3.0,Woody,woody,2000-08-15,2002-07-19,2006-06-30
-3.1,Sarge,sarge,2002-07-19,2005-06-06,2008-03-30
-4.0,Etch,etch,2005-06-06,2007-04-08,2010-02-15
-5.0,Lenny,lenny,2007-04-08,2009-02-14,2012-02-06
-6.0,Squeeze,squeeze,2009-02-14,2011-02-06
-7.0,Wheezy,wheezy,2011-02-06
-,Sid,sid,1993-08-16

data/ubuntu.csv

@@ -1,16 +0,0 @@
-version,codename,series,created,release,eol,eol-server
-4.10,Warty Warthog,warty,2004-03-05,2004-10-26,2006-04-26
-5.04,Hoary Hedgehog,hoary,2004-10-26,2005-04-08,2006-10-08
-5.10,Breezy Badger,breezy,2005-04-08,2005-10-12,2007-04-12
-6.06 LTS,Dapper Drake,dapper,2005-10-12,2006-06-01,2009-07-14,2011-06-01
-6.10,Edgy Eft,edgy,2006-06-01,2006-10-26,2008-04-25
-7.04,Feisty Fawn,feisty,2006-10-26,2007-04-19,2008-10-19
-7.10,Gutsy Gibbon,gutsy,2007-04-19,2007-10-18,2009-04-18
-8.04 LTS,Hardy Heron,hardy,2007-10-18,2008-04-24,2011-05-12,2013-04
-8.10,Intrepid Ibex,intrepid,2008-04-24,2008-10-30,2010-04-30
-9.04,Jaunty Jackalope,jaunty,2008-10-30,2009-04-23,2010-10-23
-9.10,Karmic Koala,karmic,2009-04-23,2009-10-29,2011-04-29
-10.04 LTS,Lucid Lynx,lucid,2009-10-29,2010-04-29,2013-04,2015-04
-10.10,Maverick Meerkat,maverick,2010-04-29,2010-10-10,2012-04
-11.04,Natty Narwhal,natty,2010-10-10,2011-04-28,2012-10
-11.10,Oneiric Ocelot,oneiric,2011-04-28,2011-10-13,2013-04

debian-distro-info

@@ -1,94 +0,0 @@
-#!/usr/bin/python
-
-# Copyright (C) 2009-2011, Benjamin Drung <bdrung@ubuntu.com>
-#
-# Permission to use, copy, modify, and/or distribute this software for any
-# purpose with or without fee is hereby granted, provided that the above
-# copyright notice and this permission notice appear in all copies.
-#
-# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
-"""provides information about Debian's distributions"""
-
-import optparse
-import os
-import sys
-
-from ubuntutools.distro_info import convert_date, DebianDistroInfo
-
-def main():
-    script_name = os.path.basename(sys.argv[0])
-    usage = "%s [options]" % (script_name)
-    epilog = "See %s(1) for more info." % (script_name)
-    parser = optparse.OptionParser(usage=usage, epilog=epilog)
-
-    parser.add_option("--date", dest="date", default=None,
-                      help="date for calculating the version (default: today).")
-    parser.add_option("-a", "--all", dest="all",
-                      help="list all known versions",
-                      action="store_true", default=False)
-    parser.add_option("-d", "--devel", dest="devel",
-                      help="latest development version",
-                      action="store_true", default=False)
-    parser.add_option("-o", "--old", dest="old",
-                      help="latest old (stable) version",
-                      action="store_true", default=False)
-    parser.add_option("-s", "--stable", dest="stable",
-                      help="latest stable version",
-                      action="store_true", default=False)
-    parser.add_option("--supported", dest="supported",
-                      help="list of all supported stable versions",
-                      action="store_true", default=False)
-    parser.add_option("-t", "--testing", dest="testing",
-                      help="current testing version",
-                      action="store_true", default=False)
-    parser.add_option("--unsupported", dest="unsupported",
-                      help="list of all unsupported stable versions",
-                      action="store_true", default=False)
-
-    (options, args) = parser.parse_args()
-
-    if len(args) != 0:
-        parser.error("This script does not take any additional parameters.")
-
-    versions = [options.all, options.devel, options.old, options.stable,
-                options.supported, options.testing, options.unsupported]
-    if len([x for x in versions if x]) != 1:
-        parser.error("You have to select exactly one of --all, --devel, --old, "
-                     "--stable, --supported, --testing, --unsupported.")
-
-    if options.date is None:
-        date = None
-    else:
-        try:
-            date = convert_date(options.date)
-        except ValueError:
-            parser.error("Option --date needs to be a date in ISO 8601 "
-                         "format.")
-
-    if options.all:
-        for distro in DebianDistroInfo().all:
-            print distro
-    elif options.devel:
-        print DebianDistroInfo().devel(date)
-    elif options.old:
-        print DebianDistroInfo().old(date)
-    elif options.stable:
-        print DebianDistroInfo().stable(date)
-    elif options.supported:
-        for distro in DebianDistroInfo().supported(date):
-            print distro
-    elif options.testing:
-        print DebianDistroInfo().testing(date)
-    elif options.unsupported:
-        for distro in DebianDistroInfo().unsupported(date):
-            print distro
-
-if __name__ == "__main__":
-    main()

debian/.gitignore

@@ -0,0 +1 @@
+files

debian/NEWS

@@ -1,3 +1,35 @@
+ubuntu-dev-tools (0.135) unstable; urgency=low
+
+  reverse-build-depends was removed from ubuntu-dev-tools. reverse-depends -b
+  is equivalent.
+
+ -- Stefano Rivera <stefanor@debian.org>  Sat, 12 Nov 2011 13:11:21 +0200
+
+ubuntu-dev-tools (0.131) unstable; urgency=low
+
+  get-build-deps was removed from ubuntu-dev-tools. The newer mk-build-deps in
+  devscripts is equivalent (with the -ir options).
+
+ -- Stefano Rivera <stefanor@debian.org>  Sat, 10 Sep 2011 00:13:18 +0200
+
+ubuntu-dev-tools (0.129) unstable; urgency=low
+
+  Several tools that worked against Launchpad but were not specific to Ubuntu
+  have been migrated to the "lptools" project.
+
+  The following tools have moved:
+   - get-branches (renamed to lp-get-branches)
+   - grab-attachments (renamed to lp-grab-attachments)
+   - lp-project-upload
+   - lp-list-bugs
+   - lp-set-dup
+   - lp-shell
+
+  They can now be found in the lptools package (version 0.0.1~bzr28-1 or
+  later).
+
+ -- Jelmer Vernooij <jelmer@debian.org>  Fri, 02 Sep 2011 13:43:34 +0200
+
 ubuntu-dev-tools (0.119) unstable; urgency=low
 
   launchpadlib 1.9 will cause some issues, as it uses the GNOME Keyring / KDE

debian/README.source

@@ -0,0 +1,26 @@
+Changelog generation and releasing
+----------------------------------
+
+The changelog is generated by the uploader using `gbp dch' from
+`git-buildpackage'. To invoke, just run
+
+  $ gbp dch
+
+and then edit the changelog as appropriate - wrap lines, remove Signed-Off-By,
+and so on. Then finalise the changelog, e.g.
+
+  $ dch -D unstable --release ""
+
+commit it
+
+  $ git commit debian/changelog -m "Releasing 0.foo"
+
+and tag/sign this commit
+
+  $ gbp buildpackage --git-tag-only
+
+then build using (for example)
+
+  $ gbp buildpackage -S
+
+and test/upload as normal.

debian/clean

@@ -1,2 +1 @@
-*.egg-info/*
-test-data/example_*
+*.egg-info/

debian/compat

@@ -1 +0,0 @@
-7

debian/control

@@ -1,94 +1,102 @@
 Source: ubuntu-dev-tools
 Section: devel
 Priority: optional
-Maintainer: Ubuntu Developers <ubuntu-dev-team@lists.alioth.debian.org>
-Uploaders: Benjamin Drung <bdrung@debian.org>,
-           Stefano Rivera <stefanor@debian.org>
-Vcs-Bzr: lp:ubuntu-dev-tools
-Vcs-Browser: https://code.launchpad.net/~ubuntu-dev/ubuntu-dev-tools/trunk
-Build-Depends: dctrl-tools,
-               debhelper (>= 7.0.50~),
-               devscripts (>= 2.11.0~),
-               libwww-perl,
-               lsb-release,
-               pylint,
-               python-all (>= 2.6.5-13~),
-               python-apt (>= 0.7.93~),
-               python-debian (>= 0.1.15),
-               python-gnupginterface,
-               python-launchpadlib (>= 1.5.7),
-               python-mox,
-               python-setuptools,
-               python-soappy,
-               python-unittest2
-X-Python-Version: >= 2.6
+Maintainer: Ubuntu Developers <ubuntu-dev-tools@packages.debian.org>
+Uploaders:
+ Benjamin Drung <bdrung@debian.org>,
+ Stefano Rivera <stefanor@debian.org>,
+ Mattia Rizzolo <mattia@debian.org>,
+ Simon Quigley <tsimonq2@debian.org>,
+Build-Depends:
+ black <!nocheck>,
+ dctrl-tools,
+ debhelper-compat (= 13),
+ devscripts (>= 2.11.0~),
+ dh-make,
+ dh-python,
+ distro-info (>= 0.2~),
+ flake8,
+ isort <!nocheck>,
+ lsb-release,
+ pylint <!nocheck>,
+ python3-all,
+ python3-apt,
+ python3-dateutil,
+ python3-debian,
+ python3-debianbts,
+ python3-distro-info,
+ python3-httplib2,
+ python3-launchpadlib-desktop,
+ python3-pytest,
+ python3-requests <!nocheck>,
+ python3-setuptools,
+ python3-yaml <!nocheck>,
+Standards-Version: 4.7.2
+Rules-Requires-Root: no
+Vcs-Git: https://git.launchpad.net/ubuntu-dev-tools
+Vcs-Browser: https://git.launchpad.net/ubuntu-dev-tools
 Homepage: https://launchpad.net/ubuntu-dev-tools
-Standards-Version: 3.9.2
 
 Package: ubuntu-dev-tools
 Architecture: all
-Depends: binutils,
-         dctrl-tools,
-         devscripts (>= 2.11.0~),
-         diffstat,
-         dpkg-dev,
-         lsb-release,
-         python-apt (>= 0.7.93~),
-         python-debian (>= 0.1.15),
-         python-launchpadlib (>= 1.5.7),
-         python-lazr.restfulclient,
-         sudo,
-         ${misc:Depends},
-         ${perl:Depends},
-         ${python:Depends}
-Recommends: bzr,
-            bzr-builddeb,
-            ca-certificates,
-            debian-archive-keyring,
-            debian-keyring,
-            debootstrap,
-            genisoimage,
-            libwww-perl,
-            pbuilder | cowdancer | sbuild,
-            perl-modules,
-            python-dns,
-            python-gnupginterface,
-            python-soappy,
-            reportbug (>= 3.39ubuntu1)
-Suggests: python-simplejson | python (>= 2.7), qemu-user-static
+Depends:
+ binutils,
+ dctrl-tools,
+ devscripts (>= 2.11.0~),
+ diffstat,
+ distro-info (>= 0.2~),
+ dpkg-dev,
+ dput,
+ lsb-release,
+ python3,
+ python3-apt,
+ python3-debian,
+ python3-debianbts,
+ python3-distro-info,
+ python3-httplib2,
+ python3-launchpadlib-desktop,
+ python3-lazr.restfulclient,
+ python3-ubuntutools (= ${binary:Version}),
+ python3-yaml,
+ sensible-utils,
+ sudo,
+ tzdata,
+ ${misc:Depends},
+ ${perl:Depends},
+Recommends:
+ arch-test,
+ ca-certificates,
+ debian-archive-keyring,
+ debian-keyring,
+ debootstrap,
+ genisoimage,
+ lintian,
+ patch,
+ sbuild | pbuilder | cowbuilder,
+ python3-dns,
+ quilt,
+ reportbug (>= 3.39ubuntu1),
+ ubuntu-keyring | ubuntu-archive-keyring,
+Suggests:
+ bzr | brz,
+ bzr-builddeb | brz-debian,
+ qemu-user-static,
 Description: useful tools for Ubuntu developers
  This is a collection of useful tools that Ubuntu developers use to make their
  packaging work a lot easier.
  .
  Such tools include:
  .
-  - 404main - used to check what components a package's deps are in, for
-    doing a main inclusion report for example.
+  - backportpackage - helper to test package backports
   - bitesize - add the 'bitesize' tag to a bug and comment that you are
     willing to help fix it.
   - check-mir - check support status of build/binary dependencies
   - check-symbols - will compare and give you a diff of the exported symbols of
     all .so files in a binary package.
   - dch-repeat - used to repeat a change log into an older release.
-  - debian-distro-info - provides information about Debian's distributions.
-  - dgetlp - download a source package from the Launchpad library.
-  - distro-info - provides information about the distributions' releases.
-  - get-branches - used to branch/checkout all the bzr branches in a Launchpad
-    team.
-  - get-build-deps - install the build dependencies needed for a package
-    reading debian/control.
-  - grab-attachments - download all bug attachments from a Launchpad bug
-    report.
   - grab-merge - grabs a merge from merges.ubuntu.com easily.
   - grep-merges - search for pending merges from Debian.
-  - harvest - grabs information about development opportunities from
-    http://harvest.ubuntu.com
-  - hugdaylist - compile HugDay lists from bug list URLs.
   - import-bug-from-debian - copy a bug from the Debian BTS to Launchpad
-  - lp-list-bugs - briefly list status of Launchpad bugs.
-  - lp-project-upload - upload a release tarball to a Launchpad project
-  - lp-set-dup - sets the "duplicate of" bug of a bug and its dups.
-  - massfile - fill multiple bugs using a template.
   - merge-changelog - manually merges two Debian changelogs with the same base
     version.
   - mk-sbuild - script to create LVM snapshot chroots via schroot and
@@ -97,13 +105,22 @@ Description: useful tools for Ubuntu developers
     chroots (for different Ubuntu and Debian releases) on the same system.
   - pull-debian-debdiff - attempts to find and download a specific version of
     a Debian package and its immediate parent to generate a debdiff.
-  - pull-debian-source - downloads the lastest source package available in
+  - pull-debian-source - downloads the latest source package available in
     Debian of a package.
-  - pull-lp-source - downloads lastest source package from Launchpad.
-  - pull-revu-source - downloads the latest source package from REVU
-  - requestsync - files a sync request with Debian changelog and ratione.
-  - reverse-build-depends - find the reverse build dependencies that a package
-    has.
+  - pull-lp-source - downloads source package from Launchpad.
+  - pull-lp-debs - downloads debs package(s) from Launchpad.
+  - pull-lp-ddebs - downloads dbgsym/ddebs package(s) from Launchpad.
+  - pull-lp-udebs - downloads udebs package(s) from Launchpad.
+  - pull-debian-* - same as pull-lp-* but for Debian packages.
+  - pull-uca-* - same as pull-lp-* but for Ubuntu Cloud Archive packages.
+  - pull-pkg - common script that provides above pull-* functionality.
+  - requestbackport - file a backporting request.
+  - requestsync - files a sync request with Debian changelog and rationale.
+  - reverse-depends - find the reverse dependencies (or build dependencies) of
+    a package.
+  - running-autopkgtests - lists the currently running and/or queued
+    autopkgtests on the Ubuntu autopkgtest infrastructure
+  - seeded-in-ubuntu - query if a package is safe to upload during a freeze.
   - setup-packaging-environment - assistant to get an Ubuntu installation
     ready for packaging work.
   - sponsor-patch - Downloads a patch from a Launchpad bug, patches the source
@@ -112,6 +129,27 @@ Description: useful tools for Ubuntu developers
   - syncpackage - helper to prepare .changes file to upload synced packages
   - ubuntu-build - give commands to the Launchpad build daemons from the
     command line.
-  - ubuntu-distro-info - provides information about Ubuntu's distributions.
   - ubuntu-iso - output information of an Ubuntu ISO image.
+  - ubuntu-upload-permission - query / list the upload permissions for a
+    package.
   - update-maintainer - script to update maintainer field in ubuntu packages.
+
+Package: python3-ubuntutools
+Architecture: all
+Section: python
+Depends:
+ python3-dateutil,
+ python3-debian,
+ python3-distro-info,
+ python3-httplib2,
+ python3-launchpadlib-desktop,
+ python3-lazr.restfulclient,
+ python3-requests,
+ sensible-utils,
+ ${misc:Depends},
+ ${python3:Depends},
+Description: useful APIs for Ubuntu developer tools — Python 3 library
+ This package ships a collection of APIs, helpers and wrappers used to
+ develop useful utilities for Ubuntu developers.
+ .
+ This package installs the library for Python 3.

debian/copyright

@@ -1,31 +1,32 @@
-Format: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=166
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: Ubuntu Developer Tools
 Upstream-Contact: Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>
 Source: https://launchpad.net/ubuntu-dev-tools
 
-Files: *
-       backportpackage
+Files: backportpackage
        bash_completion/pbuilder-dist
        check-symbols
+       debian/*
        doc/backportpackage.1
        doc/check-symbols.1
        doc/requestsync.1
        doc/ubuntu-iso.1
-       lp-shell
+       doc/running-autopkgtests.1
+       GPL-2
+       README.updates
        requestsync
        setup.py
+       TODO
        ubuntu-iso
-       ubuntutools/requestsync/common.py
-       ubuntutools/requestsync/lp.py
-       ubuntutools/requestsync/mail.py
+       ubuntutools/requestsync/*.py
 Copyright: 2007,      Albert Damen <albrt@gmx.net>
-           2010,      Benjamin Drung <bdrung@ubuntu.com>
-           2007-2010, Canonical Ltd.
+           2010-2024, Benjamin Drung <bdrung@ubuntu.com>
+           2007-2023, Canonical Ltd.
            2006-2007, Daniel Holbach <daniel.holbach@ubuntu.com>
-           2010,      Dustin Kirkland <kirkland@ubuntu.com>
            2010,      Evan Broder <evan@ebroder.net>
            2006-2007, Luke Yelavich <themuso@ubuntu.com>
            2009-2010, Michael Bienia <geser@ubuntu.com>
+           2024-2025, Simon Quigley <tsimonq2@debian.org>
            2010-2011, Stefano Rivera <stefanor@ubuntu.com>
            2008,      Stephan Hermann <sh@sourcecode.de>
            2007,      Steve Kowalik <stevenk@ubuntu.com>
@@ -42,30 +43,18 @@ License: GPL-2
  On Debian systems, the complete text of the GNU General Public License
  version 2 can be found in the /usr/share/common-licenses/GPL-2 file.
 
-Files: 404main
-       dgetlp
-       doc/404main.1
-       doc/dgetlp.1
-       doc/import-bug-from-debian.1
-       doc/lp-project-upload.1
-       doc/lp-set-dup.1
-       doc/lp-shell.1
+Files: doc/import-bug-from-debian.1
        doc/pbuilder-dist-simple.1
        doc/pbuilder-dist.1
-       doc/reverse-build-depends.1
        doc/submittodebian.1
        import-bug-from-debian
-       lp-project-upload
-       lp-set-dup
        pbuilder-dist
        pbuilder-dist-simple
-       reverse-build-depends
        submittodebian
 Copyright: 2007-2010, Canonical Ltd.
            2009,      James Westby <james.westby@ubuntu.com>
            2008,      Jamin W. Collins <jcollins@asgardsrealm.net>
            2008,      Jordan Mantha <mantha@ubuntu.com>
-           2008-2009, Patrick Schoenfeld <schoenfeld@in-medias-res.com>
            2006-2007, Pete Savage <petesavage@ubuntu.com>
            2009,      Ryan Kavanagh <ryanakca@kubuntu.org>
            2007,      Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>
@@ -85,30 +74,28 @@ License: GPL-2+
  On Debian systems, the complete text of the GNU General Public License
  version 2 can be found in the /usr/share/common-licenses/GPL-2 file.
 
-Files: ack-sync
-       doc/bitesize.1
-       doc/get-branches.1
-       doc/grab-attachments.1
+Files: doc/lp-bitesize.1
+       doc/check-mir.1
        doc/grab-merge.1
-       doc/harvest.1
-       doc/hugdaylist.1
-       doc/massfile.1
        doc/merge-changelog.1
+       doc/pm-helper.1
        doc/setup-packaging-environment.1
        doc/syncpackage.1
-       bitesize
-       get-branches
-       grab-attachments
+       lp-bitesize
+       check-mir
+       GPL-3
        grab-merge
-       harvest
-       hugdaylist
-       massfile
        merge-changelog
+       pm-helper
+       pyproject.toml
+       run-linters
+       running-autopkgtests
        setup-packaging-environment
        syncpackage
-Copyright: 2010,      Benjamin Drung <bdrung@ubuntu.com>
-           2007-2011, Canonical Ltd.
-           2010,      Dustin Kirkland <kirkland@ubuntu.com>
+       ubuntutools/running_autopkgtests.py
+       ubuntutools/utils.py
+Copyright: 2010-2024, Benjamin Drung <bdrung@ubuntu.com>
+           2007-2024, Canonical Ltd.
            2008,      Jonathan Patrick Davies <jpds@ubuntu.com>
            2008-2010, Martin Pitt <martin.pitt@canonical.com>
            2009,      Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>
@@ -128,23 +115,25 @@ License: GPL-3
 
 Files: dch-repeat
        doc/dch-repeat.1
-       doc/get-build-deps.1
        doc/grep-merges.1
-       doc/lp-list-bugs.1
        doc/mk-sbuild.1
-       doc/pull-lp-source.1
-       doc/pull-revu-source.1
+       doc/pull-pkg.1
        doc/ubuntu-build.1
-       get-build-deps
        grep-merges
-       lp-list-bugs
        mk-sbuild
-       pull-lp-source
-       pull-revu-source
+       pull-pkg
+       pull-*debs
+       pull-*-source
+       requirements.txt
+       test-requirements.txt
+       tox.ini
        ubuntu-build
-       ubuntutools/lp/libsupport.py
+       ubuntutools/__init__.py
+       ubuntutools/lp/__init__.py
        ubuntutools/lp/lpapicache.py
+       ubuntutools/lp/udtexceptions.py
        ubuntutools/misc.py
+       ubuntutools/pullpkg.py
 Copyright: 2007-2010, Canonical Ltd.
            2008-2009, Iain Lane <iain@orangesquash.org.uk>
            2006,      John Dong <jdong@ubuntu.com>
@@ -153,7 +142,8 @@ Copyright: 2007-2010, Canonical Ltd.
            2009-2010, Michael Bienia <geser@ubuntu.com>
            2009,      Nathan Handler <nhandler@ubuntu.com>
            2007-2008, Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>
-           2010-2011, Stefano Rivera <stefanor@ubuntu.com>
+           2010-2012, Stefano Rivera <stefanor@ubuntu.com>
+           2012,      Steve Langasek <steve.langasek@ubuntu.com>
 License: GPL-3+
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
@@ -168,34 +158,38 @@ License: GPL-3+
  On Debian systems, the complete text of the GNU General Public License
  version 3 can be found in the /usr/share/common-licenses/GPL-3 file.
 
-Files: data/*
-       debian-distro-info
-       doc/debian-distro-info.1
-       doc/distro-info.1
-       doc/pull-debian-debdiff.1
-       doc/pull-debian-source.1
+Files: doc/pull-debian-debdiff.1
+       doc/requestbackport.1
+       doc/reverse-depends.1
+       doc/seeded-in-ubuntu.1
        doc/sponsor-patch.1
        doc/ubuntu-dev-tools.5
-       doc/ubuntu-distro-info.1
+       doc/ubuntu-upload-permission.1
        doc/update-maintainer.1
+       enforced-editing-wrapper
        pull-debian-debdiff
-       pull-debian-source
+       requestbackport
+       reverse-depends
+       seeded-in-ubuntu
        sponsor-patch
-       test-data/*
-       ubuntu-distro-info
+       ubuntu-upload-permission
        ubuntutools/archive.py
        ubuntutools/builder.py
        ubuntutools/config.py
-       ubuntutools/distro_info.py
        ubuntutools/question.py
+       ubuntutools/rdepends.py
        ubuntutools/sponsor_patch/*
        ubuntutools/test/*
        ubuntutools/update_maintainer.py
+       ubuntutools/version.py
        update-maintainer
-Copyright: 2009-2011, Benjamin Drung <bdrung@ubuntu.com>
+       .pylintrc
+Copyright: 2009-2024, Benjamin Drung <bdrung@ubuntu.com>
            2010,      Evan Broder <evan@ebroder.net>
            2008,      Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>
            2010-2011, Stefano Rivera <stefanor@ubuntu.com>
+           2017-2021, Dan Streetman <ddstreet@canonical.com>
+           2024,      Canonical Ltd.
 License: ISC
  Permission to use, copy, modify, and/or distribute this software for any
  purpose with or without fee is hereby granted, provided that the above

debian/gbp.conf

@@ -0,0 +1,9 @@
+[DEFAULT]
+debian-tag = %(version)s
+debian-branch = master
+sign-tags = True
+
+[dch]
+meta = True
+auto = True
+full = True

debian/python3-ubuntutools.install

@@ -0,0 +1 @@
+/usr/lib/python3.*

debian/rules

@@ -1,16 +1,14 @@
 #!/usr/bin/make -f
 
-%:
-	dh $@ --with python2
+override_dh_auto_clean:
+	dh_auto_clean
+	rm -f .coverage
+	rm -rf .tox
 
-override_dh_auto_install:
-	dh_auto_install
-	ln -s $(shell dpkg-vendor --query Vendor | tr '[:upper:]' '[:lower:]')-distro-info debian/ubuntu-dev-tools/usr/bin/distro-info
-
-ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
 override_dh_auto_test:
-	set -e; \
-	for python in $(shell pyversions -r); do \
-		$$python setup.py test; \
-	done
+ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
+	python3 -m pytest -v ubuntutools
 endif
+
+%:
+	dh $@ --with python3 --buildsystem=pybuild

debian/source/lintian-overrides

@@ -0,0 +1,3 @@
+# pyc files are machine-generated; they're expected to have long lines and have unstated copyright
+source: file-without-copyright-information *.pyc [debian/copyright]
+source: very-long-line-length-in-source-file * > 512 [*.pyc:*]

debian/tests/control

@@ -0,0 +1,7 @@
+Test-Command: python3 -m pytest -v ubuntutools
+Depends:
+ dh-make,
+ python3-pytest,
+ python3-setuptools,
+ @,
+Restrictions: allow-stderr

debian/ubuntu-dev-tools.install

@@ -0,0 +1,2 @@
+/usr/bin
+/usr/share

dgetlp

@@ -1,331 +0,0 @@
-#!/usr/bin/python
-# -*- coding: UTF-8 -*-
-# Copyright (C) 2008 Terence Simpson <tsimpson@ubuntu.com>
-# License:
-#  This program is free software; you can redistribute it and/or modify
-#  it under the terms of the GNU General Public License as published by
-#  the Free Software Foundation; either version 2 of the License, or
-#  (at your option) any later version.
-#
-#  This program is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU General Public License for more details.
-#
-#  You should have received a copy of the GNU General Public License along
-#  with this program; if not, write to the Free Software Foundation, Inc.,
-#  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-#
-# This script simulates «dget»'s behaviour for files hosted at
-# launchpadlibrarian.net.
-#
-# Detailed description:
-# This script attempts to download the source package in the same
-# way as dget does, but from launchpadlibrarian.net, which doesn't
-# store all the files in the same directory. It (the script) assumes
-# that the files are stored in sequential directories on Launchpad
-# Librarian and attempts to download and then unpack them.
-# This is a Python rewrite of the original bash script
-
-import cStringIO
-import email.feedparser
-import hashlib
-import optparse
-import os
-import subprocess
-import sys
-import urllib2
-
-try:
-    import GnuPGInterface
-except ImportError:
-    print >> sys.stderr, ("Please install 'python-gnupginterface' in order to "
-                          "use this utility.")
-    sys.exit(1)
-
-USAGE = u"""Usage: %prog [-d|(-v|-q)] <Launchpad URL>
-
-This scripts simulates «dget»'s behaviour for files hosted at
-launchpadlibrarian.net.
-
-If you specify the -d option then it won't do anything, except download the
-.dsc file, but just print the commands it would run otherwise.
-
-Example:
-    %prog http://launchpadlibrarian.net/10348157/coreutils_5.97-5.4ubuntu1.dsc
-"""
-
-BASE_URL = "http://launchpadlibrarian.net/"
-
-Debug = Verbose = Quiet = False
-
-def unsign(data):
-    if data.splitlines()[0] != "-----BEGIN PGP SIGNED MESSAGE-----":
-        return data
-    oldstdout = sys.stdout
-    oldstderr = sys.stderr
-    sys.stdout = sys.__stdout__
-    sys.stderr = sys.__stderr__
-    gpg = GnuPGInterface.GnuPG()
-    proc = gpg.run(["--decrypt"], create_fhs=['stdin', 'stdout'])
-    proc.handles['stdin'].write(data)
-    proc.handles['stdin'].close()
-    plain = proc.handles['stdout'].read()
-    proc.handles['stdout'].close()
-    try:
-        proc.wait()
-    except:
-        pass
-    sys.stdout = oldstdout
-    sys.stderr = oldstderr
-    return plain
-
-def get_entries(data):
-    parser = email.feedparser.FeedParser()
-    parser.feed(data)
-    return parser.close()
-
-class DscParse(object):
-    """Attempt to get the file list from the .dsc file"""
-    def __init__(self, data):
-        """
-        __init__(data)
-        Given the contents of a .dsc, parse it and extract it's content
-        """
-        self.entries = get_entries(unsign(data))
-        self.files = [x.strip().split() for x in
-                      self.entries['Files'].splitlines()]
-
-    def verify_all(self):
-        """
-        verify_all()
-        Verifies all the files, first checking the size, then the md5 sum.
-        Currently not used in this utility.
-        """
-        assert self.files, "I have no files"
-        ret = []
-        for f in self.files:
-            ret.append(self.verify(f))
-        return ret
-
-    def verify(self, name):
-        """
-        verify(name)
-        Verify the file 'name', first checking the size, then the md5 sum.
-        """
-        assert self.files, "I have no files"
-        f = None
-        if isinstance(name, list):
-            f = name
-        else:
-            for i in self.files:
-                if i[2] == name:
-                    f = i
-        if not f:
-            raise ValueError, "%s is not in the .dsc" % name
-        (md5sum, size, name) = tuple(f)
-        stat = os.stat(name)
-        if str(stat.st_size) != size:
-            return (False, name, "Expected a size of %s, got %s" % \
-                (size, stat.st_size))
-        return self.getsum(name, md5sum)
-
-    def getsum(self, name, md5sum=None):
-        """
-        getsum(name[, md5sum])
-        Read the file 'name' (in 1MB chunks) and generate an md5 sum,
-        then compares that to the md5 sum in the .dsc file.
-        """
-        chunk_size = 1073741824
-        fd = open(name, 'rb')
-        res = hashlib.md5()
-        if not md5sum:
-            assert self.files, "I have no files"
-            md5sum = [x[0] for x in self.files if x[2] == name][0]
-        data = fd.read(chunk_size)
-        while data:
-            res.update(data)
-            data = fd.read(chunk_size)
-        if res.hexdigest() != md5sum:
-            return (False, name, "Expected md5sum of %r, got %r" % \
-                                 (md5sum, res.hexdigest()))
-        return (True, name, None)
-
-    def is_native(self):
-        """
-        is_native()
-        Returns True if this .dsc describes a native debian package;
-        else false.
-        """
-        return len(self.files) == 1
-
-    # Access to fields in the .dsc via a dict-like interface
-    def __getitem__(self, item):
-        """
-        x.__getitem(item) -> x[item]
-        """
-        return self.entries.__getitem__(item)
-
-    def __contains__(self, item):
-        """
-        x.__contains__(item) -> item in x
-        """
-        return self.entries.__contains__(item)
-
-    def __getattr__(self, attr):
-        """
-        x.__getattr__(attr) -> item.attr
-        """
-        return getattr(self.entries, attr)
-
-def error(ret, msg, *args):
-    """Prints an error message, unless quiet is set, and exits with ret"""
-    if not Quiet:
-        print >> sys.stderr, msg % args
-    sys.exit(ret)
-
-def debug(msg, *args):
-    """If debugging is enabled, print a message"""
-    if Debug:
-        print >> sys.stderr, msg % args
-
-def info(msg, *args):
-    """If verbose is enabled, print a message"""
-    if Verbose:
-        print msg % tuple(args)
-
-def status(msg, *args):
-    """Prints a message, unless quiet is enabled"""
-    if not Quiet:
-        print msg % tuple(args)
-
-def download(dscinfo, number, filename, verify=True):
-    """download filename"""
-    ftype = filename.endswith(".diff.gz") and "diff.gz" or \
-        filename.endswith(".orig.tar.gz") and "orig.tar.gz" or \
-        filename.endswith(".dsc") and "dsc" or "tar.gz"
-    if verify and os.path.exists(filename):
-        info('Verifying "%s"', filename)
-        res = dscinfo.verify(filename)
-        if not res[0]:
-            error(104, "Verification of %s failed: %s", filename, res[2])
-    status("Getting %s", filename)
-    debug("%s%s/%s", BASE_URL, number, filename)
-    try:
-        fd = urllib2.urlopen("%s%s/%s" % (BASE_URL, number, filename))
-        outfd = open(filename, 'wb')
-        outfd.write(fd.read())
-        fd.close()
-        outfd.close()
-    except urllib2.HTTPError, err:
-        status("Failed to fetch «%s» file, aborting.", ftype)
-        error(106, "Error: (%d %s)", err.code, err.msg)
-    except urllib2.URLError, err:
-        status("Failed to fetch «%s» file, aborting.", ftype)
-        error(105, "Error: %s", err)
-    except IOError, err:
-        status('Could not create "%s"', filename)
-        error(107, "Error: %s", err)
-
-def unpack(filename):
-    out = open('/dev/null', 'w')
-    err = open('/dev/null', 'w')
-    cmd = ["dpkg-source", "-x", filename]
-    ret = subprocess.call(cmd, stdout=out, stderr=err)
-    out.close()
-    err.close()
-    if ret:
-        status("Failed to unpack source, aborting.")
-        sys.exit(108)
-
-def get_host(url):
-    return urllib2.splithost(urllib2.splittype(url)[1])[0]
-
-def main():
-    global Debug, Verbose, Quiet
-    parser = optparse.OptionParser(usage=USAGE)
-    parser.add_option("-d", "--debug", action="store_true", dest="debug",
-                      default=False, help="Enable debugging")
-    parser.add_option("-v", "--verbose", action="store_true", dest="verbose",
-                      default=False, help="Enable verbose output")
-    parser.add_option("-q", "--quiet", action="store_true", dest="quiet",
-                      default=False, help="Never print any output")
-
-    (options, args) = parser.parse_args()
-    if len(args) != 1:
-        parser.error("Missing URL")
-    Debug = options.debug
-    Verbose = options.verbose
-    Quiet = options.quiet
-    if Verbose and Quiet:
-        error(4, "Specifying both --verbose and --quiet does not make sense")
-    if Quiet:
-        sys.stderr = cStringIO.StringIO()
-        sys.stdout = cStringIO.StringIO()
-
-    url = args[0]
-
-    if url.startswith("https://"):
-        url = url.replace("https://", "http://", 1)
-
-    if not url.startswith("http://"):
-        url = "http://" + url
-
-    if get_host(url).startswith("www."):
-        url = url.replace("www.", "", 1)
-
-    if get_host(url) != get_host(BASE_URL):
-        error(1, "Error: This utility only works for files on %s.\n"
-                 "Maybe you want to try dget?", BASE_URL)
-
-    (number, filename) = url.split('/')[3:]
-
-    if not filename.endswith('.dsc'):
-        error(2, "You have to provide the URL for the .dsc file.")
-
-    try:
-        number = int(number)
-    except:
-        error(3, "Bad URL format")
-
-    if os.path.exists(filename):
-        os.remove(filename)
-
-    download(None, number, filename, False)
-    try:
-        fd = open(filename)
-        dsc_data = fd.read()
-        fd.close()
-    except Exception:
-        status("Error: Please report this bug, providing the URL and attach"
-               " the following backtrace")
-        raise
-
-    dscinfo = DscParse(dsc_data)
-
-# launchpadlibrarian.net seems to store in this order:
-# For native packages:
-# <number>/.changes
-# <number>+1/.tar.gz
-# <number>+2/.dsc
-# For non-native packages:
-# <number>/.changes
-# <number>+1/.orig.tar.gz
-# <number>+2/.diff.gz
-# <number>+3/.dsc
-##
-# *Assuming* this does not change, we can figure out where the files are on
-# launchpadlibrarian.net relative to the .dsc file we're given.
-
-# Only one file listed in the .dsc means it's native package
-    if len(dscinfo.files) == 1:
-        download(dscinfo, number-1, dscinfo.files[0][-1]) # .tar.gz
-    else:
-        download(dscinfo, number-1, dscinfo.files[1][-1]) # .diff.gz
-        download(dscinfo, number-2, dscinfo.files[0][-1]) # .orig.tar.gz
-
-    status("Unpacking")
-    unpack(filename)
-
-if __name__ == "__main__":
-    main()

doc/404main.1

@@ -1,29 +0,0 @@
-.TH 404main 1 "February 17, 2008" "ubuntu-dev-tools"
-
-.SH NAME
-404main \- check if all build dependencies of a package are in main
-
-.SH SYNOPSIS
-\fB404main\fP <\fIpackage name\fP> [<\fIdistribution\fP>]
-
-.SH DESCRIPTION
-\fB404main\fP is a script that can be used to check if a package and
-all its build dependencies are in Ubuntu's main component or not.
-
-.SH CAVEATS
-\fB404main\fP will take the dependencies and build dependencies of the
-packages from the distribution you have first in your
-/etc/apt/sources.list file.
-.PP
-Also, because of this the <\fIdistribution\fP> option is NOT trustworthy; if
-the dependencies changed YOU WILL GET INCORRECT RESULTS.
-
-.SH SEE ALSO
-.BR apt-cache (8)
-
-.SH AUTHORS
-\fB404main\fP was written by Pete Savage <petesavage@ubuntu.com> and
-this manpage by Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>.
-.PP
-Both are released under the GNU General Public License, version 2 or
-later.

doc/backportpackage.1

@@ -10,10 +10,11 @@ backportpackage \- helper to test package backports
 .PP
 .B backportpackage \-h
 .SH DESCRIPTION
-\fBbackportpackage\fR fetches a package from one Ubuntu release or
-from a specified .dsc path or URL and creates a no-change backport of
-that package to a previous release, optionally doing a test build of
-the package and/or uploading the resulting backport for testing.
+\fBbackportpackage\fR fetches a package from one distribution release
+or from a specified .dsc path or URL and creates a no-change backport
+of that package to one or more Ubuntu releases release, optionally
+doing a test build of the package and/or uploading the resulting
+backport for testing.
 .PP
 Unless a working directory is specified, the backported package is
 fetched and built in a temporary directory in \fB/tmp\fR, which is
@@ -29,18 +30,19 @@ is unspecified, then \fBbackportpackage\fR defaults to the release on
 which it is currently running.
 .TP
 .B \-s \fISOURCE\fR, \fB\-\-source\fR=\fISOURCE\fR
-Backport the package from the specified Ubuntu release. If neither
-this option nor \fB\-\-version\fR are specified, then
-\fBbackportpackage\fR defaults to the current Ubuntu development
-release.
+Backport the package from the specified release, which can be any
+release of your distribution or any of your distribution's parent
+distributions. If neither this option nor \fB\-\-version\fR are
+specified, then \fBbackportpackage\fR defaults to the current
+development release for your distribution.
 .TP
 .B \-S \fISUFFIX\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
 Add the specified suffix to the version number when
 backporting. \fBbackportpackage\fR will always append
-~\fIDESTINATION\fR1 to the original version number, and if
+~ubuntu\fIDESTINATION\fR.1 to the original version number, and if
 \fISUFFIX\fR is specified, it is appended to that, to get version
 numbers of the form
-\fIORIGINAL_VERSION\fR~\fIDESTINATION\fR1\fISUFFIX\fR. If the
+\fIORIGINAL_VERSION\fR~ubuntu\fIDESTINATION\fR.1\fISUFFIX\fR. If the
 backported package is being uploaded to a PPA, then \fISUFFIX\fR
 defaults to \fB~ppa1\fR, otherwise the default is blank.
 .TP
@@ -63,6 +65,12 @@ Update the build environment before attempting to build.
 .B \-u \fIUPLOAD\fR, \fB\-\-upload\fR=\fIUPLOAD\fR
 Upload to \fIUPLOAD\fR with \fBdput\fR(1) (after confirmation).
 .TP
+.B \-k \fIKEYID\fR, \fB\-\-key\fR=\fIKEYID\fR
+Specify the key ID to be used for signing.
+.TP
+.B \-\-dont\-sign
+Do not sign the upload.
+.TP
 .B \-y\fR, \fB\-\-yes
 Do not prompt before uploading to a PPA. For everyone's safety, this
 option is ignored if \fIUPLOAD\fR is \fBubuntu\fR.
@@ -72,9 +80,10 @@ If the \fB\-\-source\fR option is specified, then
 \fBbackportpackage\fR verifies that the current version of \fIsource
 package\fR in \fISOURCE\fR is the same as \fIVERSION\fR. Otherwise,
 \fBbackportpackage\fR finds version \fIVERSION\fR of \fIsource
-package\fR, regardless of the release in which it was published (or if
-that version is still current). This option is ignored if a .dsc URL
-or path is passed in instead of a source package name.
+package\fR in your distribution's publishing history, regardless of
+the release in which it was published (or if that version is still
+current). This option is ignored if a .dsc URL or path is passed in
+instead of a source package name.
 .TP
 .B \-w \fIWORKDIR\fR, \fB\-\-workdir\fR=\fIWORKDIR\fR
 If \fIWORKDIR\fR is specified, then all files are downloaded,
@@ -82,12 +91,23 @@ unpacked, built into, and otherwise manipulated in
 \fIWORKDIR\fR. Otherwise, a temporary directory is created, which is
 deleted before \fIbackportpackage\fR exits.
 .TP
-.B \-m \fIUBUNTU_MIRROR\fR, \fB\-\-mirror\fR=\fIUBUNTU_MIRROR\fR
+.B \-r\fR, \fB\-\-release\-pocket
+Target the upload at the release pocket, rather than the
+\fB\-backports\fR pocket.
+This is required for Launchpad PPAs, which are pocket-less (and the
+default, when the upload target is a PPA).
+.TP
+.B \-m \fIMIRROR\fR, \fB\-\-mirror\fR=\fIMIRROR\fR
 Use the specified mirror.
 Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR.
 If the package isn't found on this mirror, \fBbackportpackage\fR
 will use Launchpad.
 .TP
+.B \-c \fIBUG\fR, \fB\-\-close\fR=\fIBUG\fR
+Include a Launchpad closer for the specified bug in the auto-generated
+changelog. In the future, this may actually close the bug, but
+currently does not.
+.TP
 .B \-l \fIINSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
 Use the specified instance of Launchpad (e.g. "staging"), instead of
 the default of "production".
@@ -120,11 +140,19 @@ The default value for \fB\-\-builder\fR.
 .BR BACKPORTPACKAGE_UPDATE_BUILDER ", " UBUNTUTOOLS_UPDATE_BUILDER
 The default value for \fB--update\fR.
 .TP
+.B BACKPORTPACKAGE_UPLOAD
+The default value for \fB--upload\fR.
+.TP
 .BR BACKPORTPACKAGE_WORKDIR ", " UBUNTUTOOLS_WORKDIR
 The default value for \fB--workdir\fR.
 .TP
 .BR BACKPORTPACKAGE_UBUNTU_MIRROR ", " UBUNTUTOOLS_UBUNTU_MIRROR
-The default value for \fB\-\-mirror\fR.
+The default value for \fB\-\-mirror\fR if the specified \fISOURCE\fR
+release is an Ubuntu release.
+.TP
+.BR BACKPORTPACKAGE_DEBIAN_MIRROR ", " UBUNTUTOOLS_DEBIAN_MIRROR
+The default value for \fB\-\-mirror\fR if the specified \fISOURCE\fR
+release is a Debian release.
 .TP
 .BR BACKPORTPACKAGE_LPINSTANCE ", " UBUNTUTOOLS_LPINSTANCE
 The default value for \fB--lpinstance\fR.

doc/debian-distro-info.1

@@ -1,54 +0,0 @@
-.\" Copyright (c) 2009-2011, Benjamin Drung <bdrung@ubuntu.com>
-.\"
-.\" Permission to use, copy, modify, and/or distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.\"
-.TH DEBIAN\-DISTRO\-INFO "1" "January 2011" "ubuntu\-dev\-tools"
-.SH NAME
-debian\-distro\-info \- provides information about Debian's distributions
-.SH SYNOPSIS
-.B debian\-distro\-info
-[\fIOPTIONS\fR]
-.SH OPTIONS
-.TP
-\fB\-\-date\fR=\fIDATE
-date for calculating the version (default: today)
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-display help message and exit
-.TP
-\fB\-a\fR, \fB\-\-all\fR
-list all known versions
-.TP
-\fB\-d\fR, \fB\-\-devel\fR
-latest development version
-.TP
-\fB\-o\fR, \fB\-\-old\fR
-latest old (stable) version
-.TP
-\fB\-s\fR, \fB\-\-stable\fR
-latest stable version
-.TP
-\fB\-\-supported\fR
-list of all supported stable versions
-.TP
-\fB\-t\fR, \fB\-\-testing\fR
-latest testing version
-.TP
-\fB\-\-unsupported\fR
-list of all unsupported stable versions
-.SH SEE ALSO
-.BR distro\-info (1),
-.BR ubuntu\-distro\-info (1)
-.SH AUTHOR
-The script and this manual page was written by
-Benjamin Drung <bdrung@ubuntu.com>.

doc/dgetlp.1

@@ -1,38 +0,0 @@
-.TH DGETLP "1" "27 August 2008" "ubuntu-dev-tools"
-
-.SH NAME
-dgetlp \- simulate ``dget'' behaviour for files hosted at librarian.launchpad.net
-
-.SH SYNOPSIS
-.B dgetlp [\fB\-d\fP|\fB(\fB\-v\fP|\fB\-q\fP)\fP] <\fBLaunchpad DSC URL\fP>
-
-.SH DESCRIPTION
-\fBdgetlp\fR simulates dget behaviour by downloading and extracting the <\fBLaunchpad DSC URL\fP> from the Launchpad Librarian.
-
-.SH OPTIONS
-Listed below are the command line options for dgetlp:
-.TP
-.B \-h, \-\-help
-show this help message and exit.
-.TP
-.B \-d, \-\-debug
-Enable debugging.
-.TP
-.B \-v, \-\-verbose
-Enable verbose output.
-.TP
-.B \-q, \-\-quiet
-Never print any output.
-.TP
-.B <Launchpad DSC URL>
-This is the source package that you would like to be downloaded from the Launchpad Librarian.
-
-.SH EXAMPLE
-.B dgetlp http://launchpadlibrarian.net/10348157/coreutils_5.97-5.4ubuntu1.dsc
-
-.SH AUTHOR
-\fBdgetlp\fR was written by Terence Simpson <tsimpson@ubuntu.com> and
-modified by Siegfried-A. Gevatter <rainct@ubuntu.com>. The python rewrite
-was written by Terence Simpson <tsimpson@ubuntu.com> based off the original.
-This man page was written by Ryan Kavanagh <ryanakca@kubuntu.org>.
-Both are released under the GNU General Public License, version 2 or later.

doc/distro-info.1

@@ -1,58 +0,0 @@
-.\" Copyright (c) 2009-2011, Benjamin Drung <bdrung@ubuntu.com>
-.\"
-.\" Permission to use, copy, modify, and/or distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.\"
-.TH DISTRO\-INFO "1" "January 2011" "ubuntu\-dev\-tools"
-.SH NAME
-distro\-info \- provides information about the distributions' releases
-.SH SYNOPSIS
-.B distro\-info
-[\fIOPTIONS\fR]
-.SH DESCRIPTION
-.B distro\-info
-is a symlink to the distro\-info command for your distribution.
-On Debian it links to
-.B debian\-distro\-info
-and on Ubuntu it links to \fBubuntu\-distro\-info\fR.
-All options described in this manual page are available in all
-.B distro\-info
-commands. All other options, which are not described here, are distribution
-specific.
-.SH OPTIONS
-.TP
-\fB\-\-date\fR=\fIDATE
-date for calculating the version (default: today)
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-display help message and exit
-.TP
-\fB\-a\fR, \fB\-\-all\fR
-list all known versions
-.TP
-\fB\-d\fR, \fB\-\-devel\fR
-latest development version
-.TP
-\fB\-s\fR, \fB\-\-stable\fR
-latest stable version
-.TP
-\fB\-\-supported\fR
-list of all supported stable versions
-.TP
-\fB\-\-unsupported\fR
-list of all unsupported stable versions
-.SH SEE ALSO
-.BR debian\-distro\-info (1),
-.BR ubuntu\-distro\-info (1)
-.SH AUTHOR
-The script and this manual page was written by
-Benjamin Drung <bdrung@ubuntu.com>.

doc/get-branches.1

@@ -1,47 +0,0 @@
-.TH get\-branches "1" "11 August 2008" "ubuntu-dev-tools"
-.SH NAME
-get\-branches - downloads all branches related to a Launchpad team or person
-
-.SH SYNOPSIS
-.B get\-branches
-.RB [ \-d
-.IR directory ]
-.RB [ \-o
-.BR branch | checkout ]
-.B \-t
-.I team
-.br
-.B get\-branches
-.I team
-.br
-.B get\-branches \-\-help
-
-.SH DESCRIPTION
-\fBget\-branches\fR uses the LP API to get a list of branches for a person or
-team and calls Bazaar to download all branches.
-
-.SH OPTIONS
-Listed below are the command line options for \fBget\-branches\fR:
-.TP
-.BR \-h ", " \-\-help
-Display a help message and exit.
-.TP
-.BR \-d ", " \-\-directory
-Download branches to a directory other than the current directory.
-.TP
-.BR \-o ", " \-\-operation
-Specifies which Bazaar operation to use when downloading the branches; may be
-either \fIbranch\fR or \fIcheckout\fR.
-.TP
-.BR \-t ", "  \-\-team
-Specifies which Launchpad team/person to download branches from.
-This option is required.
-
-.SH AUTHORS
-\fBget\-branches\fR was written by Daniel Holbach <daniel.holbach@ubuntu.com>,
-and this manual page was written by Jonathan Patrick Davies <jpds@ubuntu.com>.
-.PP
-Both are released under the terms of the GNU General Public License, version 3.
-
-.SH SEE ALSO
-.B bzr(1)

doc/get-build-deps.1

@@ -1,60 +0,0 @@
-.TH GET\-BUILD\-DEPS 1 "October 27, 2007" "ubuntu-dev-tools"
-
-.SH NAME
-get\-build\-deps \- install build dependencies for one or more packages
-
-.SH SYNOPSIS
-\fBget\-build\-deps\fP [\fIpackage name\fR]
-
-.SH DESCRIPTION
-\fBget\-build\-deps\fP is a script to install the build dependencies for
-either a local source package or one or more packages from the repositories.
-.PP
-In order to obtain all missing build dependencies for a package on
-which source you are currently working, just run this script without
-any argument, and it'll read its debian/control file to determine the
-missing build dependencies.
-.PP
-Alternatively, you can call it with a list of space-separated package
-names, or the name of a single file which contains the package names
-each on a line.
-Then it will install the missing dependencies for those packages using
-"apt\-get build\-dep".
-
-.SH EXAMPLES
-.TP
-get\-build\-deps
-Looks for a debian/control file in the current working directory and
-installs the dependencies listed there.
-.TP
-get\-build\-deps geany
-Installs the build dependencies for the version of \fBgeany\fP that's
-in the repositories.
-.TP
-get\-build\-deps geany epiphany\-browser rhythmbox
-Same as the previous example but also with the dependencies for
-.B epiphany\-browser
-and
-.BR rhythmbox .
-.TP
-get\-build\-deps ./package_list.txt
-Reads the file
-.B package_list.txt
-(relative to the current working directory),
-where each line contains the name of a package, and installs the
-dependencies for the versions of all those that are in the repositories.
-
-.SH KNOWN BUGS AND LIMITATIONS
-When it's being used to install the missing dependencies for a local
-source package (i.e., no arguments are passed to it) it doesn't check
-for the dependencies to match the indicated versions, but just installs
-the newest one available in the repositories.
-
-.SH SEE ALSO
-.BR dpkg\-checkbuilddeps (1),
-.BR apt\-get (8)
-
-.SH AUTHORS
-\fBget\-build\-deps\fP and this manual page have been written by Siegfried-Angel
-Gevatter Pujals <rainct@ubuntu.com>.
-They are released under the GNU General Public License, version 3 or later.

doc/grab-attachments.1

@@ -1,49 +0,0 @@
-.TH GRAB\-ATTACHMENTS "1" "10 August 2008" "ubuntu-dev-tools"
-.SH NAME
-grab\-attachments \- downloads attachments from a Launchpad bug
-.SH SYNOPSIS
-.B grab\-attachments\fR [\fIoptions\fR] \fIbug-number\fR...
-.br
-.B grab\-attachments \-h
-.SH DESCRIPTION
-\fBgrab\-attachments\fR is a script to download all attachments from a
-Launchpad bug report into the a directory named after the bug e.g. bug-1.
-
-.SH OPTIONS
-Listed below are the command line options for grab\-attachments:
-.TP
-.I bug-number
-Specifies the Launchpad bug number that the script should download
-attachments from.
-.TP
-.BR \-h ", " \-\-help
-Display a help message and exit.
-.TP
-.B \-l \fIINSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
-Use the specified instance of Launchpad (e.g. "staging"), instead of
-the default of "production".
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
-.SH ENVIRONMENT
-All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
-environment variables.
-Variables in the environment take precedence to those in configuration
-files.
-.SH CONFIGURATION VARIABLES
-The following variables can be set in the environment or in
-.BR ubuntu\-dev\-tools (5)
-configuration files.
-In each case, the script\-specific variable takes precedence over the
-package\-wide variable.
-.TP
-.BR GRAB_ATTACHMENTS_LPINSTANCE ", " UBUNTUTOOLS_LPINSTANCE
-The default value for \fB--lpinstance\fR.
-.SH SEE ALSO
-.BR ubuntu\-dev\-tools (5)
-.SH AUTHOR
-\fBgrab\-attachments\fR was written by Daniel Holbach and this manual page
-was written by Jonathan Patrick Davies.
-.PP
-Both are released under the GNU General Public License, version 2.

doc/harvest.1

@@ -1,19 +0,0 @@
-.TH harvest 1 "March 21, 2011" "ubuntu-dev-tools"
-
-.SH NAME
-harvest \- grabs information about a given source package from harvest.ubuntu.com.
-
-.SH SYNOPSIS
-\fBharvest\fP <\fIsource package name\fP>
-
-.SH DESCRIPTION
-\fBharvest\fP is a script that downloads information about development
-opportunities from harvest.ubuntu.com and gives a summary of the types of
-opportunities.
-
-.SH AUTHORS
-\fBharvest\fP and its manpage were written by Daniel Holbach
-<daniel.holbach@ubuntu.com>.
-.PP
-Both are released under the GNU General Public License, version 3 or
-later.

doc/hugdaylist.1

@@ -1,26 +0,0 @@
-.TH HUGDAYLIST "1" "August 27, 2008" "ubuntu-dev-tools"
-
-.SH NAME
-hugdaylist \- produce MoinMoin wiki formatted tables based on a Launchpad bug list
-
-.SH SYNOPSIS
-.B hugdaylist [\fB\-n\fP|\fB\-\-number <NUMBER>\fP] \fBlaunchpad-buglist-url\fP
-
-.SH DESCRIPTION
-\fBhugdaylist\fP produces MoinMoin wiki formatted tables based on a
-Launchpad bug list
-
-.SH OPTIONS
-.TP
-\fB\-\-number=<NUMBER>\fP
-This option allows you to specify the number of entries to output.
-.TP
-\fBlaunchpad-buglist-url\fP
-Required, this option is a URL pointing to a launchpad bug list.
-
-.SH AUTHOR
-\fBhugdaylist\fP has been written by Canonical Ltd., Daniel Holbach
-<daniel.holbach@canonical.com> and Jonathan Patrick Davies <jpds@ubuntu.com>.
-This manual page was written by Ryan Kavanagh <ryanakca@kubuntu.org>.
-.PP
-Both are released under the GNU General Public License, version 3.

doc/lp-bitesize.1

@@ -1,21 +1,21 @@
-.TH bitesize "1" "May 9 2010" "ubuntu-dev-tools"
+.TH lp-bitesize "1" "May 9 2010" "ubuntu-dev-tools"
 .SH NAME
-bitesize \- Add \fBbitesize\fR tag to bugs and add a comment.
+lp-bitesize \- Add \fBbitesize\fR tag to bugs and add a comment.
 
 .SH SYNOPSIS
-.B bitesize \fR<\fIbug number\fR>
+.B lp-bitesize \fR<\fIbug number\fR>
 .br
-.B bitesize \-\-help
+.B lp-bitesize \-\-help
 
 .SH DESCRIPTION
-\fBbitesize\fR adds a bitesize tag to the bug, if it's not there yet. It
+\fBlp-bitesize\fR adds a bitesize tag to the bug, if it's not there yet. It
 also adds a comment to the bug indicating that you are willing to help with
 fixing it.
 It checks for permission to operate on a given bug first,
 then perform required tasks on Launchpad.
 
 .SH OPTIONS
-Listed below are the command line options for \fBbitesize\fR:
+Listed below are the command line options for \fBlp-bitesize\fR:
 .TP
 .BR \-h ", " \-\-help
 Display a help message and exit.
@@ -48,7 +48,7 @@ The default value for \fB--lpinstance\fR.
 .BR ubuntu\-dev\-tools (5)
 
 .SH AUTHORS
-\fBbitesize\fR and this manual page were written by Daniel Holbach
+\fBlp-bitesize\fR and this manual page were written by Daniel Holbach
 <daniel.holbach@canonical.com>.
 .PP
 Both are released under the terms of the GNU General Public License, version 3.

doc/lp-list-bugs.1

@@ -1,27 +0,0 @@
-.TH lp\-list\-bugs 1 2010-09-17 ubuntu-dev-tools
-.SH NAME
-lp\-list\-bugs \- briefly list status of Launchpad bugs
-.SH DESCRIPTION
-.B lp\-list\-bugs
-takes one or more Launchpad bug numbers, and lists the status of each bug in a
-concise format.
-For example:
-.PP
-.RS
-.nf
-$ lp\-list\-bugs 3
-Bug 3: Custom information for each translation team
-  rosetta: Fix Released
-  ubuntu: Invalid
-  mono (Ubuntu): Invalid
-.fi
-.RE
-.SH OPTIONS
-.TP
-.BR \-h ", " \-\-help
-Display a help message and exit.
-.SH AUTHORS
-.B lp\-list\-bugs
-and this manual page were written by Colin Watson <cjwatson@ubuntu.com>.
-Both are released under the terms of the GNU General Public License, version
-3 or later.

doc/lp-project-upload.1

@@ -1,20 +0,0 @@
-.TH lp-project-upload "1" "05 September 2009" "ubuntu-dev-tools"
-.SH NAME
-lp\-project\-upload \- Upload a release tarball to a Launchpad project.
-
-.SH SYNOPSIS
-.B lp\-project\-upload
-.I project-name version tarball [new milestone]
-
-.SH DESCRIPTION
-\fBlp\-project\-upload\fR uploads a tarball release of a project to Launchpad.
-It can create milestones and releases on the fly after confirmation.
-
-If there is a file \fItarball\fB.asc\fR, it is uploaded as the signature of the
-tarball.
-
-.SH AUTHORS
-\fBlp\-project\-upload\fR was written by Martin Pitt <martin.pitt@ubuntu.com>.
-.PP
-It is released under the terms of the GNU General Public License, version 2
-or (at your option) any later version.

doc/lp-set-dup.1

@@ -1,56 +0,0 @@
-.TH lp\-set\-dup "1" "March 6 2010" "ubuntu-dev-tools"
-.SH NAME
-lp\-set\-dup \- mark one or more bugs as duplicate of another bug
-
-.SH SYNOPSIS
-.B lp\-set\-dup \fR[\fB\-f\fR] <\fImain bug\fR> <\fIduplicate bug\fR>
-[<\fIduplicate bug\fR> ...]
-.br
-.B lp\-set\-dup \-\-help
-
-.SH DESCRIPTION
-\fBlp\-set\-dup\fR allow to easily mark one or more bug as duplicate of
-another bug. It checks for permission to operate on a given bug first,
-then perform required tasks on Launchpad.
-
-.SH OPTIONS
-Listed below are the command line options for \fBlp\-set\-dup\fR:
-.TP
-.BR \-h ", " \-\-help
-Display a help message and exit.
-.TP
-.B \-f
-Skip confirmation prompt.
-.TP
-.B \-l \fIINSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
-Use the specified instance of Launchpad (e.g. "staging"), instead of
-the default of "production".
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
-
-.SH ENVIRONMENT
-All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
-environment variables.
-Variables in the environment take precedence to those in configuration
-files.
-
-.SH CONFIGURATION VARIABLES
-The following variables can be set in the environment or in
-.BR ubuntu\-dev\-tools (5)
-configuration files.
-In each case, the script\-specific variable takes precedence over the
-package\-wide variable.
-.TP
-.BR LP_SET_DUP_LPINSTANCE ", " UBUNTUTOOLS_LPINSTANCE
-The default value for \fB--lpinstance\fR.
-
-.SH SEE ALSO
-.BR ubuntu\-dev\-tools (5)
-
-.SH AUTHORS
-\fBlp\-set\-dup\fR was written by Loïc Minier <lool@dooz.org>,
-and this manual page was written by Luca Falavigna <dktrkranz@debian.org>.
-.PP
-Both are released under the terms of the GNU General Public License, version 2.

doc/lp-shell.1

@@ -1,42 +0,0 @@
-.TH lp-shell "1" "27 March 2010" "ubuntu-dev-tools"
-.SH NAME
-lp\-shell \- Open an interactive launchpadlib shell.
-
-.SH SYNOPSIS
-.B lp\-shell
-.RB [ \-a ]
-.RI [ service ]
-.RI [ "LP API version" ]
-
-.SH DESCRIPTION
-.B lp\-shell
-opens an interactive Python shell with a launchpadlib.Launchpad object "lp"
-which is ready for use.
-
-It authenticates against Launchpad with the consumer name "udt-lp-shell". When
-using \fBlp\-shell\fR with the \fB\-a\fR option it will use the anonymous login
-from launchpadlib.Launchpad.
-
-By default \fBlp\-shell\fR connects to the "\fIproduction\fR" Launchpad service
-using the "\fI1.0\fR" LP API version.
-
-If you want to connect to another Launchpad service, call \fBlp\-shell\fR with
-the service name as the second argument. \fBlp\-shell\fR supports all services
-known by launchpadlib Python module.
-Currently known are (list can be incomplete or outdated): "production",
-"staging", "dogfood".
-
-A different LP API version can be selected by passing the API version to use as
-the third argument. Current supported are: "beta", "1.0" and "devel".
-
-.SH OPTIONS
-.TP
-.B \-a
-Login anonymously into Launchpad.
-
-.SH AUTHORS
-.B lp\-shell
-was written by Martin Pitt <martin.pitt@ubuntu.com>.
-.PP
-It is released under the terms of the GNU General Public License, version 2
-or (at your option) any later version.

doc/massfile.1

@@ -1,71 +0,0 @@
-.TH MASSFILE "1" "June 2010" "ubuntu-dev-tools"
-.SH NAME
-\fBmassfile\fR \- script for massfiling bugs against Ubuntu packages
-
-.SH SYNOPSIS
-\fBmassfile\fR [\fIoptions\fR]
-
-.SH DESCRIPTION
-\fBmassfile\fR is a script for massfiling bugs against Ubuntu packages in Launchpad. It requires an instructions file describing the contents of the bug report and a list file which lists the packages which the bug will be filed against.
-
-Templates for both files can be found in /usr/share/doc/ubuntu-dev-tools/examples.
-
-.SH OPTIONS
-.TP
-.B \-l \fIINSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
-Use the specified instance of Launchpad (e.g. "staging"), instead of
-the default of "production".
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
-
-.SH EXAMPLES
-\fBinstructions\fR - file designating the contents of the bug report
-
- subject: [UNMETDEPS] $pack has unmet dependencies
- assignee:
- status: confirmed
- subscribers: motu
- tags: unmetdeps
- buglist-url: http://bugs.launchpad.net/ubuntu/+bugs?field.tag=unmetdeps
- text:
-  A run of
-  .
-   LC_ALL=C apt-cache \-i unmet | grep ^Package | cut \-d' ' \-f2 | grep
-   \-v dbgsym | sort \-u | xargs apt-cache showsrc | grep ^Directory |
-   sed 's/Package\:\ //g' | grep verse | cut \-d'/' \-f4
-  indicates that the source package $pack has binary packages that are
-  not installable (on AMD64) at the moment.
-  .
-  Please have a look and make sure it's installable again.
-
-\fBlist\fR - file designating the packages affected
-
-Each package should be listed on a new line as follows:
-
- z88dk
- zope-quotafolder
-
-.SH ENVIRONMENT
-All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
-environment variables.
-Variables in the environment take precedence to those in configuration
-files.
-
-.SH CONFIGURATION VARIABLES
-The following variables can be set in the environment or in
-.BR ubuntu\-dev\-tools (5)
-configuration files.
-In each case, the script\-specific variable takes precedence over the
-package\-wide variable.
-.TP
-.BR MASSFILE_LPINSTANCE ", " UBUNTUTOOLS_LPINSTANCE
-The default value for \fB--lpinstance\fR.
-
-.SH AUTHORS
-\fBmassfile\fR was written by Iain Lane <iain@orangesquash.org.uk>, Daniel Hahler <ubuntu@thequod.de>. and Markus Korn <thekorn@gmx.de>.
-
-This manual page was written by Andrew Starr-Bochicchio <a.starr.b@gmail.com>.
-.PP
-Both are released under the terms of the GNU General Public License, version 3.

doc/mk-sbuild.1

@@ -15,6 +15,10 @@ Listed below are the command line options for mk\-sbuild:
 .B \-\-arch\fR=\fIARCH
 What architecture to select (defaults to the native architecture).
 .TP
+.B \-\-target\fR=\fRARCH
+Set up the chroot as a cross-building environment targeting the specified
+architecture.
+.TP
 .B \-\-name\fR=\fINAME
 Base name for the schroot (arch is appended).
 .TP
@@ -28,6 +32,10 @@ Turn on script debugging.
 Do not include the \fB\-updates\fR pocket in the installed
 \fBsources.list\fR.
 .TP
+.B \-\-skip\-proposed
+Do not include the \fB\-proposed\fR pocket in the installed
+\fBsources.list\fR.
+.TP
 .B \-\-source\-template\fR=\fIFILE
 Use \fIFILE\fR as the \fBsources.list\fR template (defaults to
 \fI$HOME\fB/.mk\-sbuild.sources\fR).
@@ -47,6 +55,24 @@ Pass along a comma separated list of packages to debootstrap's
 \fBWARNING:\fR be careful using this option as you can end up
 excluding essential package. See \fBdebootstrap \fR(8) for more details.
 .TP
+.B \-\-debootstrap\-keyring\fR=\fIkeyring
+Pass along the path to a gpg keyring file to debootsrap's
+\fB\-\-keyring\fR argument. See \fBdebootstrap\fR (8) for more details.
+.TP
+.B \-\-debootstrap\-no\-check\-gpg
+Disable checking gpg signatures of downloaded Release files by using
+debootstrap's \fB\-\-no\-check\-gpg\fR option. See \fBdebootstrap\fR (8)
+for more details.
+.TP
+.B \-\-debootstrap\-proxy\fR=\fIPROXY
+Use \fIPROXY\fR as apt proxy.
+.TP
+.B \-\-eatmydata
+Install and use eatmydata (default)
+.TP
+.B \-\-skip\-eatmydata
+Don't install and use eatmydata
+.TP
 .B \-\-distro\fR=\fIDISTRO
 Enable distro-specific logic.
 When not provided, the distribution is determined from \fIrelease\fR.
@@ -54,12 +80,34 @@ Currently known distros: "\fBdebian\fR" and "\fBubuntu\fR".
 .TP
 .B \-\-vg\fR=\fIVOLUME_GROUP
 Specify a volume group, and subsequently use a default \fBSCHROOT_TYPE\fR of
-"\fBlvm-snapshot\fR" rather than "\fBdirectory\fR" (via aufs) mounts.
+"\fBlvm-snapshot\fR" rather than "\fBdirectory\fR" (via overlayfs or
+aufs) mounts.
+.TP
+.B \-\-zfs-dataset=\fIDATASET
+Specify a zfs dataset, and subsequently use a default \fBSCHROOT_TYPE\fR of
+"\fBzfs-snapshot\fR" rather than "\fBdirectory\fR" (via overlayfs or
+aufs) mounts.
 .TP
 .B \-\-type\fR=\fISHROOT_TYPE
 Specify a \fBSCHROOT_TYPE\fR.  Supported values are "\fBdirectory\fR"
 (default if \fB\-\-vg\fR not specified), "\fBlvm-snapshot\fR" (default
-if \fB\-\-vg\fR specified), "\fBbtrfs-snapshot\fR", and "\fBfile\fR".
+if \fB\-\-vg\fR specified), "\fBbtrfs-snapshot\fR", "\fBzfs-snapshot\fR"
+and "\fBfile\fR".
+.TP
+.B \-\-ccache
+Enable usage of \fBccache\fR by default. See \fBccache\fR (1) for
+more details.
+.TP
+.B \-\-ccache-dir=\fIPATH
+Use \fBPATH\fR as schroot ccache directory. This directory can be
+safely shared by multiple schroots, but they will all use the same
+\fBCCACHE_MAXSIZE\fR.
+Defaults to /var/cache/ccache-sbuild.
+See \fBccache\fR (1) for more details.
+.TP
+.B \-\-ccache-size=\fISIZE
+Sets \fBSIZE\fR as the schroot \fBCCACHE_DIR\fR max-size used by ccache.
+See \fBccache\fR (1) for more details.
 
 .SH ENVIRONMENT VARIABLES
 .TP
@@ -72,10 +120,17 @@ Size of snapshot LVs (defaults to 4G).
 .B SCHROOT_CONF_SUFFIX
 Lines to append to schroot entries.
 .TP
+.B SCHROOT_PROFILE
+Profile to use with schroot. (defaults to sbuild)
+.TP
 .B SKIP_UPDATES
 Do not include the \fB\-updates\fR pocket (same as
 \fB\-\-skip\-updates\fR)
 .TP
+.B SKIP_PROPOSED
+Do not include the \fB\-proposed\fR pocket (same as
+\fB\-\-skip\-proposed\fR)
+.TP
 .B DEBOOTSTRAP_MIRROR
 Mirror location (same as \fB\-\-debootstrap-mirror\fR)
 .TP
@@ -87,6 +142,22 @@ Comma separated list of packages to include when bootstrapping (same as
 Comma separated list of packages to exclude when bootstrapping (same as
 \fB\-\-debootstrap-exclude\fR; see warning above)
 .TP
+.B DEBOOTSTRAP_KEYRING
+Keyring file to use for checking gpg signatures of retrieved release files
+(same as \fB\-\-debootstrap\-keyring\fR)
+.TP
+.B DEBOOTSTRAP_NO_CHECK_GPG
+Disable gpg verification of retrieved release files (same as
+\fB\-\-debootstrap\-no\-check\-gpg\fR)
+.TP
+.B DEBOOTSTRAP_PROXY
+Proxy to use for apt. (same as
+\fB\-\-debootstrap\-proxy\fR)
+.TP
+.B EATMYDATA
+Enable or disable eatmydata usage, see \fB\-\-eatmydata\fR
+and \fB\-\-skip\-eatmydata\fR
+.TP
 .B SOURCE_CHROOTS_DIR
 Use \fBSOURCE_CHROOTS_DIR\fR as home of schroot source directories.
 (default \fB/var/lib/schroot/chroots\fR)
@@ -98,6 +169,18 @@ Use \fBSOURCE_CHROOTS_TGZ\fR as home of schroot source tarballs.
 .B CHROOT_SNAPSHOT_DIR
 Use \fBCHROOT_SNAPSHOT_DIR\fR as home of mounted btrfs snapshots.
 (default \fB/var/lib/schroot/snapshots\fR)
+.TP
+.B CCACHE
+Enable \fBccache\fR (1) by default.
+(defaults to \fB0\fR)
+.TP
+.B CCACHE_DIR
+Use \fBCCACHE_DIR\fR as the \fBccache\fR (1) directory.
+(default \fB/var/cache/ccache-sbuild\fR)
+.TP
+.B CCACHE_SIZE
+Use \fBCCACHE_SIZE\fR as the \fBccache\fR (1) max-size.
+(defaults to \fB4G\fR)
 
 
 .SH FILES

doc/pbuilder-dist.1

@@ -20,7 +20,7 @@ like for example \fBpbuilder\-feisty\fP, \fBpbuilder\-sid\fP, \fBpbuilder\-gutsy
 .PP
 The same applies to \fBcowbuilder\-dist\fP, which uses cowbuilder. The main
 difference between both is that pbuilder compresses the created chroot as a
-a tarball, thus using less disc space but needing to uncompress (and possibly
+tarball, thus using less disc space but needing to uncompress (and possibly
 compress) its contents again on each run, and cowbuilder doesn't do this.
 
 .SH USAGE
@@ -35,11 +35,13 @@ Replace this with the codename of the version of Ubuntu or Debian you want to us
 .TP
 \fBarchitecture\fP
 This optional parameter will attempt to construct a chroot in a foreign
-architecture.  For some architecture pairs (e.g. i386 on an amd64 install),
-the chroot will be created natively.  For others (e.g. armel on an i386
-install), qemu-static and binfmt-misc will be used.  Note that some
-combinations (e.g. amd64 on an i386 install) require special separate
-kernel handling, and may break in unexpected ways.
+architecture.
+For some architecture pairs (e.g. i386 on an amd64 install), the chroot
+will be created natively.
+For others (e.g. arm64 on an amd64 install), qemu\-user\-static will be
+used.
+Note that some combinations (e.g. amd64 on an i386 install) require
+special separate kernel handling, and may break in unexpected ways.
 .TP
 \fBoperation\fP
 Replace this with the action you want \fBpbuilder\fP to do (create, update,
@@ -58,26 +60,41 @@ building is the action you want to do.
 
 .SH OPTIONS
 .TP
-\fB--main-only\fP (deprecated: \fBmainonly\fP)
+\fB\-\-main\-only\fP (deprecated: \fBmainonly\fP)
 If you specify this option, only packages from the \fImain\fP (in Debian) or
 \fImain\fP and \fIrestricted\fP (in Ubuntu) components will be used. By
 default, all official components are enabled. This only has effect when
 creating a new environment.
 .TP
-\fB--debug-echo\fP
+\fB\-\-debug\-echo\fP
 The generated \fBpbuilder\fP/\fBcowbuilder\fP command will be printed to the
 standard output instead of being executed. This is useful for debugging.
 .TP
-\fB--buildresult\fP \fBDIRECTORY\fP (pbuilder-dist only)
+\fB\-\-buildresult\fP \fBDIRECTORY\fP (pbuilder\-dist only)
 If this option is specified, the resultant files of the \fBpbuilder\fP build
 are placed in \fBDIRECTORY\fP.
+.TP
+\fB\-\-release\-only\fP
+Only use the release pocket.
+Default for development releases.
+.TP
+\fB\-\-security\-only\fP
+Only use the release and security pockets.
+Suitable environment for preparing security updates.
+.TP
+\fB\-\-updates\-only\fP
+Only use the release, security, and updates pocket.
+Not the proposed\-updates pocket.
+.TP
+\fB\-\-backports\fP
+Also use the backports archive..
 
 .SH EXAMPLES
 .TP
 pbuilder\-dist gutsy create
 Creates a \fBpbuilder\fP environment for Ubuntu Gutsy, with all components enabled.
 .TP
-pbuilder\-sid mainonly create
+pbuilder\-sid \-\-main\-only create
 Creates a \fBpbuilder\fP environment for Debian Sid, with only the main component.
 .TP
 pbuilder\-feisty build ./sample_1.0\-0ubuntu1.dsc
@@ -104,6 +121,16 @@ saved in the results subdirectory of each build environment.
 The default authentication method is \fBsudo\fP. You can change this by
 setting the \fBPBUILDAUTH\fP variable.
 .PP
+By default, \fBpbuilder\-dist\fP use the master Debian and Ubuntu mirrors.
+The pbuilder \fBMIRRORSITE\fP and \fBOTHERMIRROR\fP variables are
+supported, as are the standard ubuntu\-dev\-tools variables:
+\fBUBUNTUTOOLS_DEBIAN_MIRROR\fP, \fBPBUILDER_DIST_DEBIAN_MIRROR\fP,
+\fBUBUNTUTOOLS_DEBSEC_MIRROR\fP, \fBPBUILDER_DIST_DEBSEC_MIRROR\fP,
+\fBUBUNTUTOOLS_UBUNTU_MIRROR\fP, \fBPBUILDER_DIST_UBUNTU\fP,
+\fBUBUNTUTOOLS_UBUNTU_PORTS_MIRROR\fP, and
+\fBPBUILDER_DIST_UBUNTU_PORTS_MIRROR\fP.
+See \fBubuntu\-dev\-tools\fP (5) for details.
+.PP
 You may also want to know that \fBpbuilder\-dist\fP exports \fBDIST\fP and
 \fBARCH\fP environment variables to the invoked process, containing the name
 of the distribution and the architecture targeted by the current build. You
@@ -111,13 +138,16 @@ can make use of them, for example, in \fBpbuilderrc\fP.
 
 .SH BUGS
 If you experience any problem with this script contact me on rainct@ubuntu.com
-or file a bug at https://bugs.launchpad.net/ubuntu/+source/ubuntu-dev-tools.
+or file a bug at https://bugs.launchpad.net/ubuntu/+source/ubuntu\-dev\-tools.
 .PP
 Please ensure first that the problem is really this script and not an issue
 with \fBpbuilder\fP or \fBcowbuilder\fP themselves.
 
 .SH SEE ALSO
-\fBpbuilder\fR, \fBpbuilderrc\fR, \fBcowbuilder\fR
+.BR pbuilder (1),
+.BR pbuilderrc (5),
+.BR cowbuilder (1),
+.BR ubuntu\-dev\-tools (5).
 
 .SH AUTHORS
 \fBpbuilder\-dist\fP and this manual page were written by Siegfried-A. Gevatter

doc/pm-helper.1

@@ -0,0 +1,44 @@
+.\" Copyright (C) 2023, Canonical Ltd.
+.\"
+.\" This program is free software; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License, version 3.
+.\"
+.\" This program is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+.\" General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
+.TH pm\-helper 1 "June 2023" ubuntu\-dev\-tools
+
+.SH NAME
+pm\-helper \- helper to guide a developer through proposed\-migration work
+
+.SH SYNOPSIS
+.B pm\-helper \fR[\fIoptions\fR] [\fIpackage\fR]
+
+.SH DESCRIPTION
+Claim a package from proposed\-migration to work on and get additional
+information (such as the state of the package in Debian) that may be helpful
+in unblocking it.
+.PP
+This tool is incomplete and under development.
+
+.SH OPTIONS
+.TP
+.B \-l \fIINSTANCE\fR, \fB\-\-launchpad\fR=\fIINSTANCE\fR
+Use the specified instance of Launchpad (e.g. "staging"), instead of
+the default of "production".
+.TP
+.B \-v\fR, \fB--verbose\fR
+be more verbose
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a help message and exit
+
+.SH AUTHORS
+\fBpm\-helper\fR and this manpage were written by Steve Langasek
+<steve.langasek@ubuntu.com>.
+.PP
+Both are released under the GPLv3 license.

doc/pull-debian-ddebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-debian-debs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-debian-source.1

@@ -1,89 +0,0 @@
-.\" Copyright (C) 2010-2011, Stefano Rivera <stefanor@ubuntu.com>
-.\"
-.\" Permission to use, copy, modify, and/or distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-.\" PERFORMANCE OF THIS SOFTWARE.
-.TH PULL\-DEBIAN\-SOURCE "1" "22 January 2011" "ubuntu\-dev\-tools"
-
-.SH NAME
-pull\-debian\-source \- download and extract a source package from Debian
-
-.SH SYNOPSIS
-.B pull\-debian\-source \fR[\fIoptions\fR] <\fIsource package\fR>
-[\fIrelease\fR|\fIversion\fR]
-
-.SH DESCRIPTION
-\fBpull\-debian\-source\fR downloads and extracts the specified
-\fIversion\fR of \fIsource package\fR, or the latest version in the
-specified Debian \fIrelease\fR.
-.P
-\fBpull\-debian\-source\fR will try the preferred mirror, default
-mirror, security mirror, and fall back to \fBLaunchpad\fR or
-\fBsnapshot.debian.org\fR, in search of the requested version.
-
-.SH OPTIONS
-.TP
-.I source package
-The source package to download from Debian.
-.TP
-.I release
-The release to download the source package from. Defaults to
-\fBunstable\fR.
-.TP
-.I version
-The specific version of the package to download.
-.TP
-.BR \-d ", " \-\-download\-only
-Do not extract the source package.
-.TP
-.B \-m \fIDEBIAN_MIRROR\fR, \fB\-\-mirror\fR=\fIDEBIAN_MIRROR\fR
-Use the specified mirror.
-Should be in the form \fBhttp://ftp.debian.org/debian\fR.
-If the package isn't found on this mirror, \fBpull\-debian\-source\fR
-will fall back to the default mirror.
-.TP
-.B \-s \fIDEBSEC_MIRROR\fR, \fB\-\-security\-mirror\fR=\fIDEBSEC_MIRROR\fR
-Use the specified mirror.
-Should be in the form \fBhttp://security.debian.org\fR.
-If the package isn't found on this mirror, \fBpull\-debian\-source\fR
-will fall back to the default mirror.
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
-.TP
-.BR \-h ", " \-\-help
-Display the usage instructions and exit.
-
-.SH ENVIRONMENT
-All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
-environment variables.
-Variables in the environment take precedence to those in configuration
-files.
-
-.SH CONFIGURATION VARIABLES
-The following variables can be set in the environment or in
-.BR ubuntu\-dev\-tools (5)
-configuration files.
-In each case, the script\-specific variable takes precedence over the
-package\-wide variable.
-.TP
-.BR PULL_DEBIAN_SOURCE_DEBIAN_MIRROR ", " UBUNTUTOOLS_DEBIAN_MIRROR
-The default value for \fB\-\-mirror\fR.
-.TP
-.BR PULL_DEBIAN_SOURCE_DEBSEC_MIRROR ", " UBUNTUTOOLS_DEBSEC_MIRROR
-The default value for \fB\-\-security\-mirror\fR.
-
-.SH SEE ALSO
-.BR dget (1),
-.BR pull\-debian\-debdiff (1),
-.BR pull\-lp\-source (1),
-.BR ubuntu\-dev\-tools (5)

doc/pull-debian-source.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-debian-udebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-lp-ddebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-lp-debs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-lp-source.1

@@ -1,76 +0,0 @@
-.TH PULL\-LP\-SOURCE "1" "4 August 2008" "ubuntu-dev-tools"
-
-.SH NAME
-pull\-lp\-source \- download a source package from Launchpad
-
-.SH SYNOPSIS
-.B pull\-lp\-source \fR[\fIoptions\fR]\fB \fBsource package\fR
-[\fIrelease\fR|\fIversion\fR]
-
-.SH DESCRIPTION
-\fBpull\-lp\-source\fR downloads and extracts the specified
-\fIversion\fR of <\fBsource package\fR> from Launchpad, or the latest
-version of the specified \fIrelease\fR.
-If no \fIversion\fR or \fIrelease\fR is specified, the latest version in
-the development release will be downloaded.
-
-.SH OPTIONS
-Listed below are the command line options for pull\-lp\-source:
-.TP
-.B source package
-This is the source package that you would like to be downloaded from Launchpad.
-.TP
-.B version
-This is the version of the source package to be downloaded.
-.TP
-.B release
-This is the release that you would like the source package to be downloaded from.
-This value defaults to the current development release.
-.TP
-.BR \-h ", " \-\-help
-Display a help message and exit.
-.TP
-.BR \-d ", " \-\-download\-only
-Do not extract the source package.
-.TP
-.B \-m \fIUBUNTU_MIRROR\fR, \fB\-\-mirror\fR=\fIUBUNTU_MIRROR\fR
-Use the specified Ubuntu mirror.
-Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR.
-If the package isn't found on this mirror, \fBpull\-lp\-source\fR will
-fall back to Launchpad, as its name implies.
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
-
-.SH ENVIRONMENT
-All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
-environment variables.
-Variables in the environment take precedence to those in configuration
-files.
-.TP
-.B
-DIST
-Specifies the default target.
-
-.SH CONFIGURATION VARIABLES
-The following variables can be set in the environment or in
-.BR ubuntu\-dev\-tools (5)
-configuration files.
-In each case, the script\-specific variable takes precedence over the
-package\-wide variable.
-.TP
-.BR PULL_LP_SOURCE_UBUNTU_MIRROR ", " UBUNTUTOOLS_UBUNTU_MIRROR
-The default value for \fB\-\-mirror\fR.
-
-.SH SEE ALSO
-.BR dget (1),
-.BR pull\-debian\-source (1),
-.BR pull\-debian\-debdiff (1),
-.BR ubuntu\-dev\-tools (5)
-
-.SH AUTHOR
-.PP
-\fBpull\-lp\-source\fR and this manual page were written by Iain Lane
-<iain@orangesquash.org.uk>.
-Both are released under the GNU General Public License, version 3 or later.

doc/pull-lp-source.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-lp-udebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-pkg.1

@@ -0,0 +1,147 @@
+.TH PULL\-PKG "1" "28 August 2017" "ubuntu-dev-tools"
+
+.SH NAME
+pull\-pkg \- download a package for Debian, Ubuntu, UCA, or a PPA
+
+.SH SYNOPSIS
+.B pull\-pkg \fR[\fIoptions\fR]\fR <\fIpackage name\fR>
+[\fIrelease\fR|\fIversion\fR]
+
+.SH DESCRIPTION
+\fBpull\-pkg\fR downloads the specified \fIversion\fR of
+<\fIpackage name\fR>, or the latest version from the
+specified \fIrelease\fR.  To request a version from
+a particular pocket say \fIrelease\fB\-\fIpocket\fR (with a magic
+\fB\-release\fR for only the release pocket).  If no \fIpocket\fR is
+specified, all pockets will be searched except -backports.
+If no \fIversion\fR or \fIrelease\fR is specified, the latest version in
+the development release will be downloaded.
+
+There are convenience scripts that set pull type and distribution
+appropriately: these are
+\fBpull\-lp\-source\fR, \fBpull\-lp\-debs\fR, \fBpull\-lp\-ddebs\fR,
+and \fBpull\-lp\-udebs\fR, which all pull Ubuntu packages;
+\fBpull\-debian\-source\fR, \fBpull\-debian\-debs\fR, \fBpull\-debian\-ddebs\fR,
+and \fBpull\-debian\-udebs\fR, which all pull Debian packages;
+\fBpull\-uca\-source\fR, \fBpull\-uca\-debs\fR, \fBpull\-uca\-ddebs\fR,
+and \fBpull\-uca\-udebs\fR, which all pull Ubuntu Cloud Archive packages;
+and \fBpull\-ppa\-source\fR, \fBpull\-ppa\-debs\fR, \fBpull\-ppa\-ddebs\fR,
+and \fBpull\-ppa\-udebs\fR, which all pull from a specified Personal Package
+Archive on Launchpad.  Each script pulls the file type in its name, i.e.
+\fIsource\fR, \fIdebs\fR, \fIddebs\fR, or \fIudebs\fR.
+
+.SH OPTIONS
+Listed below are the command line options for pull\-pkg:
+.TP
+.I package name
+This is name of the package to downloaded.
+You can use either the source package name, or binary package name.
+.TP
+.I version
+This is the version of the package to downloaded.
+.TP
+.I release
+This is the release to downloaded from.
+For debian, you can use either the release name like \fBjessie\fR
+or \fBsid\fR, or you can use the special release names \fBunstable\fR,
+\fBstable\fR, or \fBtesting\fR.
+For ubuntu, you can use either the release name like \fBxenial\fR
+or the release-pocket like \fBxenial-proposed\fR.
+For ubuntu cloud archive (uca) you can use either the uca release
+name like \fBmitaka\fR or the ubuntu and uca release names like
+\fBtrusty-mitaka\fR.  Defaults to the current development release.
+.TP
+.BR \-h ", " \-\-help
+Display a help message and exit.
+.TP
+.BR \-v ", " \-\-verbose
+Be verbose about what is being done.
+.TP
+.BR \-d ", " \-\-download\-only
+Do not extract the source package (applies only to source packages).
+.TP
+.B \-m \fIMIRROR\fR, \fB\-\-mirror\fR=\fIMIRROR\fR
+Use the specified mirror server.
+Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR or
+\fBhttp://deb.debian.org/debian\fR.  If not specified or if the
+package is not found on the specified mirror, this will fall
+back to the default mirror(s) and/or mirror(s) from environment
+variables, and then will fall back to Launchpad or Debian Snapshot.
+This can be specified multiple times to try multiple mirrors.
+.TP
+.B \-\-no\-conf
+Do not use mirrors from the default configuration, or from
+any environment variables.
+.TP
+.B \-a \fIARCH\fR, \fB\-\-arch\fR=\fIARCH\fR
+Get binary packages from the \fIARCH\fR architecture.
+Defaults to the local architecture, if it can be deteected.
+.TP
+.B \-p \fIPULL\fR, \fB\-\-pull\fR=\fIPULL\fR
+What to pull: \fBsource\fR, \fBdebs\fR, \fBddebs\fR, \fBudebs\fR,
+or \fBlist\fR.  The \fBlist\fR action only lists all a package's
+source and binary files, but does not actually download any.
+Defaults to \fBsource\fR.
+.TP
+.B \-D \fIDISTRO\fR, \fB\-\-distro\fR=\fIDISTRO\fR
+Pull from: \fBdebian\fR, \fBuca\fR, \fBubuntu\fR, or a \fBppa\fR.
+\fBlp\fR can be used instead of \fBubuntu\fR.
+Any string containing \fBcloud\fR can be used instead of \fBuca\fR.
+If pulling from a ppa, you must specify the PPA.  Defaults to \fBubuntu\fR.
+.TP
+.B \-\-ppa\fR=ppa:\fIUSER/NAME\fR
+Applies only when \fBdistro\fR is \fIppa\fR.  Can be provided either as
+a value to the \fB\-\-ppa\fR option parameter, or as a plain option
+(like \fIrelease\fR or \fIversion\fR).  When specified as a plain option,
+the form must be \fBppa:USER/NAME\fR; when specified as a value to the
+\fB\-\-ppa\fR option parameter, the leading \fBppa:\fR is optional.
+
+.SH ENVIRONMENT
+All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
+environment variables.
+Variables in the environment take precedence to those in configuration
+files.
+
+.SH CONFIGURATION VARIABLES
+The following variables can be set in the environment or in
+.BR ubuntu\-dev\-tools (5)
+configuration files.
+In each case, the script\-specific variable takes precedence over the
+package\-wide variable.
+.TP
+.BR UBUNTUTOOLS_UBUNTU_MIRROR
+The default mirror.
+.TP
+.BR PULL_PKG_UBUNTU_MIRROR
+The default mirror when using the \fBpull\-pkg\fR script.
+.TP
+.BR PULL_[LP|DEBIAN|PPA|UCA]_[SOURCE|DEBS|DDEBS|UDEBS]_MIRROR
+The default mirror when using the associated script.
+
+.SH SEE ALSO
+.BR dget (1),
+.BR pull\-lp\-source (1),
+.BR pull\-lp\-debs (1),
+.BR pull\-lp\-ddebs (1),
+.BR pull\-lp\-udebs (1),
+.BR pull\-debian\-source (1),
+.BR pull\-debian\-debs (1),
+.BR pull\-debian\-ddebs (1),
+.BR pull\-debian\-udebs (1),
+.BR pull\-ppa\-source (1),
+.BR pull\-ppa\-debs (1),
+.BR pull\-ppa\-ddebs (1),
+.BR pull\-ppa\-udebs (1),
+.BR pull\-uca\-source (1),
+.BR pull\-uca\-debs (1),
+.BR pull\-uca\-ddebs (1),
+.BR pull\-uca\-udebs (1),
+.BR pull\-debian\-debdiff (1),
+.BR ubuntu\-dev\-tools (5)
+
+.SH AUTHOR
+.PP
+\fBpull\-pkg\fR was written by Dan Streetman <ddstreet@canonical.com>,
+based on the original \fBpull\-lp\-source\fR; it and this manual page
+were written by Iain Lane <iain@orangesquash.org.uk>.
+All are released under the GNU General Public License, version 3 or later.

doc/pull-ppa-ddebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-ppa-debs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-ppa-source.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-ppa-udebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-revu-source.1

@@ -1,27 +0,0 @@
-.TH PULL\-REVU\-SOURCE "1" "30 August 2009" "ubuntu-dev-tools"
-
-.SH NAME
-pull\-revu\-source \- download a source package from REVU
-
-.SH SYNOPSIS
-.B pull\-revu\-source \fR[\fB\-h\fR]\fB <\fBsource package\fR>
-
-.SH DESCRIPTION
-\fBpull\-revu\-source\fR downloads and extracts the latest version of
-<\fBsource package\fR> from REVU.
-
-.SH OPTIONS
-Listed below are the command line options for pull\-revu\-source:
-.TP
-.B \-h, \-\-help
-Display the usage instructions and exit.
-.TP
-.B <source package>
-This is the source package that you would like to be downloaded from Debian.
-
-.SH AUTHOR
-.PP
-\fBpull\-revu\-source\fR and this manual page were written by Nathan Handler
-<nhandler@ubuntu.com>. \fBpull\-revu\-source\fR is based on \fBrevupull\fR in
-\fBkubuntu\-dev\-tools\fR, written by Harald Sitter <apachelogger@ubuntu.com>.
-Both are released under the GNU General Public License, version 3 or later.

doc/pull-uca-ddebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-uca-debs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-uca-source.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/pull-uca-udebs.1

@@ -0,0 +1 @@
+pull-pkg.1

doc/requestbackport.1

@@ -0,0 +1,57 @@
+.\" Copyright (C) 2011, Stefano Rivera <stefanor@ubuntu.com>
+.\"
+.\" Permission to use, copy, modify, and/or distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.TH requestbackport 1 "November 2011" ubuntu\-dev\-tools
+
+.SH NAME
+requestbackport \- File a backport request bug
+
+.SH SYNOPSIS
+.B requestbackport \fR[\fIoptions\fR] \fIpackage\fR
+
+.SH DESCRIPTION
+Determine the intermediate releases that \fIpackage\fR needs to be
+backported to, list all reverse\-dependencies, and file the backporting
+request.
+\fBrequestbackport\fR will include a testing checklist in the bug.
+
+.SH OPTIONS
+.TP
+\fB\-d\fR \fIDEST\fR, \fB\-\-destination\fR=\fIDEST\fR
+Backport to \fIDEST\fR release and necessary intermediate
+releases. Default: current stable release.
+.TP
+\fB\-s\fR \fISOURCE\fR, \fB\-\-source\fR=\fISOURCE\fR
+Backport from \fISOURCE\fR release.
+Default: current development release.
+.TP
+\fB\-l\fR \fIINSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
+Launchpad instance to connect to.
+Default: \fBproduction\fR.
+.TP
+\fB\-\-no\-conf\fR
+Don't read config files or environment variables
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a help message and exit.
+
+.SH SEE ALSO
+.BR backportpackage (1),
+.BR reverse\-depends (1),
+.BR https://wiki.ubuntu.com/UbuntuBackports .
+
+.SH AUTHORS
+\fBrequestbackport\fR and this manpage were written by Stefano Rivera
+<stefanor@ubuntu.com>.
+.PP
+Both are released under the terms of the ISC License.

doc/requestsync.1

@@ -11,14 +11,10 @@ requestsync \- helper to file sync requests for Ubuntu
 \fBrequestsync\fR looks at the versions of <source package> in Debian and
 Ubuntu and prompts for an explanation of why the Ubuntu changes (if there
 are any) should be dropped.
-The changelog entry is then downloaded from packages.debian.org.
-If the sync request is being filed per email (default), a prompt for your
-GPG passphrase follows so that it can sign the mail and send it off to
-Launchpad.
-Alternatively a sync request can be filed directly using the launchpadlib
-Python module (option \fB\-\-lp\fR).
-\fBrequestsync\fR falls back to mail the sync request if submitting using
-the launchpadlib module fails.
+The changelog entry is then downloaded from packages.debian.org, and the
+sync request bug is filed in launchpad.
+Alternatively, the sync request can be filed by GPG\-signed email (option
+\fB\-\-email\fR).
 
 .PP
 \fBrequestsync\fR checks if you have the permissions to request the sync from
@@ -28,10 +24,15 @@ you don't have upload permissions, the script will subscribe the necessary
 team with approval rights to the bug report for you.
 
 This check is only performed if \fBrequestsync\fR is allowed to use the LP API
-(option \fB\-\-lp\fR). In the other case \fBrequestsync\fR relies on that you
+(not email submission). In the other case \fBrequestsync\fR relies on that you
 answer the question about upload permissions honestly to determine if a team
 with approval rights is to be subscribed to the bug.
 
+If you have permission to upload the package directly, then you may prefer
+to use \fBsyncpackage\fR instead to copy the package using the Launchpad
+API. At some future point, \fBrequestsync\fR will be changed to do this
+automatically.
+
 .PP
 \fBrequestsync\fR uses launchpadlib authentication to file its requests.
 
@@ -53,15 +54,21 @@ attempt to look it up in Ubuntu since it will not exist.
 Specifies your GPG key.
 This is only used if the sync request is mailed to Launchpad.
 .TP
-.B \-\-lp
-Use the launchpadlib Python module (packaged as python\-launchpadlib) to
-file the sync request in Launchpad.
+.B \-\-email
+Use GPG\-signed email to file the bug, rather than launchpadlib.
 .TP
 .B \-s
 Specifies that you require sponsorship.
 You need this option if you don't have upload permissions for that package.
 This disables the upload permissions check described above.
 .TP
+.B \-C
+Allow changelog to be manually filled in when missing.
+\fBrequestsync\fR gets Debian changelogs from packages.debian.org, which
+isn't in sync with the Debian archive.
+To request a sync before the changelog is available, pass this option,
+and provide the changelog entries yourself.
+.TP
 .B \-e
 Use this flag after FeatureFreeze for non-bug fix syncs. \fBrequestsync\fR will
 subscribe ubuntu-release team instead of sponsorship team.
@@ -104,7 +111,8 @@ files.
 .TP
 .B REQUESTSYNC_SMTP_SERVER
 Set which SMTP server to use when sending mail.
-If unspecified this defaults to fiordland.ubuntu.com.
+If unspecified this defaults to launchpad's SMTP servers (the
+eventual destination).
 .TP
 .B REQUESTSYNC_SMTP_PORT
 Sets which port of the SMTP server to use. Default is 25.
@@ -113,10 +121,13 @@ Sets which port of the SMTP server to use. Default is 25.
 Sets the username and password to use when authenticating to the SMTP server.
 .TP
 .BR REQUESTSYNC_USE_LPAPI
-Setting this to \fIyes\fR is equivalent to running with \fB--lp\fR.
+Setting this to \fIno\fR is equivalent to running with \fB--email\fR.
 .TP
 .BR REQUESTSYNC_LPINSTANCE ", " UBUNTUTOOLS_LPINSTANCE
 The default value for \fB--lpinstance\fR.
+.TP
+.BR REQUESTSYNC_KEYID ", " UBUNTUTOOLS_KEYID
+The default value for \fB-k\fR.
 
 .SH SEE ALSO
 .BR rmadison (1),

doc/reverse-build-depends.1

@@ -1,172 +0,0 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
-.\"
-.\" Standard preamble:
-.\" ========================================================================
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
-.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-'br\}
-.\"
-.\" Escape single quotes in literal strings from groff's Unicode transform.
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
-.\" entries marked with X<> in POD.  Of course, you'll have to process the
-.\" output yourself in some meaningful fashion.
-.ie \nF \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
-..
-.    nr % 0
-.    rr F
-.\}
-.el \{\
-.    de IX
-..
-.\}
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ========================================================================
-.\"
-.IX Title "BUILD-RDEPS 1"
-.TH BUILD-RDEPS 1 "2008-08-14" "Debian Utilities" " "
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.if n .ad l
-.nh
-.SH "NAME"
-build\-rdeps \- find packages that depend on a specific package to build (reverse build depends)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBubuild-rdeps\fR \fIpackage\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBubuild-rdeps\fR searches for all packages that build-depend on the specified package.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-.IP "\fB\-u\fR \fB\-\-update\fR" 4
-.IX Item "-u --update"
-Run apt-get update before searching for build-depends.
-.IP "\fB\-s\fR \fB\-\-sudo\fR" 4
-.IX Item "-s --sudo"
-Use sudo when running apt-get update. Has no effect if \-u is omitted.
-.IP "\fB\-\-distribution\fR" 4
-.IX Item "--distribution"
-Select another distribution, which is searched for build-depends.
-.IP "\fB\-m\fR \fB\-\-print\-maintainer\fR" 4
-.IX Item "-m --print-maintainer"
-Print the value of the maintainer field for each package.
-.IP "\fB\-d\fR \fB\-\-debug\fR" 4
-.IX Item "-d --debug"
-Run the debug mode
-.IP "\fB\-\-help\fR" 4
-.IX Item "--help"
-Show the usage information.
-.IP "\fB\-\-version\fR" 4
-.IX Item "--version"
-Show the version information.
-.SH "LICENSE"
-.IX Header "LICENSE"
-This code is copyright by Patrick Schoenfeld
-<schoenfeld@in\-medias\-res.com>, all rights reserved.
-This program comes with \s-1ABSOLUTELEY\s0 \s-1NO\s0 \s-1WARRANTY\s0.
-You are free to redistribute this code under the terms of the
-\&\s-1GNU\s0 General Public License, version 2 or later.
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Patrick Schoenfeld <schoenfeld@in\-medias\-res.com>

doc/reverse-depends.1

@@ -0,0 +1,81 @@
+.\" Copyright (C) 2011, Stefano Rivera <stefanor@ubuntu.com>
+.\"
+.\" Permission to use, copy, modify, and/or distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.TH reverse\-depends 1 "November 2011" ubuntu\-dev\-tools
+
+.SH NAME
+reverse\-depends \- List the reverse\-dependencies (or
+build\-dependencies) of a package
+
+.SH SYNOPSIS
+.B reverse\-depends \fR[\fIoptions\fR] \fIpackage
+
+.SH DESCRIPTION
+List reverse\-dependencies (or build\-dependencies) of \fIpackage\fR.
+If the package name is prefixed with \fBsrc:\fR then the
+reverse\-dependencies of all the binary packages that the specified
+source package builds will be listed.
+
+.SH OPTIONS
+.TP
+\fB\-r\fR \fIRELEASE\fR, \fB\-\-release\fR=\fIRELEASE\fR
+Query dependencies in \fIRELEASE\fR.
+Default: current development release.
+.TP
+\fB\-R\fR, \fB\-\-without\-recommends\fR
+Only consider Depends relationships, not Recommends.
+.TP
+\fB\-s\fR, \fB\-\-with\-suggests\fR
+Also consider Suggests relationships.
+.TP
+\fB\-b\fR, \fB\-\-build\-depends\fR
+Query build dependencies.
+Synonym for \fB\-\-arch\fR=\fIsource\fR.
+.TP
+\fB\-a\fR \fIARCH\fR, \fB\-\-arch\fR=\fIARCH\fR
+Query dependencies in \fIARCH\fR.
+Besides valid architecture names, the special values \fBany\fR and
+\fBsource\fR may be used.
+\fBany\fR displays all reverse dependencies, the union across all
+architecture.
+\fBsource\fR displays build dependencies.
+Default: \fBany\fR.
+.TP
+\fB\-c\fR \fICOMPONENT\fR, \fB\-\-component\fR=\fICOMPONENT\fR
+Only consider reverse\-dependencies in \fICOMPONENT\fR. Can
+be specified multiple times.
+Default: all components.
+.TP
+\fB\-l\fR, \fB\-\-list\fR
+Display a simple, machine\-readable list.
+.TP
+\fB\-u\fR \fIURL\fR, \fB\-\-service\-url\fR=\fIURL\fR
+Reverse Dependencies web\-service \fIURL\fR.
+Default: UbuntuWire's service at
+\fBhttp://qa.ubuntuwire.org/rdepends/\fR.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a help message and exit
+
+.SH EXAMPLES
+All reverse dependencies of source package bash:
+.IP
+.nf
+.B reverse\-depends src:bash
+.fi
+
+.SH AUTHORS
+\fBreverse\-depends\fR and this manpage were written by Stefano Rivera
+<stefanor@ubuntu.com>.
+.PP
+Both are released under the terms of the ISC License.

doc/running-autopkgtests.1

@@ -0,0 +1,15 @@
+.TH running\-autopkgtests "1" "18 January 2024" "ubuntu-dev-tools"
+.SH NAME
+running\-autopkgtests \- dumps a list of currently running autopkgtests
+
+.SH SYNOPSIS
+.B running\-autopkgtests
+
+.SH DESCRIPTION
+Dumps a list of currently running and queued tests in Autopkgtest.
+Pass --running to only see running tests, or --queued to only see
+queued tests. Passing both will print both, which is the default behavior.
+
+.SH AUTHOR
+.B running\-autopkgtests
+was written by Chris Peterson <chris.peterson@canonical.com>.

doc/seeded-in-ubuntu.1

@@ -0,0 +1,60 @@
+.\" Copyright (C) 2011, Stefano Rivera <stefanor@ubuntu.com>
+.\"
+.\" Permission to use, copy, modify, and/or distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.TH seeded\-in\-ubuntu 1 "December 2011" ubuntu\-dev\-tools
+
+.SH NAME
+seeded\-in\-ubuntu \- Determine whether a package is safe to upload
+during a freeze
+
+.SH SYNOPSIS
+.B seeded\-in\-ubuntu \fR[\fIoptions\fR] \fIpackage\fR...
+
+.SH DESCRIPTION
+Lists all the current daily images containing the specified packages.
+Or whether the package is part of the supported seed.
+.PP
+If it isn't on an image, it should be safe to upload.
+During the final freeze, one should avoid packages in the supported seed
+too.
+.PP
+An index of the current manifests is downloaded from UbuntuWire.
+
+.SH OPTIONS
+.TP
+\fB\-b\fR, \fB\-\-binary\fR
+The packages specified are binary packages.
+This is faster than source packages, as otherwise we must query LP to
+determine the binary packages that every specified source package
+builds.
+.TP
+\fB\-u\fR \fIURL\fR, \fB\-\-data\-url\fR=\fIURL\fR
+URL for index of seeded packages.
+Default: UbuntuWire's service at
+\fBhttp://qa.ubuntuwire.org/ubuntu-seeded-packages/seeded.json.gz\fR.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a help message and exit
+
+.SH EXAMPLES
+All the images that contain unity:
+.IP
+.nf
+.B seeded\-in\-ubuntu -b unity
+.fi
+
+.SH AUTHORS
+\fBseeded\-in\-ubuntu\fR and this manpage were written by Stefano Rivera
+<stefanor@ubuntu.com>.
+.PP
+Both are released under the terms of the ISC License.

doc/setup-packaging-environment.1

@@ -6,7 +6,13 @@
 \fBsetup-packaging-environment\fR
 
 .SH DESCRIPTION
-\fBsetup-packaging-environment\fR aims to make it more straightforward for new contributors to get their Ubuntu installation ready for packaging work. It ensures that all four components from Ubuntu's official repositories are enabled along with their corresponding source repositories. It also installs a minimal set of packages needed for Ubuntu packaging work (ubuntu-dev-tools, devscripts, debhelper, cdbs, patchutils, pbuilder, and build-essential). Finally, it assists in defining the DEBEMAIL and DEBFULLNAME environment variables.
+\fBsetup-packaging-environment\fR aims to make it more straightforward for new
+contributors to get their Ubuntu installation ready for packaging work. It
+ensures that all four components from Ubuntu's official repositories are enabled
+along with their corresponding source repositories. It also installs a minimal
+set of packages needed for Ubuntu packaging work (ubuntu-dev-tools, devscripts,
+debhelper, patchutils, pbuilder, and build-essential). Finally, it assists
+in defining the DEBEMAIL and DEBFULLNAME environment variables.
 
 .SH AUTHORS
 \fBsetup-packaging-environment\fR was written by Siegfried-A. Gevatter <rainct@ubuntu.com>.

doc/sponsor-patch.1

@@ -1,7 +1,6 @@
 .TH sponsor\-patch "1" "September 21 2010" "ubuntu-dev-tools"
 .SH NAME
-sponsor\-patch \- Pull a patch / merge request from Launchpad,
-test-build it, and upload.
+sponsor\-patch \- Prepare, test\-build, and sponsor an upload.
 
 .SH SYNOPSIS
 .B sponsor\-patch \fR[\fIoptions\fR] \fIbug
@@ -15,8 +14,8 @@ builds it, runs
 .BR lintian (1)
 and, after review and confirmation, can upload it.
 
-\fBsponsor\-patch\fR can be used for sponsoring patches, merges from
-Debian, SRUs, and creating debdiffs from patches.
+\fBsponsor\-patch\fR can be used for sponsoring patches, syncs and
+merges from Debian, SRUs, and creating debdiffs from patches.
 If \fIbug\fR has multiple patches or branches linked, it will prompt the
 user to select one.
 The same applies to bug tasks.
@@ -43,7 +42,7 @@ The changelog target must be valid.
 The changelog timestamp is touched.
 
 .PP
-Should any checks (or the build fail), the user has an option to edit
+Should any checks (or the build) fail, the user has an option to edit
 the patched source and try building it again.
 .PP
 Unless a working directory is specified, the sources and patches will be
@@ -127,6 +126,9 @@ The default value for \fB--update\fR.
 .TP
 .BR SPONSOR_PATCH_WORKDIR ", " UBUNTUTOOLS_WORKDIR
 The default value for \fB--workdir\fR.
+.TP
+.BR SPONSOR_PATCH_KEYID ", " UBUNTUTOOLS_KEYID
+The default value for \fB--key\fR.
 
 .SH EXAMPLES
 Test-building and sponsoring an upload of bug \fB1234\fR:

doc/syncpackage.1

@@ -1,38 +1,44 @@
 .TH SYNCPACKAGE "1" "June 2010" "ubuntu-dev-tools"
 .SH NAME
-syncpackage \- helper to prepare .changes file to upload synced packages
+syncpackage \- copy source packages from Debian to Ubuntu
+.\"
 .SH SYNOPSIS
 .B syncpackage
-[\fIoptions\fR] \fI<.dsc URL/path or package name>\fR
+[\fIoptions\fR] \fI<.dsc URL/path or package name(s)>\fR
+.\"
 .SH DESCRIPTION
-\fBsyncpackage\fR generates a changes file to be directly uploaded to Ubuntu
-primary archive or PPA starting from a pristine Debian package.
+\fBsyncpackage\fR causes one or more source package(s) to be copied from Debian
+to Ubuntu.
 .PP
 \fBsyncpackage\fR allows you to upload files with the same checksums of the
 Debian ones, as the common script used by Ubuntu archive administrators does,
 this way you can preserve source files integrity between the two distributions.
 .PP
-\fBsyncpackage\fR will detect source tarballs with mismatching checksums
-and will automatically create fake syncs instead.
+\fBsyncpackage\fR will detect source tarballs with mismatching
+checksums, and can perform fake syncs.
+.\"
 .SH WARNING
-The use of \fBsyncpackage\fR is discouraged by the Ubuntu Archive
-Administrators, as it introduces an unnecessary window for error.
-In future launchpad will offer the ability to directly perform sync
-requests, without a developer having to do an upload.
-Until then, it's advised to use \fBsyncpackage\fR with caution, and
-request syncs via bugs with
-.BR requestsync (1)
-where possible.
+The use of \fBsyncpackage \-\-no\-lp\fR, which generates a changes file to
+be directly uploaded to the Ubuntu primary archive or a PPA, is discouraged
+by the Ubuntu Archive Administrators, as it introduces an unnecessary window
+for error.
+This only exists for backward compatibility, for unusual corner cases
+(such as fakesyncs), and for uploads to archives other than the Ubuntu
+primary archive.
+Omitting this option will cause Launchpad to perform the sync request
+directly, which is the preferred method for uploads to the Ubuntu primary
+archive.
+.\"
 .SH OPTIONS
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Show help message and exit
 .TP
 \fB\-d\fI DIST\fR, \fB\-\-distribution\fR=\fIDIST\fR
-Debian distribution to sync from.
+Debian distribution to sync from. Default is \fIunstable\fR.
 .TP
 \fB\-r\fI RELEASE\fR, \fB\-\-release\fR=\fIRELEASE\fR
-Specify target Ubuntu release.
+Specify target Ubuntu release. Default: current development release.
 .TP
 \fB\-V\fI DEBVERSION\fR, \fB\-\-debian\-version\fR=\fIDEBVERSION\fR
 Specify the version to sync from.
@@ -40,16 +46,54 @@ Specify the version to sync from.
 \fB\-c\fI COMPONENT\fR, \fB\-\-component\fR=\fICOMPONENT\fR
 Specify the component to sync from.
 .TP
+\fB\-b\fI BUG\fR, \fB\-\-bug\fR=\fIBUG\fR
+Mark a Launchpad bug as being fixed by this upload.
+.TP
+\fB\-s\fI USERNAME\fR, \fB\-\-sponsor\fR=\fIUSERNAME\fR
+Sponsor the sync for \fIUSERNAME\fR (a Launchpad username).
+.TP
 \fB\-v\fR, \fB\-\-verbose\fR
 Display more progress information.
 .TP
+\fB\-F\fR, \fB\-\-fakesync\fR
+Perform a fakesync, to work around a tarball mismatch between Debian and
+Ubuntu.
+This option ignores blocklisting, and performs a local sync.
+It implies \fB\-\-no\-lp\fR, and will leave a signed \fB.changes\fR file
+for you to upload.
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+Force sync over the top of Ubuntu changes.
+.TP
+.B \-\-no\-conf
+Do not read any configuration files, or configuration from environment
+variables.
+.TP
+\fB\-l\fI INSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
+Launchpad instance to connect to (default: production).
+.TP
+.B \-\-simulate
+Show what would be done, but don't actually do it.
+.\"
+.SH LOCAL SYNC PREPARATION OPTIONS
+.TP
+Options that only apply when using \fB\-\-no\-lp\fR:
+.TP
+.B \-\-no\-lp
+Construct sync locally, rather than letting Launchpad copy the package
+directly.
+It will leave a signed \fB.changes\fR file for you to upload.
+See the \fBWARNING\fR above.
+.TP
 \fB\-n\fI UPLOADER_NAME\fR, \fB\-\-uploader\-name\fR=\fIUPLOADER_NAME\fR
 Use UPLOADER_NAME as the name of the maintainer for this upload instead
 of evaluating DEBFULLNAME and UBUMAIL.
+This option may only be used in \fB\-\-no\-lp\fR mode.
 .TP
 \fB\-e\fI UPLOADER_EMAIL\fR, \fB\-\-uploader\-email\fR=\fIUPLOADER_EMAIL\fR
 Use UPLOADER_EMAIL as the email address of the maintainer for this
 upload instead of evaluating DEBEMAIL and UBUMAIL.
+This option may only be used in \fB\-\-no\-lp\fR mode.
 .TP
 \fB\-k\fI KEYID\fR, \fB\-\-key\fR=\fIKEYID\fR
 Specify the key ID to be used for signing.
@@ -57,9 +101,6 @@ Specify the key ID to be used for signing.
 \fB\-\-dont-sign\fR
 Do not sign the upload.
 .TP
-\fB\-b\fI BUG\fR, \fB\-\-bug\fR=\fIBUG\fR
-Mark a Launchpad bug as being fixed by this upload.
-.TP
 .B \-d \fIDEBIAN_MIRROR\fR, \fB\-\-debian\-mirror\fR=\fIDEBIAN_MIRROR\fR
 Use the specified mirror.
 Should be in the form \fBhttp://ftp.debian.org/debian\fR.
@@ -71,10 +112,7 @@ Use the specified Debian security mirror.
 Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR.
 If the package isn't found on this mirror, \fBsyncpackage\fR will fall
 back to the default mirror.
-.TP
-.B \-\-no\-conf
-Do not read any configuration files, or configuration from environment
-variables.
+.\"
 .SH ENVIRONMENT
 .TP
 .BR DEBFULLNAME ", " DEBEMAIL ", " UBUMAIL
@@ -87,6 +125,7 @@ All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
 environment variables.
 Variables in the environment take precedence to those in configuration
 files.
+.\"
 .SH CONFIGURATION VARIABLES
 The following variables can be set in the environment or in
 .BR ubuntu\-dev\-tools (5)
@@ -99,12 +138,17 @@ The default value for \fB\-\-debian\-mirror\fR.
 .TP
 .BR SYNCPACKAGE_UBUNTU_MIRROR ", " UBUNTUTOOLS_DEBSEC_MIRROR
 The default value for \fB\-\-ubuntu\-mirror\fR.
+.TP
+.BR SYNCPACKAGE_KEYID ", " UBUNTUTOOLS_KEYID
+The default value for \fB\-\-key\fR.
+.\"
 .SH SEE ALSO
 .BR requestsync (1),
 .BR ubuntu\-dev\-tools (5)
+.\"
 .SH AUTHOR
 \fBsyncpackage\fR was written by Martin Pitt <martin.pitt@canonical.com> and Benjamin Drung <bdrung@ubuntu.com>.
 .PP
-This manual page were written by Luca Falavigna <dktrkranz@ubuntu.com>
+This manual page was written by Luca Falavigna <dktrkranz@ubuntu.com>
 .PP
 Both are released under GNU General Public License, version 3.

doc/ubuntu-build.1

@@ -1,20 +1,19 @@
-.TH UBUNTU-BUILD "1" "June 2010" "ubuntu-dev-tools"
+.TH UBUNTU-BUILD "1" "Mar 2024" "ubuntu-dev-tools"
 .SH NAME
 ubuntu-build \- command-line interface to Launchpad build operations
 
 .SH SYNOPSIS
-.B ubuntu-build <srcpackage> <release> <operation>
+.nf
+\fBubuntu-build\fR <srcpackage> <release> <operation>
+\fBubuntu-build\fR --batch [--retry] [--rescore \fIPRIORITY\fR] [--arch \fIARCH\fR [...]]
+             [--series \fISERIES\fR] [--state \fIBUILD-STATE\fR]
+             [-A \fIARCHIVE\fR] [pkg]...
+.fi
 
 .SH DESCRIPTION
 \fBubuntu-build\fR provides a command line interface to the Launchpad build
 operations.
 
-.PP
-\fBubuntu-build\fR uses a cookie file stored at \fI~/.lpcookie.txt\fR to authenticate
-to Launchpad.
-This cookie is created on run from the Mozilla Firefox cookie
-file at \fI~/.mozilla/*/*/cookies.sqlite\fR.
-
 .SH OPERATIONS
 Listed below are the available operations for \fBubuntu-build\fR:
 .TP
@@ -43,8 +42,8 @@ operations.
 .IP
 \fB\-a\fR ARCHITECTURE, \fB\-\-arch\fR=\fIARCHITECTURE\fR
 Rebuild or rescore a specific architecture. Valid
-architectures include: amd64, sparc, powerpc, i386,
-armel, ia64, lpia, hppa.
+architectures are:
+armhf, arm64, amd64, i386, powerpc, ppc64el, riscv64, s390x.
 .TP
 Batch processing:
 .IP
@@ -64,14 +63,16 @@ Retry builds (give\-back).
 \fB\-\-rescore\fR=\fIPRIORITY\fR
 Rescore builds to <priority>.
 .IP
-\fB\-\-arch2\fR=\fIARCHITECTURE\fR
+\fB\-\-arch\fR=\fIARCHITECTURE\fR
 Affect only 'architecture' (can be used several
-times). Valid architectures are: amd64, sparc,
-powerpc, i386, armel, ia64, lpia, hppa.
+times). Valid architectures are:
+arm64, amd64, i386, powerpc, ppc64el, riscv64, s390x.
+.IP
+\fB\-A=\fIARCHIVE\fR
+Act on the named archive (ppa) instead of on the main Ubuntu archive.
 
 .SH AUTHORS
 \fBubuntu-build\fR was written by Martin Pitt <martin.pitt@canonical.com>, and
 this manual page was written by Jonathan Patrick Davies <jpds@ubuntu.com>.
 .PP
-Both are released under the terms of the GNU General Public License, version 3
-or (at your option) any later version.
+Both are released under the terms of the GNU General Public License, version 3.

doc/ubuntu-dev-tools.5

@@ -76,6 +76,12 @@ Should be of the form \fBhttp://archive.ubuntu.com/ubuntu\fR (no
 trailing slash).
 If not specified, the master will be used.
 .TP
+.B UBUNTUTOOLS_UBUNTU_PORTS_MIRROR
+The preferred Ubuntu archive mirror.
+Should be of the form \fBhttp://ports.ubuntu.com\fR (no
+trailing slash).
+If not specified, the master will be used.
+.TP
 .B UBUNTUTOOLS_LPINSTANCE
 The launchpad instance to communicate with. e.g. \fBproduction\fR
 (default) or \fBstaging\fR.

doc/ubuntu-distro-info.1

@@ -1,51 +0,0 @@
-.\" Copyright (c) 2009-2011, Benjamin Drung <bdrung@ubuntu.com>
-.\"
-.\" Permission to use, copy, modify, and/or distribute this software for any
-.\" purpose with or without fee is hereby granted, provided that the above
-.\" copyright notice and this permission notice appear in all copies.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.\"
-.TH UBUNTU\-DISTRO\-INFO "1" "January 2011" "ubuntu\-dev\-tools"
-.SH NAME
-ubuntu\-distro\-info \- provides information about Ubuntu's distributions
-.SH SYNOPSIS
-.B ubuntu\-distro\-info
-[\fIOPTIONS\fR]
-.SH OPTIONS
-.TP
-\fB\-\-date\fR=\fIDATE
-date for calculating the version (default: today)
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-display help message and exit
-.TP
-\fB\-a\fR, \fB\-\-all\fR
-list all known versions
-.TP
-\fB\-d\fR, \fB\-\-devel\fR
-latest development version
-.TP
-\fB\-\-lts\fR
-latest long term support (LTS) version
-.TP
-\fB\-s\fR, \fB\-\-stable\fR
-latest stable version
-.TP
-\fB\-\-supported\fR
-list of all supported stable versions
-.TP
-\fB\-\-unsupported\fR
-list of all unsupported stable versions
-.SH SEE ALSO
-.BR debian\-distro\-info (1),
-.BR distro\-info (1)
-.SH AUTHOR
-The script and this manual page was written by
-Benjamin Drung <bdrung@ubuntu.com>.

doc/ubuntu-upload-permission.1

@@ -0,0 +1,60 @@
+.\" Copyright (C) 2011, Stefano Rivera <stefanor@ubuntu.com>
+.\"
+.\" Permission to use, copy, modify, and/or distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.TH ubuntu\-upload\-permission 1 "November 2011" ubuntu\-dev\-tools
+
+.SH NAME
+ubuntu\-upload\-permission \- Query upload rights and (optionally) list
+the people and teams with upload rights for a package
+
+.SH SYNOPSIS
+.B ubuntu\-upload\-permission \fR[\fIoptions\fR] \fIpackage
+
+.SH DESCRIPTION
+\fBubuntu\-upload\-permission\fR checks if the user has upload
+permissions for \fIpackage\fR.
+If the \fB\-\-list\-uploaders\fR option is provided, all the people and
+teams that do have upload rights for \fIpackage\fR will be listed.
+
+.SH OPTIONS
+.TP
+\fB\-r\fR \fIRELEASE\fR, \fB\-\-release\fR=\fIRELEASE\fR
+Query permissions in \fIRELEASE\fR.
+Default: current development release.
+.TP
+\fB\-a\fR, \fB\-\-list\-uploaders\fR
+List all the people and teams who have upload rights for \fIpackage\fR.
+.TP
+\fB\-t\fR, \fB\-\-list\-team\-members\fR
+List all the members of every team with rights. (Implies
+\fB\-\-list\-uploaders\fR)
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display a help message and exit
+
+.SH EXIT STATUS
+.TP
+.B 0
+You have the necessary upload rights.
+.TP
+.B 1
+You don't have the necessary upload rights.
+.TP
+.B 2
+There was an error.
+
+.SH AUTHORS
+\fBubuntu\-upload\-permission\fR and this manpage were written by
+Stefano Rivera <stefanor@ubuntu.com>.
+.PP
+Both are released under the terms of the ISC License.

enforced-editing-wrapper

@@ -0,0 +1,62 @@
+#!/usr/bin/python3
+#
+# Copyright (C) 2011, Stefano Rivera <stefanor@ubuntu.com>
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+#
+#
+# Wraps sensisible-editor in checks for remaining boilerplate.
+# Configured through environment variables:
+# UDT_EDIT_WRAPPER_EDITOR: The user's usual $EDITOR
+# UDT_EDIT_WRAPPER_VISUAL: The user's usual $VISUAL
+# UDT_EDIT_WRAPPER_TEMPLATE_RE: An extra boilerplate-detecting regex.
+# UDT_EDIT_WRAPPER_FILE_DESCRIPTION: The type of file being edited.
+
+# pylint: disable=invalid-name
+# pylint: enable=invalid-name
+
+import argparse
+import os
+import re
+
+from ubuntutools.question import EditFile
+
+
+def main():
+    parser = argparse.ArgumentParser(usage="%(prog)s [options] filename")
+    parser.add_argument("filename", help=argparse.SUPPRESS)
+    args = parser.parse_args()
+    if not os.path.isfile(args.filename):
+        parser.error(f"File {args.filename} does not exist")
+
+    if "UDT_EDIT_WRAPPER_EDITOR" in os.environ:
+        os.environ["EDITOR"] = os.environ["UDT_EDIT_WRAPPER_EDITOR"]
+    else:
+        del os.environ["EDITOR"]
+
+    if "UDT_EDIT_WRAPPER_VISUAL" in os.environ:
+        os.environ["VISUAL"] = os.environ["UDT_EDIT_WRAPPER_VISUAL"]
+    else:
+        del os.environ["VISUAL"]
+
+    placeholders = []
+    if "UDT_EDIT_WRAPPER_TEMPLATE_RE" in os.environ:
+        placeholders.append(re.compile(os.environ["UDT_EDIT_WRAPPER_TEMPLATE_RE"]))
+
+    description = os.environ.get("UDT_EDIT_WRAPPER_FILE_DESCRIPTION", "file")
+
+    EditFile(args.filename, description, placeholders).edit()
+
+
+if __name__ == "__main__":
+    main()

examples/massfile.instructions

@@ -1,16 +0,0 @@
-subject: [UNMETDEPS] $pack has unmet dependencies
-assignee:
-status: confirmed
-subscribers: motu
-tags: unmetdeps
-buglist-url: http://bugs.launchpad.net/ubuntu/+bugs?field.tag=unmetdeps
-text:
- A run of
- .
-  LC_ALL=C apt-cache -i unmet | grep ^Package | cut -d' ' -f2 | grep
-  -v dbgsym | sort -u | xargs apt-cache showsrc | grep ^Directory |
-  sed 's/Package\:\ //g' | grep verse | cut -d'/' -f4
- indicates that the source package $pack has binary packages that are not
- installable (on AMD64) at the moment.
- .
- Please have a look and make sure it's installable again.

examples/massfile.list

@@ -1,2 +0,0 @@
-z88dk
-zope-quotafolder

get-branches

@@ -1,118 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-#
-# Copyright (C) 2007 Canonical Ltd.
-# Created by Daniel Holbach <daniel.holbach@ubuntu.com>
-# Modified by Jonathan Patrick Davies <jpds@ubuntu.com>
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-#
-# ##################################################################
-#
-# This script is used to checkout or branch all the Bazaar branches
-# of a Launchpad team.
-#
-
-import os
-import subprocess
-import sys
-from optparse import OptionParser
-from ubuntutools.lp.lpapicache import PersonTeam
-
-def main():
-    usage = "Usage: %prog [-d <directory>] -t <team> [-o <operation>]"
-    usage += "\nUsage: %prog <team>"
-    opt_parser = OptionParser(usage)
-
-    # Our options.
-    opt_parser.add_option("-d", "--directory", action="store", type="string",
-                          dest="directory", default=os.getcwd(),
-                          help="Directory to download branches to.")
-    opt_parser.add_option("-t", "--team", action="store", type="string",
-                          dest="lpteam",
-                          help="Launchpad team to download branches from.")
-    opt_parser.add_option("-o", "--operation", action="store", type="string",
-                          dest="operation", default="branch",
-                          help="Whether to branch or checkout the Bazaar "
-                               "branches. May be either 'branch' or "
-                               "'checkout'.")
-
-    (options, args) = opt_parser.parse_args()
-
-    # Fetch our current directory to return to later.
-    pwd = os.getcwd()
-
-    # Parse our options.
-    if len(args) != 1 and options.lpteam == None:
-        opt_parser.error("No team has been specified.")
-
-    # Dictionary settings.
-    directory = options.directory
-    if not os.path.isdir(directory): # Check that it is a directory.
-        opt_parser.error("%s is not a valid directory." % directory)
-    os.chdir(directory)
-
-    # Type of Bazaar operation to perform.
-    operation_type = options.operation.lower()
-    if operation_type not in ("branch", "checkout"):
-        opt_parser.error("Invalid operation '%s' for '-o' flag." % \
-            operation_type)
-
-    # Launchpad team setting.
-    if options.lpteam:
-        team = options.lpteam.lower()
-    if args:
-        team = args[0].lower()
-    try:
-        team = PersonTeam(team)
-    except KeyError:
-        print >> sys.stderr, "E: The team '%s' doesn't exist." % team
-
-    # Get a list of branches
-    branches = team.getBranches()
-
-    print "Downloading all branches for the '%s' team. This may take some " \
-        "time." % team.display_name
-
-    try:
-        os.makedirs(team.name)
-    except:
-        pass
-
-    os.chdir(team.name)
-
-    for branch in branches:
-        project_name = branch.project.name
-        if not os.path.exists(project_name):
-            os.makedirs(project_name)
-        os.chdir(project_name)
-
-        if not os.path.exists(branch.name):
-            print "Branching %s ..." % branch.display_name
-            cmd = ["bzr", operation_type, branch.bzr_identity, branch.name]
-            subprocess.call(cmd)
-        else:
-            print "Merging %s ..." % branch.display_name
-            os.chdir(branch.name)
-            subprocess.call(["bzr", "merge", "--pull", "--remember"])
-        os.chdir(os.path.join(directory, team.name))
-
-    os.chdir(pwd)
-    sys.exit(0)
-
-if __name__ == "__main__":
-    try:
-        main()
-    except KeyboardInterrupt:
-        print "Operation was interrupted by user."

get-build-deps

@@ -1,95 +0,0 @@
-#!/bin/bash
-#
-# Copyright 2007 (C) Siegfried-A. Gevatter <rainct@ubuntu.com>
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; either version 3
-# of the License, or (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL for more details.
-#
-# ##################################################################
-#
-# If you don't pass it any argument, this script will check if
-# there's a control (debian/control) file somewhere in the current
-# directory, and if it's so, it'll install the build dependencies
-# listed there.
-#
-# If it gets a single argument, and it's the name of a file, it will
-# read it, supposing that each line contains the name of a package,
-# and install the build dependencies for all those.
-#
-# Otherwise, if there is more than one argument, or the given argument
-# isn't the name of an existing file, it will suppose that the each
-# argument is the name of a package, and install the dependencies for
-# all of them.
-
-if [ $# -eq 0 ]
-then
-	#########################################################
-	# Install the dependencies for the source package the
-	# user is working on.
-
-	if [ -f ../debian/control ]; then
-		cd ..
-	elif [ ! -f ./debian/control ]; then
-		echo "\
-Couldn't find file debian/control. You have to be inside the \
-source directory of a Debian package or pass the name of the \
-package(s) whose build dependencies you want to install in order \
-to use this script."
-		exit 1
-	fi
-
-	filepath="`pwd`/debian/control"
-	missing_dependencies=$(dpkg-checkbuilddeps 2>&1)
-
-	if [ -z "$missing_dependencies" ]; then
-		echo "The build dependencies described in «$filepath» are already satisfied."
-		exit 0
-	fi
-
-	echo "Installing the build dependencies described in «$filepath»..."
-
-	if [ -x /usr/lib/pbuilder/pbuilder-satisfydepends ]
-	then
-		sudo /usr/lib/pbuilder/pbuilder-satisfydepends
-	else
-		echo "Warning: «pbuilder» isn\'t installed, falling back to «dpkg-checkbuilddeps»."
-		sudo aptitude install $(echo $missing_dependencies | awk -F: '{ print $3 }' | sed 's/([^)]*)//g' | sed 's/|\s[^\s]*//g')
-		#' <--- Fix to avoid Geanys markup breaking
-	fi
-	exit 0
-elif [ $# -eq 1 ]
-then
-	#########################################################
-	# Check if the given argument is a file name, else
-	# continue after the if.
-	if [ -f $1 ]
-	then
-		packages=''
-		echo "Installing the build dependencies for the following packages:"
-		while read line
-		do
-			echo $line
-			packages="$packages $line"
-		done < $1
-		echo
-		sudo apt-get build-dep $packages
-		exit 0
-	fi
-fi
-
-#########################################################
-# All arguments should be package names, install
-# their build dependencies.
-
-sudo apt-get build-dep $*

grab-attachments

@@ -1,83 +0,0 @@
-#!/usr/bin/python
-#
-# Copyright (C) 2007, Canonical Ltd.
-# Written by Daniel Holbach,
-#            Stefano Rivera
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-#
-# ##################################################################
-
-from optparse import OptionParser
-import errno
-import os
-import sys
-
-from launchpadlib.launchpad import Launchpad
-
-from ubuntutools.config import UDTConfig
-
-USAGE = "grab-attachments <bug numbers>"
-
-def main():
-    parser = OptionParser('Usage: %prog [options] <bug numbers>')
-    parser.add_option('-l', '--lpinstance', metavar='INSTANCE',
-                      dest='lpinstance', default=None,
-                      help='Launchpad instance to connect to '
-                           '(default: production)')
-    parser.add_option('--no-conf',
-                      dest='no_conf', default=False, action='store_true',
-                      help="Don't read config files or environment variables")
-    opts, args = parser.parse_args()
-    if len(args) < 1:
-        parser.error('No bug numbers provided')
-    config = UDTConfig(opts.no_conf)
-    if opts.lpinstance is None:
-        opts.lpinstance = config.get_value('LPINSTANCE')
-
-    try:
-        launchpad = Launchpad.login_with("ubuntu-dev-tools", opts.lpinstance)
-
-        for arg in args:
-            try:
-                number = int(arg)
-            except ValueError:
-                parser.error("'%s' is not a valid bug number." % arg)
-
-            bug = launchpad.bugs[number]
-
-            bug_folder_name = 'bug-%s' % number
-
-            try:
-                os.mkdir(bug_folder_name)
-            except OSError, error:
-                if error.errno == errno.EEXIST:
-                    continue
-
-            for attachment in bug.attachments:
-                f = attachment.data.open()
-                filename = os.path.join(os.getcwd(), bug_folder_name,
-                                        f.filename)
-                local_file = open(filename, "w")
-                local_file.write(f.read())
-                f.close()
-                local_file.close()
-
-    # no LP credentials
-    except IOError, error:
-        print error
-        sys.exit(1)
-
-if __name__ == '__main__':
-    main()

grab-merge

@@ -59,10 +59,10 @@ fi
 if [ "$RSYNC" = "y" ]; then
     URL="merges.ubuntu.com:/srv/patches.ubuntu.com/merges/$HASH/$MERGE/"
     rsync --verbose --archive --progress --compress --delete \
-	"$URL" . || { echo "Error while rsyncing $URL"; exit 1; }
+        "$URL" . || { echo "Error while rsyncing $URL"; exit 1; }
 else
     rm -rf  --one-file-system *
-    wget -q https://merges.ubuntu.com/$HASH/$MERGE/REPORT || {
+    wget -nv https://merges.ubuntu.com/$HASH/$MERGE/REPORT || {
             echo "Package not found on merges.ubuntu.com."
             [ "$CREATED_DIR" != "1" ] || { cd ..; rmdir $MERGE; }
             exit 1

grep-merges

@@ -1,4 +1,4 @@
-#! /usr/bin/python
+#! /usr/bin/python3
 #
 # grep-merges - search for pending merges from Debian
 #
@@ -19,35 +19,70 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-import sys
-import urllib2
+# pylint: disable=invalid-name
+# pylint: enable=invalid-name
+
+import argparse
 import json
+import sys
+
+from httplib2 import Http, HttpLib2Error
 
 import ubuntutools.misc
+from ubuntutools import getLogger
+
+Logger = getLogger()
+
 
 def main():
+    parser = argparse.ArgumentParser(
+        usage="%(prog)s [options] [string]",
+        description="List pending merges from Debian matching string",
+    )
+    parser.add_argument("string", nargs="?", help=argparse.SUPPRESS)
+    args = parser.parse_args()
+
     ubuntutools.misc.require_utf8()
-    if len(sys.argv) > 1:
-        match = sys.argv[1]
-    else:
-        match = None
 
-    for component in ('main', 'main-manual',
-                      'restricted', 'restricted-manual',
-                      'universe', 'universe-manual',
-                      'multiverse', 'multiverse-manual'):
-        page = urllib2.urlopen('http://merges.ubuntu.com/%s.json' % component)
-        for merge in json.load(page):
-            package = merge['source_package']
-            author, uploader = '', ''
-            if 'user' in merge:
-                author = merge['user']
-            if 'uploader' in merge:
-                uploader = '(%s)' % merge['uploader']
-            pretty_uploader = ' '.join((author, uploader)).strip()
-            if (match is None or
-                match in package or match in author or match in uploader):
-                print '%s\t%s' % (package, pretty_uploader)
+    for component in (
+        "main",
+        "main-manual",
+        "restricted",
+        "restricted-manual",
+        "universe",
+        "universe-manual",
+        "multiverse",
+        "multiverse-manual",
+    ):
+        url = f"https://merges.ubuntu.com/{component}.json"
+        try:
+            headers, page = Http().request(url)
+        except HttpLib2Error as e:
+            Logger.exception(e)
+            sys.exit(1)
+        if headers.status != 200:
+            Logger.error("%s: %s %s", url, headers.status, headers.reason)
+            sys.exit(1)
 
-if __name__ == '__main__':
+        for merge in json.loads(page):
+            package = merge["source_package"]
+            author, uploader = "", ""
+            if merge.get("user"):
+                author = merge["user"]
+            if merge.get("uploader"):
+                uploader = f"({merge['uploader']})"
+            teams = merge.get("teams", [])
+
+            pretty_uploader = f"{author} {uploader}"
+            if (
+                args.string is None
+                or args.string in package
+                or args.string in author
+                or args.string in uploader
+                or args.string in teams
+            ):
+                Logger.info("%s\t%s", package, pretty_uploader)
+
+
+if __name__ == "__main__":
     main()

harvest

@@ -1,77 +0,0 @@
-#!/usr/bin/python
-
-# Copyright (C) 2011 Canonical Ltd., Daniel Holbach
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-#
-# ##################################################################
-#
-#
-# harvest - grabs information about development opportunities from
-#           harvest.ubuntu.com
-#
-#
-# Daniel Holbach
-# (c) 2011 Canonical
-
-from optparse import OptionParser
-import urllib2
-import json
-import sys
-
-BASE_URL = "http://harvest.ubuntu.com/"
-URL_STUB = BASE_URL + "opportunities/json/"
-
-def opportunity_summary(data):
-    l = []
-    for key in filter(lambda a: a != "total", data.keys()):
-        l += ["%s (%s)" % (key, data[key])]
-    return ", ".join(l)
-
-def main():
-    usage = "usage: %prog source-package-name"
-    opt_parser = OptionParser(usage)
-    (options, args) = opt_parser.parse_args()
-    if not args:
-        opt_parser.print_help()
-        sys.exit(1)
-    pkg = sys.argv[1]
-    url = URL_STUB + pkg.strip()
-    try:
-        sock = urllib2.urlopen(url)
-    except IOError, e:
-        try:
-            urllib2.urlopen(BASE_URL)
-        except urllib2.URLError, _e:
-            print >> sys.stderr, "Harvest is down."
-            sys.exit(1)
-        print "There is no information in Harvest about package '%s'." % pkg
-        sys.exit(1)
-    response = sock.read()
-    sock.close()
-    data = json.loads(response)
-    print >> sys.stdout, \
-"""%s has %s opportunities: %s
-Find out more: %sopportunities/package/%s""" % (pkg,
-                              data["total"],
-                              opportunity_summary(data),
-                              BASE_URL,
-                              pkg)
-
-if __name__ == '__main__':
-    try:
-        main()
-    except KeyboardInterrupt:
-        print >> sys.stderr, "Aborted."
-        sys.exit(1)

hugdaylist

@@ -1,136 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-#
-# Copyright (C) 2007 Canonical Ltd., Daniel Holbach
-# Copyright (C) 2008 Jonathan Patrick Davies <jpds@ubuntu.com>
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-#
-# ##################################################################
-#
-#
-# hugdaylist - produces MoinMoin wiki formatted tables based on a Launchpad bug
-#              list.
-#
-# hugdaylist <url>
-# - produces lists like https://wiki.ubuntu.com/UbuntuBugDay/20070912?action=raw
-#
-# hugdaylist -n <howmany> <url>
-# - will only list <howmany> URLs.
-
-import sys
-from optparse import OptionParser
-
-from launchpadlib.launchpad import Launchpad
-
-from ubuntutools.lp.libsupport import translate_web_api
-
-def check_args():
-    howmany = -1
-    url = ""
-
-    # Our usage options.
-    usage = "usage: %prog [-n <number>] launchpad-buglist-url"
-    opt_parser = OptionParser(usage)
-
-    # Options - namely just the number of bugs to output.
-    opt_parser.add_option("-n", "--number", type="int",
-                          dest="number", help="Number of entries to output.")
-
-    # Parse arguments.
-    (options, args) = opt_parser.parse_args()
-
-    # Check if we want a number other than the default.
-    howmany = options.number
-
-    # Check that we have an URL.
-    if not args:
-        print >> sys.stderr, "An URL pointing to a Launchpad bug list is " \
-           "required."
-        opt_parser.print_help()
-        sys.exit(1)
-    else:
-        url = args[0]
-
-    return (howmany, url)
-
-def filter_unsolved(task):
-    # TODO: don't use this filter here, only check status and assignee of
-    #   the given task
-    # Filter out special types of bugs:
-    # - https://wiki.ubuntu.com/Bugs/HowToTriage#Special%20types%20of%20bugs
-    # this is expensive, parse name out of self_link instead?
-    subscriptions = set(s.person.name for s in task.bug.subscriptions)
-    if (task.status != "Fix Committed" and
-        (not task.assignee or task.assignee.name in ['motu','desktop-bugs']) and
-         'ubuntu-sponsors' not in subscriptions and
-         'ubuntu-archive' not in subscriptions):
-        return True
-    return False
-
-def main():
-    (howmany, url) = check_args()
-    if len(url.split("?", 1)) == 2:
-        # search options not supported, because there is no mapping web ui
-        # options <-> API options
-        print >> sys.stderr, "Options in url are not supported, url: %s" % url
-        sys.exit(1)
-
-    launchpad = None
-    try:
-        launchpad = Launchpad.login_with("ubuntu-dev-tools", 'production')
-    except IOError, error:
-        print error
-        sys.exit(1)
-
-    api_url = translate_web_api(url, launchpad)
-    try:
-        product = launchpad.load(api_url)
-    except Exception, error:
-        response = getattr(error, "response", {})
-        if response.get("status", None) == "404":
-            print >> sys.stderr, ("The URL at '%s' does not appear to be a "
-                                  "valid url to a product") % url
-            sys.exit(1)
-        else:
-            raise
-
-    bug_list = [b for b in product.searchTasks() if filter_unsolved(b)]
-
-    if not bug_list:
-        print "Bug list of %s is empty." % url
-        sys.exit(0)
-    if howmany == -1:
-        howmany = len(bug_list)
-
-    print """
-## ||<rowbgcolor="#CCFFCC"> This task is done || somebody || ||
-## ||<rowbgcolor="#FFFFCC"> This task is assigned || somebody || <status> ||
-## ||<rowbgcolor="#FFEBBB"> This task isn't || ... || ||
-## ||<rowbgcolor="#FFCCCC"> This task is blocked on something || somebody || <explanation> ||
-
-|| Bug || Subject || Triager ||"""
-
-    for i in list(bug_list)[:howmany]:
-        bug = i.bug
-        print '||<rowbgcolor="#FFEBBB"> [%s %s] || %s || ||' % \
-            (bug.web_link, bug.id, bug.title)
-
-
-if __name__ == '__main__':
-    try:
-        main()
-    except KeyboardInterrupt:
-        print >> sys.stderr, "Aborted."
-        sys.exit(1)

import-bug-from-debian

@@ -1,8 +1,7 @@
-#!/usr/bin/python
-# -*- coding: UTF-8 -*-
+#!/usr/bin/python3
 
 # Copyright © 2009 James Westby <james.westby@ubuntu.com>,
-#             2010 Stefano Rivera <stefanor@ubuntu.com>
+#             2010, 2011 Stefano Rivera <stefanor@ubuntu.com>
 #
 # ##################################################################
 #
@@ -22,177 +21,236 @@
 #
 # ##################################################################
 
-from optparse import OptionParser, SUPPRESS_HELP
+# pylint: disable=invalid-name
+# pylint: enable=invalid-name
+
+import argparse
+import logging
 import re
 import sys
-import subprocess
-
-try:
-    import SOAPpy
-except ImportError:
-    print >> sys.stderr, ("Please install 'python-soappy' in order to use "
-                          "this utility.")
-    sys.exit(1)
+import webbrowser
+from collections.abc import Iterable
+from email.message import EmailMessage
 
+import debianbts
 from launchpadlib.launchpad import Launchpad
 
+from ubuntutools import getLogger
 from ubuntutools.config import UDTConfig
 
-def main():
+Logger = getLogger()
+ATTACHMENT_MAX_SIZE = 2000
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "-b",
+        "--browserless",
+        action="store_true",
+        help="Don't open the bug in the browser at the end",
+    )
+    parser.add_argument(
+        "-l",
+        "--lpinstance",
+        metavar="INSTANCE",
+        help="LP instance to connect to (default: production)",
+    )
+    parser.add_argument(
+        "-v", "--verbose", action="store_true", help="Print info about the bug being imported"
+    )
+    parser.add_argument(
+        "-n",
+        "--dry-run",
+        action="store_true",
+        help="Don't actually open a bug (also sets verbose)",
+    )
+    parser.add_argument(
+        "-p", "--package", help="Launchpad package to file bug against (default: Same as Debian)"
+    )
+    parser.add_argument(
+        "--no-conf", action="store_true", help="Don't read config files or environment variables."
+    )
+    parser.add_argument("bugs", nargs="+", help="Bug number(s) or URL(s)")
+    return parser.parse_args()
+
+
+def get_bug_numbers(bug_list: Iterable[str]) -> list[int]:
     bug_re = re.compile(r"bug=(\d+)")
 
-    url = 'http://bugs.debian.org/cgi-bin/soap.cgi'
-    namespace = 'Debbugs/SOAP'
-    debbugs = SOAPpy.SOAPProxy(url, namespace)
+    bug_nums = []
 
-    # debug
-    #debbugs.config.dumpSOAPOut = 1
-    #debbugs.config.dumpSOAPIn = 1
+    for bug_num in bug_list:
+        if bug_num.startswith("http"):
+            # bug URL
+            match = bug_re.search(bug_num)
+            if match is None:
+                Logger.error("Can't determine bug number from %s", bug_num)
+                sys.exit(1)
+            bug_num = match.groups()[0]
+        bug_num = bug_num.lstrip("#")
+        bug_nums.append(int(bug_num))
 
-    parser = OptionParser(usage="%prog [option] bug ...")
-    parser.add_option("-b", "--browserless",
-                      help="Don't open the bug in the browser at the end",
-                      dest="browserless", action="store_true")
-    parser.add_option("-l", "--lpinstance", metavar="INSTANCE",
-                      help="Launchpad instance to connect to "
-                           "(default: production)",
-                      dest="lpinstance", default=None)
-    parser.add_option("-n", "--dry-run",
-                      help=SUPPRESS_HELP,
-                      dest="lpinstance", action="store_const", const="staging")
-    parser.add_option("-p", "--package", metavar="PACKAGE",
-                      help="Launchpad package to file bug against "
-                           "(default: Same as Debian)",
-                      dest="package", default=None)
-    parser.add_option("--no-conf", dest="no_conf", default=False,
-                      help="Don't read config files or environment variables.",
-                      action="store_true")
-    (options, args) = parser.parse_args()
+    return bug_nums
+
+
+def walk_multipart_message(message: EmailMessage) -> tuple[str, list[tuple[int, EmailMessage]]]:
+    summary = ""
+    attachments = []
+    i = 1
+    for part in message.walk():
+        content_type = part.get_content_type()
+
+        if content_type.startswith("multipart/"):
+            # we're already iterating on multipart items
+            # let's just skip the multipart extra metadata
+            continue
+        if content_type == "application/pgp-signature":
+            # we're not interested in importing pgp signatures
+            continue
+
+        if part.is_attachment():
+            attachments.append((i, part))
+        elif content_type.startswith("image/"):
+            # images here are not attachment, they are inline, but Launchpad can't handle that,
+            # so let's add them as attachments
+            summary += f"Message part #{i}\n"
+            summary += f"[inline image '{part.get_filename()}']\n\n"
+            attachments.append((i, part))
+        elif content_type.startswith("text/html"):
+            summary += f"Message part #{i}\n"
+            summary += "[inline html]\n\n"
+            attachments.append((i, part))
+        elif content_type == "text/plain":
+            summary += f"Message part #{i}\n"
+            summary += part.get_content() + "\n"
+        else:
+            raise RuntimeError(
+                f"""Unknown message part
+Your Debian bug is too weird to be imported in Launchpad, sorry.
+You can fix that by patching this script in ubuntu-dev-tools.
+Faulty message part:
+{part}"""
+            )
+        i += 1
+
+    return summary, attachments
+
+
+def process_bugs(
+    bugs: Iterable[debianbts.Bugreport],
+    launchpad: Launchpad,
+    package: str,
+    dry_run: bool = True,
+    browserless: bool = False,
+) -> bool:
+    debian = launchpad.distributions["debian"]
+    ubuntu = launchpad.distributions["ubuntu"]
+    lp_debbugs = launchpad.bug_trackers.getByName(name="debbugs")
+
+    err = False
+    for bug in bugs:
+        ubupackage = bug.source
+        if package:
+            ubupackage = package
+        bug_num = bug.bug_num
+        subject = bug.subject
+        log = debianbts.get_bug_log(bug_num)
+        message = log[0]["message"]
+        assert isinstance(message, EmailMessage)
+        attachments: list[tuple[int, EmailMessage]] = []
+        if message.is_multipart():
+            summary, attachments = walk_multipart_message(message)
+        else:
+            summary = str(message.get_payload())
+
+        target = ubuntu.getSourcePackage(name=ubupackage)
+        if target is None:
+            Logger.error(
+                "Source package '%s' is not in Ubuntu. Please specify "
+                "the destination source package with --package",
+                ubupackage,
+            )
+            err = True
+            continue
+
+        description = f"Imported from Debian bug http://bugs.debian.org/{bug_num}:\n\n{summary}"
+        # LP limits descriptions to 50K chars
+        description = (description[:49994] + " [...]") if len(description) > 50000 else description
+
+        Logger.debug("Target: %s", target)
+        Logger.debug("Subject: %s", subject)
+        Logger.debug("Description: ")
+        Logger.debug(description)
+        for i, attachment in attachments:
+            Logger.debug("Attachment #%s (%s)", i, attachment.get_filename() or "inline")
+            Logger.debug("Content:")
+            if attachment.get_content_type() == "text/plain":
+                content = attachment.get_content()
+                if len(content) > ATTACHMENT_MAX_SIZE:
+                    content = (
+                        content[:ATTACHMENT_MAX_SIZE]
+                        + f" [attachment cropped after {ATTACHMENT_MAX_SIZE} characters...]"
+                    )
+                Logger.debug(content)
+            else:
+                Logger.debug("[data]")
+
+        if dry_run:
+            Logger.info("Dry-Run: not creating Ubuntu bug.")
+            continue
+
+        u_bug = launchpad.bugs.createBug(target=target, title=subject, description=description)
+        for i, attachment in attachments:
+            name = f"#{i}-{attachment.get_filename() or "inline"}"
+            content = attachment.get_content()
+            if isinstance(content, str):
+                # Launchpad only wants bytes
+                content = content.encode()
+            u_bug.addAttachment(
+                filename=name,
+                data=content,
+                comment=f"Imported from Debian bug http://bugs.debian.org/{bug_num}",
+            )
+        d_sp = debian.getSourcePackage(name=package)
+        if d_sp is None and package:
+            d_sp = debian.getSourcePackage(name=package)
+        d_task = u_bug.addTask(target=d_sp)
+        d_watch = u_bug.addWatch(remote_bug=bug_num, bug_tracker=lp_debbugs)
+        d_task.bug_watch = d_watch
+        d_task.lp_save()
+        Logger.info("Opened %s", u_bug.web_link)
+        if not browserless:
+            webbrowser.open(u_bug.web_link)
+
+    return err
+
+
+def main() -> None:
+    options = parse_args()
 
     config = UDTConfig(options.no_conf)
     if options.lpinstance is None:
         options.lpinstance = config.get_value("LPINSTANCE")
 
-    try:
+    if options.dry_run:
+        launchpad = Launchpad.login_anonymously("ubuntu-dev-tools")
+        options.verbose = True
+    else:
         launchpad = Launchpad.login_with("ubuntu-dev-tools", options.lpinstance)
-    except IOError, msg:
-        print msg
-        print "No credentials, can't continue"
+
+    if options.verbose:
+        Logger.setLevel(logging.DEBUG)
+
+    bugs = debianbts.get_status(get_bug_numbers(options.bugs))
+
+    if not bugs:
+        Logger.error("Cannot find any of the listed bugs")
         sys.exit(1)
 
-    debian = launchpad.distributions['debian']
-    ubuntu = launchpad.distributions['ubuntu']
-    lp_debbugs = launchpad.bug_trackers.getByName(name='debbugs')
+    if process_bugs(bugs, launchpad, options.package, options.dry_run, options.browserless):
+        sys.exit(1)
 
-    bug_nums = []
 
-    for bug_num in args:
-        if bug_num.startswith("http"):
-            # bug URL
-            match = bug_re.search(bug_num)
-            if match is None:
-                raise ValueError("Can't determine bug number from %s" % bug_num)
-            bug_num = match.groups()[0]
-        bug_num = bug_num.lstrip("#")
-        bug_num = int(bug_num)
-        bug_nums.append(bug_num)
-
-    bugs = debbugs.get_status(*bug_nums)
-
-    if len(bug_nums) > 1:
-        bugs = bugs[0]
-
-    #import pdb; pdb.set_trace()
-    for bug in bugs:
-        bug = bug.value
-        package = bug.package
-        ubupackage = package
-        if options.package:
-            ubupackage = options.package
-        bug_num = bug.bug_num
-        subject = bug.subject
-        log = debbugs.get_bug_log(bug_num)
-        summary = log[0][0]
-        target = ubuntu.getSourcePackage(name=ubupackage)
-        u_bug = launchpad.bugs.createBug(target=target, title=subject,
-                description='Imported from Debian bug '
-                            'http://bugs.debian.org/%d:\n\n%s'
-                            % (bug_num, summary))
-        d_sp = debian.getSourcePackage(name=package)
-        if d_sp is None and options.package:
-            d_sp = debian.getSourcePackage(name=options.package)
-        d_task = u_bug.addTask(target=d_sp)
-        d_watch = u_bug.addWatch(remote_bug=bug_num, bug_tracker=lp_debbugs)
-        d_task.bug_watch = d_watch
-        d_task.lp_save()
-        print "Opened %s" % u_bug.web_link
-        if not options.browserless:
-            subprocess.call(["xdg-open", u_bug.web_link])
-
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
-
-#def get_status(*args):
-#    result = server.get_status(*args)
-#    return result
-#
-#def get_bugs(*args):
-#    result = server.get_bugs(*args)
-#    return result
-#
-#def get_usertag(email, *tags):
-#    result = server.get_usertag(email, *tags)
-#    return result
-#
-#def get_bug_log(bugnumber):
-#    result = server.get_bug_log(bugnumber)
-#    return result
-#
-#def newest_bugs(amount):
-#    result = server.newest_bugs(amount)
-#    return result
-#
-#if __name__ == "__main__":
-#    # Demonstration
-#
-#    # some debug output
-#
-#    # All bugs from one package (returns a list of bugnumbers)
-#    print get_bugs("package", "gtk-qt-engine")
-#
-#    # All bugs of a maintainer
-#    print get_bugs("maint", "debian-qa@lists.debian.org")
-#
-#    # returns the status of those bugs
-#    print get_status(409909, 419920, 421581, 417044, 397993)
-#
-#    # get_status and get_bugs combined:
-#    print get_status(get_bugs("package", "gtk-qt-engine"))
-#
-#    # returns the full log for the given bug number
-#    print get_bug_log(202526)
-#
-#    # retrives the newest 20 bugs
-#    print newest_bugs(20)
-#
-#    # All bugs of a maintainer
-#    print get_bugs("maint", "debian-qa@lists.debian.org")
-#
-#    # returns the status of those bugs
-#    print get_status(409909, 419920, 421581, 417044, 397993)
-#
-#    # get_status and get_bugs combined:
-#    print get_status(get_bugs("package", "gtk-qt-engine"))
-#
-#    # returns the full log for the given bug number
-#    print get_bug_log(202526)
-#
-#    # retrives the newest 20 bugs
-#    print newest_bugs(20)
-#
-#    # returns bugs tagged by the given email
-#    print get_usertag("debian-qa@lists.debian.org")
-#
-#    # returns bugs tagged by the given email, with the given tag
-#    print get_usertag("debian-qa@lists.debian.org", "qa-ftbfs-20070708")
-#

lp-bitesize

@@ -0,0 +1,105 @@
+#!/usr/bin/python3
+"""Add 'bitesize' tag to bugs and add a comment."""
+
+# Copyright (c) 2011 Canonical Ltd.
+#
+# bitesize is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation; either version 3, or (at your option) any
+# later version.
+#
+# bitesize is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with bitesize; see the file COPYING.  If not, write to the Free
+# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301, USA.
+#
+# Authors:
+#  Daniel Holbach <daniel.holbach@canonical.com>
+
+import argparse
+import sys
+
+from launchpadlib.errors import HTTPError
+from launchpadlib.launchpad import Launchpad
+
+from ubuntutools import getLogger
+from ubuntutools.config import UDTConfig
+
+Logger = getLogger()
+
+
+def error_out(msg, *args):
+    Logger.error(msg, *args)
+    sys.exit(1)
+
+
+def save_entry(entry):
+    try:
+        entry.lp_save()
+    except HTTPError as error:
+        error_out("%s", error.content)
+
+
+def tag_bug(bug):
+    bug.tags = bug.tags + ["bitesize"]  # LP: #254901 workaround
+    save_entry(bug)
+
+
+def main():
+    parser = argparse.ArgumentParser(usage="%(prog)s [options] <bug number>")
+    parser.add_argument(
+        "-l",
+        "--lpinstance",
+        metavar="INSTANCE",
+        help="Launchpad instance to connect to (default: production)",
+        dest="lpinstance",
+        default=None,
+    )
+    parser.add_argument(
+        "--no-conf",
+        help="Don't read config files or environment variables.",
+        dest="no_conf",
+        default=False,
+        action="store_true",
+    )
+    parser.add_argument("bug_number", help=argparse.SUPPRESS)
+    args = parser.parse_args()
+    config = UDTConfig(args.no_conf)
+    if args.lpinstance is None:
+        args.lpinstance = config.get_value("LPINSTANCE")
+
+    launchpad = Launchpad.login_with("ubuntu-dev-tools", args.lpinstance)
+    if launchpad is None:
+        error_out("Couldn't authenticate to Launchpad.")
+
+    # check that the new main bug isn't a duplicate
+    try:
+        bug = launchpad.bugs[args.bug_number]
+    except HTTPError as error:
+        if error.response.status == 401:
+            error_out(
+                "Don't have enough permissions to access bug %s. %s",
+                args.bug_number,
+                error.content,
+            )
+        else:
+            raise
+    if "bitesize" in bug.tags:
+        error_out("Bug is already marked as 'bitesize'.")
+    bug.newMessage(
+        content="I'm marking this bug as 'bitesize' as it looks "
+        "like an issue that is easy to fix and suitable "
+        "for newcomers in Ubuntu development. If you need "
+        "any help with fixing it, talk to me about it."
+    )
+    bug.subscribe(person=launchpad.me)
+    tag_bug(launchpad.bugs[bug.id])  # fresh bug object, LP: #336866 workaround
+
+
+if __name__ == "__main__":
+    main()

lp-list-bugs

@@ -1,63 +0,0 @@
-#! /usr/bin/python
-# -*- coding: UTF-8 -*-
-"""Briefly list status of Launchpad bugs."""
-
-# Copyright (c) 2010 Canonical Ltd.
-#
-# lp-set-dup is free software; you can redistribute it and/or modify it
-# under the terms of the GNU General Public License as published by the
-# Free Software Foundation; either version 3, or (at your option) any
-# later version.
-#
-# lp-set-dup is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with lp-set-dup; see the file COPYING.  If not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301, USA.
-#
-# Authors:
-#  Colin Watson <cjwatson@ubuntu.com>
-
-import sys
-from optparse import OptionParser
-
-from launchpadlib.launchpad import Launchpad
-from launchpadlib.errors import HTTPError
-
-def main():
-    usage = "Usage: %prog <bug> [...]"
-    parser = OptionParser(usage)
-    args = parser.parse_args()[1]
-    if len(args) < 1:
-        parser.error("Need at least one bug number")
-
-    try:
-        launchpad = Launchpad.login_with('ubuntu-dev-tools', 'production')
-    except Exception, error:
-        print >> sys.stderr, 'Could not connect to Launchpad:', str(error)
-        sys.exit(2)
-
-    for bugnum in args:
-        try:
-            bug = launchpad.bugs[bugnum]
-            print "Bug %s: %s" % (bugnum, bug.title)
-            for task in bug.bug_tasks:
-                print "  %s: %s" % (task.bug_target_name, task.status)
-        except HTTPError, error:
-            if error.response.status == 401:
-                print >> sys.stderr, \
-                    ("E: Don't have enough permissions to access bug %s" %
-                     bugnum)
-                print >> sys.stderr, error.content
-                continue
-            elif error.response.status == 404:
-                print >> sys.stderr, "E: Bug %s not found" % bugnum
-            else:
-                raise
-
-if __name__ == '__main__':
-    main()

lp-project-upload

@@ -1,159 +0,0 @@
-#!/usr/bin/python
-
-# Copyright (c) 2009 Canonical Ltd.
-#
-# This program is free software; you can redistribute it and/or modify it
-# under the terms of the GNU General Public License as published by the
-# Free Software Foundation; either version 2, or (at your option) any
-# later version.
-#
-# lp-project-upload is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# General Public License for more details.
-
-# Authors:
-#  Martin Pitt <martin.pitt@ubuntu.com>, based on
-#  http://blog.launchpad.net/api/recipe-for-uploading-files-via-the-api
-
-'''Upload a release tarball to a Launchpad project.'''
-
-import datetime
-import os
-import subprocess
-import sys
-import tempfile
-
-from launchpadlib.launchpad import Launchpad
-from launchpadlib.errors import HTTPError
-
-def create_release(project, version):
-    '''Create new release and milestone for LP project.'''
-
-    print 'Release %s could not be found for project. Create it? (Y/n)' % \
-          version
-    answer = sys.stdin.readline().strip()
-    if answer.startswith('n'):
-        sys.exit(0)
-
-    n_series = len(project.series)
-    if n_series == 1:
-        series = project.series[0]
-    elif n_series > 1:
-        msg = 'More than one series exist. Which one would you like to ' \
-              'upload to? Possible series are (listed as index, name):'
-        print msg
-        for idx, serie in enumerate(project.series):
-            print '\t%i - %s' % (idx, serie.name)
-        print 'Enter series index: '
-        answer = sys.stdin.readline().strip()
-        try:
-            series = project.series[int(answer)]
-        except (ValueError, IndexError):
-            print >> sys.stderr, 'The series index is invalid (%s).' % answer
-            sys.exit(3)
-        else:
-            print "Using series named '%s'" % series.name
-    else:
-        print >> sys.stderr, ('Does not support creating releases if no '
-                              'series exists.')
-        sys.exit(3)
-
-    release_date = datetime.date.today().strftime('%Y-%m-%d')
-    milestone = series.newMilestone(name=version,
-            date_targeted=release_date)
-    return milestone.createProductRelease(date_released=release_date)
-
-def edit_file(prefix, description):
-    (fd, f) = tempfile.mkstemp(prefix=prefix+'.')
-    os.write(fd, '\n\n#------\n# Please enter the %s here. '
-                 'Lines which start with "#" are ignored.\n' % description)
-    os.close(fd)
-    subprocess.call(['sensible-editor', f])
-    content = ''
-    for line in open(f):
-        if line.startswith('#'):
-            continue
-        content += line
-
-    return content.strip()
-
-def main():
-    if len(sys.argv) != 4 and len(sys.argv) != 5:
-        print >> sys.stderr, '''Upload a release tarball to a Launchpad project.
-
-    Usage: %s <project name> <version> <tarball> [new milestone]''' % sys.argv[0]
-        sys.exit(1)
-
-    if len(sys.argv) == 4:
-        (project, version, tarball) = sys.argv[1:]
-    else:
-        (project, version, tarball, new_milestone) = sys.argv[1:]
-
-    try:
-        launchpad = Launchpad.login_with('ubuntu-dev-tools', 'production')
-    except Exception, error:
-        print >> sys.stderr, 'Could not connect to Launchpad:', str(error)
-        sys.exit(2)
-
-    try:
-        # Look up the project using the Launchpad instance.
-        proj = launchpad.projects[project]
-        # Find the release in the project's releases collection.
-        release = None
-        for rel in proj.releases:
-            if rel.version == version:
-                release = rel
-                break
-        if not release:
-            for milestone in proj.all_milestones:
-                if milestone.name == version:
-                    today = datetime.date.today().strftime('%Y-%m-%d')
-                    release = milestone.createProductRelease(date_released=today)
-        if not release:
-            release = create_release(proj, version)
-
-        # Get the file contents.
-        file_content = open(tarball, 'r').read()
-        # Get the signature, if available.
-        signature = tarball + '.asc'
-        if not os.path.exists(signature):
-            print 'Calling GPG to create tarball signature...'
-            cmd = ['gpg', '--armor', '--sign', '--detach-sig', tarball]
-            if subprocess.call(cmd) != 0:
-                print >> sys.stderr, 'gpg failed, aborting'
-
-        if os.path.exists(signature):
-            signature_content = open(signature, 'r').read()
-        else:
-            signature_content = None
-
-        # Create a new product release file.
-        filename = os.path.basename(tarball)
-        release.add_file(filename=filename, description='release tarball',
-                file_content=file_content, content_type='appplication/x-gzip',
-                file_type='Code Release Tarball', signature_filename=signature,
-                signature_content=signature_content)
-
-        changelog = edit_file('changelog', 'changelog')
-        if changelog:
-            release.changelog = changelog
-        release_notes = edit_file('releasenotes', 'release notes')
-        if release_notes:
-            release.release_notes = release_notes
-
-        release.lp_save()
-
-        # Create a new milestone if requested
-        if new_milestone is not None:
-            mil = release.milestone
-            for series in proj.series:
-                if mil.name in [milestone.name for milestone in series.all_milestones]:
-                    series.newMilestone(name=new_milestone)
-
-    except HTTPError, error:
-        print 'An error happened in the upload:', error.content
-        sys.exit(1)
-
-if __name__ == '__main__':
-    main()

lp-set-dup

@@ -1,134 +0,0 @@
-#!/usr/bin/python
-# -*- coding: UTF-8 -*-
-"""Sets the "duplicate of" bug of a bug and its dups."""
-
-# Copyright (c) 2009 Canonical Ltd.
-#
-# lp-set-dup is free software; you can redistribute it and/or modify it
-# under the terms of the GNU General Public License as published by the
-# Free Software Foundation; either version 2, or (at your option) any
-# later version.
-#
-# lp-set-dup is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with lp-set-dup; see the file COPYING.  If not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301, USA.
-#
-# Authors:
-#  Loïc Minier <lool@dooz.org>
-
-import sys
-from optparse import OptionParser
-
-from launchpadlib.launchpad import Launchpad
-from launchpadlib.errors import HTTPError
-
-from ubuntutools.config import UDTConfig
-
-def die(message):
-    print >> sys.stderr, "Fatal: " + message
-    sys.exit(1)
-
-def main():
-    usage = "Usage: %prog [-f] <new main bug> <bug to dup> [<bug to dup>...]"
-    opt_parser = OptionParser(usage)
-    opt_parser.add_option("-f",
-                          help="Skip confirmation prompt",
-                          dest="force", default=False, action="store_true")
-    opt_parser.add_option("-l", "--lpinstance", metavar="INSTANCE",
-                          help="Launchpad instance to connect to "
-                               "(default: production)",
-                          dest="lpinstance", default=None)
-    opt_parser.add_option("--no-conf",
-                          help="Don't read config files or "
-                               "environment variables.",
-                          dest="no_conf", default=False, action="store_true")
-    (options, args) = opt_parser.parse_args()
-
-    if len(args) < 2:
-        opt_parser.error("Need at least a new main bug and a bug to dup")
-
-    config = UDTConfig(options.no_conf)
-    if options.lpinstance is None:
-        options.lpinstance = config.get_value("LPINSTANCE")
-
-    launchpad = None
-    try:
-        print "Setting up Launchpad"
-        launchpad = Launchpad.login_with("ubuntu-dev-tools", options.lpinstance)
-        print "Launchpad setup complete"
-    except ImportError:
-        suggestion = "check whether python-launchpadlib is installed"
-    if launchpad is None:
-        die("Couldn't setup Launchpad for the ubuntu-dev-tools consumer; %s" % \
-            (suggestion, ))
-
-    # check that the new main bug isn't a duplicate
-    try:
-        new_main_bug = launchpad.bugs[args[0]]
-    except HTTPError, error:
-        if error.response.status == 401:
-            print >> sys.stderr, ("E: Don't have enough permissions to access "
-                                  "bug %s") % (args[0])
-            die(error.content)
-        else:
-            raise
-    new_main_dup_of = new_main_bug.duplicate_of
-    if new_main_dup_of is not None:
-        answer = None
-        try:
-            answer = raw_input("Bug %s is a duplicate of %s; would you like to "
-                               "use %s as the new main bug instead? [y/N]" % \
-                               (new_main_bug.id, new_main_dup_of.id,
-                                new_main_dup_of.id))
-        except:
-            die("Aborted")
-        if answer.lower() not in ("y", "yes"):
-            die("User aborted")
-        new_main_bug = new_main_dup_of
-
-    # build list of bugs to process, first the dups then the bug
-    bugs_to_process = []
-    for bug_number in args[1:]:
-        print "Processing %s" % (bug_number)
-        try:
-            bug = launchpad.bugs[bug_number]
-        except HTTPError, error:
-            if error.response.status == 401:
-                print >> sys.stderr, ("W: Don't have enough permissions to "
-                                      "access bug %s") % (bug_number)
-                print >> sys.stderr, "W: %s" % (error.content)
-                continue
-            else:
-                raise
-        dups = bug.duplicates
-        if dups is not None:
-            bugs_to_process.extend(dups)
-            print "Found %i dups for %s" % (len(dups), bug_number)
-        bugs_to_process.append(bug)
-
-    # process dups first, then their main bug
-    print "Would set the following bugs as duplicates of %s: %s" % \
-          (new_main_bug.id, " ".join([str(b.id) for b in bugs_to_process]))
-
-    if not options.force:
-        answer = None
-        try:
-            answer = raw_input("Proceed? [y/N]")
-        except:
-            die("Aborted")
-        if answer.lower() not in ("y", "yes"):
-            die("User aborted")
-
-    for bug in bugs_to_process:
-        print "Marking bug %s as a duplicate of %s" % (bug.id, new_main_bug.id)
-        bug.duplicate_of = new_main_bug
-        bug.lp_save()
-
-if __name__ == '__main__':
-    main()

lp-shell

@@ -1,86 +0,0 @@
-#!/usr/bin/python
-
-# Open an interactive launchpadlib Python shell.
-# It supports all known LP service instances and API versions. The login
-# can optionally happen anonymously.
-
-# Author: Martin Pitt <martin.pitt@ubuntu.com>
-# Copyright: (C) 2010 Canonical Ltd.
-#
-# This package is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, at version 2.
-#
-# This package is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-import sys
-import code
-from optparse import OptionParser
-
-from launchpadlib.launchpad import Launchpad
-from launchpadlib.uris import lookup_service_root
-
-def main():
-    instance = 'production'
-    valid_api_versions = ('beta', '1.0', 'devel')
-    api_version = '1.0'
-
-    usage = 'Usage: %prog [-a] [instance] [LP API version]'
-    opt_parser = OptionParser(usage)
-    opt_parser.add_option('-a', action='store_true',
-                          dest='anonymous', default=False,
-                          help='Login anonymously into LP.')
-
-    (options, args) = opt_parser.parse_args()
-
-    if len(args) >= 1:
-        try:
-            instance = lookup_service_root(args[0])
-        except ValueError, err:
-            print 'E: %s' % (err)
-            print 'I: Falling back to "production".'
-
-    if len(args) >= 2:
-        if args[1] in valid_api_versions:
-            api_version = args[1]
-        else:
-            print 'E: "%s" is not a valid LP API version.' % (args[1])
-            print 'I: Falling back to "1.0".'
-
-    if options.anonymous:
-        launchpad = Launchpad.login_anonymously('udt-lp-shell', instance,
-                                                version=api_version)
-        banner = ('Connected anonymously to LP service "%s" with API version '
-                  '"%s":' % (instance, api_version))
-    else:
-        launchpad = Launchpad.login_with('udt-lp-shell', instance,
-                                         version=api_version)
-        banner = 'Connected to LP service "%s" with API version "%s":' % \
-                 (instance, api_version)
-
-    banner += '\nNote: LP can be accessed through the "lp" object.'
-
-    class CompleterConsole(code.InteractiveConsole):
-        def __init__(self):
-            local = {'lp': launchpad}
-            code.InteractiveConsole.__init__(self, locals=local)
-            try:
-                import readline
-            except ImportError:
-                print 'I: readline module not available.'
-            else:
-                import rlcompleter
-                readline.parse_and_bind("tab: complete")
-
-    # Disable default apport hook, as lp-shell is intended for interactive use
-    # and thus exceptions often bubble up to the top level.
-    sys.excepthook = sys.__excepthook__
-
-    console = CompleterConsole()
-    console.interact(banner)
-
-if __name__ == '__main__':
-    main()

massfile

@@ -1,180 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-#
-# Copyright (C) 2007 Canonical Ltd.
-#
-# Modified by Iain Lane <iain@orangesquash.org.uk>, taking some code written by
-# Daniel Hahler <ubuntu@thequod.de>
-#
-# python-launchpadlib support was added by Markus Korn <thekorn@gmx.de>.
-#
-# ##################################################################
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# See file /usr/share/common-licenses/GPL-3 for more details.
-#
-# ##################################################################
-
-import optparse
-import os
-import sys
-import email
-
-from launchpadlib.launchpad import Launchpad
-
-from ubuntutools.config import UDTConfig
-from ubuntutools.lp.libsupport import translate_web_api
-
-def read_config():
-    instructions_file = open("instructions")
-    instructions = email.message_from_file(instructions_file)
-    instructions_file.close()
-    instr = dict()
-
-    for field in "subject", "assignee", "subscribers", "tags", "text", \
-                 "buglist-url", "status":
-        instr[field] = instructions.get(field)
-
-    return instr
-
-def read_list():
-    pack_list = set()
-
-    listfile = open("list")
-    for line in listfile.readlines():
-        if line.strip()!="":
-            pack_list.add(line.strip("\n"))
-
-    listfile.close()
-    return pack_list
-
-def check_configfiles():
-    result = True
-
-    bin_path = os.path.dirname(os.path.abspath(__file__))
-    if bin_path == "/usr/bin":
-        example_dir = "/usr/share/doc/ubuntu-dev-tools/examples"
-    else:
-        example_dir = "%s/examples" % bin_path
-
-    if not os.path.exists("instructions"):
-        os.system("cp %s/massfile.instructions instructions" % example_dir)
-        print >> sys.stderr, \
-            "No 'instructions' file found. Copied template from %s." % \
-            example_dir
-        result = False
-
-    if not os.path.exists("list"):
-        os.system("cp %s/massfile.list list" % example_dir)
-        print >> sys.stderr, \
-            "No 'list' file found. Copied template from %s." % example_dir
-        result = False
-
-    return result
-
-
-def file_bug(config, launchpad):
-    try:
-        summary = config["subject"].replace("$pack", config["sourcepackage"])
-        description = config["text"].replace("$pack", config["sourcepackage"])
-
-        product_url = "%subuntu/+source/%s" % \
-                      (launchpad._root_uri, config["sourcepackage"])
-        tags = [t for t in [t.strip("\n").strip() for t in
-                            config["tags"].split(",")] if t]
-        bug = launchpad.bugs.createBug(description=description, title=summary,
-            target=product_url, tags=tags)
-
-        print "Successfully filed bug %i: %s" % \
-              (bug.id, bug.web_link)
-
-        subscribers = [s for s in [s.strip("\n").strip() for s in
-                                   config["subscribers"].split(",")] if s]
-        for sub in subscribers:
-            subscribe_url = "%s~%s" % (launchpad._root_uri, sub)
-            bug.subscribe(person=subscribe_url)
-
-        #newly created bugreports have one task
-        task = bug.bug_tasks[0]
-
-        if config["status"]:
-            status = config["status"].capitalize()
-        else:
-            status = "Confirmed"
-        task.status = status
-
-        assignee = config["assignee"]
-        if assignee:
-            assignee_url = "%s~%s" % (launchpad._root_uri, assignee)
-            task.assignee = assignee_url
-        task.lp_save()
-    except:
-        print >> sys.stderr, "Bug for '%s' was not filed." % \
-                             config["sourcepackage"]
-
-def read_buglist(url, launchpad):
-    if not url:
-        return set()
-
-    if len(url.split("?", 1)) == 2:
-        # search options not supported, because there is no mapping
-        # web ui options <-> API options
-        print >> sys.stderr, "Options in url are not supported, url: %s" % url
-        sys.exit(1)
-
-    packages = set()
-
-    api_url = translate_web_api(url, launchpad)
-    # workaround LP #303414
-    # if this is fixed it should simply be: buglist = launchpad.load(api_url)
-    api_url = api_url.split("?", 1)[0]
-    project = launchpad.load(api_url)
-    buglist = project.searchTasks()
-
-    for bug in buglist:
-        packages.add(bug.bug_target_name)
-
-    return packages
-
-def main():
-    description = ('Files bugs against multiple packages in Ubuntu. '
-                   'Reads the bug from "instructions" and files them against '
-                   'packages listed in "list". '
-                   "If these files aren't preset they are created.")
-    parser = optparse.OptionParser(description=description)
-    parser.add_option('-l', '--lpinstance', metavar='INSTANCE',
-                      dest='lpinstance', default=None,
-                      help='Launchpad instance to connect to '
-                           '(default: production)')
-    parser.add_option('--no-conf',
-                      dest='no_conf', default=False, action='store_true',
-                      help="Don't read config files or environment variables")
-    options = parser.parse_args()[0]
-    udtconfig = UDTConfig(options.no_conf)
-    if options.lpinstance is None:
-        options.lpinstance = udtconfig.get_value('LPINSTANCE')
-
-    if not check_configfiles():
-        sys.exit(1)
-
-    launchpad = Launchpad.login_with('ubuntu-dev-tools', options.lpinstance)
-    config = read_config()
-    pack_list = read_list()
-    buglist = read_buglist(config["buglist-url"], launchpad)
-
-    for pack in pack_list:
-        if pack not in buglist:
-            config["sourcepackage"] = pack
-            file_bug(config, launchpad)
-
-
-if __name__ == '__main__':
-    main()

merge-changelog

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/python3
 # -*- coding: utf-8 -*-
 # Copyright © 2008 Canonical Ltd.
 # Author: Scott James Remnant <scott at ubuntu.com>.
@@ -18,248 +18,67 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-import re
+# pylint: disable=invalid-name
+# pylint: enable=invalid-name
+
 import sys
 
+from debian.changelog import Changelog
+
+from ubuntutools import getLogger
+
+Logger = getLogger()
+
+
 def usage(exit_code=1):
-    print '''Usage: merge-changelog <left changelog> <right changelog>
+    Logger.info(
+        """Usage: merge-changelog <left changelog> <right changelog>
 
 merge-changelog takes two changelogs that once shared a common source,
 merges them back together, and prints the merged result to stdout.  This
 is useful if you need to manually merge a ubuntu package with a new
 Debian release of the package.
-'''
+"""
+    )
     sys.exit(exit_code)
 
+
 ########################################################################
 # Changelog Management
 ########################################################################
 
-# Regular expression for top of debian/changelog
-CL_RE = re.compile(r'^(\w[-+0-9a-z.]*) \(([^\(\) \t]+)\)((\s+[-0-9a-z]+)+)\;',
-                   re.IGNORECASE)
 
 def merge_changelog(left_changelog, right_changelog):
     """Merge a changelog file."""
 
-    left_cl = read_changelog(left_changelog)
-    right_cl = read_changelog(right_changelog)
+    with open(left_changelog, encoding="utf-8") as f:
+        left_cl = Changelog(f)
+    with open(right_changelog, encoding="utf-8") as f:
+        right_cl = Changelog(f)
 
-    for right_ver, right_text in right_cl:
-        while len(left_cl) and left_cl[0][0] > right_ver:
-            (left_ver, left_text) = left_cl.pop(0)
-            print left_text
+    left_versions = set(left_cl.versions)
+    right_versions = set(right_cl.versions)
+    left_blocks = iter(left_cl)
+    right_blocks = iter(right_cl)
 
-        while len(left_cl) and left_cl[0][0] == right_ver:
-            (left_ver, left_text) = left_cl.pop(0)
+    clist = sorted(left_versions | right_versions, reverse=True)
+    remaining = len(clist)
+    for version in clist:
+        remaining -= 1
+        if version in left_versions:
+            block = next(left_blocks)
+            if version in right_versions:
+                next(right_blocks)
+        else:
+            block = next(right_blocks)
 
-        print right_text
+        assert block.version == version
 
-    for _, left_text in left_cl:
-        print left_text
-
-    return False
-
-def read_changelog(filename):
-    """Return a parsed changelog file."""
-    entries = []
-
-    changelog_file = open(filename)
-    try:
-        (ver, text) = (None, "")
-        for line in changelog_file:
-            match = CL_RE.search(line)
-            if match:
-                try:
-                    ver = Version(match.group(2))
-                except ValueError:
-                    ver = None
-
-                text += line
-            elif line.startswith(" -- "):
-                if ver is None:
-                    ver = Version("0")
-
-                text += line
-                entries.append((ver, text))
-                (ver, text) = (None, "")
-            elif len(line.strip()) or ver is not None:
-                text += line
-    finally:
-        changelog_file.close()
-
-    if len(text):
-        entries.append((ver, text))
-
-    return entries
-
-########################################################################
-# Version parsing code
-########################################################################
-# Regular expressions make validating things easy
-VALID_EPOCH = re.compile(r'^[0-9]+$')
-VALID_UPSTREAM = re.compile(r'^[A-Za-z0-9+:.~-]*$')
-VALID_REVISION = re.compile(r'^[A-Za-z0-9+.~]+$')
-
-# Character comparison table for upstream and revision components
-CMP_TABLE = "~ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz+-.:"
-
-
-class Version(object):
-    """Debian version number.
-
-    This class is designed to be reasonably transparent and allow you
-    to write code like:
-
-    |   s.version >= '1.100-1'
-
-    The comparison will be done according to Debian rules, so '1.2' will
-    compare lower.
-
-    Properties:
-      epoch       Epoch
-      upstream    Upstream version
-      revision    Debian/local revision
-    """
-
-    def __init__(self, ver):
-        """Parse a string or number into the three components."""
-        self.epoch = 0
-        self.upstream = None
-        self.revision = None
-
-        ver = str(ver)
-        if not len(ver):
-            raise ValueError
-
-        # Epoch is component before first colon
-        idx = ver.find(":")
-        if idx != -1:
-            self.epoch = ver[:idx]
-            if not len(self.epoch):
-                raise ValueError
-            if not VALID_EPOCH.search(self.epoch):
-                raise ValueError
-            ver = ver[idx+1:]
-
-        # Revision is component after last hyphen
-        idx = ver.rfind("-")
-        if idx != -1:
-            self.revision = ver[idx+1:]
-            if not len(self.revision):
-                raise ValueError
-            if not VALID_REVISION.search(self.revision):
-                raise ValueError
-            ver = ver[:idx]
-
-        # Remaining component is upstream
-        self.upstream = ver
-        if not len(self.upstream):
-            raise ValueError
-        if not VALID_UPSTREAM.search(self.upstream):
-            raise ValueError
-
-        self.epoch = int(self.epoch)
-
-    def get_without_epoch(self):
-        """Return the version without the epoch."""
-        string = self.upstream
-        if self.revision is not None:
-            string += "-%s" % (self.revision,)
-        return string
-
-    without_epoch = property(get_without_epoch)
-
-    def __str__(self):
-        """Return the class as a string for printing."""
-        string = ""
-        if self.epoch > 0:
-            string += "%d:" % (self.epoch,)
-        string += self.upstream
-        if self.revision is not None:
-            string += "-%s" % (self.revision,)
-        return string
-
-    def __repr__(self):
-        """Return a debugging representation of the object."""
-        return "<%s epoch: %d, upstream: %r, revision: %r>" \
-               % (self.__class__.__name__, self.epoch,
-                  self.upstream, self.revision)
-
-    def __cmp__(self, other):
-        """Compare two Version classes."""
-        other = Version(other)
-
-        result = cmp(self.epoch, other.epoch)
-        if result != 0:
-            return result
-
-        result = deb_cmp(self.upstream, other.upstream)
-        if result != 0:
-            return result
-
-        result = deb_cmp(self.revision or "", other.revision or "")
-        if result != 0:
-            return result
-
-        return 0
-
-
-def strcut(string, idx, accept):
-    """Cut characters from string that are entirely in accept."""
-    ret = ""
-    while idx < len(string) and string[idx] in accept:
-        ret += string[idx]
-        idx += 1
-
-    return (ret, idx)
-
-def deb_order(string, idx):
-    """Return the comparison order of two characters."""
-    if idx >= len(string):
-        return 0
-    elif string[idx] == "~":
-        return -1
-    else:
-        return CMP_TABLE.index(string[idx])
-
-def deb_cmp_str(x, y):
-    """Compare two strings in a deb version."""
-    idx = 0
-    while (idx < len(x)) or (idx < len(y)):
-        result = deb_order(x, idx) - deb_order(y, idx)
-        if result < 0:
-            return -1
-        elif result > 0:
-            return 1
-
-        idx += 1
-
-    return 0
-
-def deb_cmp(x, y):
-    """Implement the string comparison outlined by Debian policy."""
-    x_idx = y_idx = 0
-    while x_idx < len(x) or y_idx < len(y):
-        # Compare strings
-        (x_str, x_idx) = strcut(x, x_idx, CMP_TABLE)
-        (y_str, y_idx) = strcut(y, y_idx, CMP_TABLE)
-        result = deb_cmp_str(x_str, y_str)
-        if result != 0:
-            return result
-
-        # Compare numbers
-        (x_str, x_idx) = strcut(x, x_idx, "0123456789")
-        (y_str, y_idx) = strcut(y, y_idx, "0123456789")
-        result = cmp(int(x_str or "0"), int(y_str or "0"))
-        if result != 0:
-            return result
-
-    return 0
+        Logger.info("%s%s", str(block).strip(), "\n" if remaining else "")
 
 
 def main():
-    if len(sys.argv) > 1 and sys.argv[1] in ('-h', '--help'):
+    if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
         usage(0)
     if len(sys.argv) != 3:
         usage(1)
@@ -270,5 +89,6 @@ def main():
     merge_changelog(left_changelog, right_changelog)
     sys.exit(0)
 
-if __name__ == '__main__':
+
+if __name__ == "__main__":
     main()