mirror of
https://github.com/rasterio/rasterio.git
synced 2025-12-08 17:36:12 +00:00
64474c1795
* Introducing cache.invalidate() and invalidate_all() Resolves #3275 * Improve documentation of cache module * Even more documentation
55 lines
1.8 KiB
Cython
55 lines
1.8 KiB
Cython
# cython: c_string_type=unicode, c_string_encoding=utf8
|
|
|
|
"""Rasterio caches HTTP responses using GDAL's VSI CURL cache.
|
|
|
|
A global LRU cache of 16 MB shared among all downloaded content is
|
|
enabled by default, and content in it may be reused after a dataset has
|
|
been closed and reopened. Responses from FTP and HTTP servers, including
|
|
cloud storage like AWS S3 and Microsoft Azure, are stored in this cache.
|
|
Responses from HTTP servers used by Rasterio's Python openers are not.
|
|
|
|
The size of the cache and which responses are stored can be controlled
|
|
by GDAL's CPL_VSIL_CURL_CACHE_SIZE and CPL_VSIL_CURL_NON_CACHED
|
|
configuration options. For details See
|
|
https://gdal.org/en/latest/user/configoptions.html.
|
|
"""
|
|
|
|
include "gdal.pxi"
|
|
|
|
from rasterio._path import _parse_path
|
|
|
|
|
|
def invalidate(pattern):
|
|
"""Invalidate responses in Rasterio's HTTP cache
|
|
|
|
Parameters
|
|
----------
|
|
pattern : str
|
|
All responses beginning with this pattern will be invalidated.
|
|
Responses served from a particular website can be invalidated
|
|
using a pattern like "https://example.com". Responses served
|
|
from an S3 bucket can be invalidated using a pattern like
|
|
"s3://example.com", where "example.com" is the bucket name.
|
|
Invalidation can be made more selective by appending path
|
|
segments to the pattern. "s3://example.com/prefix" will
|
|
invalidate only responses served for requests for objects in the
|
|
"example.com" bucket that have a key beginning with "prefix".
|
|
|
|
Returns
|
|
-------
|
|
None
|
|
"""
|
|
path = _parse_path(pattern).as_vsi()
|
|
path = path.encode('utf-8')
|
|
VSICurlPartialClearCache(path)
|
|
|
|
|
|
def invalidate_all():
|
|
"""Invalidate all responses in Rasterio's HTTP cache
|
|
|
|
Returns
|
|
-------
|
|
None
|
|
"""
|
|
VSICurlClearCache()
|