API

Exceptions

exception pyrpkg.errors.rpkgError

Our base error class

exception pyrpkg.errors.rpkgAuthError

Raised in case of authentication errors

exception pyrpkg.errors.UnknownTargetError

exception pyrpkg.errors.HashtypeMixingError(existing_hashtype, new_hashtype)

Raised when we try to mix hash types in a sources file

exception pyrpkg.errors.MalformedLineError

Raised when parsing a sources file with malformed lines

exception pyrpkg.errors.InvalidHashType

Raised when we don’t know the requested hash algorithm

exception pyrpkg.errors.DownloadError

Raised when something went wrong during a download

exception pyrpkg.errors.UploadError(message, http_status=None)

Raised when something went wrong during an upload

cli

class pyrpkg.cli.cliClient(config, name=None)

This is a client class for rpkg clients.

_get_bool_opt(opt, default=False)

build(sets=None)

chainbuild()

clean()

clog()

clone()

cmd

This is a property for the command attribute

commit()

compile()

container_build()

container_build_koji()

container_build_setup()

copr_build()

diff()

do_imports(site=None)

Import extra stuff not needed during build

As a side effect method sets self.site with a loaded library.

Parameters:site (the module of downstream client that is built on top of rpkg.) – used to specify which library to load.

get_name()

gimmespec()

gitbuildhash()

giturl()

import_srpm()

install()

lint()

load_cmd()

This sets up the cmd object

local()

mock_config()

mockbuild()

module_build()

Builds a module using MBS

module_build_cancel()

Cancel an MBS build

module_build_info()

Show information about an MBS build

module_build_local()

Build a module locally using mbs-manager

module_build_watch()

Watch an MBS build from the command-line

module_get_auth_config()

Get the authentication configuration for the MBS

Returns:a tuple consisting of the authentication method, the OIDC ID provider, the OIDC client ID, the OIDC client secret, and the OIDC scopes. If the authentication method is not OIDC, the OIDC values in the tuple are set to None. Return type:tuple

module_overview()

Show the overview of the latest builds in the MBS

module_validate_config()

Validates the configuration needed for MBS commands

Raises:pyrpkg.errors.rpkgError

module_watch_build(build_id)

Watches the MBS build in a loop that updates every 15 seconds. The loop ends when the build state is failed, done, or ready.

Parameters:build_id (int) – ID of the module build to watch.

name

Property used to identify prog name and key in config file

new()

new_sources()

parse_cmdline(manpage=False)

Parse the commandline, optionally make a manpage

This also sets up self.user

patch()

prep()

pull()

push()

register_build()

Register the build target

register_build_common()

Create a common build parser to use in other commands

register_chainbuild()

Register the chain build target

register_clean()

Register the clean target

register_clog()

Register the clog target

register_clone()

Register the clone target and co alias

register_commit()

Register the commit target and ci alias

register_compile()

Register the compile target

register_container_build()

register_container_build_setup()

register_copr_build()

Register the copr-build target

register_diff()

Register the diff target

register_gimmespec()

Register the gimmespec target

register_gitbuildhash()

Register the gitbuildhash target

register_giturl()

Register the giturl target

register_help()

Register the help command.

register_import_srpm()

Register the import-srpm target

register_install()

Register the install target

register_lint()

Register the lint target

register_local()

Register the local target

register_mock_config()

Register the mock-config target

register_mockbuild()

Register the mockbuild target

register_module_build()

register_module_build_cancel()

register_module_build_info()

register_module_build_watch()

register_module_local_build()

register_module_overview()

register_new()

Register the new target

register_new_sources()

Register the new-sources target

register_patch()

Register the patch target

register_prep()

Register the prep target

register_pull()

Register the pull target

register_push()

Register the push target

register_rpm_common()

Create a common parser for rpm commands

register_scratch_build()

Register the scratch-build target

register_sources()

Register the sources target

register_srpm()

Register the srpm target

register_switch_branch()

Register the switch-branch target

register_tag()

Register the tag target

register_unused_patches()

Register the unused-patches target

register_upload()

Register the upload target

register_verify_files()

Register the verify-files target

register_verrel()

scratch_build()

setupLogging(log)

