# gamie
A Rust library providing abstractions for several classic tiny games.
[](https://crates.io/crates/gamie)
[](https://docs.rs/gamie)
[](https://github.com/EAimTY/gamie/blob/master/LICENSE)
gamie provides simple, well-designed abstractions for several classic tiny games.
gamie has minimal dependencies and can be easily integrated into your projects.
## Usage
To use gamie, enable the desired feature flags in `Cargo.toml`. For example, to use `tictactoe`:
```toml
[dependencies]
gamie = { version = "0.10.0", features = ["std", "tictactoe"] }
```
Now you can use the Tic-Tac-Toe game abstraction:
```rust
use gamie::tictactoe::{Game, Status};
let mut game = Game::new().unwrap();
game.put(1, 1).unwrap(); // Player0 at center
game.put(0, 0).unwrap(); // Player1 at top-left
game.put(0, 2).unwrap(); // Player0 at top-right
game.put(2, 0).unwrap(); // Player1 at bottom-left
game.put(1, 0).unwrap(); // Player0 at middle-left
game.put(1, 2).unwrap(); // Player1 at middle-right
game.put(2, 1).unwrap(); // Player0 at bottom-center
game.put(0, 1).unwrap(); // Player1 at top-center
game.put(2, 2).unwrap(); // Player0 at bottom-right
assert_eq!(game.status(), &Status::Draw);
```
Check the [docs](https://docs.rs/gamie) for further information.
## Modules
Currently, the following modules are available:
- [connect_four](https://docs.rs/gamie/latest/gamie/connect_four)
- [gomoku](https://docs.rs/gamie/latest/gamie/gomoku)
- [minesweeper](https://docs.rs/gamie/latest/gamie/minesweeper)
- [reversi](https://docs.rs/gamie/latest/gamie/reversi)
- [tictactoe](https://docs.rs/gamie/latest/gamie/tictactoe)
## Serialize / Deserialize
Enable the `serde` feature to add serialization and deserialization support for game structs.
## no_std
This crate supports `no_std` environments and runs flawlessly on bare metal.
To remove the Rust standard library dependency, disable the `std` feature by setting `default-features = false` in `Cargo.toml`:
```toml
[dependencies]
gamie = { version = "0.10.0", default-features = false, features = ["tictactoe"] }
```
## License
GNU General Public License v3.0