added comments extensively

This commit is contained in:
Nilton Constantino
2026-01-19 07:47:54 +00:00
parent 0f3105d622
commit 13ecbd1877
10 changed files with 446 additions and 104 deletions
+17 -10
View File
@@ -3,6 +3,12 @@ use std::env;
use std::path::{Path, PathBuf};
use std::process::Command;
/// PROMETEU Dispatcher (CLI).
///
/// The main entry point for the user. This binary does not implement
/// compilation or execution logic itself; instead, it acts as a smart
/// front-end that locates and dispatches commands to specialized
/// components like `prometeu-runtime` or `prometeuc`.
#[derive(Parser)]
#[command(name = "prometeu")]
#[command(about = "Dispatcher for the Prometeu ecosystem", long_about = None)]
@@ -13,30 +19,31 @@ struct Cli {
#[derive(Subcommand)]
enum Commands {
/// Executes a cartridge
/// Executes a cartridge using the available runtime.
Run {
/// Path to the cartridge
/// Path to the cartridge (directory or .pmc file).
cart: String,
},
/// Debugs a cartridge
/// Executes a cartridge in Assisted Mode (Debug).
/// The runtime will wait for a DevTools connection before starting.
Debug {
/// Path to the cartridge
/// Path to the cartridge.
cart: String,
/// Port for the debugger (default: 7777)
/// TCP port for the DevTools server (default: 7777).
#[arg(long, default_value_t = 7777)]
port: u16,
},
/// Builds a project
/// Compiles a source project into a cartridge (PBC).
Build {
/// Project directory
/// Project source directory.
project_dir: String,
},
/// Packages a cartridge
/// Packages a cartridge directory into a distributable .pmc file.
Pack {
/// Cartridge directory
/// Cartridge directory.
cart_dir: String,
},
/// Verifies the integrity of a project or cartridge
/// Diagnostic commands to verify project or cartridge integrity.
Verify {
#[command(subcommand)]
target: VerifyCommands,