<p align="center">
<img src="assets/cursive-multiplex.svg" height="128">
</p>
<h1 align="center">Welcome to cursive-multiplex 👋</h1>
<p align="center">
<a href="https://travis-ci.org/deinstapel/cursive-multiplex">
<img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fdeinstapel.github.io%2Fcursive-multiplex%2Fstable-build.json" alt="stable build">
</a>
<a href="https://travis-ci.org/deinstapel/cursive-multiplex">
<img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fdeinstapel.github.io%2Fcursive-multiplex%2Fnightly-build.json" alt="nightly build">
</a>
<a href="https://crates.io/crates/cursive-multiplex">
<img alt="crates.io" src="https://img.shields.io/crates/v/cursive-multiplex.svg">
</a>
<a href="https://docs.rs/cursive-multiplex">
<img alt="Docs.rs" src="https://docs.rs/cursive-multiplex/badge.svg">
</a>
<a href="https://github.com/deinstapel/cursive-multiplex/blob/master/LICENSE">
<img alt="GitHub" src="https://img.shields.io/github/license/deinstapel/cursive-multiplex.svg">
</a>
<a href="http://makeapullrequest.com">
<img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" target="_blank" />
</a>
<br>
<i>A tmux like multiplexer for
<a href="https://github.com/gyscos/cursive">gyscos/cursive</a>
views</i>
</p>
---
> This project is work-in-progress
This project provides a tiling window manager for [gyscos/cursive](https://github.com/gyscos/cursive) similar to Tmux. You can place any other `cursive` view inside of a `Mux` view to display these views in complex layouts side by side. Watch the demo below to see how it looks.
## How does it look like? `demo` [![terminalizer](https://img.shields.io/badge/GIF-terminalizer-blueviolet.svg)](https://github.com/faressoft/terminalizer)
<details>
<summary>Expand to view</summary>
<img src="assets/demo.gif" alt="Demo GIF">
</details>
## Usage
Simply add to your `Cargo.toml`
```toml
[dependencies]
cursive-multiplex = "^0.1.2
```
And then use `Mux::new` to create a new Mux view
```rust
let (mut mux, root_node) = cursive_multiplex::Mux::new(
cursive::views::TextView::new("Hello World!".to_string())
);
```
> Mux has defaults defined for key bindings. You can change them with the API described in the [docs](https://docs.rs/cursive-multiplex).
<details>
<summary>Expand to see default keybindings</summary>
<table>
<tr>
<th>Action</th>
<th>Key</th>
</tr>
<tr>
<td>Move focus up</td>
<td><code>↑</code></td>
</tr>
<tr>
<td>Move focus right</td>
<td><code>→</code></td>
</tr>
<tr>
<td>Move focus down</td>
<td><code>↓</code></td>
</tr>
<tr>
<td>Move focus left</td>
<td><code>←</code></td>
</tr>
<tr>
<td>Resize up</td>
<td><code>Ctrl</code> + <code>↑</code></td>
</tr>
<tr>
<td>Resize right</td>
<td><code>Ctrl</code> + <code>→</code></td>
</tr>
<tr>
<td>Resize down</td>
<td><code>Ctrl</code> + <code>↓</code></td>
</tr>
<tr>
<td>Resize left</td>
<td><code>Ctrl</code> + <code>←</code></td>
</tr>
</table>
</details>
### Adding views
You can add views by giving a path or an id to an existing node e.g.
```rust
let new_node = mux.add_right_of(
cursive::views::TextView::new("Foo"),
root_node,
).expect("adding right panel to root failed");
```
Its also possible to add views by their path.
```rust
if let Some(sibbling) = mux.root().right().right().down().build() {
let new_node = mux.add_above(
cursive::views::TextView::new("Foo"),
sibbling,
).expect("adding by path failed");
}
```
Returned will be a Result Ok contains the new id assigned to the view, or an error in case of failure.
### Removing Views
You can also remove views, by giving the id of the views.
```rust
mux.remove_id(new_node)?;
```
On success the id of the removed node is returned.
### Switch Views
If you want to reorder your views you can easily switch them by using
```rust
mux.switch_views(new_node, old_node)?;
```
## Troubleshooting
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.
## Development [![cargo test](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fdeinstapel.github.io%2Fcursive-multiplex%2Fcargo-test.json)](https://travis-ci.org/deinstapel/cursive-multiplex) [![shellshot](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fdeinstapel.github.io%2Fcursive-multiplex%2Fshellshot.json)](https://github.com/fin-ger/shellshot)
> TBD
### Running the tests
> :bangbang: **CAUTION** :bangbang: This crate uses Tmux for end2end testing and will **kill your Tmux server** during testing!
#### Preparing integration tests
In order to run the integration tests, you first need to install a recent version of `>=npm-10` and `>=tmux-2.6`!
After `npm` and `tmux` are installed, install required dependencies:
```
$ ./scripts/prepare-end2end-tests.sh
```
This will use `npm` to install `jest` and `shellshot` in the `tests` folder.
#### Running all test suites
Just run
```
$ cargo test
```
to execute all available tests.
#### shields.io endpoints
[shields.io](https://shields.io) endpoints are generated inside the `./target/shields` folder. They are used in this README.
## Authors
**Fin Christensen**
> [:octocat: `@fin-ger`](https://github.com/fin-ger)
> [:elephant: `@fin_ger@mastodon.social`](https://mastodon.social/web/accounts/787945)
> [:bird: `@fin_ger_github`](https://twitter.com/fin_ger_github)
<br>
**Johannes Wünsche**
> [:octocat: `@jwuensche`](https://github.com/jwuensche)
> [:elephant: `@fredowald@mastodon.social`](https://mastodon.social/web/accounts/843376)
> [:bird: `@Fredowald`](https://twitter.com/fredowald)
## Show your support
Give a :star: if this project helped you!