Skip to main content

App

Struct App

pub struct App { /* private fields */ }

Expand description

The main application state and driver for the interactive terminal user interface.

App owns:

The visual theme (LingoraTheme)
The AuditResult (shared across widgets/views)
The current application view state (AppViewState)

Responsibilities:

Initialize from configuration and audit result
Run the main event/draw loop
Delegate rendering to AppView (stateful widget)
Forward keyboard/mouse events to the view state
Manage cursor visibility and position

Implementations§

impl App

pub fn new(settings: LingoraToml, audit_result: AuditResult) -> Self

Creates a new App instance from settings and a completed audit result.

Initializes the theme
Wraps the audit result in Rc for shared access
Creates initial view state from settings and result

pub fn set_theme(self, theme: ThemeName) -> Self

Replaces the base theme and returns self (builder-style).

pub fn run(&mut self, terminal: &mut DefaultTerminal) -> Result<(), TuiError>

Runs the main TUI event/draw loop until the user quits.

Loop steps:

Draw current frame using AppView widget
Read next crossterm event
Handle event (keyboard, mouse, resize) via AppViewState
Repeat until state.is_running() returns false (usually on ‘q’ or Ctrl+C)

§Errors

Propagates terminal I/O or event reading failures as TuiError::Io.

Trait Implementations§

impl TryFrom<&TuiArgs> for App

type Error = TuiError

The type returned in the event of a conversion error.

fn try_from(value: &TuiArgs) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<LingoraToml> for App

type Error = TuiError

The type returned in the event of a conversion error.

fn try_from(settings: LingoraToml) -> Result<Self, Self::Error>

Performs the conversion.

Auto Trait Implementations§

impl !Freeze for App

impl !RefUnwindSafe for App

impl !Send for App

impl !Sync for App

impl Unpin for App

impl UnsafeUnpin for App

impl !UnwindSafe for App

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Any for T
where T: Any,

fn into_any(self: Box<T>) -> Box<dyn Any>

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

fn type_name(&self) -> &'static str

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<'src, T> IntoMaybe<'src, T> for T
where T: 'src,

type Proj<U: 'src> = U

fn map_maybe<R>( self, _f: impl FnOnce(&'src T) -> &'src R, g: impl FnOnce(T) -> R, ) -> <T as IntoMaybe<'src, T>>::Proj<R>
where R: 'src,

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T, S> SpanWrap<S> for T
where S: WrappingSpan<T>,

fn with_span(self, span: S) -> <S as WrappingSpan<Self>>::Spanned

Invokes WrappingSpan::make_wrapped to wrap an AST node in a span.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.