MahmoudEmad/herolib
1
0
Fork 0
Code Issues 55 Pull Requests 1 Actions Packages Projects Releases 26 Wiki Activity

fix: Rename freeflowuniverse to incubaid

Browse Source
This commit is contained in:
Mahmoud-Emad
2025-10-12 12:30:19 +03:00
parent 801c4abb43
commit 8f2d187b17
1593 changed files with 8753 additions and 8300 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
lib/osal/core/cmds.v
View File

@@ -1,11 +1,11 @@
module core
import os
import freeflowuniverse.herolib.core.pathlib
import freeflowuniverse.herolib.core
import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.pathlib
import incubaid.herolib.core
import incubaid.herolib.ui.console
// import regex
import freeflowuniverse.herolib.core.texttools
import incubaid.herolib.core.texttools
pub struct CmdAddArgs {
pub mut:
@@ -13,7 +13,7 @@ pub mut:
source string @[required] // path where the binary is
symlink bool // if rather than copy do a symlink
reset bool = true // if existing cmd will delete
// bin_repo_url string = 'https://github.com/freeflowuniverse/freeflow_binary' // binary where we put the results
// bin_repo_url string = 'https://github.com/incubaid/freeflow_binary' // binary where we put the results
}
// copy a binary to the right location on the local computer .

