926N/A

565N/A

2026N/Aimport errno

1050N/Aimport os

2524N/Aimport xml.parsers.expat as expat

926N/Aimport urlparse

926N/A

2339N/Aimport pkg.client.pkgdefs as pkgdefs

2339N/A

926N/AEmptyI = tuple()

838N/A

565N/Aclass ApiException(Exception):

2034N/A def __init__(self, *args):

2034N/A Exception.__init__(self)

2034N/A self.__verbose_info = []

1540N/A

1540N/A def __unicode__(self):

1540N/A # To workaround python issues 6108 and 2517, this provides a

1540N/A # a standard wrapper for this class' exceptions so that they

1540N/A # have a chance of being stringified correctly.

1968N/A return unicode(str(self))

1540N/A

2034N/A def add_verbose_info(self, info):

2034N/A self.__verbose_info.extend(info)

2200N/A

2034N/A @property

2034N/A def verbose_info(self):

2034N/A return self.__verbose_info

565N/A

2339N/Aclass SuidUnsupportedError(ApiException):

2339N/A def __str__(self):

2339N/A return _("""

2339N/AThe pkg client api module can not be invoked from an setuid executable.""")

2339N/A

2339N/A

2524N/Aclass HistoryException(ApiException):

2524N/A """Private base exception class for all History exceptions."""

2524N/A

2524N/A def __init__(self, *args):

2524N/A Exception.__init__(self, *args)

2524N/A self.error = args[0]

2524N/A

2524N/A def __str__(self):

2524N/A return str(self.error)

2524N/A

2524N/A

2524N/Aclass HistoryLoadException(HistoryException):

2524N/A """Used to indicate that an unexpected error occurred while loading

2524N/A def __init__(self, *args):

2524N/A HistoryException.__init__(self, *args)

2524N/A self.parse_failure = isinstance(self.error, expat.ExpatError)

2524N/A

2524N/A

2524N/Aclass HistoryRequestException(HistoryException):

2524N/A """Used to indicate that invalid time / range values were provided to

2524N/A pass

2524N/A

2524N/A

2524N/Aclass HistoryStoreException(HistoryException):

2524N/A """Used to indicate that an unexpected error occurred while storing

2524N/A pass

2524N/A

2524N/A

2524N/Aclass HistoryPurgeException(HistoryException):

2524N/A """Used to indicate that an unexpected error occurred while purging

2524N/A pass

2524N/A

2524N/A

1710N/Aclass ImageLockedError(ApiException):

1710N/A """Used to indicate that the image is currently locked by another thread

1710N/A

1710N/A def __init__(self, hostname=None, pid=None, pid_name=None):

1710N/A ApiException.__init__(self)

1710N/A self.hostname = hostname

1710N/A self.pid = pid

1710N/A self.pid_name = pid_name

1710N/A

1710N/A def __str__(self):

1710N/A if self.pid is not None and self.pid_name is not None and \

1710N/A self.hostname is not None:

1710N/A return _("The image cannot be modified as it is "

1710N/A "currently in use by another package client: "

1710N/A "%(pid_name)s on %(host)s, pid %(pid)s.") % {

1710N/A "pid_name": self.pid_name, "pid": self.pid,

1710N/A "host": self.hostname }

1710N/A if self.pid is not None and self.pid_name is not None:

1710N/A return _("The image cannot be modified as it is "

1710N/A "currently in use by another package client: "

1710N/A "%(pid_name)s on an unknown host, pid %(pid)s.") % {

1710N/A "pid_name": self.pid_name, "pid": self.pid }

1710N/A elif self.pid is not None:

1710N/A return _("The image cannot be modified as it is "

1710N/A "currently in use by another package client: "

1710N/A "pid %(pid)s on %(host)s.") % {

1710N/A "pid": self.pid, "host": self.hostname }

1710N/A return _("The image cannot be modified as it is currently "

1710N/A "in use by another package client.")

1710N/A

565N/Aclass ImageNotFoundException(ApiException):

565N/A """Used when an image was not found"""

565N/A def __init__(self, user_specified, user_dir, root_dir):

565N/A ApiException.__init__(self)

565N/A self.user_specified = user_specified

565N/A self.user_dir = user_dir

565N/A self.root_dir = root_dir

565N/A

2144N/A

2144N/Aclass ImageFormatUpdateNeeded(ApiException):

2144N/A """Used to indicate that an image cannot be used until its format is

2144N/A

2144N/A def __init__(self, path):

2144N/A ApiException.__init__(self)

2144N/A self.path = path

2144N/A

2144N/A def __str__(self):

2144N/A return _("The image rooted at %s is written in an older format "

2144N/A "and must be updated before the requested operation can be "

2144N/A "performed.") % self.path

2144N/A

2407N/Aclass ImageInsufficentSpace(ApiException):

2407N/A """Used when insuffcient space exists for proposed operation"""

2407N/A def __init__(self, needed, avail, use):

2407N/A self.needed = needed

2407N/A self.avail = avail

2407N/A self.use = use

2407N/A

2407N/A def __str__(self):

2407N/A from pkg.misc import bytes_to_str

2407N/A return _("Insufficent disk space available (%(avail)s)"

2407N/A "for estimated need (%(needed)s) for %(use)s") % {

2407N/A "avail": bytes_to_str(self.avail),

2407N/A "needed": bytes_to_str(self.needed),

2407N/A "use": self.use

2407N/A }

2407N/A

2144N/A

565N/Aclass VersionException(ApiException):

565N/A def __init__(self, expected_version, received_version):

565N/A ApiException.__init__(self)

565N/A self.expected_version = expected_version

565N/A self.received_version = received_version

565N/A

2144N/A

565N/Aclass PlanExistsException(ApiException):

565N/A def __init__(self, plan_type):

565N/A ApiException.__init__(self)

