o Ni@sPddlZddlmZmZddlmZmZmZmZm Z ddl Z GdddeZ dS)N)ABCabstractmethod)ClassVarOptionalTupleTypeUnionc@seZdZUdZejjejjfZe e e e dfe d< eZe eee edffe d< deddfdd Zedeefd d Zedeefd d ZedejddfddZdededefddZdS) SchemeClienta A client used for caching remote resources corresponding to URLs with a particular scheme. Subclasses must define the :attr:`scheme` class variable and implement :meth:`get_etag()` and :meth:`get_resource()`. .. important:: Take care when implementing subclasses to raise the right error types from :meth:`get_etag()` and :meth:`get_resource()`. .recoverable_errorsschemeresourcereturnNcCs ||_dS)N)r )selfr rU/home/ubuntu/.local/lib/python3.10/site-packages/cached_path/schemes/scheme_client.py__init__%s zSchemeClient.__init__cCt)a Get the Etag or an equivalent version identifier associated with the resource. Returns ------- ``Optional[str]`` The ETag as a ``str`` or ``None`` if there is no ETag associated with the resource. Raises ------ ``FileNotFoundError`` If the resource doesn't exist. ``Recoverable error`` Any error type defined in ``SchemeClient.recoverable_errors`` will be treated as a recoverable error. This means that when of these is caught by ``cached_path()``, it will look for cached versions of the given resource and return the latest version if there are any. Otherwise the error is propogated. ``Other errors`` Any other error type can be raised. These errors will be treated non-recoverable and will be propogated immediately by ``cached_path()``. NotImplementedErrorrrrrget_etag(szSchemeClient.get_etagcCr)a Get the size of the resource in bytes (if known). Returns ------- ``Optional[int]`` The size (in bytes). Raises ------ ``FileNotFoundError`` If the resource doesn't exist. ``Recoverable error`` Any error type defined in ``SchemeClient.recoverable_errors`` will be treated as a recoverable error. This means that when of these is caught by ``cached_path()``, the size will be ignored. ``Other errors`` Any other error type can be raised. These errors will be treated non-recoverable and will be propogated immediately by ``cached_path()``. rrrrrget_sizeHszSchemeClient.get_size temp_filecCr)ah Download the resource to the given temporary file. Raises ------ ``FileNotFoundError`` If the resource doesn't exist. ``Other errors`` Any other error type can be raised. These errors will be treated non-recoverable and will be propagated immediately by ``cached_path()``. r)rrrrr get_resourcedszSchemeClient.get_resourceindexlengthcCs~~t)a Get a sequence of ``length`` bytes from the resource, starting at ``index`` bytes. If a scheme provides a direct way of downloading a bytes range, the scheme client should implement that. Otherwise the entire file has to be downloaded. r)rrrrrrget_bytes_rangetszSchemeClient.get_bytes_range)__name__ __module__ __qualname____doc__requests exceptionsConnectionErrorTimeoutr rrr BaseException__annotations__tupler rstrrrrrintrioBufferedWriterrbytesrrrrrr s  "r ) r*abcrrtypingrrrrrr!r rrrrs