Struct DatasourceId

pub struct DatasourceId(/* private fields */);

A unique identifier for a datasource in the pipeline.

Datasource IDs are used to track the source of data updates and enable filtering of updates based on their origin. This is particularly useful when you have multiple datasources and want to process updates selectively.

Examples

Creating a datasource with a unique ID:

use carbon_core::datasource::DatasourceId;

let id = DatasourceId::new_unique();
println!("Generated ID: {:?}", id);

Creating a datasource with a named ID:

use carbon_core::datasource::DatasourceId;

let id = DatasourceId::new_named("mainnet-rpc");
println!("Named ID: {:?}", id);

Using with filters:

use carbon_core::{datasource::DatasourceId, filter::DatasourceFilter};

let datasource_id = DatasourceId::new_named("testnet");
let filter = DatasourceFilter::new(datasource_id);

Implementations

impl DatasourceId

pub fn new_unique() -> Self

Creates a new datasource ID with a randomly generated unique identifier.

This method uses a cryptographically secure random number generator to create a unique ID. The ID is converted to a string representation for easy debugging and logging.

Returns

A new DatasourceId with a unique random identifier.

Examples

use carbon_core::datasource::DatasourceId;

let id1 = DatasourceId::new_unique();
let id2 = DatasourceId::new_unique();
assert_ne!(id1, id2); // IDs should be different

pub fn new_named(name: &str) -> Self

Creates a new datasource ID with a specific name.

This method is useful when you want to assign a meaningful name to a datasource for easier identification and debugging.

Arguments

• name - A string slice containing the name for the datasource ID

Returns

A new DatasourceId with the specified name.

Examples

use carbon_core::datasource::DatasourceId;

let mainnet_id = DatasourceId::new_named("mainnet-rpc");
let testnet_id = DatasourceId::new_named("testnet-rpc");
assert_ne!(mainnet_id, testnet_id);

Trait Implementations

impl Clone for DatasourceId

fn clone(&self) -> DatasourceId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatasourceId

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

Formats the value using the given formatter.

impl Hash for DatasourceId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DatasourceId

fn eq(&self, other: &DatasourceId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DatasourceId

impl StructuralPartialEq for DatasourceId