Setup the various logging stuff.

setup_argparser()

Setup the argument parser and register some basic commands.

setup_subparsers()

Setup basic subparsers that all clients should use

sources()

Download files listed in sources

For command compile, prep, install, local and srpm, files are needed to be downloaded before doing what the command does. Hence, for these cases, sources is not called from command line. Instead, from rpkg inside.

srpm()

switch_branch()

tag()

unused_patches()

upload()

usage()

verify_files()

verrel()

commands

class pyrpkg.__init__.NullHandler(level=0)

Null logger to avoid spurious messages, add a handler in app code

emit(record)

class pyrpkg.__init__.Commands(path, lookaside, lookasidehash, lookaside_cgi, gitbaseurl, anongiturl, branchre, kojiconfig, build_client, koji_config_type='config', user=None, dist=None, target=None, quiet=False, distgit_namespaced=False, realms=None, lookaside_namespaced=False)

This is a class to hold all the commands that will be called by clients

UPLOADEXTS = ['tar', 'gz', 'bz2', 'lzma', 'xz', 'Z', 'zip', 'tff', 'bin', 'tbz', 'tbz2', 'tgz', 'tlz', 'txz', 'pdf', 'rpm', 'jar', 'war', 'db', 'cpio', 'jisp', 'egg', 'gem', 'spkg', 'oxt', 'xpi']

_byte_offset_to_line_number(text, offset)

Convert byte offset (given by e.g. DecodeError) to human readable format (line number and char position)

Returns:a pair of line number and char offset. Return type:list(int, int)

_cleanup_tmp_dir(tmp_dir)

Tries to remove directory and ignores EEXIST error

If occoured directory not exist error (EEXIST) it silently continue. Otherwise raise rpkgError exception.

_clone_config(conf_git, module)

_config_dir_basic(config_dir=None, root=None)

Setup directory with essential mock config

If config directory doesn’t exist it will be created. If temporary directory was created by this method and error occours during processing, temporary directory is removed. Otherwise it caller’s responsibility to remove this directory.

Returns used config directory

_config_dir_other(config_dir, filenames=('site-defaults.cfg', 'logging.ini'))

Populates mock config directory with other necessary files

If files are found in system config directory for mock they are copied to mock config directory defined as method’s argument. Otherwise empty files are created.

_deprecated_read_koji_config()

Read Koji config from Koji configuration files

_fetch_remotes()

_get_build_arches_from_spec()

Given the path to an spec, retrieve the build arches

_get_build_arches_from_srpm(srpm, arches)

Given the path to an srpm, determine the possible build arches

Use supplied arches as a filter, only return compatible arches

_get_namespace_anongiturl(module)

Get the namespaced git url, if DistGit namespaces enabled

Parameters:module (str) – a module name Returns:anonymous giturl with a proper namespace. Return type:str

_get_namespace_giturl(module)

Get the namespaced git url, if DistGit namespaces enabled

Parameters:module (str) – a module name Returns:giturl with proper namespace. Return type:str

_guess_hashtype()

Attempt to figure out the hash type based on branch data

_has_krb_creds()

Kerberos authentication is disabled if neither gssapi nor krbV is available

_list_branches(fetch=True)

Returns a tuple of local and remote branch names

Returns:a pair of local branch names and remote branch names. Return type:tuple(list, list)

_load_krb_user()

This attempts to get the username from active tickets

_newer(file1, file2)

Compare the last modification time of the given files

Returns:True if file1 is newer than file2 Return type:bool

_run_command(cmd, shell=False, env=None, pipe=[], cwd=None)

Run the given command.

_run_command is able to run single command or two commands via pipe. Whatever the way to run the command, output to both stdout and stderr will not be captured and output to terminal directly, that is useful for caller to redirect.

Parameters:

• cmd (str or list) – executable and arguments to run. Depending on argument shell, cmd could be a list if shell is False, and a string if False is passed to shell.
• shell (bool) – whether to run in a shell or not, defaults to False.
• env (dict(str, str)) – environment variables to use (if any)
• pipe (str or list) – command to pipe the output of cmd into. Same as argument cmd, pipe could be a string or list depending on value of shell.
• cwd (str) – optional directory to run the command from