565N/A self.plan_type = plan_type

565N/A

1618N/A

1618N/Aclass PlanPrepareException(ApiException):

1618N/A """Base exception class for plan preparation errors."""

1618N/A pass

1618N/A

1618N/A

1755N/Aclass InvalidPackageErrors(ApiException):

1755N/A """Used to indicate that the requested operation could not be completed

1755N/A

1755N/A def __init__(self, errors):

1755N/A """'errors' should be a list of exceptions or strings

1755N/A

1755N/A ApiException.__init__(self)

1755N/A self.errors = errors

1755N/A

1755N/A def __str__(self):

1755N/A return _("The requested operation cannot be completed due "

1755N/A "to invalid package metadata. Details follow:\n\n"

1755N/A "%s") % "\n".join(str(e) for e in self.errors)

1755N/A

1755N/A

1618N/Aclass LicenseAcceptanceError(ApiException):

1618N/A """Used to indicate that license-related errors occurred during

1618N/A

1618N/A def __init__(self, pfmri, src=None, dest=None, accepted=None,

1618N/A displayed=None):

1618N/A ApiException.__init__(self)

1618N/A self.fmri = pfmri

1618N/A self.src = src

1618N/A self.dest = dest

1618N/A self.accepted = accepted

1618N/A self.displayed = displayed

1618N/A

1618N/A

1618N/Aclass PkgLicenseErrors(PlanPrepareException):

1618N/A """Used to indicate that plan evaluation or execution failed due

1618N/A

1618N/A def __init__(self, errors):

1618N/A """'errors' should be a list of LicenseAcceptanceError

1618N/A

1618N/A PlanPrepareException.__init__(self)

1618N/A self.__errors = errors

1618N/A

1618N/A @property

1618N/A def errors(self):

1618N/A """A list of LicenseAcceptanceError exceptions."""

1618N/A return self.__errors

1618N/A

1618N/A

1618N/Aclass PlanLicenseErrors(PlanPrepareException):

1618N/A """Used to indicate that image plan evaluation or execution failed due

1618N/A

1618N/A def __init__(self, pp_errors):

1618N/A """'errors' should be a list of PkgLicenseErrors exceptions."""

1618N/A

1618N/A PlanPrepareException.__init__(self)

1618N/A self.__errors = pkgs = {}

1618N/A for pp_err in pp_errors:

1618N/A for e in pp_err.errors:

1618N/A pkgs.setdefault(str(e.fmri), []).append(e)

1618N/A

1618N/A @property

1618N/A def errors(self):

1618N/A """Returns a dictionary indexed by package FMRI string of

1618N/A

1618N/A return self.__errors

1618N/A

1618N/A def __str__(self):

1618N/A """Returns a string representation of the license errors."""

1618N/A

1618N/A output = ""

1618N/A for sfmri in self.__errors:

1618N/A output += ("-" * 40) + "\n"

1618N/A output += _("Package: %s\n\n") % sfmri

1618N/A for e in self.__errors[sfmri]:

1618N/A lic_name = e.dest.attrs["license"]

1618N/A output += _("License: %s\n") % lic_name

1618N/A if e.dest.must_accept and not e.accepted:

1618N/A output += _(" License requires "

1618N/A "acceptance.")

1618N/A if e.dest.must_display and not e.displayed:

1618N/A output += _(" License must be viewed.")

1618N/A output += "\n"

1618N/A return output

1618N/A

1618N/A

1019N/Aclass ActuatorException(ApiException):

1019N/A def __init__(self, e):

1019N/A ApiException.__init__(self)

1019N/A self.exception = e

1019N/A

1019N/A def __str__(self):

1019N/A return str(self.exception)

1019N/A

1618N/A

565N/Aclass PrematureExecutionException(ApiException):

565N/A pass

565N/A

1618N/A

1618N/Aclass AlreadyPreparedException(PlanPrepareException):

565N/A pass

565N/A

1618N/A

565N/Aclass AlreadyExecutedException(ApiException):

565N/A pass

565N/A

1618N/A

565N/Aclass ImageplanStateException(ApiException):

565N/A def __init__(self, state):

565N/A ApiException.__init__(self)

565N/A self.state = state

565N/A

1369N/A

1710N/Aclass InvalidPlanError(ApiException):

1710N/A """Used to indicate that the image plan is no longer valid, likely as a

1710N/A

1710N/A def __str__(self):

1710N/A return _("The plan for the current operation is no longer "

1710N/A "valid. The image has likely been modified by another "

1710N/A "process or client. Please try the operation again.")

1710N/A

1710N/A

1372N/Aclass ImagePkgStateError(ApiException):

1369N/A

1369N/A def __init__(self, fmri, states):

1369N/A ApiException.__init__(self)

1369N/A self.fmri = fmri

1369N/A self.states = states

1369N/A

1369N/A def __str__(self):

1369N/A return _("Invalid package state change attempted '%(states)s' "

1372N/A "for package '%(fmri)s'.") % { "states": self.states,

1372N/A "fmri": self.fmri }

1369N/A

1369N/A

565N/Aclass IpkgOutOfDateException(ApiException):

565N/A pass

565N/A

565N/Aclass ImageUpdateOnLiveImageException(ApiException):

565N/A pass

565N/A

1328N/Aclass RebootNeededOnLiveImageException(ApiException):

1328N/A pass

1328N/A

565N/Aclass CanceledException(ApiException):

565N/A pass

565N/A

565N/Aclass PlanMissingException(ApiException):

565N/A pass

565N/A

565N/Aclass NoPackagesInstalledException(ApiException):

565N/A pass

565N/A

685N/Aclass PermissionsException(ApiException):

685N/A def __init__(self, path):

685N/A ApiException.__init__(self)

685N/A self.path = path

685N/A

685N/A def __str__(self):

