[task #16260] Submission of shell script library

[devenkong]

URL:
  <https://savannah.nongnu.org/task/?16260>

                 Summary: Submission of shell script library
                 Project: Savannah Administration
               Submitter: devenkong
               Submitted: Tue 13 Sep 2022 05:53:13 PM UTC
         Should Start On: Tue 13 Sep 2022 12:00:00 AM UTC
   Should be Finished on: Fri 23 Sep 2022 12:00:00 AM UTC
                Category: Project Approval
                Priority: 5 - Normal
                  Status: None
                 Privacy: Public
        Percent Complete: 0%
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
                  Effort: 0.00


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Tue 13 Sep 2022 05:53:13 PM UTC By: devenkong <devenkong>
A new project has been registered at Savannah.
This project account will remain inactive until a site admin approves
or discards the registration.


= Registration Administration =

While this item will be useful to track the registration process, *approving
or discarding the registration must be done using the specific Group
Administration
<https://savannah.nongnu.org/siteadmin/groupedit.php?group_id=12260> page*,
accessible only to site administrators,
effectively *logged as site administrators* (superuser):

* Group Administration
<https://savannah.nongnu.org/siteadmin/groupedit.php?group_id=12260>


= Registration Details =

* Name: *shell script library*
* System Name:  *shlib*
* Type: non-GNU software and documentation
* License: Expat License (sometime refered to as MIT License)

----

== Description: ==
    shlib is a bash shell script library project. it allows programmer 
to use shell script code as a library, and include it by cmd 
'include'. and it also provide some usual and usefull sh functions and 
util programs.
    the feature and benifit is:
@ normally, script does not have a dir to store global lib files, we 
  shoud use absolute path to souce it. but you can install xxx.shlib 
  to shlib path, and use it like 'include xxx.shlib'. it provide a 
  conception of system global shell script lib.
@ there is something should pay attention on debug string output when 
we invoke it in a while loop with stdio redirection.

stdout=250
exec 250 >& 1
while true; do
    echo output to file.txt
    echo output as a debug info to console > $stdout
done > file.txt

we should force redirect debug string to stdout of parent process 
that saved at first. if we use stdio.shlib, we use 'dbgout xxxxxxx' to 
output debug strings, and it is more easy then orignal system command. 
this is one example of shlib.
    others:

@ it provide other functions lib such as gplib, strfmt, args, stdio, 
  term, fmtdbgout, paths, imifiles, flocker, rwfile, vqstack, catalog, 
  loadtask, and so on.
@ it provide script command programs such as shlibinc, shlibopt, imi, 
  catalog, loadtask/svclaunch, node, pexec, strfmt/evaln/tmpl, etz, 
  wrap/proginst, db, cfgpath.
@ shlib use imi(like ini) and catalog file shlib to orgnize paramters 
  and tree like infomations.
@ shlib defines some system paths, that a software normally use.
@ shlib write a program named strfmt, to unpack variables @{var} 
  nestedly in a string. it canbe used to provide templete function, 
  to output a txt string with variables dynamically.
@ shlib write functions provide queue and stack function by shell env var.
@ rwfile and flocker provide file rw and file locker functions. it 
  is needed by an other project dvar, that provide structured variable 
  defination.


== Other Software Required: ==
bash GPL3 https://www.gnu.org/software/bash/


== Other Comments: ==
code is writing, and some feature has not been implemented.


== Tarball URL: ==
https://savannah.nongnu.org/submissions_uploads/shlib-v0.0.1-20220805.zip









    _______________________________________________________

Reply to this item at:

  <https://savannah.nongnu.org/task/?16260>

_______________________________________________
Message sent via Savannah
https://savannah.nongnu.org/