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

https://src.fedoraproject.org

    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