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()