Bonezegei Scripting Language Library: Pipe

The BSL_pipe library provides an essential and intuitive mechanism for Inter-Process Communication (IPC) within the Bonezegei Scripting Language environment. It introduces the concept of a unidirectional data channel (a pipe), allowing the output stream of one process or function to be seamlessly channeled as the input stream to another, executing processes in a sequential, stream-based manner.

Install using Package Installer

Note Go to the directory where the .bzg script is located

• Windows cmd

  bzg install pipe

• Linux Terminal

  sudo bzg install pipe

Usage

This code show how to use the pipe functions

//Include the pipe library
include("lib/pipe.bzg");

//pipe_open(<executable>) 
var pipe1 = pipe_open("bonezegei --info");
var pipe2 = pipe_open("bonezegei -v");

print("\nReading from Pipe1...");  // pipe_getline(<the pipe>)
var line = pipe_getline(pipe1);    // Reads the output stream of the executable
while (line != 0) {

    // This code removes the extra new line
    var size = sizeof(line);      
    line[size - 1] = " ";     

    print("Pipe1: " + line);
    line = pipe_getline(pipe1);
}

print("\nReading from Pipe2...");
var line = pipe_getline(pipe2);
while (line != 0) {

    var size = sizeof(line);
    line[size - 1] = " "; 

    print("Pipe2: " + line);
    line = pipe_getline(pipe2);
}

The example demonstrates how to use pipe_open and pipe_getline from the Bonezegei Scripting Language Pipe library to perform inter-process communication by capturing the output of external commands. The pipe_open function launches a specified executable (like "bonezegei–info" or "bonezegei-v") and returns a pipe object that connects to its output stream. This stream is then read line by line using pipe_getline, which retrieves each line until the end of the output is reached (signaled by a return value of 0). The code also trims the trailing newline from each line for cleaner display, allowing the script to process and print the output of external commands in a structured, readable format.