Raxol.Terminal.TerminalUtils (Raxol v0.2.0)
View SourceUtility functions for terminal operations, providing cross-platform and consistent handling of terminal capabilities and dimensions.
Summary
Functions
Returns the current cursor position, if available.
Detects terminal dimensions using a multi-layered approach
Creates a bounds map with dimensions, starting at origin (0,0)
Gets terminal dimensions and returns them in a map format.
Functions
@spec cursor_position() :: {:ok, {pos_integer(), pos_integer()}} | {:error, term()}
Returns the current cursor position, if available.
@spec detect_dimensions() :: {pos_integer(), pos_integer()}
Detects terminal dimensions using a multi-layered approach:
- Uses
:io.columns
and:io.rows
(preferred) - Falls back to rrex_termbox v2.0.1 NIF if
:io
methods fail - Falls back to
stty size
system command if needed - Finally uses hardcoded default dimensions if all else fails
Returns a tuple of {width, height}.
@spec get_bounds_map() :: %{x: 0, y: 0, width: pos_integer(), height: pos_integer()}
Creates a bounds map with dimensions, starting at origin (0,0)
@spec get_dimensions_map() :: %{width: pos_integer(), height: pos_integer()}
Gets terminal dimensions and returns them in a map format.