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         ("auto-decruft",
 117          "Clean cruft without reverse dependencies automatically"),
 118         ("examine-package",
 119          "Show information useful for NEW processing"),
 120         ("import",
 121          "Import existing source and binary packages"),
 122         ("import-keyring",
 123          "Populate fingerprint/uid table based on a new/updated keyring"),
 124         ("import-users-from-passwd",
 125          "Sync PostgreSQL users with passwd file"),
 126         ("acl",
 127          "Manage upload ACLs"),
 128         ("admin",
 129          "Perform administration on the dak database"),
 130         ("update-db",
 131          "Updates databae schema to latest revision"),
 132         ("init-dirs",
 133          "Initial setup of the archive"),
 134         ("make-maintainers",
 135          "Generates Maintainers file for BTS etc"),
 136         ("make-overrides",
 137          "Generates override files"),
 138         ("new-security-install",
 139          "New way to install a security upload into the archive"),
 140         ("stats",
 141          "Generate statistics"),
 142         ("bts-categorize",
 143          "Categorize uncategorized bugs filed against ftp.debian.org"),
 144         ("add-user",
 145          "Add a user to the archive"),
 146         ("make-changelog",
 147          "Generate changelog between two suites"),
 148         ("copy-installer",
 149          "Copies the installer from one suite to another"),
 150         ("override-disparity",
 151          "Generate a list of override disparities"),
 152         ("external-overrides",
 153          "Modify external overrides"),
 154         ]
 155     return functionality
 156
 157 ################################################################################
 158
 159 def usage(functionality, exit_code=0):
 160     """Print a usage message and exit with 'exit_code'."""
 161
 162     print """Usage: dak COMMAND [...]
 163 Run DAK commands.  (Will also work if invoked as COMMAND.)
 164
 165 Available commands:"""
 166     for (command, description) in functionality:
 167         print "  %-23s %s" % (command, description)
 168     sys.exit(exit_code)
 169
 170 ################################################################################
 171
 172 def main():
 173     """Launch dak functionality."""
 174
 175
 176     try:
 177         logger = Logger('dak top-level', print_starting=False)
 178     except CantOpenError:
 179         logger = None
 180
 181     functionality = init()
 182     modules = [ command for (command, _) in functionality ]
 183
 184     if len(sys.argv) == 0:
 185         daklib.utils.fubar("err, argc == 0? how is that possible?")
 186     elif (len(sys.argv) == 1
 187           or (len(sys.argv) == 2 and
 188               (sys.argv[1] == "--help" or sys.argv[1] == "-h"))):
 189         usage(functionality)
 190
 191     # First see if we were invoked with/as the name of a module
 192     cmdname = sys.argv[0]
 193     cmdname = cmdname[cmdname.rfind("/")+1:]
 194     if cmdname in modules:
 195         pass
 196     # Otherwise the argument is the module
 197     else:
 198         cmdname = sys.argv[1]
 199         sys.argv = [sys.argv[0] + " " + sys.argv[1]] + sys.argv[2:]
 200         if cmdname not in modules:
 201             match = []
 202             for name in modules:
 203                 if name.startswith(cmdname):
 204                     match.append(name)
 205             if len(match) == 1:
 206                 cmdname = match[0]
 207             elif len(match) > 1:
 208                 daklib.utils.warn("ambiguous command '%s' - could be %s" \
 209                            % (cmdname, ", ".join(match)))
 210                 usage(functionality, 1)
 211             else:
 212                 daklib.utils.warn("unknown command '%s'" % (cmdname))
 213                 usage(functionality, 1)
 214
 215     # Invoke the module
 216     module = __import__(cmdname.replace("-","_"))
 217
 218     try:
 219         module.main()
 220     except KeyboardInterrupt:
 221         msg = 'KeyboardInterrupt caught; exiting'
 222         print msg
 223         if logger:
 224             logger.log([msg])
 225         sys.exit(1)
 226     except SystemExit:
 227         pass
 228     except:
 229         if logger:
 230             for line in traceback.format_exc().split('\n')[:-1]:
 231                 logger.log(['exception', line])
 232         raise
 233
 234 ################################################################################
 235
 236 if __name__ == "__main__":
 237     os.environ['LANG'] = 'C'
 238     os.environ['LC_ALL'] = 'C'
 239     main()