o NiU@sddlmZmZddlmZddlmZmZddlm Z ddl m Z m Z er,ddl mZ  dd e d ed ed ee dededededdefddZde d ed edefddZdS)) TYPE_CHECKINGOptional)urlparse) cached_pathget_from_cache) PathOrStr)get_scheme_clientget_supported_schemes)ProgressNFurl_or_filenameindexlength cache_dirextract_archive force_extractquietprogressr returncCs0t|ts t|}|d}|rP|dkrP|d|} ||dd} t| |d|||d} | s7t|d| | } | sJtd| d | dt| ||St |j t vrt |} zt ||||d| d \}}t|||WStyxYnwz| ||WStyYnwt||||d } t| ||S) a Get a range of up to ``length`` bytes starting at ``index``. In some cases the entire file may need to be downloaded, such as when the server does not support a range download or when you're trying to get a bytes range from a file within an archive. .. caution:: You may get less than ``length`` bytes sometimes, such as when fetching a range from an HTTP resource starting at 0 since headers will be omitted in the bytes returned. Parameters ---------- url_or_filename : A URL or path to parse and possibly download. index : The index of the byte to start at. length : The number of bytes to read. cache_dir : The directory to cache downloads. If not specified, the global default cache directory will be used (``~/.cache/cached_path``). This can be set to something else with :func:`set_cache_dir()`. This is only relevant when the bytes range cannot be obtained directly from the resource. extract_archive : Set this to ``True`` when you want to get a bytes range from a file within an archive. In this case the ``url_or_filename`` must contain an "!" followed by the relative path of the file within the archive, e.g. "s3://my-archive.tar.gz!my-file.txt". Note that the entire archive has to be downloaded in this case. force_extract : If ``True`` and the resource is a file within an archive (when the path contains an "!" and ``extract_archive=True``), it will be extracted regardless of whether or not the extracted directory already exists. .. caution:: Use this flag with caution! This can lead to race conditions if used from multiple processes on the same file. quiet : If ``True``, progress displays won't be printed. This is only relevant when the bytes range cannot be obtained directly from the resource. progress : A custom progress display to use. If not set and ``quiet=False``, a default display from :func:`~cached_path.get_download_progress()` will be used. This is only relevant when the bytes range cannot be obtained directly from the resource. !rNrT)rrrrrz9 uses the ! syntax, but does not specify an archive file.'z' not found within ')rrr no_downloads_client)rrr) isinstancestrfindris_dir ValueErrorexistsFileNotFoundError_bytes_range_from_filerschemer r rget_bytes_rangeNotImplementedError)r r rrrrrrexclamation_index archive_path file_namecached_archive_path file_pathclient cache_path_r,K/home/ubuntu/.local/lib/python3.10/site-packages/cached_path/bytes_range.pyr" sX B        r"pathcCsBt|d}||||WdS1swYdS)Nrb)openseekread)r.r rfr,r,r-r s  $r )NFFFN)typingrr urllib.parser _cached_pathrrcommonrschemesr r rich.progressr intboolbytesr"r r,r,r,r-s@    }