ratin — Custom input field for Ratatui TUI

Modular input field component for Ratatui terminal applications with character validation, cursor management, and customizable styling.

🚀 Quick Start

[dependencies]
ratin = "0.1.0"

use ratin::{InputField, CharValidator};

let validator = CharValidator::new()
    .allow_url_chars()
    .with_max_length(200);

let mut input = InputField::new()
    .with_validator(validator)
    .with_placeholder("Enter URL...")
    .with_max_length(100);

📋 Features

Input Field

Character Validator

Styling

🔧 Usage Examples

Basic Input

use ratin::InputField;

let mut input = InputField::new()
    .with_placeholder("Enter your name...")
    .with_max_length(50);

URL Input

use ratin::{InputField, CharValidator};

let validator = CharValidator::new()
    .allow_url_chars()
    .with_case_sensitive(false);

let mut input = InputField::new()
    .with_validator(validator)
    .with_placeholder("https://example.com...")
    .with_max_length(200);

Numeric Input

use ratin::{InputField, CharValidator};

let validator = CharValidator::new()
    .allow_digits()
    .with_max_length(10);

let mut input = InputField::new()
    .with_validator(validator)
    .with_placeholder("Enter number...")
    .with_max_length(10);

Custom Character Set

use ratin::{InputField, CharValidator};

let validator = CharValidator::new()
    .with_allowed_chars(vec!['a', 'b', 'c', '1', '2', '3']);

let mut input = InputField::new()
    .with_validator(validator)
    .with_placeholder("Enter a/b/c or 1/2/3...");

Custom Styling

use ratin::{InputField, InputStyle};
use ratatui::style::Color;

let style = InputStyle::new()
    .with_focused(Color::Green)
    .with_error(Color::Red)
    .with_processing(Color::Yellow)
    .with_text_color(Color::White)
    .with_placeholder_color(Color::DarkGray);

let mut input = InputField::new()
    .with_style(style)
    .with_placeholder("Styled input...");

Event Handling

use crossterm::event::{KeyCode};

loop {
    if let Event::Key(key) = event::read()? {
        if key.code == KeyCode::Enter {
            if let Err(e) = input.validate() {
                input.set_error(Some(e.to_string()));
            } else {
                let text = input.get_text();
                input.set_processing(true);
                // Process input...
            }
        } else if key.code == KeyCode::Esc {
            break;
        } else {
            input.handle_key(key.code, key.modifiers);
        }
    }
    
    terminal.draw(|f| {
        input.render(f, area);
    })?;
}

📦 Installation

From crates.io

cargo add ratin

From GitHub

[dependencies]
ratin = { git = "https://github.com/Fkernel653/ratin" }

🧩 Module Structure

ratin/
├── src/
│   ├── lib.rs          # Public API
│   ├── input.rs        # Main InputField logic
│   ├── style.rs        # Styling and themes
│   ├── validator.rs    # Character validation
│   └── error.rs        # Error types

🔌 Requirements

🎯 Key Features

• Character Validation — Restrict input to specific characters
• Cursor Management — Full cursor control with arrow keys
• Placeholder Support — Show hints when empty
• Processing State — Lock input during async operations
• Error Handling — Visual error feedback
• Max Length — Prevent overflow
• Case Sensitivity — Optional case-sensitive validation
• Clean API — Builder pattern for configuration

📄 License

MIT License — See License

Author: Fkernel653

Project: GitHub • Crates.io • Docs.rs