craft_parts.sources.tar_source module

Implement the tar source handler.

class craft_parts.sources.tar_source.TarSource(source, part_src_dir, *, cache_dir, project_dirs, source_checksum=None, command=None, ignore_patterns=None, **kwargs)

Bases: FileSourceHandler

The tar source handler.

Parameters:

• source (str)

• part_src_dir (Path)

• cache_dir (Path)

• project_dirs (ProjectDirs)

• source_checksum (Optional[str])

• command (Optional[str])

• ignore_patterns (Optional[list[str]])

• kwargs (Any)

provision(dst, keep=False, src=None)

Extract tarball contents to the part source dir.

Parameters:

• dst (Path)

• keep (bool)

• src (Optional[Path])

Return type:

None

source_model

alias of TarSourceModel

class craft_parts.sources.tar_source.TarSourceModel(**data)

Bases: BaseFileSourceModel

Pydantic model for a tar file source.

Parameters:

data (Any)

model_config: ClassVar[ConfigDict] = {'alias_generator': <function get_model_config.<locals>.<lambda>>, 'extra': 'forbid', 'frozen': True, 'json_schema_extra': {'if': {'not': {'required': ['source-type']}}, 'then': {'properties': {'source': {'pattern': '\\.(tar(\\.[a-z0-9]+)?|tgz)$'}}}}}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

pattern: ClassVar[str | None] = '\\.(tar(\\.[a-z0-9]+)?|tgz)$'

A regular expression for inferring this source type.

If pattern is None (the default), the source type cannot be inferred and must always be explicitly written in the source-type field of a part.

source: str

source_checksum: str | None

source_type: Literal['tar']

The name of this source type.

Sources must define this with a type hint of a Literal type of its name and a value of its name.