bowling 0.2.0

A generic, typestate-driven bowling game engine
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

//! Per-game score card for one player's line.
//!
//! A [`ScoreCard`] owns the completed [`ScoredFrame`]s for one competitor.
//! It is intentionally **identity-free** and **ruleset-free**: it stores only
//! raw frame data. Cumulative scoring is done by the [`scoring`] module (or
//! via [`Game::scoreboard`](crate::game::Game::scoreboard)), which knows the
//! ruleset.
//!
//! [`scoring`]: crate::scoring

use crate::frame::scored::ScoredFrame;

/// A single competitor's completed frames for one game.
#[derive(Debug, Clone)]
pub struct ScoreCard {
    /// Completed frames in play order.
    frames: Vec<ScoredFrame>,
}

impl ScoreCard {
    /// Creates an empty score card.
    pub(crate) fn new() -> Self {
        Self {
            frames: Vec::with_capacity(12),
        }
    }

    /// Returns the completed frames.
    pub fn frames(&self) -> &[ScoredFrame] {
        &self.frames
    }

    /// Records a completed frame.
    pub(crate) fn push_frame(&mut self, frame: ScoredFrame) {
        self.frames.push(frame);
    }

    /// Returns how many frames have been completed.
    pub fn frames_completed(&self) -> u8 {
        #[expect(
            clippy::cast_possible_truncation,
            reason = "frame count is always <= 255"
        )]
        {
            self.frames.len() as u8
        }
    }
}