httk.core.datastream.bytestream_url
===================================

.. py:module:: httk.core.datastream.bytestream_url


Classes
-------

.. autoapisummary::

   httk.core.datastream.bytestream_url.BytestreamURL


Module Contents
---------------

.. py:class:: BytestreamURL(url, **hints)

   Bases: :py:obj:`httk.core.datastream.bytestream_common.BytestreamCommon`, :py:obj:`httk.core.datastream.bytestream_backend.BytestreamBackend`


   Backend for streaming byte data fetched from a URL string.
   A bare string is interpreted as a URL when its scheme is one of http, https, ftp, or file,
   or when an explicit kind="url" hint is given.
   Network access from an implicit bare network URL requires explicit consent before opening;
   URL views and ``kind="url"`` provide that consent. Content is transparently decompressed
   according to the compression hint.

   :param url: URL to fetch lazily when data is first read.
   :param \**hints: Backend-selection, consent, timeout, and compression hints.
   :raises ValueError: If the compression hint is unknown.


   .. py:property:: name
      :type: str | None


      Report that a URL backend has no filename.


   .. py:property:: url
      :type: str


      Return the source URL.


   .. py:property:: closed
      :type: bool


      Report whether the URL backend is closed.