Paket: python-yarl-doc (1.4.2-2)

documentation for the yarl Python library

URL is constructed from `str`:

 >>> from yarl import URL
 >>> url = URL('https://www.python.org/~guido?arg=1#frag')
 >>> url
 URL('https://www.python.org/~guido?arg=1#frag')

All URL parts: scheme, user, passsword, host, port, path, query and fragment are accessible by properties:

 >>> url.scheme
 'https'
 >>> url.host
 'www.python.org'
 >>> url.path
 '/~guido'
 >>> url.query_string
 'arg=1'
 >>> url.query
 <MultiDictProxy('arg': '1')>
 >>> url.fragment
 'frag'

All URL manipulations produces a new URL object:

 >>> url.parent / 'downloads/source'
 URL('https://www.python.org/downloads/source')

Strings passed to constructor and modification methods are automatically encoded giving canonical representation as result::

 >>> url = URL('https://www.python.org/путь')
 >>> url
 URL('https://www.python.org/%D0%BF%D1%83%D1%82%D1%8C')

Regular properties are percent-decoded, use `raw_` versions for getting encoded strings:

 >>> url.path
 '/путь'

 >>> url.raw_path
 '/%D0%BF%D1%83%D1%82%D1%8C'

Human readable representation of URL is available as `.human_repr()`:

 >>> url.human_repr()
 'https://www.python.org/путь'

This package provides documentation for yarl