Components

Core components of the Consolix framework. More...

Files
file	include/consolix/components.hpp
	Entry point for including all Consolix components.
file	include/consolix/components/BaseLoopComponent.hpp
	Provides a base class for implementing looping application components.
file	include/consolix/components/CliComponent.hpp
	Component for handling command-line arguments using cxxopts library.
file	include/consolix/components/ConfigComponent.hpp
	Component for loading and managing configuration data from JSON files.
file	include/consolix/components/EventHubComponent.hpp
	Defines optional event-hub-cpp processing component.
file	include/consolix/components/LoggerComponent.hpp
	Logger component for managing application logging with LogIt.
file	include/consolix/components/LogoComponent.hpp
	Defines a component for displaying a customizable ASCII logo.
file	include/consolix/components/LoopComponent.hpp
	Defines a component for running a customizable execution loop.
file	include/consolix/components/ModuleHubComponent.hpp
	Defines optional event-hub-cpp ModuleHub processing component.
file	include/consolix/components/TitleComponent.hpp
	Component for managing console window titles in a platform-independent way.

Detailed Description

Core components of the Consolix framework.

The Components group includes modules that provide functionality such as logging, command-line argument handling, configuration management, logo rendering, and structured execution loops.

Main Components:

• TitleComponent: Manages the console window title across platforms.
  • Supports UTF-8 titles by converting them to UTF-16 on Windows.
  • On Linux/macOS, uses ANSI escape sequences for setting the title.
• LoggerComponent: Configures and manages logging functionality.
  • Uses MultiStream to provide consistent logging across platforms.
  • Supports UTF-8 output, with automatic conversion to CP866 on Windows for compatibility with legacy consoles.
  • Supports ANSI color codes for enhanced readability.
  • Integrates with LogIt (if enabled) for structured and multi-stream logging.
• LogoComponent: Displays the application logo in the console.
• CliComponent: Handles command-line arguments using the cxxopts library.
• ConfigComponent: Loads and manages configuration from JSON files.
• BaseLoopComponent: A base class for loop-based components.
• LoopComponent: A component with customizable execution loops.
• EventHubComponent: Optional bridge to event-hub-cpp EventBus and TaskManager.
• ModuleHubComponent: Optional bridge to event-hub-cpp ModuleHub.

Key Features:

• Easy integration of logging and logo rendering.
• Convenient handling of command-line arguments.
• Lightweight JSON configuration management, including support for comments.
• Support for custom execution loops using either a base class or the LoopComponent.
• Optional event-hub-cpp processing from the Consolix component loop.
• UTF-8 support for program titles on all platforms:
  • Automatically converted to UTF-16 on Windows for proper Unicode rendering.
  • Displayed via ANSI escape sequences on Linux/macOS.
• UTF-8 console output:
  • Uses MultiStream for consistent handling of log messages.
  • On Windows, UTF-8 is automatically converted to CP866 for legacy console compatibility.
  • Supports ANSI color sequences for improved readability.
• Integrates with LogIt (if enabled) for structured and multi-stream logging.

Included Headers:

• components/TitleComponent.hpp
• components/LoggerComponent.hpp
• components/LogoComponent.hpp
• components/CliComponent.hpp
• components/ConfigComponent.hpp
• components/BaseLoopComponent.hpp
• components/LoopComponent.hpp
• components/EventHubComponent.hpp when CONSOLIX_USE_EVENT_HUB=1
• components/ModuleHubComponent.hpp when CONSOLIX_USE_EVENT_HUB=1

Example Usage:

#define CONSOLIX_USE_LOGIT 1
#include <consolix/components.hpp>
 
int main(int argc, char* argv[]) {
    // Add logging functionality
    consolix::add<consolix::LoggerComponent>();
 
    // Display the application logo
    consolix::add<consolix::LogoComponent>(consolix::TextColor::DarkYellow);
 
    // Handle command-line arguments
    consolix::add<consolix::CliComponent>("MyApp", "Program description", [](auto& options) {
        options.add_options()("debug", "Enable debug mode");
    }, argc, argv);
 
    // Load configuration from a JSON file
    consolix::add<consolix::ConfigComponent<MyConfig>>("config.json");
 
    // Execute the main loop
    consolix::run([]() {
        CONSOLIX_STREAM() << "Executing main loop...";
    });
}