685N/A if self.path:

926N/A return _("Could not operate on %s\nbecause of "

2126N/A "insufficient permissions. Please try the "

2126N/A "command again as a privileged user.") % \

2126N/A self.path

685N/A else:

685N/A return _("""

685N/A""")

685N/A

879N/Aclass FileInUseException(PermissionsException):

879N/A def __init__(self, path):

879N/A PermissionsException.__init__(self, path)

879N/A assert path

879N/A

879N/A def __str__(self):

879N/A return _("Could not operate on %s\nbecause the file is "

879N/A "in use. Please stop using the file and try the\n"

879N/A "operation again.") % self.path

879N/A

1335N/A

2612N/Aclass UnprivilegedUserError(PermissionsException):

2612N/A def __init__(self, path):

2612N/A PermissionsException.__init__(self, path)

2612N/A

2612N/A def __str__(self):

2612N/A return _("Insufficient access to complete the requested "

2612N/A "operation.\nPlease try the operation again as a "

2612N/A "privileged user.")

2612N/A

2612N/A

1335N/Aclass ReadOnlyFileSystemException(PermissionsException):

1945N/A """Used to indicate that the operation was attempted on a

1335N/A

1335N/A def __init__(self, path):

1335N/A ApiException.__init__(self)

1335N/A self.path = path

1335N/A

1335N/A def __str__(self):

1335N/A if self.path:

1335N/A return _("Could not complete the operation on %s: "

1968N/A "read-only filesystem.") % self.path

1335N/A return _("Could not complete the operation: read-only "

1335N/A "filesystem.")

1335N/A

1335N/A

2301N/Aclass PackageMatchErrors(ApiException):

2510N/A """Used to indicate which patterns were not matched or illegal during

2510N/A

2301N/A def __init__(self, unmatched_fmris=EmptyI, multiple_matches=EmptyI,

2301N/A illegal=EmptyI, multispec=EmptyI):

2301N/A ApiException.__init__(self)

2301N/A self.unmatched_fmris = unmatched_fmris

2301N/A self.multiple_matches = multiple_matches

2301N/A self.illegal = illegal

2301N/A self.multispec = multispec

2301N/A

2301N/A def __str__(self):

2301N/A res = []

2301N/A if self.unmatched_fmris:

2301N/A s = _("The following pattern(s) did not match any "

2301N/A "packages:")

2301N/A

2301N/A res += [s]

2301N/A res += ["\t%s" % p for p in self.unmatched_fmris]

2301N/A

2301N/A if self.multiple_matches:

2301N/A s = _("'%s' matches multiple packages")

2301N/A for p, lst in self.multiple_matches:

2301N/A res.append(s % p)

2301N/A for pfmri in lst:

2301N/A res.append("\t%s" % pfmri)

2301N/A

2301N/A if self.illegal:

2301N/A s = _("'%s' is an illegal FMRI")

2301N/A res += [ s % p for p in self.illegal ]

2301N/A

2301N/A if self.multispec:

2301N/A s = _("The following different patterns specify the "

2301N/A "same package(s):")

2301N/A res += [s]

2301N/A for t in self.multispec:

2301N/A res += [

2301N/A ", ".join([t[i] for i in range(1, len(t))])

2301N/A + ": %s" % t[0]

2301N/A ]

2301N/A

2301N/A return "\n".join(res)

2301N/A

2301N/A

565N/Aclass PlanCreationException(ApiException):

2339N/A def __init__(self,

2339N/A already_installed=EmptyI,

2339N/A badarch=EmptyI,

2339N/A illegal=EmptyI,

2339N/A installed=EmptyI,

2453N/A invalid_mediations=EmptyI,

2339N/A linked_pub_error=EmptyI,

2339N/A missing_dependency=EmptyI,

2339N/A missing_matches=EmptyI,

2339N/A multiple_matches=EmptyI,

2339N/A multispec=EmptyI,

2339N/A no_solution=False,

2339N/A no_tmp_origins=False,

2339N/A no_version=EmptyI,

2505N/A not_avoided=EmptyI,

2339N/A nofiles=EmptyI,

2339N/A obsolete=EmptyI,

2339N/A pkg_updates_required=EmptyI,

2445N/A rejected_pats=EmptyI,

2339N/A solver_errors=EmptyI,

2339N/A unmatched_fmris=EmptyI,

2339N/A would_install=EmptyI,

2339N/A wrong_publishers=EmptyI,

2339N/A wrong_variants=EmptyI):

2339N/A

565N/A ApiException.__init__(self)

2339N/A self.already_installed = already_installed

2339N/A self.badarch = badarch

2339N/A self.illegal = illegal

2339N/A self.installed = installed

2453N/A self.invalid_mediations = invalid_mediations

2339N/A self.linked_pub_error = linked_pub_error

2339N/A self.missing_dependency = missing_dependency

2339N/A self.missing_matches = missing_matches

1505N/A self.multiple_matches = multiple_matches

1505N/A self.multispec = multispec

2339N/A self.no_solution = no_solution

2339N/A self.no_tmp_origins = no_tmp_origins

2339N/A self.no_version = no_version

2505N/A self.not_avoided = not_avoided

2339N/A self.nofiles = nofiles

2207N/A self.obsolete = obsolete

2339N/A self.pkg_updates_required = pkg_updates_required

2445N/A self.rejected_pats = rejected_pats

2339N/A self.solver_errors = solver_errors

2339N/A self.unmatched_fmris = unmatched_fmris

2339N/A self.would_install = would_install

1505N/A self.wrong_publishers = wrong_publishers

2212N/A self.wrong_variants = wrong_variants

2339N/A

565N/A def __str__(self):

616N/A res = []

1141N/A if self.unmatched_fmris:

616N/A s = _("""\

2339N/A""")

926N/A res += [s]

