craft_parts.errors module

Craft parts errors.

exception craft_parts.errors.CallbackRegistrationError(message)

Bases: PartsError

Error in callback function registration.

Parameters:

message (str) – the error message.

exception craft_parts.errors.CopyFileNotFound(name)

Bases: PartsError

An attempt was made to copy a file that doesn’t exist.

Parameters:

name (str) – The file name.

exception craft_parts.errors.CopyTreeError(message)

Bases: PartsError

Failed to copy or link a file tree.

Parameters:

message (str) – The error message.

exception craft_parts.errors.DebError(deb_path, command, exit_code)

Bases: PartsError

A “deb”-related command failed.

Parameters:
exception craft_parts.errors.FeatureError(message, details=None)

Bases: PartsError

A feature is not configured as expected.

Parameters:
exception craft_parts.errors.FileOrganizeError(*, part_name, message)

Bases: PartsError

Failed to organize a file layout.

Parameters:

  • part_name (str) – The name of the part being processed.

  • message (str) – The error message.

classmethod from_merge_conflicts(*, part_name, key, destination, conflicts)

Create from directory merge conflicts.

Parameters:

  • part_name (str) – The name of the part being processed.

  • key (str) – The organize key (source pattern).

  • destination (str) – The organize destination value.

  • conflicts (dict[Path, list[str]]) – A mapping of paths to their conflict descriptions.

Return type:

FileOrganizeError

exception craft_parts.errors.FilesetConflict(conflicting_files)

Bases: PartsError

Inconsistent stage to prime filtering.

Parameters:

conflicting_files (set[str]) – A set containing the conflicting file names.

exception craft_parts.errors.FilesetError(*, name, message)

Bases: PartsError

An invalid fileset operation was performed.

Parameters:

  • name (str) – The name of the fileset.

  • message (str) – The error message.

exception craft_parts.errors.FilesystemMountError(brief, *, details=None, resolution=None)

Bases: PartsError

Errors related to filesystem mounts.

Parameters:
classmethod from_validation_error(*, error_list)

Create a FilesystemMountError from a pydantic error list.

Parameters:

error_list (list[ErrorDetails]) – A list of dictionaries containing pydantic error definitions.

Return type:

FilesystemMountError

exception craft_parts.errors.InvalidAction(message)

Bases: PartsError

An attempt was made to execute an action with invalid parameters.

Parameters:

message (str) – The error message.

exception craft_parts.errors.InvalidApplicationName(name)

Bases: PartsError

The application name contains invalid characters.

Parameters:

name (str) – The invalid application name.

exception craft_parts.errors.InvalidArchitecture(arch_name)

Bases: PartsError

The machine architecture is not supported.

Parameters:

arch_name (str) – The unsupported architecture name.

exception craft_parts.errors.InvalidControlAPICall(*, part_name, scriptlet_name, message)

Bases: PartsError

A control API call was made with invalid parameters.

Parameters:

  • part_name (str) – The name of the part being processed.

  • scriptlet_name (str) – The name of the scriptlet that originated the call.

  • message (str) – The error message.

exception craft_parts.errors.InvalidPartName(part_name)

Bases: PartsError

An operation was requested on a part that’s not in the parts specification.

Parameters:

part_name (str) – The invalid part name.

exception craft_parts.errors.InvalidPlugin(plugin_name, *, part_name)

Bases: PartsError

A request was made to use a plugin that’s not registered.

Parameters:

  • plugin_name (str) – The invalid plugin name.”

  • part_name (str) – The name of the part defining the invalid plugin.

exception craft_parts.errors.OsReleaseCodenameError

Bases: PartsError

Failed to determine the host operating system version codename.

exception craft_parts.errors.OsReleaseIdError

Bases: PartsError

Failed to determine the host operating system identification string.

exception craft_parts.errors.OsReleaseNameError

Bases: PartsError

Failed to determine the host operating system name.

exception craft_parts.errors.OsReleaseVersionIdError

Bases: PartsError

Failed to determine the host operating system version.

exception craft_parts.errors.OverlayPackageNotFound(*, part_name, package_name)

Bases: PartsError

Failed to install an overlay package.

Parameters:

  • part_name (str) – The name of the part being processed.

  • message – the error message.

  • package_name (str)

exception craft_parts.errors.OverlayPermissionError

Bases: PartsError

A project using overlays was processed by a non-privileged user.

exception craft_parts.errors.OverlayPlatformError

Bases: PartsError

A project using overlays was processed on a non-Linux platform.

exception craft_parts.errors.OverlayStageConflict(*, part_name, overlay_part_name, conflicting_files, partition=None)

Bases: PartsError

A conflict between contents to be staged from the overlay and from the build step.

Parameters:
exception craft_parts.errors.PartDependencyCycle(*, part_names=None)

Bases: PartsError

A dependency cycle has been detected in the parts definition.

Parameters:

part_names (list[str] | None) – The names of the parts involved in the cycle.

exception craft_parts.errors.PartFilesConflict(*, part_name, other_part_name, conflicting_files, partition=None)

Bases: PartsError

Different parts list the same files with different contents.

Parameters:

  • part_name (str) – The name of the part being processed.

  • other_part_name (str) – The name of the conflicting part.

  • conflicting_files (list[Path]) – The list of conflicting files.

  • partition (str | None) – Optional name of the partition where the conflict occurred.

exception craft_parts.errors.PartNameConflict(*, part_name, conflicting_part_name)

Bases: PartsError

A part name conflicts with another part name because one is nested inside the other.

Parameters:

  • part_name (str) – The part name being processed.

  • conflicting_part_name (str) – The conflicting part name.