Raises:

rpkgError – any error raised from underlying subprocess while executing command in local system will be mapped to rpkgError.

_srpmdetails(srpm)

Return a tuple of package name, package files, and upload files.

add_tag(tagname, force=False, message=None, file=None)

Add a git tag to the repository

Parameters:

• tagname (str) – tag name.
• force (bool) – Optionally can force the tag, include a message, or reference a message file.
• file (str) – Optional. File containing tag message.

anon_kojisession

This property ensures the anon kojisession attribute

branch_merge

This property ensures the branch attribute

branch_remote

This property ensures the branch_remote attribute

build(skip_tag=False, scratch=False, background=False, url=None, chain=None, arches=None, sets=False, nvr_check=True)

Initiate a build of the module. Available options are:

skip_tag: Skip the tag action after the build

scratch: Perform a scratch build

background: Perform the build with a low priority

url: A url to an uploaded srpm to build from

chain: A chain build set

arches: A set of arches to limit the scratch build for

sets: A boolean to let us know whether or not the chain has sets

nvr_check: A boolean; locally construct NVR and submit a build only if

NVR doesn’t exist in a build system

This function submits the task to koji and returns the taskID

It is up to the client to wait or watch the task.

ca_cert

A CA certificate to authenticate the server in SSL connections

Downstream users of the pyrpkg API should override this property if they actually need to use a CA certificate, usually because their lookaside cache is using HTTPS with a self-signed certificate.

This defaults to None, which means the system CA bundle is used.

cert_file

A client-side certificate for SSL authentication

Downstream users of the pyrpkg API should override this property if they actually need to use a client-side certificate.

This defaults to None, which means no client-side certificate is used.

check_inheritance(build_target, dest_tag)

Check if build tag inherits from dest tag

check_repo(is_dirty=True, has_namespace=True, all_pushed=True)

Check various status of current repository

Parameters:

• is_dirty (bool) – Default to True. To check whether there is uncommitted changes.
• has_namespace (bool) – Default to True. To check whether this repo is checked out with namespace, e.g. rpms/, docker/. If the repo is an old checkout, warn user with message how to fix it.
• all_pushed (bool) – Default to True. To check whether all changes are pushed.

Raises:

rpkgError – if any unexpected status is detected. For example, if changes are not committed yet.

clean(dry=False, useignore=True)

Clean a module checkout of untracked files.

Parameters:

• dry (bool) – Can optionally perform a dry-run. Defaults to False.
• useignore (bool) – Can optionally not use the ignore rules. Defaults to True.

clog(raw=False)

Write the latest spec changelog entry to a clog file

clone(module, path=None, branch=None, bare_dir=None, anon=False, target=None)

Clone a repo, optionally check out a specific branch.

Parameters:

• module (str) – the name of the module to clone
• path (str) – an optional basedir to perform the clone in.
• branch (str) – an optional name of a branch to checkout instead of <remote>/master.
• bare_dir (str) – an optional name of a directory to make a bare clone to if this is a bare clone. None otherwise.
• anon (bool) – whether or not to clone anonymously. Defaults to False.
• target (str) – an optional name of the folder in which to clone the repo.

clone_with_dirs(module, anon=False, target=None)

Clone a repo old style with subdirs for each branch.

Parameters:

• module (str) – name of the module to clone
• anon (bool) – whether or not to clone anonymously. Defaults to False.
• target (str) – an optional name of the folder in which to clone the repo.

commit(message=None, file=None, files=[], signoff=False)

Commit changes to a module (optionally found at path)

Requires the caller be a real tty or a message passed.

Parameters:

• message (str) – an optional message to use as the commit message
• file (str) – an optional file to find the commit message within
• files (list) – an optional list to list files to commit.
• signoff (bool) – signoff commit optionally. Defaults to False.

commithash

This property ensures the commit attribute

compile(arch=None, short=False, builddir=None, nocheck=False)

Run rpmbuild -bc on a module

optionally for a specific arch, or short-circuit it, or define an alternate builddir

Logs the output and returns nothing

construct_build_url(module_name=None, commit_hash=None)

Construct build URL with namespaced anongiturl and commit hash