1141N/A res += ["\t%s" % p for p in self.unmatched_fmris]

565N/A

2445N/A if self.rejected_pats:

2445N/A s = _("""\

2445N/A""")

2445N/A res += [s]

2445N/A res += ["\t%s" % p for p in self.rejected_pats]

2445N/A

2212N/A if self.wrong_variants:

2212N/A s = _("""\

2212N/Afor the current image's architecture, zone type, and/or other variant:""")

2212N/A res += [s]

2212N/A res += ["\t%s" % p for p in self.wrong_variants]

2212N/A

1505N/A if self.wrong_publishers:

1505N/A s = _("The following patterns only matched packages "

1505N/A "that are from publishers other than that which "

1505N/A "supplied the already installed version of this package")

1505N/A res += [s]

1505N/A res += ["\t%s: %s" % (p[0], ", ".join(p[1])) for p in self.wrong_publishers]

1505N/A

565N/A if self.multiple_matches:

988N/A s = _("'%s' matches multiple packages")

565N/A for p, lst in self.multiple_matches:

922N/A res.append(s % p)

922N/A for pfmri in lst:

633N/A res.append("\t%s" % pfmri)

616N/A

1505N/A if self.missing_matches:

1505N/A s = _("'%s' matches no installed packages")

1505N/A res += [ s % p for p in self.missing_matches ]

616N/A

1505N/A if self.illegal:

1505N/A s = _("'%s' is an illegal fmri")

1505N/A res += [ s % p for p in self.illegal ]

655N/A

838N/A if self.badarch:

2826N/A s = _("'%(p)s' supports the following architectures: "

2826N/A "%(archs)s")

838N/A a = _("Image architecture is defined as: %s")

2826N/A res += [ s % {"p": self.badarch[0],

2826N/A "archs": ", ".join(self.badarch[1])}]

838N/A res += [ a % (self.badarch[2])]

838N/A

1461N/A s = _("'%(p)s' depends on obsolete package '%(op)s'")

1461N/A res += [ s % {"p": p, "op": op} for p, op in self.obsolete ]

1461N/A

1352N/A if self.installed:

1352N/A s = _("The proposed operation can not be performed for "

1352N/A "the following package(s) as they are already "

1352N/A "installed: ")

1352N/A res += [s]

1352N/A res += ["\t%s" % p for p in self.installed]

1352N/A

2453N/A if self.invalid_mediations:

2453N/A s = _("The following mediations are not syntactically "

2453N/A "valid:")

2453N/A for m, entries in self.invalid_mediations.iteritems():

2453N/A for value, error in entries.values():

2453N/A res.append(error)

2453N/A

1505N/A if self.multispec:

2681N/A s = _("The following patterns specify different "

2681N/A "versions of the same package(s):")

1505N/A res += [s]

1505N/A for t in self.multispec:

1505N/A res += [

1505N/A ", ".join(

1505N/A [t[i] for i in range(1, len(t))])

1505N/A + ": %s" % t[0]

1945N/A ]

1505N/A if self.no_solution:

1505N/A res += [_("No solution was found to satisfy constraints")]

2197N/A if isinstance(self.no_solution, list):

2197N/A res.extend(self.no_solution)

2207N/A

2339N/A if self.pkg_updates_required:

2339N/A s = _("""\

2339N/A""")

2339N/A res += [s]

2339N/A for (oldfmri, newfmri) in self.pkg_updates_required:

2339N/A res += ["%(oldfmri)s -> %(newfmri)s\n" % \

2339N/A {"oldfmri": oldfmri, "newfmri": newfmri}]

2339N/A

1505N/A if self.no_version:

1505N/A res += self.no_version

1505N/A

2339N/A if self.no_tmp_origins:

2339N/A s = _("""

2339N/Apersistently.""")

2339N/A res = [s]

2339N/A

1505N/A if self.missing_dependency:

1945N/A res += [_("Package %(pkg)s is missing a dependency: "

1945N/A "%(dep)s") %

1945N/A {"pkg": self.missing_dependency[0],

1945N/A "dep": self.missing_dependency[1]}]

2200N/A if self.nofiles:

2200N/A res += [_("The following files are not packaged in this image:")]

2200N/A res += ["\t%s" % f for f in self.nofiles]

1945N/A

2207N/A if self.solver_errors:

2207N/A res += ["\n"]

2207N/A res += [_("Solver dependency errors:")]

2207N/A res.extend(self.solver_errors)

2207N/A

2228N/A if self.already_installed:

2339N/A res += [_("The following packages are already "

2339N/A "installed in this image; use uninstall to "

2339N/A "avoid these:")]

2228N/A res += [ "\t%s" % s for s in self.already_installed]

2228N/A

2228N/A if self.would_install:

2339N/A res += [_("The following packages are a target "

2339N/A "of group dependencies; use install to unavoid "

2339N/A "these:")]

2228N/A res += [ "\t%s" % s for s in self.would_install]

2228N/A

2505N/A if self.not_avoided:

2505N/A res += [_("The following packages are not on the "

2505N/A "avoid list, so they\ncannot be removed from it.")]

2505N/A res += [ "\t%s" % s for s in sorted(self.not_avoided)]

2505N/A

2339N/A def __format_li_pubs(pubs, res):

2339N/A i = 0

2339N/A for pub, sticky in pubs:

2339N/A s = " %s %d: %s" % (_("PUBLISHER"), i, pub)

2339N/A mod = []

2339N/A if not sticky:

2339N/A mod.append(_("non-sticky"))

2339N/A if mod:

2339N/A s += " (%s)" % ",".join(mod)

2339N/A res.append(s)

2339N/A i += 1

2339N/A

2339N/A if self.linked_pub_error:

2339N/A res = []

2339N/A (pubs, parent_pubs) = self.linked_pub_error

