The BasePlus package, version: 3.2.0

The BasePlus package, version: 3.2.0

Fix for leading spaces and `[` and `]` in the %dirsAndFiles()` macro.

- File SHA256: `F*F85189F1AF33755A7C9F05673A8094AE3245A21C8B602E02C20170A4DCF73890` for this version
- Content SHA256: `C*2216D9556FF51EDABAACBBFED7D30D5B46519083F7217A647A505C2F9FAB3634` for this version

README.md

@@ -17,7 +17,7 @@ Don't forget to give the repository a **STAR** and become [stargazer](https://gi
 
 ### Current version:
 
-**The latest version** of the **SAS Packages Framework** is **`20251231`**.
+**The latest version** of the **SAS Packages Framework** is **`20260515**.
 
 ---
 
@@ -45,6 +45,11 @@ Videos presenting the SPF and packages, from various conferences and meetups (th
   - ["SAS Packages - State of the Union" - SaSensei International Dojo No. 13](https://www.youtube.com/watch?v=1GEldZYQjj0&t=0s "SID no. 13") (November 10th 2022, ~50 minutes, general overview with the latest technical details)
   - ["SAS Packages Framework - an easy code sharing medium for SAS" - Warsaw IT Days 2023](https://youtu.be/T52Omisi0dk&t=0s "Warsaw IT Days 2023") (March 31st 2023, ~60 minutes, general overview with technical details for user and developer)
   - ["SAS Package ー その共有、もっとスマートに" - SASユーザー総会 2025](https://youtu.be/4QRr7sUhO9E "SASユーザー総会2025") (September 25th 2025, ~22 minutes, general overview with the list of reasons: why is it worth to use SAS packages?)
+  - ["SQLinDS and evExpress SAS packages - a tribute to SAS rock-stars!" - SAS Innovate 2026 Users Day](https://www.youtube.com/watch?v=ONSmt_l2TtU&t=6433s "SAS Innovate 2026 Users Day") (April 27th 2026, ~30 minutes, introduction to `SQLinDS` and `evExpress` SAS packages)
+  - ["Introducing SAS Packages: A Modern Code Sharing Medium for SAS" - SAS Innovate 2026](https://youtu.be/0plCa_mcOMI?list=PLVBcK_IpFVi-BXicJ5ZMcXuPNQTphJuhv "SAS Innovate 2026") (April 28th 2026, ~36 minutes, general overview and itroduction to SAS packages)
+  - ["Le petit SAS package - a workshop about the *Hello World* SAS package" - NJSUG 2026](https://drive.google.com/file/d/1y2_HO0tTnuiv3pk5swwETsd5Mi7EeFBP/view?usp=sharing "NJSUG 2026") (May 8ht, 2026, ~53 minutes, technical presentation about building a "Hello World"-style SAS packages from scratch)
+
+
 
 
 ### Tutorials:
@@ -57,9 +62,11 @@ Letter "D" indicates tutorial dedicated for developers and "U" materials for use
 
 2) (D) Very simple ["Hello World" example](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/HelloWorldPackage.md) tutorial for developers. As a support a [walk-through video](https://youtu.be/T52Omisi0dk&t=2160s)
 
-3) (D) Article and all required materials for ["My first SAS Package"](https://github.com/yabwon/SAS_PACKAGES/tree/main/SPF/Documentation/Paper_1079-2021) tutorial.
+3) (D) Video tutorial about ["Le Petit SAS Package"](https://drive.google.com/file/d/1y2_HO0tTnuiv3pk5swwETsd5Mi7EeFBP/view?usp=sharing), materials from the recording are [here](https://github.com/yabwon/SAS_PACKAGES/tree/main/SPF/Documentation/LePetitSASpackage).
 
-4) (DU) Materials from Hands-on-Workshop (4+ hours) tutorial: [Share your code with SAS Packages](https://github.com/yabwon/HoW-SASPackages). 
+4) (D) Article and all required materials for ["My first SAS Package"](https://github.com/yabwon/SAS_PACKAGES/tree/main/SPF/Documentation/Paper_1079-2021) tutorial.
+
+5) (DU) Materials from Hands-on-Workshop (4+ hours) tutorial: [Share your code with SAS Packages](https://github.com/yabwon/HoW-SASPackages). 
    It is a "zero to hero" tutorial that explains all the "bells and whistles" of using, and all the "nuts and bolts" of developing SAS packages.
 
 ---
@@ -68,7 +75,7 @@ Letter "D" indicates tutorial dedicated for developers and "U" materials for use
 
 ### Initiative to add SAS Packages Framework to SAS Base/Viya:
 
-A **SASware Ballot Idea** for adding *SAS Packages Framework* macros into Base SAS and Viya was submitted Friday, May 27th 2022. If you would like to support the idea visit this [**communities.sas.com post**](https://communities.sas.com/t5/SASware-Ballot-Ideas/Add-SAS-Packages-Framework-to-the-SAS-Base-Viya/idi-p/815508) and up vote the idea! We have 48 likes from 46 supporters up to today (as of September 30, 2025)!
+A **SASware Ballot Idea** for adding *SAS Packages Framework* macros into Base SAS and Viya was submitted Friday, May 27th 2022. If you would like to support the idea visit this [**communities.sas.com post**](https://communities.sas.com/t5/SAS-Product-Suggestions/Add-SAS-Packages-Framework-to-the-SAS-Base-Viya/idi-p/815508) and up vote the idea! We have 49 likes from 47 supporters up to today (as of May 21, 2026)!
 
 ---
 
@@ -190,7 +197,9 @@ The SAS Packages Framework [(short) documentation](https://github.com/yabwon/SAS
 ---
 
 ### Updates worth mentioning:
-**Update**\[December 31st, 2025\]**:** `%bundlePackages()` and `%unbundlePackages()` **macros are available. (see [here](https://github.com/yabwon/SAS_PACKAGES/releases/tag/20241231 "bundling macros"))**.
+**Update**\[April 9th, 2026\]**:**Packages can be installed from private repositories. (see [here](https://github.com/yabwon/SAS_PACKAGES/releases/tag/20260409 "bundling macros"))**.
+
+**Update**\[December 31st, 2025\]**:** `%bundlePackages()` and `%unbundlePackages()` **macros are available. (see [here](https://github.com/yabwon/SAS_PACKAGES/releases/tag/20251231 "bundling macros"))**.
 
 **Update**\[December 28th, 2025\]**:** `buildLocation=` and `archLocation=` **parameters added to** `%generatePackage()` **macro, they allow to redirect results of the packages generation process. (see [here](https://github.com/yabwon/SAS_PACKAGES/releases/tag/20251228 "redirect results with buildLocation="))**.
 
@@ -234,6 +243,7 @@ This is a list of locations where the SAS Packages Framework is used:
  - Warsaw (Poland)
  - Osaka (Japan)
  - Kyoto (Japan)
+ - Boston (USA)
 
 If you want to share that you are using the SPF let me know and I'll update the list.
 

SPF/Documentation/LePetitSASpackage/le_petit_SAS_package.sas

@@ -0,0 +1,735 @@
+/*
+# **Le petit SAS package** 
+## a workshop about the "*Hello World*" SAS package.
+
+by [**Bartosz Jabłoński**](https://linkedin.com/in/yabwon)
+
+[LinkedIn](https://linkedin.com/in/yabwon)
+[GitHub](https://github.com/yabwon)
+
+---
+
+<!-- ![Cover](./le_petit_SAS_package.png) -->
+<img src="./le_petit_SAS_package.png" alt="Le petit SAS package" style="height:800px;"/>
+
+
+
+---
+*/
+
+/*
+---
+
+## Links and locations
+
+[**SAS Packages Framework**](https://github.com/yabwon/SAS_PACKAGES) - this is the place where the SAS Packages Framework lives.
+
+
+[**Hands on Workshop Materials**](https://github.com/yabwon/HoW-SASPackages) - this is the location for tutorial materials that will teach you how to work with SAS packages and that will take you "from 0 to hero" in SAS packages world.
+
+[SPF's introductory video series](https://www.youtube.com/playlist?list=PLeMzGEImIT5eV13IGXQIgWmTFCJt_cLZG) - this is a YouTube introductory video series explaining the basics.
+
+
+[**SAS Packages Archive**](https://github.com/SASPAC) - some of publicly available SAS packages are located here.
+
+[PharmaForest](https://github.com/PharmaForest) - pharma industry dedicated SAS packages are there.
+
+---
+*/
+
+options nofullstimer stimer nomprint nosymbolgen nomlogic; 
+data _null_;
+  put "WARNING- Welcome at NJSUG meetup!";
+run;
+
+/*
+## autoexec.sas
+
+I'm keeping my session setup in the `autoexec.sas` file.
+*/
+
+/* this is an optional step - I basically have my session configuration in autoexec */
+/*
+%include "C:\SAS_WORK\autoexec.sas";
+
+%put %workpath();
+
+%put &sysLoadedPackages.;
+*/
+
+/*
+But it can be replaced, for example, by something like this:
+*/
+
+/* set "current working path" to WORK location */
+%put %sysfunc(DLGCDIR(%sysfunc(PATHNAME(work))));
+filename _ ".";
+filename _ list;
+filename _ clear;
+
+
+/* enable the SAS Packages Framework */
+filename packages "C:\SAS_WORK\SAS_PACKAGES"; /* filename packages "/sas/PACKAGES"; */
+%include packages(SPFinit.sas);
+
+/* Load SAS packages */
+%loadPackageS(SQLinDS BasePlus)
+/* %loadPackageS(macroArray, DFA, GSM, bpUTiL, maxims4sas, evExpress) */
+
+
+resetline;
+/* List loaded packages */
+%put NOTE- SAS session with SAS Packages: &SYSLoadedPackages.;
+
+%put NOTE- %workpath(); /* basePlus macro */
+
+/*
+---
+
+# Code types
+
+SAS Packages can contain various code types, including: 
+- macros, 
+- FCMP functions, 
+- formats & informats, 
+- IML modules, 
+- DS2 packages & threads, 
+- CAS-L functions, 
+- data sets, 
+- libraries, etc.
+
+Full list is provided in the [Training Materials](https://github.com/yabwon/HoW-SASPackages).
+
+Today we will go with 3 basic: a macros, a function, and a format.
+*/
+
+/*
+## A Macro
+
+This macro prints the fox's quotes to the log.
+*/
+
+resetline;
+
+%macro fox(quote);
+  %local n e w;
+  %let n = NOTE;
+  %let e = ERROR;
+  %let w = WARNING;
+  %if 1=%superq(quote) %then 
+    %do;
+      %put &n.- And now here is my secret, a very simple secret:; 
+      %put &n.- It is only with the heart that one can see rightly%str(;);
+      %put &n.- what is essential is invisible to the eye.;
+    %end;
+  %else
+  %if 2=%superq(quote) %then 
+    %do;
+      %put &w.- It is the time you have wasted for your rose;
+      %put &w.- that makes your rose so important.;
+      %put &w.- Men have forgotten this truth. But you must not forget it.; 
+      %put &w.- You become responsible, forever, for what you have tamed.;
+      %put &w.- You are responsible for your rose...;
+    %end;
+  %else
+    %do;
+      %put &e.- One only understands the things that one tames.; 
+      %put &e.- Men have no more time to understand anything.;
+      %put &e.- They buy things all ready made at the shops.; 
+      %put &e.- But there is no shop anywhere where one can buy friendship,; 
+      %put &e.- and so men have no friends any more. If you want a friend, tame me...;
+    %end;
+%mend fox;
+
+%fox(1)
+%fox(2)
+%fox()
+
+/*
+## A Format
+
+This format displays values from 1 to 4 as rose's quotes.
+*/
+
+resetline;
+
+PROC FORMAT;
+  value rose
+  1="Ah! I am scarcely awake. I beg that you will excuse me. My petals are still all disarranged..."
+  2="Of course I love you. It is my fault that you have not known it all the while. [...] Try to be happy..."
+  3="My cold is not so bad as all that... The cool night air will do me good. I am a flower."
+  4="Well, I must endure the presence of two or three caterpillars if I wish to become acquainted with the butterflies."
+  other="ERROR: QUOTE OUT OF RANGE!"
+  ;
+RUN;
+
+
+data _null_;
+  do i = 1 to 5;
+    put "NOTE- " i rose. /;
+  end;
+run;
+
+/*
+## A Function
+
+This FCMP function returns the prince's quote: "*If you please--draw me a sheep!*", and generates random rose's quote in the LOG.
+*/
+
+resetline;
+
+PROC FCMP outlib=work.little.prince;
+  function prince() $ 42;
+    file log;
+
+    length i $ 256;
+    r=rand('integer',1,4);
+    i = put(r, rose.);
+    put @1 "RANDOM NOTE:" i /;
+
+    return("If you please--draw me a sheep!");
+  endfunc;
+QUIT;
+
+proc options option=cmplib;
+run;
+
+/*
+For an FCMP function to work the `CMPLIB` option has to be updated.
+*/
+
+options append=(cmplib=work.little);
+
+proc options option=cmplib;
+run;
+
+data _null_;
+  do i = 1 to 5;
+    prince=prince();
+    rc=sleep(1,0.2);
+  end;
+  put prince=;
+run;
+
+/*
+---
+
+# **##############################**
+
+# *If you please - build me a SAS package!*
+
+# **##############################**
+
+---
+*/
+
+/*
+## The Directory
+
+In the firs step, a directory for the package source has to be created.
+*/
+
+options dlcreatedir;
+%let dir = R:\NJSUG\LePetitSASpackageDirectory;
+
+libname p "&dir.";
+
+libname p list;
+
+/*
+## The Description
+
+This is the **description** file for the package.
+
+It should be named `description.sas` and located in the package source directory. 
+
+The colon (`:`) is a field separator and is restricted in lines of the header part.
+
+The part between `DESCRIPTION START:` and `DESCRIPTION END:` is a "free format" text part where the developer provides package description, additional notes, information, etc.
+*/
+
+/* **HEADER** */
+Type: Package
+Package: LePetitSASpackage
+Title: Le petit SAS package - a workshop about the "*Hello World*" SAS package.
+Version: 0.0.1
+Author: Bartosz Jablonski
+Maintainer: Bartosz Jablonski (yabwon@gmail.com)
+License: MIT
+Encoding: UTF8
+
+Required: "Base SAS Software"
+ReqPackages: "SQLinDS(2.3.3)"
+
+
+/* **DESCRIPTION** */
+/* All the text below will be used for help notes */
+DESCRIPTION START:
+
+The **LePetitSASpackage** package is an implementation 
+of a little "*Hello World*" SAS package presented during 
+**NJSUG** meetup.
+
+It is build for fun, but also (or foremost) to show us 
+how easy it is to build SAS packages.
+
+*"I have serious reason to believe that the planet from which 
+the little package came is the asteroid known as B612.
+This asteroid has only once been seen through the telescope. 
+That was by a Turkish astronomer, in 1909."*
+
+---
+
+DESCRIPTION END:
+
+/*
+[**NOTE**] The `SQLinDS` package is added as a dependency just to show the it can be done. In normal circumstances, when a package doesn't have dependencies the `ReqPackage:` tag is skipped. The `Required:` tag is also just for demonstration.
+*/
+
+/*
+## The Directory, cont.
+*/
+
+/*
+### Ordering
+
+Code files have to be placed in proper type-directories. And ordered accordingly. In this case teh following setup will work.
+*/
+
+/* 01_macro -> fox.sas */
+
+/* 02_formats -> rose.sas */
+
+/* 03_functions -> prince.sas */
+
+/*
+Directories structure can be easily created by ourselves with the `dlcreatedir` option. If the option is not available, then it can be done by hand.
+*/
+
+resetline;
+options dlcreatedir;
+
+libname p "&dir.\01_macro";
+libname p "&dir.\02_formats";
+libname p "&dir.\03_functions";
+
+libname p clear;
+
+/*
+## Code Preparation
+*/
+
+/*
+### Help Notes
+*/
+
+/*** HELP START ***//*
+
+This is a little help note.
+
+*//*** HELP END ***/
+
+/*** HELP START ***//*
+
+The `%fox()` macro prints what does the fox says...
+
+---
+
+### Syntax: ############################### 
+
+~~~~~~~~~~sas
+%fox(<quote>)
+~~~~~~~~~~
+
+### Arguments: ############################
+
+- `quote` - The number of fox's quote.
+            When missing or incorrect, 
+            the default quote is displayed.
+
+
+### Example: ##############################
+
+Print quote number 1:
+~~~~~~~~~~sas
+%fox(1)
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+/*** HELP START ***//*
+
+The `rose.` format prints what does the rose says...
+
+---
+
+### Example: ##############################
+
+Print quote number 2:
+~~~~~~~~~~sas
+data _null_;
+  r=2;
+  put r rose.;
+run;
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+/*** HELP START ***//*
+
+The `prince()` function asks to draw a sheep...
+
+---
+
+### Arguments: ############################
+
+The function has no arguments.
+
+### Dependencies: #########################
+
+The `prince()` function requires 
+the `rose.` format to work.
+
+### Example: ##############################
+
+Ask for a sheep:
+~~~~~~~~~~sas
+data _null_;
+  s=prince();
+  put s=;
+run;
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+/*
+### One file - one object
+*/
+
+resetline;
+
+/* 01_macro -> fox.sas */
+filename f "&dir.\01_macro\fox.sas";
+data _null_;
+  file f;
+  infile CARDS4;
+  input;
+  put _infile_;
+CARDS4;
+/*** HELP START ***//*
+
+The `%fox()` macro prints what does the fox says...
+
+---
+
+### Syntax: ############################### 
+
+~~~~~~~~~~sas
+%fox(<quote>)
+~~~~~~~~~~
+
+### Arguments: ############################
+
+- `quote` - The number of fox's quote.
+            When missing or incorrect, 
+            the default quote is displayed.
+
+
+### Example: ##############################
+
+Print quote number 1:
+~~~~~~~~~~sas
+%fox(1)
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+%macro fox(quote);
+  %local n e w;
+  %let n = NOTE;
+  %let e = ERROR;
+  %let w = WARNING;
+  %if 1=%superq(quote) %then 
+    %do;
+      %put &n.- And now here is my secret, a very simple secret:; 
+      %put &n.- It is only with the heart that one can see rightly%str(;);
+      %put &n.- what is essential is invisible to the eye.;
+    %end;
+  %else
+  %if 2=%superq(quote) %then 
+    %do;
+      %put &w.- It is the time you have wasted for your rose;
+      %put &w.- that makes your rose so important.;
+      %put &w.- Men have forgotten this truth. But you must not forget it.; 
+      %put &w.- You become responsible, forever, for what you have tamed.;
+      %put &w.- You are responsible for your rose...;
+    %end;
+  %else
+    %do;
+      %put &e.- One only understands the things that one tames.; 
+      %put &e.- Men have no more time to understand anything.;
+      %put &e.- They buy things all ready made at the shops.; 
+      %put &e.- But there is no shop anywhere where one can buy friendship,; 
+      %put &e.- and so men have no friends any more. If you want a friend, tame me...;
+    %end;
+%mend fox;
+;;;;
+run;
+
+/* 02_formats -> rose.sas */
+filename f "&dir.\02_formats\rose.sas";
+data _null_;
+  file f;
+  infile CARDS4;
+  input;
+  put _infile_;
+CARDS4;
+/*** HELP START ***//*
+
+The `rose.` format prints what does the rose says...
+
+---
+
+### Example: ##############################
+
+Print quote number 2:
+~~~~~~~~~~sas
+data _null_;
+  r=2;
+  put r rose.;
+run;
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+value rose
+1="Ah! I am scarcely awake. I beg that you will excuse me. My petals are still all disarranged..."
+2="Of course I love you. It is my fault that you have not known it all the while. [...] Try to be happy..."
+3="My cold is not so bad as all that... The cool night air will do me good. I am a flower."
+4="Well, I must endure the presence of two or three caterpillars if I wish to become acquainted with the butterflies."
+other="ERROR: QUOTE OUT OF RANGE!"
+;
+;;;;
+run;
+
+/* 03_functions -> prince.sas */
+filename f "&dir.\03_functions\prince.sas";
+data _null_;
+  file f;
+  infile CARDS4;
+  input;
+  put _infile_;
+CARDS4;
+/*** HELP START ***//*
+
+The `prince()` function asks to draw a sheep...
+
+---
+
+### Arguments: ############################
+
+The function has no arguments.
+
+### Dependencies: #########################
+
+The `prince()` function requires 
+the `rose.` format to work.
+
+### Example: ##############################
+
+Ask for a sheep:
+~~~~~~~~~~sas
+data _null_;
+  s=prince();
+  put s=;
+run;
+~~~~~~~~~~
+
+---
+
+*//*** HELP END ***/
+
+function prince() $ 42;
+  file log;
+
+  length i $ 256;
+  r=rand('integer',1,4);
+  i = put(r, rose.);
+  put @1 "RANDOM NOTE:" i /;
+
+  return("If you please--draw me a sheep!");
+endfunc;
+;;;;
+run;
+
+/*
+### Tests
+
+Tests are optionally available, i.e., they are available if the `XCMD` option is on. 
+
+One test of loading a package is always automatically executed. All other tests are developer's job to do.
+
+The SPF automatically points to the package location for tests, developer doesn't have to worry.
+*/
+
+resetline;
+options dlcreatedir;
+
+libname p "&dir.\99_test";
+libname p clear;
+
+/* 99_test -> test_success.sas */
+filename f "&dir.\99_test\test_success.sas";
+data _null_;
+  file f;
+  infile CARDS4;
+  input;
+  put _infile_;
+CARDS4;
+%put testing macro:;
+%fox(1)
+%fox(2)
+%fox()
+
+data _null_;
+  put "Testing format:";
+  do i = 1 to 4;
+    put "NOTE- " i rose. /;
+  end;
+run;
+
+data _null_;
+  put "Testing function:";
+  do i = 1 to 5;
+    prince=prince();
+    rc=sleep(1,0.2);
+  end;
+  put;
+run;
+;;;;
+run;
+
+/* 99_test -> test_fail_e1w0.sas */
+filename f "&dir.\99_test\test_fail_e1w0.sas";
+data _null_;
+  file f;
+  infile CARDS4;
+  input;
+  put _infile_;
+CARDS4;
+data _null_;
+  put "Testing format (should print error):";
+  do i = 5;
+    put i rose. /;
+  end;
+run;
+;;;;
+run;
+
+/*
+## Generate Package
+
+In this session we already have the SPF enabled, but in the development process you have to point the location for packages and enable the framework.
+*/
+
+filename packages "C:\SAS_WORK\SAS_PACKAGES";
+%include packages(SPFinit.sas);
+
+/*
+Options can be easily reminded (in he LOG) by calling the macro with the `HELP` keyword.
+*/
+
+%generatePackage(HELP)
+
+resetline;
+
+/* Generate Package */
+
+%generatePackage(
+ R:\NJSUG\LePetitSASpackageDirectory
+,markdownDoc=1
+,packages=C:\SAS_WORK\SAS_PACKAGES
+)
+
+/* REMEMBER! Always check the log.*/
+
+/*
+# --The End--
+
+The package is ready! It can be shared with other SAS programmers now.
+
+---
+*/
+
+/*
+#
+
+##
+
+###
+
+---
+
+# Start New SAS Session
+
+In a brand new SAS session try out how the created package works.
+*/
+
+/* create directory for SAS packages */
+
+resetline;
+options dlcreatedir;
+libname p "R:\NJSUG\trySASpackages";
+libname p clear;
+
+/* install the SAS Packages Framework and the SQLinDS package */
+
+filename packages "R:\NJSUG\trySASpackages";
+
+filename SPFinit url "https://bit.ly/SPFinit";
+%include SPFinit; /* enable the framework */
+filename SPFinit clear;
+
+%installPackage(SPFinit SQLinDS)
+
+/*
+Copy, manually for now, the LePetitSASpackage (the zip file) to packages directory.
+*/
+
+/* enable the SPF and load the LePetitSASpackage */
+
+filename packages "R:\NJSUG\trySASpackages";
+%include packages(SPFinit.sas);
+%listPackages()
+
+
+%loadPackage(LePetitSASpackage)
+
+/* try it */
+%fox(1)
+%fox(2)
+
+%put %sysfunc(prince());
+
+data _null_;
+  p = prince();
+  put p=;
+run;
+
+/*
+---
+*/
+
+/*
+---
+*/

SPF/Macros/bundlePackages.sas

@@ -8,7 +8,7 @@
 ,packagesRef=packages
 ,ods= /* data set for report file */
 )/
-des='Macro to create a bundle of SAS packages, version 20251231. Run %bundlePackages(HELP) for help info.'
+des='Macro to create a bundle of SAS packages, version 20260515. Run %bundlePackages(HELP) for help info.'
 secure minoperator
 ;
 
@@ -25,7 +25,7 @@ secure minoperator
     %put ###      This is short help information for the `bundlePackages` macro          #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to *create bundles* of SAS packages, version `20251231`                 #;
+    %put # Macro to *create bundles* of SAS packages, version `20260515`                 #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -62,7 +62,7 @@ secure minoperator
     %put # - `packagesRef=`      *Optional.* Fileref to location of packages for the     #;
     %put #                       bundle. Default value is `packages`.                    #;
     %put #                                                                               #;
-    %put # - `ods=`              *Optional.* Name of SAS data set for the report.        #;
+    %put # - `ods=`              *Optional.* V7 style name of SAS data set for report.   #;
     %put #                                                                               #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
@@ -126,6 +126,13 @@ secure minoperator
 %let datetime = %sysfunc(datetime());
 %let reportFile = WORK.tmpbundlefile%sysfunc(int(&datetime.), b8601dt15.)_;
 
+%if NOT %sysevalf(%superq(ods)=,BOOLEAN) %then %do;
+  data _null_; /* verify ods= value */
+    %SPFinit_intrnl_forceV7DSname(ods);
+    call symputX("ods",ods,"L");
+  run;
+%end;
+
 data _null_ %if %superq(ods) NE %then %do; &ods. %end;
                                 %else %do; &reportFile.1  %end;
 ;
@@ -399,8 +406,8 @@ put "INFO: The " bundleName "bundle creation ended.";
       ;
   format datetime e8601dt.;
   output 
-    %if %superq(ods) NE %then %do; %scan(&ods.,1,()) %end;
-                        %else %do; &reportFile.1     %end;
+    %if %superq(ods) NE %then %do; &ods.         %end;
+                        %else %do; &reportFile.1 %end;
   ;
 put " ";
 rc=sleep(1,1); 
@@ -408,13 +415,13 @@ stop;
 run;
 
 title2 "Summary of the bundle file";;
-proc print
-  data= %if %superq(ods) NE %then %do; %scan(&ods.,1,()) %end;
-                            %else %do; &reportFile.1     %end;
-  noObs label;
+proc print noObs label
+  data= %if %superq(ods) NE %then %do; &ods.         %end;
+                            %else %do; &reportFile.1 %end;
+  ;
   var bundleName datetime BundleSHA256 path;
 run;
-%if %superq(ods) NE %then %do; %put INFO: Report file: %scan(&ods.,1,()); %end;
+%if %superq(ods) NE %then %do; %put INFO: Report file: &ods.;       %end;
                     %else %do; proc delete data=&reportFile.1; run; %end;
 
 

SPF/Macros/extendpackagesfileref.sas

@@ -6,7 +6,7 @@
              when empty the "packages" value is used */
 )/secure
 /*** HELP END ***/
-des = 'Macro to list directories pointed by "packages" fileref, version 20251231. Run %extendPackagesFileref(HELP) for help info.'
+des = 'Macro to list directories pointed by "packages" fileref, version 20260515. Run %extendPackagesFileref(HELP) for help info.'
 ;
 
 %if %QUPCASE(&packages.) = HELP %then
@@ -22,7 +22,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20251231
     %put ###       This is short help information for the `extendPackagesFileref` macro            #;
     %put #-----------------------------------------------------------------------------------------#;;
     %put #                                                                                         #;
-    %put # Macro to list directories pointed by 'packages' fileref, version `20251231`             #;
+    %put # Macro to list directories pointed by 'packages' fileref, version `20260515`             #;
     %put #                                                                                         #;
     %put # A SAS package is a zip file containing a group                                          #;
     %put # of SAS codes (macros, functions, data steps generating                                  #;

SPF/Macros/generatepackage.sas

@@ -3,7 +3,7 @@
 
    Macro to generate SAS packages.
 
-   Version 20251231
+   Version 20260515
 
    A SAS package is a zip file containing a group 
    of SAS codes (macros, functions, data steps generating 
@@ -29,7 +29,7 @@
                          if more than one are provided only the first is used */
 ,testResults=         /* location where tests results should be stored,
                          if null (the default) the WORK is used */
-,workInTestResults=0  /* indicates if WORK directories for tests should located 
+,workInTestResults=0  /* indicates if WORK directories for tests should be located 
                          in the same place as results  */
 ,testWorkPath=        /* location where tests SAS sessions' work directories 
                          should be stored, if null (the default) the main SAS 
@@ -53,7 +53,7 @@
                          when empty takes buildLocation */
 )/ secure minoperator
 /*** HELP END ***/
-des = 'Macro to generate SAS packages, version 20251231. Run %generatePackage() for help info.'
+des = 'Macro to generate SAS packages, version 20260515. Run %generatePackage() for help info.'
 ;
 %if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
   %do;
@@ -68,7 +68,7 @@ des = 'Macro to generate SAS packages, version 20251231. Run %generatePackage()
     %put ###      This is short help information for the `generatePackage` macro              #;
     %put #------------------------------------------------------------------------------------#;
     %put #                                                                                    #;
-    %put # Macro to generate SAS packages, version `20251231`                                 #;
+    %put # Macro to generate SAS packages, version `20260515`                                 #;
     %put #                                                                                    #;
     %put # A SAS package is a zip file containing a group                                     #;
     %put # of SAS codes (macros, functions, data steps generating                             #;
@@ -262,13 +262,13 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
     options &qlenmax_fstimer_tmp.;
  
     /* test for required descriptors */
-    %if (%nrbquote(&packageName.) = )
-     or (%nrbquote(&packageVersion.) = )
-     or (%nrbquote(&packageAuthor.) = )
-     or (%nrbquote(&packageMaintainer.) = )
-     or (%nrbquote(&packageTitle.) = )
-     or (%nrbquote(&packageEncoding.) = )
-     or (%nrbquote(&packageLicense.) = )
+    %if (%superq(packageName) = )
+     or (%superq(packageVersion) = )
+     or (%superq(packageAuthor) = )
+     or (%superq(packageMaintainer) = )
+     or (%superq(packageTitle) = )
+     or (%superq(packageEncoding) = )
+     or (%superq(packageLicense) = )
       %then
         %do;
           %put ERROR: At least one of descriptors is missing!;
@@ -444,10 +444,10 @@ options NOquotelenmax NOstimer NOfullstimer;
   */
 data _null_; 
   call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-run;
+/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
 /* test if version is a number */
-data _null_;
+/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
   v = "&packageVersion.";
   version = coalesce(input(scan(v,1,".","M"), ?? best32.),0)*1e8
           + coalesce(input(scan(v,2,".","M"), ?? best32.),0)*1e4
@@ -950,7 +950,7 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
     title&_titleNumber_. "Package ZIP file location is: &buildLocation.";
   %end;
 
-footnote1 "SAS Packages Framework, version 20251231";
+footnote1 "SAS Packages Framework, version 20260515";
 
 proc print 
   data = &filesWithCodes.(drop=base build folderRef fileRef rc folderid _abort_ fileId additionalContent)
@@ -1239,7 +1239,7 @@ data _null_;
         / ' /* print out setinit */                                     '
         / ' proc setinit %str(;) run %str(;)                            '
         / ' proc printto %str(;) run %str(;)                            '
-
+        / ' options ps=min %str(;)                                      '
         / ' data _null_ %str(;)                                         '
         / '   /* loadup checklist of required SAS components */         '
         / '   if _n_ = 1 then                                           '
@@ -1298,8 +1298,10 @@ data _null_;
       packageReqPackages = lowcase(symget('packageReqPackages'));
       
       /* try to load required packages */
-      put 'data _null_ ;                                                                                 '
-        / ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages loading."; stop; end; '
+      put '%let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
+        / 'options noNotes;'
+        / 'data _null_ ;                                                                                 '
+        / ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages loading."; stop; end; '
         / '  length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767;                '
         / '  if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then             '
         / '    do;                                                                                       '
@@ -1341,7 +1343,7 @@ data _null_;
 
         / '    if (LP_find ne 0) or (LP_find = 0 and . < versN < verRN) then                                     '
         / '     do;                                                                                              '
-        / '      put "NOTE: Trying to load required SAS package: " req;                                          '
+        / '      put "INFO: Trying to load required SAS package: " req;                                          '
         / '       if LoadPackageExist then                                                                       '
         / '         call execute(cats(''%nrstr(%loadPackage('', name, ", requiredVersion = ", verR, "))"));      '
         / '       else if ICELoadPackageExist then                                                               '
@@ -1353,7 +1355,7 @@ data _null_;
 
       /* test if required packages are loaded */
         / 'data _null_ ;                                                                                 '
-        / ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages checking."; stop; end; '
+        / ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages checking."; stop; end; '
         / '  length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767;                '
         / '  if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then             '
         / '    do;                                                                                       '
@@ -1414,14 +1416,17 @@ data _null_;
         / '      end ;                                                                                   '
         / '    end;                                                                                      '
         / '  stop;                                                                                       '
-        / 'run;                                                                                          ';
+        / 'run;                                                                                          '
+        / 'options &temp_noNotes_etc.;';
     %end;
 
   %if (%superq(packageRequired) ne ) 
      or (%superq(packageReqPackages) ne ) 
   %then
     %do;
-      put ' data _null_;                                                     '
+      put ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
+        / ' options noNotes;'
+        / ' data _null_;                                                     '
         / '  if 1 = symgetn("packageRequiredErrors") then                    '
         / '    do;                                                           '
         / '      put "ERROR: Loading package &packageName. will be aborted!";'
@@ -1436,7 +1441,8 @@ data _null_;
         / '  else                                              '
         / '    call symputX("packageRequiredErrors", " ", "L");'
         / ' run;                                               '
-        / ' &packageRequiredErrors.                            ';
+        / ' &packageRequiredErrors.                            '
+        / ' options &temp_noNotes_etc.;                        ';
     %end;
 
 
@@ -1769,7 +1775,7 @@ data _null_;
     %end; 
   put +(-1) '`.;''' 
     / ' !! ''      %put The macro generated: '' !! put(dtCASLudf, E8601DT19.-L) !! ";"' 
-    / ' !! ''      %put with the SAS Packages Framework version 20251231.;''' 
+    / ' !! ''      %put with the SAS Packages Framework version 20260515.;''' 
     / ' !! ''      %put ****************************************************************************;''' 
     / ' !! ''    %GOTO theEndOfTheMacro;''' 
     / ' !! ''    %end;''' ;
@@ -1933,7 +1939,7 @@ data _null_;
             %end; 
       put +(-1) '`.; '' !!' /
           '''      %put The macro generated: ''' " !! put(dtIML, E8601DT19.-L) !! " ''';                    '' !! ' / 
-          '''      %put with the SAS Packages Framework version 20251231.;                                  '' !! ' / 
+          '''      %put with the SAS Packages Framework version 20260515.;                                  '' !! ' / 
           '''      %put ****************************************************************************;       '' !! ' / 
           '''    %GOTO theEndOfTheMacro;                                                                    '' !! ' / 
           '''    %end;                                                                                      '' !! ' / 
@@ -2149,6 +2155,66 @@ data _null_;
   put 'run;';
   /* KMF -------------------------------------------------------------------------------- end */
 
+  /*=add meta function========================================================================*/
+    isFunction+1;
+
+    length packageName $ 32 packageVersion packageGenerated $ 24
+           packageTitle packageAuthor packageMaintainer $ 2048
+           packageEncoding $ 8 packageLicense $ 128;
+    packageName       = quote(strip(symget('packageName')),'"');
+    packageVersion    = quote(strip(symget('packageVersion')),'"');
+    packageTitle      = quote(strip(symget('packageTitle')),'"');
+    packageAuthor     = quote(strip(symget('packageAuthor')),'"');
+    packageMaintainer = quote(strip(symget('packageMaintainer')),'"');
+    packageEncoding   = quote(strip(symget('packageEncoding')),'"');
+    packageLicense    = quote(strip(symget('packageLicense')),'"');
+    packageGenerated  = quote(strip(symget('packageGenerated')),'"');
+    /* add quotes to hide special characters */
+    %if (%superq(packageReqPackages) ne ) %then /* required packages list */
+      %do;
+        packageReqPackages = quote(strip(packageReqPackages)); 
+      %end;
+    %if (%superq(packageRequired) ne ) %then /* required SAS products */
+      %do;
+        packageRequired = quote(strip(packageRequired));
+      %end;
+
+    put '%if (%str(*)=%superq(cherryPick)) %then %do;'; /* cherryPick 4 ---*/
+    put "proc fcmp outlib = work.&packageName.fcmp.packagemeta ; "
+      / " function &packageName.META(meta $) $ 32767;"
+      / '  m = char(upcase(meta),1);'
+      / "   if m = 'V' then return(strip(" packageVersion    +(-1) "));"
+      / "   if m = 'D' then return(strip(" packageGenerated  +(-1) "));"
+      / "   if m = 'A' then return(strip(" packageAuthor     +(-1) "));"
+      / "   if m = 'M' then return(strip(" packageMaintainer +(-1) "));"
+      / "   if m = 'T' then return(strip(" packageTitle      +(-1) "));"
+      / "   if m = 'E' then return(strip(" packageEncoding   +(-1) "));"
+      / "   if m = 'L' then return(strip(" packageGenerated  +(-1) "));"
+      %if (%superq(packageReqPackages) ne ) %then /* required packages list */
+        %do;
+          / "   if m = 'P' then return(strip(" packageReqPackages +(-1) "));" 
+        %end;
+      %if (%superq(packageRequired) ne ) %then /* required SAS products */
+        %do;
+          / "   if m = 'S' then return(strip(" packageRequired +(-1) "));" 
+        %end;
+      / '  return(" ");'
+      / ' endfunc;'
+      / 'quit;';
+
+    put '%sysfunc(ifc(0<' 
+      / '  %sysfunc(findw((%sysfunc(getoption(cmplib)))' 
+      / "                ,work.%sysfunc(lowcase(&packageName.fcmp)),""'( )'"",RIO))" 
+      / ',,%str(options' " APPEND=(cmplib = work.%sysfunc(lowcase(&packageName.fcmp)));)" 
+      / '))' ;
+
+    put '%macro ' "&packageName.META(meta)/parmbuff;" /* returned values are quoted to mask special chars*/
+      / '%if %superq(meta) = %then %return;'
+      / '%do;%qsysfunc(strip(%qsysfunc(' "&packageName.META" '&syspbuff.)))%end;'
+      / '%mend;' / /;
+    put '%end;'; /* cherryPick 4 ---*/
+  /*==========================================================================================*/
+
   /* list cmplib for functions and fmtsearch for formats*/
   if isFunction OR isProto then
     do;      
@@ -2162,8 +2228,10 @@ data _null_;
     end;
 
   /* update SYSloadedPackages global macrovariable */
-  put 'options noNotes;'
-    / '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
+
+  put '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
+    / ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
+    / ' options noNotes;'
     / ' data _null_ ;                                                                                              '
     / '  length SYSloadedPackages stringPCKG $ 32767;                                                              '
     / '  if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then                           '
@@ -2180,7 +2248,7 @@ data _null_;
     / "          SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)');              "
     / '          SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#"));                               '
     / '          call symputX("SYSloadedPackages", SYSloadedPackages, "G");                                        '
-    / '          put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ;                                             '
+    / '          put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ;                                             '
     / '         end ;                                                                                              '
     / "      else                                                                                                  "
     / '         do;                                                                                                '
@@ -2189,16 +2257,17 @@ data _null_;
     / "          SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)');              "
     / '          SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#"));                               '
     / '          call symputX("SYSloadedPackages", SYSloadedPackages, "G");                                        '
-    / '          put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ;                                             '
+    / '          put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ;                                             '
     / '         end ;                                                                                              '
     / '    end;                                                                                                    '
     / '  else                                                                                                      '
     / '    do;                                                                                                     '
     / "      call symputX('SYSloadedPackages', '&packageName.(&packageVersion.)', 'G');                            "
-    / "      put / 'INFO:[SYSLOADEDPACKAGES] &packageName.(&packageVersion.)';                                     "
+    / "      put / 'INFO: [SYSLOADEDPACKAGES] &packageName.(&packageVersion.)';                                     "
     / '    end;                                                                                                    '
     / '  stop;                                                                                                     '
     / ' run;                                                                                                       '
+    / ' options &temp_noNotes_etc.;'
     / '%end; ' / ; /* Cherry Pick test3 end */
 
   put 'options NOTES;'
@@ -2314,7 +2383,8 @@ data _null_;
     / '  from dictionary.catalogs'
     / '  where '
     / '  ('
-    / '   objname in ("*"' 
+    / '   objname in ("*"'
+    / "   ,%UPCASE('&packageName.META')" 
     / "   ,%UPCASE('&packageName.IML')" 
     / "   ,%UPCASE('&packageName.CASLUDF')";
   /* list of macros */
@@ -2416,7 +2486,12 @@ data _null_;
       / 'deletefunc ' fileshort ';';
     isFunction + 1;
   end;
-  put "run;" /;
+  put "quit;" /;
+
+  put "proc fcmp outlib = work.&packageName.fcmp.packagemeta;"
+    / "deletefunc &packageName.META;"
+    / "quit;" /;
+  isFunction + 1;
 
   /* delete the link to the functions dataset */
   if isFunction then
@@ -2736,7 +2811,7 @@ data _null_;
   %end;
 
   put 'put " " / @3 "---------------------------------------------------------------------" / " ";' 
-    /       'put @3 "*SAS package generated by SAS Package Framework, version `20251231`*";' 
+    /       'put @3 "*SAS package generated by SAS Package Framework, version `20260515`*";' 
     /       "put @3 '*under `&sysscp.`(`&sysscpl.`) operating system,*';"
     /       "put @3 '*using SAS release: `&sysvlong4.`.*';"
     / 'put " " / @3 "---------------------------------------------------------------------";';

SPF/Macros/helppackage.sas

@@ -28,7 +28,7 @@
                                         */
 )/secure
 /*** HELP END ***/
-des = 'Macro to get help about SAS package, version 20251231. Run %helpPackage() for help info.'
+des = 'Macro to get help about SAS package, version 20260515. Run %helpPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
   %do;
@@ -43,7 +43,7 @@ des = 'Macro to get help about SAS package, version 20251231. Run %helpPackage()
     %put ###       This is short help information for the `helpPackage` macro            #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to get help about SAS packages, version `20251231`                      #;
+    %put # Macro to get help about SAS packages, version `20260515`                      #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -133,18 +133,20 @@ des = 'Macro to get help about SAS package, version 20251231. Run %helpPackage()
 
   %local _PackageFileref_;
   data _null_; 
-    call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+    length packageName $ 32;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
+      exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");

SPF/Macros/installpackage.sas

@@ -1,5 +1,5 @@
 /*+installPackage+*/
-/* Macros to install SAS packages, version 20251231  */
+/* Macros to install SAS packages, version 20260515  */
 /* A SAS package is a zip file containing a group of files
    with SAS code (macros, functions, data steps generating 
    data, etc.) wrapped up together and %INCLUDEed by
@@ -13,6 +13,7 @@
 , mirror = 0    /* indicates which location for package source should be used */
 , version =     /* indicates which version of a package to install */
 , replace = 1   /* 1 = replace if the package already exist, 0 = otherwise */
+, backup = 0    /* 1 = before replacing make a copy if the package already exist, 0 = do nothing */
 , URLuser =     /* user name for the password protected URLs */
 , URLpass =     /* password for the password protected URLs */
 , URLoptions =  /* options for the `sourcePath` URLs */
@@ -22,11 +23,14 @@
                    default is 0 - means No, 1 means Yes */
 , SFRCVN =      /* name of a macro variable to store success-failure return code value */
 , github =      /* name of a user or an organization in GitHub, all characters except [A-z0-9_.-] are compressed */
+, githubRepo = %sysfunc(lowcase(&packageName.)) /* repo name to be used, by default it is the package name, but can be altered */
+, githubToken = /* user's github fine-grained personal access token */
+, githubTokenDebug = 0 /* debug values: 0,1,2,3 */
 )
 /secure
 minoperator 
 /*** HELP END ***/
-des = 'Macro to install SAS package, version 20251231. Run %%installPackage() for help info.'
+des = 'Macro to install SAS package, version 20260515. Run %%installPackage() for help info.'
 ;
 %if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
   %do;
@@ -41,7 +45,7 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
     %put ###       This is short help information for the `installPackage` macro                      #;
     %put #--------------------------------------------------------------------------------------------#;;
     %put #                                                                                            #;
-    %put # Macro to install SAS packages, version `20251231`                                          #;
+    %put # Macro to install SAS packages, version `20260515`                                          #;
     %put #                                                                                            #;
     %put # A SAS package is a zip file containing a group                                             #;
     %put # of SAS codes (macros, functions, data steps generating                                     #;
@@ -90,8 +94,15 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
     %put #                   When there are multiple packages to install the `version` variable       #;
     %put #                   is scan sequentially.                                                    #;
     %put #                                                                                            #;
-    %put # - `replace=`      With default value of `1`, it causes existing package file 0             #;
-    %put #                   to be replaced by new downloaded file.                                   #;
+    %put # - `replace=`      When set to `1` and a package file exists, it forces the package         #;
+    %put #                   file replacement by the new downloaded file.                             #;
+    %put #                   It is a binary indicator ('0' or '1'). Default value is `1`.             #;
+    %put #                                                                                            #;
+    %put # - `backup=`       When set to `1` and a package file exists, it creates a backup copy      #;
+    %put #                   of the package file. The backup copy is created with a suffix of the     #;
+    %put #                   following format: `_BCKP_yyyymmddJJMMSS`.                                #;
+    %put #                   If `replace=0` then `backup` is set to `0`.                              #;
+    %put #                   It is a binary indicator ('0' or '1'). Default value is `0`.             #;
     %put #                                                                                            #;
     %put # - `URLuser=`      A user name for the password protected URLs, no quotes needed.           #;
     %put #                                                                                            #;
@@ -119,9 +130,27 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
     %put #                                                                                            #;
     %put #  - `github=`      *Optional.* A name of a user or an organization in GitHub.               #;
     %put #                   Allows an easy set of the search path for packages available on GitHub:  #;
-    %put #                    `https://github.com/<github>/<packagename>/raw/.../`                    #;
+    %put #                    `https://github.com/<github>/<githubRepo>/raw/.../`                     #;
     %put #                   All characters except `[A-z0-9_.-]` are compressed.                      #;
     %put #                                                                                            #;
+    %put #  - `githubRepo=`  *Optional.* A name of a repository in GitHub.                            #;
+    %put #                   Allows an easy set of the search path for packages available on GitHub:  #;
+    %put #                    `https://github.com/<github>/<githubRepo>/raw/.../`                     #;
+    %put #                   By default lowercase name of installed package is used.                  #;
+    %put #                                                                                            #;
+    %put #  - `githubToken=` *Optional.* A fine-grained personal access token for GitHub.             #;
+    %put #                   When the value is non-missing it triggers GitHub API access to           #;
+    %put #                   private repositories. Of course the token used has to be configured      #;
+    %put #                   properly for the access.                                                 #;
+    %put #                   Read GitHub documentation to learn how to create and setup your token:   #;
+    %put #                   `https://docs.github.com/en/authentication/                              #;
+    %put #                     keeping-your-account-and-data-secure/                                  #;
+    %put #                      managing-your-personal-access-tokens                                  #;
+    %put #                       #creating-a-fine-grained-personal-access-token`                      #;
+    %put #                   (lines break added for easier reading)                                   #;
+    %put #                   Public repos do not need authentication.                                 #;
+    %put #                   [NOTE!] This feature is experimental in this release.                    #;
+    %put #                                                                                            #;
     %put #--------------------------------------------------------------------------------------------#;
     %put #                                                                                            #;
     %put # Visit: `https://github.com/yabwon/SAS_PACKAGES/tree/main/SPF/Documentation`                #;
@@ -200,9 +229,13 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
 
   %let loadAddCnt = %sysevalf(NOT(0=%superq(loadAddCnt)));
   %let instDoc    = %sysevalf(NOT(0=%superq(instDoc)));
+  %let backup     = %sysevalf(NOT(0=%superq(backup)));
   
   %let replace    = %sysevalf(1=%superq(replace));
 
+  /* in case you do not replace then you also do not do a backup */
+  %if 0=&replace. %then %let backup = 0;
+
   %if %superq(sourcePath)= %then
     %do;
       %local SPFinitMirror SPFinitMirrorMD;
@@ -259,7 +292,7 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
         %do;
           %let SPFinitMirror   = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.sas;
           %let SPFinitMirrorMD = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.md;
-          /* ingnore version support for pharmaForest for now */
+          /* ingnore version support for github for now */
           %let github = %sysfunc(compress(%superq(github),%str(,.-),KAD));
           %put INFO: GitHub location used is: %superq(github).;
           %let sourcePath = https://github.com/&github./; /*users content*/
@@ -321,13 +354,16 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
     %put ### &packageName.(&vers.) ###;
     
     %put *** %sysfunc(lowcase(&packageName.)) start *****************************************;
-    %local in out inMD outMD _IOFileref_;
+    %local in out inMD outMD bckp_ref bckplabel _IOFileref_;
     data _null_; call symputX("_IOFileref_", put(MD5(lowcase("&packageName.")), hex7. -L), "L"); run;
     %let  in = i&_IOFileref_.;
     %let out = o&_IOFileref_.;
     %let  inMD = j&_IOFileref_.;
     %let outMD = u&_IOFileref_.;
 
+    %let bckp_ref = b&_IOFileref_.;
+    %let bckplabel = _BCKP_%sysfunc(compress(%sysfunc(datetime(),b8601dt.),,KD));
+
     /* %let  in = i%sysfunc(md5(&packageName.),hex7.); */
     /* %let out = o%sysfunc(md5(&packageName.),hex7.); */
 
@@ -340,7 +376,7 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
             %let SPFinitMirror   = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/&vers./SPF/SPFinit.sas;
             %let SPFinitMirrorMD = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/&vers./SPF/SPFinit.md;
           %end;
-        %if %superq(mirror) > 1 %then
+        %if NOT (%superq(mirror) in (0 1 4)) %then
           %put %str( )Mirror %superq(mirror) does not support versioning.;
  
         /* source code file */
@@ -363,12 +399,12 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
       %do;
         %if %superq(mirror) IN (0 3 4) %then /* SASPAC or PharmaForest or an arbitrary GitHub repo */
           %do;
-            %let packageSubDir = %sysfunc(lowcase(&packageName.))/raw/main/;
+            %let packageSubDir = &githubRepo./raw/main/;
             
             %if %superq(vers) ne %then
               %do;
                 /*%let packageSubDir = %sysfunc(lowcase(&packageName.))/main/hist/&version./;*/
-                %let packageSubDir = %sysfunc(lowcase(&packageName.))/raw/&vers./;
+                %let packageSubDir = &githubRepo./raw/&vers./;
               %end;
           %end;
         %else
@@ -405,6 +441,13 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
     /* copy the file byte-by-byte  */
     %local installationRC;
     %let installationRC=1;
+
+    %if (%superq(githubToken)= )
+        OR
+        (%upcase(&packageName.) in (SPFINIT SASPACKAGEFRAMEWORK SASPACKAGESFRAMEWORK))
+    %then
+    %do;
+    /* public repo, location with URL access, or SPFinit */
     data _null_;
       length filein fileinMD 8 
         out_path in_path out_pathMD in_pathMD rcTXT $ 4096
@@ -451,12 +494,34 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
         do;
           if symgetn("replace")=1 then
             do;
+              rc = 0;
               put @2 "The following file will be replaced during "
                 / @2 "installation of the &packageName. package: " 
                 / @5 out_path;
-              rc = FDELETE(out_ref);
-              rc = FCOPY(in_ref, out_ref);
-              rcTXT=sysmsg();
+
+              /* backup package file */
+              if symgetn("backup")=1 then
+                do;
+                  length bckp_ref $ 8 bckplabel $ 32;
+                  bckplabel = "&bckplabel.";
+                  rc = filename(bckp_ref, cats(out_path, bckplabel), "DISK", "recfm=N lrecl=1");
+                  put / @2 "The following backup file will be created:"
+                      / @5 out_path +(-1) bckplabel;                  
+                  rc + FCOPY(out_ref, bckp_ref);
+                  rcTXT=sysmsg();
+                  if rc then put "WARNING: [&packageName.] Backup failed... ";
+                  _N_ = filename(bckp_ref);
+                end;
+
+              /* replace package file */
+              if rc=0 then
+                do;
+                  rc + FDELETE(out_ref);
+                  if 0=rc then
+                    rc + FCOPY(in_ref, out_ref);
+                  rcTXT=sysmsg();
+                  if rc then put "WARNING: [&packageName.] Installation failed... ";
+                end;
             end;
           else
             do;
@@ -484,6 +549,9 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
                 end;
               else if 1=FEXIST(out_refMD) and 1=symgetn("replace") then
                 do;
+                  if symgetn("backup")=1 then 
+                    put @2 "No backup done for documentation file.";
+
                   rcMD = FDELETE(out_refMD);
                   if rcMD=0 then
                     rcMD2 = FCOPY(in_refMD, out_refMD);
@@ -495,7 +563,161 @@ des = 'Macro to install SAS package, version 20251231. Run %%installPackage() fo
             put @2 "Package documentation in markdown format not available." ; /* / out_pathMD / in_pathMD;*/
         end;
     run;
-     
+    /************************************************************************************************************/
+    %end;
+    %else
+    %do;
+    /* when githubToken= is not null then a "private repo" case is assumed           */
+    /* except for SPFinit.sas that is always installed from SAS_PACKAGES public repo */
+
+    %put [NOTE!] This feature is experimental in this release!;
+    %local ref notRunHTTP;
+    %let notRunHTTP=1;
+    %if %superq(vers)= %then %let ref = main;
+                       %else %let ref = &vers.;
+    
+    %if NOT(%superq(githubTokenDebug) in (0 1 2 3)) %then %let githubTokenDebug = 0;
+
+    %if %sysfunc(FEXIST(&out.)) = 0 %then 
+      %do;
+        %put %str(  )Installing the &packageName. package;
+        %put %str(  )in the &firstPackagesPath. directory.;
+        %let notRunHTTP=0;
+      %end;
+    %else
+      %do;
+        %if 1=&replace. %then
+          %do;
+            %put %str(  )The following file will be replaced during;
+            %put %str(  )installation of the &packageName. package:; 
+            %put %str(     )%sysfunc(pathname(&out.));
+
+            /* backup package file */
+            %if 1=&backup. %then
+              %do;
+                filename &bckp_ref. "&firstPackagesPath./%sysfunc(lowcase(&packageName.)).zip&bckplabel." recfm=N lrecl=1;
+
+                %put %str(  )The following backup file will be created:; 
+                %put %str(     )%sysfunc(pathname(&bckp_ref.));
+ 
+                %let notRunHTTP = %sysfunc(FCOPY(&out., &bckp_ref.));
+                %put %sysfunc(sysmsg());
+
+                filename &bckp_ref. clear;
+
+                %let notRunHTTP = %sysevalf(&notRunHTTP. + %sysfunc(FDELETE(&out.)));
+                %put %sysfunc(sysmsg());
+              %end;
+            %else
+              %do;
+                %let notRunHTTP = %sysfunc(FDELETE(&out.));
+                %put %sysfunc(sysmsg());
+              %end;
+          %end;
+        %else
+          %do;
+            %put %str(  )The following file will NOT be replaced:; 
+            %put %str(  )%sysfunc(pathname(&out.));
+            %let notRunHTTP = 1;
+          %end;
+      %end;
+
+    %if %superq(githubToken) NE %qsysfunc(compress(%superq(githubToken),%str( _),KAD)) %then
+      %do;
+        %put WARNING: The githubToken= parameter contains illegal symbols;
+        %put WARNING- Allowed symbols are letters A to Z and a to z, digits 0 to 9, and underscore(_);
+        %put WARNING- Verify your token. Installation aborted.;
+        %let notRunHTTP = 1;
+      %end; 
+
+    %if &notRunHTTP.=0 %then
+      %do;
+        %put %str(  )URL called by PROC HTTP is:;
+        %put %str(  )"https://api.github.com/repos/&github./&githubRepo./contents/%sysfunc(lowcase(&packageName.)).zip?ref=&ref.";
+        %put %str(  )Headers:;
+        %put %str(    )Accept=application/vnd.github.raw+json;
+        %put %str(    )X-GitHub-Api-Version=2026-03-10;
+        %put %str(    )Authorization=Bearer *****************;
+        %put %str(  );
+
+
+        /* proc http setup based on: 
+           https://docs.github.com/en/rest/repos/contents?apiVersion=2026-03-10#get-repository-content
+        */
+        proc http 
+          method="GET"
+          out=&out.
+          URL=
+          "https://api.github.com/repos/&github./&githubRepo./contents/%sysfunc(lowcase(&packageName.)).zip?ref=&ref."
+          CLEAR_CACHE
+          ;
+          headers
+             "Accept"="application/vnd.github.raw+json"
+             "X-GitHub-Api-Version"="2026-03-10"
+             "Authorization"="Bearer &githubToken."
+          ;     
+          debug level=&githubTokenDebug.;
+        run;
+        
+        %if %sysfunc(FEXIST(&out.)) AND &SYS_PROCHTTP_STATUS_CODE.=200 %then
+          %do;
+            %let installationRC=0;
+            %put %str(  )Done with return code rc=0 (zero = success);
+          %end;
+        %else
+          %do;
+            %let installationRC=1;
+            %put %str(  )Done with return code rc=&SYS_PROCHTTP_STATUS_CODE. (zero = success);
+            %put %str(  )Message: &SYS_PROCHTTP_STATUS_PHRASE.;
+          %end;
+
+        %let notRunHTTP=1;
+        %if 1=&instDoc. AND 0=&installationRC. %then
+          %do;
+            %if %sysfunc(FEXIST(&outMD.)) = 0 %then
+              %do;
+                %put %str(  )Package documentation installation on request:;
+                %let notRunHTTP = 0;
+              %end;
+            %else %if 1=&replace. %then
+              %do;
+                %if 1=&backup. %then %put %str(  )No backup done for documentation file.;
+                %put %str(  )Package documentation installation on demand:;
+                %let notRunHTTP = %sysfunc(FDELETE(&outMD.));
+                %if &notRunHTTP. %then %put %sysfunc(sysmsg());
+              %end;
+
+            %if &notRunHTTP.=0 %then
+              %do;
+                proc http 
+                  method="GET"
+                  out=&outMD.
+                  URL=
+                  "https://api.github.com/repos/&github./&githubRepo./contents/%sysfunc(lowcase(&packageName.)).md?ref=&ref."
+                  CLEAR_CACHE
+                  ;
+                  headers
+                     "Accept"="application/vnd.github.raw+json"
+                     "X-GitHub-Api-Version"="2026-03-10"
+                     "Authorization"="Bearer &githubToken."
+                  ;     
+                  debug level=&githubTokenDebug.;
+                run;
+                %if %sysfunc(FEXIST(&outMD.)) AND &SYS_PROCHTTP_STATUS_CODE.=200 
+                %then %put %str(  )status successful!;
+                %else %put %str(  )status unsuccessful!;
+
+              %end;
+          %end;
+      %end;
+    %else 
+      %do;
+        %let installationRC=1;
+        %put %str(  )Done with return code rc=1 (zero = success);
+      %end;
+    /************************************************************************************************************/
+    %end;
+
     filename &in.  clear;
     filename &out. clear;
     filename &inMD.  clear;

SPF/Macros/ispackagesfilerefok.sas

@@ -4,7 +4,7 @@
 vERRb /* indicates if macro should be verbose and report errors */
 )
 / minoperator PARMBUFF
-des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20251231.'
+des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260515.'
 ;
 /*** HELP END ***/
 %if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
@@ -20,7 +20,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
     %put ###       This is short help information for the `isPackagesFilerefOK` macro              #;
     %put #-----------------------------------------------------------------------------------------#;;
     %put #                                                                                         #;
-    %put # Macro to check if the `packages` fileref is "correct", version `20251231`               #;
+    %put # Macro to check if the `packages` fileref is "correct", version `20260515`               #;
     %put #                                                                                         #;
     %put # A SAS package is a zip file containing a group                                          #;
     %put # of SAS codes (macros, functions, data steps generating                                  #;

SPF/Macros/listpackages.sas

@@ -3,7 +3,7 @@
 
   Macro to list SAS packages in packages folder. 
 
-  Version 20251231 
+  Version 20260515 
 
   A SAS package is a zip file containing a group 
   of SAS codes (macros, functions, data steps generating 
@@ -21,11 +21,13 @@
 *//*** HELP END ***/
 
 
-%macro listPackages()
-/secure PARMBUFF
-des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20251231.'
+%macro listPackages(
+  listDataSet /* Name of a data set to save results */
+, quiet = 0   /* Indicate if results should be printed in log */
+)/secure parmbuff
+des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260515.'
 ;
-%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
+%if (%QUPCASE(&listDataSet.) = HELP) %then
   %do;
     %local options_tmp ;
     %let options_tmp = ls=%sysfunc(getoption(ls)) ps=%sysfunc(getoption(ps))
@@ -38,7 +40,7 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
     %put ###       This is short help information for the `listPackages` macro                     #;
     %put #-----------------------------------------------------------------------------------------#;;
     %put #                                                                                         #;
-    %put # Macro to list available SAS packages, version `20251231`                                #;
+    %put # Macro to list available SAS packages, version `20260515`                                #;
     %put #                                                                                         #;
     %put # A SAS package is a zip file containing a group                                          #;
     %put # of SAS codes (macros, functions, data steps generating                                  #;
@@ -49,7 +51,11 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
     %put #                                                                                         #;
     %put #### Parameters:                                                                          #;
     %put #                                                                                         #;
-    %put # NO PARAMETERS                                                                           #;
+    %put # 1. `listDataSet`  Name of a SAS data set to store results in.                           #;
+    %put #                   No data set options are honored.                                      #;
+    %put #                                                                                         #;
+    %put # - `quiet=`      *Optional.* Indicates if the LOG printout should be suspended.          #;
+    %put #                 Default value of zero (`0`) means "Do printout", other means "No".      #;
     %put #                                                                                         #;
     %put # When used as: `%nrstr(%%listPackages(HELP))` it displays this help information.                  #;
     %put #                                                                                         #;
@@ -74,6 +80,8 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
     %put  %nrstr( %%include packages(SPFinit.sas);      %%* enable the framework;                           );
     %put  ;
     %put  %nrstr( %%listPackages()                      %%* list available packages;                        );
+    %put  ;
+    %put  %nrstr( %%listPackages(ListDS,quiet=1)        %%* save packages list in ListDS data set;          );
     %put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
     %put ###########################################################################################;
     %put ;
@@ -81,30 +89,50 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
     %GOTO ENDoflistPackages;
   %end;
 
-%local ls_tmp ps_tmp notes_tmp source_tmp filesWithCodes;
-
-%let filesWithCodes = WORK._%sysfunc(datetime(), hex16.)_;
+%local ls_tmp ps_tmp notes_tmp source_tmp listDataSetCheck ;
 
 %let ls_tmp     = %sysfunc(getoption(ls));
 %let ps_tmp     = %sysfunc(getoption(ps));
 %let notes_tmp  = %sysfunc(getoption(notes));
 %let source_tmp = %sysfunc(getoption(source));
+%let listDataSetCheck=0;
+
+%let quiet = %sysevalf(NOT(0=%superq(quiet)));
 
 options NOnotes NOsource ls=MAX ps=MAX;
 
-data _null_;
-  length baseAll $ 32767 base $ 1024;
+%if %superq(listDataSet) NE %then 
+  %do;
+    data _null_; /* verify listDataSet compatibility with V7 naming */
+      %SPFinit_intrnl_forceV7DSname(listDataSet);
+
+      call symputX('listDataSet',listDataSet,"L");
+      if not (listDataSet = " ") then 
+        call symputX('listDataSetCheck',1,"L");
+      else call symputX('quiet',0,"L");
+    run;
+  %end;
+
+data _null_ 
+  %if 1=&listDataSetCheck. %then
+    %do;
+      &listDataSet.(compress=yes keep=k base PackageZIPNumber folder n tag value rename=(folder=PackageZIP k=baseNumber n=tagNumber))
+    %end;
+;
+  length k 8 baseAll $ 32767 base $ 1024 PackageZIPNumber 8;
   baseAll = pathname("packages");
 
+  array TAGSLIST[6] $ 16 _temporary_ ("PACKAGE" "TITLE" "VERSION" "AUTHOR" "MAINTAINER" "LICENSE");
+
   if baseAll = " " then
     do;
-      put "NOTE: The file reference PACKAGES is not assigned.";
+      put "WARNING: The file reference PACKAGES is not assigned.";
       stop;
     end;
 
   if char(baseAll,1) ^= "(" then baseAll = quote(strip(baseAll)); /* for paths with spaces */
   
-  do k = 1 to kcountw(baseAll, "()", "QS"); drop k;
+  do k = 1 to kcountw(baseAll, "()", "QS"); /*drop k;*/
     base = dequote(kscanx(baseAll, k, "()", "QS"));
 
     length folder $ 64 file $ 1024 folderRef fileRef $ 8;
@@ -114,15 +142,21 @@ data _null_;
     rc=filename(folderRef, base);
     folderid=dopen(folderRef);
 
-    putlog " ";
-    put "/*" 100*"+" ;
+    %if 0=&quiet. %then 
+      %do; 
+        putlog " ";
+        put "/*" 100*"+" ;
+      %end;
     do i=1 to dnum(folderId); drop i;
 
       if i = 1 then
         do;
+          %if 0=&quiet. %then 
+            %do; 
               put " #";
               put " # Listing packages for: " base;
               put " #";
+            %end;
         end;
 
       folder = dread(folderId, i);
@@ -133,7 +167,7 @@ data _null_;
 
       EOF = 0;
       if fileId = 0 and lowcase(kscanx(folder, -1, ".")) = 'zip' then 
-        do;
+        do;          
           file = catx('/',base, folder);
           
           rc1 = filename("package", strip(file), 'zip', 'member="description.sas"');
@@ -142,24 +176,43 @@ data _null_;
 
           if rcE then /* if the description.sas exists in the zip then read it */
             do;
-              putlog " *  ";
+              PackageZIPNumber+1;
               length nn $ 96;
-              if (96-lengthn(file)) < 1 then
-                put " * " file;  
-              else
-                do;
-                  nn = repeat("*", (96-lengthn(file)));   
-                  put " * " file nn;
-                end;
-              
+              %if 0=&quiet. %then 
+                %do; 
+                  putlog " *  ";
+                  if (96-lengthn(file)) < 1 then
+                    put " * " file;  
+                  else
+                    do;
+                      nn = repeat("*", (96-lengthn(file)));   
+                      put " * " file nn;
+                    end;
+                %end;
+
               infile _DUMMY_ ZIP FILEVAR=file member="description.sas" end=EOF;
               
-              do until(EOF);
+              n = 0;
+              do lineinfile = 1 by 1 until(EOF);
                 input;
-                if strip(upcase(kscanx(_INFILE_,1,":"))) in ("PACKAGE" "TITLE" "VERSION" "AUTHOR" "MAINTAINER" "LICENSE") then
+
+                length tag $ 16 value $ 4096;
+
+                tag = strip(upcase(kscanx(_INFILE_,1,":")));
+                value = kscanx(_INFILE_,2,":");
+                n = whichc(tag, of TAGSLIST[*]);
+
+                if (n > 0) then
                   do;
-                    _INFILE_ = kscanx(_INFILE_,1,":") !! ":" !! kscanx(_INFILE_,2,":");
-                    putlog " *  " _INFILE_;
+                    %if 0=&quiet. %then 
+                      %do; 
+                        putlog " *  " tag +(-1) ":" @ 17 value;
+                      %end;
+                    %if 1=&listDataSetCheck. %then
+                      %do;
+                        output &listDataSet.;
+                      %end;
+                    n=0;
                   end;                
                 if strip(upcase(strip(_INFILE_))) =: "DESCRIPTION START:" then leave;
               end;
@@ -170,15 +223,41 @@ data _null_;
       rc = filename(fileRef);
     end;
 
-    putlog " *  ";
-    put 100*"+" "*/";
+    %if 0=&quiet. %then 
+      %do; 
+        putlog " *  ";
+        put 100*"+" "*/";
+      %end;
     rc = dclose(folderid);
     rc = filename(folderRef);
   end;
 
   stop;
+  label
+    k = "Packages path ordering number."
+    base = "Packages path."
+    PackageZIPNumber = "Packages ZIP file number."
+    folder = "Packages ZIP file."
+    n = "Tag number"
+    tag = "Package Tag Name"
+    value = "Value"
+    ;
 run;
 
+%if 1=&listDataSetCheck. %then
+  %do;
+    proc sort data=&listDataSet. out=&listDataSet.(compress=yes label='Output from the %listPackages() macro');
+      by baseNumber PackageZIPNumber tagNumber;
+    run;
+
+    %if 0=&quiet. %then 
+      %do; 
+        %put %str( );
+        %put # Results provided in the &listDataSet. data set. #;
+        %put %str( );
+      %end;
+  %end;
+
 options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
 
 %ENDoflistPackages:

SPF/Macros/loadpackage.sas

@@ -36,7 +36,7 @@
                                        */
 )/secure
 /*** HELP END ***/
-des = 'Macro to load SAS package, version 20251231. Run %loadPackage() for help info.'
+des = 'Macro to load SAS package, version 20260515. Run %loadPackage() for help info.'
 minoperator
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -52,7 +52,7 @@ minoperator
     %put ###      This is short help information for the `loadPackage` macro             #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to *load* SAS packages, version `20251231`                              #;
+    %put # Macro to *load* SAS packages, version `20260515`                              #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -180,30 +180,34 @@ minoperator
 
   %local _PackageFileref_;
   data _null_; 
-    call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+    length packageName $ 32;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
+      exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");
-  run;
+  /*run;*/ /* moved to line 272 */
   
   /* convert cherryPick to lower case if needed */
   %if NOT (%str(*) = %superq(cherryPick)) %then
     %do;
-      data _null_;
+      /*data _null_;*/
         call symputX("cherryPick",lowcase(compbl(compress(symget("cherryPick"),". _","KDA"))),"L");
-      run;
+      /*run;*/
     %end;
+  run;
+
   /* empty list is equivalent to "*" */ 
   %if %superq(cherryPick)= %then 
     %do;

SPF/Macros/loadpackageaddcnt.sas

@@ -19,7 +19,7 @@
                                          is provided in required version */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to load additional content for a SAS package, version 20251231. Run %loadPackageAddCnt() for help info.'
+des = 'Macro to load additional content for a SAS package, version 20260515. Run %loadPackageAddCnt() for help info.'
 minoperator
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -35,7 +35,7 @@ minoperator
     %put ###      This is short help information for the `loadPackageAddCnt` macro       #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to *load* additional content for a SAS package, version `20251231`      #;
+    %put # Macro to *load* additional content for a SAS package, version `20260515`      #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -116,20 +116,22 @@ minoperator
   options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
 
   %local _PackageFileref_;
-  data _null_; 
-    call symputX("_PackageFileref_", "A" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-    call symputX("_TargetFileref_",  "T" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+  data _null_;
+    length packageName $ 32;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "A" !! put(MD5(strip(packageName)), hex7. -L), "L"); 
+    call symputX("_TargetFileref_",  "T" !! put(MD5(strip(packageName)), hex7. -L), "L");
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
+      exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");

SPF/Macros/loadpackages.sas

@@ -11,7 +11,7 @@
                  */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to load multiple SAS packages at one run, version 20251231. Run %loadPackages() for help info.'
+des = 'Macro to load multiple SAS packages at one run, version 20260515. Run %loadPackages() for help info.'
 parmbuff
 ;
 %if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
@@ -27,7 +27,7 @@ parmbuff
     %put ###      This is short help information for the `loadPackageS` macro            #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro wrapper for the loadPackage macro, version `20251231`                   #;
+    %put # Macro wrapper for the loadPackage macro, version `20260515`                   #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;

SPF/Macros/previewpackage.sas

@@ -23,7 +23,7 @@
                                        */
 )/secure
 /*** HELP END ***/
-des = 'Macro to preview content of a SAS package, version 20251231. Run %previewPackage() for help info.'
+des = 'Macro to preview content of a SAS package, version 20260515. Run %previewPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
   %do;
@@ -38,7 +38,7 @@ des = 'Macro to preview content of a SAS package, version 20251231. Run %preview
     %put ###    This is short help information for the `previewPackage` macro            #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to get preview of a SAS packages, version `20251231`                    #;
+    %put # Macro to get preview of a SAS packages, version `20260515`                    #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -119,18 +119,20 @@ des = 'Macro to preview content of a SAS package, version 20251231. Run %preview
   
   %local _PackageFileref_;
   data _null_; 
-    call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+    length packageName $ 32;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L"); 
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
+      exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");

SPF/Macros/relocatepackage.sas

@@ -15,7 +15,7 @@
 ,psMAX=MAX     /* pageSise in case executed inside DoSubL() */
 ,ods=          /* a data set for results, e.g., work.relocatePackageReport */
 )
-/ des = 'Utility macro that locally Copies or Moves Packages, version 20251231. Run %relocatePackage() for help info.'
+/ des = 'Utility macro that locally Copies or Moves Packages, version 20260515. Run %relocatePackage() for help info.'
   secure
   minoperator
 ;
@@ -33,7 +33,7 @@
     %put ###      This is short help information for the `relocatePackage` macro         #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to *locally copy or move* (relocate) SAS packages, version `20251231`   #;
+    %put # Macro to *locally copy or move* (relocate) SAS packages, version `20260515`   #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -185,7 +185,14 @@
       %put WARNING: Checksum verification impossible! Minimum SAS version required for the process is 9.4M6. ;
     %end;
 
-  data _null_ %if %superq(ods) NE %then %do; &ods. %end;
+  %if NOT %sysevalf(%superq(ods)=,BOOLEAN) %then %do;
+    data _null_; /* verify ods= value */
+      %SPFinit_intrnl_forceV7DSname(ods);
+      call symputX("ods",ods,"L");
+    run;
+  %end;
+
+  data _null_ &ods. /* the &ods. will be used if not missing */
   ;
     putlog 52*"*" 24*"=" 52*"*";
     length packages source target $ 32767 sDevice tDevice $ 32;
@@ -565,7 +572,7 @@
                      / "WARNING- Source is: " s_HASHING 
                      / "WARNING- Target is: " t_HASHING
                      / "WARNING- There could be errors during copying. Check your files.";
-              %if %superq(ods) NE %then %do; output %scan(&ods.,1,()) ; %end;
+              output &ods.; /* the &ods. will be used if not missing */
             end;
         %end;
 

SPF/Macros/saspackagesframeworknotes.sas

@@ -5,7 +5,7 @@ SPFmacroName /* space separated list of names */
 /
 minoperator 
 secure
-des = 'Macro to provide help notes about SAS Packages Framework macros, version 20251231. Run %SasPackagesFrameworkNotes(HELP) for help info.'
+des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260515. Run %SasPackagesFrameworkNotes(HELP) for help info.'
 ;
 %local list N i element;
 %let list=
@@ -51,7 +51,7 @@ SasPackagesFrameworkNotes
     %put ###   This is short help information for the `SasPackagesFrameworkNotes` macro  #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro prints help notes for SAS Packages Framework macros, version `20251231` #;
+    %put # Macro prints help notes for SAS Packages Framework macros, version `20260515` #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;

SPF/Macros/spfinit_intrnl_forcev7dsname.sas

@@ -0,0 +1,94 @@
+/*+SPFinit_intrnl_forceV7DSname+*/
+%macro SPFinit_intrnl_forceV7DSname(
+mcParam /* name of a macro parameter holding user provided data set name */
+)/secure minoperator
+des='SAS Packages Framework internal macro. Executable only inside selected SPF macros. Macro generates 4GL code that forces V7 compatybility for user provided data set names. Version 20260515.';
+/* The macro can be called only inside a data step. */
+/****************************************************************************
+  ### Parameters:
+
+  `mcParam` - name of a macro parameter holding user provided data set name
+
+  ### Behavior:
+  
+  Description:
+    The 4GL code SYMGETs macro variable value, SCANs only first 
+    part of the string in case there are parenthesis "()" in it. 
+    Then it COMPRESSes the string and keep _only_ digits, letters, 
+    underscore, and period. All periods are TRANSLATEd to spaces. 
+    If created string is not empty its last chunk is SCANned for 
+    data set name, the second to last chunk is SCANned for libname 
+    (if empty then "work" is used). First character of LIB and DS 
+    variables is checked, if it is a digit, then underscore is added. 
+    At the end the LIB and DS are concatenated and casted to upper 
+    case letters. 
+  
+  Examples:
+
+    abc.xyz -> ABC.XYZ
+    ABC.XYZ(obs=42) -> ABC.XYZ
+    XYZ -> WORK.XYZ
+    abc. -> WORK.ABC
+    .XYZ -> WORK.XYZ
+    123.456 -> _123._456
+    A#B.x$y -> AB.XY
+
+  Usecase:
+    Inside a macro for value check
+
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+    %macro A(ods);
+      data _null_;
+        %SPDinit_intrnl_forceV7DSname(ods);
+        call symputX("ods",ods,"L");
+      run;
+      
+      %if %superq(ods) ne  %then
+        %do;
+          data &ods.;
+            ...
+          run;
+        %end;
+    %mend;
+
+    %A()
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+****************************************************************************/
+%local allowedSPFmacrosList;
+%let allowedSPFmacrosList=LISTPACKAGES RELOCATEPACKAGE UNBUNDLEPACKAGES BUNDLEPACKAGES;
+%if %sysmexecname(%sysmexecdepth-1) in (&allowedSPFmacrosList.) %then
+%do;
+/*=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=*/
+  length &mcParam. $ 41 lib $ 8 ds $ 32;
+  /* force only V7 valid symbols */
+  &mcParam. = symget("&mcParam.");
+  if NOT (&mcParam. = " ") then
+    do;
+      /* drop every illegal character */ 
+      &mcParam. = compress(scan(&mcParam,1,'()'),'_.','kad');
+      &mcParam. = cats(translate(&mcParam.," ","."));
+      if NOT (&mcParam.=" ") then 
+        do;
+          /* use 2 last blocks of symbols */
+          lib = coalescec(scan(&mcParam.,-2),"work");
+          ds  = scan(&mcParam.,-1);
+          /* check first symbol, in case leading digit add _ */
+          if ("0" <=: lib <=: "9")
+            then lib=cats("_",lib); 
+          if ("0" <=: ds  <=: "9")
+            then ds=cats("_",ds); 
+
+          &mcParam. = upcase(catx(".",lib,ds));
+        end;
+    end;
+/*=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=*/
+%end;
+%else
+  %do;
+    %put INFO: SAS Packages Framework internal macro.;
+    %put INFO: Executable only inside &allowedSPFmacrosList. macros.;
+  %end;
+%mend SPFinit_intrnl_forceV7DSname;
+
+/* end of SPFinit.sas file */ 

SPF/Macros/spfint_gnpckg_arch.sas

@@ -1,6 +1,6 @@
 /*+SPFint_gnPckg_arch+*/
 %macro SPFint_gnPckg_arch()/secure minoperator
-des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20251231.';
+des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260515.';
 /* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
 %if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
 %do;

SPF/Macros/spfint_gnpckg_markdown.sas

@@ -1,6 +1,6 @@
 /*+SPFint_gnPckg_markdown+*/
 %macro SPFint_gnPckg_markdown()/secure minoperator
-des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20251231.';
+des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260515.';
 /* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
 %if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
 %do;
@@ -112,7 +112,7 @@ data &filesWithCodes.markdown;
   %end;
 
   put " " / "---------------------------------------------------------------------" / " " 
-          / "*SAS package generated by SAS Package Framework, version `20251231`,*"
+          / "*SAS package generated by SAS Package Framework, version `20260515`,*"
           / "*under `&sysscp.`(`&sysscpl.`) operating system,*" 
           / "*using SAS release: `&sysvlong4.`.*" 
     / " " / "---------------------------------------------------------------------" / " ";

SPF/Macros/spfint_gnpckg_tests.sas

@@ -1,6 +1,6 @@
 /*+SPFint_gnPckg_tests+*/
 %macro SPFint_gnPckg_tests()/secure minoperator
-des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20251231.';
+des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260515.';
 /* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
 %if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
 %do;
@@ -73,6 +73,22 @@ run;
       put @n '%loadpackage'"(&packageName.,";
       put @n " path=&buildLocation., lazyData=*)" /;
 
+      /* meta */
+      put @n '%put >>>%'"&packageName."'META( )<<<;'/
+          @n '%put >>>%'"&packageName."'META(V)<<<;'/
+          @n '%put >>>%'"&packageName."'META(D)<<<;'/
+          @n '%put >>>%'"&packageName."'META(A)<<<;'/
+          @n '%put >>>%'"&packageName."'META(M)<<<;'/
+          @n '%put >>>%'"&packageName."'META(L)<<<;'/
+          @n '%put >>>%'"&packageName."'META(E)<<<;'/
+          @n '%put >>>%'"&packageName."'META(T)<<<;'/
+          @n '%put >>>%'"&packageName."'META(P)<<<;'/
+          @n '%put >>>%'"&packageName."'META(S)<<<;'/;
+
+      /* verify */
+      put @n '%verifyPackage'"(&packageName.,";
+      put @n " path=&buildLocation.)" /;
+
       /* help */
       put @n '%helpPackage'"(&packageName.,";
       put @n " path=&buildLocation.)" /;
@@ -292,6 +308,23 @@ data _null_;
   put '%loadpackage'"(&packageName.,"
     / " path=&buildLocation., lazyData=*)" /;
 
+  /* meta */
+  put '%put >>null        >%'"&packageName."'META( )<<<;'/
+      '%put >>unknown     >%'"&packageName."'META(U)<<<;'/ /* test for unknown values */
+      '%put >>version     >%'"&packageName."'META(V)<<<;'/
+      '%put >>datetime    >%'"&packageName."'META(D)<<<;'/
+      '%put >>authors     >%'"&packageName."'META(A)<<<;'/
+      '%put >>maintainers >%'"&packageName."'META(M)<<<;'/
+      '%put >>license     >%'"&packageName."'META(L)<<<;'/
+      '%put >>encoding    >%'"&packageName."'META(E)<<<;'/
+      '%put >>title       >%'"&packageName."'META(T)<<<;'/
+      '%put >>req packages>%'"&packageName."'META(P)<<<;'/
+      '%put >>req SAS     >%'"&packageName."'META(S)<<<;'/;
+
+  /* verify */
+  put '%verifyPackage'"(&packageName.,";
+  put " path=&buildLocation.)" /;
+
   /* help */
   put '%helpPackage'"(&packageName.,"
     / " path=&buildLocation.)" /;

SPF/Macros/splitcodeforpackage.sas

@@ -8,7 +8,7 @@
 ,nobs=0            /* technical parameter  */
 )
 /*** HELP END ***/
-/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20251231. Run %splitCodeForPackage() for help info.'
+/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260515. Run %splitCodeForPackage() for help info.'
 ;
 %if (%superq(codeFile) = ) OR (%qupcase(&codeFile.) = HELP) %then
   %do;
@@ -24,7 +24,7 @@
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
     %put # Utility macro to *split* single file with SAS package code into multiple      #;
-    %put # files with separate snippets, version `20251231`                              #;
+    %put # files with separate snippets, version `20260515`                              #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -400,7 +400,7 @@ options nomprint nosymbolgen nomlogic notes source ls=MAX ps=MAX msglevel=N ;
             */
             if firstLine[j] then
               do;
-                put '/* File generated with help of SAS Packages Framework, version 20251231. */';
+                put '/* File generated with help of SAS Packages Framework, version 20260515. */';
                 firstLine[j]=0;
               end; 
             put _infile_;

SPF/Macros/unbundlePackages.sas

@@ -6,9 +6,11 @@
 ,packagesPath=
 ,packagesRef=packages
 ,ods= /* data set for report file */
+,reportOnly=0
 ,verify=0
+,quiet=0
 )/
-des='Macro to extract a bundle of SAS packages, version 20251231. Run %unbundlePackages(HELP) for help info.'
+des='Macro to extract a bundle of SAS packages, version 20260515. Run %unbundlePackages(HELP) for help info.'
 secure
 minoperator
 ;
@@ -26,7 +28,7 @@ minoperator
     %put ###     This is short help information for the `unbundlePackages` macro         #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to *extract* SAS packages from a bundle, version `20251231`             #;
+    %put # Macro to *extract* SAS packages from a bundle, version `20260515`             #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -58,11 +60,20 @@ minoperator
     %put # - `packagesRef=`      *Optional.* Fileref to location where packages will     #;
     %put #                       be extracted. Default value is `packages`.              #;
     %put #                                                                               #;
-    %put # - `ods=`              *Optional.* Name of SAS data set for the report.        #;
+    %put # - `ods=`              *Optional.* V7 style name of SAS data set for report.   #;
     %put #                                                                               #;
     %put # - `verify=`           *Optional.* Indicates if verification code should       #;
     %put #                       be executed after bundle extraction.                    #;
-    %put #                       Value `1` means yes, Value `0` means no.                #;
+    %put #                       Value `1` means yes, Value `0` (default) means no.      #;
+    %put #                                                                               #;
+    %put # - `reportOnly=`       *Optional.* Indicates if packages unbundling should     #;
+    %put #                       be suspended and only a report with bundle content      #;
+    %put #                       be produced and printed.                                #;
+    %put #                       Value `1` means yes, Value `0` (default) means no.      #;
+    %put #                                                                               #;
+    %put # - `quiet=`           *Optional.* Indicates if printout of the summary         #;
+    %put #                       report should be suspended.                             #;
+    %put #                       Value `1` means yes, Value `0` (default) means no.      #;
     %put #                                                                               #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
@@ -110,6 +121,11 @@ minoperator
 /*===================================================================================================*/
 
 %if NOT(%superq(verify) in (0 1)) %then %let verify=0;
+%if NOT(%superq(quiet) in (0 1))  %then %let quiet=0;
+
+%if NOT(%superq(reportOnly) in (0 1)) %then %let reportOnly=0;
+/* no verification when reporting */
+%if 1=&reportOnly. %then %let verify=0;
 
 %local HASHING_FILE_exist;
 %let HASHING_FILE_exist = 0;
@@ -128,11 +144,17 @@ minoperator
 %let datetime = %sysfunc(datetime());
 %let reportFile = WORK.tmpbundlefile%sysfunc(int(&datetime.), b8601dt15.)_;
 
-data _null_ ;
+%if NOT %sysevalf(%superq(ods)=,BOOLEAN) %then %do;
+  data _null_; /* verify ods= value */
+    %SPFinit_intrnl_forceV7DSname(ods);
+    call symputX("ods",ods,"L");
+  run;
+%end;
+
+data _null_;
 datetime=symgetn('datetime');
 
 length packagesList $ 32767 bundleName $ 128;
-
 bundleName = compress(symget('bundleName'),"_.","KAD"); /* bundle name is letters, digits, and underscore, up to 128 symbols */
 
 if bundleName NE symget('bundleName') then /* warn about illegal characters */
@@ -140,12 +162,12 @@ if bundleName NE symget('bundleName') then /* warn about illegal characters */
     put "ERROR: Bundle name contains illegal characters. Exiting";
     stop; 
   end;
-
 bundleName=lowcase(bundleName); 
+lbn = length(bundleName); /* to cover lengths < 7 & 11 */
 /* if there is ".bundle.zip" extension added, remove it */
-if substr(strip(reverse(bundleName)),1,11) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
+if substr(strip(reverse(bundleName)),1,min(11,lbn)) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
 else /* if there is ".bundle" extension added, remove it */
-if substr(strip(reverse(bundleName)),1,7)  = 'eldnub.'     then bundleName=scan(bundleName,-2,".");
+if substr(strip(reverse(bundleName)),1,min(7,lbn))  = 'eldnub.'     then bundleName=scan(bundleName,-2,".");
 
 put / "INFO: Bundle name is: " bundleName / ;
 
@@ -153,43 +175,47 @@ length packagesPath $ 32767 packagesRef $ 8;
 packagesPath = dequote(symget('packagesPath'));
 packagesRef = upcase(strip(symget('packagesRef')));
 
+if 0 then set SASHELP.VEXTFL(keep=level xpath xengine fileref exists);
 
-/* organize target path (location for packages) */
-if " "=packagesPath then
-  do;
-    if 0 then set SASHELP.VEXTFL(keep=level xpath xengine fileref exists);
-    DECLARE HASH sH(dataset:'SASHELP.VEXTFL(where=(fileref=' !! quote(packagesRef) !! '))', ordered: "A");
-    sH.DefineKey("level");
-    sH.DefineData("xpath","xengine","exists");
-    sH.DefineDone();
-
-    if sH.NUM_ITEMS=0 then
+/* ignore target check when only report is requested */
+%if 0=&reportOnly. %then
+  %do;
+    /* organize target path (location for packages) */
+    if " "=packagesPath then
       do;
-        put "ERROR: Fileref in packagesRef= does NOT exist. Exiting!";
-        stop;
+        DECLARE HASH sH(dataset:'SASHELP.VEXTFL(where=(fileref=' !! quote(packagesRef) !! '))', ordered: "A");
+        sH.DefineKey("level");
+        sH.DefineData("xpath","xengine","exists");
+        sH.DefineDone();
+
+        if sH.NUM_ITEMS=0 then
+          do;
+            put "ERROR: Fileref in packagesRef= does NOT exist. Exiting!";
+            stop;
+          end;
+
+        packagesPath=" ";
+
+        rc = sH.FIND(key:NOT(1=sH.NUM_ITEMS)); /* if only 1 element select level 0, if more than 1 select level 1 */
+        if xengine = "DISK" AND exists='yes' then
+          packagesPath=quote(strip(xpath)); /* add quotes to the packagesPath */
+        else
+          do;
+            put "ERROR: Path: " xpath "in packagesRef= is invalid! Exiting!";
+            stop; 
+          end;
       end;
-
-    packagesPath=" ";
-
-    rc = sH.FIND(key:NOT(1=sH.NUM_ITEMS)); /* if only 1 element select level 0, if more than 1 select level 1 */
-    if xengine = "DISK" AND exists='yes' then
-      packagesPath=quote(strip(xpath)); /* add quotes to the packagesPath */
     else
       do;
-        put "ERROR: Path: " xpath "in packagesRef= is invalid! Exiting!";
-        stop; 
+        rcPckPath = fileexist(strip(packagesPath));
+        if 0=rcPckPath then
+          do;
+            put "ERROR: Path in packagesPath= does NOT exist. Exiting!";
+            stop;
+          end;
+        else packagesPath=quote(strip(packagesPath)); /* add quotes to the packagesPath */
       end;
-  end;
-else
-  do;
-    rcPckPath = fileexist(strip(packagesPath));
-    if 0=rcPckPath then
-      do;
-        put "ERROR: Path in packagesPath= does NOT exist. Exiting!";
-        stop;
-      end;
-    else packagesPath=quote(strip(packagesPath)); /* add quotes to the packagesPath */
-  end;
+  %end;
 
 length path $ 32767 pathRef $ 8;
 path = dequote(symget('path'));
@@ -272,7 +298,7 @@ DECLARE HITER IQ("Q");
 
 /*--------------------------------------------------*/
 do until(EOF);
-  input package :$32. pckVer :$16. pckDtm :$16. hash :$128.;
+  input package :$32. pckVer :$16. pckDtm :$24. hash :$128.;
   if " " NE package then rc = Q.ADD();
 end;
 label package="Package name" 
@@ -281,7 +307,6 @@ label package="Package name"
       hash="SHA256 for the Package"; 
 /*--------------------------------------------------*/
 
-
 if 0=Q.NUM_ITEMS then /* ... if empty then exit */
   do;
     put "WARNING: No packages to unbundle. Exiting!";
@@ -292,22 +317,31 @@ else
     packagesList = catx(" ", packagesList, package);
   end;
 
-rc = Q.output(dataset:"&reportFile.1");
+
+rc = Q.output(dataset: /* create propper tag */
+  %if %superq(ods) NE %then %do; "&ods.(label='Bundle: " !! strip(bundleName) !! "')" %end; 
+                      %else %do; "&reportFile.1" %end;
+);
+
 
 /* code executed for unbundling */
 length code1 code2 $ 32767;
-code1= 
-'options ps=min nofullstimer nostimer msglevel=N; filename PACKAGES ' !! strip(packagesPath) !! ';' !!
-'%relocatePackage(' !! strip(packagesList) !! ',source=' !! catx("/", path, bundleName) !! 
-'.bundle.zip, sDevice=ZIP,psMAX=MIN)'; 
+%if 0=&reportOnly. %then
+  %do;
+    code1= 
+    'options ps=min nofullstimer nostimer msglevel=N; filename PACKAGES ' !! strip(packagesPath) !! ';' !!
+    '%relocatePackage(' !! strip(packagesList) !! ',source=' !! catx("/", path, bundleName) !! 
+    '.bundle.zip, sDevice=ZIP,psMAX=MIN)'; 
 
-/*put code=;*/
+    /*put code=;*/
 
-put / "INFO: The " bundleName "bundle extraction in progress...";
+    put / "INFO: The " bundleName "bundle extraction in progress...";
 
-rc = doSubL(code1);
+    rc = doSubL(code1);
+
+    put / "INFO: The " bundleName "bundle extraction ended.";
+  %end;
 
-put / "INFO: The " bundleName "bundle extraction ended.";
 
 /* code executed for verification */
 %if 1=&verify. %then
@@ -320,21 +354,22 @@ put / "INFO: The " bundleName "bundle extraction ended.";
     rc = doSubL(code2);
     put / "INFO: The " bundleName "bundle verification ended.";
   %end;
-
 put " ";
 rc=sleep(1,1); 
 
-rc = doSubL("title 'Summary of the extracted bundle file';" !! 
-"proc print data=" !! 
+rc = doSubL(
+%if 0=&quiet. %then /* do not print report */
+  %do;
+    "title 'Summary of the bundle file: " !! strip(bundleName) !! "';" !! 
+    "proc print label data=" !! 
+    %if %superq(ods) NE %then %do; "&ods." %end; 
+                        %else %do; "&reportFile.1" %end; !! 
+    "; var package pckVer pckDtm hash; run;" !!
+  %end;
 %if %superq(ods) NE %then 
-  %do; "%scan(&ods.,1,())" %end; 
+  %do; %put INFO: Report file: &ods.; %end; 
 %else 
-  %do; "&reportFile.1" %end; !! 
-" label; var package pckVer pckDtm hash; run;" !!
-%if %superq(ods) NE %then 
-  %do; %put INFO: Report file: %scan(&ods.,1,()); %end; 
-%else 
-  %do; "proc delete data=&reportFile.1; run;" %end; !! 
+  %do; "proc delete data=&reportFile.1; run;" !! %end;
 "title;");
 
 stop;
@@ -363,6 +398,7 @@ options mprint;
 ,path=R:\
 ,packagesPath=R:\check2
 ,verify=1
+,ods=WORK.bundlenametest124_reportDS
 )
 
 %unbundlePackages(
@@ -385,7 +421,42 @@ options mprint;
 ,packagesPath=R:\check
 ,verify=1
 )
+*/
+
+/* reportOnly & quiet 
+
+%bundlePackages(myLittleBundle
+              ,path=R:\
+              ,packagesList=basePlus SQLinDS macroarray
+              ,packagesRef=PACKAGES)
+
+option dlcreatedir;
+libname _ "R:\check5";
+
+%unbundlePackages(myLittleBundle         
+                 ,path=R:\
+                 ,reportOnly=1                 
+                 ,ods=work.bundleReport1) 
+
+%unbundlePackages(myLittleBundle         
+                 ,path=R:\
+                 ,reportOnly=1                 
+                 ,ods=work.bundleReport2
+                 ,quiet=1) 
+
+%unbundlePackages(myLittleBundle         
+                 ,path=R:\
+                 ,packagesPath=R:\check5
+                 ,ods=work.bundleReport3
+                 ,quiet=1, verify=1) 
+
+%unbundlePackages(myLittleBundle         
+                 ,path=R:\
+                 ,packagesPath=R:\check5
+                 ,ods=work.bundleReport4
+                 ,quiet=0, verify=1) 
+
 
 */
 
-/* end of SPFinit.sas file */ 
+

SPF/Macros/unloadpackage.sas

@@ -20,7 +20,7 @@
                                        */
 )/secure
 /*** HELP END ***/
-des = 'Macro to unload SAS package, version 20251231. Run %unloadPackage() for help info.'
+des = 'Macro to unload SAS package, version 20260515. Run %unloadPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
   %do;
@@ -35,7 +35,7 @@ des = 'Macro to unload SAS package, version 20251231. Run %unloadPackage() for h
     %put ###      This is short help information for the `unloadPackage` macro           #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to unload SAS packages, version `20251231`                              #;
+    %put # Macro to unload SAS packages, version `20260515`                              #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -115,18 +115,20 @@ des = 'Macro to unload SAS package, version 20251231. Run %unloadPackage() for h
 
   %local _PackageFileref_;
   data _null_; 
-    call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+    length packageName $ 32;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
+      exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");

SPF/Macros/verifypackage.sas

@@ -8,12 +8,12 @@
 , path = %sysfunc(pathname(packages)) /* location of a package, 
                                          by default it looks for 
                                          location of "packages" fileref */
-, hash =                              /* The SHA256 hash digest for 
+, hash = F*                           /* The SHA256 hash digest for 
                                          the package generated by 
                                          hashing_file() function, SAS 9.4M6 */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %verifyPackage() for help info.'
+des = 'Macro to verify SAS package with the hash digest, version 20260515. Run %verifyPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
   %do;
@@ -28,7 +28,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %
     %put ###      This is short help information for the `verifyPackage` macro           #;
     %put #-------------------------------------------------------------------------------#;
     %put #                                                                               #;
-    %put # Macro to verify SAS package with it hash digest, version `20251231`           #;
+    %put # Macro to verify SAS package with it hash digest, version `20260515`           #;
     %put #                                                                               #;
     %put # A SAS package is a zip file containing a group                                #;
     %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -48,7 +48,9 @@ des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %
     %put #                       If empty displays this help information.                #;
     %put #                                                                               #;
     %put # - `hash=`             A value of the package `SHA256` hash.                   #;
-    %put #                       Provided by the user.                                   #;
+    %put #                       Provided by the user. When the value is not provided    #;
+    %put #                       then macro calculates `SHA256`, `SHA1`, and `MD5`       #;
+    %put #                       digests and display then in the log.                    #;
     %put #                                                                               #;
     %put # - `path=`             Location of a package. By default it looks for          #;
     %put #                       location of the "packages" fileref, i.e.                #;
@@ -76,7 +78,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %
     %put  ;
     %put  %nrstr( %%installPackage(SQLinDS)  %%* install the package from the Internet;           );
     %put  %nrstr( %%verifyPackage%(SQLinDS,   %%* verify the package with provided hash;          );
-    %put  %nrstr(               hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%)        );
+    %put  %nrstr(                hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%)       );
     %put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
     %put #################################################################################;
     %put ;
@@ -97,19 +99,21 @@ des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %
   options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
   
   %local _PackageFileref_ checkExist;
-  data _null_; 
-    call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L"); 
-  run;
+  data _null_;
+    length packageName $ 140;
+    packageName = lowcase(symget("packageName")); 
+    call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L"); 
+  /*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
 
   /* when the packages reference is multi-directory search for the first one containing the package */
-  data _null_;
+  /*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
     exists = 0;
     length packages $ 32767 p $ 4096;
     packages = resolve(symget("path"));
     if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
     do i = 1 to kcountw(packages, "()", "QS");
       p = dequote(kscanx(packages, i, "()", "QS"));
-      exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".zip")); /* check on zip files only! */
+      exists + fileexist(catx("/", p, cats(packageName,".zip"))); /* check on zip files only! */
       if exists then leave;
     end;
     if exists then call symputx("path", p, "L");
@@ -142,31 +146,60 @@ des = 'Macro to verify SAS package with the hash digest, version 20251231. Run %
           filename &_PackageFileref_. list;
           
           data _null_;
-            length providedHash $ 128;
+            length providedHash $ 128 packageName $ 140;
             providedHash = strip(symget("hash"));
-            select;
-              when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */                
-                SHA256 = 'F*' !! HASHING_FILE("SHA256", pathname("&_PackageFileref_.",'F'), 0);
-              when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */                
-                SHA256 = 'C*' !! HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
-              otherwise /* legacy approach, without C or F, digest value equivalent to C */
-                SHA256 = HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
-            end;
-            put "Provided Hash: " providedHash;
-            put "SHA256 digest: " SHA256;
-            put " ";
-            
-            if upcase(SHA256) = upcase(providedHash) then
-              do;
-                put "NOTE: Package verification SUCCESSFUL."; 
-                put "NOTE- Generated hash is EQUAL to the provided one."; 
+            packageName = strip(symget("packageName"));
+
+            emptyHash = (providedHash = " " OR providedHash in ("F*" "f*" "C*" "c*"));
+
+            put 82*"-" / @2 packageName / 82*"-" /;
+
+            if NOT emptyHash then put "Provided Hash: " providedHash;
+
+            length method $ 8 digest $ 128;
+            /* calculate SHA256 */
+            method="SHA256";
+            LINK CalcualteHashDigest; /* go to Link 1 */
+
+            if NOT emptyHash then 
+              do; /* step for veryfication */
+                if upcase(digest) = upcase(providedHash) then
+                  do;
+                    put "NOTE: Verification SUCCESSFUL."
+                      / "NOTE- Generated hash is EQUAL to the provided one." / ; 
+                  end;
+                else
+                  do; 
+                    pos = 0;
+                    do i = 1 to max(lengthn(digest),lengthn(providedHash)) while(pos=0);
+                      if char(digest,i) NE char(providedHash,i) then pos = i;
+                    end;
+                    put "ERROR- " @(pos+15)"^"/"ERROR- " @(pos+15)"| diff @" pos/"ERROR- ";
+                    put "ERROR: Verification FAILED!!" 
+                      / "ERROR- Generated hash is DIFFERENT than the provided one." 
+                      / "ERROR- Check if the ZIP is genuine." / ; 
+                  end;
               end;
             else
-              do;
-                put "ERROR: Package verification FAILED!!"; 
-                put "ERROR- Generated hash is DIFFERENT than the provided one."; 
-                put "ERROR- Confirm if the package is genuine."; 
+              do method = "SHA1", "MD5"; /* step for digest display, calcualte also SHA1 and MD5 */
+                  LINK CalcualteHashDigest; /* go to Link 1 */
               end;
+            put 82*"-" /;
+            stop;
+            return;
+            CalcualteHashDigest: /* Link 1 */
+
+            select;
+              when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */                
+              digest = 'F*' !! HASHING_FILE(method, pathname("&_PackageFileref_.",'F'), 0);
+              when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */                
+                digest = 'C*' !! HASHING_FILE(method, "&_PackageFileref_.", 4);
+              otherwise /* legacy approach, without C or F, digest value equivalent to C */
+                digest = HASHING_FILE(method, "&_PackageFileref_.", 4);
+            end;
+            put method "digest: " digest /;
+
+            return;
           run;
           %let HASHING_FILE_exist = 0;
         %end;

SPF/SPFinit.md

@@ -1,7 +1,7 @@
 
 ---
 
-# SAS Packages Framework, version `20251231`
+# SAS Packages Framework, version `20260515`
 
 ---
 
@@ -34,7 +34,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 the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20251231`**.
+In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20260515`**.
 
 **To get started with SAS Packages** try this [**`Introduction to SAS Packages`**](https://youtube.com/playlist?list=PLeMzGEImIT5eV13IGXQIgWmTFCJt_cLZG&si=ElQm0_ifq76mvUbq "Introduction to SAS Packages video series") video series or [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
 
@@ -57,7 +57,7 @@ them using the SPF can be found [**HERE**](https://github.com/yabwon/HoW-SASPack
 ##       This is short help information for the `installPackage` macro <a name="installpackage"></a>
 --------------------------------------------------------------------------------------------
 
- Macro to install SAS packages, version `20251231`
+ Macro to install SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -105,8 +105,15 @@ them using the SPF can be found [**HERE**](https://github.com/yabwon/HoW-SASPack
                    When there are multiple packages to install version variable
                    is scan sequentially.
 
- - `replace=`      With default value of `1` it causes existing package file
-                   to be replaced by new downloaded file.
+ - `replace=`      When set to `1` and a package file exists, it forces the package
+                   file replacement by the new downloaded file.
+                   It is a binary indicator ('0' or '1'). Default value is `1`.
+
+ - `backup=`       When set to `1` and a package file exists, it creates a backup copy
+                   of the package file. The backup copy is created with a suffix of the
+                   following format: `_BCKP_yyyymmddJJMMSS`.
+                   If `replace=0` then `backup` is set to `0`.
+                   It is a binary indicator ('0' or '1'). Default value is `0`.
 
  - `URLuser=`      A user name for the password protected URLs, no quotes needed.
 
@@ -137,6 +144,24 @@ them using the SPF can be found [**HERE**](https://github.com/yabwon/HoW-SASPack
                    `https://github.com/<github>/<packagename>/raw/.../`
                   All characters except `[A-z0-9_.-]` are compressed.
 
+  - `githubRepo=`  *Optional.* A name of a repository in GitHub.
+                   Allows an easy set of the search path for packages available on GitHub:
+                    `https://github.com/<github>/<githubRepo>/raw/.../`
+                   By default lowercase name of installed package is used.
+
+  - `githubToken=` *Optional.* A fine-grained personal access token for GitHub.
+                   When the value is non-missing it triggers GitHub API access to
+                   private repositories. Of course the token used has to be configured
+                   properly for the access.
+                   Read GitHub documentation to learn how to create and setup your token:
+                   `https://docs.github.com/en/authentication/`
+                    `keeping-your-account-and-data-secure/`
+                     `managing-your-personal-access-tokens`
+                      `#creating-a-fine-grained-personal-access-token`
+                   (lines break added for easier reading)
+                   Public repos do not need authentication.
+                   [NOTE!] This feature is experimental in this release.
+
 --------------------------------------------------------------------------------------------
 
  Visit: `https://github.com/yabwon/SAS_PACKAGES/tree/main/SPF/Documentation` to learn more.
@@ -185,7 +210,7 @@ filename packages "C:/SAS_PACKAGES";
 ##       This is short help information for the `helpPackage` macro <a name="helppackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to get help about SAS packages, version `20251231`
+ Macro to get help about SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -263,7 +288,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `loadPackage` macro <a name="loadpackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to *load* SAS packages, version `20251231`
+ Macro to *load* SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -421,7 +446,7 @@ If created, those macros are automatically deleted when the `%unloadPackage()` m
 ##      This is short help information for the `loadPackageS` macro <a name="loadpackages"></a>
 -------------------------------------------------------------------------------
 
- Macro wrapper for the loadPackage macro, version `20251231`
+ Macro wrapper for the loadPackage macro, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -472,7 +497,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `unloadPackage` macro <a name="unloadpackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to unload SAS packages, version `20251231`
+ Macro to unload SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -539,7 +564,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##       This is short help information for the `listPackages` macro <a name="listpackages"></a>
 -----------------------------------------------------------------------------------------
 
- Macro to list available SAS packages, version `20251231`
+ Macro to list available SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -550,7 +575,11 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 
 ### Parameters:
 
- NO PARAMETERS
+ 1. `listDataSet`  Name of a SAS data set to store results in.
+                   No data set options are honored.
+
+ - `quiet=`      *Optional.* Indicates if the LOG printout should be suspended.
+                 Default value of zero (`0`) means "Do printout", other means "No".
 
  When used as: `%listPackages(HELP)` it displays this help information.
 
@@ -576,13 +605,15 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 %include packages(SPFinit.sas);      %* enable the framework;
 
 %listPackages()                      %* list available packages;
+
+%listPackages(ListDS,quiet=1)        %* save packages list in ListDS data set;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 ##      This is short help information for the `verifyPackage` macro <a name="verifypackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to verify SAS package with it hash digest, version `20251231`
+ Macro to verify SAS package with it hash digest, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -603,7 +634,9 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
                        If empty displays this help information.
 
  - `hash=`             A value of the package `SHA256` hash.
-                       Provided by the user.
+                       Provided by the user. When the value is not provided
+                       then macro calculates `SHA256`, `SHA1`, and `MD5`
+                       digests and display then in the log.
 
  - `path=`             Location of a package. By default it looks for
                        location of the "packages" fileref, i.e.
@@ -630,13 +663,13 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
 
 %installPackage(SQLinDS)  %* install the package from the Internet;
 %verifyPackage(SQLinDS,   %* verify the package with provided hash;
-              hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4)
+               hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ##    This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to get preview of a SAS packages, version `20251231`
+ Macro to get preview of a SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -705,7 +738,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `generatePackage` macro <a name="generatepackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to generate SAS packages, version `20251231`
+ Macro to generate SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -938,7 +971,7 @@ All files have to have `.sas` extension. Other files are ignored.
 ##      This is short help information for the `extendPackagesFileref` macro <a name="extendpackagesfileref"></a>
 -----------------------------------------------------------------------------------------
 
- Macro to list directories pointed by 'packages' fileref, version `20251231`
+ Macro to list directories pointed by 'packages' fileref, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -980,7 +1013,7 @@ filename packages ("D:/NEW_DIR" %extendPackagesFileref()); %* add new directory;
 ##      This is short help information for the `loadPackageAddCnt` macro <a name="loadpackageaddcnt"></a>
 -------------------------------------------------------------------------------
 
- Macro to load *additional content* for a SAS package, version `20251231`
+ Macro to load *additional content* for a SAS package, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1074,7 +1107,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 -------------------------------------------------------------------------------
 
  Utility macro to *split* single file with SAS package code into multiple
- files with separate snippets, version `20251231`
+ files with separate snippets, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1155,7 +1188,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `relocatePackage` macro <a name="relocatepackage"></a>
 -------------------------------------------------------------------------------
 
- Macro to *locally copy or move* (relocate) SAS packages, version `20251231`
+ Macro to *locally copy or move* (relocate) SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1267,7 +1300,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##       This is short help information for the `isPackagesFilerefOK` macro <a name="ispackagesfilerefok"></a>
 -----------------------------------------------------------------------------------------
 
- Macro to check if the `packages` fileref is "correct", version `20251231`
+ Macro to check if the `packages` fileref is "correct", version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1318,7 +1351,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##   This is short help information for the `SasPackagesFrameworkNotes` macro <a name="saspackagesframeworknotes"></a>
 -------------------------------------------------------------------------------
 
- Macro prints help notes for SAS Packages Framework macros, version `20251231`
+ Macro prints help notes for SAS Packages Framework macros, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1368,7 +1401,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `bundlePackages` macro <a name="bundlepackages"></a>
 -------------------------------------------------------------------------------
 
- Macro to *create bundles* of SAS packages, version `20251231`
+ Macro to *create bundles* of SAS packages, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1405,7 +1438,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
  - `packagesRef=`      *Optional.* Fileref to location of packages for the
                        bundle. Default value is `packages`.
 
- - `ods=`              *Optional.* Name of SAS data set for the report.
+ - `ods=`              *Optional.* V7 style name of SAS data set for report.
 
 -------------------------------------------------------------------------------
 
@@ -1437,7 +1470,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##     This is short help information for the `unbundlePackages` macro <a name="unbundlepackages"></a>
 -------------------------------------------------------------------------------
 
- Macro to *extract* SAS packages from a bundle, version `20251231`
+ Macro to *extract* SAS packages from a bundle, version `20260515`
 
  A SAS package is a zip file containing a group
  of SAS codes (macros, functions, data steps generating
@@ -1469,11 +1502,20 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
  - `packagesRef=`      *Optional.* Fileref to location where packages will
                        be extracted. Default value is `packages`.
 
- - `ods=`              *Optional.* Name of SAS data set for the report.
+ - `ods=`              *Optional.* V7 style name of SAS data set for report.
 
  - `verify=`           *Optional.* Indicates if verification code should
                        be executed after bundle extraction.
-                       Value `1` means yes, Value `0` means no.
+                       Value `1` means yes, Value `0` (default) means no.
+
+ - `reportOnly=`       *Optional.* Indicates if packages unbundling should
+                       be suspended and only a report with bundle content
+                       be produced and printed.
+                       Value `1` means yes, Value `0` (default) means no.
+
+ - `quiet=`           *Optional.* Indicates if printout of the summary report
+                       should be suspended.
+                       Value `1` means yes, Value `0` (default) means no.
 
 -------------------------------------------------------------------------------
 

packages/README.md

@@ -10,7 +10,7 @@ Packages:
 
 ---
 
-- **SQLinDS**\[2.3.1\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
+- **SQLinDS**\[2.4.0\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
 ```sas
 data class;
   set %SQL(
@@ -22,13 +22,13 @@ data class;
     WH = weight + height;
 run;
 ```
-SHA256 digest for SQLinDS: F*606A24A2A6B06DAAD2D443FA9A9819D9564235A5CD8599FD15586F1EFFCB41BC
+SHA256 digest for SQLinDS: F*A3DC9400DEF1403DC9E191611790244A8B0FB23303D3A98D29777E46A1D4E8B4
 
-[Documentation for SQLinDS](https://github.com/SASPAC/blob/main/sqlinds.md "Documentation for SQLinDS")
+[Documentation for SQLinDS](https://github.com/SASPAC/sqlinds/blob/main/sqlinds.md "Documentation for SQLinDS")
 
 ---
 
-- **DFA** (Dynamic Function Arrays)\[0.5.7\], 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.
+- **DFA** (Dynamic Function Arrays)\[0.5.10\], 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.
 ```sas
 %createDFArray(ArrDynamic, resizefactor=17); 
 
@@ -55,13 +55,13 @@ data _null_;
   end;
 run;
 ```
-SHA256 digest for DFA: F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045BEB958168
+SHA256 digest for DFA: F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9
 
-[Documentation for DFA](https://github.com/SASPAC/blob/main/dfa.md "Documentation for DFA")
+[Documentation for DFA](https://github.com/SASPAC/dfa/blob/main/dfa.md "Documentation for DFA")
 
 ---
 
-- **macroArray**\[1.3.0\], implementation of an array concept in a macro language, e.g. 
+- **macroArray**\[1.3.2\], implementation of an array concept in a macro language, e.g. 
 ```sas
   %array(ABC[17] (111:127), macarray=Y); 
   
@@ -80,13 +80,13 @@ SHA256 digest for DFA: F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045
       which = 1:H:2
   );
 ```
-SHA256 digest for macroArray: F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24
+SHA256 digest for macroArray: F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9
 
-[Documentation for macroArray](https://github.com/SASPAC/blob/main/macroarray.md "Documentation for macroArray")
+[Documentation for macroArray](https://github.com/SASPAC/macroarray/blob/main/macroarray.md "Documentation for macroArray")
 
 ---
 
-- **BasePlus**\[3.1.1\] adds a bunch of functionalities I am missing in BASE SAS, such as: 
+- **BasePlus**\[3.2.0\] adds a bunch of functionalities I am missing in BASE SAS, such as: 
 ```sas
 call arrMissToRight(myArray); 
 call arrFillMiss(17, myArray); 
@@ -120,13 +120,13 @@ format x bool.;
 
 %workLib(ABC)
 ```
-SHA256 digest for BasePlus: F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F4A561BDDF274A6
+SHA256 digest for BasePlus: F*F85189F1AF33755A7C9F05673A8094AE3245A21C8B602E02C20170A4DCF73890
 
-[Documentation for BasePlus](https://github.com/SASPAC/blob/main/baseplus.md "Documentation for BasePlus")
+[Documentation for BasePlus](https://github.com/SASPAC/baseplus/blob/main/baseplus.md "Documentation for BasePlus")
 
 ---
 
-- **GSM** (Generate Secure Macros)\[0.22.1\], package allows
+- **GSM** (Generate Secure Macros)\[0.22.3\], package allows
  to create secured macros stored in SAS Proc FCMP functions.
  The dataset with functions can be shared between different operating systems
  and allows to generate macros on site without showing their code.
@@ -135,9 +135,9 @@ SHA256 digest for BasePlus: F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F
 
 [The WUSS 2023 Conference article describing the idea](https://www.wuss.org/proceedings/2023/WUSS-2023-Paper-189.pdf "Article about the idea GSM")
 
-SHA256 digest for GSM: F*80197391195C3EC41BD436DF0C8802D3920E4D22B64009A7DE872FBDF8D4B86E
+SHA256 digest for GSM: F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1
 
-[Documentation for GSM](https://github.com/SASPAC/blob/main/gsm.md "Documentation for GSM")
+[Documentation for GSM](https://github.com/SASPAC/gsm/blob/main/gsm.md "Documentation for GSM")
 
 ---
 

packages/SHA256_for_packages.txt

@@ -1,3 +1,30 @@
+/* 20260528 */
+BasePlus: F*F85189F1AF33755A7C9F05673A8094AE3245A21C8B602E02C20170A4DCF73890
+
+/* 20260512 */
+BasePlus: F*2308959251D1BF9259B693EB8C60D30D24D5D7E06AED05A03639A7C7E458658F
+
+/* 20260511 */
+SQLinDS: F*A3DC9400DEF1403DC9E191611790244A8B0FB23303D3A98D29777E46A1D4E8B4
+
+/* 20260217 */
+BasePlus: F*BD248E5F8CBD94B5F45467B723A73D97D646CD665BA98679F87C7A03A484E83E
+DFA: F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9
+GSM: F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1
+macroArray: F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9
+SQLinDS: F*6CC51325BDCE164B2E811896DD1C3A6D44242F50CC313D0721350CA49975F628
+
+/* 20260202 */
+BasePlus: F*B762F900EEFF7035880891D89416C0F973E4D377BCB75486283363A9BDADBA82
+DFA: F*17C88537F5FA9BCFAA1AC4803D0F1EF47665C8446A44C82B5558A08315DF0C49
+
+/* 20260126 */
+BasePlus: F*91A5AD4709A418704315EF37DDCF954522D4FB42808D406B3ED4DA560F6864C6
+DFA: F*643FBE2B7AE1425FC0240139813B93AE2C6BCFFDF6A0CFAEBEC11F83D3548E57
+GSM: F*7A4FEC410DEB921613A33F154FBBE332D7EC4C4DAC1351A4E611D986489EE848
+macroArray: F*9DA64CA9A745E1DB7176F7AF4459BB014F61F71626473ABF6471A32689E14FF1
+SQLinDS: F*CEAA4C90515F6E8AACBFFD55ABA6544E399EDBE0A7081107B62DCEE6F5430A1D
+
 /* 20260113 */
 macroArray: F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24
 

packages/baseplus.md

@@ -9,23 +9,21 @@
 ### Version information:
   
 - Package: BasePlus
-- Version: 3.1.1
-- Generated: 2025-11-05T15:10:31
+- Version: 3.2.0
+- Generated: 2026-05-28T12:00:14
 - Author(s): Bartosz Jablonski (yabwon@gmail.com), contributors are Quentin McMullen (qmcmullen@gmail.com) and Ryo Nakaya (nakaya.ryou@gmail.com)
 - Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
 - License: MIT
-- File SHA256: `F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F4A561BDDF274A6` for this version
-- Content SHA256: `C*3CA28DF8F3E6D6670D7FD44788D347452F24F4BCF18115873E7EBC742FE30CA4` for this version
+- File SHA256: `F*F85189F1AF33755A7C9F05673A8094AE3245A21C8B602E02C20170A4DCF73890` for this version
+- Content SHA256: `C*2216D9556FF51EDABAACBBFED7D30D5B46519083F7217A647A505C2F9FAB3634` for this version
   
 ---
  
-# The `BasePlus` package, version: `3.1.1`;
+# The `BasePlus` package, version: `3.2.0`;
   
 ---
  
 
-# The BasePlus package [ver. 3.1.1] <a name="baseplus-package"></a> ###############################################
-
 The **BasePlus** package implements useful
 functions and functionalities I miss in the BASE SAS.
 
@@ -407,11 +405,13 @@ Package contains additional content, run:  `%loadPackageAddCnt(BasePlus)`  to lo
 or look for the `baseplus_AdditionalContent` directory in the `packages` fileref
 localization (only if additional content was deployed during the installation process).
  
---------------------------------------------------------------------
+---------------------------------------------------------------------
  
-*SAS package generated by SAS Package Framework, version `20251017`*
+*SAS package generated by SAS Package Framework, version `20260515`,*
+*under `WIN`(`X64_10PRO`) operating system,*
+*using SAS release: `9.04.01M9P06052025`.*
  
---------------------------------------------------------------------
+---------------------------------------------------------------------
  
 # The `BasePlus` package content
 The `BasePlus` package consists of the following content:
@@ -878,8 +878,11 @@ The basic syntax is the following, the `<...>` means optional parameters:
 
 * `backslashSens=0`           - *Optional*, if not zero then it indicates 
                                 that backslash(`\`) symbol in files and dirs 
-                                names is detectable under Linux. Accepted 
-                                values: `0` and `1`. Ignored under Windows. 
+                                names is detectable under Linux. Additionally, 
+                                for a square-bracket (`[` or `]`), it turns 
+                                off their special meaning under Linux. 
+                                Accepted values: `0` and `1`. 
+                                Ignored under Windows. 
 
 
 ### EXAMPLES AND USECASES: ####################################################
@@ -7738,7 +7741,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
  
 # License <a name="license"></a> ######
  
-Copyright (c) 2020 - 2025 Bartosz Jablonski
+Copyright (c) 2020 - 2026 Bartosz Jablonski
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

packages/dfa.md

@@ -1,24 +1,28 @@
-- [The DFA package](#dfa-package)
-- [Content description](#content-description)
-  * [`%createDFArray()` macro](#createdfarray-macro)
-  * [`%createDHArray()` macro](#createdharray-macro)
-  * [`%createDHFifo()` macro](#createdhfifo-macro)
-  * [`%createDHOrdStack()` macro](#createdhordstack-macro)
-  * [`%createDHPrtQueue()` macro](#createdhprtqueue-macro)
-  * [`%createDHStack()` macro](#createdhstack-macro)
-  * [`bit64orPROTOdfa()` proto function](#bit64orprotodfa-proto-function)
-  * [`bit64andPROTOdfa()` proto function](#bit64andprotodfa-proto-function)  
-  * [`bit64orDFA()` subroutine](#bit64ordfa-function)  
-  * [`bit64andDFA()` subroutine](#bit64anddfa-function)  
-  * [`%createDFBitmap()` macro](#createdfbitmap-macro)
-  * [`generateArrays` exec](#createdhprtqueue-exec)
-  * [`generateArrays` clean](#createdhprtqueue-clean)
+# Documentation for the `DFA` package.
+  
+----------------------------------------------------------------
+ 
+ *Dynamic function arrays and other useful data structures* 
+  
+----------------------------------------------------------------
+ 
+### Version information:
+  
+- Package: DFA
+- Version: 0.5.10
+- Generated: 2026-02-17T12:17:54
+- Author(s): Bartosz Jablonski (yabwon@gmail.com)
+- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
+- License: MIT
+- File SHA256: `F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9` for this version
+- Content SHA256: `C*EE048846A8155C317867DCDB8EE1AE9E0352235DC247E4379D101A7296BD0C07` for this version
   
-  * [License](#license)
-
 ---
-
-# The DFA package [ver. 0.5.7] <a name="dfa-package"></a> ###############################################
+ 
+# The `DFA` package, version: `0.5.10`;
+  
+---
+ 
 
 The **DFA** (a.k.a. *Dynamic Function Array*) package implements:
  - dynamic numeric and character arrays,
@@ -36,30 +40,50 @@ Few exemplary functions are also generated.
 See particular macro help for further details.
 
 ---
-
-Package contains: 
-1.   macro      createdfarray 
-2.   macro      createdharray 
-3.   macro      createdhfifo 
-4.   macro      createdhordstack 
-5.   macro      createdhprtqueue 
-6.   macro      createdhstack 
-7.   proto      bit64andprotodfa 
-8.   proto      bit64orprotodfa 
-9.   functions  bit64anddfa 
-10.  functions  bit64ordfa 
-11.  macro      createdfbitmap 
-12.  exec       generatearrays 
-13.  clean      generatearrays
-
-*SAS package generated by generatePackage, version 20231111*
-
-The SHA256 hash digest for package DFA: 
-`F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045BEB958168` 
-
+  
 ---
-# Content description ############################################################################################
-
+ 
+  
+---
+ 
+Required SAS Components: 
+  - Base SAS Software
+  
+---
+ 
+ 
+---------------------------------------------------------------------
+ 
+*SAS package generated by SAS Package Framework, version `20260216`,*
+*under `WIN`(`X64_10PRO`) operating system,*
+*using SAS release: `9.04.01M9P06042025`.*
+ 
+---------------------------------------------------------------------
+ 
+# The `DFA` package content
+The `DFA` package consists of the following content:
+ 
+1. [`%createdfarray()` macro ](#createdfarray-macro-1 )
+2. [`%createdharray()` macro ](#createdharray-macro-2 )
+3. [`%createdhfifo()` macro ](#createdhfifo-macro-3 )
+4. [`%createdhordstack()` macro ](#createdhordstack-macro-4 )
+5. [`%createdhprtqueue()` macro ](#createdhprtqueue-macro-5 )
+6. [`%createdhstack()` macro ](#createdhstack-macro-6 )
+7. [`bit64andprotodfa()` proto ](#bit64andprotodfa-proto-7 )
+8. [`bit64orprotodfa()` proto ](#bit64orprotodfa-proto-8 )
+9. [`bit64anddfa()` function ](#bit64anddfa-functions-9 )
+10. [`bit64ordfa()` function ](#bit64ordfa-functions-10 )
+11. [`%createdfbitmap()` macro ](#createdfbitmap-macro-11 )
+12. [`generatearrays` exec ](#generatearrays-exec-12 )
+13. [`generatearrays` clean ](#generatearrays-clean-13 )
+  
+ 
+14. [License note](#license)
+  
+---
+ 
+## `%createdfarray()` macro <a name="createdfarray-macro-1"></a> ######
+ 
 ## >>> `%createDFArray()` macro: <<< <a name="createdfarray-macro"></a> #######################
 
 The `%createDFArray()` macro allows to generate
@@ -122,7 +146,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -172,6 +196,7 @@ and accepts the following list of arguments and values:
 
 The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
 
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Searchable, and Immutable array:
@@ -309,6 +334,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---
+
+  
+---
+ 
+## `%createdharray()` macro <a name="createdharray-macro-2"></a> ######
+ 
 ## >>> `%createDHArray()` macro: <<< <a name="createdharray-macro"></a> #######################
 
 The `%createDHArray()` macro allows to generate
@@ -360,7 +391,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -397,6 +428,7 @@ and accepts the following list of arguments and values:
 
 The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
 
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Hash-based, and Character array:
@@ -464,6 +496,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---
+
+  
+---
+ 
+## `%createdhfifo()` macro <a name="createdhfifo-macro-3"></a> ######
+ 
 ## >>> `%createDHFifo()` macro: <<< <a name="createdhfifo-macro"></a> #######################
 
 The `%createDHFifo()`  macro allows to generate
@@ -519,7 +557,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -550,7 +588,7 @@ and accepts the following list of arguments and values:
 
 The `value` argument is **outarg**, i.e. can be changed by the function.
 
-
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Hash-based, and Character fifo:
@@ -639,6 +677,12 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---
+
+  
+---
+ 
+## `%createdhordstack()` macro <a name="createdhordstack-macro-4"></a> ######
+ 
 ## >>> `%createDHOrdStack()` macro: <<< <a name="createdhordstack-macro"></a> #######################
 
 The `%createDHOrdStack()` macro allows to generate
@@ -699,7 +743,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -732,7 +776,7 @@ and accepts the following list of arguments and values:
 
 The `value` argument is **outarg**, i.e. can be changed by the function.
 
-
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Hash-based, and Character Descending Ordered stack:
@@ -804,6 +848,12 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---
+
+  
+---
+ 
+## `%createdhprtqueue()` macro <a name="createdhprtqueue-macro-5"></a> ######
+ 
 ## >>> `%createDHPrtQueue()` macro: <<< <a name="createdhprtqueue-macro"></a> #######################
 
 
@@ -860,7 +910,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -901,7 +951,7 @@ and accepts the following list of arguments and values:
 
 The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
 
-
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Hash-based, and Character Priority queue:
@@ -965,6 +1015,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---
+
+  
+---
+ 
+## `%createdhstack()` macro <a name="createdhstack-macro-6"></a> ######
+ 
 ## >>> `%createDHStack()` macro: <<< <a name="createdhstack-macro"></a> #######################
 
 The `%createDHStack()` macro allows to generate
@@ -1020,7 +1076,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -1050,7 +1106,7 @@ and accepts the following list of arguments and values:
 
 The `value` argument is **outarg**, i.e. can be changed by the function.
 
-
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Dynamic, Hash-based, and Character stack:
@@ -1128,31 +1184,11 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
 
 ---
 
-## >>> `bit64orPROTOdfa()` proto function: <<< <a name="bit64orprotodfa-proto-function"></a> #######################  
-
-The **bit64orPROTOdfa()** is external *C* function, 
-this is the implementation of the *bitwise OR* operation
-on doubles. A double is returned. 
-
-**Caution!** For SAS numeric values *only* operations on first 53 bits are valid! 
-
-The function is used **internally** by functions in the *DFA* package.
-
-### SYNTAX: ###################################################################
-
-The basic syntax is the following:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
-bit64orPROTOdfa(i, j)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-**Arguments description**:
-
-1. `i`  - A double numeric argument.
-
-2. `j`  - A double numeric argument.
-
+  
 ---
-
+ 
+## `bit64andprotodfa()` proto <a name="bit64andprotodfa-proto-7"></a> ######
+ 
 ## >>> `bit64andPROTOdfa()` proto function: <<< <a name="bit64andprotodfa-proto-function"></a> #######################  
 
 The **bit64andPROTOdfa()** is external *C* function, 
@@ -1178,62 +1214,41 @@ bit64andPROTOdfa(i, j)
 
 ---
 
-## >>> `bit64orDFA()` subroutine: <<< <a name="bit64ordfa-function"></a> #######################  
+  
+---
+ 
+## `bit64orprotodfa()` proto <a name="bit64orprotodfa-proto-8"></a> ######
+ 
+## >>> `bit64orPROTOdfa()` proto function: <<< <a name="bit64orprotodfa-proto-function"></a> #######################  
 
-The **bit64orDFA()** function is an alternative to 
-the 32 bit bitwise `BOR()` function working on SAS numerics.
-Allows to work on *up to* 53 bits of SAS numeric value.
+The **bit64orPROTOdfa()** is external *C* function, 
+this is the implementation of the *bitwise OR* operation
+on doubles. A double is returned. 
 
-The `bit64orDFA()` is an *internal* function of the `DFA` package.
+**Caution!** For SAS numeric values *only* operations on first 53 bits are valid! 
+
+The function is used **internally** by functions in the *DFA* package.
 
 ### SYNTAX: ###################################################################
 
-The basic syntax is the following, the `<...>` means optional parameters:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
-bit64orDFA(a, b)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The basic syntax is the following:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+bit64orPROTOdfa(i, j)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Arguments description**:
 
-1. `a` - Argument is a SAS numeric values.
+1. `i`  - A double numeric argument.
 
-2. `B` - Argument is a SAS numeric values.
-
-### EXAMPLES AND USECASES: ####################################################
-
-**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
-  options ls = max ps = max;
-  %let M = 53 ; %* 53 is maximum valid value;
-  data _null_;
-    array bitmask [ 0: &M] _temporary_ ;
-    do P = 1 to &M ;
-      bitmask[P] = 2**(P-1) ;
-      put bitmask[P] = binary54. @;
-      put bitmask[P] = best32.; 
-    end ;
-    bitmask[0] = bitmask[&M.] ;
-      put bitmask[0] = best32. /;
-
-      a=0;
-      put a = binary54.;
-      do P = 1 to &M ;
-        a = BIT64ORDFA (a, bitmask[P]) ;
-        put a = binary54.;
-      end;
-      put;
-      
-      b = 0;
-      put b = binary54./;
-      do P = 1 to &M ;
-        b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
-        put b = best32.;
-      end;
-  run;
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+2. `j`  - A double numeric argument.
 
 ---
 
+  
+---
+ 
+## `bit64anddfa()` function <a name="bit64anddfa-functions-9"></a> ######
+ 
 ## >>> `bit64andDFA()` subroutine: <<< <a name="bit64anddfa-function"></a> #######################  
 
 The **bit64andDFA()** function is an alternative to 
@@ -1255,6 +1270,7 @@ bit64andDFA(a, b)
 
 2. `B` - Argument is a SAS numeric values.
 
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
@@ -1290,6 +1306,73 @@ bit64andDFA(a, b)
 
 ---
 
+  
+---
+ 
+## `bit64ordfa()` function <a name="bit64ordfa-functions-10"></a> ######
+ 
+## >>> `bit64orDFA()` subroutine: <<< <a name="bit64ordfa-function"></a> #######################  
+
+The **bit64orDFA()** function is an alternative to 
+the 32 bit bitwise `BOR()` function working on SAS numerics.
+Allows to work on *up to* 53 bits of SAS numeric value.
+
+The `bit64orDFA()` is an *internal* function of the `DFA` package.
+
+### SYNTAX: ###################################################################
+
+The basic syntax is the following, the `<...>` means optional parameters:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+bit64orDFA(a, b)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**Arguments description**:
+
+1. `a` - Argument is a SAS numeric values.
+
+2. `B` - Argument is a SAS numeric values.
+
+ 
+### EXAMPLES AND USECASES: ####################################################
+
+**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+  options ls = max ps = max;
+  %let M = 53 ; %* 53 is maximum valid value;
+  data _null_;
+    array bitmask [ 0: &M] _temporary_ ;
+    do P = 1 to &M ;
+      bitmask[P] = 2**(P-1) ;
+      put bitmask[P] = binary54. @;
+      put bitmask[P] = best32.; 
+    end ;
+    bitmask[0] = bitmask[&M.] ;
+      put bitmask[0] = best32. /;
+
+      a=0;
+      put a = binary54.;
+      do P = 1 to &M ;
+        a = BIT64ORDFA (a, bitmask[P]) ;
+        put a = binary54.;
+      end;
+      put;
+      
+      b = 0;
+      put b = binary54./;
+      do P = 1 to &M ;
+        b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
+        put b = best32.;
+      end;
+  run;
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+---
+
+  
+---
+ 
+## `%createdfbitmap()` macro <a name="createdfbitmap-macro-11"></a> ######
+ 
 ## >>> `%createDFBitmap()` macro: <<< <a name="createdfbitmap-macro"></a> #######################
 
 The `%createDFBitmap()` macro allows to generate
@@ -1346,7 +1429,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * `header=`       - *Optional*, the default value is `1`. Indicates if 
                     the `proc fcmp outlib = &outlib.;` header is added to 
                     the executed code. If not 1 then no header is added.
-                    
+
 **Created function arguments description**:
 
 A function generated by the macro is:
@@ -1382,6 +1465,7 @@ and accepts the following list of arguments and values:
 
 The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
 
+ 
 ### EXAMPLES AND USECASES: ####################################################
 
 **EXAMPLE 1.** Bitmap of type 32:
@@ -1534,6 +1618,11 @@ NOTE: DATA statement used (Total process time):
 
 ---
 
+  
+---
+ 
+## `generatearrays` exec <a name="generatearrays-exec-12"></a> ######
+ 
 ## >>> `generateArrays` exec: <<< <a name="createdhprtqueue-exec"></a> #######################
  
 The generateArrays exec file provides a **list of automatically generated examples** of functions
@@ -1563,6 +1652,12 @@ The list of provided examples is the following:
 The `outlib=` option is set to `work.DFAfcmp.package`. The `cmplib=` option is updated automatically.
 
 ---
+
+  
+---
+ 
+## `generatearrays` clean <a name="generatearrays-clean-13"></a> ######
+ 
 ## >>> `generateArrays` clean: <<< <a name="createdhprtqueue-clean"></a> #######################
  
 The generateArrays clean file clears the list of automatically generated examples of functions
@@ -1572,9 +1667,15 @@ The `cmplib=` option is updated automatically.
 
 ---
 
-## License ####################################################################
-
-Copyright (c) 2019 Bartosz Jablonski
+  
+---
+ 
+  
+---
+ 
+# License <a name="license"></a> ######
+ 
+Copyright (c) 2019 - 2026 Bartosz Jablonski
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1593,5 +1694,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
+  
 ---
+ 

packages/gsm.md

@@ -1,20 +1,38 @@
-- [The GSM package](#gsm-package)
-- [Content description](#content-description)
-  * [`%GSM()` macro](#gsm-macro)  
-  * [`%GSMpck_makeFCMPcode()` macro](#gsmpck-makefcmpcode-macro)  
-
-  * [License](#license)
+# Documentation for the `GSM` package.
+  
+----------------------------------------------------------------
+ 
+ *Generate Secure Macros - to keep your code secret* 
+  
+----------------------------------------------------------------
+ 
+### Version information:
+  
+- Package: GSM
+- Version: 0.22.3
+- Generated: 2026-02-17T12:08:56
+- Author(s): Bartosz Jablonski (yabwon@gmail.com)
+- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
+- License: MIT
+- File SHA256: `F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1` for this version
+- Content SHA256: `C*1955721DDAAE32A631A8071BEE3BC6CF83761C2280DA5F823D4E4CFD96838FD3` for this version
   
 ---
-
-
-# The GSM package [ver. 0.22.1] <a name="gsm-package"></a> ###############################################
+ 
+# The `GSM` package, version: `0.22.3`;
+  
+---
+ 
 
 The **GSM** (a.k.a. *Generate Secure Macros*) package allows
 to create secured macros stored in SAS Proc FCMP functions.
 The dataset with functions can be shared and allows to generate 
 macros without showing their code.
 
+[Recording of presentation with "how it works" description (in Polish)](https://www.youtube.com/watch?v=LtaWPe2sgRY&t=1s "YouTube").
+
+[The WUSS 2023 Conference article describing the idea](https://www.wuss.org/wuss-2023-conference-proceedings/ "Article about the idea GSM")
+
 The GSM package is basically an automated version of the following:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 proc fcmp outlib = work.gsm.secure ENCRYPT;
@@ -42,10 +60,6 @@ run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 See examples for more details.
 
-[Recording of presentation with "how it works" description (in Polish)](https://www.youtube.com/watch?v=LtaWPe2sgRY&t=1s "YouTube").
-
-[The WUSS 2023 Conference article describing the idea](https://www.lexjansen.com/wuss/2023/WUSS-2023-Paper-189.pdf "Article about the idea GSM")
-
 
 *How to use it:* 
  - Copy all files with your secured macros code into a directory. 
@@ -56,53 +70,74 @@ See examples for more details.
    %GSM(<the path to directory>, cmplib=<name of the dataset>)
    ```
  - Share generated `ZIP` file (unzip and run the code).
- 
+
+
 **Limitations:** 
  - Single macro file cannot be longer than 32760 bytes.
  
  - Multiline text variable. Consider the following code text file:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-%macro~test()/SECURE;~#@
-data~test;~#@
-a~=~"abc~#@
-~#@
-def";~#@
-put~a~hex20.;~#@
-run;~#@
-%mend~test;~#@
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-where `~` symbols the space character, 
-`#` symbols the carriage return (`0D`), 
-and `@` symbols the line feed (`0A`).
-The code file is scanned and inserted into 
-the `resolve()` function argument in a "byte by byte"
-fashion hence also the "end of line" characters are included.
-As the result value of variable `a` will be: 
+   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+   %macro~test()/SECURE;~#@
+   data~test;~#@
+   a~=~"abc~#@
+   ~#@
+   def";~#@
+   put~a~hex20.;~#@
+   run;~#@
+   %mend~test;~#@
+   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+   where `~` symbols the space character, 
+   `#` symbols the carriage return (`0D`), 
+   and `@` symbols the line feed (`0A`).
+   The code file is scanned and inserted into 
+   the `resolve()` function argument in a "byte by byte"
+   fashion hence also the "end of line" characters are included.
+   As the result value of variable `a` will be: 
 
-`a = "abc~#@~#@def"`. 
-
-If you want to use the `GSM` package avoid 
-such "style" of coding in your macros.
+   `a = "abc~#@~#@def"`. 
 
+   If you want to use the `GSM` package avoid 
+   such "style" of coding in your macros.
 
 ---
-
-Package contains: 
-  1.   macro      gsm 
-  2.   macro      gsmpck_makefcmpcode 
-
+  
+---
+ 
+  
+---
+ 
 Required SAS Components: 
-  `Base SAS Software`
-
-Package contains additional content, run:  %loadPackageAddCnt(GSM)  to load it
-or look for the gsm_AdditionalContent directory in the Packages fileref
+  - Base SAS Software
+  
+---
+ 
+  
+---
+ 
+Package contains additional content, run:  `%loadPackageAddCnt(GSM)`  to load it
+or look for the `gsm_AdditionalContent` directory in the `packages` fileref
 localization (only if additional content was deployed during the installation process).
-
-*SAS package generated by generatePackage, version 20231111*
-
-The SHA256 hash digest for package GSM: 
-`F*80197391195C3EC41BD436DF0C8802D3920E4D22B64009A7DE872FBDF8D4B86E` 
-
+ 
+---------------------------------------------------------------------
+ 
+*SAS package generated by SAS Package Framework, version `20260216`,*
+*under `WIN`(`X64_10PRO`) operating system,*
+*using SAS release: `9.04.01M9P06042025`.*
+ 
+---------------------------------------------------------------------
+ 
+# The `GSM` package content
+The `GSM` package consists of the following content:
+ 
+1. [`%gsm()` macro ](#gsm-macro-1 )
+2. [`%gsmpck_makefcmpcode()` macro ](#gsmpckmakefcmpcode-macro-2 )
+  
+ 
+3. [License note](#license)
+  
+---
+ 
+## `%gsm()` macro <a name="gsm-macro-1"></a> ######
  
 ## >>> `%GSM()` macro: <<< <a name="gsm-macro"></a> #######################
 
@@ -111,20 +146,22 @@ the **GSM** (a.k.a. *Generate Secure Macros*) package.
 
 It converts a list of macros provided by the user into
 a data set of the Proc FCMP functions. The macros are stored
-in functions are encrypted which allow to share them without 
-showing their code. *Important* thing is that macros provided 
-by the user *has* to be "secure", i.e. the `secure` option has to 
-be added to the macro definition. See the example:
+as encrypted code which allow to share the macros
+without showing their code.
+
+*Important* thing is that macros provided by the user *has* to
+be "secure", i.e. the `secure` option has to be added to the 
+macro definition and th emacro code has to be written properly. 
+See the example:
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
-%macro secretMacro(x) / SECURE; /* <- the secure option */
-  <... some code ...>
+%macro secretMacro(x) / SECURE; %* <- the secure option *;
+  <... secure code ...>
 %mend secretMacro;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
 As a result a zip file, containing dataset with functions and 
-code to be executed on site, is generated.
+code to be executed on site, is generated. 
 
 Since encrypted code is stored in a SAS dataset it has
 no limitation in sharing between operating systems (like catalogs have).
@@ -199,9 +236,11 @@ The basic syntax is the following, the `<...>` means optional parameters:
 
 * `trim=`               - *Deprecated*, the default value is `0`.
                           *Kept for backward compatibility.*
-                          
+
+
 ---
 
+
 ### Example: ###################################################################
 
 Example 1. Prepare 2 files: `f1.sas` and `f2.sas` and use the `%GSM()` macro.
@@ -245,6 +284,11 @@ run;
 %GSM(&path., cmplib=work.myMacros)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+  
+---
+ 
+## `%gsmpck_makefcmpcode()` macro <a name="gsmpckmakefcmpcode-macro-2"></a> ######
+ 
 ## >>> `%GSMpck_makeFCMPcode()` macro: <<< <a name="GSMpck-makeFCMPcode-macro"></a> #######################
 
 The `%GSMpck_makeFCMPcode()` macro is an internal macro of 
@@ -310,10 +354,15 @@ The basic syntax is the following, the `<...>` means optional parameters:
 
 ---
 
-
-## License ####################################################################
-
-Copyright (c) Bartosz Jablonski, since 2021
+  
+---
+ 
+  
+---
+ 
+# License <a name="license"></a> ######
+ 
+Copyright (c) Bartosz Jablonski, since 2021 onward
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -332,5 +381,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
+  
 ---
+ 

packages/macroarray.md

@@ -9,17 +9,17 @@
 ### Version information:
   
 - Package: macroArray
-- Version: 1.3.0
-- Generated: 2026-01-13T15:30:15
+- Version: 1.3.2
+- Generated: 2026-02-17T08:51:01
 - Author(s): Bartosz Jablonski (yabwon@gmail.com)
 - Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
 - License: MIT
-- File SHA256: `F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24` for this version
-- Content SHA256: `C*9119F3A4C7C4D859C7FB03373AB4FE6551CD7BDFA42BA9B4303D36C367BC8855` for this version
+- File SHA256: `F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9` for this version
+- Content SHA256: `C*DE477F4E280D438B364320F324C88DA3D336F102BA37810C60BDE15398DE84E9` for this version
   
 ---
  
-# The `macroArray` package, version: `1.3.0`;
+# The `macroArray` package, version: `1.3.2`;
   
 ---
  
@@ -43,6 +43,14 @@ Some of components are:
 - `%mcDictionary()`,
 - etc.
 
+Read this article to learn more:
+"Macro Variable Arrays Made Easy with macroArray SAS Package"
+
+Link to the text:
+`https://www.lexjansen.com/pharmasug/2024/AP/PharmaSUG-2024-AP-108.pdf`
+or
+`https://www.lexjansen.com/wuss/2024/124_FINAL_paper_pdf.pdf`
+
 *Note:*
 If you are working with BIG macroarrays do not 
 forget to verify your session setting for macro 
@@ -75,7 +83,7 @@ Required SAS Components:
  
 ---------------------------------------------------------------------
  
-*SAS package generated by SAS Package Framework, version `20251231`,*
+*SAS package generated by SAS Package Framework, version `20260216`,*
 *under `WIN`(`X64_10PRO`) operating system,*
 *using SAS release: `9.04.01M9P06042025`.*
  

packages/sqlinds.md

@@ -9,23 +9,21 @@
 ### Version information:
   
 - Package: SQLinDS
-- Version: 2.3.1
-- Generated: 2025-11-22T12:47:32
+- Version: 2.4.0
+- Generated: 2026-05-11T14:15:07
 - Author(s): Mike Rhoads (RhoadsM1@Westat.com), contributor Bartosz Jablonski
 - Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
 - License: MIT
-- File SHA256: `F*606A24A2A6B06DAAD2D443FA9A9819D9564235A5CD8599FD15586F1EFFCB41BC` for this version
-- Content SHA256: `C*4CCCF31DA9D94E0EE2DA612724D395056B7BA07CB593C93947835BB8319B33EB` for this version
+- File SHA256: `F*A3DC9400DEF1403DC9E191611790244A8B0FB23303D3A98D29777E46A1D4E8B4` for this version
+- Content SHA256: `C*4A49F365C4EF8C5523393FDC1E11C344B023F449B3F1759BA27CFC6C1293A499` for this version
   
 ---
  
-# The `SQLinDS` package, version: `2.3.1`;
+# The `SQLinDS` package, version: `2.4.0`;
   
 ---
  
 
-### The SQLinDS package [ver. 2.3.1]
-
 The **SQLinDS** package is an implementation of 
 the *macro-function-sandwich* concept introduced in the 
 *"Use the Full Power of SAS in Your Function-Style Macros"*,
@@ -77,9 +75,9 @@ localization (only if additional content was deployed during the installation pr
  
 ---------------------------------------------------------------------
  
-*SAS package generated by SAS Package Framework, version `20251122`,*
+*SAS package generated by SAS Package Framework, version `20260411`,*
 *under `WIN`(`X64_10PRO`) operating system,*
-*using SAS release: `9.04.01M9P06042025`.*
+*using SAS release: `9.04.01M9P06052025`.*
  
 ---------------------------------------------------------------------
  
@@ -157,18 +155,18 @@ Copy of the article can also be found in *additional content* directory.
 %sql(<nonempty Proc SQL query code>)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The THE query code is limited to approximately *32000* bytes.
+The query code is limited to approximately *32000* bytes.
 
 ### EXAMPLES: #################################################################
 
-**EXAMPLE 1**: simple SQL query
+**EXAMPLE 1**: A simple SQL query.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data class_subset;
   set %SQL(select name, sex, height from sashelp.class where age > 12);
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**EXAMPLE 2**: query with dataset options
+**EXAMPLE 2**: A query with dataset options.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data renamed;
   set %SQL(select name, age from sashelp.class 
@@ -177,12 +175,28 @@ data renamed;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**EXAMPLE 3**: Proc SQL dictionaries in the data step
+**EXAMPLE 3**: Proc SQL dictionaries in the data step.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data dictionary;
   set %SQL(select dict.* from dictionary.macros as dict);
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**EXAMPLE 4**: Use Proc SQL to populate hash table. 
+               Call to `%SQL()` has to be in double-quotes.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+data _null_;
+  if 0 then set %SQL(SELECT name, age FROM sashelp.class);
+
+  declare hash H (dataset: "%SQL(SELECT name, age FROM sashelp.class)") ;
+  H.defineKey("age");
+  H.defineKey("name");
+  H.defineDone();
+
+  H.output(dataset:"output");
+  stop;
+run;
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ---
 
   
@@ -235,7 +249,7 @@ run he following:
  
 # License <a name="license"></a> ######
  
-Copyright (c) 2012 Mike Rhoads
+Copyright (c) since 2012 onward, Mike Rhoads
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal