#!/usr/bin/python3
# pull-debian-debdiff - find and download a specific version of a Debian
#                       package and its immediate parent to generate a debdiff.
#
# Copyright (C) 2010-2011, Stefano Rivera <stefanor@ubuntu.com>
# Inspired by a tool of the same name by Kees Cook.
#
# 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.

# pylint: disable=invalid-name
# pylint: enable=invalid-name

import optparse
import sys

import debian.changelog

from ubuntutools import getLogger
from ubuntutools.archive import DebianSourcePackage, DownloadError
from ubuntutools.config import UDTConfig
from ubuntutools.version import Version

Logger = getLogger()


def previous_version(package, version, distance):
    "Given an (extracted) package, determine the version distance versions ago"
    upver = Version(version).upstream_version
    filename = "%s-%s/debian/changelog" % (package, upver)
    changelog_file = open(filename, "r")
    changelog = debian.changelog.Changelog(changelog_file.read())
    changelog_file.close()
    seen = 0
    for entry in changelog:
        if entry.distributions == "UNRELEASED":
            continue
        if seen == distance:
            return entry.version.full_version
        seen += 1
    return False


def main():
    parser = optparse.OptionParser("%prog [options] <package> <version> [distance]")
    parser.add_option(
        "-f",
        "--fetch",
        dest="fetch_only",
        default=False,
        action="store_true",
        help="Only fetch the source packages, don't diff.",
    )
    parser.add_option(
        "-d",
        "--debian-mirror",
        metavar="DEBIAN_MIRROR",
        dest="debian_mirror",
        help="Preferred Debian mirror (default: http://deb.debian.org/debian)",
    )
    parser.add_option(
        "-s",
        "--debsec-mirror",
        metavar="DEBSEC_MIRROR",
        dest="debsec_mirror",
        help="Preferred Debian Security mirror (default: http://security.debian.org)",
    )
    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) < 2:
        parser.error("Must specify package and version")
    elif len(args) > 3:
        parser.error("Too many arguments")
    package = args[0]
    version = args[1]
    distance = int(args[2]) if len(args) > 2 else 1

    config = UDTConfig(opts.no_conf)
    if opts.debian_mirror is None:
        opts.debian_mirror = config.get_value("DEBIAN_MIRROR")
    if opts.debsec_mirror is None:
        opts.debsec_mirror = config.get_value("DEBSEC_MIRROR")
    mirrors = [opts.debsec_mirror, opts.debian_mirror]

    Logger.info("Downloading %s %s", package, version)

    newpkg = DebianSourcePackage(package, version, mirrors=mirrors)
    try:
        newpkg.pull()
    except DownloadError as e:
        Logger.error("Failed to download: %s", str(e))
        sys.exit(1)
    newpkg.unpack()

    if opts.fetch_only:
        sys.exit(0)

    oldversion = previous_version(package, version, distance)
    if not oldversion:
        Logger.error("No previous version could be found")
        sys.exit(1)
    Logger.info("Downloading %s %s", package, oldversion)

    oldpkg = DebianSourcePackage(package, oldversion, mirrors=mirrors)
    try:
        oldpkg.pull()
    except DownloadError as e:
        Logger.error("Failed to download: %s", str(e))
        sys.exit(1)
    Logger.info("file://" + oldpkg.debdiff(newpkg, diffstat=True))


if __name__ == "__main__":
    try:
        main()
    except KeyboardInterrupt:
        Logger.info("User abort.")