Struct CosMapItem 

pub struct CosMapItem {
    pub host: String,
    pub port: u16,
    pub region: Option<String>,
    pub api_key: Option<String>,
    pub access_key: Option<String>,
    pub secret_key: Option<String>,
    pub ttl: Option<u64>,
    pub tls: Option<bool>,
    pub addressing_style: Option<String>,
}

Represents a COS map item with its properties.

This struct is used to store the configuration for a COS bucket. Each bucket is identified by its name, and the properties include:

• host: The host address of the COS service.
• port: The port number for the COS service.
• region: The region where the COS service is located.
• api_key: The API key for accessing the COS service (optional).
• access_key: The access key for the COS service (optional).
• secret_key: The secret key for the COS service (optional).
• ttl: The time-to-live for the COS bucket (optional).

Fields

host: String

port: u16

region: Option<String>

api_key: Option<String>

access_key: Option<String>

secret_key: Option<String>

ttl: Option<u64>

tls: Option<bool>

addressing_style: Option<String>

Implementations

impl CosMapItem

pub fn has_hmac(&self) -> bool

Returns true if all three HMAC fields are present.

pub fn has_api_key(&self) -> bool

Returns true if an API‑key is present.

pub async fn ensure_credentials<F, Fut>( &mut self, bucket: &str, fetcher: Option<F>, ) -> Result<(), Box<dyn Error + Send + Sync>>

where F: FnOnce(String) -> Fut + Send, Fut: Future<Output = Result<String, Box<dyn Error + Send + Sync>>> + Send,

Ensure that some credential (HMAC or API key) is populated.

• If HMAC pair exists → OK
• Else if api_key exists → OK
• Else it calls the supplied async fetcher(bucket) which should return one of the accepted formats (see BucketCredential). The struct is then updated in‑place.

Trait Implementations

impl Clone for CosMapItem

fn clone(&self) -> CosMapItem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CosMapItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'py> IntoPyObject<'py> for CosMapItem

type Target = CosMapItem

The Python output type

type Output = Bound<'py, <CosMapItem as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for CosMapItem

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for CosMapItem

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<CosMapItem>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a CosMapItem

type Holder = Option<PyRef<'py, CosMapItem>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a mut CosMapItem

type Holder = Option<PyRefMut<'py, CosMapItem>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'a mut Self::Holder, ) -> PyResult<Self>

impl PyTypeInfo for CosMapItem

const NAME: &'static str = "CosMapItem"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl DerefToPyAny for CosMapItem