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         ("graph",
  65          "Output graphs of number of packages in various queues"),
  66
  67         ("rm",
  68          "Remove packages from suites"),
  69
  70         ("process-new",
  71          "Process NEW and BYHAND packages"),
  72         ("process-upload",
  73          "Process packages in queue/unchecked"),
  74         ("process-commands",
  75          "Process command files (*.dak-commands)"),
  76         ("process-policy",
  77          "Process packages in policy queues from COMMENTS files"),
  78
  79         ("dominate",
  80          "Remove obsolete source and binary associations from suites"),
  81         ("export",
  82          "Export uploads from policy queues"),
  83         ("export-suite",
  84          "export a suite to a flat directory structure"),
  85         ("make-pkg-file-mapping",
  86          "Generate package <-> file mapping"),
  87         ("generate-releases",
  88          "Generate Release files"),
  89         ("generate-packages-sources2",
  90          "Generate Packages/Sources files"),
  91         ("contents",
  92          "Generate content files"),
  93         ("metadata",
  94          "Load data for packages/sources files"),
  95         ("generate-index-diffs",
  96          "Generate .diff/Index files"),
  97         ("clean-suites",
  98          "Clean unused/superseded packages from the archive"),
  99         ("manage-build-queues",
 100          "Clean and update metadata for build queues"),
 101         ("clean-queues",
 102          "Clean cruft from incoming"),
 103
 104         ("transitions",
 105          "Manage the release transition file"),
 106         ("check-overrides",
 107          "Override cruft checks"),
 108         ("control-overrides",
 109          "Manipulate/list override entries in bulk"),
 110         ("control-suite",
 111          "Manipulate suites in bulk"),
 112         ("update-suite",
 113          "Update suite with packages from a different suite"),
 114         ("cruft-report",
 115          "Check for obsolete or duplicated packages"),
 116         ("examine-package",
 117          "Show information useful for NEW processing"),
 118         ("import",
 119          "Import existing source and binary packages"),
 120         ("import-keyring",
 121          "Populate fingerprint/uid table based on a new/updated keyring"),
 122         ("import-users-from-passwd",
 123          "Sync PostgreSQL users with passwd file"),
 124         ("acl",
 125          "Manage upload ACLs"),
 126         ("admin",
 127          "Perform administration on the dak database"),
 128         ("update-db",
 129          "Updates databae schema to latest revision"),
 130         ("init-dirs",
 131          "Initial setup of the archive"),
 132         ("make-maintainers",
 133          "Generates Maintainers file for BTS etc"),
 134         ("make-overrides",
 135          "Generates override files"),
 136         ("new-security-install",
 137          "New way to install a security upload into the archive"),
 138         ("stats",
 139          "Generate statistics"),
 140         ("bts-categorize",
 141          "Categorize uncategorized bugs filed against ftp.debian.org"),
 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         ("external-overrides",
 151          "Modify external overrides"),
 152         ]
 153     return functionality
 154
 155 ################################################################################
 156
 157 def usage(functionality, exit_code=0):
 158     """Print a usage message and exit with 'exit_code'."""
 159
 160     print """Usage: dak COMMAND [...]
 161 Run DAK commands.  (Will also work if invoked as COMMAND.)
 162
 163 Available commands:"""
 164     for (command, description) in functionality:
 165         print "  %-23s %s" % (command, description)
 166     sys.exit(exit_code)
 167
 168 ################################################################################
 169
 170 def main():
 171     """Launch dak functionality."""
 172
 173
 174     try:
 175         logger = Logger('dak top-level', print_starting=False)
 176     except CantOpenError:
 177         logger = None
 178
 179     functionality = init()
 180     modules = [ command for (command, _) in functionality ]
 181
 182     if len(sys.argv) == 0:
 183         daklib.utils.fubar("err, argc == 0? how is that possible?")
 184     elif (len(sys.argv) == 1
 185           or (len(sys.argv) == 2 and
 186               (sys.argv[1] == "--help" or sys.argv[1] == "-h"))):
 187         usage(functionality)
 188
 189     # First see if we were invoked with/as the name of a module
 190     cmdname = sys.argv[0]
 191     cmdname = cmdname[cmdname.rfind("/")+1:]
 192     if cmdname in modules:
 193         pass
 194     # Otherwise the argument is the module
 195     else:
 196         cmdname = sys.argv[1]
 197         sys.argv = [sys.argv[0] + " " + sys.argv[1]] + sys.argv[2:]
 198         if cmdname not in modules:
 199             match = []
 200             for name in modules:
 201                 if name.startswith(cmdname):
 202                     match.append(name)
 203             if len(match) == 1:
 204                 cmdname = match[0]
 205             elif len(match) > 1:
 206                 daklib.utils.warn("ambiguous command '%s' - could be %s" \
 207                            % (cmdname, ", ".join(match)))
 208                 usage(functionality, 1)
 209             else:
 210                 daklib.utils.warn("unknown command '%s'" % (cmdname))
 211                 usage(functionality, 1)
 212
 213     # Invoke the module
 214     module = __import__(cmdname.replace("-","_"))
 215
 216     try:
 217         module.main()
 218     except KeyboardInterrupt:
 219         msg = 'KeyboardInterrupt caught; exiting'
 220         print msg
 221         if logger:
 222             logger.log([msg])
 223         sys.exit(1)
 224     except SystemExit:
 225         pass
 226     except:
 227         if logger:
 228             for line in traceback.format_exc().split('\n')[:-1]:
 229                 logger.log(['exception', line])
 230         raise
 231
 232 ################################################################################
 233
 234 if __name__ == "__main__":
 235     os.environ['LANG'] = 'C'
 236     os.environ['LC_ALL'] = 'C'
 237     main()