Cache

b2sdk caches the mapping between bucket name and bucket id, so that the user of the library does not need to maintain the mapping to call the api.

class b2sdk.v2.AbstractCache[source]
clear()[source]
abstract get_bucket_id_or_none_from_bucket_name(name)[source]
abstract get_bucket_name_or_none_from_allowed()[source]
abstract get_bucket_name_or_none_from_bucket_id(bucket_id)[source]
Parameters

bucket_id (str) –

Return type

str | None

abstract list_bucket_names_ids()[source]

List buckets in the cache.

Returns

list of tuples (bucket_name, bucket_id)

abstract save_bucket(bucket)[source]
abstract set_bucket_name_cache(buckets)[source]
class b2sdk.v2.AuthInfoCache(info)[source]

A cache that stores data persistently in StoredAccountInfo.

Parameters

info (AbstractAccountInfo) –

__init__(info)[source]
Parameters

info (AbstractAccountInfo) –

get_bucket_id_or_none_from_bucket_name(name)[source]
get_bucket_name_or_none_from_bucket_id(bucket_id)[source]
Return type

str | None

get_bucket_name_or_none_from_allowed()[source]
list_bucket_names_ids()[source]

List buckets in the cache.

Returns

list of tuples (bucket_name, bucket_id)

save_bucket(bucket)[source]
set_bucket_name_cache(buckets)[source]
clear()
class b2sdk.v2.DummyCache[source]

A cache that does nothing.

get_bucket_id_or_none_from_bucket_name(name)[source]
get_bucket_name_or_none_from_bucket_id(bucket_id)[source]
Parameters

bucket_id (str) –

Return type

str | None

get_bucket_name_or_none_from_allowed()[source]
list_bucket_names_ids()[source]

List buckets in the cache.

Returns

list of tuples (bucket_name, bucket_id)

save_bucket(bucket)[source]
set_bucket_name_cache(buckets)[source]
clear()
class b2sdk.v2.InMemoryCache[source]

A cache that stores the information in memory.

__init__()[source]
get_bucket_id_or_none_from_bucket_name(name)[source]
get_bucket_name_or_none_from_bucket_id(bucket_id)[source]
Parameters

bucket_id (str) –

Return type

str | None

get_bucket_name_or_none_from_allowed()[source]
list_bucket_names_ids()[source]

List buckets in the cache.

Returns

list of tuples (bucket_name, bucket_id)

save_bucket(bucket)[source]
set_bucket_name_cache(buckets)[source]
clear()