#game-state #conway #grid #life #cell #iterate

conway-gol-rs

A Conway's Game of Life implementation in Rust

3 releases

0.1.2 Jun 22, 2024
0.1.1 Jun 22, 2024
0.1.0 Jun 22, 2024

#140 in Games

MIT license

8KB
139 lines

Conway's Game of Life

A Rust library implementation of Conway's Game of Life.

Features

  • Create a game grid of any size
  • Iterate the game state
  • Get and set individual cell states
  • Visualize the game state as a string

Installation

Add this to your Cargo.toml:

[dependencies]
conway_game_of_life = "0.1.0"

Usage

Here's a quick example of how to use the library:

use conway_game_of_life::ConwayGameGrid;

fn main() {
    // Create a 10x10 grid
    let mut game = ConwayGameGrid::new(10, 10);
    
    // Set some initial live cells
    game.set_cell_state(1, 1, true);
    game.set_cell_state(1, 2, true);
    game.set_cell_state(1, 3, true);

    // Run a single iteration
    game.iterate();

    // Print the current state
    println!("{}", game.dump());
}

API

ConwayGameGrid

The main struct representing the game grid.

Methods

  • new(width: usize, height: usize) -> Self: Create a new game grid.
  • iterate(&mut self): Advance the game state by one generation.
  • update_cells(&mut self, cells: &[UpdatedCell]): Update multiple cells at once.
  • get_cell_state(&self, row: usize, col: usize) -> Option<bool>: Get the state of a specific cell.
  • set_cell_state(&mut self, row: usize, col: usize, state: bool) -> bool: Set the state of a specific cell.
  • dimensions(&self) -> (usize, usize): Get the dimensions of the grid.
  • dump(&self) -> String: Get a string representation of the current grid state.

UpdatedCell

A struct representing a cell update.

Fields

  • row: usize: The row of the cell.
  • col: usize: The column of the cell.
  • state: bool: The new state of the cell.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

No runtime deps