Parameters:

• module_name (str) – name of the module part of the build URL. If omitted, module name with namespace will be guessed from current repository. The given module name will be used in URL directly without guessing namespace.
• commit_hash (str) – the commit hash appended to build URL. It omitted, the latest commit hash got from current repository will be used.

Returns:

URL built from anongiturl.

Return type:

str

container_build_koji(target_override=False, opts={}, kojiconfig=None, kojiprofile=None, build_client=None, koji_task_watcher=None, nowait=False)

container_build_setup(get_autorebuild=None, set_autorebuild=None)

container_build_target

This property ensures the target for container builds.

copr_build(project, srpm_name, nowait, config_file)

create_koji_session_opts(koji_config)

Create session options from Koji config

delete_tag(tagname)

Delete a git tag from the repository found at optional path

diff(cached=False, files=[])

Execute a git diff

Parameters:

• cached (bool) – optionally diff the cached or staged changes. Defaults to not.
• files (list) – optional list of files to diff relative to the module base directory.

disttag

This property ensures the disttag attribute

distval

This property ensures the distval attribute

distvar

This property ensures the distvar attribute

epoch

This property ensures the epoch attribute

find_untracked_patches()

Find patches that are not tracked by git and sources both

get_base_module(module)

get_latest_commit(module, branch)

Discover the latest commit has for a given module and return it

gitbuildhash(build)

Determine the git hash used to produce a particular N-V-R

giturl()

Return the git url that would be used for building

import_srpm(srpm)

Import the contents of an srpm into a repo.

This function will add/remove content to match the srpm, upload new files to the lookaside, and stage the changes.

Parameters:srpm (str) – file to import contents from. Returns:a list of files to upload. Return type:list

install(arch=None, short=False, builddir=None, nocheck=False)

Run rpm -bi on a module

optionally for a specific arch, short-circuit it, or define an alternative builddir

Logs the output and returns nothing

koji_upload(file, path, callback=None)

Upload a file to koji

file is the file you wish to upload

path is the relative path on the server to upload to

callback is the progress callback to use, if any

Returns nothing or raises

kojisession

This property ensures the kojisession attribute

kojiweburl

This property ensures the kojiweburl attribute

lint(info=False, rpmlintconf=None)

Run rpmlint over a built srpm

Log the output and returns nothing rpmlintconf is the name of the config file passed to rpmlint if specified by the command line argument.

list_tag(tagname='*')

List all tags in the repository which match a given tagname.

Parameters:tagname (str) – an optional shell glob to match part of tags (it is matched with fnmatch). Defaults to ‘*’ to list all tags.

load_branch_merge()

Find the remote tracking branch from the branch we’re on.

The goal of this function is to catch if we are on a branch we can make some assumptions about. If there is no merge point then we raise and ask the user to specify.

load_branch_remote()

Find the name of remote from branch we’re on.

load_commit()

Discover the latest commit to the package

load_container_build_target()

This creates a target based on git branch and namespace.

load_kojisession(anon=False)

Initiate a koji session.

The koji session can be logged in or anonymous

load_localarch()

Get the local arch as defined by rpm

load_mockconfig()

This sets the mockconfig attribute

load_module_name()

Loads a package module.

load_nameverrel()

Set the release of a package module.

load_ns()

Loads the namespace

load_nvr()

This sets the nvr attribute

load_push_url()

Find the pushurl or url of remote of branch we’re on.

load_repo()

Create a repo object from our path

load_rpmdefines()

Populate rpmdefines based on current active branch

load_spec()

This sets the spec attribute

load_target()

This creates the target attribute based on branch merge

load_user()

This sets the user attribute

local(arch=None, hashtype=None, builddir=None)

rpmbuild locally for given arch.

Writes output to a log file and logs it to the logger. Log file is written into current working directory and in format .build-{version}-{release}.log.

Parameters:

• arch (str) – to optionally build for a specific arch.
• hashtype (str) – an alternative algorithm used for payload file digests.
• builddir (str) – an alternative builddir.

Raises:

rpkgError – if underlying rpmbuild fails.

localarch

This property ensures the module attribute

login_koji_session(koji_config, session)

