Specfile module

class rebasehelper.specfile.PackageCategory

An enumeration.

R = re.compile('^R-')

haskell = re.compile('^ghc-')

nodejs = re.compile('^nodejs-')

perl = re.compile('^perl-')

php = re.compile('^php-')

python = re.compile('^python[23]?-')

ruby = re.compile('^rubygem-')

rust = re.compile('^rust-')

class rebasehelper.specfile.PatchObject(path, number, strip)

Class represents set of information about patches

get_patch_name()

class rebasehelper.specfile.SpecFile(path: str, sources_location: str = '', predefined_macros: Optional[Dict[str, str]] = None, lookaside_cache_preset: str = 'fedpkg')

Class representing a spec file.

copy(new_path)

Creates a copy of the current object and copies the SPEC file to a new location.

Parameters:new_path (str) – Path to copy the new SPEC file to. Returns:The created SpecFile instance. Return type:SpecFile

download_remote_sources() → None

Downloads sources specified as URL.

expand(s: str, default: str = '') → str

extract_version_from_archive_name(archive_path: str, main_source: str) → str

Extracts version string from source archive name.

Parameters:

• archive_path – Path to the main sources archive.
• main_source – Value of Source0 tag.

Returns:

Extracted version string.

Raises:

RebaseHelperError in case version can’t be determined.

find_archive_target_in_prep(archive)

Tries to find a command that is used to extract the specified archive and attempts to determine target path from it. ‘tar’ and ‘unzip’ commands are supported so far.

Parameters:archive – Path to archive Returns:Target path relative to builddir or None if not determined

get_NVR() → str

get_applied_patches()

Method returns list of all applied patches.

Returns:list of PatchObject

classmethod get_comment_span(line: str, script_section: bool) → Tuple[int, int]

Gets span of a comment depending on the section.

Parameters:

• line – Line to find the comment in.
• script_section – Whether the section the line is in is a shell script.

Returns:

Span of the comment. If no comment is found, both tuple elements are equal to the length of the line for convenient use in a slice.

get_main_files_section()

Finds the exact name of the main %files section.

Returns:Name of the main files section. Return type:str

get_main_source() → str

get_not_used_patches()

Method returns list of all unpplied patches.

Returns:list of PatchObject

get_other_sources() → List[str]

get_patches()

Method returns list of all applied and not applied patches

Returns:list of PatchObject

get_prep_section()

Function returns whole prep section

get_raw_main_source() → str

get_release() → str

Returns release string without %dist

get_setup_dirname()

Get dirname from %setup or %autosetup macro arguments

Returns:dirname

get_sources() → List[str]

static get_subpackage_name(files_section)

Gets subpackage name based on the %files section.

is_test_suite_enabled()

Returns whether test suite is enabled during the build time

Returns:True if enabled or False if not

parse_release() → Tuple[bool, int, Optional[str]]

Parses release string.

Returns:Tuple of is_prerelease, release_number and extra_version. Raises:RebaseHelperError in case release string is not valid.

process_patch_macros(comment_out: Optional[List[int]] = None, remove: Optional[List[int]] = None, annotate: Optional[List[int]] = None, note: Optional[str] = None) → None

Processes %patch macros in %prep section.

Parameters:

• comment_out – List of patch numbers to comment out.
• remove – List of patch numbers to remove.
• annotate – List of patch numbers to annotate.
• note – Message to annotate patches with.

reload()

Reloads the whole Spec file.

save() → None

Saves changes made to SpecContent and updates the internal state.

set_extra_version(extra_version: Optional[str], version_changed: bool) → None

Updates SPEC file with the specified extra version.

Parameters:

• extra_version – Extra version string or None.
• version_changed – Whether version (the value of Version tag) changed.

set_release(release: str, preserve_macros: bool = True) → None

set_version(version: str, preserve_macros: bool = True) → None

static split_version_string(version_string: str, current_version: str) → Tuple[str, Optional[str]]

Splits version string into version and extra version.

Parameters:

• version_string – Complete version string.
• current_version – Current version (the value of Version tag).

Returns:

Tuple of version and extra_version.

Raises:

RebaseHelperError in case passed version string is not valid.

substitute_path_with_macros(path: str, condition: Optional[Callable] = None)

Substitutes parts of a path with macros.

Parameters:

• path – Path to be changed.
• condition – Condition determining if that particular active macro is a suitable substitution.

Returns:

Path expressed using macros.

update() → None

update_changelog(*args, **kwargs)

update_paths_to_sources_and_patches(*args, **kwargs)

update_setup_dirname(*args, **kwargs)

write_updated_patches(*args, **kwargs)

rebasehelper.specfile.get_rebase_name(dir_name, name)

Function returns a name in results directory

Parameters:

• dir_name –
• name –

Returns:

full path to results dir with name

rebasehelper.specfile.saves(func)

Decorator for saving the SpecFile after a method is run.