# bilderhic Bilderhic is a smart and simple command tool for automatization. ## How does it work? You have to create a pipe file. Bilderhic will run the commands inside your file. The commands of the pipe file can be Bilderhic commands, or bash / cmd commands. Bilderhic includes usefull commands for edit files. ## Installation Requires Node.js 18 or newer. ```bash npm i -g bilderhic ``` ## License [MIT](https://github.com/lcnvdl/bilderhic/blob/master/LICENSE) Third party licenses: * https://github.com/microsoft/tslib/blob/main/LICENSE.txt * https://github.com/isaacs/node-glob/blob/main/LICENSE * https://github.com/eemeli/yaml/blob/master/LICENSE * https://github.com/ReactiveX/rxjs/blob/master/LICENSE.txt ## Usage ```bash bhic [-vb or --verbose] [-d or --debug] or bhic [-vb or --verbose] [-d or --debug] [-c or --command] ``` ### ~ Bilderhic Commands ~ #### > env command ##### Description It allows you to create / load / edit environment variables (inside your process). ##### Usage > Set variable manually ```bash env set ``` > Set variable value (if the variable doesn't exists) ```bash env set-default ``` > Set variable from user input ```bash env prompt -m ``` > Adds a value to a numeric variable ```bash env add ``` > Load variables ```bash env load ``` > File.yml example ```yaml app: id: com.brand.app version: 2 description: This is an awesome Android Application. name: Awesomapp ``` > Usage of environment variables ```bash env load File.yml :open config.xml - set widget.id=[app.id] - set widget.android-versionCode=[app.version] - set widget.version=0.0.[app.version] - set widget>name=[app.name] - set widget>description=[app.description] - save - close ``` > Clear your environment ```bash env clear ``` > Change the debug mode ```bash env debug ``` #### > copy command ##### Description Copies a file or a folder. Override the files if it exists. ##### Usage ```bash copy [-i or --ignore ] [-q or --quiet] [-e or --ignore-errors] ``` #### > sync command ##### Description Synchronizes (mirror mode) two folders. Only writes the diferrences between the folders. ##### Usage ```bash sync [-i or --ignore ] [-q or --quiet] [-nd or --disable-delete] [--compare-by ] ``` ##### Compare Strategies - `--compare-by default` or `--compare-by hash`: Compares files by size first, then by MD5 hash if sizes match (default). - `--compare-by date-and-size` or `--compare-by date`: Compares files by size first, then by modification date if sizes match (faster, no hash computation). ##### Examples ```bash sync source dest sync source dest -i excludedFileOrDirectory sync source dest --compare-by hash sync source dest --compare-by date-and-size ``` #### > del command ##### Description Deletes a file o a folder (recursively) if exists. ##### Usage ```bash del ``` #### > cd command DOC ##### Usage ```bash cd cd cd --clear cd --back ``` #### > log command Writes a text to the configured loggers. ```bash log [info | warn | debug | error | success] ``` #### > mkdir command DOC #### > ren command Renames a file o a folder. ##### Usage ```bash ren [--skip-unexisting or -sk] [--overwrite or -o] ``` #### > base64 command ##### Description Parses a base-64 string. ##### Usage ```bash base64 or base64 > or base64 >> ``` ##### Example ```bash base64 YmlsZGVyaGlj > mistery.txt ``` #### > cat command ##### Description Reads a file and prints its content. ##### Usage ```bash cat or cat > or cat >> ``` ##### Example ```bash base64 YmlsZGVyaGlj > mistery.txt ``` #### > run command ##### Description Renames a file or a folder. ##### Usage ```bash ren [--overwrite or -w] ``` #### > exit command ##### Description Stops the pipe or the process. ##### Usage ```bash exit [pipe] or exit [] ``` #### > sleep command ##### Description Waits until timer ends. ##### Usage ```bash sleep ``` #### > beep command ##### Description Makes a console beep sound. ##### Usage ```bash beep [times] [delay between beeps] ``` ##### Examples ```bash echo Beep! beep echo Beep! Beep! beep 2 echo Beep! ... Beep! ... Beep! beep 3 1000 ``` ### ~ Special Commands ~ #### Pipe Open a new pipe from a file ```bash :pipe ``` #### Pipe line Open a new pipe from a line of code ```bash :pipeline ``` #### Each Open a new pipe from a list of folders or files ```bash :each folder [recursive] [async [limit x]] [filter] ``` ```bash :each file [recursive] [filter] ``` Example 1 ```bash :each folder :begin echo [$currentFolder] :end ``` Example 2 ```bash :each folder recursive :begin echo [$currentFolder] :end ``` Example 3 ```bash :each folder recursive **/node_* :begin echo [$currentFolder] :end ``` Example 4 ```bash :each folder **/node_* :begin echo [$currentFolder] :end ``` Example 5 ```bash :each folder async :begin echo [$currentFolder] :end ``` Example 6 ```bash :each folder async limit 5 :begin echo [$currentFolder] :end ``` #### Logger Adds a logger instance. ```bash :logger add [logger name] ``` Logger types: * File Example: ```bash :logger add file - set file logs.txt log Hello word! ``` #### Open Open a file editor ```bash :open [force a file format] ``` Example 1: Open a JSON file. ```bash :open settings.json - close ``` Example 2: Open a JSON file as a Text file. ```bash :open settings.json txt - close ``` #### Eval Run javacript code and saves the result to $eval (environment variable). ```bash :eval ``` Example: ```bash :eval +(new Date()) echo [$eval] ``` #### If If condition ```bash :if ``` ```bash :if :begin :end ``` #### Await Wait for all async commands to finish. ```bash :await ``` If you want to start an async command, you need to start it with a ~ character. Example: ```bash run echo This is a sync command ~run echo This is an async command :await ``` #### Bhic / Bilderhic It does nothing. It's useful for ensure that you are running a file on Bilderhic. ```bash !bhic or !bilderhic ``` ## File edition Text editors: TXT Object editors: XML, HTML, JSON ### ~ Text editors ~ ```bash - append ``` ```bash - set ``` ```bash - replace ``` ```bash - replaceone ``` ```bash - replace:raw ``` ```bash - replaceone:raw ``` ```bash - save ``` ```bash - close ``` ### ~ Object editors ~ ```bash - add = ``` ```bash - set = ``` ```bash - get > ``` ```bash - save ``` ```bash - close ``` ## Examples bhic pipe.txt bhic -c echo Hi world! bhic pipe.txt --set myVariable=myCustomValue ## Misc Multiple line command ```bash bhic -c echo Running :eol: sleep 5000 :eol: beep :eol: echo Run finished ``` Timestamp ```bash bhic -c echo My timestamp is [timestamp] ``` Date ```bash bhic -c echo Today is [date] ``` Date (custom format) ```bash bhic -c echo Today is [date:YYYY-MM-DD] ``` Time ```bash bhic -c echo The current time is [hour] ``` Time (custom format) ```bash bhic -c echo The current time is [hour:HH.MM] ```