distgit_directive - download files from distgit¶
New in version 0.3.16.
Download files from Fedora package repository (usually called ‘distgit’) hosted at http://pkgs.fedoraproject.org/. Any files hosted at that repository can be downloaded for a chosen package.
Parameters¶
Parameter | Required | Description | Type | Default | Choices |
---|---|---|---|---|---|
baseurl |
no | The baseurl to use for dist-git. Defaults to Fedora's production instance. Example: https://src.stg.fedoraproject.org |
str |
||
gitref |
no | A git ref to check out. May be a branch, tag, or commit hash. Example: f24 or 04164165a840405e6bb5acc54a51e22346d84e0d |
str |
master |
|
ignore_missing |
no | Ignore 404 error when requested files are missing in distgit |
bool |
False |
|
localpath |
no | a local path of downloaded file. If not provided, path from distgit will be used. Example: [specs/xchat.spec] |
list of str |
||
namespace |
no | dist-git namespace to use when constructing the url to clone. Example: modules, rpms or docker |
str |
rpms |
|
nvr |
yes | N(E)VR of the package build. If you input this, then the package, gitref and namespace parameters will be automatically filled out (by parsing package name, dist tag, and using rpms namespace, respectively), but you can still override those if needed. You need to provide either package or nvr parameter. Example: xchat-2.8.8-32.fc25 |
str |
||
package |
yes | Name of a package. You need to provide either package or nvr parameter. Example: xchat |
str |
||
path |
yes | files (directories not supported at the moment) to be downloaded from distgit. Example: [xchat.spec] |
list of str |
||
target_dir |
yes | directory into which to download files |
str |
Return Values¶
A dictionary containing following items:
- downloaded_files: (list of str) a list of local filenames of the downloaded files
Exceptions¶
TaskotronRemoteError
: if downloading failedTaskotronValueError
: if path and localpath are not lists or are not of the same lengthTaskotronDirectiveError
: if package or path is missing