Shellapi

Shellapi

SHELL API Full revision log

SHELL API Full revision log

Revision Date Log

188

2026-09-07 00:32:20

Changed: CHANGELOG.txt

187

2026-09-07 00:30:59

changed man section to 1 for genapp’s templates

186

2026-09-06 23:23:32

retro fix of v1.1.3’s manpage

185

2026-09-06 23:16:00

fixed tools/update-web.sh

184

2026-09-03 20:27:20

fixed an introduced typo bug in Array__toString

183

2026-09-03 18:51:21

Changed: README-version-upgrade.txt

182

2026-09-03 18:41:55

changed man section to 1 (completed)

181

2026-09-03 18:41:26

changed man section to 1

180

2026-09-03 18:37:55

Changed: CHANGELOG.txt. New: README-version-upgrade.txt tools/update-web.sh

179

2026-09-03 15:20:00

removed README.asciidoc.templ since useless after readme mgt simplification, further fix in Makefile, preparing release 1.1.3

178

2026-09-03 15:09:03

comments

177

2026-09-02 03:50:36

added _foreachLine, FilelsSignature, optimized ArraytoString

176

2026-09-01 16:37:22

fixed usage of 'av diff' in makefile following latest changes

175

2026-09-01 15:17:22

worked out file headers

174

2026-08-31 16:26:11

implemented links between api index and api doc details, added shellapi specific stylesheet, other improvs

173

2026-08-30 20:58:58

genapidoc improved adoc output

172

2026-08-30 20:15:18

inline doc format fixes and further improvs of genapidoc/genapidoc

171

2026-08-30 19:52:36

same as 170

170

2026-08-30 19:05:30

inline doc format fixes and further extensions of genapidoc/genapidoc

169

2026-08-30 18:11:24

first version of api doc generation

168

2026-08-28 23:22:55

simplified management of the README mainly intended for github; merged make’s doc and web targets

167

2026-08-28 23:18:52

'doc' target updates the release line in readme (was done initially, but then got lost in rev 163). 'doc' should be called prior to tagging the release

166

2026-08-28 22:53:28

cleaned up change log and inserting links to the online pages

165

2026-08-28 22:38:09

removed useless license file for genapidoc and put it under the global applying license

164

2026-08-28 22:27:27

switched to LGPL license for v1.1.2

163

2026-08-28 18:14:21

separated make target web and web_download as we wanna update web afterwards without having to impact download page with wrong package versions

162

2026-08-27 17:40:14

extended Array__toTextTable to enable to last field to span over remaining line using '**' field prefix

161

2026-08-27 17:09:12

fixed var name with typo

160

2026-08-27 10:06:51

improved Test__assertCmd

159

2026-08-25 18:13:48

Changed: README.asciidoc

158

2026-08-25 18:12:56

added _foreach3(), extended StrgetDiffLines() with additional params: start line no from which to check, end line no till to check, line numbers to be ignored, same extended params for TestassertCmdOutput()

157

2026-08-25 16:43:52

reordered some test functions

156

2026-08-25 15:08:21

Changed: README.asciidoc

155

2026-08-25 15:07:59

StrgetDiffLines : fixed bug and added param whether to ignore leading and trailing whitespaces for each compared line (false by default); added TestassertCmdOuput()

154

2026-08-25 11:35:43

adding the text mode (normal, underline etc) as entries in the color palette, also adapting other parts to preserve initial behavior (like key 'normal' which was used in resetColor* but was actually an empty string before)

153

2026-08-25 08:50:41

fixed setColored() and colorText()

152

2026-08-24 17:26:55

readme

151

2026-08-24 17:26:17

simplified make targets

150

2026-08-24 17:23:41

added Str__escapeXML()

149

2026-08-24 14:18:31

Changed: README.asciidoc

148

2026-08-24 13:53:42

added Test__assertCmdNotExit

147

2026-08-24 13:38:20

fixed makefiles following latest arcv changes

146

2026-08-24 13:17:05

Int_isInt now accepted negative numbers; Option handling improving by escaping option values starting with an hyphen (-) and fixed parsing of options with values for accepting '=' inside the value itself

145

2026-08-23 11:56:09

in Input__cursorSelect, the terminal color settings are reset before printing of prompt

144

2026-08-21 21:54:41

README no more autoupdated with list of packages as resulting in endless commit

143

2026-08-21 21:31:45

updated readme

142

2026-08-21 20:32:00

fix for 141

141

2026-08-21 20:28:36

reverting invalid 140 but generating doc before commit check

140

2026-08-21 20:23:00

updated README and updated Makefile to auto call update_vernum_in_files

139

2026-08-21 18:55:46

Changed: Makefile

138

2026-08-21 18:54:06

added Filerealpath as an attempt avoiding calling a process realpath (overal perf equal); added parameter to control field trimming in ArrayfromString