exception craft_parts.errors.PartSpecificationError(*, part_name, message)

Bases: PartsError

A part was not correctly specified.

Parameters:

  • part_name (str) – The name of the part being processed.

  • message (str) – The error message.

classmethod from_validation_error(*, part_name, error_list)

Create a PartSpecificationError from a pydantic error list.

Parameters:

  • part_name (str) – The name of the part being processed.

  • error_list (list[ErrorDetails]) – A list of dictionaries containing pydantic error definitions.

Return type:

PartSpecificationError

exception craft_parts.errors.PartitionError(brief, *, details=None, resolution=None)

Bases: PartsError

Errors related to partitions.

Parameters:
exception craft_parts.errors.PartitionNotFound(partition_name, partitions)

Bases: PartitionUsageError

A partition has been specified that does not exist.

Parameters:

  • partition_name (str) – The name of the partition that does not exist.

  • partitions (Iterable[str]) – Iterable of the names of valid partitions.

exception craft_parts.errors.PartitionUsageError(error_list, partitions, brief=None)

Bases: PartitionError

Error for a list of invalid partition usages.

Parameters:

  • error_list (Iterable[str]) – Iterable of strings describing the invalid usages.

  • partitions (Iterable[str] | None) – Iterable of the names of valid partitions.

  • brief (str | None) – Override brief message.

exception craft_parts.errors.PartitionUsageWarning(warning_list)

Bases: PartitionError, Warning

Warnings for possibly invalid usages of partitions.

Parameters:

warning_list (Iterable[str]) – Iterable of strings describing the misuses.

exception craft_parts.errors.PartsError(brief, details=None, resolution=None, doc_slug=None)

Bases: Exception

Unexpected error.

Parameters:

  • brief (str) – Brief description of error.

  • details (str | None) – Detailed information.

  • resolution (str | None) – Recommendation, if any.

  • doc_slug (str | None) – Reusable documentation slug for consumers adopting the Craft Parts documentation.

property details: str | None

Further details on the error.

exception craft_parts.errors.PluginBuildError(*, part_name, plugin_name, stderr=None)

Bases: UserExecutionError

Plugin build script failed at runtime.

Parameters:

  • part_name (str) – The name of the part being processed.

  • plugin_name (str) – The name of the plugin being processed.

  • stderr (bytes | None) – The contents of the build execution error.

exception craft_parts.errors.PluginCleanError(*, part_name)

Bases: PartsError

Script to clean strict build preparation failed at runtime.

Parameters:

part_name (str) – The name of the part being processed.

exception craft_parts.errors.PluginEnvironmentValidationError(*, part_name, reason)

Bases: PartsError

Plugin environment validation failed at runtime.

Parameters:

  • part_name (str) – The name of the part being processed.

  • reason (str)

exception craft_parts.errors.PluginNotStrict(plugin_name, *, part_name)

Bases: PartsError

A request was made to use a plugin that’s not strict.

Parameters:

  • plugin_name (str) – The plugin name.

  • part_name (str) – The name of the part defining the plugin.

exception craft_parts.errors.PluginPullError(*, part_name)

Bases: PartsError

Plugin pull script failed at runtime.

Parameters:

part_name (str) – The name of the part being processed.

exception craft_parts.errors.ScriptletRunError(*, part_name, scriptlet_name, exit_code, stderr=None)

Bases: UserExecutionError

A scriptlet execution failed.

Parameters:

  • part_name (str) – The name of the part being processed.

  • scriptlet_name (str) – The name of the scriptlet that failed to execute.

  • exit_code (int) – The execution error code.

  • stderr (bytes | None) – The contents of the scriptlet execution error.

exception craft_parts.errors.StageFilesConflict(*, part_name, conflicting_files)

Bases: PartsError

Files from a part conflict with files already being staged.

Parameters:

  • part_name (str) – The name of the part being processed.

  • conflicting_files (list[Path]) – The list of confictling files.

exception craft_parts.errors.StagePackageNotFound(*, part_name, package_name)

Bases: PartsError

Failed to install a stage package.

Parameters:

  • part_name (str) – The name of the part being processed.

  • package_name (str) – The name of the package.

exception craft_parts.errors.UndefinedPlugin(*, part_name)

Bases: PartsError

The part didn’t define a plugin and the part name is not a valid plugin name.

Parameters:

part_name (str) – The name of the part with no plugin definition.

exception craft_parts.errors.UnsupportedBuildAttributesError(unsupported, plugin_name)

Bases: PartsError

Use of build-attributes that a plugin does not support.

Parameters:
exception craft_parts.errors.UserExecutionError(*, brief, resolution, stderr=None)

Bases: PartsError, ABC

Plugin build script failed at runtime.

Parameters:

  • part_name – The name of the part being processed.

  • plugin_name – The name of the plugin being processed.

  • brief (str)

  • resolution (str)

  • stderr (bytes | None)

property details: str | None

Further details on the error.

Displays the last three trace lines from the error output.

exception craft_parts.errors.XAttributeError(key, path, *, is_write=False)

Bases: PartsError

Failed to read or write an extended attribute.

Parameters:

  • action – The action being performed.

  • key (str) – The extended attribute key.

  • path (Path) – The file path.

  • is_write (bool) – Whether this is an attribute write operation.

exception craft_parts.errors.XAttributeTooLong(key, value, path)

Bases: PartsError

Failed to write an extended attribute because key and/or value is too long.

Parameters:

  • key (str) – The extended attribute key.

  • value (str) – The extended attribute value.

  • path (Path) – The file path.