version 20200725

version 20200725, descriptions to macros added

README.md

@@ -6,7 +6,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
 
 The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
 
-In this repository we are presenting a **standalone Base SAS framework** which allows to develop and use SAS packages. Read the **`SAS(r) packages - the way to share (a how to)- Paper 4725-2020 - extended.pdf`** to learn more.
+In this repository we are presenting a **standalone Base SAS framework** which allows to develop and use SAS packages. Read the **`SAS(r) packages - the way to share (a how to)- Paper 4725-2020 - extended.pdf`** to learn more. Latest version is `20200725`.
 
 **General overview video:**
   - SAS Global Forum 2020 V.E.: `https://www.youtube.com/watch?v=qCkb-bx0Dv8&t=0s`
@@ -64,6 +64,7 @@ data class;
   set %SQL(select * from sashelp.class order by age);
 run;
 ```
+
 - **DFA** (Dynamic Function Arrays)\[0.2\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
 - **macroArray**\[0.3\], implementation of an array concept in a macrolanguage, e.g. 
 ```
@@ -79,6 +80,22 @@ run;
     %put &i.) %ABC(&i.); 
   %end;
 ```
+
+- **FunctionsImissinBASE**\[0.3\] A bunch of functions and functionalities I am missing in BASE SAS, such as:
+```
+call shiftLeft(myArray); 
+call replaceNull(17, myArray); 
+call arrVal(42, myArray); 
+
+rc = kill("DataSetToDrop"); 
+
+string = catXFn("date9.", "#", myArray);
+
+format x bool.;
+
+%put %getVars(sashelp.class, patern = ght$, sep = +, varRange = _numeric_);
+```
+
 - **dynMacroArray**\[0.2\], set of macros (wrappers for a hash table) emulating dynamic array in the datastep (macro predecessor of DFA)
 
 ### ======

generatePackage.sas

@@ -36,7 +36,7 @@
                                                                                  */
 /**#############################################################################**/
 
-/* Macros to generate SAS packages, version 20200619 */
+/* Macros to generate SAS packages, version 20020725 */
 /* A SAS package is a zip file containing a group 
    of SAS codes (macros, functions, datasteps generating 
    data, etc.) wrapped up together and %INCLUDEed by
@@ -54,8 +54,10 @@
                     default value Y means "execute tests" */
 ,packages=       /* location of other packages if there are
                     dependencies in loading */
-)/secure;
+)/secure
 /*** HELP END ***/
+des = 'Macro to generate SAS packages, version 20020725. Run %generatePackage() for help info.'
+;
 %if %superq(filesLocation) = %then
   %do;
     %put ;
@@ -63,7 +65,7 @@
     %put #        This is short help information for the generatePackage macro         #;
     %put ###############################################################################;
     %put #                                                                             #;
-    %put # Macro to generate SAS packages, version 20200619                            #;
+    %put # Macro to generate SAS packages, version 20020725                            #;
     %put #                                                                             #;
     %put # A SAS package is a zip file containing a group                              #;
     %put # of SAS codes (macros, functions, datasteps generating                       #;
@@ -1190,7 +1192,7 @@ data _null_;
     put '  end ;                                                                 ';
   %end;
 
-  put 'put "***"; put "* SAS package generated by generatePackage, version 20200619 *"; put "***";';
+  put 'put "***"; put "* SAS package generated by generatePackage, version 20020725 *"; put "***";';
 
   put 'run;                                                                      ' /;
 

listpackages.sas

@@ -36,7 +36,7 @@
                                                                                  */
 /**#############################################################################**/
 
-/* Macros to list SAS packages in packages' folder, version 20200608 */
+/* Macros to list SAS packages in packages' folder, version 20020725 */
 /* A SAS package is a zip file containing a group 
    of SAS codes (macros, functions, datasteps generating 
    data, etc.) wrapped up together and %INCLUDEed by
@@ -53,7 +53,9 @@
 /*** HELP END ***/
 
 
-%macro listPackages();
+%macro listPackages()/
+des = 'Macro to list SAS package from `package` fileref, version 20020725.'
+;
 
 %local ls_tmp ps_tmp notes_tmp source_tmp;
 %let   filesWithCodes = WORK._%sysfunc(datetime(), hex16.)_;

loadpackage.sas

@@ -36,7 +36,7 @@
                                                                                  */
 /**#############################################################################**/
 
-/* Macros to load, to get help, or to unload SAS packages, version 20200610  */
+/* Macros to load, to get help, or to unload SAS packages, version 20020725  */
 /* A SAS package is a zip file containing a group of files
    with SAS code (macros, functions, datasteps generating 
    data, etc.) wrapped up together and %INCLUDEed by
@@ -71,8 +71,10 @@
                                          and use loadPackage in the form: 
                                          %loadPackage(PiPackage, zip=disk, options=) 
                                        */
-)/secure;
+)/secure 
 /*** HELP END ***/
+des = 'Macro to load SAS package, version 20020725. Run %loadPackage() for help info.'
+;
 %if %superq(packageName) = %then
   %do;
     %put ;
@@ -80,7 +82,7 @@
     %put #        This is short help information for the loadPackage macro             #;
     %put ###############################################################################;
     %put #                                                                             #;
-    %put # Macro to load SAS packages, version 20200610                                #;
+    %put # Macro to load SAS packages, version 20020725                                #;
     %put #                                                                             #;
     %put # A SAS package is a zip file containing a group                              #;
     %put # of SAS codes (macros, functions, datasteps generating                       #;
@@ -199,8 +201,10 @@
                                          and use unloadPackage in the form: 
                                          %unloadPackage(PiPackage, zip=disk, options=) 
                                        */
-)/secure;
+)/secure
 /*** HELP END ***/
+des = 'Macro to unload SAS package, version 20020725. Run %unloadPackage() for help info.'
+;
 %if %superq(packageName) = %then
   %do;
     %put ;
@@ -208,7 +212,7 @@
     %put #        This is short help information for the unloadPackage macro           #;
     %put ###############################################################################;
     %put #                                                                             #;
-    %put # Macro to unload SAS packages, version 20200610                              #;
+    %put # Macro to unload SAS packages, version 20020725                              #;
     %put #                                                                             #;
     %put # A SAS package is a zip file containing a group                              #;
     %put # of SAS codes (macros, functions, datasteps generating                       #;
@@ -299,8 +303,10 @@
                                          and use helpPackage in the form: 
                                          %helpPackage(PiPackage, *, zip=disk, options=) 
                                        */
-)/secure;
+)/secure
 /*** HELP END ***/
+des = 'Macro to get help about SAS package, version 20020725. Run %helpPackage() for help info.'
+;
 %if %superq(packageName) = %then
   %do;
     %put ;
@@ -308,7 +314,7 @@
     %put #        This is short help information for the helpPackage macro             #;
     %put ###############################################################################;
     %put #                                                                             #;
-    %put # Macro to get help about SAS packages, version 20200610                      #;
+    %put # Macro to get help about SAS packages, version 20020725                      #;
     %put #                                                                             #;
     %put # A SAS package is a zip file containing a group                              #;
     %put # of SAS codes (macros, functions, datasteps generating                       #;
@@ -447,9 +453,10 @@ TODO:
 , sourcePath = /* location of the package, e.g. "www.some.page/", mind the "/" at the end */
 , replace = 1  /* 1 = replace if the package already exist, 0 = otherwise */
 )
+/secure  
 /*** HELP END ***/
-/
-secure;
+des = 'Macro to install SAS package, version 20020725. Run %%installPackage() for help info.'
+;
 %if %superq(packageName) = %then
   %do;
     %put ;
@@ -457,7 +464,7 @@ secure;
     %put #        This is short help information for the installPackage macro          #;
     %put ###############################################################################;
     %put #                                                                             #;
-    %put # Macro to install SAS packages, version 20200610                             #;
+    %put # Macro to install SAS packages, version 20020725                             #;
     %put #                                                                             #;
     %put # A SAS package is a zip file containing a group                              #;
     %put # of SAS codes (macros, functions, datasteps generating                       #;