137

2026-08-20 20:44:09

added _foreach2() and StrgetDiffLines, Intmin(), File__dirSHA extended with a 4th parameter to return the data used to compute the fingerprint, and a 5th parameter for providing an explicitit input list of files instead of getting them via recursive ls

136

2026-08-18 20:28:27

shell-api now provides a hash computation algorithm which is more reliable across different systems

135

2026-08-18 17:11:47

fixed a bug related to last change in 134 when the choices exactly fit to full pages, selection could not move from the very first item of last page

134

2026-08-18 15:33:27

Input__cursorSelect - fixed arrow navigation beyond last item of a multipage selection

133

2026-08-17 18:30:39

added auto update of README.asciidoc

132

2026-08-17 17:56:02

added 'doc' target to makefile

131

2026-08-17 17:54:32

fixes for genapidoc

130

2026-08-17 17:26:16

integrated adoc doc generation implying 2 minor func name fixes for consistency; +_foreach(),+Arrayprint(),+Filelist(),+Fileforeach(),+Fileappend()

129

2026-08-16 20:34:14

addd Arrayconcat; in sys api, added Syspool_sweepall, forwarding more safely spawn argument when containing spaces, spawn now executes directly the passed arguments without passing through eval

128

2026-08-16 14:02:04

fixed/improved trim functions for specified trim char different of including special handling of '"' when used as trim char.

127

2026-08-16 12:49:03

Input__cursorSelect now displaying page number/total pages, fix Makefile for autoupdating of release version data in doc

126

2026-08-15 23:42:12

added late change log for 1.1.2

125

2026-08-15 23:25:17

Termclear extended with a line number parameter enabling to clear the terminal only from the specified line; added InputpressToContinue

124

2026-08-15 14:35:24

serious optimization of all string trimming functions; added Desktop__isAvailable; in test, encapsulated random test lines into functions so that to be able to run existing formal tests

123

2026-08-14 16:25:12

bug fix Input__cursorSelect: default value index was not handled properly when it was greater than the maximum number of displayable values per page

122

2026-08-14 13:35:20

extended Input__cursorSelect with additional features: the available terminal rowscan be forced to be reduced (this allows to tune menu size depending on the user messages heading on the terminal); simulated scrollbar with triangles now shown if menu spreads over multiple pages

121

2026-08-14 12:08:11

added missing file header in template avoid + minor optimization for not multiplying lowering and uppering case of appname

120

2026-08-13 11:39:54

Added StrgrepAndGetField, Strgrep, StrgetField. Fixed bug of FiledirSHA256 not restoring properly timezone after setting it to US/Pacific

119

2026-08-13 00:22:43

fixed bug in Str__fitToWidth

118

2026-08-12 18:06:43

fixed potential endless loop in Str__fitToLineWidth

117

2026-08-12 02:17:25

extended File__getSize to retrieve size of a folder

116

2026-08-12 01:08:24

extended Str__swap to enable alternating between 2 fixed values regardless of input var current value

115

2026-08-12 00:28:01

new _setColored() to enable some color managing code to be more efficient; additional parameter for Str__indent to control start line of indentation

114

2026-08-11 20:02:59

extended _colorText function to manage fore and background colors; fix in setTermColor; changed dependency handling of shell-api for arcv install: now the tool looks for a local shell-api dir which is a symbolic to a folder thereof holding the exact version, whereby genapp has been adapted accordingly to create automatically a symlink from the shell-api used for the generation

113

2026-08-11 16:06:12

shell-api pkg now installs in a folder containing the version number to allow multiple tools depending on it to use different shell api versions

112

2026-08-10 10:40:22

extended ArrayfromString and ArraytoTextTable with the ability not to interpret as an escape char, whereby Array__fromString has also been rewritten using read instead of readarray

111

2026-08-09 17:02:15

added Strhighlight; error message now displayed after usage following a usage error (_susage called); ArraycsvToTextTable converted to the more generic Array__toTextTable where separators can be given

110

2026-08-09 12:33:29

added Array__toString

109

2026-08-08 18:24:45

added Array__csvToTextTable

108

2026-08-08 17:06:23

improved generic options handling by checking that options AND commands (no dash) expecting a value are actually assigned one ; added check whether expected app-specific option variables are defined

107

2026-07-26 12:29:02

reverting changes of 106

106

2026-07-26 12:26:44

forcing copy to ftp in all case (see inlie comment)

105

2026-07-26 12:19:31

completion of 104

104

2026-07-26 12:00:45

updating also README.asciidoc when making a release

103

2026-07-26 11:59:37

applying fix of 102 which was only applied for genapp’s generated Makefile

102

2026-07-26 11:57:01

fix: there could be words in local language appearing in the generated man page (month at end of page)

101

