Skip to content

Releases: rhinonix/equasis-cli

v2.0.0 - Modern TUI with Ephemeral Menus

01 Oct 13:20
@rhinonix rhinonix
v2.0.0
d101915

Choose a tag to compare

View all tags
v2.0.0 - Modern TUI with Ephemeral Menus Latest
Latest

🎉 Major Release: v2.0.0

This is a major version release featuring a complete redesign of the interactive mode with modern TUI architecture, context-aware ephemeral menus, and significantly enhanced user experience.

✨ New Features

Modern TUI Architecture

  • prompt_toolkit Application Layout: Migrated from traditional cmd.Cmd to modern application framework
  • Fixed Output Area: Scrollable command history above, persistent prompt below
  • Gradient ASCII Art Banner: Beautiful magenta → purple → violet gradient styling
  • Context-Aware Ephemeral Menus: Smart menus that appear when needed and disappear when done
  • Vim/Less-Style Scroll Mode: Navigate output with j/k keys and position indicator

Interactive Menus

  • Help Menu (?): Context-aware command help that shows relevant commands based on current state
  • Slash Parameter Menu (Tab): Auto-complete available parameters for current command
  • Company Selection Menu: Interactive disambiguation when multiple companies match
  • Keyboard Navigation: Arrow keys, Enter, Escape with visual feedback
  • Smart Positioning: Menus appear at optimal screen positions

Enhanced Commands

  • Fleet Command Improvements:

    • Company search with automatic disambiguation
    • Interactive company selection menu for multiple matches
    • Robust P_COMP ID extraction from search results
    • Improved vessel name parsing from complex HTML structures

  • Search Command Enhancements:

    • Now uses general search endpoint for better results
    • Whitespace normalization for clean output
    • Automatic deduplication of responsive design duplicates
    • Position-based text extraction for accurate vessel names

Loading & Status

  • Animated Loading Indicators: Real-time progress with spinner and shine effects
  • Progressive Detail Display: Shows what's happening during long operations
  • Status Bar: Connection state, output format, and last operation result
  • Batch Progress: Real-time updates for multi-vessel operations

User Experience

  • Custom Syntax Highlighting: OutputLexer for beautiful output styling
  • Auto-Completion: SlashCommandCompleter for parameter suggestions
  • Command History: Up/Down arrows to recall previous commands
  • Color System: Enhanced with dim variants for UI chrome vs content
  • Improved Error Messages: Clear, actionable error information

🔧 Technical Improvements

  • Custom lexer for gradient ASCII art and syntax highlighting
  • Buffer-based layout with proper scroll management
  • Async-safe status updates and menu rendering
  • Robust HTML parsing with error recovery
  • Position-based text extraction algorithms
  • Window-based layout with proper buffer management

🐛 Bug Fixes

  • Fixed vessel name extraction with parentheses in fleet results
  • Fixed company search result parsing for P_COMP ID extraction
  • Fixed whitespace normalization in table cells
  • Fixed responsive design duplicate handling in search results
  • Improved error handling for malformed HTML responses

📦 Dependencies

Updated to require prompt_toolkit>=3.0.0 for modern TUI capabilities.

💡 Usage

Simply run equasis with no arguments to enter the new interactive mode:

```bash
equasis
```

Interactive Commands:

  • vessel /imo 9074729 - Get vessel information
  • search /name "MAERSK" - Search vessels by name
  • fleet /company "MSC" - Get fleet information with interactive selection
  • batch /imos "9074729,9632179" - Process multiple vessels
  • format json - Set default output format
  • ? - Show context-aware help menu
  • Tab - Show slash parameter menu
  • status - Show connection and configuration status

Scroll Mode (when output exceeds screen):

  • j / ↓ - Scroll down
  • k / ↑ - Scroll up
  • d - Page down
  • u - Page up
  • q - Exit scroll mode

🚀 Upgrade Notes

This is a major version release with breaking changes to the interactive mode implementation:

  • New dependency: prompt_toolkit>=3.0.0
  • Interactive mode completely redesigned (cmd.Cmd → Application)
  • Enhanced visual styling requires terminal color support
  • Improved but different command output formatting

To upgrade:
```bash
pip install --upgrade equasis-cli

or

pipx upgrade equasis-cli
```

📝 Full Changelog

See commit history for complete technical details of all changes.

Files Modified:

  • equasis_cli/interactive.py - Complete TUI rewrite
  • equasis_cli/banner.py - Added gradient banner and StatusBar
  • equasis_cli/client.py - Enhanced company/fleet search
  • equasis_cli/main.py - TUI integration
  • setup.py, equasis_cli/__init__.py, README.md - Version 2.0.0
  • requirements.txt - Updated dependencies

Full Commit: Implement modern TUI with context-aware ephemeral menus and bump version to 2.0.0

Assets 2
Loading

v1.0.0 - First Stable Release

27 Sep 10:10
@rhinonix rhinonix
v1.0.0
e98c6b7

Choose a tag to compare

View all tags
v1.0.0 - First Stable Release

Equasis CLI v1.0.0 - First Stable Release

Major update from beta: Now provides comprehensive vessel intelligence with 50+ data points including management companies, PSC inspections, historical names/flags, and classification details - all collected automatically from multiple Equasis tabs.

What's New in v1.0.0

Interactive Mode

  • REPL Interface: Type equasis to enter interactive mode
  • Slash Command Syntax: Modern /imo, /name, /company parameters
  • Persistent Sessions: Authenticate once, run multiple queries
  • Built-in Help: Comprehensive help system with examples

Comprehensive Data Collection

  • 3-Tab Strategy: Ship Info, Inspections, and Ship History
  • 50+ Data Points: Management companies, PSC inspections, historical data
  • Rich Parsing: Detailed vessel profiles vs basic lookups

Professional Experience

  • Modern Banner: Stylized startup interface
  • Multiple Formats: Table, JSON, CSV output
  • File Export: Save results with /output filename.ext
  • Dual-Mode: Interactive REPL or traditional CLI

Technical Features

  • Professional package structure
  • Comprehensive documentation
  • Color-coded interface with fallbacks
  • Session management and error handling

Installation

pipx install git+https://github.com/rhinonix/equasis-cli.git

Roadmap

See our GitHub Projects roadmap for planned features including batch processing, data caching, and maritime analytics.

License

Licensed under CC BY-NC-SA 4.0 - free for non-commercial use.

Loading