2339N/A

2339N/A res.append(_("""

2339N/AThe parent image has the following enabled publishers:"""))

2339N/A __format_li_pubs(parent_pubs, res)

2339N/A res.append(_("""

2339N/AThe child image has the following enabled publishers:"""))

2339N/A __format_li_pubs(pubs, res)

2339N/A

1352N/A return "\n".join(res)

565N/A

2228N/A

2205N/Aclass ConflictingActionError(ApiException):

2205N/A """Used to indicate that the imageplan would result in one or more sets

2205N/A

2205N/A def __init__(self, data):

2205N/A self._data = data

2205N/A

2205N/Aclass ConflictingActionErrors(ApiException):

2205N/A """A container for multiple ConflictingActionError exception objects

2205N/A

2205N/A def __init__(self, errors):

2205N/A self.__errors = errors

2205N/A

2205N/A def __str__(self):

2205N/A return "\n\n".join((str(err) for err in self.__errors))

2205N/A

2205N/Aclass DuplicateActionError(ConflictingActionError):

2205N/A """Multiple actions of the same type have been delivered with the same

2205N/A

2205N/A def __str__(self):

2205N/A pfmris = set((a[1] for a in self._data))

2205N/A kv = self._data[0][0].attrs[self._data[0][0].key_attr]

2205N/A action = self._data[0][0].name

2205N/A if len(pfmris) > 1:

2205N/A s = _("The following packages all deliver %(action)s "

2205N/A "actions to %(kv)s:\n") % locals()

2205N/A for a, p in self._data:

2205N/A s += "\n %s" % p

2205N/A s += _("\n\nThese packages may not be installed together. "

2205N/A "Any non-conflicting set may\nbe, or the packages "

2205N/A "must be corrected before they can be installed.")

2205N/A else:

2205N/A pfmri = pfmris.pop()

2205N/A s = _("The package %(pfmri)s delivers multiple copies "

2205N/A "of %(action)s %(kv)s") % locals()

2205N/A s += _("\nThis package must be corrected before it "

2205N/A "can be installed.")

2205N/A

2205N/A return s

2205N/A

2205N/Aclass InconsistentActionTypeError(ConflictingActionError):

2205N/A """Multiple actions of different types have been delivered with the same

2205N/A

2205N/A def __str__(self):

2205N/A ad = {}

2205N/A pfmris = set()

2205N/A kv = self._data[0][0].attrs[self._data[0][0].key_attr]

2205N/A for a, p in self._data:

2205N/A ad.setdefault(a.name, []).append(p)

2205N/A pfmris.add(p)

2205N/A

2205N/A if len(pfmris) > 1:

2205N/A s = _("The following packages deliver conflicting "

2205N/A "action types to %s:\n") % kv

2205N/A for name, pl in ad.iteritems():

2205N/A s += "\n %s:" % name

2205N/A s += "".join("\n %s" % p for p in pl)

2205N/A s += _("\n\nThese packages may not be installed together. "

2205N/A "Any non-conflicting set may\nbe, or the packages "

2205N/A "must be corrected before they can be installed.")

2205N/A else:

2205N/A pfmri = pfmris.pop()

2205N/A types = list_to_lang(ad.keys())

2205N/A s = _("The package %(pfmri)s delivers conflicting "

2205N/A "action types (%(types)s) to %(kv)s") % locals()

2205N/A s += _("\nThis package must be corrected before it "

2205N/A "can be installed.")

2205N/A return s

2205N/A

2205N/Aclass InconsistentActionAttributeError(ConflictingActionError):

2205N/A """Multiple actions of the same type representing the same object have

2205N/A

2205N/A def __str__(self):

2205N/A actions = self._data

2205N/A keyattr = actions[0][0].attrs[actions[0][0].key_attr]

2205N/A actname = actions[0][0].name

2205N/A

2205N/A # Trim the action's attributes to only those required to be

2205N/A # unique.

2205N/A def ou(action):

2205N/A ua = dict(

2205N/A (k, v)

2205N/A for k, v in action.attrs.iteritems()

2453N/A if ((k in action.unique_attrs and

2453N/A not (k == "preserve" and "overlay" in action.attrs)) or

2453N/A ((action.name == "link" or action.name == "hardlink") and

2453N/A k.startswith("mediator")))

2205N/A )

2205N/A action.attrs = ua

2205N/A return action

2205N/A

2205N/A d = {}

2205N/A for a in actions:

2232N/A if a[0].attrs.get("implicit", "false") == "false":

2232N/A d.setdefault(str(ou(a[0])), set()).add(a[1])

2205N/A l = sorted([

2205N/A (len(pkglist), action, pkglist)

2205N/A for action, pkglist in d.iteritems()

2205N/A ])

2205N/A

2205N/A s = _("The requested change to the system attempts to install "

2205N/A "multiple actions\nfor %(a)s '%(k)s' with conflicting "

2205N/A "attributes:\n\n") % {"a": actname, "k": keyattr}

2205N/A allpkgs = set()

2205N/A for num, action, pkglist in l:

2205N/A allpkgs.update(pkglist)

2205N/A if num <= 5:

2205N/A if num == 1:

2205N/A t = _(" %(n)d package delivers '%(a)s':\n")

2205N/A else:

2205N/A t = _(" %(n)d packages deliver '%(a)s':\n")

2205N/A s += t % {"n": num, "a": action}

2205N/A for pkg in sorted(pkglist):

2205N/A s += _(" %s\n") % pkg

2205N/A else:

2826N/A t = _(" %(n)d packages deliver '%(a)s', including:\n")

2826N/A s += t % {"n": num, "a": action}

2205N/A for pkg in sorted(pkglist)[:5]:

2205N/A s += _(" %s\n") % pkg

2205N/A

2205N/A if len(allpkgs) == 1:

2239N/A s += _("\nThis package must be corrected before it "

2205N/A "can be installed.")

2205N/A else:

2239N/A s += _("\nThese packages may not be installed together."

2205N/A " Any non-conflicting set may\nbe, or the packages "

2205N/A "must be corrected before they can be installed.")

2205N/A

2205N/A return s

2205N/A

2205N/Adef list_to_lang(l):

2205N/A """Takes a list of items and puts them into a string, with commas in