2026-07-24 00:27:30

added File__deleteAllTempItems

100

2026-07-23 23:35:10

fix for rev 99

99

2026-07-23 23:08:00

extended template genapp Makefile with 'export' and 'upload' targets

98

2026-07-23 22:52:57

readme for github, added updated of webpage download table, updated changelog

97

2026-07-23 13:37:28

updated Array__fromString to trim field values

96

2026-07-23 11:20:37

deactivated undesired output on standard output

95

2026-07-22 17:11:02

fixed the _loada file sourcing macro for genapp-generated apps. Only impacts those related apps when using _loada

94

2026-07-22 16:00:26

added Sys__terminate

93

2026-07-22 15:12:52

implemented hash()

92

2026-07-22 15:04:27

implemented revision() and versionnum() functions

91

2026-07-22 12:19:43

genapp fix to enable appnames to contain '-'. In that case, the ..VARS variable is the appname in uppercase where '-' is replaced with ''

90

2026-07-21 22:01:18

fixed YAML__isntVoid and using a local syncfull.yml for uploading to FTP

89

2026-07-18 23:11:26

extended File__dirSHA256 with a 3rd parameter to supply a list of --ignore options for file patterns to be excluded from 'ls' command which output is used for the computing

88

2026-07-18 18:13:09

Forced upload even if source SHA256 didn’t change

87

2026-07-15 19:40:14

makefile fix

86

2026-07-15 01:42:28

fix in makefile

85

2026-07-15 01:41:01

84

2026-07-15 01:36:59

hash cleanup

83

2026-07-14 23:36:00

fixed for MANPAGE.txt generation

82

2026-07-14 23:33:50

Changed manpage generation to limit paging width in a terminal

81

2026-07-14 20:29:13

Changed: Makefile

80

2026-07-14 20:27:00

fixed arcv usage

79

2026-07-14 20:26:30

updated makefile for ftp upload

78

2026-07-13 10:30:35

added Str__isWord

77

2026-07-10 00:46:39

added unformal tests regarding Strjustify and StrfitToLineWidth

76

2026-07-09 20:18:53

fixed man output in sOptions

75

2026-07-09 18:52:55

smarter output of _options() and _optionsN() in the same way as sOptions(), ensuring description lines have ~equal width

74

2026-07-09 18:37:44

added StrlineCount, StrlinesToArray, StrfitToLineWidth, Strjustify, removed old() functions, improved comments

73

2026-07-09 03:00:04

updated man page

72

2026-07-09 02:48:39

updated genapp help and man according to latest shellapi

71

2026-07-09 02:26:33

fix for help display: using printf instead of echo because the problem when "-n" is part of the string to display (interpreted as option -n); fix for last commit to use complete option key for sorting not just the one before |

70

2026-07-09 01:24:16

added Array__getSortedArray and now sorting all options alphabetically

69

2026-07-06 17:29:06

added TestassertFileContainsLine and NetMAC

68

2026-07-06 13:16:42

added Input__testForcedInput

67

2026-07-06 12:41:28

added debug output (commented)

66

2026-07-05 20:56:20

generalized use of temp file api. fixed _exit which should call _cleanup as well. temp files now prefixed with app name.added Test__assertCmdExit

65

2026-07-04 20:53:47

added ArrayfromString and TestassertDirsShouldExist

64

2026-06-24 19:20:09

added TestassertTwoCommandsSameOutput; fixed FiledirSHA256 to be make it more robust , ie independent of owner and group, independent of directory times (and no time sorting)

63

2026-06-22 17:45:32

improv display of Test__assertSameFiles

62

2026-06-22 17:38:56

fixed and improv display of Test__assertSameFiles

61

2026-06-21 21:01:47

added Str__padded

60

2026-06-21 14:57:19

added 2 functions in Test API

59

2026-06-20 18:32:48

added _resetDependenciesCache to enable forcing loading of all or a specific dependency

58

2026-06-16 12:08:16

fixed makefile for not updating unchanged generated man related files and not compromising hash

57

2026-06-16 12:02:51

hash cleanup

56

2026-06-16 10:43:39

handling of copyright in file headers both for original src and released src; improved makefile output when run

55

2026-06-14 20:01:29

fix makefile

54

2026-06-14 19:59:38

Deleted: tm

53

2026-06-14 19:59:20

Changed: Makefile. New: tm

52

2026-06-14 19:52:50

fixed Makefile for not alterating generated man page if content does not change

51

2026-06-14 15:52:57

added builtin option handling for --revision and --hash

50

2026-06-14 15:45:35

extended resolution of shell-api location: either given by env var ENV_SHELL_API, or to be found either inside the generated app folder, or in its parent

49

2026-06-14 15:24:27

added revision and hash in generated apps

48

2026-06-14 13:04:59

improv handling of REVISION.txt in makefile

