maverick.card.Card

class maverick.card.Card(*, suit: Suit, rank: Rank)

A playing card with a suit and rank.

Fields

suitSuit

The suit of the card (Hearts, Diamonds, Clubs, Spades).

rankRank

The rank of the card (Two through Ace).

Examples

>>> from maverick import Card, Suit, Rank
>>> card = Card(suit=Suit.HEARTS, rank=Rank.ACE)
>>> card.utf8()
'A♥'

__init__(**data: Any) → None

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Methods

__init__(**data)	Create a new model by parsing and validating input data from keyword arguments.
code()	Return short canonical card code (e.g. Ah, Td, Ks).
construct([_fields_set])
copy(*[, include, exclude, update, deep])	Returns a copy of the model.
dict(*[, include, exclude, by_alias, ...])
from_orm(obj)
json(*[, include, exclude, by_alias, ...])
model_construct([_fields_set])	Creates a new instance of the Model class with validated data.
model_copy(*[, update, deep])	!!! abstract "Usage Documentation"
model_dump(*[, mode, include, exclude, ...])	!!! abstract "Usage Documentation"
model_dump_json(*[, indent, ensure_ascii, ...])	!!! abstract "Usage Documentation"
model_json_schema(by_alias, ref_template, ...)	Generates a JSON schema for a model class.
model_parametrized_name(params)	Compute the class name for parametrizations of generic classes.
model_post_init(context, /)	Override this method to perform additional initialization after __init__ and model_construct.
model_rebuild(*[, force, raise_errors, ...])	Try to rebuild the pydantic-core schema for the model.
model_validate(obj, *[, strict, extra, ...])	Validate a pydantic model instance.
model_validate_json(json_data, *[, strict, ...])	!!! abstract "Usage Documentation"
model_validate_strings(obj, *[, strict, ...])	Validate the given object with string data against the Pydantic model.
parse_file(path, *[, content_type, ...])
parse_obj(obj)
parse_raw(b, *[, content_type, encoding, ...])
random([n])	Generate n random cards without repetition.
schema([by_alias, ref_template])
schema_json(*[, by_alias, ref_template])
score()	Classifies and scores the card.
text()	Return human-readable text representation.
update_forward_refs(**localns)
utf8()	Return the UTF-8 representation of the card.
validate(value)

Attributes

model_computed_fields
model_config	Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
model_extra	Get extra fields set during validation.
model_fields
model_fields_set	Returns the set of fields that have been explicitly set on this model instance.
suit
rank

classmethod random(n: int = 1) → list[Card]

Generate n random cards without repetition.

score() → Tuple[HandType, float]

Classifies and scores the card.

Returns (HandType, float_score) where higher scores = stronger hands.

utf8() → str

Return the UTF-8 representation of the card.

code() → str

Return short canonical card code (e.g. Ah, Td, Ks).

text() → str

Return human-readable text representation.

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].