Struct scryfall::ruling::Ruling

pub struct Ruling {
    pub oracle_id: Uuid,
    pub source: Source,
    pub published_at: NaiveDate,
    pub comment: String,
}

A ruling object.

For documentation on it's fields refer to the ruling object on the official site.

Fields

oracle_id: Uuid

source: Source

published_at: NaiveDate

comment: String

Methods

impl Ruling

Important traits for PaginatedURI<T>

impl<T: DeserializeOwned> Iterator for PaginatedURI<T> type Item = Result<Vec<T>>;

pub fn multiverse_id(id: usize) -> PaginatedURI<Self>

Returns a List of rulings for a card with the given Multiverse ID. If the card has multiple multiverse IDs, this method can find either of them.

Examples

use scryfall::ruling::Ruling;
match Ruling::multiverse_id(3255).next() {
    Some(rulings) => assert_eq!(
        rulings
            .unwrap()
            .iter()
            .filter(|r| r.comment == "The ability is a mana ability, so it is activated and resolves as a mana ability, but it can only be activated at times when you can cast an instant. Yes, this is a bit weird.")
            .count(),
        1
    ),
    None => panic!("Nothing")
}

Important traits for PaginatedURI<T>

impl<T: DeserializeOwned> Iterator for PaginatedURI<T> type Item = Result<Vec<T>>;

pub fn mtgo_id(id: usize) -> PaginatedURI<Self>

Returns rulings for a card with the given MTGO ID (also known as the Catalog ID). The ID can either be the card’s mtgo_id or its mtgo_foil_id.

Examples

use scryfall::ruling::Ruling;
match Ruling::mtgo_id(57934).next() {
    Some(rulings) => assert_eq!(
        rulings
            .unwrap()
            .iter()
            .filter(|r| r.comment == "Yes, if the fourth mode is the only one remaining, you must choose it. You read the whole contract, right?")
            .count(),
        1
    ),
    None => panic!(),
}

Important traits for PaginatedURI<T>

impl<T: DeserializeOwned> Iterator for PaginatedURI<T> type Item = Result<Vec<T>>;

pub fn arena_id(id: usize) -> PaginatedURI<Self>

Returns rulings for a card with the given Magic: The Gathering Arena ID.

use scryfall::ruling::Ruling;
match Ruling::arena_id(67462).next() {
    Some(rulings) => assert_eq!(
        rulings
            .unwrap()
            .iter()
            .filter(|r| r.comment == "Once a chapter ability has triggered, the ability on the stack won’t be affected if the Saga gains or loses counters, or if it leaves the battlefield.")
            .count(),
        1
    ),
    None => panic!(),
}

Important traits for PaginatedURI<T>

impl<T: DeserializeOwned> Iterator for PaginatedURI<T> type Item = Result<Vec<T>>;

pub fn set_and_number(set: &str, number: u32) -> PaginatedURI<Self>

Returns a List of rulings for the card with the given set code and collector number.

Examples

use scryfall::ruling::Ruling;
match Ruling::set_and_number("ima", 65).next() {
    Some(rulings) => assert_eq!(
        rulings
            .unwrap()
            .iter()
            .filter(|r| r.comment == "If the target spell is an illegal target when Mana Drain tries to resolve, it won’t resolve and none of its effects will happen. You won’t get any mana.")
            .count(),
        1
    ),
    None => panic!(),
}

Important traits for PaginatedURI<T>

impl<T: DeserializeOwned> Iterator for PaginatedURI<T> type Item = Result<Vec<T>>;

pub fn uuid(id: Uuid) -> PaginatedURI<Self>

Returns a List of rulings for a card with the given Scryfall ID.

Examples

use scryfall::ruling::Ruling;
match Ruling::uuid("f2b9983e-20d4-4d12-9e2c-ec6d9a345787".to_string()).next() {
    Some(rulings) => assert_eq!(
        rulings
            .unwrap()
            .iter()
            .filter(|r| r.comment == "It must flip like a coin and not like a Frisbee.")
            .count(),
        1
    ),
    None => panic!(),
}

Trait Implementations

impl Clone for Ruling

fn clone(&self) -> Ruling

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Ord for Ruling

fn cmp(&self, other: &Ruling) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialOrd<Ruling> for Ruling

fn partial_cmp(&self, other: &Ruling) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Ruling) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Ruling) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Ruling) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Ruling) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialEq<Ruling> for Ruling

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Eq for Ruling

impl Debug for Ruling

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

Formats the value using the given formatter.

impl Hash for Ruling

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, 

Feeds a slice of this type into the given [Hasher].

impl Serialize for Ruling

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

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for Ruling

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.