6
lib/osal/core/done.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.core.base
import freeflowuniverse.herolib.core.redisclient
import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.base
import incubaid.herolib.core.redisclient
import incubaid.herolib.ui.console
fn donedb() !&redisclient.Redis {
mut context := base.context()!

6
lib/osal/core/downloader.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.core.pathlib
// import freeflowuniverse.herolib.core.texttools
import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.pathlib
// import incubaid.herolib.core.texttools
import incubaid.herolib.ui.console
import os
@[params]

2
lib/osal/core/env.v
View File

@@ -1,6 +1,6 @@
module core
import freeflowuniverse.herolib.core.pathlib
import incubaid.herolib.core.pathlib
import os
@[params]

6
lib/osal/core/exec.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.core.texttools
// import freeflowuniverse.herolib.core.pathlib
import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.texttools
// import incubaid.herolib.core.pathlib
import incubaid.herolib.ui.console
import json
import os
import time

6
lib/osal/core/exec_to_scriptpath.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.core.texttools
import freeflowuniverse.herolib.core.pathlib
// import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.texttools
import incubaid.herolib.core.pathlib
// import incubaid.herolib.ui.console
// will return temporary path which then can be executed, is a helper function for making script out of command
pub fn cmd_to_script_path(cmd Command) !string {

6
lib/osal/core/file.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.core.texttools
import freeflowuniverse.herolib.core
import freeflowuniverse.herolib.ui.console
import incubaid.herolib.core.texttools
import incubaid.herolib.core
import incubaid.herolib.ui.console
import os
pub fn file_write(path string, text string) ! {

4
lib/osal/core/net.v
View File

@@ -2,8 +2,8 @@ module core
import net
import time
import freeflowuniverse.herolib.ui.console
import freeflowuniverse.herolib.core as herolib_core
import incubaid.herolib.ui.console
import incubaid.herolib.core as herolib_core
import math
import os

6
lib/osal/core/package.v
View File

@@ -1,8 +1,8 @@
module core
import freeflowuniverse.herolib.ui.console
import freeflowuniverse.herolib.core.texttools
import freeflowuniverse.herolib.core
import incubaid.herolib.ui.console
import incubaid.herolib.core.texttools
import incubaid.herolib.core
// update the package list
pub fn package_refresh() ! {

2
lib/osal/core/package_test.v
View File

@@ -1,6 +1,6 @@
module core
import freeflowuniverse.herolib.core
import incubaid.herolib.core
fn test_package_management() {
platform_ := core.platform()!

2
lib/osal/core/ps_tool.v
View File

@@ -3,7 +3,7 @@ module core
import time
import os
import math
// import freeflowuniverse.herolib.ui.console
// import incubaid.herolib.ui.console
pub enum PMState {
init

169
lib/osal/core/readme.md
View File

@@ -10,31 +10,31 @@ This module encapsulates essential OS-level features, making system programming
Execute shell commands with fine-grained control and robust error handling.
* **`osal.exec(cmd: Command)`**: Executes a command with extensive options.
* `Command` struct fields:
* `cmd` (string): The command string.
* `timeout` (int): Max execution time in seconds (default: 3600).
* `retry` (int): Number of retries on failure.
* `work_folder` (string): Working directory for the command.
* `environment` (map[string]string): Environment variables for the command.
* `stdout` (bool): Show command output (default: true).
* `raise_error` (bool): Raise V error on failure (default: true).
* `ignore_error` (bool): Do not raise error, just report.
* `debug` (bool): Enable debug output.
* `shell` (bool): Execute in interactive shell.
* `async` (bool): Run command asynchronously.
* `runtime` (RunTime): Specify runtime (e.g., `.bash`, `.python`).
* Returns `Job` struct with `status`, `output`, `error`, `exit_code`, etc.
* **`osal.execute_silent(cmd string)`**: Executes a command silently, returns output.
* **`osal.execute_debug(cmd string)`**: Executes a command with debug output, returns output.
* **`osal.execute_stdout(cmd string)`**: Executes a command and prints output to stdout, returns output.
* **`osal.execute_interactive(cmd string)`**: Executes a command in an interactive shell.
* **`osal.cmd_exists(cmd string)`**: Checks if a command exists in the system's PATH.
* **`osal.exec(cmd: Command)`**: Executes a command with extensive options.
* `Command` struct fields:
* `cmd` (string): The command string.
* `timeout` (int): Max execution time in seconds (default: 3600).
* `retry` (int): Number of retries on failure.
* `work_folder` (string): Working directory for the command.
* `environment` (map[string]string): Environment variables for the command.
* `stdout` (bool): Show command output (default: true).
* `raise_error` (bool): Raise V error on failure (default: true).
* `ignore_error` (bool): Do not raise error, just report.
* `debug` (bool): Enable debug output.
* `shell` (bool): Execute in interactive shell.
* `async` (bool): Run command asynchronously.
* `runtime` (RunTime): Specify runtime (e.g., `.bash`, `.python`).
* Returns `Job` struct with `status`, `output`, `error`, `exit_code`, etc.
* **`osal.execute_silent(cmd string)`**: Executes a command silently, returns output.
* **`osal.execute_debug(cmd string)`**: Executes a command with debug output, returns output.
* **`osal.execute_stdout(cmd string)`**: Executes a command and prints output to stdout, returns output.
* **`osal.execute_interactive(cmd string)`**: Executes a command in an interactive shell.
* **`osal.cmd_exists(cmd string)`**: Checks if a command exists in the system's PATH.
**Example: Flexible Command Execution**
```v
import freeflowuniverse.herolib.osal.core as osal
import incubaid.herolib.osal.core as osal
// Simple command execution
job := osal.exec(cmd: 'ls -la')!
@@ -79,90 +79,89 @@ if job_result.is_err() {
Tools for network diagnostics and information.
* **`osal.ping(args: PingArgs)`**: Checks host reachability.
* `PingArgs` struct fields: `address` (string, required), `count` (u8), `timeout` (u16), `retry` (u8).
* Returns `PingResult` enum: `.ok`, `.timeout`, `.unknownhost`.
* **`osal.tcp_port_test(args: TcpPortTestArgs)`**: Tests if a TCP port is open.
* `TcpPortTestArgs` struct fields: `address` (string, required), `port` (int), `timeout` (u16 in milliseconds).
* Returns `bool`.
* **`osal.ipaddr_pub_get()`**: Retrieves the public IP address. Returns `string`.
* **`osal.is_ip_on_local_interface(ip string)`**: Checks if an IP is on a local interface. Returns `bool`.
* **`osal.ping(args: PingArgs)`**: Checks host reachability.
* `PingArgs` struct fields: `address` (string, required), `count` (u8), `timeout` (u16), `retry` (u8).
* Returns `PingResult` enum: `.ok`, `.timeout`, `.unknownhost`.
* **`osal.tcp_port_test(args: TcpPortTestArgs)`**: Tests if a TCP port is open.
* `TcpPortTestArgs` struct fields: `address` (string, required), `port` (int), `timeout` (u16 in milliseconds).
* Returns `bool`.
* **`osal.ipaddr_pub_get()`**: Retrieves the public IP address. Returns `string`.
* **`osal.is_ip_on_local_interface(ip string)`**: Checks if an IP is on a local interface. Returns `bool`.
### 3. File System Operations (`file.v`)
Functions for managing files and directories.
* **`osal.file_write(path string, text string)`**: Writes text to a file.
* **`osal.file_read(path string)`**: Reads content from a file. Returns `string`.
* **`osal.dir_ensure(path string)`**: Ensures a directory exists, creates if not.
* **`osal.dir_delete(path string)`**: Deletes a directory if it exists.
* **`osal.dir_reset(path string)`**: Deletes and recreates a directory.
* **`osal.rm(todelete string)`**: Removes files/directories (supports `~`, comma/newline separated paths, sudo).
* **`osal.file_write(path string, text string)`**: Writes text to a file.
* **`osal.file_read(path string)`**: Reads content from a file. Returns `string`.
* **`osal.dir_ensure(path string)`**: Ensures a directory exists, creates if not.
* **`osal.dir_delete(path string)`**: Deletes a directory if it exists.
* **`osal.dir_reset(path string)`**: Deletes and recreates a directory.
* **`osal.rm(todelete string)`**: Removes files/directories (supports `~`, comma/newline separated paths, sudo).
### 4. Environment Variables (`env.v`)
Manage system environment variables.
* **`osal.env_set(args: EnvSet)`**: Sets an environment variable.
* `EnvSet` struct fields: `key` (string, required), `value` (string, required), `overwrite` (bool).
* **`osal.env_unset(key string)`**: Unsets an environment variable.
* **`osal.env_unset_all()`**: Unsets all environment variables.
* **`osal.env_set_all(args: EnvSetAll)`**: Sets multiple environment variables.
* `EnvSetAll` struct fields: `env` (map[string]string), `clear_before_set` (bool), `overwrite_if_exists` (bool).
* **`osal.env_get(key string)`**: Retrieves an environment variable's value. Returns `string`.
* **`osal.env_exists(key string)`**: Checks if an environment variable exists. Returns `bool`.
* **`osal.env_get_default(key string, def string)`**: Gets an environment variable or a default value. Returns `string`.
* **`osal.load_env_file(file_path string)`**: Loads environment variables from a file.
* **`osal.env_set(args: EnvSet)`**: Sets an environment variable.
* `EnvSet` struct fields: `key` (string, required), `value` (string, required), `overwrite` (bool).
* **`osal.env_unset(key string)`**: Unsets an environment variable.
* **`osal.env_unset_all()`**: Unsets all environment variables.
* **`osal.env_set_all(args: EnvSetAll)`**: Sets multiple environment variables.
* `EnvSetAll` struct fields: `env` (map[string]string), `clear_before_set` (bool), `overwrite_if_exists` (bool).
* **`osal.env_get(key string)`**: Retrieves an environment variable's value. Returns `string`.
* **`osal.env_exists(key string)`**: Checks if an environment variable exists. Returns `bool`.
* **`osal.env_get_default(key string, def string)`**: Gets an environment variable or a default value. Returns `string`.
* **`osal.load_env_file(file_path string)`**: Loads environment variables from a file.
### 5. Command & Profile Management (`cmds.v`)
Manage system commands and shell profile paths.
* **`osal.cmd_add(args: CmdAddArgs)`**: Adds a binary to system paths and updates profiles.
* `CmdAddArgs` struct fields: `cmdname` (string), `source` (string, required), `symlink` (bool), `reset` (bool).
* **`osal.profile_path_add_hero()`**: Adds `~/hero/bin` to profile. Returns `string` (path).
* **`osal.bin_path()`**: Returns the preferred binary installation path. Returns `string`.
* **`osal.hero_path()`**: Returns the `~/hero` directory path. Returns `string`.
* **`osal.usr_local_path()`**: Returns `/usr/local` (Linux) or `~/hero` (macOS). Returns `string`.
* **`osal.profile_path_source()`**: Returns a source command for the preferred profile. Returns `string`.
* **`osal.profile_path_source_and()`**: Returns a source command followed by `&&`. Returns `string`.
* **`osal.profile_path_add_remove(args: ProfilePathAddRemoveArgs)`**: Adds/removes paths from profiles.
* `ProfilePathAddRemoveArgs` struct fields: `paths_profile` (string), `paths2add` (string), `paths2delete` (string), `allprofiles` (bool).
* **`osal.cmd_path(cmd string)`**: Returns the full path of an executable command. Returns `string`.
* **`osal.cmd_delete(cmd string)`**: Deletes commands from their locations.
* **`osal.profile_paths_all()`**: Lists all possible profile file paths. Returns `[]string`.
* **`osal.profile_paths_preferred()`**: Lists preferred profile file paths for the OS. Returns `[]string`.
* **`osal.profile_path()`**: Returns the most preferred profile file path. Returns `string`.
* **`osal.cmd_add(args: CmdAddArgs)`**: Adds a binary to system paths and updates profiles.
* `CmdAddArgs` struct fields: `cmdname` (string), `source` (string, required), `symlink` (bool), `reset` (bool).
* **`osal.profile_path_add_hero()`**: Adds `~/hero/bin` to profile. Returns `string` (path).
* **`osal.bin_path()`**: Returns the preferred binary installation path. Returns `string`.
* **`osal.hero_path()`**: Returns the `~/hero` directory path. Returns `string`.
* **`osal.usr_local_path()`**: Returns `/usr/local` (Linux) or `~/hero` (macOS). Returns `string`.
* **`osal.profile_path_source()`**: Returns a source command for the preferred profile. Returns `string`.
* **`osal.profile_path_source_and()`**: Returns a source command followed by `&&`. Returns `string`.
* **`osal.profile_path_add_remove(args: ProfilePathAddRemoveArgs)`**: Adds/removes paths from profiles.
* `ProfilePathAddRemoveArgs` struct fields: `paths_profile` (string), `paths2add` (string), `paths2delete` (string), `allprofiles` (bool).
* **`osal.cmd_path(cmd string)`**: Returns the full path of an executable command. Returns `string`.
* **`osal.cmd_delete(cmd string)`**: Deletes commands from their locations.
* **`osal.profile_paths_all()`**: Lists all possible profile file paths. Returns `[]string`.
* **`osal.profile_paths_preferred()`**: Lists preferred profile file paths for the OS. Returns `[]string`.
* **`osal.profile_path()`**: Returns the most preferred profile file path. Returns `string`.
### 6. System Information & Utilities (`ps_tool.v`, `sleep.v`, `downloader.v`, `users.v`, etc.)
Miscellaneous system functionalities.
* **`osal.processmap_get()`**: Gets a map of all running processes. Returns `ProcessMap`.
* **`osal.processinfo_get(pid int)`**: Gets info for a specific process. Returns `ProcessInfo`.
* **`osal.processinfo_get_byname(name string)`**: Gets info for processes by name. Returns `[]ProcessInfo`.
* **`osal.process_exists(pid int)`**: Checks if a process exists by PID. Returns `bool`.
* **`osal.processinfo_with_children(pid int)`**: Gets a process and its children. Returns `ProcessMap`.
* **`osal.processinfo_children(pid int)`**: Gets children of a process. Returns `ProcessMap`.
* **`osal.process_kill_recursive(args: ProcessKillArgs)`**: Kills a process and its children.
* `ProcessKillArgs` struct fields: `name` (string), `pid` (int).
* **`osal.whoami()`**: Returns the current username. Returns `string`.
* **`osal.sleep(duration int)`**: Pauses execution for `duration` seconds.
* **`osal.download(args: DownloadArgs)`**: Downloads a file from a URL.
* `DownloadArgs` struct fields: `url` (string), `name` (string), `reset` (bool), `hash` (string), `dest` (string), `timeout` (int), `retry` (int), `minsize_kb` (u32), `maxsize_kb` (u32), `expand_dir` (string), `expand_file` (string).
* Returns `pathlib.Path`.
* **`osal.user_exists(username string)`**: Checks if a user exists. Returns `bool`.
* **`osal.user_id_get(username string)`**: Gets user ID. Returns `int`.
* **`osal.user_add(args: UserArgs)`**: Adds a user.
* `UserArgs` struct fields: `name` (string, required). Returns `int` (user ID).
* **`osal.processmap_get()`**: Gets a map of all running processes. Returns `ProcessMap`.
* **`osal.processinfo_get(pid int)`**: Gets info for a specific process. Returns `ProcessInfo`.
* **`osal.processinfo_get_byname(name string)`**: Gets info for processes by name. Returns `[]ProcessInfo`.
* **`osal.process_exists(pid int)`**: Checks if a process exists by PID. Returns `bool`.
* **`osal.processinfo_with_children(pid int)`**: Gets a process and its children. Returns `ProcessMap`.
* **`osal.processinfo_children(pid int)`**: Gets children of a process. Returns `ProcessMap`.
* **`osal.process_kill_recursive(args: ProcessKillArgs)`**: Kills a process and its children.
* `ProcessKillArgs` struct fields: `name` (string), `pid` (int).
* **`osal.whoami()`**: Returns the current username. Returns `string`.
* **`osal.sleep(duration int)`**: Pauses execution for `duration` seconds.
* **`osal.download(args: DownloadArgs)`**: Downloads a file from a URL.
* `DownloadArgs` struct fields: `url` (string), `name` (string), `reset` (bool), `hash` (string), `dest` (string), `timeout` (int), `retry` (int), `minsize_kb` (u32), `maxsize_kb` (u32), `expand_dir` (string), `expand_file` (string).
* Returns `pathlib.Path`.
* **`osal.user_exists(username string)`**: Checks if a user exists. Returns `bool`.
* **`osal.user_id_get(username string)`**: Gets user ID. Returns `int`.
* **`osal.user_add(args: UserArgs)`**: Adds a user.
* `UserArgs` struct fields: `name` (string, required). Returns `int` (user ID).
## Notes on the CMD Job Execution
* Commands are executed from temporary scripts in `/tmp/execscripts`.
* Failed script executions are preserved for debugging.
* Successful script executions are automatically cleaned up.
* Platform-specific behavior is automatically handled.
* Timeout and retry mechanisms are available for robust execution.
* Environment variables and working directories can be specified per command.
* Interactive and non-interactive modes are supported.
* Commands are executed from temporary scripts in `/tmp/execscripts`.
* Failed script executions are preserved for debugging.
* Successful script executions are automatically cleaned up.
* Platform-specific behavior is automatically handled.
* Timeout and retry mechanisms are available for robust execution.
* Environment variables and working directories can be specified per command.
* Interactive and non-interactive modes are supported.

2
lib/osal/core/ssh_key.v
View File

@@ -1,6 +1,6 @@
module core
import freeflowuniverse.herolib.core.pathlib
import incubaid.herolib.core.pathlib
import os
@[noinit]

4
lib/osal/core/users.v
View File

@@ -1,8 +1,8 @@
module core
import os
import freeflowuniverse.herolib.ui.console
import freeflowuniverse.herolib.core
import incubaid.herolib.ui.console
import incubaid.herolib.core
@[params]
pub struct UserArgs {