rustubble

Beautifull components for your terminal.

Motive

This project aims to provide a set of components that can be used in your terminal applications.

Components

• TextInput Component
• TextArea Component
• Spinner Component
• Table Component
• Progress bar Component
• Timer Component
• Stopwatch Component
• Viewport Component
• List Component
• MenuList Component

TextInput Component

The TextInput component is a versatile and customizable input field designed for terminal-based applications using Rust. It supports Unicode, dynamic input handling, and comes with a variety of customization options to enhance user interaction.

Features

• Unicode Support: Handles Unicode input seamlessly.
• Dynamic Input Handling: Supports real-time input processing including pasting and deletion.
• Customization: Allows setting up padding, placeholder, initial text, and helper text.
• Cursor Management: Manages cursor positioning and ensures it is always placed correctly based on user interaction.

Usage

• Example Code

TextArea Component

A text area field, akin to an in HTML. Allows for input that spans multiple lines. Supports unicode, pasting, vertical scrolling when the value exceeds the width and height of the element, and many customization options.</p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/text_area_example.rs">Example Code</a></li> </ul> <h1>Spinner Component</h1> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/spinner.gif" alt="spinner" /></p> <p>The Spinner Component provides an easy-to-use and customizable loading animation for CLI applications written in Rust, utilizing the Crossterm library to handle terminal output. This component allows for a dynamic visual display during long-running operations.</p> <h2>Features</h2> <ul> <li><strong>Multiple Spinner Styles</strong>: Choose from a variety of predefined spinner styles including dots, lines, and more complex patterns.</li> <li><strong>Customizable Speed</strong>: Control the speed of the spinner animation.</li> <li><strong>Customizable Messages</strong>: Attach messages alongside the spinner to provide real-time feedback to users.</li> <li><strong>Easy Integration</strong>: Simple API for starting, updating, and stopping the spinner.</li> </ul> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/spinner_example.rs">Example Code</a></li> </ul> <h3>Customizing the Spinner</h3> <p>You can customize the spinner style and message at initialization. Here's how you can specify a different spinner style:</p> <pre><code class="language-rust">let spinner = Spinner::new("Dots2", "Loading resources..."); </code></pre> <p>Available styles include <code>Dots</code>, <code>Dots2</code>, <code>Dots3</code>, etc. Refer to the <code>spinner_data.rs</code> file for a complete list of available styles and their configurations.</p> <h2>Spinner Styles</h2> <p>The spinner styles are predefined in a <code>lazy_static</code> block within the <code>spinner_data.rs</code> file. Each style is represented by a unique key and includes an array of frames and an interval timing in milliseconds.</p> <p>Here’s an excerpt from the spinner styles definition:</p> <pre><code class="language-rust">lazy_static! { static ref SPINNERS: HashMap<String, SpinnerData> = { hashmap! { "Dots".into() => SpinnerData { frames: vec!["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"], interval: 80 }, // Additional spinner styles... } }; } </code></pre> <h1>Table Component</h1> <p>The <code>Table</code> component allows you to create a table in your terminal application using Rust. The component provides a flexible and customizable way to display data in a table format.</p> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/table.png" alt="table" /></p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/table_example.rs">Example Code</a></li> </ul> <h3>Customizing the Table</h3> <p>You can set the padding, the number of visible lines and the scroll offset of the table. Here's an example of how you can customize the table:</p> <pre><code class="language-rust">let mut table = Table::new(headers, data, 0, 3, 7); </code></pre> <p>You can set the position of the table on the view when rendering:</p> <pre><code class="language-rust"> let (x, y) = (5, 5); handle_table(&mut table, x, y); </code></pre> <h1>Progress bar Component</h1> <p>The <code>ProgressBar</code> component is a versatile and customizable loading animation for CLI applications written in Rust. This component allows for a dynamic visual display during long-running operations.</p> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/progress_bar.gif" alt="progress" /></p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/progress_bar_example.rs">Example Code</a></li> </ul> <h1>ViewPort Component</h1> <p>The <code>ViewPort</code> component allows you to create a viewport in your terminal application. The component provides a flexible and customizable way to display data in a <code>String</code> view format</p> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/viewport.gif" alt="viewport" /></p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/viewport_example.rs">Example Code</a></li> </ul> <h1>StopWatch Component</h1> <p>A simple component for counting down.</p> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/stopwatch.gif" alt="stopwatch" /></p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/stopwatch_example.rs">Example Code</a></li> </ul> <h1>Timer Component</h1> <p>A simple component for counting up.</p> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/timer.gif" alt="timer" /></p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/timer_example.rs">Example Code</a></li> </ul> <h1>List Component</h1> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/list.gif" alt="list" /></p> <p>A list component, build with ratatui.</p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/list_example.rs">Example Code</a></li> </ul> <h1>MenuList Component</h1> <p><img src="https://github.com/warpy-ai/rustubble/blob/main/assets/menulist.gif" alt="menulist" /></p> <p>A menu list component, build with ratatui.</p> <h2>Usage</h2> <ul> <li><a href="https://github.com/warpy-ai/rustubble/blob/main/examples/menu_list_example.rs">Example Code</a></li> </ul> <h2>Contribution</h2> <p>Contributions are welcome! If you have suggestions for improving the spinner or adding new styles, please open an issue or pull request on our GitHub repository.</p> <h2>License</h2> <p>This project is licensed under the Apache License - see the <a href="https://github.com/warpy-ai/rustubble/blob/main/LICENSE.md">LICENSE</a> file for details.</p> </div> Commit count: 72 <h2 class="title is-4">cargo fmt</h2> <div> </div> </div> </section> <footer class="footer"> <div class="content has-text-centered"> <p> Generated at 2024-12-14 10:39:41.140036535 UTC using version 0.1.0. <a href="/about">About</a> <a href="https://github.com/szabgab/rust-digger">source</a> </p> </div> </footer> </body> </html>