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
//! This library provides example games and strategies implemented using the
//! [tit-for-tat (t4t)][t4t] library.
//!
//! The games are organized into modules, which define several related games and strategies for
//! playing them. The top-level documentation for each module provides a more detailed overview.
//!
//! # Dilemma games ([dilemma])
//!
//! This module defines a collection of 2x2 symmetric normal-form games, where each player may
//! cooperate or defect. It includes the classic [prisoner's dilemma][prisoner] game, along with
//! several related games such as [stag hunt][stag-hunt], [chicken][chicken], and more!
//!
//! The games in this module are typically played [repeated][repeated] several times, with the
//! payoffs accumulated.
//!
//! The module also includes [several well-known strategies][pd-strategies] for playing the
//! repeated forms of such games, including the famous [tit-for-tat strategy][tft-strategy] from
//! which the t4t library gets its name!
//!
//! # Rock-paper-scissors games ([rock_paper_scissors])
//!
//! This module defines [rock-paper-scissors][rps-game] plus a few variants of the classic game
//! that involve either more moves or more players.
//!
//! In particular, this module illustrates a very large variant of rock-paper-scissors involving
//! 100 players playing simultaneously, which is supported by t4t's normal form representation that
//! does not require representing the payoff matrix directly.
//!
//! # Tic-tac-toe ([tic_tac_toe])
//!
//! This module defines [tic-tac-toe][tic-tac-toe-game], illustrating how combinatorial games can
//! be defined by defining the game's state and describing the moves each player may make to modify
//! that state.
//!
//! The example in the module also illustrates t4t's built-in generic minimax strategy, which can
//! play small combinatorial games optimally.
//!
//! [t4t]: https://crates.io/crates/t4t
//! [prisoner]: https://en.wikipedia.org/wiki/Prisoner%27s_dilemma
//! [stag-hunt]: https://en.wikipedia.org/wiki/Stag_hunt
//! [chicken]: https://en.wikipedia.org/wiki/Chicken_(game)
//! [repeated]: https://en.wikipedia.org/wiki/Repeated_game
//! [pd-strategies]: http://www.prisoners-dilemma.com/common-strategy/
//! [tft-strategy]: https://en.wikipedia.org/wiki/Tit_for_tat
//! [rps-game]: https://en.wikipedia.org/wiki/Rock_paper_scissors
//! [tic-tac-toe-game]: https://en.wikipedia.org/wiki/Tic-tac-toe