2205N/A

2205N/A if not l:

2205N/A return ""

2205N/A if len(l) == 1:

2205N/A return l[0]

2205N/A if len(l) == 2:

2205N/A # Used for a two-element list

2205N/A return _("%(penultimate)s and %(ultimate)s") % {

2205N/A "penultimate": l[0],

2205N/A "ultimate": l[1]

2205N/A }

2205N/A # In order to properly i18n this construct, we create two templates:

2205N/A # one for each element save the last, and one that tacks on the last

2205N/A # element.

2205N/A # 'elementtemplate' is for each element through the penultimate

2205N/A elementtemplate = _("%s, ")

2205N/A # 'listtemplate' concatenates the concatenation of non-ultimate elements

2205N/A # and the ultimate element.

2205N/A listtemplate = _("%(list)sand %(tail)s")

2205N/A return listtemplate % {

2205N/A "list": "".join(elementtemplate % i for i in l[:-1]),

2205N/A "tail": l[-1]

2205N/A }

1068N/A

1050N/Aclass ActionExecutionError(ApiException):

1859N/A """Used to indicate that action execution (such as install, remove,

1859N/A

1859N/A def __init__(self, action, details=None, error=None, fmri=None,

1859N/A use_errno=None):

1859N/A """'action' is the object for the action that failed during the

1050N/A

1859N/A assert (details or error)

1050N/A self.action = action

1859N/A self.details = details

1859N/A self.error = error

1859N/A self.fmri = fmri

1859N/A if use_errno == None:

1859N/A # If details were provided, don't use errno unless

1859N/A # explicitly requested.

1859N/A use_errno = not details

1859N/A self.use_errno = use_errno

1050N/A

1050N/A def __str__(self):

1050N/A errno = ""

1859N/A if self.use_errno and self.error and \

1859N/A hasattr(self.error, "errno"):

1859N/A errno = "[errno %d: %s]" % (self.error.errno,

1859N/A os.strerror(self.error.errno))

1050N/A

1859N/A details = self.details or ""

1050N/A

1050N/A # Fall back on the wrapped exception if we don't have anything

1050N/A # useful.

1859N/A if not errno and not details:

1859N/A return str(self.error)

1859N/A

1859N/A if errno and details:

1859N/A details = "%s: %s" % (errno, details)

1050N/A

1859N/A if details and not self.fmri:

1859N/A details = _("Requested operation failed for action "

1859N/A "%(action)s:\n%(details)s") % {

1859N/A "action": self.action,

2073N/A "details": details }

1859N/A elif details:

1859N/A details = _("Requested operation failed for package "

1859N/A "%(fmri)s:\n%(details)s") % { "fmri": self.fmri,

1859N/A "details": details }

1050N/A

1050N/A # If we only have one of the two, no need for the colon.

1859N/A return "%s%s" % (errno, details)

1050N/A

1068N/A

565N/Aclass CatalogRefreshException(ApiException):

1603N/A def __init__(self, failed, total, succeeded, errmessage=None):

565N/A ApiException.__init__(self)

565N/A self.failed = failed

565N/A self.total = total

565N/A self.succeeded = succeeded

1603N/A self.errmessage = errmessage

565N/A

1068N/A

1352N/Aclass CatalogError(ApiException):

1352N/A """Base exception class for all catalog exceptions."""

1352N/A

1352N/A def __init__(self, *args, **kwargs):

565N/A ApiException.__init__(self)

1352N/A if args:

1352N/A self.data = args[0]

1352N/A else:

1352N/A self.data = None

1516N/A self._args = kwargs

1352N/A

1352N/A def __str__(self):

1352N/A return str(self.data)

1352N/A

1352N/A

1352N/Aclass AnarchicalCatalogFMRI(CatalogError):

1352N/A """Used to indicate that the specified FMRI is not valid for catalog

1352N/A

1352N/A def __str__(self):

1352N/A return _("The FMRI '%s' does not contain publisher information "

1352N/A "and cannot be used for catalog operations.") % self.data

1352N/A

1352N/A

1352N/Aclass BadCatalogMetaRoot(CatalogError):

1352N/A """Used to indicate an operation on the catalog's meta_root failed

1352N/A

1352N/A def __str__(self):

1352N/A return _("Catalog meta_root '%(root)s' is invalid; unable "

1352N/A "to complete operation: '%(op)s'.") % { "root": self.data,

1516N/A "op": self._args.get("operation", None) }

1352N/A

1352N/A

1352N/Aclass BadCatalogPermissions(CatalogError):

1352N/A """Used to indicate the server catalog files do not have the expected

1352N/A

1352N/A def __init__(self, files):

1352N/A """files should contain a list object with each entry consisting

1352N/A if not files:

1352N/A files = []

1352N/A CatalogError.__init__(self, files)

1352N/A

1352N/A def __str__(self):

1352N/A msg = _("The following catalog files have incorrect "

1352N/A "permissions:\n")

2614N/A for f in self.data:

1352N/A fname, emode, fmode = f

1352N/A msg += _("\t%(fname)s: expected mode: %(emode)s, found "

1352N/A "mode: %(fmode)s\n") % { "fname": fname,

1352N/A "emode": emode, "fmode": fmode }

1352N/A return msg

1352N/A

1352N/A

1352N/Aclass BadCatalogSignatures(CatalogError):