47

2026-06-14 13:04:08

added generation of REVISION.txt in makefile generated by genapp

46

2026-06-14 11:57:04

cleanup

45

2026-06-14 11:45:46

genapp - reviewed the __version generated functions to be more generic (retrieves full user name) and include revision infos when available

44

2026-06-11 02:41:05

added auto deps loading, fixed File__dirSHA256 for using -A instead of -a in ls cmd for not including . and ..

43

2026-06-10 17:50:52

update manual page

42

2026-06-10 16:37:54

added _log_if, _log_ifnot

41

2026-06-10 15:55:54

added Str__toCharArray and enabling option combinations (eg -ym for -y -m)

40

2026-06-10 12:45:18

completed change log

39

2026-06-10 12:01:23

Input__cursorSelect: predefined prompt can now be extended using '+' as 1st char, added 9th param to return value of sections greater than 255

38

2026-06-09 18:00:34

input__cursor : limiting displayed width of menu items to the terminal width and minor robustness fixes

37

2026-06-09 12:19:37

cleanup

36

2026-06-07 23:05:36

Extended net api with: NetgetDeviceName, NetgetDeviceMAC, NetgetMAC. pack api: fix DPKGexists, oneline status info line for dpkg downloading. yaml api: added YAMLisUndefined to test if value is empty or 'null'. extended core api: added _isLoadDepCached, _loadVDep to allow to load a package that may exist or not for the distro, Strswap for transient variable value, StrreplaceOne, a certain number of basic File* function, most important is File__dirSHA256, Improved message output of the test api

35

2026-06-05 12:24:18

added handling of help function 'xxx__versionnum'

34

2026-06-04 19:18:35

fixed the signal trapping and handling

33

2026-06-03 15:59:15

added some comments

32

2026-06-03 13:03:58

bugfix - strings starting with '' where removed when appearing as first line of a multiline string#

31

2026-06-03 12:26:04

extended test api

30

2026-06-02 19:02:25

added an api to manage temporary dirs and files

29

2026-06-02 14:47:25

added Int__getIntTrail

28

2026-06-01 19:08:01

in genapp template makefile, adding cleaning of release folder after deb pkg build; added deps to required input files to build release

27

2026-06-01 18:26:14

add _optionsN() a better variant than _options() to display actual arg types; extended soptions() to work in manpage mode; added Input__confirm_high

26

2026-05-31 19:28:00

added TestassertSymlinkPath; also default initializing forceInput vars since they may hold undesired values when not , whereby it could produce endlessloops in Input__sentence

25

2026-05-31 13:16:25

extended test API

24

2026-05-29 17:49:11

added --config in genapp

23

2026-05-26 00:12:48

added InputtestYesForcedInput(); fixed endless loop in Inputsentence when forced -y is specified, now returning directly default value

22

2026-05-22 16:16:07

fixed option help in case of a dashless option (command) not requiring '='

21

2026-05-22 03:50:50

added Str__eraseCommonTail() and added builtin cfg param 'default app options' which enables to inject default parameters at each app launch

20

2026-05-21 04:55:44

added a filter parameter for the builtin *options function in order to display only strict options starting with - and commands not starting with -

19

2026-05-21 03:51:04

updated doc with --log option now also generated

18

2026-05-21 03:36:04

added default generated option --log

17

2026-05-21 03:03:16

fixed generated man description in Makefile

16

2026-05-21 02:57:59

moved template_pack to templates folder

15

2026-05-21 02:54:57

added generation of the man and cleanup EXAMPLES.txt from initial GENAPP_EXAMPLES.txt

14

2026-05-21 02:29:28

moved templates into a separate folder

13

2026-05-21 02:22:33

cleanup

12

2026-05-20 21:49:03

update/extended template app for genapp, various addons

11

2026-05-19 02:31:19

extended default genapp skeleton

10

2026-05-19 00:35:15

improved _appendConfig by removing any prior existing config param for not creating duplicates if operation is performed multiple times

9

2026-05-18 16:57:06

added github.txt + fix comment in yaml

8

2026-05-18 16:49:03

fixed make export following arcv usage change

7

2026-05-18 16:48:11

fixed make export following arcv usage change

6

2026-05-18 16:17:52

update makefile to manage tagging and export to github

5

2026-05-18 14:52:41

in Input__coonfirm, added forced input 'no' along the 'yes'

4

2026-05-16 03:10:30

cleanup

3

2026-05-16 03:09:21

completed genapp with 'verbose' option, default config file callback ; shell api: Input__memsize allowing function to abort on invalid input depending on passed bool

2

2026-05-15 19:01:20

added dpkg dep, fix copyright notice to initial state

1

2026-05-15 17:15:49

added makefile to create the shell-api packages

0

2026-05-15 17:02:59

initial version separated from sumo