zeroinstall/__init__.py

   1 """
   2 The Python implementation of the Zero Install injector is divided into four sub-packages:
   3
   4  - L{zeroinstall.injector} contains most of the interesting stuff for managing feeds, keys and downloads and for selecting versions
   5  - L{zeroinstall.zerostore} contains low-level code for handling the implementation cache (where unpacked packages are stored)
   6  - L{zeroinstall.gtkui} contains code for making GTK user-interfaces
   7  - L{zeroinstall.support} contains helper code (not really specific to Zero Install)
   8
   9 @copyright: (C) 2009, Thomas Leonard
  10 @see: U{http://0install.net}
  11
  12 @var _: a function for translating strings using the zero-install domain (for use internally by Zero Install)
  13 """
  14
  15 version = '0.42.1'
  16
  17 import gettext
  18
  19 translation = gettext.translation('zero-install', fallback = True)
  20 _ = translation.ugettext
  21
  22 class SafeException(Exception):
  23         """An exception that can be reported to the user without a stack trace.
  24         The command-line interface's C{--verbose} option will display the full stack trace."""
  25
  26 class NeedDownload(SafeException):
  27         """Thrown by L{injector.autopolicy.AutoPolicy} if we tried to start a download
  28         and downloading is disabled."""
  29         def __init__(self, url):
  30                 Exception.__init__(self, _("Would download '%s'") % url)