Struct CardQuery 

pub struct CardQuery<'a> { /* private fields */ }

Query interface for MTG cards backed by the cards parquet view.

Implementations

impl<'a> CardQuery<'a>

pub fn new(conn: &'a Connection) -> Self

Create a new CardQuery bound to the given connection.

pub fn get_by_uuid(&self, uuid: &str) -> Result<Option<Value>>

Retrieve a single card by its UUID.

pub fn get_by_uuids(&self, uuids: &[&str]) -> Result<Vec<Value>>

Retrieve multiple cards by their UUIDs (preserves order where possible).

pub fn get_by_name( &self, name: &str, set_code: Option<&str>, ) -> Result<Vec<Value>>

Get all printings of a card by exact name, optionally filtered by set code.

pub fn get_printings(&self, name: &str) -> Result<Vec<Value>>

Alias for get_by_name – returns all printings of the card.

pub fn get_atomic(&self, name: &str) -> Result<Vec<Value>>

Get a de-duplicated oracle-level card by name.

De-duplicates by (name, faceName). If no results are found for an exact name match, falls back to searching by faceName.

pub fn find_by_scryfall_id(&self, scryfall_id: &str) -> Result<Vec<Value>>

Find cards by their Scryfall ID (joins card_identifiers).

pub fn random(&self, count: usize) -> Result<Vec<Value>>

Return count randomly-sampled cards.

pub fn count(&self, filters: &HashMap<String, String>) -> Result<i64>

Count cards, optionally filtered by the supplied column/value pairs.

pub fn search(&self, params: &SearchCardsParams) -> Result<Vec<Value>>

Search for cards using a rich set of optional filters.

Translates each field of SearchCardsParams into appropriate SQL conditions (LIKE, exact match, fuzzy match, JOIN, list_contains, regexp, etc.).