926N/A

565N/A

2026N/Aimport errno

3094N/Aimport operator

1050N/Aimport os

3234N/Aimport six

2524N/Aimport xml.parsers.expat as expat

3245N/Afrom functools import total_ordering

3234N/Afrom six.moves.urllib.parse import urlsplit

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

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: "

3158N/A "{pid_name} on {host}, pid {pid}.").format(

3158N/A pid_name=self.pid_name, pid=self.pid,

3158N/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: "

3158N/A "{pid_name} on an unknown host, pid {pid}.").format(

3158N/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: "

3158N/A "pid {pid} on {host}.").format(

3158N/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

2976N/A def __str__(self):

3158N/A return _("No image rooted at '{0}'").format(self.user_dir)

2976N/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):

3158N/A return _("The image rooted at {0} is written in an older format "

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

3158N/A "performed.").format(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

3158N/A return _("Insufficient disk space available ({avail}) "

3158N/A "for estimated need ({needed}) for {use}").format(

3158N/A avail=bytes_to_str(self.avail),

3158N/A needed=bytes_to_str(self.needed),

3158N/A use=self.use

3158N/A )

2875N/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"

3158N/A "{0}").format("\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"

3158N/A output += _("Package: {0}\n\n").format(sfmri)

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

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

3158N/A output += _("License: {0}\n").format(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

3459N/Aclass InvalidVarcetNames(PlanPrepareException):

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

3459N/A

3459N/A def __init__(self, invalid_names):

3459N/A PlanPrepareException.__init__(self)

3459N/A self.names = invalid_names

3459N/A

3459N/A def __str__(self):

3459N/A return _(", ".join(self.names) + " are not valid variant/facet "

3459N/A "names; variant/facet names cannot contain whitespace.")

3459N/A

3459N/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):

3158N/A return _("Invalid package state change attempted '{states}' "

3158N/A "for package '{fmri}'.").format(states=self.states,

3158N/A fmri=self.fmri)

1369N/A

1369N/A

565N/Aclass IpkgOutOfDateException(ApiException):

2976N/A def __str__(self):

3356N/A return _("pkg(7) out of date")

2976N/A

565N/A

565N/Aclass ImageUpdateOnLiveImageException(ApiException):

2976N/A def __str__(self):

2976N/A return _("Requested operation cannot be performed "

2976N/A "in live image.")

2976N/A

565N/A

1328N/Aclass RebootNeededOnLiveImageException(ApiException):

2976N/A def __str__(self):

2976N/A return _("Requested operation cannot be performed "

2976N/A "in live image.")

2976N/A

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:

3158N/A return _("Could not operate on {0}\nbecause of "

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

3158N/A "command again as a privileged user.").format(

3158N/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):

3158N/A return _("Could not operate on {0}\nbecause the file is "

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

3158N/A "operation again.").format(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:

3158N/A return _("Could not complete the operation on {0}: "

3158N/A "read-only filesystem.").format(self.path)

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

1335N/A "filesystem.")

1335N/A

1335N/A

2974N/Aclass InvalidLockException(ApiException):

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

2974N/A ApiException.__init__(self)

2974N/A self.path = path

2974N/A

2974N/A def __str__(self):

3158N/A return _("Unable to obtain or operate on lock at {0}.\n"

3158N/A "Please try the operation again as a privileged "

3158N/A "user.").format(self.path)

2974N/A

2974N/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]

3158N/A res += ["\t{0}".format(p) for p in self.unmatched_fmris]

2301N/A

2301N/A if self.multiple_matches:

3158N/A s = _("'{0}' matches multiple packages")

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

3158N/A res.append(s.format(p))

2301N/A for pfmri in lst:

3158N/A res.append("\t{0}".format(pfmri))

2301N/A

2301N/A if self.illegal:

3158N/A s = _("'{0}' is an illegal FMRI")

3158N/A res += [ s.format(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))])

3158N/A + ": {0}".format(t[0])

2301N/A ]

2301N/A

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

2301N/A

2301N/A

3384N/Aclass PlanExecutionError(InvalidPlanError):