1352N/A """Used to indicate that the Catalog signatures are not valid."""

1352N/A

1352N/A def __str__(self):

1352N/A return _("The signature data for the '%s' catalog file is not "

1352N/A "valid.") % self.data

1352N/A

1352N/A

1352N/Aclass BadCatalogUpdateIdentity(CatalogError):

1352N/A """Used to indicate that the requested catalog updates could not be

1352N/A

1352N/A def __str__(self):

1352N/A return _("Unable to determine the updates needed for "

1352N/A "the current catalog using the provided catalog "

1352N/A "update data in '%s'.") % self.data

1352N/A

1352N/A

1352N/Aclass DuplicateCatalogEntry(CatalogError):

1352N/A """Used to indicate that the specified catalog operation could not be

1352N/A

1352N/A def __str__(self):

1352N/A return _("Unable to perform '%(op)s' operation for catalog "

1352N/A "%(name)s; completion would result in a duplicate entry "

1516N/A "for package '%(fmri)s'.") % { "op": self._args.get(

1516N/A "operation", None), "name": self._args.get("catalog_name",

1352N/A None), "fmri": self.data }

1352N/A

1352N/A

1352N/Aclass CatalogUpdateRequirements(CatalogError):

1352N/A """Used to indicate that an update request for the catalog could not

1352N/A

1352N/A def __str__(self):

1352N/A return _("Catalog updates can only be applied to an on-disk "

1352N/A "catalog.")

1352N/A

1352N/A

1352N/Aclass InvalidCatalogFile(CatalogError):

1352N/A """Used to indicate a Catalog file could not be loaded."""

1352N/A

1352N/A def __str__(self):

1352N/A return _("Catalog file '%s' is invalid.") % self.data

1352N/A

1352N/A

2022N/Aclass MismatchedCatalog(CatalogError):

2022N/A """Used to indicate that a Catalog's attributes and parts do not

2022N/A

2022N/A def __str__(self):

2022N/A return _("The content of the catalog for publisher '%s' "

2022N/A "doesn't match the catalog's attributes. This is "

2022N/A "likely the result of a mix of older and newer "

2022N/A "catalog files being provided for the publisher.") % \

2022N/A self.data

2022N/A

2022N/A

1352N/Aclass ObsoleteCatalogUpdate(CatalogError):

1352N/A """Used to indicate that the specified catalog updates are for an older

1352N/A

1352N/A def __str__(self):

1352N/A return _("Unable to determine the updates needed for the "

1352N/A "catalog using the provided catalog update data in '%s'. "

1352N/A "The specified catalog updates are for an older version "

1352N/A "of the catalog and cannot be used.") % self.data

1352N/A

1352N/A

1352N/Aclass UnknownCatalogEntry(CatalogError):

1352N/A """Used to indicate that an entry for the specified package FMRI or

1352N/A

1352N/A def __str__(self):

1352N/A return _("'%s' could not be found in the catalog.") % self.data

1352N/A

1352N/A

1352N/Aclass UnknownUpdateType(CatalogError):

1352N/A """Used to indicate that the specified CatalogUpdate operation is

1352N/A

1352N/A def __str__(self):

1352N/A return _("Unknown catalog update type '%s'") % self.data

1352N/A

1352N/A

1431N/Aclass UnrecognizedCatalogPart(CatalogError):

1431N/A """Raised when the catalog finds a CatalogPart that is unrecognized

1431N/A

1431N/A def __str__(self):

1431N/A return _("Unrecognized, unknown, or invalid CatalogPart '%s'") \

1431N/A % self.data

1431N/A

1431N/A

1352N/Aclass InventoryException(ApiException):

1352N/A """Used to indicate that some of the specified patterns to a catalog

1352N/A

1352N/A def __init__(self, illegal=EmptyI, matcher=EmptyI, notfound=EmptyI,

1352N/A publisher=EmptyI, version=EmptyI):

1352N/A ApiException.__init__(self)

838N/A self.illegal = illegal

1352N/A self.matcher = matcher

1352N/A self.notfound = set(notfound)

1352N/A self.publisher = publisher

1352N/A self.version = version

1352N/A

1352N/A self.notfound.update(matcher)

1352N/A self.notfound.update(publisher)

1352N/A self.notfound.update(version)

1352N/A self.notfound = list(self.notfound)

1352N/A

1945N/A assert self.illegal or self.notfound

565N/A

596N/A def __str__(self):

596N/A outstr = ""

596N/A for x in self.illegal:

596N/A # Illegal FMRIs have their own __str__ method

596N/A outstr += "%s\n" % x

614N/A

1352N/A if self.matcher or self.publisher or self.version:

614N/A outstr += _("No matching package could be found for "

614N/A "the following FMRIs in any of the catalogs for "

926N/A "the current publishers:\n")

614N/A

1352N/A for x in self.matcher:

1352N/A outstr += _("%s (pattern did not match)\n") % x

1352N/A for x in self.publisher:

1352N/A outstr += _("%s (publisher did not "

1352N/A "match)\n") % x

1352N/A for x in self.version:

1352N/A outstr += _("%s (version did not match)\n") % x

596N/A return outstr

565N/A

1027N/A

1191N/A

1027N/Aclass SearchException(ApiException):

1027N/A """Based class used for all search-related api exceptions."""

1027N/A pass

1027N/A

1027N/A

1191N/Aclass MalformedSearchRequest(SearchException):

1191N/A """Raised when the server cannot understand the format of the

1191N/A

1191N/A def __init__(self, url):

1191N/A SearchException.__init__(self)

1191N/A self.url = url

1191N/A

1191N/A def __str__(self):

1191N/A return str(self.url)

1191N/A

1191N/A

1191N/Aclass NegativeSearchResult(SearchException):

1191N/A """Returned when the search cannot find any matches."""

1191N/A

