xterm-js-rs

Crates.ioxterm-js-rs
lib.rsxterm-js-rs
version0.1.2
sourcesrc
created_at2020-05-10 12:56:44.236277
updated_at2021-11-15 21:08:58.421477
descriptionRust-WASM bindings for the xterm-js Javascript library
homepagehttps://github.com/segeljakt/xterm-js-rs/
repositoryhttps://github.com/segeljakt/xterm-js-rs/
max_upload_size
id239624
size64,502
Klas Segeljakt (segeljakt)

documentation

README

🕸 xterm-js-rs 🦀

This crate provides Rust-WebAssembly bindings to the xterm-js Javascript library and can be used to setup a custom web-based command-line for your crate, without much effort, running at the client-side.

🎥 Example

To see it running in action on GitHub Pages: https://segeljakt.github.io/xterm-js-rs. Code for the example can be found here.

🚀 GitHub Actions and GitHub Pages

The GitHub Actions workflow for automatically deploying the website to GitHub Pages can be found here along with instructions to setup GitHub Pages.

🔬 Documentation

For an overview of what the bindings do, checkout the official API.

🎚 Addons

Conditionally, addons of xterm-js can be activated by compiling this crate with the corresponding features enabled:

  • xterm-addon-attach
  • xterm-addon-fit
  • xterm-addon-ligatures
  • xterm-addon-search
  • xterm-addon-serialize
  • xterm-addon-unicode11
  • xterm-addon-web-links
  • xterm-addon-webgl

⚠️ Information

If your npm-crate depends on this crate, then it must contain a package.json in the root directory and www directory which specifies the dependencies to the xterm-js library. As in the example:

👷 Help Wanted

Help with adding support for xterm-js-rs in existing Rust-REPL-libraries (linefeed, liner, rustyline, termwiz) is greatly appreciated!

😕 TODO

  • Add proper documentation, tests, and cleaner API.
Commit count: 46

cargo fmt