dak/dak.py

   1 #!/usr/bin/env python
   2
   3 """
   4 Wrapper to launch dak functionality
   5
   6 G{importgraph}
   7
   8 """
   9 # Copyright (C) 2005, 2006 Anthony Towns <ajt@debian.org>
  10 # Copyright (C) 2006 James Troup <james@nocrew.org>
  11
  12 # This program is free software; you can redistribute it and/or modify
  13 # it under the terms of the GNU General Public License as published by
  14 # the Free Software Foundation; either version 2 of the License, or
  15 # (at your option) any later version.
  16
  17 # This program is distributed in the hope that it will be useful,
  18 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 # GNU General Public License for more details.
  21
  22 # You should have received a copy of the GNU General Public License
  23 # along with this program; if not, write to the Free Software
  24 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  25
  26 ################################################################################
  27
  28 # well I don't know where you're from but in AMERICA, there's a little
  29 # thing called "abstinent until proven guilty."
  30 #  -- http://harrietmiers.blogspot.com/2005/10/wow-i-feel-loved.html
  31
  32 # (if James had a blog, I bet I could find a funny quote in it to use!)
  33
  34 ################################################################################
  35
  36 import os
  37 import sys
  38 import traceback
  39 import daklib.utils
  40
  41 from daklib.daklog import Logger
  42 from daklib.config import Config
  43 from daklib.dak_exceptions import CantOpenError
  44
  45 ################################################################################
  46
  47 def init():
  48     """Setup the list of modules and brief explanation of what they
  49     do."""
  50
  51     functionality = [
  52         ("ls",
  53          "Show which suites packages are in"),
  54         ("override",
  55          "Query/change the overrides"),
  56         ("check-archive",
  57          "Archive sanity checks"),
  58         ("queue-report",
  59          "Produce a report on NEW and BYHAND packages"),
  60         ("show-new",
  61          "Output html for packages in NEW"),
  62         ("show-deferred",
  63          "Output html and symlinks for packages in DEFERRED"),
  64
  65         ("rm",
  66          "Remove packages from suites"),
  67
  68         ("process-new",
  69          "Process NEW and BYHAND packages"),
  70         ("process-upload",
  71          "Process packages in queue/unchecked"),
  72         ("process-policy",
  73          "Process packages in policy queues from COMMENTS files"),
  74
  75         ("dominate",
  76          "Remove obsolete source and binary associations from suites"),
  77         ("make-pkg-file-mapping",
  78          "Generate package <-> file mapping"),
  79         ("generate-filelist",
  80          "Generate file lists for apt-ftparchive"),
  81         ("generate-releases",
  82          "Generate Release files"),
  83         ("generate-packages-sources",
  84          "Generate Packages/Sources files"),
  85         ("contents",
  86          "Generate content files"),
  87         ("generate-index-diffs",
  88          "Generate .diff/Index files"),
  89         ("clean-suites",
  90          "Clean unused/superseded packages from the archive"),
  91         ("manage-build-queues",
  92          "Clean and update metadata for build queues"),
  93         ("clean-queues",
  94          "Clean cruft from incoming"),
  95         ("clean-proposed-updates",
  96          "Remove obsolete .changes from proposed-updates"),
  97
  98         ("transitions",
  99          "Manage the release transition file"),
 100         ("check-overrides",
 101          "Override cruft checks"),
 102         ("check-proposed-updates",
 103          "Dependency checking for proposed-updates"),
 104         ("control-overrides",
 105          "Manipulate/list override entries in bulk"),
 106         ("control-suite",
 107          "Manipulate suites in bulk"),
 108         ("cruft-report",
 109          "Check for obsolete or duplicated packages"),
 110         ("examine-package",
 111          "Show information useful for NEW processing"),
 112         ("find-null-maintainers",
 113          "Check for users with no packages in the archive"),
 114         ("import-keyring",
 115          "Populate fingerprint/uid table based on a new/updated keyring"),
 116         ("import-ldap-fingerprints",
 117          "Syncs fingerprint and uid tables with Debian LDAP db"),
 118         ("import-users-from-passwd",
 119          "Sync PostgreSQL users with passwd file"),
 120         ("admin",
 121          "Perform administration on the dak database"),
 122         ("update-db",
 123          "Updates databae schema to latest revision"),
 124         ("init-dirs",
 125          "Initial setup of the archive"),
 126         ("make-maintainers",
 127          "Generates Maintainers file for BTS etc"),
 128         ("make-overrides",
 129          "Generates override files"),
 130         ("poolize",
 131          "Move packages from dists/ to pool/"),
 132         ("new-security-install",
 133          "New way to install a security upload into the archive"),
 134         ("split-done",
 135          "Split queue/done into a date-based hierarchy"),
 136         ("stats",
 137          "Generate statistics"),
 138         ("bts-categorize",
 139          "Categorize uncategorized bugs filed against ftp.debian.org"),
 140         ("import-known-changes",
 141          "import old changes files into known_changes table"),
 142         ("add-user",
 143          "Add a user to the archive"),
 144         ("make-changelog",
 145          "Generate changelog between two suites"),
 146         ("copy-installer",
 147          "Copies the installer from one suite to another"),
 148         ("override-disparity",
 149          "Generate a list of override disparities"),
 150         ]
 151     return functionality
 152
 153 ################################################################################
 154
 155 def usage(functionality, exit_code=0):
 156     """Print a usage message and exit with 'exit_code'."""
 157
 158     print """Usage: dak COMMAND [...]
 159 Run DAK commands.  (Will also work if invoked as COMMAND.)
 160
 161 Available commands:"""
 162     for (command, description) in functionality:
 163         print "  %-23s %s" % (command, description)
 164     sys.exit(exit_code)
 165
 166 ################################################################################
 167
 168 def main():
 169     """Launch dak functionality."""
 170
 171
 172     try:
 173         logger = Logger(Config(), 'dak top-level', print_starting=False)
 174     except CantOpenError:
 175         logger = None
 176
 177     functionality = init()
 178     modules = [ command for (command, _) in functionality ]
 179
 180     if len(sys.argv) == 0:
 181         daklib.utils.fubar("err, argc == 0? how is that possible?")
 182     elif (len(sys.argv) == 1
 183           or (len(sys.argv) == 2 and
 184               (sys.argv[1] == "--help" or sys.argv[1] == "-h"))):
 185         usage(functionality)
 186
 187     # First see if we were invoked with/as the name of a module
 188     cmdname = sys.argv[0]
 189     cmdname = cmdname[cmdname.rfind("/")+1:]
 190     if cmdname in modules:
 191         pass
 192     # Otherwise the argument is the module
 193     else:
 194         cmdname = sys.argv[1]
 195         sys.argv = [sys.argv[0] + " " + sys.argv[1]] + sys.argv[2:]
 196         if cmdname not in modules:
 197             match = []
 198             for name in modules:
 199                 if name.startswith(cmdname):
 200                     match.append(name)
 201             if len(match) == 1:
 202                 cmdname = match[0]
 203             elif len(match) > 1:
 204                 daklib.utils.warn("ambiguous command '%s' - could be %s" \
 205                            % (cmdname, ", ".join(match)))
 206                 usage(functionality, 1)
 207             else:
 208                 daklib.utils.warn("unknown command '%s'" % (cmdname))
 209                 usage(functionality, 1)
 210
 211     # Invoke the module
 212     module = __import__(cmdname.replace("-","_"))
 213
 214     try:
 215         module.main()
 216     except KeyboardInterrupt:
 217         msg = 'KeyboardInterrupt caught; exiting'
 218         print msg
 219         if logger:
 220             logger.log([msg])
 221         sys.exit(1)
 222     except SystemExit:
 223         pass
 224     except:
 225         if logger:
 226             for line in traceback.format_exc().split('\n')[:-1]:
 227                 logger.log(['exception', line])
 228         raise
 229
 230 ################################################################################
 231
 232 if __name__ == "__main__":
 233     os.environ['LANG'] = 'C'
 234     os.environ['LC_ALL'] = 'C'
 235     main()