Compare commits

...

3 Commits

Author SHA1 Message Date
Bart Jablonski 923dfbc369 SAS Packages Framework, version 20260723
SAS Packages Framework, version `20260723`

Changes:

- Bugfix in the %isPackagesFilerefOK() macro.
- New functionality added to the %SasPackagesFrameworkNotes() macro.
- Minor code cleaning.
2026-07-23 15:37:54 +02:00
Bart Jablonski 914ad08157 SAS Packages Framework, version 20260721
SAS Packages Framework, version `20260721`

Changes:

- Small errors fixed
- Code cleanup
2026-07-22 10:14:11 +02:00
Bart Jablonski 8102ab5513 SAS Packages Framework, version 20260710
SAS Packages Framework, version `20260710`

Changes:

- Code cleanup
2026-07-10 11:05:38 +02:00
26 changed files with 471 additions and 405 deletions
+1 -1
View File
@@ -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 **`20260617**.
**The latest version** of the **SAS Packages Framework** is **`20260723**.
---
+6 -6
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -72,7 +72,7 @@ Contributors:
,packagesRef=packages
,ods= /* data set for report file */
)/
des='Macro to create a bundle of SAS packages, version 20260617. Run %bundlePackages(HELP) for help info.'
des='Macro to create a bundle of SAS packages, version 20260723. Run %bundlePackages(HELP) for help info.'
secure minoperator
;
@@ -89,7 +89,7 @@ secure minoperator
%put ### This is short help information for the `bundlePackages` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *create bundles* of SAS packages, version `20260617` #;
%put # Macro to *create bundles* of SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -490,7 +490,7 @@ run;
/*===================================================================================================*/
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -70,7 +70,7 @@ Contributors:
when empty the "packages" value is used */
)/secure
/*** HELP END ***/
des = 'Macro to list directories pointed by "packages" fileref, version 20260617. Run %extendPackagesFileref(HELP) for help info.'
des = 'Macro to list directories pointed by "packages" fileref, version 20260723. Run %extendPackagesFileref(HELP) for help info.'
;
%if %QUPCASE(&packages.) = HELP %then
@@ -86,7 +86,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20260617
%put ### This is short help information for the `extendPackagesFileref` macro #;
%put #-----------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to list directories pointed by 'packages' fileref, version `20260617` #;
%put # Macro to list directories pointed by 'packages' fileref, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+82 -81
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -67,7 +67,7 @@ Contributors:
Macro to generate SAS packages.
Version 20260617
Version 20260723
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -95,7 +95,7 @@ Contributors:
if null (the default) the WORK is used */
,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
,testWorkPath= /* location where tests SAS session work directories
should be stored, if null (the default) the main SAS
session WORK is used. Takes precedence over workInTestResults= */
,sasexe= /* a DIRECTORY where the SAS binary is located,
@@ -117,7 +117,7 @@ Contributors:
when empty takes buildLocation */
)/ secure minoperator
/*** HELP END ***/
des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HELP) for help info.'
des = 'Macro to generate SAS packages, version 20260723. Run %generatePackage(HELP) for help info.'
;
%if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
%do;
@@ -132,7 +132,7 @@ des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HE
%put ### This is short help information for the `generatePackage` macro #;
%put #------------------------------------------------------------------------------------#;
%put # #;
%put # Macro to generate SAS packages, version `20260617` #;
%put # Macro to generate SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -189,8 +189,8 @@ des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HE
%put # if null (the default) then the `!SASROOT` is used. #;
%put # #;
%put # - `sascfgFile=` Location of a FILE with testing session configuration #;
%put # parameters, if null (the default) then no config file #;
%put # is pointed during the SAS invocation, #;
%put # parameters, if null (the default) then no configuration #;
%put # file is pointed during the SAS invocation, #;
%put # if set to `DEF` then the `!SASROOT/sasv9.cfg` is used. #;
%put # #;
%put # - `delTestWork=` Indicates if `WORK` directories generated by user tests #;
@@ -512,7 +512,8 @@ data _null_;
/* test if version is a number */
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
v = "&packageVersion.";
length v $ 64;
v = symget("packageVersion");
version = coalesce(input(scan(v,1,".","M"), ?? best32.),0)*1e8
+ coalesce(input(scan(v,2,".","M"), ?? best32.),0)*1e4
+ coalesce(input(scan(v,3,".","M"), ?? best32.),0)*1e0
@@ -520,7 +521,7 @@ data _null_;
if not (version > 0) then
do;
put 'ERROR: Package version should be a positive NUMBER.'
/ 'ERROR- Current value is: ' "&packageVersion."
/ 'ERROR- Current value is: ' v
/ 'ERROR- Try something small, e.g. 0.1'
/ 'ERROR- Aborting.';
put;
@@ -1014,7 +1015,7 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
title&_titleNumber_. "Package ZIP file location is: &buildLocation.";
%end;
footnote1 "SAS Packages Framework, version 20260617";
footnote1 "SAS Packages Framework, version 20260723";
proc print
data = &filesWithCodes.(drop=base build folderRef fileRef rc folderid _abort_ fileId additionalContent)
@@ -1195,20 +1196,20 @@ data _null_;
/ ' %let pV = %sysevalf((%scan(&pV0.,1,.,M)+0)*1e8 '
/ ' + (%scan(&pV0.,2,.,M)+0)*1e4 '
/ ' + (%scan(&pV0.,3,.,M)+0)*1e0); '
/ ' '
/ ' %let rV0 = %sysfunc(compress(&requiredVersion.,.,kd)); '
/ ' %let rVsign = %sysfunc(compress(&requiredVersion.,<=>,k)); '
/ ' %if %superq(rVsign)= %then %let rVsign=<=; '
/ ' %else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then '
/ ' %do; '
/ ' %put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.; '
/ ' %put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.; '
/ ' %put WARNING- Supported operators are: %str(= <= =< => >= < >); '
/ ' %let rVsign=<=; '
/ ' %end; '
/ ' %let rV = %sysevalf((%scan(&rV0.,1,.,M)+0)*1e8 '
/ ' + (%scan(&rV0.,2,.,M)+0)*1e4 '
/ ' + (%scan(&rV0.,3,.,M)+0)*1e0); '
/ ' '
/ ' %if NOT %sysevalf(&rV. &rVsign. &pV.) %then '
/ ' %do; '
/ ' %put ERROR: Package &packageName. will not be loaded!; '
@@ -1228,8 +1229,8 @@ data _null_;
/ ' %local cherryPick; %let cherryPick=*; '
/ ' %local tempLoad_minoperator; '
/ ' %let tempLoad_minoperator = %sysfunc(getoption(minoperator)); '
/ " "
/ ' %if %superq(suppressExec) NE 1 %then %let suppressExec = 0; '
/ ' %if %sysevalf(%superq(suppressExec) NE 1,boolean) %then %let suppressExec = 0; '
/ ' %include &_PackageFileref_.(load.sas) / &source2.; '
/ ' options &tempLoad_minoperator.; '
/ ' filename &_PackageFileref_. clear; '
@@ -1287,72 +1288,71 @@ data _null_;
or (%superq(packageReqPackages) ne )
%then
%do;
put ' data _null_; '
/ ' call symputX("packageRequiredErrors", 0, "L"); '
/ ' run; ';
put ' data _null_; '
/ ' call symputX("packageRequiredErrors", 0, "L"); '
/ ' run; ';
%end;
%if %superq(packageRequired) ne %then
%if %sysevalf(%superq(packageRequired) ne,boolean) %then
%do;
put ' %put NOTE- *Testing required SAS components*%sysfunc(DoSubL(' /* <- DoSubL() is here */
/ ' options nonotes nosource %str(;) '
/ ' options ls=max ps=max locale=en_US %str(;) '
/ ' /* temporary redirect log */ '
/ ' filename _stinit_ TEMP %str(;) '
/ ' proc printto log = _stinit_ %str(;) run %str(;) '
/ ' /* 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 '
/ ' do %str(;) '
/ ' length req $ 256 %str(;) '
/ ' declare hash R() %str(;) '
/ ' _N_ = R.defineKey("req") %str(;) '
/ ' _N_ = R.defineDone() %str(;) '
/ ' declare hiter iR("R") %str(;) ';
put ' %put NOTE- *Testing required SAS components*%sysfunc(DoSubL(%str(' /* <- DoSubL() is here */
/ ' options nonotes nosource ; '
/ ' options ls=max ps=max locale=en_US ; '
/ ' /* temporary redirect log */ '
/ ' filename _stinit_ TEMP ; '
/ ' proc printto log = _stinit_ ; run ; '
/ ' /* print out setinit */ '
/ ' proc setinit ; run ; '
/ ' proc printto ; run ; '
/ ' options ps=min ; '
/ ' data _null_ ; '
/ ' /* loadup checklist of required SAS components */ '
/ ' if _n_ = 1 then '
/ ' do ; '
/ ' length req $ 256 ; '
/ ' declare hash R() ; '
/ ' _N_ = R.defineKey("req") ; '
/ ' _N_ = R.defineDone() ; '
/ ' declare hiter iR("R") ; ';
length packageRequired $ 32767;
packageRequired = upcase(symget('packageRequired'));
put ' do req = %bquote(' / packageRequired / ') %str(;) '
/ ' _N_ = R.add(key:req,data:req) %str(;) '
/ ' end %str(;) '
/ ' end %str(;) '
/ ' '
/ ' /* read in output from proc setinit */ '
/ ' infile _stinit_ end=eof %str(;) '
/ ' input %str(;) '
/* / ' put "*> " _infile_ %str(;) ' */ /* for testing */
/ ' '
put ' do req = %bquote(' / packageRequired / ') ; '
/ ' _N_ = R.add(key:req,data:req) ; '
/ ' end ; '
/ ' end ; '
/ ' '
/ ' /* read in output from proc setinit */ '
/ ' infile _stinit_ end=eof ; '
/ ' input ; '
/* / ' put "*> " _infile_ ; ' */ /* for testing */
/ ' '
/ ' /* if component is in setinit remove it from checklist */ '
/ ' if _infile_ =: "---" then '
/ ' do %str(;) '
/ ' req = upcase(substr(_infile_, 4, 64)) %str(;) '
/ ' if R.find(key:req) = 0 then '
/ ' do %str(;) '
/ ' _N_ = R.remove() %str(;) '
/ ' end %str(;) '
/ ' end %str(;) '
/ ' '
/ ' /* if checklist is not null rise error */ '
/ ' if eof and R.num_items > 0 then '
/ ' do %str(;) '
/ ' put "WARNING- ###########################################" %str(;) '
/ ' put "WARNING: The following SAS components are missing! " %str(;) '
/ ' call symputX("packageRequiredErrors", 0, "L") %str(;) '
/ ' do while(iR.next() = 0) %str(;) '
/ ' put "WARNING- " req %str(;) '
/ ' end %str(;) '
/ ' put "WARNING: The package may NOT WORK as expected " %str(;) '
/ ' put "WARNING: or even result with ERRORS! " %str(;) '
/ ' put "WARNING- ###########################################" %str(;) '
/ ' put %str(;) '
/ ' end %str(;) '
/ ' run %str(;) '
/ ' filename _stinit_ clear %str(;) '
/ ' options notes source %str(;) '
/ ' ))*; ';
/ ' if _infile_ =: "---" then '
/ ' do ; '
/ ' req = upcase(substr(_infile_, 4, 64)) ; '
/ ' if R.find(key:req) = 0 then '
/ ' do ; '
/ ' _N_ = R.remove() ; '
/ ' end ; '
/ ' end ; '
/ ' '
/ ' /* if checklist is not null rise error */ '
/ ' if eof and R.num_items > 0 then '
/ ' do ; '
/ ' put "WARNING- ###########################################" ; '
/ ' put "WARNING: The following SAS components are missing! " ; '
/ ' call symputX("packageRequiredErrors", 0, "L") ; '
/ ' do while(iR.next() = 0) ; '
/ ' put "WARNING- " req ; '
/ ' end ; '
/ ' put "WARNING: The package may NOT WORK as expected " ; '
/ ' put "WARNING: or even result with ERRORS! " ; '
/ ' put "WARNING- ###########################################" ; '
/ ' put ; '
/ ' end ; '
/ ' run ; '
/ ' filename _stinit_ clear ; '
/ ' options notes source ; '
/ ' )))*; ';
%end;
%if %superq(packageReqPackages) ne %then
@@ -1839,7 +1839,7 @@ data _null_;
%end;
put +(-1) '`.;'''
/ ' !! '' %put The macro generated: '' !! put(dtCASLudf, E8601DT19.-L) !! ";"'
/ ' !! '' %put with the SAS Packages Framework version 20260617.;'''
/ ' !! '' %put with the SAS Packages Framework version 20260723.;'''
/ ' !! '' %put ****************************************************************************;'''
/ ' !! '' %GOTO theEndOfTheMacro;'''
/ ' !! '' %end;''' ;
@@ -2003,7 +2003,7 @@ data _null_;
%end;
put +(-1) '`.; '' !!' /
''' %put The macro generated: ''' " !! put(dtIML, E8601DT19.-L) !! " '''; '' !! ' /
''' %put with the SAS Packages Framework version 20260617.; '' !! ' /
''' %put with the SAS Packages Framework version 20260723.; '' !! ' /
''' %put ****************************************************************************; '' !! ' /
''' %GOTO theEndOfTheMacro; '' !! ' /
''' %end; '' !! ' /
@@ -2875,7 +2875,7 @@ data _null_;
%end;
put 'put " " / @3 "---------------------------------------------------------------------" / " ";'
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260617`*";'
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260723`*";'
/ "put @3 '*under `&sysscp.`(`&sysscpl.`) operating system,*';"
/ "put @3 '*using SAS release: `&sysvlong4.`.*';"
/ 'put " " / @3 "---------------------------------------------------------------------";';
@@ -3039,6 +3039,7 @@ data _null_;
call execute(' rc = fcopy("_SPFIN_", "_SPFOUT_");');
call execute(' ex = fexist("_SPFOUT_"); Try + 1;');
call execute(' put Try= " File existence in ZIP verified as: " ex;');
call execute(' rc = sleep(^ex, 0.25);'); /* wait 0.25 sec if not copied successfully */
call execute(' end ;');
call execute(' if ex then put "File " pathname "copied into the package with return code: " rc "(0 = success)";');
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -92,7 +92,7 @@ Contributors:
*/
)/secure
/*** HELP END ***/
des = 'Macro to get help about SAS package, version 20260617. Run %helpPackage(HELP) for help info.'
des = 'Macro to get help about SAS package, version 20260723. Run %helpPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -107,7 +107,7 @@ des = 'Macro to get help about SAS package, version 20260617. Run %helpPackage(H
%put ### This is short help information for the `helpPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to get help about SAS packages, version `20260617` #;
%put # Macro to get help about SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+10 -10
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -63,7 +63,7 @@ Contributors:
/*** HELP END ***/
/*+installPackage+*/
/* Macros to install SAS packages, version 20260617 */
/* Macros to install SAS packages, version 20260723 */
/* 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
@@ -88,13 +88,13 @@ Contributors:
, 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 = /* 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 */
, githubToken = /* user 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 20260617. Run %installPackage(HELP) for help info.'
des = 'Macro to install SAS package, version 20260723. Run %installPackage(HELP) for help info.'
;
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
%do;
@@ -109,7 +109,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%put ### This is short help information for the `installPackage` macro #;
%put #--------------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to install SAS packages, version `20260617` #;
%put # Macro to install SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -212,7 +212,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%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 # Public repositories do not need authentication. #;
%put # [NOTE!] This feature is experimental in this release. #;
%put # #;
%put #--------------------------------------------------------------------------------------------#;
@@ -492,7 +492,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%if (%superq(URLuser) ne ) %then
%do;
user = "&URLuser."
pass = "&URLuser."
pass = "&URLpass."
%end;
&URLoptions.
recfm=N lrecl=1;
@@ -502,7 +502,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%if (%superq(URLuser) ne ) %then
%do;
user = "&URLuser."
pass = "&URLuser."
pass = "&URLpass."
%end;
&URLoptions.
recfm=N lrecl=1;
+16 -11
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -68,7 +68,7 @@ Contributors:
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 20260617.'
des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260723.'
;
/*** HELP END ***/
%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
@@ -77,14 +77,15 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%let options_tmp = ls=%sysfunc(getoption(ls)) ps=%sysfunc(getoption(ps))
%sysfunc(getoption(notes)) %sysfunc(getoption(source))
msglevel=%sysfunc(getoption(msglevel))
%sysfunc(getoption(mprint)) %sysfunc(getoption(mlogic)) %sysfunc(getoption(symbolgen))
;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N NOmprint NOmlogic NOsymbolgen;
%put ;
%put ###########################################################################################;
%put ### This is short help information for the `isPackagesFilerefOK` macro #;
%put #-----------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to check if the `packages` fileref is "correct", version `20260617` #;
%put # Macro to check if the `packages` fileref is "correct", version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -101,6 +102,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%put # #;
%put # 1. `vERRb` - *Optional* Indicates if the macro should return value AND be verbose #;
%put # (e.g., print errors and notes) or just return value. #;
%put # `1` means "verbose", `0` means "quiet". #;
%put # #;
%put # When used as: `%nrstr(%%isPackagesFilerefOK(HELP))` it displays this help information. #;
%put # #;
@@ -137,6 +139,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%GOTO ENDofIsPackagesFilerefOK;
%end;
%if %sysevalf(%superq(vERRb)=,boolean) %then %let vERRb = 0;
%if NOT (%superq(vERRb) in (0 1)) %then %let vERRb = 0;
%local isPackagesFilerefOK;
@@ -149,17 +152,19 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%if &nobs. AND 1=&vERRb. %then %put INFO: PACKAGES fileref is: %sysfunc(pathname(PACKAGES));
%let isPackagesFilerefOK=%sysevalf(&nobs. AND 1, boolean);
%let isPackagesFilerefOK=%sysevalf(&nobs. AND 1, boolean);
%do i = 1 %to &nobs.;
%let rc=%sysfunc(FETCHOBS(&dsid., &i.));
%let XENGINE=%sysfunc(GETVARC(&dsid., %sysfunc(VARNUM(&dsid., XENGINE))));
%let XPATH=%sysfunc(GETVARC(&dsid., %sysfunc(VARNUM(&dsid., XPATH))));
%put %superq(XENGINE) %superq(XPATH);
%if 1=&vERRb. %then
%put %superq(XENGINE) %superq(XPATH);
%if DISK ne %superq(XENGINE) %then
%do;
%let isPackagesFilerefOK=0;
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * 0);
%if 1=&vERRb. %then
%do;
%if %superq(XENGINE) = SASFSVAM %then %let XENGINE= FILESRVC (SASFSVAM);
@@ -168,7 +173,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%end;
%else %if 0=%sysfunc(fileexist(%superq(XPATH))) %then
%do;
%let isPackagesFilerefOK=0;
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * 0);
%if 1=&vERRb. %then
%do;
%put ERROR: Path: %superq(XPATH) does NOT exist!;
@@ -178,7 +183,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%do;
%let rc = %sysfunc(FILENAME(_F_, %superq(XPATH)));
%let dirid = %sysfunc(DOPEN(&_F_.));
%let isPackagesFilerefOK=%sysevalf(&dirid. AND 1, boolean);
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * %sysevalf(&dirid. AND 1, boolean));
%let dirid = %sysfunc(DCLOSE(&dirid.));
%let rc = %sysfunc(FILENAME(_F_));
%if 1=&vERRb. AND 0=&isPackagesFilerefOK. %then
+6 -6
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -67,7 +67,7 @@ Contributors:
Macro to list SAS packages in packages folder.
Version 20260617
Version 20260723
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -89,7 +89,7 @@ Contributors:
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 20260617.'
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260723.'
;
%if (%QUPCASE(&listDataSet.) = HELP) %then
%do;
@@ -104,7 +104,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 `20260617` #;
%put # Macro to list available SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+7 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -101,7 +101,7 @@ Contributors:
, force=0 /* force loading even if given version is already loaded */
)/secure
/*** HELP END ***/
des = 'Macro to load SAS package, version 20260617. Run %loadPackage(HELP) for help info.'
des = 'Macro to load SAS package, version 20260723. Run %loadPackage(HELP) for help info.'
minoperator
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -117,7 +117,7 @@ minoperator
%put ### This is short help information for the `loadPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *load* SAS packages, version `20260617` #;
%put # Macro to *load* SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -313,7 +313,7 @@ minoperator
%if %superq(rVsign)= %then %let rVsign=<=;
%else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then
%do;
%put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING- Supported operators are: %str(= <= =< => >= < >);
%let rVsign=<=;
%end;
@@ -384,7 +384,7 @@ minoperator
%else
%do;
%put NOTE- %str( );
%put NOTE: It looks like the &packageName.(&pLV0.) package already loaded! Nothing to do.;
%put NOTE: It looks like the &packageName.(&pLV0.) package is already loaded! Nothing to do.;
%put NOTE- To force reloading use the force=1;
/* if package is already loaded with req version. */
%put NOTE- %str( );
+7 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -83,7 +83,7 @@ Contributors:
is provided in required version */
)/secure
/*** HELP END ***/
des = 'Macro to load additional content for a SAS package, version 20260617. Run %loadPackageAddCnt(HELP) for help info.'
des = 'Macro to load additional content for a SAS package, version 20260723. Run %loadPackageAddCnt(HELP) for help info.'
minoperator
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -99,7 +99,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 `20260617` #;
%put # Macro to *load* additional content for a SAS package, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -236,7 +236,7 @@ minoperator
%if %superq(rVsign)= %then %let rVsign=<=;
%else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then
%do;
%put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING- Supported operators are: %str(= <= =< => >= < >);
%let rVsign=<=;
%end;
@@ -449,7 +449,7 @@ minoperator
%WrongVersionOFPackageAddCnt:
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -75,7 +75,7 @@ Contributors:
*/
)/secure
/*** HELP END ***/
des = 'Macro to load multiple SAS packages at one run, version 20260617. Run %loadPackages(HELP) for help info.'
des = 'Macro to load multiple SAS packages at one run, version 20260723. Run %loadPackages(HELP) for help info.'
parmbuff
;
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
@@ -91,7 +91,7 @@ parmbuff
%put ### This is short help information for the `loadPackageS` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro wrapper for the loadPackage macro, version `20260617` #;
%put # Macro wrapper for the loadPackage macro, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -87,7 +87,7 @@ Contributors:
*/
)/secure
/*** HELP END ***/
des = 'Macro to preview content of a SAS package, version 20260617. Run %previewPackage(HELP) for help info.'
des = 'Macro to preview content of a SAS package, version 20260723. Run %previewPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -102,7 +102,7 @@ des = 'Macro to preview content of a SAS package, version 20260617. Run %preview
%put ### This is short help information for the `previewPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to get preview of a SAS packages, version `20260617` #;
%put # Macro to get preview of a SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+7 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -79,7 +79,7 @@ Contributors:
,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 20260617. Run %relocatePackage(HELP) for help info.'
/ des = 'Utility macro that locally Copies or Moves Packages, version 20260723. Run %relocatePackage(HELP) for help info.'
secure
minoperator
;
@@ -97,7 +97,7 @@ Contributors:
%put ### This is short help information for the `relocatePackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260617` #;
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -295,7 +295,7 @@ Contributors:
%do;
if NOT (input(resolve('%isPackagesFilerefOK(&debug.)'), best.)=1) then /* if debug=1 the isPackagesFilerefOK in verbose mode */
do;
putlog "WARNING: The PACKAGES fileres is not OK! Exiting!";
putlog "WARNING: The PACKAGES fileref is not OK! Exiting!";
LINK stopProcessing;
end;
%end;
@@ -681,7 +681,7 @@ Contributors:
run;
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
+7 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -81,7 +81,7 @@ Contributors:
, github = /* name of a user or an organization in GitHub, all characters except [A-z0-9_.-] are compressed */
, githubRepo = /* 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 */
, githubToken = /* user github fine-grained personal access token */
, githubTokenDebug = 0 /* debug values: 0,1,2,3 */
, loadPackage=1 /* should the packages be loaded after installing */
@@ -90,7 +90,7 @@ Contributors:
, successDS= /* technical */
)
/secure
des = 'Macro to request SAS package installation and loading, version 20260617. Run %requestPackage(HELP) for help info.'
des = 'Macro to request SAS package installation and loading, version 20260723. Run %requestPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -106,7 +106,7 @@ des = 'Macro to request SAS package installation and loading, version 20260617.
%put ### This is short help information for the `requestPackage` macro #;
%put #--------------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to request (install and load) SAS packages, version `20260617` #;
%put # Macro to request (install and load) SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -203,7 +203,7 @@ des = 'Macro to request SAS package installation and loading, version 20260617.
%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 # Public repositories do not need authentication. #;
%put # [NOTE!] This feature is experimental in this release. #;
%put # #;
%put # **Loading options:** #;
+32 -10
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -69,7 +69,7 @@ SPFmacroName /* space separated list of names */
/
minoperator
secure
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260617. Run %SasPackagesFrameworkNotes(HELP) for help info.'
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260723. Run %SasPackagesFrameworkNotes(HELP) for help info.'
;
%local list N i element;
%let list=
@@ -94,6 +94,7 @@ relocatePackage
isPackagesFilerefOK
bundlePackages
unbundlePackages
requestPackage
/**/
SasPackagesFrameworkNotes
;
@@ -115,7 +116,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 `20260617` #;
%put # Macro prints help notes for SAS Packages Framework macros, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -133,6 +134,12 @@ SasPackagesFrameworkNotes
%put # allowed too. In such case ALL help notes are printed #;
%put # If equal `HELP` displays this help information. #;
%put # If empty displays list of SPF macros. #;
%put # If equal `VERSION`, `VER`, or just `V` returns (in #;
%put # a function stule) version number, but since the macro #;
%put # is compiled as "secure" it **cannot** be called through #;
%put # the `%nrstr(%%put)` statement. Direct assignment to a #;
%put # macrovariable has to be executed, e.g., #;
%put # `%nrstr(%%let version = %%SasPackagesFrameworkNotes(V);)` #;
%put # #;
%put #-------------------------------------------------------------------------------#;
%put # #;
@@ -161,25 +168,37 @@ SasPackagesFrameworkNotes
%put %nrstr( %%SasPackagesFrameworkNotes(generatePackage helpPackage) );
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
%put # #;
%put ### Example 4 ###################################################################;
%put # #;
%put # Run the following code to get SPF version: #;
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas;
%put %nrstr( %%let version = %%SasPackagesFrameworkNotes(V); );
%put %nrstr( %%put &=version; );
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
%put # #;
%put #################################################################################;
%put ;
%put ;
options &options_tmp.;
%GOTO ENDofSPFNotes;
%end;
%if %sysevalf(%superq(SPFmacroName)=,boolean) %then
%do;
%put ================================================================;
%put %str( ) SAS Packages Framework provides the following macros:;
%put ================================================================;
%put =================================================================================;
%put %str( ) SAS Packages Framework (version 20260723) provides the following macros:;
%put =================================================================================;
%do i = 1 %to &N.;
%let element = %scan(&list., &i.);
%if &i. IN (3 6 9 10 12) %then %put %str( );
%if &i. > 9 %then %put %str( )&i.. %NRSTR(%%)&element.();
%else %put %str( )&i.. %NRSTR(%%)&element.();
%end;
%put =================================================================;
%put =================================================================================;
%end;
/* return version number */
%else %if (%qupcase(&SPFmacroName.) in (VERSION VER V)) %then %do;20260723%return;%end;
%else %if %str(*) IN (%superq(SPFmacroName)) %then
%do;
%do i = 1 %to &N.;
@@ -225,6 +244,9 @@ options mlogic symbolgen;
%SasPackagesFrameworkNotes(generatePackage helpPackage)
%SasPackagesFrameworkNotes(generatePackage helpPackages SasPackagesFrameworkNotes isPackagesFilerefOK)
%SasPackagesFrameworkNotes(*)
%let x = %SasPackagesFrameworkNotes(VER);
%put &=x.;
*/
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -66,7 +66,7 @@ Contributors:
%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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside selected SPF macros. Macro generates 4GL code that forces V7 compatibility for user provided data set names. Version 20260723.';
/* The macro can be called only inside a data step. */
/****************************************************************************
### Parameters:
@@ -103,7 +103,7 @@ des='SAS Packages Framework internal macro. Executable only inside selected SPF
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
%macro A(ods);
data _null_;
%SPDinit_intrnl_forceV7DSname(ods);
%SPFinit_intrnl_forceV7DSname(ods);
call symputX("ods",ods,"L");
run;
+4 -4
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -64,7 +64,7 @@ Contributors:
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -64,7 +64,7 @@ Contributors:
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
@@ -176,7 +176,7 @@ data &filesWithCodes.markdown;
%end;
put " " / "---------------------------------------------------------------------" / " "
/ "*SAS package generated by SAS Package Framework, version `20260617`,*"
/ "*SAS package generated by SAS Package Framework, version `20260723`,*"
/ "*under `&sysscp.`(`&sysscpl.`) operating system,*"
/ "*using SAS release: `&sysvlong4.`.*"
/ " " / "---------------------------------------------------------------------" / " ";
+4 -4
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -64,7 +64,7 @@ Contributors:
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
+8 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -72,7 +72,7 @@ Contributors:
,nobs=0 /* technical parameter */
)
/*** HELP END ***/
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260617. Run %splitCodeForPackage(HELP) for help info.'
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260723. Run %splitCodeForPackage(HELP) for help info.'
;
%if (%superq(codeFile) = ) OR (%qupcase(&codeFile.) = HELP) %then
%do;
@@ -80,15 +80,16 @@ Contributors:
%let options_tmp = ls=%sysfunc(getoption(ls)) ps=%sysfunc(getoption(ps))
%sysfunc(getoption(notes)) %sysfunc(getoption(source))
msglevel=%sysfunc(getoption(msglevel))
%sysfunc(getoption(mprint)) %sysfunc(getoption(mlogic)) %sysfunc(getoption(symbolgen))
;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N NOmprint NOmlogic NOsymbolgen;
%put ;
%put #################################################################################;
%put ### This is short help information for the `splitCodeForPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Utility macro to *split* single file with SAS package code into multiple #;
%put # files with separate snippets, version `20260617` #;
%put # files with separate snippets, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -464,7 +465,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 20260617. */';
put '/* File generated with help of SAS Packages Framework, version 20260723. */';
firstLine[j]=0;
end;
put _infile_;
+7 -7
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -74,7 +74,7 @@ Contributors:
,verify=0
,quiet=0
)/
des='Macro to extract a bundle of SAS packages, version 20260617. Run %unbundlePackages(HELP) for help info.'
des='Macro to extract a bundle of SAS packages, version 20260723. Run %unbundlePackages(HELP) for help info.'
secure
minoperator
;
@@ -92,7 +92,7 @@ minoperator
%put ### This is short help information for the `unbundlePackages` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *extract* SAS packages from a bundle, version `20260617` #;
%put # Macro to *extract* SAS packages from a bundle, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -382,7 +382,7 @@ else
end;
rc = Q.output(dataset: /* create propper tag */
rc = Q.output(dataset: /* create proper tag */
%if %superq(ods) NE %then %do; "&ods.(label='Bundle: " !! strip(bundleName) !! "')" %end;
%else %do; "&reportFile.1" %end;
);
@@ -439,7 +439,7 @@ rc = doSubL(
stop;
run;
/*===================================================================================================*/
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
+5 -5
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -84,7 +84,7 @@ Contributors:
*/
)/secure
/*** HELP END ***/
des = 'Macro to unload SAS package, version 20260617. Run %unloadPackage(HELP) for help info.'
des = 'Macro to unload SAS package, version 20260723. Run %unloadPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -99,7 +99,7 @@ des = 'Macro to unload SAS package, version 20260617. Run %unloadPackage(HELP) f
%put ### This is short help information for the `unloadPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to unload SAS packages, version `20260617` #;
%put # Macro to unload SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
+10 -10
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -77,7 +77,7 @@ Contributors:
hashing_file() function, SAS 9.4M6 */
)/secure
/*** HELP END ***/
des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %verifyPackage(HELP) for help info.'
des = 'Macro to verify SAS package with the hash digest, version 20260723. Run %verifyPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -92,7 +92,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
%put ### This is short help information for the `verifyPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to verify SAS package with it hash digest, version `20260617` #;
%put # Macro to verify SAS package with it hash digest, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -223,10 +223,10 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
length method $ 8 digest $ 128;
/* calculate SHA256 */
method="SHA256";
LINK CalcualteHashDigest; /* go to Link 1 */
LINK CalculateHashDigest; /* go to Link 1 */
if NOT emptyHash then
do; /* step for veryfication */
do; /* step for verification */
if upcase(digest) = upcase(providedHash) then
do;
put "NOTE: Verification SUCCESSFUL."
@@ -245,13 +245,13 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
end;
end;
else
do method = "SHA1", "MD5"; /* step for digest display, calcualte also SHA1 and MD5 */
LINK CalcualteHashDigest; /* go to Link 1 */
do method = "SHA1", "MD5"; /* step for digest display, calculate also SHA1 and MD5 */
LINK CalculateHashDigest; /* go to Link 1 */
end;
put 82*"-" /;
stop;
return;
CalcualteHashDigest: /* Link 1 */
CalculateHashDigest: /* Link 1 */
select;
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
+37 -29
View File
@@ -1,7 +1,7 @@
---
# SAS Packages Framework, version `20260615`
# SAS Packages Framework, version `20260723`
---
@@ -35,7 +35,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 **`20260615`**.
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20260723`**.
**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).
@@ -58,7 +58,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 `20260615`
Macro to install SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -160,7 +160,7 @@ them using the SPF can be found [**HERE**](https://github.com/yabwon/HoW-SASPack
`managing-your-personal-access-tokens`
`#creating-a-fine-grained-personal-access-token`
(lines break added for easier reading)
Public repos do not need authentication.
Public repositories do not need authentication.
[NOTE!] This feature is experimental in this release.
--------------------------------------------------------------------------------------------
@@ -211,7 +211,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 `20260615`
Macro to get help about SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -289,7 +289,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 `20260615`
Macro to *load* SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -447,7 +447,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 `20260615`
Macro wrapper for the loadPackage macro, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -499,7 +499,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 `20260615`
Macro to unload SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -566,7 +566,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 `20260615`
Macro to list available SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -615,7 +615,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
## This is short help information for the `verifyPackage` macro <a name="verifypackage"></a>
-------------------------------------------------------------------------------
Macro to verify SAS package with it hash digest, version `20260615`
Macro to verify SAS package with it hash digest, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -671,7 +671,7 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
## This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
-------------------------------------------------------------------------------
Macro to get preview of a SAS packages, version `20260615`
Macro to get preview of a SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -740,7 +740,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 `20260615`
Macro to generate SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -796,8 +796,8 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
if null (the default) then the `!SASROOT` is used.
- `sascfgFile=` Location of a FILE with testing session configuration
parameters, if null (the default) then no config file
is pointed during the SAS invocation,
parameters, if null (the default) then no configuration
file is pointed during the SAS invocation,
if set to `DEF` then the `!SASROOT/sasv9.cfg` is used.
- `delTestWork=` Indicates if `WORK` directories generated by user tests
@@ -973,7 +973,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 `20260615`
Macro to list directories pointed by 'packages' fileref, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1015,7 +1015,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 `20260615`
Macro to load *additional content* for a SAS package, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1111,7 +1111,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
--------------------------------------------------------------------------------------------
Macro to request (install and load) SAS packages, version `20260615`
Macro to request (install and load) SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1208,7 +1208,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
managing-your-personal-access-tokens
#creating-a-fine-grained-personal-access-token`
(lines break added for easier reading)
Public repos do not need authentication.
Public repositories do not need authentication.
[NOTE!] This feature is experimental in this release.
**Loading options:**
@@ -1271,7 +1271,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 `20260615`
files with separate snippets, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1352,7 +1352,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 `20260615`
Macro to *locally copy or move* (relocate) SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1464,7 +1464,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 `20260615`
Macro to check if the `packages` fileref is "correct", version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1481,6 +1481,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
1. `vERRb` - *Optional* Indicates if the macro should return value AND be verbose
(e.g., print errors and notes) or just return value.
`1` means "verbose", `0` means "quiet".
When used as: `%isPackagesFilerefOK(HELP)` it displays this help information.
@@ -1515,7 +1516,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 `20260615`
Macro prints help notes for SAS Packages Framework macros, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1528,11 +1529,18 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
-------------------------------------------------------------------------------
### Parameters:
1. `SPFmacroName` *Required.* Names of a SPF components.
Names should be space separated, asterisk(*) is
allowed too. In such case ALL help notes are printed
If equal `HELP` displays this help information.
If empty displays list of SPF macros.
1. `SPFmacroName` *Required.* Names of a SPF components.
Names should be space separated, asterisk(*) is
allowed too. In such case ALL help notes are printed
If equal `HELP` displays this help information.
If empty displays list of SPF macros.
If equal `VERSION`, `VER`, or just `V` returns (in
a function stule) version number, but since the macro
is compiled as "secure" it **cannot** be called through
the `%put` statement. Direct assignment to a
macrovariable has to be executed, e.g.,
`%let version = %SasPackagesFrameworkNotes(V);`
-------------------------------------------------------------------------------
@@ -1565,7 +1573,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 `20260615`
Macro to *create bundles* of SAS packages, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1634,7 +1642,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 `20260615`
Macro to *extract* SAS packages from a bundle, version `20260723`
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
+185 -156
View File
@@ -32,8 +32,8 @@
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.
*/
/**#############################################################################**/
*/
/**############################################################################**/
/*** HELP START ***/
/* SPF (SAS Packages Framework) is a set of macros:
@@ -43,7 +43,7 @@
- to unload, or
- to generate SAS packages.
SAS Packages Framework, version 20260617.
SAS Packages Framework, version 20260723.
See examples below.
A SAS package is a zip file containing a group of files
@@ -101,7 +101,7 @@ Contributors:
, force=0 /* force loading even if given version is already loaded */
)/secure
/*** HELP END ***/
des = 'Macro to load SAS package, version 20260617. Run %loadPackage(HELP) for help info.'
des = 'Macro to load SAS package, version 20260723. Run %loadPackage(HELP) for help info.'
minoperator
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -117,7 +117,7 @@ minoperator
%put ### This is short help information for the `loadPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *load* SAS packages, version `20260617` #;
%put # Macro to *load* SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -313,7 +313,7 @@ minoperator
%if %superq(rVsign)= %then %let rVsign=<=;
%else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then
%do;
%put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING- Supported operators are: %str(= <= =< => >= < >);
%let rVsign=<=;
%end;
@@ -384,7 +384,7 @@ minoperator
%else
%do;
%put NOTE- %str( );
%put NOTE: It looks like the &packageName.(&pLV0.) package already loaded! Nothing to do.;
%put NOTE: It looks like the &packageName.(&pLV0.) package is already loaded! Nothing to do.;
%put NOTE- To force reloading use the force=1;
/* if package is already loaded with req version. */
%put NOTE- %str( );
@@ -432,7 +432,7 @@ minoperator
*/
)/secure
/*** HELP END ***/
des = 'Macro to unload SAS package, version 20260617. Run %unloadPackage(HELP) for help info.'
des = 'Macro to unload SAS package, version 20260723. Run %unloadPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -447,7 +447,7 @@ des = 'Macro to unload SAS package, version 20260617. Run %unloadPackage(HELP) f
%put ### This is short help information for the `unloadPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to unload SAS packages, version `20260617` #;
%put # Macro to unload SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -605,7 +605,7 @@ des = 'Macro to unload SAS package, version 20260617. Run %unloadPackage(HELP) f
*/
)/secure
/*** HELP END ***/
des = 'Macro to get help about SAS package, version 20260617. Run %helpPackage(HELP) for help info.'
des = 'Macro to get help about SAS package, version 20260723. Run %helpPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -620,7 +620,7 @@ des = 'Macro to get help about SAS package, version 20260617. Run %helpPackage(H
%put ### This is short help information for the `helpPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to get help about SAS packages, version `20260617` #;
%put # Macro to get help about SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -765,7 +765,7 @@ TODO:
*/
/*+installPackage+*/
/* Macros to install SAS packages, version 20260617 */
/* Macros to install SAS packages, version 20260723 */
/* 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
@@ -790,13 +790,13 @@ TODO:
, 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 = /* 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 */
, githubToken = /* user 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 20260617. Run %installPackage(HELP) for help info.'
des = 'Macro to install SAS package, version 20260723. Run %installPackage(HELP) for help info.'
;
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
%do;
@@ -811,7 +811,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%put ### This is short help information for the `installPackage` macro #;
%put #--------------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to install SAS packages, version `20260617` #;
%put # Macro to install SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -914,7 +914,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%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 # Public repositories do not need authentication. #;
%put # [NOTE!] This feature is experimental in this release. #;
%put # #;
%put #--------------------------------------------------------------------------------------------#;
@@ -1194,7 +1194,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%if (%superq(URLuser) ne ) %then
%do;
user = "&URLuser."
pass = "&URLuser."
pass = "&URLpass."
%end;
&URLoptions.
recfm=N lrecl=1;
@@ -1204,7 +1204,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
%if (%superq(URLuser) ne ) %then
%do;
user = "&URLuser."
pass = "&URLuser."
pass = "&URLpass."
%end;
&URLoptions.
recfm=N lrecl=1;
@@ -1691,7 +1691,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
Macro to list SAS packages in packages folder.
Version 20260617
Version 20260723
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1713,7 +1713,7 @@ des = 'Macro to install SAS package, version 20260617. Run %installPackage(HELP)
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 20260617.'
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260723.'
;
%if (%QUPCASE(&listDataSet.) = HELP) %then
%do;
@@ -1728,7 +1728,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 `20260617` #;
%put # Macro to list available SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -1957,7 +1957,7 @@ options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
Macro to generate SAS packages.
Version 20260617
Version 20260723
A SAS package is a zip file containing a group
of SAS codes (macros, functions, data steps generating
@@ -1985,7 +1985,7 @@ options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
if null (the default) the WORK is used */
,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
,testWorkPath= /* location where tests SAS session work directories
should be stored, if null (the default) the main SAS
session WORK is used. Takes precedence over workInTestResults= */
,sasexe= /* a DIRECTORY where the SAS binary is located,
@@ -2007,7 +2007,7 @@ options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
when empty takes buildLocation */
)/ secure minoperator
/*** HELP END ***/
des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HELP) for help info.'
des = 'Macro to generate SAS packages, version 20260723. Run %generatePackage(HELP) for help info.'
;
%if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
%do;
@@ -2022,7 +2022,7 @@ des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HE
%put ### This is short help information for the `generatePackage` macro #;
%put #------------------------------------------------------------------------------------#;
%put # #;
%put # Macro to generate SAS packages, version `20260617` #;
%put # Macro to generate SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -2079,8 +2079,8 @@ des = 'Macro to generate SAS packages, version 20260617. Run %generatePackage(HE
%put # if null (the default) then the `!SASROOT` is used. #;
%put # #;
%put # - `sascfgFile=` Location of a FILE with testing session configuration #;
%put # parameters, if null (the default) then no config file #;
%put # is pointed during the SAS invocation, #;
%put # parameters, if null (the default) then no configuration #;
%put # file is pointed during the SAS invocation, #;
%put # if set to `DEF` then the `!SASROOT/sasv9.cfg` is used. #;
%put # #;
%put # - `delTestWork=` Indicates if `WORK` directories generated by user tests #;
@@ -2402,7 +2402,8 @@ data _null_;
/* test if version is a number */
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
v = "&packageVersion.";
length v $ 64;
v = symget("packageVersion");
version = coalesce(input(scan(v,1,".","M"), ?? best32.),0)*1e8
+ coalesce(input(scan(v,2,".","M"), ?? best32.),0)*1e4
+ coalesce(input(scan(v,3,".","M"), ?? best32.),0)*1e0
@@ -2410,7 +2411,7 @@ data _null_;
if not (version > 0) then
do;
put 'ERROR: Package version should be a positive NUMBER.'
/ 'ERROR- Current value is: ' "&packageVersion."
/ 'ERROR- Current value is: ' v
/ 'ERROR- Try something small, e.g. 0.1'
/ 'ERROR- Aborting.';
put;
@@ -2904,7 +2905,7 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
title&_titleNumber_. "Package ZIP file location is: &buildLocation.";
%end;
footnote1 "SAS Packages Framework, version 20260617";
footnote1 "SAS Packages Framework, version 20260723";
proc print
data = &filesWithCodes.(drop=base build folderRef fileRef rc folderid _abort_ fileId additionalContent)
@@ -3085,20 +3086,20 @@ data _null_;
/ ' %let pV = %sysevalf((%scan(&pV0.,1,.,M)+0)*1e8 '
/ ' + (%scan(&pV0.,2,.,M)+0)*1e4 '
/ ' + (%scan(&pV0.,3,.,M)+0)*1e0); '
/ ' '
/ ' %let rV0 = %sysfunc(compress(&requiredVersion.,.,kd)); '
/ ' %let rVsign = %sysfunc(compress(&requiredVersion.,<=>,k)); '
/ ' %if %superq(rVsign)= %then %let rVsign=<=; '
/ ' %else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then '
/ ' %do; '
/ ' %put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.; '
/ ' %put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.; '
/ ' %put WARNING- Supported operators are: %str(= <= =< => >= < >); '
/ ' %let rVsign=<=; '
/ ' %end; '
/ ' %let rV = %sysevalf((%scan(&rV0.,1,.,M)+0)*1e8 '
/ ' + (%scan(&rV0.,2,.,M)+0)*1e4 '
/ ' + (%scan(&rV0.,3,.,M)+0)*1e0); '
/ ' '
/ ' %if NOT %sysevalf(&rV. &rVsign. &pV.) %then '
/ ' %do; '
/ ' %put ERROR: Package &packageName. will not be loaded!; '
@@ -3118,8 +3119,8 @@ data _null_;
/ ' %local cherryPick; %let cherryPick=*; '
/ ' %local tempLoad_minoperator; '
/ ' %let tempLoad_minoperator = %sysfunc(getoption(minoperator)); '
/ " "
/ ' %if %superq(suppressExec) NE 1 %then %let suppressExec = 0; '
/ ' %if %sysevalf(%superq(suppressExec) NE 1,boolean) %then %let suppressExec = 0; '
/ ' %include &_PackageFileref_.(load.sas) / &source2.; '
/ ' options &tempLoad_minoperator.; '
/ ' filename &_PackageFileref_. clear; '
@@ -3177,72 +3178,71 @@ data _null_;
or (%superq(packageReqPackages) ne )
%then
%do;
put ' data _null_; '
/ ' call symputX("packageRequiredErrors", 0, "L"); '
/ ' run; ';
put ' data _null_; '
/ ' call symputX("packageRequiredErrors", 0, "L"); '
/ ' run; ';
%end;
%if %superq(packageRequired) ne %then
%if %sysevalf(%superq(packageRequired) ne,boolean) %then
%do;
put ' %put NOTE- *Testing required SAS components*%sysfunc(DoSubL(' /* <- DoSubL() is here */
/ ' options nonotes nosource %str(;) '
/ ' options ls=max ps=max locale=en_US %str(;) '
/ ' /* temporary redirect log */ '
/ ' filename _stinit_ TEMP %str(;) '
/ ' proc printto log = _stinit_ %str(;) run %str(;) '
/ ' /* 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 '
/ ' do %str(;) '
/ ' length req $ 256 %str(;) '
/ ' declare hash R() %str(;) '
/ ' _N_ = R.defineKey("req") %str(;) '
/ ' _N_ = R.defineDone() %str(;) '
/ ' declare hiter iR("R") %str(;) ';
put ' %put NOTE- *Testing required SAS components*%sysfunc(DoSubL(%str(' /* <- DoSubL() is here */
/ ' options nonotes nosource ; '
/ ' options ls=max ps=max locale=en_US ; '
/ ' /* temporary redirect log */ '
/ ' filename _stinit_ TEMP ; '
/ ' proc printto log = _stinit_ ; run ; '
/ ' /* print out setinit */ '
/ ' proc setinit ; run ; '
/ ' proc printto ; run ; '
/ ' options ps=min ; '
/ ' data _null_ ; '
/ ' /* loadup checklist of required SAS components */ '
/ ' if _n_ = 1 then '
/ ' do ; '
/ ' length req $ 256 ; '
/ ' declare hash R() ; '
/ ' _N_ = R.defineKey("req") ; '
/ ' _N_ = R.defineDone() ; '
/ ' declare hiter iR("R") ; ';
length packageRequired $ 32767;
packageRequired = upcase(symget('packageRequired'));
put ' do req = %bquote(' / packageRequired / ') %str(;) '
/ ' _N_ = R.add(key:req,data:req) %str(;) '
/ ' end %str(;) '
/ ' end %str(;) '
/ ' '
/ ' /* read in output from proc setinit */ '
/ ' infile _stinit_ end=eof %str(;) '
/ ' input %str(;) '
/* / ' put "*> " _infile_ %str(;) ' */ /* for testing */
/ ' '
put ' do req = %bquote(' / packageRequired / ') ; '
/ ' _N_ = R.add(key:req,data:req) ; '
/ ' end ; '
/ ' end ; '
/ ' '
/ ' /* read in output from proc setinit */ '
/ ' infile _stinit_ end=eof ; '
/ ' input ; '
/* / ' put "*> " _infile_ ; ' */ /* for testing */
/ ' '
/ ' /* if component is in setinit remove it from checklist */ '
/ ' if _infile_ =: "---" then '
/ ' do %str(;) '
/ ' req = upcase(substr(_infile_, 4, 64)) %str(;) '
/ ' if R.find(key:req) = 0 then '
/ ' do %str(;) '
/ ' _N_ = R.remove() %str(;) '
/ ' end %str(;) '
/ ' end %str(;) '
/ ' '
/ ' /* if checklist is not null rise error */ '
/ ' if eof and R.num_items > 0 then '
/ ' do %str(;) '
/ ' put "WARNING- ###########################################" %str(;) '
/ ' put "WARNING: The following SAS components are missing! " %str(;) '
/ ' call symputX("packageRequiredErrors", 0, "L") %str(;) '
/ ' do while(iR.next() = 0) %str(;) '
/ ' put "WARNING- " req %str(;) '
/ ' end %str(;) '
/ ' put "WARNING: The package may NOT WORK as expected " %str(;) '
/ ' put "WARNING: or even result with ERRORS! " %str(;) '
/ ' put "WARNING- ###########################################" %str(;) '
/ ' put %str(;) '
/ ' end %str(;) '
/ ' run %str(;) '
/ ' filename _stinit_ clear %str(;) '
/ ' options notes source %str(;) '
/ ' ))*; ';
/ ' if _infile_ =: "---" then '
/ ' do ; '
/ ' req = upcase(substr(_infile_, 4, 64)) ; '
/ ' if R.find(key:req) = 0 then '
/ ' do ; '
/ ' _N_ = R.remove() ; '
/ ' end ; '
/ ' end ; '
/ ' '
/ ' /* if checklist is not null rise error */ '
/ ' if eof and R.num_items > 0 then '
/ ' do ; '
/ ' put "WARNING- ###########################################" ; '
/ ' put "WARNING: The following SAS components are missing! " ; '
/ ' call symputX("packageRequiredErrors", 0, "L") ; '
/ ' do while(iR.next() = 0) ; '
/ ' put "WARNING- " req ; '
/ ' end ; '
/ ' put "WARNING: The package may NOT WORK as expected " ; '
/ ' put "WARNING: or even result with ERRORS! " ; '
/ ' put "WARNING- ###########################################" ; '
/ ' put ; '
/ ' end ; '
/ ' run ; '
/ ' filename _stinit_ clear ; '
/ ' options notes source ; '
/ ' )))*; ';
%end;
%if %superq(packageReqPackages) ne %then
@@ -3729,7 +3729,7 @@ data _null_;
%end;
put +(-1) '`.;'''
/ ' !! '' %put The macro generated: '' !! put(dtCASLudf, E8601DT19.-L) !! ";"'
/ ' !! '' %put with the SAS Packages Framework version 20260617.;'''
/ ' !! '' %put with the SAS Packages Framework version 20260723.;'''
/ ' !! '' %put ****************************************************************************;'''
/ ' !! '' %GOTO theEndOfTheMacro;'''
/ ' !! '' %end;''' ;
@@ -3893,7 +3893,7 @@ data _null_;
%end;
put +(-1) '`.; '' !!' /
''' %put The macro generated: ''' " !! put(dtIML, E8601DT19.-L) !! " '''; '' !! ' /
''' %put with the SAS Packages Framework version 20260617.; '' !! ' /
''' %put with the SAS Packages Framework version 20260723.; '' !! ' /
''' %put ****************************************************************************; '' !! ' /
''' %GOTO theEndOfTheMacro; '' !! ' /
''' %end; '' !! ' /
@@ -4765,7 +4765,7 @@ data _null_;
%end;
put 'put " " / @3 "---------------------------------------------------------------------" / " ";'
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260617`*";'
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260723`*";'
/ "put @3 '*under `&sysscp.`(`&sysscpl.`) operating system,*';"
/ "put @3 '*using SAS release: `&sysvlong4.`.*';"
/ 'put " " / @3 "---------------------------------------------------------------------";';
@@ -4929,6 +4929,7 @@ data _null_;
call execute(' rc = fcopy("_SPFIN_", "_SPFOUT_");');
call execute(' ex = fexist("_SPFOUT_"); Try + 1;');
call execute(' put Try= " File existence in ZIP verified as: " ex;');
call execute(' rc = sleep(^ex, 0.25);'); /* wait 0.25 sec if not copied successfully */
call execute(' end ;');
call execute(' if ex then put "File " pathname "copied into the package with return code: " rc "(0 = success)";');
@@ -5204,7 +5205,7 @@ options &qlenmax_fstimer_tmp.;
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
@@ -5886,7 +5887,7 @@ options &quotelenmax_tmp.;
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
@@ -5998,7 +5999,7 @@ data &filesWithCodes.markdown;
%end;
put " " / "---------------------------------------------------------------------" / " "
/ "*SAS package generated by SAS Package Framework, version `20260617`,*"
/ "*SAS package generated by SAS Package Framework, version `20260723`,*"
/ "*under `&sysscp.`(`&sysscpl.`) operating system,*"
/ "*using SAS release: `&sysvlong4.`.*"
/ " " / "---------------------------------------------------------------------" / " ";
@@ -6139,7 +6140,7 @@ options &MarkDownOptionsTmp.;
/*+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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260723.';
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
%do;
@@ -6306,7 +6307,7 @@ TODO: (in Polish)
*/
)/secure
/*** HELP END ***/
des = 'Macro to load multiple SAS packages at one run, version 20260617. Run %loadPackages(HELP) for help info.'
des = 'Macro to load multiple SAS packages at one run, version 20260723. Run %loadPackages(HELP) for help info.'
parmbuff
;
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
@@ -6322,7 +6323,7 @@ parmbuff
%put ### This is short help information for the `loadPackageS` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro wrapper for the loadPackage macro, version `20260617` #;
%put # Macro wrapper for the loadPackage macro, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -6420,7 +6421,7 @@ parmbuff
hashing_file() function, SAS 9.4M6 */
)/secure
/*** HELP END ***/
des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %verifyPackage(HELP) for help info.'
des = 'Macro to verify SAS package with the hash digest, version 20260723. Run %verifyPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -6435,7 +6436,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
%put ### This is short help information for the `verifyPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to verify SAS package with it hash digest, version `20260617` #;
%put # Macro to verify SAS package with it hash digest, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -6566,10 +6567,10 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
length method $ 8 digest $ 128;
/* calculate SHA256 */
method="SHA256";
LINK CalcualteHashDigest; /* go to Link 1 */
LINK CalculateHashDigest; /* go to Link 1 */
if NOT emptyHash then
do; /* step for veryfication */
do; /* step for verification */
if upcase(digest) = upcase(providedHash) then
do;
put "NOTE: Verification SUCCESSFUL."
@@ -6588,13 +6589,13 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
end;
end;
else
do method = "SHA1", "MD5"; /* step for digest display, calcualte also SHA1 and MD5 */
LINK CalcualteHashDigest; /* go to Link 1 */
do method = "SHA1", "MD5"; /* step for digest display, calculate also SHA1 and MD5 */
LINK CalculateHashDigest; /* go to Link 1 */
end;
put 82*"-" /;
stop;
return;
CalcualteHashDigest: /* Link 1 */
CalculateHashDigest: /* Link 1 */
select;
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
@@ -6651,7 +6652,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260617. Run %
*/
)/secure
/*** HELP END ***/
des = 'Macro to preview content of a SAS package, version 20260617. Run %previewPackage(HELP) for help info.'
des = 'Macro to preview content of a SAS package, version 20260723. Run %previewPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
%do;
@@ -6666,7 +6667,7 @@ des = 'Macro to preview content of a SAS package, version 20260617. Run %preview
%put ### This is short help information for the `previewPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to get preview of a SAS packages, version `20260617` #;
%put # Macro to get preview of a SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -6800,7 +6801,7 @@ des = 'Macro to preview content of a SAS package, version 20260617. Run %preview
when empty the "packages" value is used */
)/secure
/*** HELP END ***/
des = 'Macro to list directories pointed by "packages" fileref, version 20260617. Run %extendPackagesFileref(HELP) for help info.'
des = 'Macro to list directories pointed by "packages" fileref, version 20260723. Run %extendPackagesFileref(HELP) for help info.'
;
%if %QUPCASE(&packages.) = HELP %then
@@ -6816,7 +6817,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20260617
%put ### This is short help information for the `extendPackagesFileref` macro #;
%put #-----------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to list directories pointed by 'packages' fileref, version `20260617` #;
%put # Macro to list directories pointed by 'packages' fileref, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -6918,7 +6919,7 @@ filename packages list;
is provided in required version */
)/secure
/*** HELP END ***/
des = 'Macro to load additional content for a SAS package, version 20260617. Run %loadPackageAddCnt(HELP) for help info.'
des = 'Macro to load additional content for a SAS package, version 20260723. Run %loadPackageAddCnt(HELP) for help info.'
minoperator
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -6934,7 +6935,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 `20260617` #;
%put # Macro to *load* additional content for a SAS package, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -7071,7 +7072,7 @@ minoperator
%if %superq(rVsign)= %then %let rVsign=<=;
%else %if NOT (%superq(rVsign) IN (%str(=) %str(<=) %str(=<) %str(=>) %str(>=) %str(<) %str(>))) %then
%do;
%put WARNING: Illegal operatopr "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING: Illegal operator "%superq(rVsign)"! Default(<=) will be used.;
%put WARNING- Supported operators are: %str(= <= =< => >= < >);
%let rVsign=<=;
%end;
@@ -7284,7 +7285,7 @@ minoperator
%WrongVersionOFPackageAddCnt:
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
@@ -7305,7 +7306,7 @@ minoperator
,nobs=0 /* technical parameter */
)
/*** HELP END ***/
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260617. Run %splitCodeForPackage(HELP) for help info.'
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260723. Run %splitCodeForPackage(HELP) for help info.'
;
%if (%superq(codeFile) = ) OR (%qupcase(&codeFile.) = HELP) %then
%do;
@@ -7313,15 +7314,16 @@ minoperator
%let options_tmp = ls=%sysfunc(getoption(ls)) ps=%sysfunc(getoption(ps))
%sysfunc(getoption(notes)) %sysfunc(getoption(source))
msglevel=%sysfunc(getoption(msglevel))
%sysfunc(getoption(mprint)) %sysfunc(getoption(mlogic)) %sysfunc(getoption(symbolgen))
;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N NOmprint NOmlogic NOsymbolgen;
%put ;
%put #################################################################################;
%put ### This is short help information for the `splitCodeForPackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Utility macro to *split* single file with SAS package code into multiple #;
%put # files with separate snippets, version `20260617` #;
%put # files with separate snippets, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -7697,7 +7699,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 20260617. */';
put '/* File generated with help of SAS Packages Framework, version 20260723. */';
firstLine[j]=0;
end;
put _infile_;
@@ -7730,7 +7732,7 @@ options &options_tmp2.;
,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 20260617. Run %relocatePackage(HELP) for help info.'
/ des = 'Utility macro that locally Copies or Moves Packages, version 20260723. Run %relocatePackage(HELP) for help info.'
secure
minoperator
;
@@ -7748,7 +7750,7 @@ options &options_tmp2.;
%put ### This is short help information for the `relocatePackage` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260617` #;
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -7946,7 +7948,7 @@ options &options_tmp2.;
%do;
if NOT (input(resolve('%isPackagesFilerefOK(&debug.)'), best.)=1) then /* if debug=1 the isPackagesFilerefOK in verbose mode */
do;
putlog "WARNING: The PACKAGES fileres is not OK! Exiting!";
putlog "WARNING: The PACKAGES fileref is not OK! Exiting!";
LINK stopProcessing;
end;
%end;
@@ -8332,7 +8334,7 @@ options &options_tmp2.;
run;
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
@@ -8413,7 +8415,7 @@ filename PACKAGES ("R:\testPackages2" "R:\testPackages1");
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 20260617.'
des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260723.'
;
/*** HELP END ***/
%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
@@ -8422,14 +8424,15 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%let options_tmp = ls=%sysfunc(getoption(ls)) ps=%sysfunc(getoption(ps))
%sysfunc(getoption(notes)) %sysfunc(getoption(source))
msglevel=%sysfunc(getoption(msglevel))
%sysfunc(getoption(mprint)) %sysfunc(getoption(mlogic)) %sysfunc(getoption(symbolgen))
;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N;
options NOnotes NOsource ls=MAX ps=MAX msglevel=N NOmprint NOmlogic NOsymbolgen;
%put ;
%put ###########################################################################################;
%put ### This is short help information for the `isPackagesFilerefOK` macro #;
%put #-----------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to check if the `packages` fileref is "correct", version `20260617` #;
%put # Macro to check if the `packages` fileref is "correct", version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -8446,6 +8449,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%put # #;
%put # 1. `vERRb` - *Optional* Indicates if the macro should return value AND be verbose #;
%put # (e.g., print errors and notes) or just return value. #;
%put # `1` means "verbose", `0` means "quiet". #;
%put # #;
%put # When used as: `%nrstr(%%isPackagesFilerefOK(HELP))` it displays this help information. #;
%put # #;
@@ -8482,6 +8486,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%GOTO ENDofIsPackagesFilerefOK;
%end;
%if %sysevalf(%superq(vERRb)=,boolean) %then %let vERRb = 0;
%if NOT (%superq(vERRb) in (0 1)) %then %let vERRb = 0;
%local isPackagesFilerefOK;
@@ -8494,17 +8499,19 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%if &nobs. AND 1=&vERRb. %then %put INFO: PACKAGES fileref is: %sysfunc(pathname(PACKAGES));
%let isPackagesFilerefOK=%sysevalf(&nobs. AND 1, boolean);
%let isPackagesFilerefOK=%sysevalf(&nobs. AND 1, boolean);
%do i = 1 %to &nobs.;
%let rc=%sysfunc(FETCHOBS(&dsid., &i.));
%let XENGINE=%sysfunc(GETVARC(&dsid., %sysfunc(VARNUM(&dsid., XENGINE))));
%let XPATH=%sysfunc(GETVARC(&dsid., %sysfunc(VARNUM(&dsid., XPATH))));
%put %superq(XENGINE) %superq(XPATH);
%if 1=&vERRb. %then
%put %superq(XENGINE) %superq(XPATH);
%if DISK ne %superq(XENGINE) %then
%do;
%let isPackagesFilerefOK=0;
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * 0);
%if 1=&vERRb. %then
%do;
%if %superq(XENGINE) = SASFSVAM %then %let XENGINE= FILESRVC (SASFSVAM);
@@ -8513,7 +8520,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%end;
%else %if 0=%sysfunc(fileexist(%superq(XPATH))) %then
%do;
%let isPackagesFilerefOK=0;
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * 0);
%if 1=&vERRb. %then
%do;
%put ERROR: Path: %superq(XPATH) does NOT exist!;
@@ -8523,7 +8530,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
%do;
%let rc = %sysfunc(FILENAME(_F_, %superq(XPATH)));
%let dirid = %sysfunc(DOPEN(&_F_.));
%let isPackagesFilerefOK=%sysevalf(&dirid. AND 1, boolean);
%let isPackagesFilerefOK=%eval(&isPackagesFilerefOK. * %sysevalf(&dirid. AND 1, boolean));
%let dirid = %sysfunc(DCLOSE(&dirid.));
%let rc = %sysfunc(FILENAME(_F_));
%if 1=&vERRb. AND 0=&isPackagesFilerefOK. %then
@@ -8563,7 +8570,7 @@ SPFmacroName /* space separated list of names */
/
minoperator
secure
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260617. Run %SasPackagesFrameworkNotes(HELP) for help info.'
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260723. Run %SasPackagesFrameworkNotes(HELP) for help info.'
;
%local list N i element;
%let list=
@@ -8588,6 +8595,7 @@ relocatePackage
isPackagesFilerefOK
bundlePackages
unbundlePackages
requestPackage
/**/
SasPackagesFrameworkNotes
;
@@ -8609,7 +8617,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 `20260617` #;
%put # Macro prints help notes for SAS Packages Framework macros, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -8627,6 +8635,12 @@ SasPackagesFrameworkNotes
%put # allowed too. In such case ALL help notes are printed #;
%put # If equal `HELP` displays this help information. #;
%put # If empty displays list of SPF macros. #;
%put # If equal `VERSION`, `VER`, or just `V` returns (in #;
%put # a function stule) version number, but since the macro #;
%put # is compiled as "secure" it **cannot** be called through #;
%put # the `%nrstr(%%put)` statement. Direct assignment to a #;
%put # macrovariable has to be executed, e.g., #;
%put # `%nrstr(%%let version = %%SasPackagesFrameworkNotes(V);)` #;
%put # #;
%put #-------------------------------------------------------------------------------#;
%put # #;
@@ -8655,25 +8669,37 @@ SasPackagesFrameworkNotes
%put %nrstr( %%SasPackagesFrameworkNotes(generatePackage helpPackage) );
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
%put # #;
%put ### Example 4 ###################################################################;
%put # #;
%put # Run the following code to get SPF version: #;
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas;
%put %nrstr( %%let version = %%SasPackagesFrameworkNotes(V); );
%put %nrstr( %%put &=version; );
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
%put # #;
%put #################################################################################;
%put ;
%put ;
options &options_tmp.;
%GOTO ENDofSPFNotes;
%end;
%if %sysevalf(%superq(SPFmacroName)=,boolean) %then
%do;
%put ================================================================;
%put %str( ) SAS Packages Framework provides the following macros:;
%put ================================================================;
%put =================================================================================;
%put %str( ) SAS Packages Framework (version 20260723) provides the following macros:;
%put =================================================================================;
%do i = 1 %to &N.;
%let element = %scan(&list., &i.);
%if &i. IN (3 6 9 10 12) %then %put %str( );
%if &i. > 9 %then %put %str( )&i.. %NRSTR(%%)&element.();
%else %put %str( )&i.. %NRSTR(%%)&element.();
%end;
%put =================================================================;
%put =================================================================================;
%end;
/* return version number */
%else %if (%qupcase(&SPFmacroName.) in (VERSION VER V)) %then %do;20260723%return;%end;
%else %if %str(*) IN (%superq(SPFmacroName)) %then
%do;
%do i = 1 %to &N.;
@@ -8719,6 +8745,9 @@ options mlogic symbolgen;
%SasPackagesFrameworkNotes(generatePackage helpPackage)
%SasPackagesFrameworkNotes(generatePackage helpPackages SasPackagesFrameworkNotes isPackagesFilerefOK)
%SasPackagesFrameworkNotes(*)
%let x = %SasPackagesFrameworkNotes(VER);
%put &=x.;
*/
@@ -8732,7 +8761,7 @@ options mlogic symbolgen;
,packagesRef=packages
,ods= /* data set for report file */
)/
des='Macro to create a bundle of SAS packages, version 20260617. Run %bundlePackages(HELP) for help info.'
des='Macro to create a bundle of SAS packages, version 20260723. Run %bundlePackages(HELP) for help info.'
secure minoperator
;
@@ -8749,7 +8778,7 @@ secure minoperator
%put ### This is short help information for the `bundlePackages` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *create bundles* of SAS packages, version `20260617` #;
%put # Macro to *create bundles* of SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -9150,7 +9179,7 @@ run;
/*===================================================================================================*/
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
@@ -9243,7 +9272,7 @@ filename p2 "R:/dontexist";
,verify=0
,quiet=0
)/
des='Macro to extract a bundle of SAS packages, version 20260617. Run %unbundlePackages(HELP) for help info.'
des='Macro to extract a bundle of SAS packages, version 20260723. Run %unbundlePackages(HELP) for help info.'
secure
minoperator
;
@@ -9261,7 +9290,7 @@ minoperator
%put ### This is short help information for the `unbundlePackages` macro #;
%put #-------------------------------------------------------------------------------#;
%put # #;
%put # Macro to *extract* SAS packages from a bundle, version `20260617` #;
%put # Macro to *extract* SAS packages from a bundle, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -9551,7 +9580,7 @@ else
end;
rc = Q.output(dataset: /* create propper tag */
rc = Q.output(dataset: /* create proper tag */
%if %superq(ods) NE %then %do; "&ods.(label='Bundle: " !! strip(bundleName) !! "')" %end;
%else %do; "&reportFile.1" %end;
);
@@ -9608,7 +9637,7 @@ rc = doSubL(
stop;
run;
/*===================================================================================================*/
/* restore optionos */
/* restore options */
options ls = &ls_tmp. ps = &ps_tmp.
&notes_tmp. &source_tmp.
&stimer_tmp. &fullstimer_tmp.
@@ -9697,7 +9726,7 @@ libname _ "R:\check5";
%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 20260617.';
des='SAS Packages Framework internal macro. Executable only inside selected SPF macros. Macro generates 4GL code that forces V7 compatibility for user provided data set names. Version 20260723.';
/* The macro can be called only inside a data step. */
/****************************************************************************
### Parameters:
@@ -9734,7 +9763,7 @@ des='SAS Packages Framework internal macro. Executable only inside selected SPF
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
%macro A(ods);
data _null_;
%SPDinit_intrnl_forceV7DSname(ods);
%SPFinit_intrnl_forceV7DSname(ods);
call symputX("ods",ods,"L");
run;
@@ -9807,7 +9836,7 @@ des='SAS Packages Framework internal macro. Executable only inside selected SPF
, github = /* name of a user or an organization in GitHub, all characters except [A-z0-9_.-] are compressed */
, githubRepo = /* 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 */
, githubToken = /* user github fine-grained personal access token */
, githubTokenDebug = 0 /* debug values: 0,1,2,3 */
, loadPackage=1 /* should the packages be loaded after installing */
@@ -9816,7 +9845,7 @@ des='SAS Packages Framework internal macro. Executable only inside selected SPF
, successDS= /* technical */
)
/secure
des = 'Macro to request SAS package installation and loading, version 20260617. Run %requestPackage(HELP) for help info.'
des = 'Macro to request SAS package installation and loading, version 20260723. Run %requestPackage(HELP) for help info.'
;
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
@@ -9832,7 +9861,7 @@ des = 'Macro to request SAS package installation and loading, version 20260617.
%put ### This is short help information for the `requestPackage` macro #;
%put #--------------------------------------------------------------------------------------------#;;
%put # #;
%put # Macro to request (install and load) SAS packages, version `20260617` #;
%put # Macro to request (install and load) SAS packages, version `20260723` #;
%put # #;
%put # A SAS package is a zip file containing a group #;
%put # of SAS codes (macros, functions, data steps generating #;
@@ -9929,7 +9958,7 @@ des = 'Macro to request SAS package installation and loading, version 20260617.
%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 # Public repositories do not need authentication. #;
%put # [NOTE!] This feature is experimental in this release. #;
%put # #;
%put # **Loading options:** #;