NAME

Ordeal::Model::Deck - Class for representing decks of cards

SYNOPSIS

   use Ordeal::Model::Deck;

   my $card = Ordeal::Model::Deck->new(
      group => 'whatever',
      id => 'AAA-bb-1235',
      name => 'three of clubs',
      cards => \@cards,
   );

DESCRIPTION

This class represents a deck of cards. The representation is considered ordered, see Ordeal::Model::Shuffle for a wrapper object for shuffling the cards.

"id" should be a unique identifier for the deck. "cards" is the low-level accessor to the cards, although you shoud probably stick to the higher level interface provided by "card_at" and "n_cards".

"group" can be used to group decks together, e.g. for assigning them to owners. All in all it is opaque data that you can use.

"name" is a name you can associate to the deck. Again, it's treated as opaque data, so you can abuse it.

METHODS

card_at

   my $card = $deck->card_at($i);

get the card in position $i. Positions are assumed to start from 0 and arrive up to "n_cards" minus one. Invalid indexes $i trigger an exception.

cards

   my @cards = $deck->cards;
   $deck->cards(@cards);

accessor for the list of cards. Note that it accepts and returns a list not an array reference.

group

   my $group = $deck->group;
   $deck->group($group);

accessor for some c<group> metadata you might want to associate to the deck. Treated as opaque data.

id

   my $id = $deck->id;
   $deck->id($id);

accessor for a unique identifer associated to the deck.

name

   my $name = $deck->name;
   $deck->name($name);

accessor for a name associated to the deck.

n_cards

   my $n = $deck->n_cards;

returns the number of cards in the deck.

BUGS AND LIMITATIONS

The code leverages some experimental Perl features like signatures and postderef; for this reason, at least perl 5.20 will be needed.

Report bugs through GitHub (patches welcome) at https://github.com/polettix/Ordeal-Model.

AUTHOR

Flavio Poletti <polettix@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2018 by Flavio Poletti <polettix@cpan.org>

This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.