#vim:set fileencoding=utf-8: # # apt-listchanges - Show changelog entries between the installed versions # of a set of packages and the versions contained in # corresponding .deb files # # Copyright (C) 2000-2006 Matt Zimmerman # Copyright (C) 2006 Pierre Habouzit # # 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., 59 Temple Place, Suite 330, Boston, # MA 02111-1307 USA # import re import sys, os, os.path import tempfile import gzip import errno import glob import shutil import signal import subprocess import apt_pkg from ALChacks import * # TODO: # indexed lookups by package at least, maybe by arbitrary field def numeric_urgency(u): urgency_map = { 'low' : 1, 'medium' : 2, 'high' : 3, 'emergency' : 4, 'critical' : 4 } return urgency_map.get(u.lower(), 5) class ControlStanza: source_version_re = re.compile('^\S+ \((?P.*)\).*') def __init__(self, str): field = None for line in str.split('\n'): if not line: break if line[0] in (' ', '\t'): if field: setattr(self, field, getattr(self, field) + '\n' + line) else: field, value = line.split(':', 1) setattr(self, field, value.lstrip()) def source(self): return getattr(self, 'Source', self.Package).split(' ')[0] def installed(self): return hasattr(self, 'Status') and self.Status.split(' ')[2] == 'installed' def version(self): """ This function returns the version of the package. One would like it to be the "binary" version, though we have the tough case of source package whose binary packages versioning scheme is different from the source one (see OOo, linux-source, ...). This code does the following, if the Source field is set with a specified version, then we use the binary version if and only if the source version is a prefix. We must do that because of binNMUs. """ v = self.Version if hasattr(self, 'Source'): match = self.source_version_re.match(self.Source) if match: sv = match.group('version') if not v.startswith(sv): return sv return v class ControlParser: def __init__(self): self.stanzas = [] self.index = {} def makeindex(self, field): self.index[field] = {} for stanza in self.stanzas: self.index[field][getattr(stanza, field)] = stanza def readfile(self, file): self.stanzas += [ControlStanza(x) for x in open(file, 'r').read().split('\n\n') if x] def readdeb(self, deb): fh = os.popen('dpkg-deb -f %s' % deb) self.stanzas.append(ControlStanza(fh.read())) def find(self, field, value): if self.index.has_key(field): if self.index[field].has_key(value): return self.index[field][value] else: return None else: for stanza in self.stanzas: if hasattr(stanza, field) and getattr(stanza, field) == value: return stanza return None class Package: changelog_header = re.compile('^\S+ \((?P.*)\) .*;.*urgency=(?P\w+).*') def __init__(self, path): self.path = path parser = ControlParser() parser.readdeb(self.path) pkgdata = parser.stanzas[0] self.binary = pkgdata.Package self.source = pkgdata.source() self.Version = pkgdata.version() self.arch = pkgdata.Architecture def extract_changes(self, which, since_version=None, reverse=None): '''Extract changelog entries, news or both from the package. If since_version is specified, only return entries later than the specified version. returns a sequence of Changes objects.''' news_filenames = self._changelog_variations('NEWS.Debian') changelog_filenames = self._changelog_variations('changelog.Debian') changelog_filenames_binnmu = self._changelog_variations('changelog.Debian.' + self.arch) changelog_filenames_native = self._changelog_variations('changelog') filenames = [] if which == 'both' or which == 'news': filenames.extend(news_filenames) if which == 'both' or which == 'changelogs': filenames.extend(changelog_filenames) filenames.extend(changelog_filenames_binnmu) filenames.extend(changelog_filenames_native) tempdir = self.extract_contents(filenames) find_first = lambda acc, fname: acc or self.read_changelog(os.path.join(tempdir, fname), since_version, reverse) news = reduce(find_first, news_filenames, None) changelog = reduce(find_first, changelog_filenames + changelog_filenames_native, None) binnmu = reduce(find_first, changelog_filenames_binnmu, None) shutil.rmtree(tempdir, 1) return (news, changelog, binnmu) def extract_contents(self, filenames): tempdir = tempfile.mkdtemp(prefix='apt-listchanges') extract_command = 'dpkg-deb --fsys-tarfile %s | tar xf - --wildcards -C %s %s 2>/dev/null' % ( self.path, tempdir, ' '.join(["'" + x + "'" for x in filenames]) ) # tar exits unsuccessfully if _any_ of the files we wanted # were not available, so we can't do much with its status status = os.system(extract_command) if os.WIFSIGNALED(status) and os.WTERMSIG(status) == signal.SIGINT: shutil.rmtree(tempdir, 1) raise KeyboardInterrupt return tempdir def read_changelog(self, filename, since_version, reverse=False): filenames = glob.glob(filename) fd = None for filename in filenames: try: if os.path.isdir(filename): print >> sys.stderr, _("Ignoring `%s' (seems to be a directory!)") % filename elif filename.endswith('.gz'): fd = gzip.GzipFile(filename) else: fd = open(filename) break except IOError, e: if e.errno == errno.ENOENT: pass else: raise if not fd: return None urgency = numeric_urgency('low') entry = '' entries = [] is_debian_changelog = 0 for line in fd.readlines(): match = self.changelog_header.match(line) if match: entries += [entry] entry = '' is_debian_changelog = 1 if since_version: if apt_pkg.version_compare(match.group('version'), since_version) > 0: urgency = max(numeric_urgency(match.group('urgency')), urgency) else: break entry += line if not is_debian_changelog: return None if entry != '': entries += [entry] if reverse: entries.reverse() changes = "".join(entries) if changes and not changes.endswith('\n\n'): changes += '\n' return Changes(self.source, changes, urgency) def _changelog_variations(self, filename): formats = ['usr/doc/*/%s.gz', 'usr/share/doc/*/%s.gz', 'usr/doc/*/%s', 'usr/share/doc/*/%s', './usr/doc/*/%s.gz', './usr/share/doc/*/%s.gz', './usr/doc/*/%s', './usr/share/doc/*/%s'] return [x % filename for x in formats] class Changes: def __init__(self, package, changes, urgency): self.package = package self.changes = changes self.urgency = urgency __all__ = [ 'ControlParser', 'Package' ]