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 sys
  37 import traceback
  38 import daklib.utils
  39
  40 from daklib.daklog import Logger
  41 from daklib.config import Config
  42 from daklib.dak_exceptions import CantOpenError
  43
  44 ################################################################################
  45
  46 def init():
  47     """Setup the list of modules and brief explanation of what they
  48     do."""
  49
  50     functionality = [
  51         ("ls",
  52          "Show which suites packages are in"),
  53         ("override",
  54          "Query/change the overrides"),
  55         ("check-archive",
  56          "Archive sanity checks"),
  57         ("queue-report",
  58          "Produce a report on NEW and BYHAND packages"),
  59         ("show-new",
  60          "Output html for packages in NEW"),
  61         ("show-deferred",
  62          "Output html and symlinks for packages in DEFERRED"),
  63
  64         ("rm",
  65          "Remove packages from suites"),
  66
  67         ("process-new",
  68          "Process NEW and BYHAND packages"),
  69         ("process-unchecked",
  70          "Process packages in queue/unchecked"),
  71         ("process-accepted",
  72          "Install packages into the pool"),
  73
  74         ("make-suite-file-list",
  75          "Generate lists of packages per suite for apt-ftparchive"),
  76         ("make-pkg-file-mapping",
  77          "Generate package <-> file mapping"),
  78         ("generate-releases",
  79          "Generate Release files"),
  80         ("contents",
  81          "Generate content files"),
  82         ("generate-index-diffs",
  83          "Generate .diff/Index files"),
  84         ("clean-suites",
  85          "Clean unused/superseded packages from the archive"),
  86         ("clean-queues",
  87          "Clean cruft from incoming"),
  88         ("clean-proposed-updates",
  89          "Remove obsolete .changes from proposed-updates"),
  90
  91         ("transitions",
  92          "Manage the release transition file"),
  93         ("check-overrides",
  94          "Override cruft checks"),
  95         ("check-proposed-updates",
  96          "Dependency checking for proposed-updates"),
  97         ("control-overrides",
  98          "Manipulate/list override entries in bulk"),
  99         ("control-suite",
 100          "Manipulate suites in bulk"),
 101         ("cruft-report",
 102          "Check for obsolete or duplicated packages"),
 103         ("decode-dot-dak",
 104          "Display contents of a .dak file"),
 105         ("examine-package",
 106          "Show information useful for NEW processing"),
 107         ("find-null-maintainers",
 108          "Check for users with no packages in the archive"),
 109         ("import-keyring",
 110          "Populate fingerprint/uid table based on a new/updated keyring"),
 111         ("import-ldap-fingerprints",
 112          "Syncs fingerprint and uid tables with Debian LDAP db"),
 113         ("import-users-from-passwd",
 114          "Sync PostgreSQL users with passwd file"),
 115         ("admin",
 116          "Perform administration on the dak database"),
 117         ("init-db",
 118          "Update the database to match the conf file"),
 119         ("update-db",
 120          "Updates databae schema to latest revision"),
 121         ("init-dirs",
 122          "Initial setup of the archive"),
 123         ("make-maintainers",
 124          "Generates Maintainers file for BTS etc"),
 125         ("make-overrides",
 126          "Generates override files"),
 127         ("poolize",
 128          "Move packages from dists/ to pool/"),
 129         ("new-security-install",
 130          "New way to install a security upload into the archive"),
 131         ("split-done",
 132          "Split queue/done into a date-based hierarchy"),
 133         ("stats",
 134          "Generate statistics"),
 135         ("bts-categorize",
 136          "Categorize uncategorized bugs filed against ftp.debian.org"),
 137         ("add-user",
 138          "Add a user to the archive"),
 139         ]
 140     return functionality
 141
 142 ################################################################################
 143
 144 def usage(functionality, exit_code=0):
 145     """Print a usage message and exit with 'exit_code'."""
 146
 147     print """Usage: dak COMMAND [...]
 148 Run DAK commands.  (Will also work if invoked as COMMAND.)
 149
 150 Available commands:"""
 151     for (command, description) in functionality:
 152         print "  %-23s %s" % (command, description)
 153     sys.exit(exit_code)
 154
 155 ################################################################################
 156
 157 def main():
 158     """Launch dak functionality."""
 159
 160
 161     try:
 162         logger = Logger(Config(), 'dak top-level', print_starting=False)
 163     except CantOpenError:
 164         logger = None
 165
 166     functionality = init()
 167     modules = [ command for (command, _) in functionality ]
 168
 169     if len(sys.argv) == 0:
 170         daklib.utils.fubar("err, argc == 0? how is that possible?")
 171     elif (len(sys.argv) == 1
 172           or (len(sys.argv) == 2 and
 173               (sys.argv[1] == "--help" or sys.argv[1] == "-h"))):
 174         usage(functionality)
 175
 176     # First see if we were invoked with/as the name of a module
 177     cmdname = sys.argv[0]
 178     cmdname = cmdname[cmdname.rfind("/")+1:]
 179     if cmdname in modules:
 180         pass
 181     # Otherwise the argument is the module
 182     else:
 183         cmdname = sys.argv[1]
 184         sys.argv = [sys.argv[0] + " " + sys.argv[1]] + sys.argv[2:]
 185         if cmdname not in modules:
 186             match = []
 187             for name in modules:
 188                 if name.startswith(cmdname):
 189                     match.append(name)
 190             if len(match) == 1:
 191                 cmdname = match[0]
 192             elif len(match) > 1:
 193                 daklib.utils.warn("ambiguous command '%s' - could be %s" \
 194                            % (cmdname, ", ".join(match)))
 195                 usage(functionality, 1)
 196             else:
 197                 daklib.utils.warn("unknown command '%s'" % (cmdname))
 198                 usage(functionality, 1)
 199
 200     # Invoke the module
 201     module = __import__(cmdname.replace("-","_"))
 202
 203     try:
 204         module.main()
 205     except KeyboardInterrupt:
 206         msg = 'KeyboardInterrupt caught; exiting'
 207         print msg
 208         if logger:
 209             logger.log([msg])
 210         sys.exit(1)
 211     except SystemExit:
 212         pass
 213     except:
 214         if logger:
 215             for line in traceback.format_exc().split('\n')[:-1]:
 216                 logger.log(['exception', line])
 217         raise
 218
 219 ################################################################################
 220
 221 if __name__ == "__main__":
 222     main()