docs: added markdown for tools

Added markdown for several tools inside the cli

small fix

Author: d4rkstar

tools/base64.md

@@ -1,11 +1,6 @@
-
-# Tool base64
-
-base64 utility acts as a base64 decoder when passed the --decode (or -d) flag and as a base64 encoder
-otherwise.  As a decoder it only accepts raw base64 input and as an encoder it does not produce the framing
-lines.  base64 reads standard input or file if it is provided and writes to standard output.  Options
---wrap (or -w) and --ignore-garbage (or -i) are accepted for compatibility with GNU base64, but the latter
-is unimplemented and silently ignored.
+`base64` utility acts as a base64 decoder when passed the `--decode` (or -d) flag and as a base64 encoder
+otherwise. As a decoder it only accepts raw base64 input and as an encoder it does not produce the framing
+lines.
 
 ```text
 Usage:
@@ -22,16 +17,26 @@ Usage:
 
 ## Examples
 
-### Encoding: 
+### Encoding
 
 ```bash
 ops -base64 -e "OpenServerless is wonderful"
+```
+
+This will output:
+
+```text
 T3BlblNlcnZlcmxlc3MgaXMgd29uZGVyZnVs
 ```
 
-### Decoding: 
+### Decoding
 
 ```bash
-$ ops -base64 -d "T3BlblNlcnZlcmxlc3MgaXMgd29uZGVyZnVs"
+ops -base64 -d "T3BlblNlcnZlcmxlc3MgaXMgd29uZGVyZnVs"
+```
+
+This will output:
+
+```text
 OpenServerless is wonderful
 ```

tools/echoif.md

@@ -0,0 +1,20 @@
+`echoif` is a utility that echoes the value of `<a>` if the exit code of the previous command is 0,
+echoes the value of `<b>` otherwise
+
+```text
+Usage:
+    ops -echoif <a> <b>
+```
+
+## Example
+```bash
+  $( exit 1 ); ops -echoif "0" "1"
+  1
+```
+
+or
+
+```bash
+  $( exit 0 ); ops -echoif "0" "1"
+  0
+```

tools/echoifempty.md

@@ -0,0 +1,12 @@
+`echoifempty` is a utility that echoes the value of `<a>` if `<str>` is empty, echoes the value of `<b>` otherwise.
+
+```text
+Usage:
+    ops -echoifempty <str> <a> <b>
+```
+
+## Example
+
+```bash
+  ops -echoifempty "not empty string" "string is empty" "string is not empty"
+```

tools/echoifexists.md

@@ -0,0 +1,12 @@
+echoifexists is a utility that echoes the value of `<a>` if `<file>` exists, echoes the value of `<b>` otherwise.
+
+```text
+Usage:
+    ops -echoifexists <file> <a> <b>
+```
+
+## Example
+
+```bash
+  ops -echoifexists "exists" "doesn't exists"
+```

tools/empty.md

@@ -0,0 +1,12 @@
+`empty` creates an empty file - returns error if it already exists.
+
+```text
+Usage:
+    ops -empty <filename>
+```
+
+## Options
+
+```
+-h, --help             Display this help message
+```

tools/executable.md

@@ -0,0 +1,12 @@
+`executable` make a file executable: on Unix-like systems it will do a chmod u+x.
+On Windows systems it will rename the file to .exe if needed.
+
+```text
+Usage:
+    ops -executable <filename>
+```
+## Example
+
+```bash
+ops -executable kind
+```

tools/extract.md

@@ -0,0 +1,14 @@
+Extract one single file from a .zip .tar, .tgz, .tar.gz, tar.bz2, tar.gz.
+
+```text
+Usage:
+    ops -extract file.(zip|tgz|tar[.gz|.bz2|.xz]) target
+```
+
+## Example
+
+Extract file named `single.pdf` from `archive.zip` archive.
+
+```bash
+ops -extract archive.zip single.pdf
+```

tools/filetype.md

@@ -0,0 +1,27 @@
+Show extension and MIME type of a file.
+Supported types are documented [here](https://github.com/h2non/filetype?tab=readme-ov-file#supported-types)
+
+```text
+Usage:
+    ops -filetype [-h] [-e] [-m] FILE
+```
+
+## Options
+
+```
+-h  shows this help
+-e  show file standard extension
+-m  show file mime type
+```
+
+## Examples
+
+### File Mime type
+
+```bash
+ops -filetype -m `which ops`
+```
+
+This will output the ops executable type:
+``application/x-mach-binary`` or `application/x-executable`
+

tools/needupdate.md

@@ -0,0 +1,39 @@
+Check if a semver version A > semver version B.
+Exits with 0 if greater, 1 otherwise.
+
+```text
+Usage:
+    ops -needupdate <versionA> <versionB>
+```
+
+## Options
+
+```
+    -h, --help		 print this help info
+```
+
+## Examples
+
+### Update is needed
+
+```bash
+ops -needupdate 1.0.1 1.0.0; echo $?
+```
+
+This will output:
+
+```text
+0
+```
+
+### Update is not needed
+
+```bash
+ops -needupdate 1.0.0 1.0.1; echo $?
+```
+
+This will output:
+
+```text
+1
+```

tools/random.md

@@ -0,0 +1,40 @@
+Generate random numbers, strings and uuids
+
+```text
+Usage:
+    ops -random [options]
+```
+
+## Options
+
+```
+-h, --help  shows this help
+-u, --uuid  generates a random uuid v4
+--int  <max> [min] generates a random non-negative integer between min and max (default min=0)
+--str  <len> [<characters>] generates an alphanumeric string of length <len> from the set of <characters> provided (default <characters>=a-zA-Z0-9)
+```
+ 
+## Examples
+
+### Random uuid v4:
+
+```bash
+ops -random -u                 
+```
+
+This will output something like:
+
+```text
+5b2c45ef-7d15-4a15-84c6-29144393b621
+```
+
+### Random integer between max and min
+```bash
+ops -random --int 100 60
+```
+
+This will output something like:
+
+```text
+78
+```