Login Koji session

lookasidecache

A helper to interact with the lookaside cache

Downstream users of the pyrpkg API may override this property with their own, returning their own implementation of a lookaside cache helper object.

Returns:lookaside cache instance providing all the needed stuff to communicate with a Fedora-style lookaside cache. Return type:pyrpkg.lookaside.CGILookasideCache

mock_config(target=None, arch=None)

Generate a mock config based on branch data.

Parameters:

• target (str) – an alternative build target, otherwise default build target will be used.
• arch (str) – an alternative arch, otherwise local system arch will be used.

Returns:

the mock config content got from Koji.

Return type:

str

mock_results_dir

mockbuild(mockargs=[], root=None, hashtype=None)

Build the package in mock, using mockargs

Log the output and returns nothing

mockconfig

This property ensures the mockconfig attribute

module_build_cancel(api_url, build_id, auth_method, oidc_id_provider=None, oidc_client_id=None, oidc_client_secret=None, oidc_scopes=None)

Cancel an MBS build

Parameters:

• api_url (str) – URL of the MBS API
• build_id (int) – build ID to cancel
• auth_method (str) – authentication method used by the MBS
• oidc_id_provider (str) – the OIDC provider when MBS is using OIDC for authentication
• oidc_client_id (str) – the OIDC client ID when MBS is using OIDC for authentication
• oidc_client_secret (str) – the OIDC client secret when MBS is using OIDC for authentication. Based on the OIDC setup, this could be None.
• oidc_scopes (list) – a list of OIDC scopes when MBS is using OIDC for authentication

module_build_info(api_url, build_id)

Show information about an MBS build

Parameters:

• api_url (str) – URL of the MBS API
• build_id (int) – build ID to query MBS about

module_get_build(api_url, build_id)

Get an MBS build :param api_url: a string of the URL of the MBS API :param build_id: an integer of the build ID to query MBS about :return: None or a dictionary representing the module build

static module_get_koji_state_dict()

Get a dictionary of Koji build states with the keys being strings and the values being their associated integer.

Returns:a dictionary of Koji build states Return type:dict

module_get_scm_info(scm_url=None, branch=None)

Determines the proper SCM URL and branch based on the arguments. If the user doesn’t specify an SCM URL and branch, then the git repo the user is currently in is used instead.

Parameters:

• scm_url (str) – a string of the module’s SCM URL
• branch (str) – a string of the module’s branch

Returns:

a tuple containing a string of the SCM URL and a string of the branch

Return type:

tuple

module_get_url(api_url, build_id, action='GET')

Get the proper MBS API URL for the desired action

Parameters:

• api_url (str) – a string of the URL of the MBS API
• build_id (int) – an integer of the module build desired. If this is set to None, then the base URL for all module builds is returned.
• action (str) – a string determining the HTTP action. If this is set to GET, then the URL will contain ?verbose=true. Any other value will not have verbose set.

Returns:

a string of the desired MBS API URL.

Return type:

str

module_local_build(file_path, stream, local_builds_nsvs=None, verbose=False, debug=False, skip_tests=False)

A wrapper for mbs-manager build_module_locally.

Parameters:

• file_path (str) – path of the module’s modulemd yaml file.
• stream (str) – stream of the module.
• local_builds_nsvs (list) – a list of localbuild ids to import into MBS before running this local build.
• skip_tests (bool) – a boolean determining if the check sections should be skipped.
• verbose (bool) – a boolean specifying if mbs-manager should be verbose. This is overridden by self.quiet.
• debug (bool) – a boolean specifying if mbs-manager should be debug. This is overridden by self.quiet and verbose.

module_name

This property ensures the module attribute

module_overview(api_url, limit=10, finished=True)

Show the overview of the latest builds in MBS

Parameters:

• api_url (str) – a string of the URL of the MBS API
• limit (int) – an integer of the number of most recent module builds to display. This defaults to 10.
• finished (bool) – a boolean that determines if only finished or unfinished module builds should be displayed. This defaults to True.

module_send_authorized_request(verb, url, body, auth_method, oidc_id_provider=None, oidc_client_id=None, oidc_client_secret=None, oidc_scopes=None, **kwargs)

