grux

A library for drawing grid-based user interfaces using ASCII characters.

```rs // Provides a uniform interface for drawing to a 2D grid. use grux::GridWriter;

// Create a 3x3 2D array. // Alternatives provided by grux: Vec<Vec<T>> and String. let mut grid = [[' '; 3]; 3];

// Draw some random stuff. In practice, you'd probably use a loop :P. grid.draw((0, 0), '╔'); grid.draw((1, 0), '═'); grid.draw((2, 0), '╗'); grid.draw((0, 1), '║'); grid.draw((2, 1), '║'); grid.draw((0, 2), '╚'); grid.draw((1, 2), '═'); grid.draw((2, 2), '╝');

// Provides a uniform interface for displaying a 2D grid. use grux::DisplayGrid;

// ╔═╗ // ║ ║ // ╚═╝ println!("{}", grid.to_string().unwrap()); ```

Why Grux?

There are plenty of existing libraries for terminal-based user interfaces, but none of them are quite what I wanted. I wanted a library that would let me draw a grid of cells, each of which could contain a single character.

Importantly, Grux isn't a UI framework.

It doesn't handle input or even output. It just lets you draw to a grid-like structure, which could be:

• A Vec<Vec<T>>
• A String
• A fixed-size 2D array (i.e. [[T; 10]; 10])
• Your custom data structure (just implement GridWriter and/or DisplayGrid)

tl;dr: Draw to whatever you want, and build on top of it (or replace it).