AXSH.Library/ReadMe.ans at main · PhMajerus/AXSH.Library · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219

                              ]8;;http://www.majerus.net/[31mß[32mÜ[34mß[33mÜ[90m Majerus[3m.net[m]8;;
       [91;4mÜþÜ_[24;93mu[m         [1;4m [24m [4m [24m  [4m [24m  [4m [24m  [4m [24m     [4m [m                           [91;4m_ÜþÜ[m
      [37;4m [24;97;103mÝ[30m''[49;37;4m [24;34;104m±[m     [1;4m/\[24m  \[4m [24m/ ([4m [24m` ³[4m  [24m³     ³   ú ³[4m [24m  [4m  [24m  [4m [24m  [4m  [m         [37;4m [24;103;30m''[90m°[49;37;4m [m
     [94;4m/[24;43mÝ[90mÎ[94mV[90mÎ[94mÞ[49m/[m    [1;4m/[24m  [4m\[24m [4m/[24m [4m\[24m .[4m [24m) [4m³[24m  [4m³[24m  .  [4m³ [24m, [4m³[24m ³[4m [24m) [4m³[24m  .[4mÄ³[24m [4m³[24m  ([4m [24m³[m    [94;4m/[24;43mÝ[90mÎ[94mV[90mÎ[94mÞ[49;4m\[m
     [94;44m²[43;90;4mÍÊØÊÍ[m                                                [1;4m [24mõ[m    [94;44m²[43;90;4mÍÊØÊÍ[44;94;24m²[m
     [93mï[94mÞ[104;34mÄÒÄ[49;94mÝ[m                                                      [93mï[94mÞ[104;34mÄÒÄ[49;94mÝ[93mï[m
   [31;7;4mß[m [31;7;4mß[m[94mÞ[104;34mÄ[49;94;7m³[27;104;34mÄ[49;94mÝ[31;7;4mß[m [31;7;4mß[m         [32;7;4mß[m [32;7;4mß[m [32;7;4mß[m [32;7;4mß[m [32;7;4mß[m [32;7;4mß[m         [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m         [93;7;4mß[m [93;7;4mß[m[94mÞ[104;34mÄ[49;94;7m³[27;104;34mÄ[49;94mÝ[93;7;4mß[m [93;7;4mß[m
  [31mÞÛÛÛÛÛÛÛÛÛÛÛÝ[m       [32mÞÛÛÛÛÛÛÛÛÛÛÛÝ[m       [94mÞÛÛÛÛÛÛÛÛÛÛÛÝ[m       [93mÞÛÛÛÛÛÛÛÛÛÛÛÝ[m
 [90;7;4mß[m[31mÞÛÛÛÛÛÛÛÛÛÛÛÝ[90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m[32mÞÛÛÛÛÛÛÛÛÛÛÛÝ[90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m[94mÞÛÛÛÛÛÛÛÛÛÛÛÝ[90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m[93mÞÛÛÛÛÛÛÛÛÛÛÛÝ[90;7;4mß[m
[90mßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß[m

 Welcome to the AXSH.Library for Majerus.net ActiveScript Shell !

 [1;4mIntroduction[m

 ActiveScript Shell automatically loads and parses functions and modules
 installed into your Functions\ folders.
 One is located in its installation folder, and another can be provided in
 your Documents folder.
 Create a folder named "Majerus.net ActiveScript Shell" in your Documents\
 folder, such as "%UserProfile%\Documents\Majerus.net ActiveScript Shell\".
 Then, create a subfolder named Functions\ in that folder.
 Whenever you call a function that doesn't exist yet in your scripting
 environment, ActiveScript Shell will search for a file which name and
 language matches the function name.  If found, the content of the file
 is loaded and parsed on-demand, before executing the requested function.
 The same process is used for Modules, exposed as objects in your scripts.

 This project is a library of functions, modules, components and includes
 updated and distributed separately from ActiveScript Shell.
 It is designed to be copied to your own Functions\, Modules\, Components\
 and Include\ folders to extend AXSH original capabilities.

 If you write a collection of functions or modules of your own, you can
 request a pull so they can be evaluated for distribution with the library.
 Alternatively, if you create a collection of functions and/or modules for
 some specific needs, you can provide a similar library on its own.


 [1;4mFunctions for JScript[m
               [90;4m            [m
 awgToArea (n)  [90;4m           [m Convert wire AWG to cross-section area (mmý).
 binaryClock ()             Displays a clock in binary notation.
 bitsDots (number, [cbits]) Returns number in binary as colored dots.
 buildPascalTriangle ([r.]) Returns a triang. array of binomial coefficients.
 codebreaker ([c., c., c.]) Code Breaker logic guessing game.
 createPassword ([len]) [90;4m   [m Generates a random password.
 drawCards (cCards) [90;4m       [m Draws and shows cCards cards from a 52-cards deck.
 editFunc (func)         [90;4m  [m Edits a function using Windows Notepad.
 encodeScriptLiteral (s)    Encodes (obfuscates) JScript script source code.
 ES6LiteralToString (l,[s]) Converts an ES6 Unicode literal to a string.
 farey (value, [limit]) [90;4m   [m Rational approximations of floating-point numbers.
 fibonacci   [90;4m              [m An iterable object providing the Fibonacci seq.
 flipCoin ()           [90;4m    [m Flips a coin and shows result as ANSI-art.
 formatAsEighths (val) [90;4m    [m Format a number using n/8 fraction symbols.
 formatAsHalves (val)   [90;4m   [m Format a number using n/2 fraction symbols.
 formatAsQuarters (val)   [90;4m [m Format a number using n/4 fraction symbols.
 getBigDigitalClock ([t]) [90;4m [m Get the specified time as large LED-like text.
 getHashCode (val)          Variant hash function.
 getLEDGaugeBar (val,max,w) Get the specified value as LED gauge bars.
 getPublicIP ()             Get the public IP address of the computer.
 getSmallDigitalClock ([t]) Get the specified time as small LED-like text.
 getTargetURL (url)     [90;4m   [m Get the final target URL of a document or resource.
 getWebServerDate (url) [90;4m   [m Get current server date from specified URL.
 grep (text, regexp) [90;4m      [m Returns a string containing only lines that match
                  [90;4m         [m  a regular expression from a multi-lines text.
 higherOrLower ()         [90;4m [m Higher or Lower guessing game.
 himetricsToPixels (size) [90;4m [m Converts a number from OLE Size to pixels.
 listShellApps () [90;4m         [m List installed apps and their "shell:" commands.
 magic8Ball ()     [90;4m        [m A simple Magic 8-Ball response function.
 marquee (t,w,p,s)  [90;4m       [m Generates a marquee animation for AXSH.echo.
 numberLines (text)   [90;4m     [m Adds line number to a multi-line text string.
 paletteColor (index)       Converts a color palette index into an OLE Color.
 pixelsToHimetrics (pixels) Converts a number from pixels to OLE Size.
 pixelsToPoints (pixels) [90;4m  [m Converts a number from pixels to points.
 pointsToPixels (points) [90;4m  [m Converts a number from points to pixels.
 powerlinePrompt [90;4m          [m A powerline-style shell prompt.
 primeNumbers             [90;4m [m An iterable object providing prime numbers.
 Range (from, to, [step]) [90;4m [m Creates iterable range objects.
 remindMe (message, time) [90;4m [m Show a message at a specified time or interval.
 rgbComponents (color) [90;4m    [m Converts an OLE Color into red,green,blue values.
 rollDice ()     [90;4m          [m Rolls two dice and shows result as ANSI-art.
 saveFunc (func)            Saves a function to your Functions folder.
 ScriptEngineArchitecture() Returns the processor architecture of the system.
 ScriptEnginePlatform () [90;4m  [m Returns the operating system architecture.
 ScriptEngineVersion ()     Returns the complete version string of JScript.
 showBigDigitalClock ([t])  Show the specified time as large LED-like text.
 showHttpHeaders (url)   [90;4m  [m Lists HTTP response headers for specified URL.
 showNumberBits (number) [90;4m  [m Shows the binary representation of numbers.
 showPToE ()                Displays the Periodic Table of Elements.
 showSmallDigitalClock([t]) Show the specified time as small LED-like text.
 showStringBits (text)      Shows the hexadecimal representation of strings.
 showSurfaceDockFwVersion() Shows the Microsoft Surface Dock firmware version.
 showSysColors ()  [90;4m        [m Shows system colors as per current colors scheme.
 showVarBits (var) [90;4m        [m Shows the binary representation of Variables.
 showVMs ()                 Lists Hyper-V virtual machines with their states.
 sinebow (hue, sat, light)  Converts hue,saturation,lightness to OLE Color.
 stringToES6Literal(s,[sq]) Converts a string into an ES6 Unicode literal.


 [1;4mModules for JScript[m
           [90;4m                [m
 MorseCode [90;4m                [m A simple Morse Code encoder.
 Palette         [90;4m          [m A module to easily change the console palette.
    .standard ()      [90;4m     [m The default ActiveScript Shell palette.
    .standardLight () [90;4m     [m A light version of the standard palette.
    .even ()      [90;4m         [m Even brightness and evenly spaced colors palette.
    .evenLight () [90;4m         [m A light version of the even palette.
    .MDA () [90;4m               [m Changes the console palette to MDA monochrome.
    .CGA ()  [90;4m              [m Changes the console palette to CGA colors.
    .RGBI () [90;4m              [m Changes the console palette to RGBI (4-bit).
    .C64 () [90;4m               [m Changes the console palette to C=64 colors.
    .A2 ()            [90;4m     [m Changes the console palette to Apple II colors.
    .WindowsLegacy () [90;4m     [m Changes the console palette to legacy Windows.
    .Windows () [90;4m           [m Changes the console palette to modern Windows.
    .VSCode ()    [90;4m         [m Changes the console palette to VS Code colors.
    .Solarized ()      [90;4m    [m Changes console palette to Solarized palette.
    .SolarizedLight () [90;4m    [m Changes console palette to Solarized Light.
 SI  [90;4m                      [m A module to help with metric and SI conversions.
 XML [90;4m                      [m Encodes objects and arrays into XML.


 [1;4mFunctions and procedures for VBScript[m
               [90;4m            [m
 AWGToArea (N) [90;4m            [m Convert wire AWG to cross-section area (mmý).
 BinaryClock              [90;4m [m Displays a clock in binary notation.
 BitsDots (Number, cBits)   Returns number in binary as colored dots.
 BuildPascalTriangle (Rows) Returns a triang. array of binomial coefficients.
 Codebreaker Clrs, Hls, Tns Code Breaker logic guessing game.
 CreatePassword (Length) [90;4m  [m Generates a random password.
 DrawCards CCards        [90;4m  [m Draws and shows CCards cards from a 52-cards deck.
 EncodeScriptLiteral (S) [90;4m  [m Encodes (obfuscates) VBScript script source code.
 Farey (Value, Limit)  [90;4m    [m Rational approximations of floating-point numbers.
 FormatAsEighths (Val) [90;4m    [m Format a number using n/8 fraction symbols.
 FormatAsHalves (Val)   [90;4m   [m Format a number using n/2 fraction symbols.
 FormatAsQuarters (Val)     Format a number using n/4 fraction symbols.
 GetBigDigitalClock (Time)  Get the specified time as large LED-like text.
 GetHashCode (Val)          Variant hash function.
 GetLEDGaugeBar (Val,Max,W) Get the specified value as LED gauge bars.
 GetPublicIP              [90;4m [m Get the public IP address of the computer.
 GetSmallDigitalClock (T) [90;4m [m Get the specified time as small LED-like text.
 GetTargetURL (Url)     [90;4m   [m Get the final target URL of a document or resource.
 GetWebServerDate (Url)     Get current server date from specified URL.
 Grep (strText, strPattern) Returns a string containing only lines that match
               [90;4m            [m  a regular expression from a multi-lines text.
 HigherOrLower            [90;4m [m Higher or Lower guessing game.
 HimetricsToPixels (Size) [90;4m [m Converts a number from OLE Size to pixels.
 JSMath                  [90;4m  [m JScript native Math object for use in VBScript.
 ListShellApps NameSpecs [90;4m  [m List installed apps and their "shell:" commands.
 Magic8Ball        [90;4m        [m A simple Magic 8-Ball response function.
 Marquee (t,w,p,s)     [90;4m    [m Generates a marquee animation for AXSH.Echo.
 NumberLines (strText) [90;4m    [m Adds line number to a multi-line text string.
 PalColor (Index)           Converts a color palette index into an OLE Color.
 PixelsToHimetrics (Pixels) Converts a number from pixels to OLE Size.
 PixelsToPoints (Pixels) [90;4m  [m Converts a number from pixels to points.
 PointsToPixels (Points) [90;4m  [m Converts a number from points to pixels.
 PowerlinePrompt      [90;4m     [m A powerline-style shell prompt.
 PrimeNumber (Number)   [90;4m   [m Computes the first prime number ò given Number.
 RemindMe Message, Time     Show a message at a specified time or interval.
 ShowBigDigitalClock (Time) Show the specified time as large LED-like text.
 ShowByteBits ByteVal [90;4m     [m Shows the binary representation of Bytes.
 ShowCurBits Cur [90;4m          [m Shows the binary representation of Currency nmbrs.
 ShowDblBits Dbl [90;4m          [m Shows the binary representation of Double numbers.
 ShowDecBits Dec [90;4m          [m Shows the binary representation of Decimal numbers.
 ShowHlfBits Val     [90;4m      [m Shows the binary representation of Half numbers.
 ShowHttpHeaders Url [90;4m      [m Lists HTTP response headers for specified URL.
 ShowIntBits Int [90;4m          [m Shows the binary representation of Integer numbers.
 ShowLngBits Lng       [90;4m    [m Shows the binary representation of Long numbers.
 ShowLngLngBits LngLng [90;4m    [m Shows the binary representation of 64-bit numbers.
 ShowPToE                   Displays the Periodic Table of Elements.
 ShowSmallDigitalClock Time Show the specified time as small LED-like text.
 ShowSngBits Sng [90;4m          [m Shows the binary representation of Single numbers.
 ShowStrBits Str          [90;4m [m Shows the hexadecimal representation of Strings.
 ShowSurfaceDockFwVersion [90;4m [m Shows the Microsoft Surface Dock firmware version.
 ShowVarBits Var [90;4m          [m Shows the binary representation of Variants.
 ShowVMs                    Lists Hyper-V virtual machines with their states.
 Sinebow (Hue, Sat, Light)  Converts hue,saturation,lightness to an OLE Color.
 [90m+ Sound, InKey, Input, Locate, Swap, Go64  (from old BASIC interpreters)[m


 [1;4mModules for VBScript[m
           [90;4m                [m
 MorseCode [90;4m                [m A simple Morse Code encoder.
 Palette      [90;4m             [m A module to easily change the console palette.
    .Standard      [90;4m        [m The default ActiveScript Shell palette.
    .StandardLight [90;4m        [m A light version of the standard palette.
    .Even      [90;4m            [m Even brightness and evenly spaced colors palette.
    .EvenLight [90;4m            [m A light version of the even palette.
    .MDA [90;4m                  [m Changes the console palette to MDA monochrome.
    .CGA  [90;4m                 [m Changes the console palette to CGA colors.
    .RGBI [90;4m                 [m Changes the console palette to RGBI (4-bit).
    .C64 [90;4m                  [m Changes the console palette to C=64 colors.
    .A2            [90;4m        [m Changes the console palette to Apple II colors.
    .WindowsLegacy [90;4m        [m Changes the console palette to legacy Windows.
    .Windows [90;4m              [m Changes the console palette to modern Windows.
    .VSCode    [90;4m            [m Changes the console palette to VS Code colors.
    .Solarized      [90;4m       [m Changes console palette to Solarized palette.
    .SolarizedLight [90;4m       [m Changes console palette to Solarized Light.
 SI [90;4m                       [m A module to help with metric and SI conversions.


 [1;4mIncludes for VBScript[m
           [90;4m                [m
 Fibonacci [90;4m                [m A Fibonacci sequence class (pseudo-iterable).


 [1;4mWindows Script Components[m
                               [90;4m    [m
 "Scripting.CurrencyConverter" [90;4m    [m Currency (exchange rate) converter.
 "Scripting.JSON-js" [90;4m              [m JSON-js library as an Automation object.


   [31;7;4mß[m [31;7;4mß[m [31;7;4mß[m [31;7;4mß[m     [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m [94;7;4mß[m
  [31mÞÛÛÛÛÛÛÛÝ[m   [94mÞÛÛÛÛÛÛÛÝ[m        Last updated on February 3, 2024
  [31mÞÛÛÛÛÛÛÛÝ[32;7;4mß[m [32;7;4mß[m[94mÞÛÛÛÛÛÛÛÝ[93;7;4mß[m [93;7;4mß[m [93;7;4mß[m   Updates are available on our GitHub repository
        [32mÞÛÛÛÛÛÛÛÝ[m   [93mÞÛÛÛÛÛÛÛÝ[m   ]8;;https://github.com/PhMajerus/AXSH.Library/https://github.com/PhMajerus/AXSH.Library/]8;;
 [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m[32mÞÛÛÛÛÛÛÛÝ[90;7;4mß[m [90;7;4mß[m[93mÞÛÛÛÛÛÛÛÝ[90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m [90;7;4mß[m
[90mßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß[m