Sends authorized request to MBS

Parameters:

• verb (str) – a string of the HTTP verb of the request (e.g. POST)
• url (str) – a string of the URL to make the request on.
• body (dict) – a dictionary of the data to send in the authorized request.
• auth_method (str) – a string of the authentication method used by the MBS. Valid methods are oidc and kerberos.
• oidc_id_provider (str) – a string of the OIDC provider when MBS is using OIDC for authentication
• oidc_client_id (str) – a string of the OIDC client ID when MBS is using OIDC for authentication
• oidc_client_secret (str) – a string of the OIDC client secret when MBS is using OIDC for authentication. Based on the OIDC setup, this could be None.
• oidc_scopes (list) – a list of OIDC scopes when MBS is using OIDC for authentication
• kwargs – any additional python-requests keyword arguments.

Returns:

a python-requests response object

module_submit_build(api_url, scm_url, branch, auth_method, optional=None, oidc_id_provider=None, oidc_client_id=None, oidc_client_secret=None, oidc_scopes=None)

Submit a module build to the MBS

Parameters:

• api_url (str) – URL of the MBS API
• scm_url (str) – module’s SCM URL
• branch (str) – module’s branch
• auth_method (str) – authentication method used by the MBS. For valid methods, refer to module_send_authorized_request()
• optional (list) – an optional list of key=value to be passed in with the MBS build submission
• oidc_id_provider (str) – the OIDC provider when MBS is using OIDC for authentication
• oidc_client_id (str) – the OIDC client ID when MBS is using OIDC for authentication
• oidc_client_secret (str) – the OIDC client secret when MBS is using OIDC for authentication. Based on the OIDC setup, this could be None.
• oidc_scopes (list) – a list of OIDC scopes when MBS is using OIDC for authentication

module_watch_build(api_url, build_id)

Watches the MBS build in a loop that updates every 15 seconds. The loop ends when the build state is ‘failed’, ‘done’, or ‘ready’.

Parameters:

• api_url (str) – URL of the MBS API
• build_id (int) – module build to watch.

new()

Return changes in a repo since the last tag

ns

This property provides the namespace of the module

ns_module_name

nvr

This property ensures the nvr attribute

osbs_config_filename

password

This property ensures the password attribute

patch(suffix, rediff=False)

Generate a patch from the expanded source and add it to index

suffix: Look for files named with this suffix to diff rediff: optionally retain any comments in the patch file and rediff

Will create a patch file named name-version-suffix.patch

path

prep(arch=None, builddir=None)

Run rpmbuild -bp on a module

Parameters:

• arch (str) – optional to run prep section for a specific arch. By default, local system arch will be used.
• builddir (str) – an alternative builddir.

pull(rebase=False, norebase=False)

Pull changes from the remote repository

Optionally rebase current branch on top of remote branch

Optionally override .git setting to always rebase

push(force=False)

Push changes to the remote repository

push_url

This property ensures the push_url attribute

read_koji_config()

Read Koji config from Koji configuration files or profile

rel

This property ensures the rel attribute

repo

This property ensures the repo attribute

rpmdefines

This property ensures the rpm defines

runas

This property ensures the runas attribute

sources(outdir=None)

Download source files

sources_filename

spec

This property ensures the module attribute

srpm(hashtype=None)

Create an srpm using hashtype from content in the module

Requires sources already downloaded. The generated SRPM file will be put into package repository directory.

Parameters:hashtype (str) – an alternative algorithm used for payload file digests.

switch_branch(branch, fetch=True)

Switch the working branch

Will create a local branch if one doesn’t already exist, based on <remote>/<branch>

Logs output and returns nothing.

target

This property ensures the target attribute

topurl

This property ensures the topurl attribute

unused_patches()

Discover patches checked into source control that are not used

Returns:a list of unused patches, which may be empty. Return type:list

upload(files, replace=False)

Upload source file(s) in the lookaside cache

Both file sources and .gitignore will be updated with uploaded files, and added to index tree eventually.

Parameters:

• files (iterable) – an iterable of files to upload.
• replace (bool) – optionally replace the existing tracked sources. Defaults to False.

Raises:

