Current File : //usr/lib64/python3.6/site-packages/librepo/__init__.py
# librepo - A library providing (libcURL like) API to downloading repository
# Copyright (C) 2012-2014 Tomas Mlcoch
#
# Licensed under the GNU Lesser General Public License Version 2.1
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
#
"""
Version contants
----------------
.. data:: VERSION_MAJOR
VERSION_MINOR
VERSION_PATCH
VERSION
Constants with version numbers and whole version string.
.. _handle-options-label:
:class:`~.Handle` options
-------------------------
**LRO_** (aka LibRepo Option) prefixed constants are used to set
:class:`.Handle` options via :meth:`~.Handle.setopt` method.
This options could be also set by :class:`.Handle` attributes
with the same names but in lowercase and without ``LRO_`` prefix.
Example::
# The command:
h.setopt(librepo.LRO_URLS, ["http://ftp.linux.ncsu.edu/pub/fedora/linux/releases/17/Everything/i386/os/"])
# is equivalent to:
h.urls = ["http://ftp.linux.ncsu.edu/pub/fedora/linux/releases/17/Everything/i386/os/"]
.. note:: For detailed description of this options consult :class:`.Handle` page.
.. data:: LRO_UPDATE
*Boolean*. Set to ``True`` if only want update localised or downloaded
repository represented by :class:`.Result` object. Update mode is
meant to download previously omitted repository file(s).
.. data:: LRO_URLS
*List or None*. Set repository urls (repository url and baseurl
are interchangeable terms in this context).
.. data:: LRO_MIRRORLIST
*String or None*. **DEPRECATED** Set mirrorlist url (url could point
to a metalink mirrorlist or to a simple mirrorlist where each line without
``'#'`` is considered as mirror url).
.. data:: LRO_MIRRORLISTURL
*String or None*. Mirrorlist URL.
.. data:: LRO_METALINKURL
*String or None*. Metalink URL.
.. data:: LRO_LOCAL
*Boolean*. If set to True, no local copy of repository is created
and repository is just localized in its current location.
When True, url of repository MUST be a local address
(e.g. '/home/user/repo' or 'file:///home/user/repo').
.. data:: LRO_HTTPAUTH
*Boolean*. If True, all supported methods of HTTP authentication
are enabled.
.. data:: LRO_USERPWD
*String or None*. Set username and password for HTTP authentication.
Param must be in format 'username:password'.
.. data:: LRO_PROXY
*String or None*. Set proxy server address. Port could be
specified by different option or by the :[port] suffix of
this address. Any protocol prefix (``http://``, ...) will be ignored.
.. data:: LRO_PROXYPORT
*Integer or None*. Set proxy port number to connect unless
it is specified in the proxy address string. None sets default
value 1080.
.. data:: LRO_PROXYTYPE
*Long*. Set type of proxy - could be one of :ref:`proxy-type-label`
.. data:: LRO_PROXYAUTH
*Boolean*. If True, all supported proxy authentication methods are enabled.
If False, only basic authentication method is enabled.
.. data:: LRO_PROXYUSERPWD
*String or None*. Set username and password for proxy
authentication in format 'username:password'.
.. data:: LRO_PROGRESSCB
*Function or None*. (See: :ref:`callback-progresscb-label`)
Set progress callback. Callback must be in format:
``callback(userdata, total_to_download, downloaded)``. If
total_to_download is 0, then total size is not known.
Total size (total_to_download) could change (grow) among two callback
calls (if some download failed and another mirror is tried).
.. data:: LRO_PROGRESSDATA
*Any object*. Set user data for the progress callback.
.. data:: LRO_MAXSPEED
*Long or None*. Set maximal allowed speed per download in bytes per second.
0 = unlimited speed - the default value.
.. data:: LRO_DESTDIR
*String or None*. Set destination directory for downloaded data
(metadata or packages).
.. data:: LRO_REPOTYPE
*Integer*. One of :ref:`repotype-constants-label`. See more
:meth:`~.Handle.repotype` Set type of repository.
.. data:: LRO_CONNECTTIMEOUT
*Integer or None. Set maximal timeout in sec for connection phase.
Default value is 30. None as *val* sets the default value.
.. data:: LRO_IGNOREMISSING
*Boolean*. If you want to localize (LRO_LOCAL is True) a incomplete local
repository (eg. only primary and filelists are present but repomd.xml
contains more files), you could use LRO_YUMDLIST and specify only file
that are present, or use LRO_YUMBLIST and specify files that are not
present or use this option.
.. data:: LRO_INTERRUPTIBLE
*Boolean*. Librepo sets up its own SIGTERM handler. If the SIGTERM signal
is catched, the current download is interrupted.
.. data:: LRO_USERAGENT
*String*. String for User-Agent: header in the http request sent
to the remote server.
.. data:: LRO_FETCHMIRRORS
*Boolean*. With this option enabled, only mirrorlist download and parsing
will be performed during :meth:`librepo.Handle.perform`.
.. data:: LRO_MAXMIRRORTRIES
*Integer or None*. If download fails, try at most the specified number
of mirrors. 0 (None) means try all available mirrors.
.. data:: LRO_MAXPARALLELDOWNLOADS
*Integer or None*. Maximum number of parallel downloads.
``None`` sets default value.
.. data:: LRO_MAXDOWNLOADSPERMIRROR
*Integer or None*. Maximum number of parallel downloads per mirror.
``None`` sets default value.
.. data:: LRO_VARSUB
*[(String, String), ...] or None*. Set list of substitutions
for variables in ulrs (e.g.: "http://foo/$version/").
``[("releasever", "f18"), ("basearch", "i386")]``
.. data:: LRO_FASTESTMIRROR
*Boolean*. If True, internal mirrorlist is sorted
by the determined connection speed, after it is constructed.
.. data:: LRO_FASTESTMIRRORCACHE
*String or None*. Path to the cache file. If cache file it doesn't exists
it will be created.
.. data:: LRO_FASTESTMIRRORMAXAGE
*Integer or None*. Max age of cache record. Older records will not be used.
.. data:: LRO_FASTESTMIRRORCB
*Function or None*. (See: :ref:`callback-fastestmirrorcb-label`)
Fastest mirror status callback.
Its prototype looks like ``callback(userdata, stage, data)``
Where *userdata* are data passed by user via LRO_FASTESTMIRRORDATA.
*stage* is value from
:ref:`fastestmirror-stages-constants-label`. *data* value depends
on *stage* value. See the list of available stages.
.. data:: LRO_FASTESTMIRRORDATA
*Any object*. User data for fastest mirror status callback.
.. data:: LRO_LOWSPEEDTIME
*Integer or None*. The time in seconds that the transfer should be below
the LRO_LOWSPEEDLIMIT for the library to consider it too slow and abort.
Default: 30 (sec)
.. data:: LRO_LOWSPEEDLIMIT
*Integer or None*. The transfer speed in bytes per second that
the transfer should be below during LRO_LOWSPEEDTIME seconds for
the library to consider it too slow and abort. Default: 1000 (byte/s)
.. data:: LRO_GPGCHECK
*Boolean*. Set True to enable gpg check (if available) of downloaded repo.
.. data:: LRO_CHECKSUM
*Boolean*. Set False/True to disable/enable checksum check.
.. note:: Checksum check is enabled by default.
.. note::
If checksum check is disabled, then even explicitly specified
checksum related params e.g. in :meth:`~librepo.Handle.download`
method are ignored and checksum is not checked!
.. data:: LRO_YUMDLIST
*List of strings*. Some predefined list :ref:`predefined-yumdlists-label`.
Set list of yum metadata files to download. e.g. ``["primary",
"filelists", "other", "primary_db", "prestodelta"]`` If *val* is None,
all metadata files will be downloaded. If *val* is ``[]`` or ``[None]``
only ``repomd.xml`` will be downloaded.
.. data:: LRO_YUMSLIST
*[(String, String), ...] or None*. Set list of substitutions
for repomd records.
``[("group_gz", "group")]`
.. data:: LRO_RPMMDDLIST
See LRO_YUMDLIST
.. data:: LRO_YUMBLIST
*List of strings*. Set skiplist of yum metadata files.
This files will not be downloaded.
.. data:: LRO_RPMMDBLIST
See LRO_YUMBLIST
.. data:: LRO_HMFCB
*Function or None* (See: :ref:`callback-handlemirrorfailurecb-label`)
The Handle Mirror Failure Callback is called
when a metadata download fails. It provides
a detailed information about what exactly failed.
Call of this callback doesn't mean that whole downloading failed.
If there are other mirrors on the list, these mirrors will be tried.
.. data:: LRO_SSLVERIFYPEER
*Boolean*. This option determines whether librepo verifies the
authenticity of the peer's certificate. This trust is based on a chain
of digital signatures, rooted in certification authority
(CA) certificates.
.. data:: LRO_SSLVERIFYSTATUS
*Boolean*. This option determines whether librepo verifies the status
of the server cert using the 'Certificate Status Request' TLS extension
(aka. OCSP stapling).
Note that if this option is enabled but the server does not support
the TLS extension, the verification will fail. */
.. data:: LRO_SSLVERIFYHOST
*Boolean*. This option determines whether librepo verifies that
the server cert is for the server it is known as.
.. data:: LRO_SSLCLIENTCERT
*String or None*. Path to the PEM format SSL client certificate to use
when talking to the server.
.. data:: LRO_SSLCLIENTKEY
*String or None*. Path to the PEM format SSL client key to use when
talking to the server.
.. data:: LRO_SSLCACERT
*String or None*. Path to a file containing the list of PEM format
trusted CA certificates.
.. data:: LRO_PROXY_SSLVERIFYPEER
*Boolean*. This option determines whether librepo verifies the
authenticity of the proxy certificate. This trust is based on a chain
of digital signatures, rooted in certification authority
(CA) certificates.
.. data:: LRO_PROXY_SSLVERIFYHOST
*Boolean*. This option determines whether librepo verifies
the name of the proxy certificate against the host.
.. data:: LRO_PROXY_SSLCLIENTCERT
*String or None*. Path to the PEM format SSL client certificate to use
when talking to the proxy.
.. data:: LRO_PROXY_SSLCLIENTKEY
*String or None*. Path to the PEM format SSL client key to use when
talking to the proxy.
.. data:: LRO_PROXY_SSLCACERT
*String or None*. Path to a file containing the list of PEM format
trusted CA certificates. Used for proxy.
.. data:: LRO_IPRESOLVE
*Integer or None* Sets kind of IP addresses to use when resolving host
names. Could be one of: :ref:`ipresolve-type-label`
.. data:: LRO_ALLOWEDMIRRORFAILURES
*Integer or None* If all transfers from a mirror failed (no successful transfer
from the mirror exists) and the number
of failed downloads is higher or equal to this value
the mirror will be skipped (ignored) for all next downloads.
**Note:** Number of failed transfers for a single mirror can
outreach this number! For example, if you set this value to 1
but you allow 3 parallel downloads it is possible that all
three downloads start from the mirror,
before any of them can fail. Then, if all three transfers
fail, the number of failures for the mirror
will be 3, even if this option was set to 1.
.. data:: LRO_ADAPTIVEMIRRORSORTING
*Integer or None* If enabled, internal list of mirrors for each
handle is re-sorted after each finished transfer.
The the sorting is based on mirror error rate etc.
.. data:: LRO_GNUPGHOMEDIR
*String or None* set own GNUPG configuration directory (a dir with keyring).
.. data:: LRO_FASTESTMIRRORTIMEOUT
*Float of None* Max length of fastest mirror measurement in seconds.
Default value is 2.0sec.
.. data:: LRO_HTTPHEADER
*List of strings or None* List of strings that represent http headers.
Each header has format "header_name: content". If you add a header
with no content as in 'Accept:' (no data on the right side of the colon),
the internally used header will get disabled. With this option you can
add new headers, replace internal headers and remove internal headers.
To add a header with no content (nothing to the right side of the colon),
use the form 'MyHeader;' (note the ending semicolon).
Note: Headers must not be CRLF-terminated!
.. data:: LRO_OFFLINE
*Boolean* Make the handle work only locally, all remote URLs are
ignored. Remote mirrorlists/metalinks (if they are specified)
are ignored. Fastest mirror check (if enabled) is skiped.
.. data:: LRO_HTTPAUTHMETHODS
*Long (bitmask)* Bitmask which tell Librepo which auth metods to use.
See: :ref:`auth-methods-label`
.. data:: LRO_PROXYAUTHMETHODS
*Long (bitmask)* Bitmask which tell Librepo which auth metods to use
for proxy authentication.
See: :ref:`auth-methods-label`
.. data:: LRO_FTPUSEEPSV
*Boolean* Enable/Disable EPSV (Extended Passive mode) for FTP.
.. data:: LRO_PRESERVETIME
*Boolean* If enabled, librepo will try to keep timestamps of the downloaded files
in sync with that on the remote side.
.. _handle-info-options-label:
:class:`~.Handle` info options
------------------------------
LRI (aka LibRepo Information) constants are used to get information
from :class:`.Handle` via :meth:`~.Handle.getinfo` method.
.. data:: LRI_UPDATE
.. data:: LRI_URLS
.. data:: LRI_MIRRORLIST
.. data:: LRI_MIRRORLISTURL
.. data:: LRI_METALINKURL
.. data:: LRI_LOCAL
.. data:: LRI_PROGRESSCB
.. data:: LRI_PROGRESSDATA
.. data:: LRI_DESTDIR
.. data:: LRI_REPOTYPE
.. data:: LRI_USERAGENT
.. data:: LRI_YUMDLIST
.. data:: LRI_YUMSLIST
.. data:: LRI_RPMMDDLIST
.. data:: LRI_YUMBLIST
.. data:: LRI_RPMMDBLIST
.. data:: LRI_FETCHMIRRORS
.. data:: LRI_MAXMIRRORTRIES
.. data:: LRI_VARSUB
.. data:: LRI_MIRRORS
.. data:: LRI_METALINK
.. data:: LRI_FASTESTMIRROR
.. data:: LRI_FASTESTMIRRORCACHE
.. data:: LRI_FASTESTMIRRORMAXAGE
.. data:: LRI_HMFCB
.. data:: LRI_SSLVERIFYPEER
.. data:: LRI_SSLVERIFYSTATUS
.. data:: LRI_SSLVERIFYHOST
.. data:: LRI_SSLCLIENTCERT
.. data:: LRI_SSLCLIENTKEY
.. data:: LRI_SSLCACERT
.. data:: LRI_PROXY_SSLVERIFYPEER
.. data:: LRI_PROXY_SSLVERIFYHOST
.. data:: LRI_PROXY_SSLCLIENTCERT
.. data:: LRI_PROXY_SSLCLIENTKEY
.. data:: LRI_PROXY_SSLCACERT
.. data:: LRI_IPRESOLVE
.. data:: LRI_ALLOWEDMIRRORFAILURES
.. data:: LRI_ADAPTIVEMIRRORSORTING
.. data:: LRI_GNUPGHOMEDIR
.. data:: LRI_FASTESTMIRRORTIMEOUT
.. data:: LRI_HTTPHEADER
.. data:: LRI_OFFLINE
.. data:: LRI_HTTPAUTHMETHODS
.. data:: LRI_PROXYAUTHMETHODS
.. data:: LRI_FTPUSEEPSV
.. _proxy-type-label:
Proxy type constants
--------------------
.. data:: PROXY_HTTP (LR_PROXY_HTTP)
.. data:: PROXY_HTTP_1_0 (LR_PROXY_HTTP_1_0)
.. data:: PROXY_SOCKS4 (LR_PROXY_SOCKS4)
.. data:: PROXY_SOCKS5 (LR_PROXY_SOCKS5)
.. data:: PROXY_SOCKS4A (LR_PROXY_SOCKS4A)
.. data:: PROXY_SOCKS5_HOSTNAME (LR_PROXY_SOCKS5_HOSTNAME)
.. _ipresolve-type-label:
Supported IP resolving
----------------------
.. data:: IPRESOLVE_WHATEVER
Default value, resolves addresses to all IP versions that
your system allows.
.. data:: IPRESOLVE_V4
Resolve to IPv4 addresses.
.. data:: IPRESOLVE_V6
Resolve to IPv6 addresses.
.. _repotype-constants-label:
Repo type constants
-------------------
.. data:: RPMMDREPO (LR_RPMMDREPO)
Classical repository in repo-md format with ``repodata/`` directory.
.. data:: YUMREPO (LR_YUMREPO)
See RPMMDREPO
.. data:: SUSEREPO (LR_SUSEREPO)
YaST2 repository (http://en.opensuse.org/openSUSE:Standards_YaST2_Repository_Metadata_content).
.. note:: This option is not supported yet!
.. data:: DEBREPO (LR_DEBREPO)
Debian repository
.. note:: This option is not supported yet!
.. _predefined-yumdlists-label:
Predefined yumdlist lists
-------------------------
.. data:: RPMMD_FULL (YUM_FULL, LR_YUM_FULL)
Download all repodata files
.. data:: RPMMD_REPOMDONLY (YUM_REPOMDONLY, LR_YUM_REPOMDONLY)
Download only repomd.xml file
.. data:: RPMMD_BASEXML (YUM_BASEXML, LR_YUM_BASEXML)
Download only primary.xml, filelists.xml and other.xml
.. data:: RPMMD_BASEDB (YUM_BASEDB, LR_YUM_BASEDB)
Download only primary, filelists and other databases.
.. data:: RPMMD_HAWKEY (YUM_HAWKEY, LR_YUM_HAWKEY)
Download only files used by Hawkey (https://github.com/akozumpl/hawkey/).
(primary, filelists, prestodelta)
.. _auth-methods-label:
Auth methods
------------
Supported auth methods for :data:`~.LRO_HTTPAUTHMETHODS` and
:data:`~.LRO_PROXYAUTHMETHODS` options.
.. data:: LR_AUTH_NONE
No auth method enabled.
.. data:: LR_AUTH_BASIC
HTTP Basic authentication (Default).
.. data:: LR_AUTH_DIGEST
HTTP Digest authentication.
.. data:: LR_AUTH_NEGOTIATE
HTTP Negotiate (SPNEGO) authentication.
.. data:: LR_AUTH_NTLM
HTTP NTLM authentication.
.. data:: LR_AUTH_DIGEST_IE
HTTP Digest authentication with an IE flavor.
.. data:: LR_AUTH_NTLM_WB
NTLM delegating to winbind helper.
.. data:: LR_AUTH_ONLY
This is a meta symbol. OR this value
together with a single specific auth
value to force libcurl to probe for
un-restricted auth and if not, only
that single auth algorithm is
acceptable.
.. data:: LR_AUTH_ANY
All suitable methods.
.. _fastestmirror-stages-constants-label:
Fastest mirror stages
---------------------
Values used by fastest mirror callback (:data:`~.LRO_FASTESTMIRRORCB`):
.. data:: FMSTAGE_INIT
(0) Fastest mirror detection just started. *data* is None.
.. data:: FMSTAGE_CACHELOADING
(1) Cache file is specified. *data* is path to the cache file.
.. data:: FMSTAGE_CACHELOADINGSTATUS
(2) Cache loading finished. If successful, *data* is None, otherwise
*data* is string with error message.
.. data:: FMSTAGE_DETECTION
(3) Detection in progress. *data* is number of mirrors that will be pinged.
If all times were loaded from cache, this stage is skiped.
.. data:: FMSTAGE_FINISHING
(4) Detection is done, sorting mirrors, updating cache, etc.
*data* is None.
.. data:: FMSTAGE_STATUS
(5) The very last invocation of fastest mirror callback.
If fastest mirror detection was successful *data*,
otherwise *data* contain string with error message.
.. _error-codes-label:
Error codes
-----------
LibRepo Error codes.
.. data:: LRE_OK
(0) Everything is ok.
.. data:: LRE_BADFUNCARG
(1) Bad function argument(s).
.. data:: LRE_BADOPTARG
(2) Bad argument for the option in :meth:`~.Handle.setopt`.
.. data:: LRE_UNKNOWNOPT
(3) Unknown option.
.. data:: LRE_CURLSETOPT
(4) cURL doesn't know an option used by librepo. Probably
too old cURL version is used.
.. data:: LRE_ALREADYUSEDRESULT
(5) :class:`.Result` object is not "clean" (it has been already used).
.. data:: LRE_INCOMPLETERESULT
(6) :class:`.Result` object doesn't contain all what is needed.
.. data:: LRE_CURLDUP
(7) Cannot duplicate cURL handle. No free memory?
.. data:: LRE_CURL
(8) A cURL error.
.. data:: LRE_CURLM
(9) A multi cURL handle error.
.. data:: LRE_BADSTATUS
(10) Error HTTP or FTP status code.
.. data:: LRE_TEMPORARYERR
(11) An error that should be temporary (e.g. HTTP status codes 500, 502-504, ..)
.. data:: LRE_NOTLOCAL
(12) URL is not a local address.
E.g. in case when :data:`~.LRO_UPDATE` option is ``True`` and URL
is a remote address.
.. data:: LRE_CANNOTCREATEDIR
(13) Cannot create directory for downloaded data. Bad permission?
.. data:: LRE_IO
(14) Input/Output error.
.. data:: LRE_MLBAD
(15) Bad mirrorlist or metalink file. E.g. metalink doesn't contain
reference to target file (repomd.xml), mirrorlist is empty, ..
.. data:: LRE_MLXML
(16) Cannot parse metalink xml. Non-valid metalink file?
E.g. (metalink doesn't contain needed
file, mirrorlist doesn't contain urls, ..)
.. data:: LRE_BADCHECKSUM
(17) Bad checksum.
.. data:: LRE_REPOMDXML
(18) Cannot parse repomd.xml file. Non-valid repomd.xml file?
.. data:: LRE_NOURL
(19) No usable URL found. E.g. bad links or no links in metalink.
.. data:: LRE_CANNOTCREATETMP
(20) Cannot create temporary directory.
.. data:: LRE_UNKNOWNCHECKSUM
(21) Unknown type of checksum is needed for verification of one
or more files.
.. data:: LRE_BADURL
(22) Bad URL specified.
.. data:: LRE_GPGNOTSUPPORTED
(23) OpenPGP protocol is not supported.
.. data:: LRE_GPGERROR
(24) GPG error.
.. data:: LRE_BADGPG
(25) Bad GPG signature.
.. data:: LRE_INCOMPLETEREPO
(26) Repository metadata are not complete.
.. data:: LRE_INTERRUPTED
(27) Download was interrupted by SIGTERM signal.
.. data:: LRE_SIGACTION
(28) Sigaction system call failed.
.. data:: LRE_ALREADYDOWNLOADED
(29) The file is already downloaded and its checksum matches.
.. data:: LRE_UNFINISHED
(30) Download wasn't (or cannot be) finished.
.. data:: LRE_SELECT
(31) select() call failed.
.. data:: LRE_OPENSSL
(32) OpenSSL library related error.
.. data:: LRE_MEMORY
(33) Cannot allocate more memory.
.. data:: LRE_XMLPARSER
(34) XML parser error.
.. data:: LRE_CBINTERRUPTED
(35) Interrupted by user cb.
.. data:: LRE_UNKNOWNERROR
An unknown error.
.. _result-options-label:
:class:`~.Result` options
-------------------------
LibRepo Result options for use in :meth:`~.Result.getinfo` method.
.. data:: LRR_YUM_REPO (deprecated - use LRR_RPMMD_REPO instead)
Returns a flat dictionary with local paths to downloaded/localised
rpmmd repository and basic repository's information.::
{'repomd': u'/tmp/librepotest-jPMmX5/repodata/repomd.xml',
'url': u'http://127.0.0.1:5000/yum/static/01/'
'destdir': u'/tmp/librepotest-jPMmX5',
'metalink': None,
'mirrorlist': None,
'signature': None,
'primary': u'/tmp/librepotest-jPMmX5/repodata/4543ad62e4d86337cd1949346f9aec976b847b58-primary.xml.gz',
'primary_db': u'/tmp/librepotest-jPMmX5/repodata/735cd6294df08bdf28e2ba113915ca05a151118e-primary.sqlite.bz2',
'filelists': u'/tmp/librepotest-jPMmX5/repodata/aeca08fccd3c1ab831e1df1a62711a44ba1922c9-filelists.xml.gz',
'filelists_db': u'/tmp/librepotest-jPMmX5/repodata/4034dcea76c94d3f7a9616779539a4ea8cac288f-filelists.sqlite.bz2',
'other': u'/tmp/librepotest-jPMmX5/repodata/a8977cdaa0b14321d9acfab81ce8a85e869eee32-other.xml.gz',
'other_db': u'/tmp/librepotest-jPMmX5/repodata/fd96942c919628895187778633001cff61e872b8-other.sqlite.bz2',
}
.. data:: LRR_RPMMD_REPO
Returns a dict with local paths to downloaded/localised
rpmmd repository and basic repository's information.::
{'repomd': u'/tmp/librepotest-jPMmX5/repodata/repomd.xml',
'url': u'http://127.0.0.1:5000/yum/static/01/'
'destdir': u'/tmp/librepotest-jPMmX5',
'metalink': None,
'mirrorlist': None,
'signature': None,
'paths': {'primary': u'/tmp/librepotest-jPMmX5/repodata/4543ad62e4d86337cd1949346f9aec976b847b58-primary.xml.gz',
'primary_db': u'/tmp/librepotest-jPMmX5/repodata/735cd6294df08bdf28e2ba113915ca05a151118e-primary.sqlite.bz2',
'filelists': u'/tmp/librepotest-jPMmX5/repodata/aeca08fccd3c1ab831e1df1a62711a44ba1922c9-filelists.xml.gz',
'filelists_db': u'/tmp/librepotest-jPMmX5/repodata/4034dcea76c94d3f7a9616779539a4ea8cac288f-filelists.sqlite.bz2',
'other': u'/tmp/librepotest-jPMmX5/repodata/a8977cdaa0b14321d9acfab81ce8a85e869eee32-other.xml.gz',
'other_db': u'/tmp/librepotest-jPMmX5/repodata/fd96942c919628895187778633001cff61e872b8-other.sqlite.bz2'}
}
.. data:: LRR_YUM_REPOMD (deprecated - use LRR_RPMMD_REPOMD instead)
Returns a flat dict representing a repomd.xml file of downloaded
rpmmd repository.::
{'revision': u'1347459931',
'repo_tags': [],
'content_tags': [],
'distro_tags': [],
'primary': {'checksum': u'4543ad62e4d86337cd1949346f9aec976b847b58',
'checksum_open': u'68457ceb8e20bda004d46e0a4dfa4a69ce71db48',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/4543ad62e4d86337cd1949346f9aec976b847b58-primary.xml.gz',
'size': 936L,
'size_open': 3385L,
'timestamp': 1347459930L},
'primary_db': {'checksum': u'735cd6294df08bdf28e2ba113915ca05a151118e',
'checksum_open': u'ba636386312e1b597fc4feb182d04c059b2a77d5',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/735cd6294df08bdf28e2ba113915ca05a151118e-primary.sqlite.bz2',
'size': 2603L,
'size_open': 23552L,
'timestamp': 1347459931L},
'filelists': {'checksum': u'aeca08fccd3c1ab831e1df1a62711a44ba1922c9',
'checksum_open': u'52d30ae3162ca863c63c345ffdb7f0e10c1414a5',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/aeca08fccd3c1ab831e1df1a62711a44ba1922c9-filelists.xml.gz',
'size': 43310L,
'size_open': 735088L,
'timestamp': 1347459930L},
'filelists_db': {'checksum': u'4034dcea76c94d3f7a9616779539a4ea8cac288f',
'checksum_open': u'949c6b7b605b2bc66852630c841a5003603ca5b2',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/4034dcea76c94d3f7a9616779539a4ea8cac288f-filelists.sqlite.bz2',
'size': 22575L,
'size_open': 201728L,
'timestamp': 1347459931L},
'other': {'checksum': u'a8977cdaa0b14321d9acfab81ce8a85e869eee32',
'checksum_open': u'4b5b8874fb233a626b03b3260a1aa08dce90e81a',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/a8977cdaa0b14321d9acfab81ce8a85e869eee32-other.xml.gz',
'size': 807L,
'size_open': 1910L,
'timestamp': 1347459930L},
'other_db': {'checksum': u'fd96942c919628895187778633001cff61e872b8',
'checksum_open': u'c5262f62b6b3360722b9b2fb5d0a9335d0a51112',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/fd96942c919628895187778633001cff61e872b8-other.sqlite.bz2',
'size': 1407L,
'size_open': 8192L,
'timestamp': 1347459931L},
}
.. data:: LRR_RPMMD_REPOMD
Returns a dict representing a repomd.xml file of downloaded
rpmmd repository.::
{'revision': u'1347459931',
'repo_tags': [],
'content_tags': [],
'distro_tags': [],
'records': {'primary': {'checksum': u'4543ad62e4d86337cd1949346f9aec976b847b58',
'checksum_open': u'68457ceb8e20bda004d46e0a4dfa4a69ce71db48',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/4543ad62e4d86337cd1949346f9aec976b847b58-primary.xml.gz',
'size': 936L,
'size_open': 3385L,
'timestamp': 1347459930L},
'primary_db': {'checksum': u'735cd6294df08bdf28e2ba113915ca05a151118e',
'checksum_open': u'ba636386312e1b597fc4feb182d04c059b2a77d5',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/735cd6294df08bdf28e2ba113915ca05a151118e-primary.sqlite.bz2',
'size': 2603L,
'size_open': 23552L,
'timestamp': 1347459931L}},
'filelists': {'checksum': u'aeca08fccd3c1ab831e1df1a62711a44ba1922c9',
'checksum_open': u'52d30ae3162ca863c63c345ffdb7f0e10c1414a5',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/aeca08fccd3c1ab831e1df1a62711a44ba1922c9-filelists.xml.gz',
'size': 43310L,
'size_open': 735088L,
'timestamp': 1347459930L},
'filelists_db': {'checksum': u'4034dcea76c94d3f7a9616779539a4ea8cac288f',
'checksum_open': u'949c6b7b605b2bc66852630c841a5003603ca5b2',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/4034dcea76c94d3f7a9616779539a4ea8cac288f-filelists.sqlite.bz2',
'size': 22575L,
'size_open': 201728L,
'timestamp': 1347459931L},
'other': {'checksum': u'a8977cdaa0b14321d9acfab81ce8a85e869eee32',
'checksum_open': u'4b5b8874fb233a626b03b3260a1aa08dce90e81a',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 0L,
'location_href': u'repodata/a8977cdaa0b14321d9acfab81ce8a85e869eee32-other.xml.gz',
'size': 807L,
'size_open': 1910L,
'timestamp': 1347459930L},
'other_db': {'checksum': u'fd96942c919628895187778633001cff61e872b8',
'checksum_open': u'c5262f62b6b3360722b9b2fb5d0a9335d0a51112',
'checksum_open_type': u'sha1',
'checksum_type': u'sha1',
'db_version': 10L,
'location_href': u'repodata/fd96942c919628895187778633001cff61e872b8-other.sqlite.bz2',
'size': 1407L,
'size_open': 8192L,
'timestamp': 1347459931L},
}
.. data:: LRR_RPMMD_TIMESTAMP (LRR_YUM_TIMESTAMP)
Returns the highest timestamp from all records in the repomd.
See: http://yum.baseurl.org/gitweb?p=yum.git;a=commitdiff;h=59d3d67f
.. _endcb-statuses-label:
Transfer statuses for endcb of :class:`~.PackageTarget`
-------------------------------------------------------
.. data:: TRANSFER_SUCCESSFUL
.. data:: TRANSFER_ALREADYEXISTS
.. data:: TRANSFER_ERROR
Callbacks prototypes
--------------------
Some librepo's functions and classes can take a callbacks in their arguments.
This section contain the callbacks prototypes and explanation of their
arguments.
By default all callbacks should return *None* (this is default behaviour
of python function if it doesn't have a specified return statement -
it returns None).
But there are some callbacks that can return a specific values defined
in :ref:`callbacks-return-values`.
.. _callback-progresscb-label:
Progress callback - progresscb
------------------------------
``progresscb(userdata, totalsize, downloaded)``
Callback frequently called during a download.
:userdata: User specified data or *None*
:totalsize: Total size (in bytes) of the target (float).
:downloaded: Currently downloaded size (in bytes).
:returns: This callback can return values from :ref:`callbacks-return-values`
.. _callback-endcb-label:
End callback - endcb
--------------------
``endcb(userdata, status, msg)``
Callback called when a transfer is done either successfully or unsuccessfully.
:userdata: User specified data or *None*
:status: :ref:`endcb-statuses-label`
:msg: String with error message or *None*
:returns: This callback can return values from :ref:`callbacks-return-values`
.. _callback-mirrorfailurecb-label:
Mirror Failure Callback - mirrorfailurecb
-----------------------------------------
``mirrorfailurecb(userdata, msg, url)``
Callback called when a transfer failed.
:userdata: User specified data or *None*
:msg: String with error message
:url: String with mirror URL
:returns: This callback can return values from :ref:`callbacks-return-values`
.. _callback-fastestmirrorcb-label:
Fastestmirror callback - fastestmirrorcb
----------------------------------------
``fastestmirrorcb(userdata, stage, data)``
:userdata: User specified data or *None*
:stage: :ref:`fastestmirror-stages-constants-label`
:data: Content of *data* is different for different stages.
See :ref:`fastestmirror-stages-constants-label`
:returns: This callback must return *None* each other value will be ignored.
.. _callback-handlemirrorfailurecb-label:
Handle Mirror Failure Callback - hmfcb
--------------------------------------
``hmfcb(userdata, msg, url, metadata)``
Callback called when a download of a metadata during
:meth:`~.Handle.perform()` fails.
:userdata: User specified data or *None*
:msg: String with error message
:url: String with mirror URL
:metadata: String with metadata name ("primary", "filelists", ...)
:returns: This callback can return values from :ref:`callbacks-return-values`
.. _callbacks-return-values:
Callbacks return values
-----------------------
Each callback can safely return ``None`` (this is implicit return value
when no return statement is defined).
``return None`` is equivalent for ``return librepo.CB_OK``.
.. data:: CB_OK
Everything is OK
.. data:: CB_ABORT
Abort just the current transfer.
Note: If failfast option for the downloading is enabled,
the whole downloading will be aborted.
.. data:: CB_ERROR
Abort the whole downloading (all transfers).
(Note: This code is automatically internally returned when
an exception is raised in the callback.)
.. _checksum-constants-label:
Checksum (hash) type constants
------------------------------
.. data:: MD5 (CHECKSUM_MD5)
.. data:: SHA1 (CHECKSUM_SHA1)
.. data:: SHA224 (CHECKSUM_SHA224)
.. data:: SHA256 (CHECKSUM_SHA256)
.. data:: SHA384 (CHECKSUM_SHA384)
.. data:: SHA512 (CHECKSUM_SHA512)
"""
import sys
import librepo._librepo
current_module = sys.modules[__name__]
LibrepoException = _librepo.LibrepoException
ATTR_TO_LRO = {}
ATTR_TO_LRI = {}
ATTR_TO_LRR = {}
_CHECKSUM_STR_TO_VAL_MAP = {}
# Create local aliases for contants from _librepo C module
for attr in dir(_librepo):
if not attr.isupper():
# Only constants should be imported automatically
continue
# Create local alias
val = getattr(_librepo, attr)
setattr(current_module, attr, val)
if attr.endswith("_SENTINEL"):
# Ignore sentinel values
continue
if attr.startswith("LR_"):
setattr(current_module, attr[3:], val)
if attr.startswith("LRO_"):
ATTR_TO_LRO[attr.lower()[4:]] = val
if attr.startswith("LRI_"):
ATTR_TO_LRI[attr.lower()[4:]] = val
if attr.startswith("LRR_"):
ATTR_TO_LRR[attr.lower()[4:]] = val
if attr.startswith("LR_CHECKSUM_"):
setattr(current_module, attr[12:], val)
_CHECKSUM_STR_TO_VAL_MAP[attr[12:].lower()] = val
RPMMD_FULL = YUM_FULL = LR_YUM_FULL = None
RPMMD_REPOMDONLY= YUM_REPOMDONLY = LR_YUM_REPOMDONLY = [None]
RPMMD_BASEXML = YUM_BASEXML = LR_YUM_BASEXML = ["primary", "filelists", "other", None]
RPMMD_BASEDB = YUM_BASEDB = LR_YUM_BASEDB = ["primary_db", "filelists_db", "other_db", None]
RPMMD_HAWKEY = YUM_HAWKEY = LR_YUM_HAWKEY = ["primary", "filelists", "prestodelta", None]
def checksum_str_to_type(name):
"""
Convert string with name of hash function to numeric value
that represents the hash in createrepo_c.
:param name: Checksum name (e.g. "sha256", "sha512", ...)
:returns: Integer value (from :ref:`checksum-constants-label`)
"""
name = name.lower()
return _CHECKSUM_STR_TO_VAL_MAP.get(name, CHECKSUM_UNKNOWN)
class MetadataTarget(_librepo.MetadataTarget):
def __init__(self, handle=None, cbdata=None, progresscb=None, mirrorfailurecb=None, endcb=None, gnupghomedir=None):
_librepo.MetadataTarget.__init__(self, handle, cbdata, progresscb, mirrorfailurecb, endcb, gnupghomedir)
class PackageTarget(_librepo.PackageTarget):
"""
Represent a single package that will be downloaded by
:func:`~librepo.download_packages`.
"""
def __init__(self, relative_url, dest=None, checksum_type=CHECKSUM_UNKNOWN,
checksum=None, expectedsize=0, base_url=None, resume=False,
progresscb=None, cbdata=None, handle=None, endcb=None,
mirrorfailurecb=None, byterangestart=0, byterangeend=0):
"""
:param relative_url: Target URL. If *handle* or *base_url* specified,
the *url* can be (and logically should be) only a relative part of path.
:param dest: Destination filename or directory (file basename will
be derived from the relative_url). If *None* current
working directory will be used.
:param checksum_type: :ref:`checksum-constants-label`
:param checksum: Expected checksum value.
:param expectedsize: Expected size of the target. If server reports
different size, then download won't be performed.
:param base_url: Base part of URL
:param resume: If True then downloader will try to resume download
if the destination file already exists. If the file doesn't exist
yet, it will be downloaded.
:param progresscb: :ref:`callback-progresscb-label`
:param cbdata: User data for the callback.
:param handle: :class:`~librepo.Handle`
:param endcb: :ref:`callback-endcb-label`
:param mirrorfailurecb: See :ref:`callback-mirrorfailurecb-label`
:param byterangestart: Start downloading from the specified byte.
:param byterangeend: Stop downloading at the specified byte.
*Note: If the byterangeend is less or equal to byterangestart,
then it is ignored!*
"""
_librepo.PackageTarget.__init__(self, handle, relative_url, dest,
checksum_type, checksum, expectedsize,
base_url, resume, progresscb, cbdata,
endcb, mirrorfailurecb, byterangestart,
byterangeend)
class Handle(_librepo.Handle):
"""Librepo handle class.
Handle hold information about a repository and configuration for
downloading from the repository.
**Attributes:**
.. attribute:: update:
See: :data:`.LRO_UPDATE`
.. attribute:: urls:
See: :data:`.LRO_URLS`
.. attribute:: mirrorlist:
See: :data:`.LRO_MIRRORLIST`
.. attribute:: mirrorlisturl:
See: :data:`.LRO_MIRRORLISTURL`
.. attribute:: metalinkurl:
See: :data:`.LRO_METALINKURL`
.. attribute:: local:
See: :data:`.LRO_LOCAL`
.. attribute:: httpauth:
See: :data:`.LRO_HTTPAUTH`
.. attribute:: userpwd:
See: :data:`.LRO_USERPWD`
.. attribute:: proxy:
See: :data:`.LRO_PROXY`
.. attribute:: proxyport:
See: :data:`.LRO_PROXYPORT`
.. attribute:: proxytype:
See: :data:`.LRO_PROXYTYPE`
.. attribute:: proxyauth:
See: :data:`.LRO_PROXYAUTH`
.. attribute:: proxyuserpwd:
See: :data:`.LRO_PROXYUSERPWD`
.. attribute:: progresscb:
See: :data:`.LRO_PROGRESSCB`
.. attribute:: progressdata:
See: :data:`.LRO_PROGRESSDATA`
.. attribute:: maxspeed:
See: :data:`.LRO_MAXSPEED`
.. attribute:: destdir:
See: :data:`.LRO_DESTDIR`
.. attribute:: repotype:
See: :data:`.LRO_REPOTYPE`
.. attribute:: connecttimeout:
See: :data:`.LRO_CONNECTTIMEOUT`
.. attribute:: ignoremissing:
See: :data:`.LRO_IGNOREMISSING`
.. attribute:: interruptible:
See: :data:`.LRO_INTERRUPTIBLE`
.. attribute:: useragent:
See: :data:`.LRO_USERAGENT`
.. attribute:: fetchmirrors:
See: :data:`.LRO_FETCHMIRRORS`
.. attribute:: maxmirrortries:
See: :data:`.LRO_MAXMIRRORTRIES`
.. attribute:: maxparalleldownloads:
See: :data:`.LRO_MAXPARALLELDOWNLOADS`
.. attribute:: maxdownloadspermirror:
See: :data:`.LRO_MAXDOWNLOADSPERMIRROR`
.. attribute:: varsub:
See: :data:`.LRO_VARSUB`
.. attribute:: fastestmirror:
See: :data:`.LRO_FASTESTMIRROR`
.. attribute:: fastestmirrorcache:
See: :data:`.LRO_FASTESTMIRRORCACHE`
.. attribute:: fastestmirrormaxage:
See: :data:`.LRO_FASTESTMIRRORMAXAGE`
.. attribute:: fastestmirrorcb:
See: :data:`.LRO_FASTESTMIRRORCB`
.. attribute:: fastestmirrordata:
See: :data:`.LRO_FASTESTMIRRORDATA`
.. attribute:: lowspeedtime:
See: :data:`.LRO_LOWSPEEDTIME`
.. attribute:: lowspeedlimit:
See: :data:`.LRO_LOWSPEEDLIMIT`
.. attribute:: gpgcheck:
See: :data:`.LRO_GPGCHECK`
.. attribute:: checksum:
See: :data:`.LRO_CHECKSUM`
.. attribute:: rpmmddlist:
See: :data:`.LRO_RPMMDDLIST`
.. attribute:: yumdlist:
See: :data:`.LRO_YUMDLIST`
.. attribute:: yumslist:
See: :data:`.LRO_YUMSLIST`
.. attribute:: rpmmdblist:
See: :data:`.LRO_RPMMDBLIST`
.. attribute:: yumblist:
See: :data:`.LRO_YUMBLIST`
.. attribute:: hmfcb:
See: :data:`.LRO_HMFCB`
.. attribute:: sslverifypeer:
See :data:`.LRO_SSLVERIFYPEER`
.. attribute:: sslverifystatus:
See :data:`.LRO_SSLVERIFYSTATUS`
.. attribute:: sslverifyhost:
See :data:`.LRO_SSLVERIFYHOST`
.. attribute:: sslclientcert:
See :data:`.LRO_SSLCLIENTCERT`
.. attribute:: sslclientkey:
See :data:`.LRO_SSLCLIENTKEY`
.. attribute:: sslcacert:
See :data:`.LRO_SSLCACERT`
.. attribute:: proxy_sslverifypeer:
See :data:`.LRO_PROXY_SSLVERIFYPEER`
.. attribute:: proxy_sslverifyhost:
See :data:`.LRO_PROXY_SSLVERIFYHOST`
.. attribute:: proxy_sslclientcert:
See :data:`.LRO_PROXY_SSLCLIENTCERT`
.. attribute:: proxy_sslclientkey:
See :data:`.LRO_PROXY_SSLCLIENTKEY`
.. attribute:: proxy_sslcacert:
See :data:`.LRO_PROXY_SSLCACERT`
.. attribute:: ipresolve:
See :data:`.LRO_IPRESOLVE`
.. attribute:: allowedmirrorfailures:
See :data:`.LRO_ALLOWEDMIRRORFAILURES`
.. attribute:: adaptivemirrorsorting:
See :data:`.LRO_ADAPTIVEMIRRORSORTING`
.. attribute:: gnupghomedir:
See :data:`.LRO_GNUPGHOMEDIR`
.. attribute:: fastestmirrortimeout:
See :data:`.LRO_FASTESTMIRRORTIMEOUT`
.. attribute:: httpheader:
See :data:`.LRO_HTTPHEADER`
.. attribute:: offline:
See :data:`.LRO_OFFLINE`
.. attribute:: httpauthmethods
See :data:`.LRO_HTTPAUTHMETHODS`
.. attribute:: proxyauthmethods
See :data:`.LRO_PROXYAUTHMETHODS`
.. attribute:: ftpuseepsv
See :data:`.LRO_FTPUSEEPSV`
.. attribute:: preservetime
See :data:`.LRO_PRESERVETIME`
"""
def setopt(self, option, val):
"""Set option to :class:`.Handle` directly.
:param option: One of: :ref:`handle-options-label`
:returns: *None*
Example::
# The command:
h.setopt(librepo.LRO_URLS, ["http://ftp.linux.ncsu.edu/pub/fedora/linux/releases/17/Everything/i386/os/"])
# is equivalent to:
h.urls(["http://ftp.linux.ncsu.edu/pub/fedora/linux/releases/17/Everything/i386/os/"])
"""
if (option == LRO_URLS and (not isinstance(val, list) and val is not None)):
import warnings
warnings.warn("Using string value for LRO_URLS is deprecated, " \
"use list of strings instead", DeprecationWarning)
val = [val]
_librepo.Handle.setopt(self, option, val)
def __setattr__(self, attr, val):
if attr not in ATTR_TO_LRO and attr in ATTR_TO_LRI:
raise AttributeError("Set of attribute '%s' is not supported" % attr)
elif attr not in ATTR_TO_LRO:
raise AttributeError("'%s' object has no attribute '%s'" % \
(self.__class__.__name__, attr))
self.setopt(ATTR_TO_LRO[attr], val)
def __getattr__(self, attr):
if attr not in ATTR_TO_LRI and attr in ATTR_TO_LRO:
raise AttributeError("Read of attribute '%s' is not supported" % attr)
elif attr not in ATTR_TO_LRI:
raise AttributeError("'%s' object has no attribute '%s'" % \
(self.__class__.__name__, attr))
return _librepo.Handle.getinfo(self, ATTR_TO_LRI[attr])
def getinfo(self, option):
"""Get information from :class:`.Handle`.
:param option: One of :ref:`handle-info-options-label`
:returns: Value for the specified option or
*None* if the option is not set.
"""
return _librepo.Handle.getinfo(self, option)
def download(self, url, dest=None, checksum_type=CHECKSUM_UNKNOWN,
checksum=None, expectedsize=0, base_url=None, resume=0):
"""
**This method is deprecated** - Use :func:`~librepo.download_packages`
instead.
Download package from the repository specified in the
:Class:`~librepo.Handle`. If *base_url* is specified,
urls and mirrors specified in the Handle are ignored.
Note: If resume is True and checksum_type and checksum are specified
and downloaded package already exists, then checksum of the
existing package is checked. If checksum matches, then no downloading
is done and exception with LRE_ALREADYDOWNLOADED return code is raised.
:param url: Relative path to the package in the repository.
:param dest: Destination for package. Could be absolute/relative
path to directory or filename.
:param checksum_type: :ref:`checksum-constants-label`.
:param checksum: Checksum value.
:param expectedsize: Expected size of the file. If server reports
different size, then no download is preformed.
:param base_url: Instead of repositories specified in ``Handle``
use repository on this url.
:param resume: ``True`` enables resume. Resume means that if local
destination file exists, just try to
resume download, if not or resume download failed
than download whole file again.
Example::
h = librepo.Handle()
h.setopt(librepo.LRO_URLS, ["http://ftp.linux.ncsu.edu/pub/fedora/linux/releases/17/Everything/i386/os/"])
h.setopt(librepo.LRO_REPOTYPE, librepo.LR_YUMREPO)
h.download("Packages/s/sl-3.03-12.fc17.i686.rpm",
checksum="0ec8535d0fc00b497d8aef491c3f8b3955f2d84846325ee44851d9de8a36d12c",
checksum_type=librepo.CHECKSUM_SHA256)
.. note::
If checksum check is disabled in the current ``Handle``, then
checksum is NOT checked even if *checksum* and *checksum_type*
params are specified!
"""
if isinstance(checksum_type, str):
checksum_type = checksum_str_to_type(checksum_type)
self.download_package(url, dest, checksum_type, checksum,
expectedsize, base_url, resume)
def perform(self, result=None):
"""
Perform the specified action - download/locate a repository.
:param result: :Class:`~librepo.Result` object or *None*
:returns: :Class:`~librepo.Result` object that was passed by
*result* parameter or the new one if the parameter was not
specified or was *None*.
"""
if result is None:
result = Result()
_librepo.Handle.perform(self, result)
return result
def new_packagetarget(self, relative_url, **kwargs):
"""
Shortcut for creating a new :Class:`~librepo.PackageTarget` objects.
Targets created by this way have automatically setted handle to the
current :Class:`~librepo.Handle` object.
:param relative_url: Relative par of target (package) URL
:returns: New :Class:`~librepo.PackageTarget`
"""
return PackageTarget(relative_url, handle=self, **kwargs)
class Result(_librepo.Result):
"""Librepo result class
This class holds information about a downloaded/localised repository.
**Attributes:**
.. attribute:: rpmmd_repo
See: :data:`.LRR_RPMMD_REPO`
.. attribute:: yum_repo
See: :data:`.LRR_YUM_REPO`
.. attribute:: rpmmd_repomd
See: :data:`.LRR_RPMMD_REPOMD`
.. attribute:: yum_repomd
See: :data:`.LRR_YUM_REPOMD`
.. attribute:: rpmmd_timestamp
See: :data:`.LRR_RPMMD_TIMESTAMP`
.. attribute:: yum_timestamp
See: :data:`.LRR_YUM_TIMESTAMP`
"""
def getinfo(self, option):
"""Returns information about a downloaded/localised repository.
*option* could be one of: :ref:`result-options-label`
"""
return _librepo.Result.getinfo(self, option)
def __getattr__(self, attr):
if attr not in ATTR_TO_LRR:
raise AttributeError("'%s' object has no attribute '%s'" % \
(self.__class__.__name__, attr))
return self.getinfo(ATTR_TO_LRR[attr])
# Functions
def download_metadata(list):
"""
Download metadata. *list* is a list of
:class:`~librepo.MetadataTarget` objects.
Exception is raised only if a nonrecoverable
error related to the function itself is meet
(Errors related to individual downloads are
reported via corresponding MetadataTarget objects)
:param list: List of :class:`~.librepo.MetadataTarget` objects.
:returns: *None*
"""
return _librepo.download_metadata(list)
def download_packages(list, failfast=False):
"""
Download list of packages. *list* is a list of
:class:`~librepo.PackageTarget` objects.
If the *failfast* is True, then whole downloading is stopped
immediately when any of download fails (and exception is raised).
If the failfast is False, then this function returns after all
downloads finish (no matter if successfully or unsuccessfully)
and exception is raised only if a nonrecoverable
error related to the function itself is meet
(Errors related to individual downloads are
reported via corresponding PackageTarget objects)
:param list: List of :class:`~.librepo.PackageTarget` objects.
:param failfast: If *True*, stop whole downloading immediately when any
of downloads fails. If *False*, ignore failed download(s)
and continue with other downloads.
:returns: *None*
"""
return _librepo.download_packages(list, failfast)
def download_url(url, fd, handle=None):
"""
Download specified URL and write it content to opened file descriptor.
:param url: Target URL
:param fd: Opened file descriptor (To get a file descriptor
use for example **os.open()**.
:param handle: :Class:`~librepo.Handle` object or *None*
:returns: *None*
"""
return _librepo.download_url(handle, url, fd)
def yum_repomd_get_age(result_object):
"""
Get the highest timestamp of the repo's repomd.xml.
:param result_object: Used (filled) :Class:`~librepo.Result`
:returns: The highest timestamp from repomd (Float) or *0.0* on error.
"""
return _librepo.yum_repomd_get_age(result_object)
def set_debug_log_handler(log_function, user_data=None):
"""
ONLY FOR DEVELOPMENT (DEBUGGING) PURPOSES!
(Deprecated, use :func:`~log_set_file` instead)
When python debug log handler is used, the librepo is **THREAD-UNSAFE**!
If used, it overrides logging set by :func:`~log_set_file` and vice versa.
:param log_function: Function that will handle the debug messages.
:param user_data: An data you want to be passed to the log_function
during call.
:returns: *None*
Example::
def debug_function(msg, _):
print(msg)
librepo.set_debug_log_handler(debug_function)
"""
return _librepo.set_debug_log_handler(log_function, user_data)
def log_set_file(filename):
"""Set a filename of a file where logs are going to be written.
Note: Only one file could be set at a time.
Note: If the LIBREPO_DEBUG environ variable is set and this
function is used then the LIBREPO_DEBUG effect will be suppressed.
(All debug output will be redirected to the specified file)
:param filename: Filename
:returns: Id of the handler
"""
return _librepo.log_set_file(filename)
def log_remove_handler(handler_id):
"""Remove handler.
:param handler_id: id
"""
return _librepo.log_remove_handler(handler_id)
Mini Shell