libcoinche 0.4.0

A library to model the Coinche card game.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! This module implements a trick in a game of coinche.

use super::cards;
use super::points;
use super::pos;

/// The current cards on the table.
#[derive(Clone, serde::Serialize, Debug)]
pub struct Trick {
    /// Cards currently on the table (they are `None` until played).
    pub cards: [Option<cards::Card>; 4],
    /// First player in this trick.
    pub first: pos::PlayerPos,
    /// Current winner of the trick (updated after each card played).
    pub winner: pos::PlayerPos,
}

impl Trick {
    /// Creates a new, empty trick.
    pub fn new(first: pos::PlayerPos) -> Self {
        Trick {
            first,
            winner: first,
            cards: [None; 4],
        }
    }

    /// Returns the points value of this trick.
    pub fn score(&self, trump: cards::Suit) -> i32 {
        self.cards
            .iter()
            .map(|c| c.map_or(0, |c| points::score(c, trump)))
            .sum()
    }

    /// Plays a card.
    ///
    /// Updates the winner.
    ///
    /// Returns `true` if this completes the trick.
    pub fn play_card(
        &mut self,
        player: pos::PlayerPos,
        card: cards::Card,
        trump: cards::Suit,
    ) -> bool {
        self.cards[player as usize] = Some(card);
        if player == self.first {
            return false;
        }

        if points::strength(card, trump)
            > points::strength(self.cards[self.winner as usize].unwrap(), trump)
        {
            self.winner = player
        }

        player == self.first.prev()
    }

    /// Returns the starting suit for this trick.
    ///
    /// Returns `None` if the trick hasn't started yet.
    pub fn suit(&self) -> Option<cards::Suit> {
        self.cards[self.first as usize].map(|c| c.suit())
    }
}