Enum ChecksumMismatch

#[non_exhaustive]
pub enum ChecksumMismatch {
    Crc32c(String),
    MD5(String),
    Both(String),
}

The error type for checksum comparisons.

By default the client library computes a checksum of the uploaded data, and compares this checksum against the value returned by the service.

Example

use std::error::Error as _;
let upload = client
    .upload_object("projects/_/buckets/my-bucket", "my-object", "hello world")
    .with_if_generation_not_match(0);
match upload.send().await {
    Ok(object) => println!("Successfully uploaded the object"),
    Err(error) if error.is_serialization() => {
        println!("Some problem {error:?} sending the data to the service");
        if let Some(m) = error.source().and_then(|e| e.downcast_ref::<ChecksumMismatch>()) {
            println!("The checksums did not match: {m}");
        }
    },
    Err(e) => return Err(e.into()), // not handled in this example
}

Troubleshooting

Data integrity problems are notoriously difficult to root cause. If you are using pre-existing, or pre-computed checksum values, you may want to verify the source data.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Crc32c(String)

MD5(String)

Both(String)

Trait Implementations

impl Debug for ChecksumMismatch

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

Formats the value using the given formatter.

impl Display for ChecksumMismatch

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

Formats the value using the given formatter.

impl Error for ChecksumMismatch

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.