3384N/A """Used to indicate that the requested operation could not be executed

3384N/A

3384N/A def __init__(self, paths):

3384N/A self.paths = paths

3384N/A

3384N/A def __str__(self):

3384N/A return _("The files listed below were modified after operation "

3384N/A "planning was complete or were missing during plan "

3384N/A "execution; this may indicate an administrative issue or "

3384N/A "system configuration issue:\n{0}".format(

3384N/A "\n".join(list(self.paths))))

3384N/A

3384N/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,

3110N/A no_repo_pubs=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

3110N/A self.no_repo_pubs = no_repo_pubs

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]

3158N/A res += ["\t{0}".format(p) for p in self.unmatched_fmris]

565N/A

2445N/A if self.rejected_pats:

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

2445N/A""")

2445N/A res += [s]

3158N/A res += ["\t{0}".format(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]

3158N/A res += ["\t{0}".format(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]

3158N/A res += ["\t{0}: {1}".format(p[0], ", ".join(p[1])) for p in self.wrong_publishers]

1505N/A

565N/A if self.multiple_matches:

3158N/A s = _("'{0}' matches multiple packages")

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

3158N/A res.append(s.format(p))

922N/A for pfmri in lst:

3158N/A res.append("\t{0}".format(pfmri))

616N/A

1505N/A if self.missing_matches:

3158N/A s = _("'{0}' matches no installed packages")

3158N/A res += [ s.format(p) for p in self.missing_matches ]

616N/A

1505N/A if self.illegal:

3158N/A s = _("'{0}' is an illegal fmri")

3158N/A res += [ s.format(p) for p in self.illegal ]

655N/A

838N/A if self.badarch:

3158N/A s = _("'{p}' supports the following architectures: "

3158N/A "{archs}")

3158N/A a = _("Image architecture is defined as: {0}")

3158N/A res += [ s.format(p=self.badarch[0],

3158N/A archs=", ".join(self.badarch[1]))]

3158N/A res += [ a.format(self.badarch[2])]

3158N/A

3158N/A s = _("'{p}' depends on obsolete package '{op}'")

3158N/A res += [ s.format(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]

3158N/A res += ["\t{0}".format(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:")

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

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))])

3158N/A + ": {0}".format(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:

3158N/A res += ["{oldfmri} -> {newfmri}\n".format(

3158N/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:

3158N/A res += [_("Package {pkg} is missing a dependency: "

3158N/A "{dep}").format(

3158N/A pkg=self.missing_dependency[0],

3158N/A dep=self.missing_dependency[1])]

2200N/A if self.nofiles:

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

3158N/A res += ["\t{0}".format(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:")]

3158N/A res += [ "\t{0}".format(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:")]

3158N/A res += [ "\t{0}".format(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.")]

3158N/A res += [ "\t{0}".format(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:

3158N/A s = " {0} {1:d}: {2}".format(_("PUBLISHER"),

3158N/A i, pub)

2339N/A mod = []

2339N/A if not sticky:

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

2339N/A if mod:

3158N/A s += " ({0})".format(",".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

3110N/A if self.no_repo_pubs:

3110N/A res += [_("The following publishers do not have any "

3110N/A "configured package repositories and cannot be "

3110N/A "used in package dehydration or rehydration "

3110N/A "operations:\n")]

3158N/A res += ["\t{0}".format(s) for s in sorted(

3110N/A self.no_repo_pubs)]

3110N/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:

3158N/A s = _("The following packages all deliver {action} "

3158N/A "actions to {kv}:\n").format(**locals())

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

3158N/A s += "\n {0}".format(p)

3347N/A s += _("\n\nThese packages cannot be installed "

3347N/A "together. Any non-conflicting subset\nof "

3347N/A "the above packages can be installed.")

2205N/A else:

2205N/A pfmri = pfmris.pop()

3158N/A s = _("The package {pfmri} delivers multiple copies "

3158N/A "of {action} {kv}").format(**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 "

3158N/A "action types to {0}:\n").format(kv)

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

3158N/A s += "\n {0}:".format(name)

3158N/A s += "".join("\n {0}".format(p) for p in pl)

3347N/A s += _("\n\nThese packages cannot be installed "

3347N/A "together. Any non-conflicting subset\nof "

3347N/A "the above packages can be installed.")

2205N/A else:

2205N/A pfmri = pfmris.pop()

3234N/A types = list_to_lang(list(ad.keys()))

3158N/A s = _("The package {pfmri} delivers conflicting "

3158N/A "action types ({types}) to {kv}").format(**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)

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

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)

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

2205N/A ])

2205N/A

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

3158N/A "multiple actions\nfor {a} '{k}' with conflicting "

3158N/A "attributes:\n\n").format(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:

3158N/A t = _(" {n:d} package delivers '{a}':\n")

2205N/A else:

3158N/A t = _(" {n:d} packages deliver '{a}':\n")

3158N/A s += t.format(n=num, a=action)

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

3158N/A s += _(" {0}\n").format(pkg)

2205N/A else:

3158N/A t = _(" {n:d} packages deliver '{a}', including:\n")

3158N/A s += t.format(n=num, a=action)

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

3158N/A s += _(" {0}\n").format(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:

3347N/A s += _("\n\nThese packages cannot be installed "

3347N/A "together. Any non-conflicting subset\nof "

3347N/A "the above packages can be installed.")

2205N/A

2205N/A return s

2205N/A

3206N/A

3206N/Aclass ImageBoundaryError(ApiException):

3206N/A """Used to indicate that a file is delivered to image dir"""

3206N/A

3206N/A GENERIC = "generic" # generic image boundary violation

3206N/A OUTSIDE_BE = "outside_be" # deliver items outside boot environment

3206N/A RESERVED = "reserved" # deliver items to reserved dirs

3206N/A

3206N/A def __init__(self, fmri, actions=None):

3206N/A """fmri is the package fmri

3206N/A

3206N/A ApiException.__init__(self)

3206N/A self.fmri = fmri

3206N/A generic = _("The following items are outside the boundaries "

3206N/A "of the target image:\n\n")

3206N/A outside_be = _("The following items are delivered outside "

3206N/A "the target boot environment:\n\n")

3206N/A reserved = _("The following items are delivered to "

3206N/A "reserved directories:\n\n")

3206N/A

3206N/A self.message = {

3206N/A self.GENERIC: generic,

3206N/A self.OUTSIDE_BE: outside_be,

3206N/A self.RESERVED: reserved

3206N/A }

3206N/A

3206N/A if actions:

3206N/A self.actions = actions

3206N/A else:

3206N/A self.actions = {}

3206N/A

3206N/A def append_error(self, action, err_type=GENERIC):

3206N/A """This function is used to append errors in the error

3206N/A

3206N/A if action:

3206N/A self.actions.setdefault(err_type, []).append(action)

3206N/A

3206N/A def isEmpty(self):

3206N/A """Return whether error dictionary is empty"""

3206N/A

3206N/A return len(self.actions) == 0

3206N/A

3206N/A def __str__(self):

3206N/A error_list = [self.GENERIC, self.OUTSIDE_BE, self.RESERVED]

3458N/A s = ""

3206N/A for err_type in error_list:

3206N/A if not err_type in self.actions:

3206N/A continue

3206N/A if self.actions[err_type]:

3458N/A if err_type == self.GENERIC:

3458N/A s += ("The package {0} delivers items"

3458N/A " outside the boundaries of"

3458N/A " the target image and can not be"

3458N/A " installed.\n\n").format(self.fmri)

3458N/A elif err_type == self.OUTSIDE_BE:

3458N/A s += ("The package {0} delivers items"

3458N/A " outside the target boot"

3458N/A " environment and can not be"

3458N/A " installed.\n\n").format(self.fmri)

3458N/A else:

3458N/A s += ("The package {0} delivers items"

3458N/A " to reserved directories and can"

3458N/A " not be installed.\n\n").format(self.fmri)

3206N/A s += self.message[err_type]

3206N/A for action in self.actions[err_type]:

3206N/A s += (" {0} {1}\n").format(

3206N/A action.name, action.attrs["path"])

3206N/A return s

3206N/A

3206N/A

3206N/Aclass ImageBoundaryErrors(ApiException):

3206N/A """A container for multiple ImageBoundaryError exception objects

3206N/A

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

3206N/A ApiException.__init__(self)

3206N/A self.__errors = errors

3206N/A

3206N/A generic = _("The following packages deliver items outside "

3206N/A "the boundaries of the target image and can not be "

3206N/A "installed:\n\n")

3206N/A outside_be = _("The following packages deliver items outside "

3206N/A "the target boot environment and can not be "

3206N/A "installed:\n\n")

3206N/A reserved = _("The following packages deliver items to reserved "

3206N/A "directories and can not be installed:\n\n")

3206N/A

3206N/A self.message = {

3206N/A ImageBoundaryError.GENERIC: generic,

3206N/A ImageBoundaryError.OUTSIDE_BE: outside_be,

3206N/A ImageBoundaryError.RESERVED: reserved

3206N/A }

3206N/A

3206N/A def __str__(self):

3206N/A if len(self.__errors) <= 1:

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

3206N/A

3206N/A s = ""

3206N/A for err_type in self.message:

3206N/A cur_errs = []

3206N/A for err in self.__errors:

3206N/A # If err does not contain this error type

3206N/A # we just ignore this.

3206N/A if not err_type in err.actions or \

3206N/A not err.actions[err_type]:

3206N/A continue

3206N/A cur_errs.append(err)

3206N/A

3206N/A if not cur_errs:

3206N/A continue

3206N/A

3206N/A if len(cur_errs) == 1:

3458N/A s += str(cur_errs[0]) + "\n"

3206N/A continue

3206N/A

3206N/A s += self.message[err_type]

3206N/A for err in cur_errs:

3206N/A s += (" {0}\n").format(err.fmri)

3206N/A for action in err.actions[err_type]:

3206N/A s += (" {0} {1}\n").format(

3206N/A action.name, action.attrs["path"])

3206N/A s += "\n"

3206N/A return s

3206N/A

3206N/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

3158N/A return _("{penultimate} and {ultimate}").format(

3158N/A penultimate=l[0],

3158N/A ultimate=l[1]

3158N/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

3158N/A elementtemplate = _("{0}, ")

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

2205N/A # and the ultimate element.

3158N/A listtemplate = _("{list}and {tail}")

3158N/A return listtemplate.format(

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

3158N/A tail=l[-1]

3158N/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"):

3158N/A errno = "[errno {0:d}: {1}]".format(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:

3158N/A details = "{0}: {1}".format(errno, details)

1050N/A

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

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

3158N/A "{action}:\n{details}").format(

3158N/A action=self.action,

3158N/A details=details)

1859N/A elif details:

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

3158N/A "{fmri}:\n{details}").format(fmri=self.fmri,

3158N/A details=details)

1050N/A

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

3158N/A return "{0}{1}".format(errno, details)

1050N/A

1068N/A

3293N/Aclass CatalogOriginRefreshException(ApiException):

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

3293N/A ApiException.__init__(self)

3293N/A self.failed = failed

3293N/A self.total = total

3293N/A self.errmessage = errmessage

3293N/A

3293N/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):

3158N/A return _("The FMRI '{0}' does not contain publisher information "

3158N/A "and cannot be used for catalog operations.").format(

3158N/A 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):

3158N/A return _("Catalog meta_root '{root}' is invalid; unable "

3158N/A "to complete operation: '{op}'.").format(root=self.data,

3158N/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

3158N/A msg += _("\t{fname}: expected mode: {emode}, found "

3158N/A "mode: {fmode}\n").format(fname=fname,

3158N/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):

3158N/A return _("The signature data for the '{0}' catalog file is not "

3158N/A "valid.").format(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 "

3158N/A "update data in '{0}'.").format(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):

3158N/A return _("Unable to perform '{op}' operation for catalog "

3158N/A "{name}; completion would result in a duplicate entry "

3158N/A "for package '{fmri}'.").format(op=self._args.get(

3158N/A "operation", None), name=self._args.get("catalog_name",

3158N/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):

3158N/A return _("Catalog file '{0}' is invalid.\nUse 'pkgrepo rebuild' "

3158N/A "to create a new package catalog.").format(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):

3158N/A return _("The content of the catalog for publisher '{0}' "

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

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

3158N/A "catalog files being provided for the publisher.").format(

3158N/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 "

3158N/A "catalog using the provided catalog update data in '{0}'. "

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

3158N/A "of the catalog and cannot be used.").format(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):

3158N/A return _("'{0}' could not be found in the catalog.").format(

3158N/A 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):

3158N/A return _("Unknown catalog update type '{0}'").format(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):