rpkgError – if failed to add a file to file sources.

user

This property ensures the user attribute

ver

This property ensures the ver attribute

verify_files(builddir=None)

Run rpmbuild -bl on a module to verify the %files section

Parameters:builddir (str) – optionally define an alternate builddir.

Lookaside

class pyrpkg.lookaside.CGILookasideCache(hashtype, download_url, upload_url, client_cert=None, ca_cert=None)

A class to interact with a CGI-based lookaside cache

download(name, filename, hash, outfile, hashtype=None, **kwargs)

Download a source file

Parameters:

• name (str) – The name of the module. (usually the name of the SRPM). This can include the namespace as well (depending on what the server side expects).
• filename (str) – The name of the file to download.
• hash (str) – The known good hash of the file.
• outfile (str) – The full path where to save the downloaded file.
• hashtype (str) – Optional. The hash algorithm. (e.g ‘md5’) This defaults to the hashtype passed to the constructor.
• kwargs – Additional keyword arguments. They will be used when constructing the full URL to the file to download.

file_is_valid(filename, hash, hashtype=None)

Ensure the file is correct

Parameters:

• filename (str) – The full path to the file. It is assumed to exist.
• hash (str) – The known good hash of the file.
• hashtype (str) – Optional. The hash algorithm to use. (e.g ‘md5’) This defaults to the hashtype passed to the constructor.

Returns:

True if the file is valid, False otherwise.

Return type:

bool

hash_file(filename, hashtype=None)

Compute the hash of a file

Parameters:

• filename (str) – The full path to the file. It is assumed to exist.
• hashtype (str) – Optional. The hash algorithm to use. (e.g ‘md5’) This defaults to the hashtype passed to the constructor.

Returns:

The hash digest.

print_progress(to_download, downloaded, to_upload, uploaded)

raise_upload_error(http_status)

remote_file_exists(name, filename, hash)

Verify whether a file exists on the lookaside cache

Parameters:

• name (str) – The name of the module. (usually the name of the SRPM). This can include the namespace as well (depending on what the server side expects).
• filename (str) – The name of the file to check for.
• hash (str) – The known good hash of the file.

upload(name, filepath, hash)

Upload a source file

Parameters:

• name (str) – The name of the module. (usually the name of the SRPM) This can include the namespace as well (depending on what the server side expects).
• filepath (str) – The full path to the file to upload.
• hash (str) – The known good hash of the file.

Sources

class pyrpkg.sources.SourcesFile(sourcesfile, entry_type, replace=False)

add_entry(hashtype, file, hash)

parse_line(line)

write()

class pyrpkg.sources.SourceFileEntry(hashtype, file, hash)

class pyrpkg.sources.BSDSourceFileEntry(hashtype, file, hash)

gitignore

class pyrpkg.gitignore.GitIgnore(path)

A class to manage a .gitignore file

add(line)

Add a line

Parameters:line (str) – The line to add to the file. It will not be added if it already matches an existing line.

match(line)

Check whether the line matches an existing one

This uses fnmatch to match against wildcards.

Parameters:line (str) – The new line to match against existing ones. Returns:True if the new line matches, False otherwise. Return type:bool

write()

Write the file to the disk

This will only actually write if necessary, that is if lines have been added since the last time the file was written.

Utilities

class pyrpkg.utils.cached_property

A property caching its return value

This is pretty much the same as a normal Python property, except that the decorated function is called only once. Its return value is then saved, subsequent calls will return it without executing the function any more.

Example:

>>> class Foo(object):
...     @cached_property
...     def bar(self):
...         print("Executing Foo.bar...")
...         return 42
...
>>> f = Foo()
>>> f.bar
Executing Foo.bar...
42
>>> f.bar
42

pyrpkg.utils.warn_deprecated(clsname, oldname, newname)

Emit a deprecation warning

Parameters:

• clsname (str) – The name of the class which has its attribute deprecated.
• oldname (str) – The name of the deprecated attribute.
• newname (str) – The name of the new attribute, which should be used instead.

pyrpkg.utils._log_value(log_func, value, level, indent, suffix='')

pyrpkg.utils.log_result(log_func, result, level=0, indent=2)