Struct GcsSourceConfig 

pub struct GcsSourceConfig {
    pub bucket: String,
    pub prefix: Option<String>,
    pub object_keys: Option<Vec<String>>,
    pub auth: GcsCredentials,
    pub file_format: GcsFileFormat,
    pub max_objects: Option<usize>,
    pub concurrency: usize,
    pub batch_size: usize,
    pub verify_length: bool,
    pub verify_checksum: bool,
    pub storage_host: Option<String>,
    pub compression: CompressionConfig,
}

Configuration for the GCS source connector.

Fields

bucket: String

GCS bucket name.

prefix: Option<String>

Object name prefix filter. Ignored when object_keys is set.

object_keys: Option<Vec<String>>

Explicit object names. When set, listing is skipped and prefix is ignored.

auth: GcsCredentials

Credential source.

file_format: GcsFileFormat

File format.

max_objects: Option<usize>

Hard cap on the number of objects read (after listing).

concurrency: usize

Maximum concurrent object reads (default: 10).

batch_size: usize

Records per emitted StreamPage. See “Streaming and batching” in the README. batch_size = 0 is the “no batching” sentinel and emits one page per object.

verify_length: bool

Verify each object’s byte length against the size GCS reports for it, failing the read with FaucetError::Source on a short (truncated) or over-long transfer (#161). Cheap (a byte counter over the body that is read anyway) and defaults to true. The check is automatically skipped for an object served with a non-empty Content-Encoding (GCS may decompressively transcode it on read, so the received byte count would not match the stored size).

verify_checksum: bool

Verify each object’s body against the CRC32C (or MD5) checksum GCS reports for it (#161). Stronger than the length check but costs a hash over the full body, so it defaults to false. Skipped for an object with no usable checksum or one served with a non-empty Content-Encoding (the stored checksum covers the stored bytes, which transcoding would not return).

storage_host: Option<String>

Optional storage-host override (e.g. http://localhost:4443 for fake-gcs-server). Production users should leave this unset.

compression: CompressionConfig

Available on crate feature compression only.

Compression codec applied to each downloaded object. Defaults to CompressionConfig::Auto — the codec is resolved per-object-key, so a single source can read a mix of compressed and uncompressed objects. Requires the crate-local compression feature.

Implementations

impl GcsSourceConfig

pub fn new(bucket: impl Into<String>) -> Self

Create a new config with the required bucket name and sensible defaults.

pub fn prefix(self, prefix: impl Into<String>) -> Self

pub fn object_keys(self, keys: Vec<String>) -> Self

pub fn auth(self, creds: GcsCredentials) -> Self

pub fn file_format(self, format: GcsFileFormat) -> Self

pub fn max_objects(self, max: usize) -> Self

pub fn concurrency(self, concurrency: usize) -> Self

pub fn with_batch_size(self, batch_size: usize) -> Self

pub fn storage_host(self, host: impl Into<String>) -> Self

pub fn verify_length(self, verify: bool) -> Self

Enable or disable the per-object length verification (default true). See verify_length.

pub fn verify_checksum(self, verify: bool) -> Self

Enable or disable per-object checksum verification (default false). See verify_checksum.

pub fn compression(self, c: CompressionConfig) -> Self

Available on crate feature compression only.

Set the compression codec. Available only with the compression feature.

Trait Implementations

impl Clone for GcsSourceConfig

fn clone(&self) -> GcsSourceConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GcsSourceConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GcsSourceConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for GcsSourceConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for GcsSourceConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.