Struct CardDb 

pub struct CardDb {
    pub cards: Vec<CardStatic>,
    /* private fields */
}

Loaded card database with cached per-id lookups and compiled abilities.

Fields

cards: Vec<CardStatic>

Canonical list of static card definitions.

Implementations

impl CardDb

pub fn load<P: AsRef<Path>>(path: P) -> Result<Self>

Load a WSDB v2 file from disk.

pub fn from_wsdb_bytes(bytes: &[u8]) -> Result<Self>

Parse a WSDB v2 file from bytes.

pub fn from_postcard_payload(payload: &[u8]) -> Result<Self>

Parse the postcard payload (without WSDB header) into a CardDb.

pub fn schema_version() -> u32

Return the current WSDB schema version supported by this build.

pub fn to_bytes_with_header(&self) -> Result<Vec<u8>>

Serialize this database to a WSDB v2 byte buffer (including header).

impl CardDb

pub fn new(cards: Vec<CardStatic>) -> Result<Self>

Build a new database from raw card definitions.

Validates ids, canonicalizes templates, and builds per-id caches.

pub fn get(&self, id: CardId) -> Option<&CardStatic>

Look up a card by id. Returns None for invalid or zero ids.

pub fn max_card_id(&self) -> CardId

Maximum card id present in the index.

pub fn is_valid_id(&self, id: CardId) -> bool

Whether an id exists in this database.

pub fn power_by_id(&self, id: CardId) -> i32

Cached power value for a card id, or 0 if invalid.

pub fn soul_by_id(&self, id: CardId) -> u8

Cached soul value for a card id, or 0 if invalid.

pub fn level_by_id(&self, id: CardId) -> u8

Cached level value for a card id, or 0 if invalid.

pub fn cost_by_id(&self, id: CardId) -> u8

Cached cost value for a card id, or 0 if invalid.

pub fn color_by_id(&self, id: CardId) -> CardColor

Cached color value for a card id, defaulting to red.

pub fn card_type_by_id(&self, id: CardId) -> CardType

Cached card type for a card id, defaulting to character.

pub fn iter_card_abilities_in_canonical_order( &self, card_id: CardId, ) -> &[AbilitySpec]

Abilities in canonical order for a given card id.

pub fn compiled_effects_for_ability( &self, card_id: CardId, ability_index: usize, ) -> &[EffectSpec]

Compiled effects for a specific ability on a card.

pub fn compiled_effects_flat(&self, card_id: CardId) -> Vec<EffectSpec>

Flattened list of all compiled effects for a card.

Trait Implementations

impl Clone for CardDb

fn clone(&self) -> CardDb

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CardDb

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CardDb

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CardDb

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

where __S: Serializer,

Serialize this value into the given Serde serializer.