A view wrapper for gyscos/cursive views which aligns child views

This project provides an AlignedView for gyscos/cursive views which makes it possible to align the child view (center, left, right, top, bottom). The AlignedView uses the required_size reported by the child view and fills the rest of the available space with the views background color.

Expand to view

Simply add to your Cargo.toml

[dependencies]
cursive-aligned-view = "^0"

The easiest way to align a view is via the Alignable trait:

use cursive_aligned_view::Alignable;
let aligned = child_view.align_center();

This is the preferred way as it is chainable and consistent with cursive's Boxable and Identifiable traits.

As an alternative you can use the AlignedView constructors directly:

use cursive_aligned_view::AlignedView;
let aligned = AlignedView::with_center(child_view);

Look into the documentation for a detailed explanation on the API.

If you find any bugs/unexpected behaviour or you have a proposition for future changes open an issue describing the current behaviour and what you expected.

To perform the test it's advisable to install cargo-insta in case your tests fail and you want to inspect the received output.

$ cargo install cargo-insta

You will also need insta to validate new tests you add or update older ones.

Just run

$ cargo test

to execute all available tests.

Or if you want to interactively inspect failed tests

$ cargo insta test

shields.io endpoints are generated inside the ./target/shields folder. They are used in this README.

Fin Christensen

@fin-ger
🐘 @fin_ger@weirder.earth
🐦 @fin_ger_github

Johannes Wünsche

@jwuensche
🐘 @fredowald@mastodon.social
🐦 @Fredowald

Give a ⭐ if this project helped you!