1191N/A def __init__(self, url):

1191N/A SearchException.__init__(self)

1191N/A self.url = url

1191N/A

1191N/A def __str__(self):

1191N/A return _("The search at url %s returned no results.") % self.url

1191N/A

1191N/A

1191N/Aclass ProblematicSearchServers(SearchException):

1191N/A """This class wraps exceptions which could appear while trying to

1191N/A

1191N/A def __init__(self, failed=EmptyI, invalid=EmptyI, unsupported=EmptyI):

1191N/A SearchException.__init__(self)

1191N/A self.failed_servers = failed

1191N/A self.invalid_servers = invalid

1191N/A self.unsupported_servers = unsupported

1191N/A

1191N/A def __str__(self):

1895N/A s = _("Some repositories failed to respond appropriately:\n")

1191N/A for pub, err in self.failed_servers:

1191N/A s += _("%(o)s:\n%(msg)s\n") % \

1191N/A { "o": pub, "msg": err}

1191N/A for pub in self.invalid_servers:

1191N/A s += _("%s did not return a valid response.\n" \

1191N/A % pub)

1191N/A if len(self.unsupported_servers) > 0:

1895N/A s += _("Some repositories don't support requested "

1895N/A "search operation:\n")

1191N/A for pub, err in self.unsupported_servers:

1191N/A s += _("%(o)s:\n%(msg)s\n") % \

1191N/A { "o": pub, "msg": err}

1191N/A

1191N/A return s

1191N/A

1191N/A

1191N/Aclass SlowSearchUsed(SearchException):

1191N/A """This exception is thrown when a local search is performed without

1191N/A

1191N/A def __str__(self):

1191N/A return _("Search performance is degraded.\n"

1191N/A "Run 'pkg rebuild-index' to improve search speed.")

1191N/A

1191N/A

1191N/Aclass UnsupportedSearchError(SearchException):

1191N/A """Returned when a search protocol is not supported by the

1191N/A

1191N/A def __init__(self, url=None, proto=None):

1191N/A SearchException.__init__(self)

1191N/A self.url = url

1191N/A self.proto = proto

1191N/A

1191N/A def __str__(self):

1895N/A s = _("Search repository does not support the requested "

1895N/A "protocol:")

1191N/A if self.url:

1895N/A s += "\nRepository URL: %s" % self.url

1191N/A if self.proto:

1191N/A s += "\nRequested operation: %s" % self.proto

1191N/A return s

1191N/A

1191N/A def __cmp__(self, other):

1191N/A if not isinstance(other, UnsupportedSearchError):

1945N/A return -1

1191N/A r = cmp(self.url, other.url)

1191N/A if r != 0:

1191N/A return r

1191N/A return cmp(self.proto, other.proto)

1191N/A

1191N/A

1191N/A

1027N/Aclass IndexingException(SearchException):

565N/A """ The base class for all exceptions that can occur while indexing. """

1027N/A

565N/A def __init__(self, private_exception):

1027N/A SearchException.__init__(self)

565N/A self.cause = private_exception.cause

565N/A

1027N/A

565N/Aclass CorruptedIndexException(IndexingException):

565N/A """This is used when the index is not in a correct state."""

565N/A pass

565N/A

1027N/A

1191N/Aclass InconsistentIndexException(IndexingException):

1191N/A """This is used when the existing index is found to have inconsistent

1191N/A def __init__(self, e):

1191N/A IndexingException.__init__(self, e)

1191N/A self.exception = e

1191N/A

1191N/A def __str__(self):

1191N/A return str(self.exception)

1191N/A

1191N/A

2028N/Aclass IndexLockedException(IndexingException):

2028N/A """This is used when an attempt to modify an index locked by another

2028N/A

2028N/A def __init__(self, e):

2028N/A IndexingException.__init__(self, e)

2028N/A self.exception = e

2028N/A

2028N/A def __str__(self):

2028N/A return str(self.exception)

2028N/A

2028N/A

565N/Aclass ProblematicPermissionsIndexException(IndexingException):

565N/A """ This is used when the indexer is unable to create, move, or remove

565N/A def __str__(self):

565N/A return "Could not remove or create " \

565N/A "%s because of incorrect " \

565N/A "permissions. Please correct this issue then " \

565N/A "rebuild the index." % self.cause

941N/A

1286N/Aclass WrapIndexingException(ApiException):

1286N/A """This exception is used to wrap an indexing exception during install,

1286N/A

1286N/A def __init__(self, e, tb, stack):

1286N/A ApiException.__init__(self)

1286N/A self.wrapped = e

1286N/A self.tb = tb

1286N/A self.stack = stack

1286N/A

1286N/A def __str__(self):

1286N/A tmp = self.tb.split("\n")

1286N/A res = tmp[:1] + [s.rstrip("\n") for s in self.stack] + tmp[1:]

1286N/A return "\n".join(res)

1286N/A

1286N/A

1286N/Aclass WrapSuccessfulIndexingException(WrapIndexingException):

1286N/A """This exception is used to wrap an indexing exception during install,

1286N/A pass

1286N/A

1286N/A

1191N/Aclass BooleanQueryException(ApiException):

1191N/A """This exception is used when the children of a boolean operation

941N/A

941N/A def __init__(self, e):

1191N/A ApiException.__init__(self)

1191N/A self.e = e

1191N/A

1191N/A def __str__(self):

1191N/A return str(self.e)

1191N/A

1191N/A

1191N/Aclass ParseError(ApiException):

1191N/A def __init__(self, e):

1191N/A ApiException.__init__(self)

941N/A self.e = e

941N/A

941N/A def __str__(self):

1027N/A return str(self.e)

1027N/A

565N/A

565N/Aclass NonLeafPackageException(ApiException):

565N/A """Removal of a package which satisfies dependencies has been attempted.

565N/A