bucket_DC/python-yarl

   1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
   2
   3 NAMEBASE=               python-yarl
   4 VERSION=                1.9.4
   5 KEYWORDS=               python
   6 VARIANTS=               v11 v12
   7 SDESC[v11]=             Yet another URL library (3.11)
   8 SDESC[v12]=             Yet another URL library (3.12)
   9 HOMEPAGE=               https://github.com/aio-libs/yarl
  10 CONTACT=                Python_Automaton[python@ironwolf.systems]
  11
  12 DOWNLOAD_GROUPS=        main
  13 SITES[main]=            PYPIWHL/4d/05/4d79198ae568a92159de0f89e710a8d19e3fa267b719a236582eee921f4a
  14 DISTFILE[1]=            yarl-1.9.4-py3-none-any.whl:main
  15 DF_INDEX=               1
  16 SPKGS[v11]=             single
  17 SPKGS[v12]=             single
  18
  19 OPTIONS_AVAILABLE=      PY311 PY312
  20 OPTIONS_STANDARD=       none
  21 VOPTS[v11]=             PY311=ON PY312=OFF
  22 VOPTS[v12]=             PY311=OFF PY312=ON
  23
  24 DISTNAME=               yarl-1.9.4.dist-info
  25
  26 GENERATED=              yes
  27
  28 [PY311].RUN_DEPENDS_ON=                 python-idna:single:v11
  29                                         python-multidict:single:v11
  30 [PY311].USES_ON=                        python:v11,wheel
  31
  32 [PY312].RUN_DEPENDS_ON=                 python-idna:single:v12
  33                                         python-multidict:single:v12
  34 [PY312].USES_ON=                        python:v12,wheel
  35
  36 [FILE:2395:descriptions/desc.single]
  37 yarl
  38 ====
  39
  40 The module provides handy URL class for URL parsing and changing.
  41
  42   :align: right
  43
  44    :alt: Matrix Room — #aio-libs:matrix.org
  45
  46    :alt: Matrix Space — #aio-libs-space:matrix.org
  47
  48 Introduction
  49 ------------
  50
  51 Url is constructed from str:
  52
  53 .. code-block:: pycon
  54
  55    >>> from yarl import URL
  56    >>> url = URL('https://www.python.org/~guido?arg=1#frag')
  57    >>> url
  58    URL('https://www.python.org/~guido?arg=1#frag')
  59
  60 All url parts: *scheme*, *user*, *password*, *host*, *port*, *path*,
  61 *query* and *fragment* are accessible by properties:
  62
  63 .. code-block:: pycon
  64
  65    >>> url.scheme
  66    'https'
  67    >>> url.host
  68    'www.python.org'
  69    >>> url.path
  70    '/~guido'
  71    >>> url.query_string
  72    'arg=1'
  73    >>> url.query
  74    <MultiDictProxy('arg': '1')>
  75    >>> url.fragment
  76    'frag'
  77
  78 All url manipulations produce a new url object:
  79
  80 .. code-block:: pycon
  81
  82    >>> url = URL('https://www.python.org')
  83    >>> url / 'foo' / 'bar'
  84    URL('https://www.python.org/foo/bar')
  85    >>> url / 'foo' % {'bar': 'baz'}
  86    URL('https://www.python.org/foo?bar=baz')
  87
  88 Strings passed to constructor and modification methods are
  89 automatically encoded giving canonical representation as result:
  90
  91 .. code-block:: pycon
  92
  93    >>> url = URL('https://www.python.org/шлях')
  94    >>> url
  95    URL('https://www.python.org/%D1%88%D0%BB%D1%8F%D1%85')
  96
  97 Regular properties are *percent-decoded*, use raw_ versions for
  98 getting *encoded* strings:
  99
 100 .. code-block:: pycon
 101
 102    >>> url.path
 103    '/шлях'
 104
 105    >>> url.raw_path
 106    '/%D1%88%D0%BB%D1%8F%D1%85'
 107
 108 Human readable representation of URL is available as ``.human_repr()``:
 109
 110 .. code-block:: pycon
 111
 112    >>> url.human_repr()
 113    'https://www.python.org/шлях'
 114
 115 For full documentation please read https://yarl.aio-libs.org.
 116
 117 Installation
 118 ------------
 119
 120 ::
 121
 122    $ pip install yarl
 123
 124 The library is Python 3 only!
 125
 126 PyPI contains binary wheels for Linux, Windows and MacOS.  If you want to
 127 install
 128 yarl on another operating system (like *Alpine Linux*, which is not
 129 manylinux-compliant because of the missing glibc and therefore, cannot be
 130 used with our wheels) the the tarball will be used to compile the library
 131 from
 132 the source code. It requires a C compiler and and Python headers installed.
 133
 134 To skip the compilation you must explicitly opt-in by using a PEP 517
 135 configuration setting ``pure-python``, or setting the YARL_NO_EXTENSIONS
 136 environment variable to a non-empty value, e.g.:
 137
 138
 139 [FILE:106:distinfo]
 140 928cecb0ef9d5a7946eb6ff58417ad2fe9375762382f1bf5c55e61645f2c43ad        31638 yarl-1.9.4-py3-none-any.whl
 141