mirror of
https://github.com/yabwon/SAS_PACKAGES.git
synced 2026-03-10 01:38:19 +00:00
Compare commits
9 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
d7623839b2 | ||
|
|
bf314227dc | ||
|
|
d6da6d7232 | ||
|
|
0a3226f4d0 | ||
|
|
fcdb3709c4 | ||
|
|
d8f5b2ec91 | ||
|
|
75a1dcd287 | ||
|
|
3fbc55c01c | ||
|
|
dcb012883f |
@@ -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 **`20260125`**.
|
||||
**The latest version** of the **SAS Packages Framework** is **`20260216`**.
|
||||
|
||||
---
|
||||
|
||||
@@ -234,6 +234,7 @@ This is a list of locations where the SAS Packages Framework is used:
|
||||
- Warsaw (Poland)
|
||||
- Osaka (Japan)
|
||||
- Kyoto (Japan)
|
||||
- Boston (USA)
|
||||
|
||||
If you want to share that you are using the SPF let me know and I'll update the list.
|
||||
|
||||
|
||||
Binary file not shown.
@@ -8,7 +8,7 @@
|
||||
,packagesRef=packages
|
||||
,ods= /* data set for report file */
|
||||
)/
|
||||
des='Macro to create a bundle of SAS packages, version 20260125. Run %bundlePackages(HELP) for help info.'
|
||||
des='Macro to create a bundle of SAS packages, version 20260216. Run %bundlePackages(HELP) for help info.'
|
||||
secure minoperator
|
||||
;
|
||||
|
||||
@@ -25,7 +25,7 @@ secure minoperator
|
||||
%put ### This is short help information for the `bundlePackages` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *create bundles* of SAS packages, version `20260125` #;
|
||||
%put # Macro to *create bundles* of SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
when empty the "packages" value is used */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to list directories pointed by "packages" fileref, version 20260125. Run %extendPackagesFileref(HELP) for help info.'
|
||||
des = 'Macro to list directories pointed by "packages" fileref, version 20260216. Run %extendPackagesFileref(HELP) for help info.'
|
||||
;
|
||||
|
||||
%if %QUPCASE(&packages.) = HELP %then
|
||||
@@ -22,7 +22,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20260125
|
||||
%put ### This is short help information for the `extendPackagesFileref` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to list directories pointed by 'packages' fileref, version `20260125` #;
|
||||
%put # Macro to list directories pointed by 'packages' fileref, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
Macro to generate SAS packages.
|
||||
|
||||
Version 20260125
|
||||
Version 20260216
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -29,7 +29,7 @@
|
||||
if more than one are provided only the first is used */
|
||||
,testResults= /* location where tests results should be stored,
|
||||
if null (the default) the WORK is used */
|
||||
,workInTestResults=0 /* indicates if WORK directories for tests should located
|
||||
,workInTestResults=0 /* indicates if WORK directories for tests should be located
|
||||
in the same place as results */
|
||||
,testWorkPath= /* location where tests SAS sessions' work directories
|
||||
should be stored, if null (the default) the main SAS
|
||||
@@ -53,7 +53,7 @@
|
||||
when empty takes buildLocation */
|
||||
)/ secure minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to generate SAS packages, version 20260125. Run %generatePackage() for help info.'
|
||||
des = 'Macro to generate SAS packages, version 20260216. Run %generatePackage() for help info.'
|
||||
;
|
||||
%if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
|
||||
%do;
|
||||
@@ -68,7 +68,7 @@ des = 'Macro to generate SAS packages, version 20260125. Run %generatePackage()
|
||||
%put ### This is short help information for the `generatePackage` macro #;
|
||||
%put #------------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to generate SAS packages, version `20260125` #;
|
||||
%put # Macro to generate SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -262,13 +262,13 @@ filename &_LIC_. "&filesLocation./license.sas" lrecl = 1024;
|
||||
options &qlenmax_fstimer_tmp.;
|
||||
|
||||
/* test for required descriptors */
|
||||
%if (%nrbquote(&packageName.) = )
|
||||
or (%nrbquote(&packageVersion.) = )
|
||||
or (%nrbquote(&packageAuthor.) = )
|
||||
or (%nrbquote(&packageMaintainer.) = )
|
||||
or (%nrbquote(&packageTitle.) = )
|
||||
or (%nrbquote(&packageEncoding.) = )
|
||||
or (%nrbquote(&packageLicense.) = )
|
||||
%if (%superq(packageName) = )
|
||||
or (%superq(packageVersion) = )
|
||||
or (%superq(packageAuthor) = )
|
||||
or (%superq(packageMaintainer) = )
|
||||
or (%superq(packageTitle) = )
|
||||
or (%superq(packageEncoding) = )
|
||||
or (%superq(packageLicense) = )
|
||||
%then
|
||||
%do;
|
||||
%put ERROR: At least one of descriptors is missing!;
|
||||
@@ -444,10 +444,10 @@ options NOquotelenmax NOstimer NOfullstimer;
|
||||
*/
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* test if version is a number */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
v = "&packageVersion.";
|
||||
version = coalesce(input(scan(v,1,".","M"), ?? best32.),0)*1e8
|
||||
+ coalesce(input(scan(v,2,".","M"), ?? best32.),0)*1e4
|
||||
@@ -950,7 +950,7 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
|
||||
title&_titleNumber_. "Package ZIP file location is: &buildLocation.";
|
||||
%end;
|
||||
|
||||
footnote1 "SAS Packages Framework, version 20260125";
|
||||
footnote1 "SAS Packages Framework, version 20260216";
|
||||
|
||||
proc print
|
||||
data = &filesWithCodes.(drop=base build folderRef fileRef rc folderid _abort_ fileId additionalContent)
|
||||
@@ -1239,7 +1239,7 @@ data _null_;
|
||||
/ ' /* print out setinit */ '
|
||||
/ ' proc setinit %str(;) run %str(;) '
|
||||
/ ' proc printto %str(;) run %str(;) '
|
||||
|
||||
/ ' options ps=min %str(;) '
|
||||
/ ' data _null_ %str(;) '
|
||||
/ ' /* loadup checklist of required SAS components */ '
|
||||
/ ' if _n_ = 1 then '
|
||||
@@ -1298,8 +1298,10 @@ data _null_;
|
||||
packageReqPackages = lowcase(symget('packageReqPackages'));
|
||||
|
||||
/* try to load required packages */
|
||||
put 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages loading."; stop; end; '
|
||||
put '%let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ 'options noNotes;'
|
||||
/ 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages loading."; stop; end; '
|
||||
/ ' length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
/ ' do; '
|
||||
@@ -1341,7 +1343,7 @@ data _null_;
|
||||
|
||||
/ ' if (LP_find ne 0) or (LP_find = 0 and . < versN < verRN) then '
|
||||
/ ' do; '
|
||||
/ ' put "NOTE: Trying to load required SAS package: " req; '
|
||||
/ ' put "INFO: Trying to load required SAS package: " req; '
|
||||
/ ' if LoadPackageExist then '
|
||||
/ ' call execute(cats(''%nrstr(%loadPackage('', name, ", requiredVersion = ", verR, "))")); '
|
||||
/ ' else if ICELoadPackageExist then '
|
||||
@@ -1353,7 +1355,7 @@ data _null_;
|
||||
|
||||
/* test if required packages are loaded */
|
||||
/ 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages checking."; stop; end; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages checking."; stop; end; '
|
||||
/ ' length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
/ ' do; '
|
||||
@@ -1414,14 +1416,17 @@ data _null_;
|
||||
/ ' end ; '
|
||||
/ ' end; '
|
||||
/ ' stop; '
|
||||
/ 'run; ';
|
||||
/ 'run; '
|
||||
/ 'options &temp_noNotes_etc.;';
|
||||
%end;
|
||||
|
||||
%if (%superq(packageRequired) ne )
|
||||
or (%superq(packageReqPackages) ne )
|
||||
%then
|
||||
%do;
|
||||
put ' data _null_; '
|
||||
put ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ ' options noNotes;'
|
||||
/ ' data _null_; '
|
||||
/ ' if 1 = symgetn("packageRequiredErrors") then '
|
||||
/ ' do; '
|
||||
/ ' put "ERROR: Loading package &packageName. will be aborted!";'
|
||||
@@ -1436,7 +1441,8 @@ data _null_;
|
||||
/ ' else '
|
||||
/ ' call symputX("packageRequiredErrors", " ", "L");'
|
||||
/ ' run; '
|
||||
/ ' &packageRequiredErrors. ';
|
||||
/ ' &packageRequiredErrors. '
|
||||
/ ' options &temp_noNotes_etc.; ';
|
||||
%end;
|
||||
|
||||
|
||||
@@ -1769,7 +1775,7 @@ data _null_;
|
||||
%end;
|
||||
put +(-1) '`.;'''
|
||||
/ ' !! '' %put The macro generated: '' !! put(dtCASLudf, E8601DT19.-L) !! ";"'
|
||||
/ ' !! '' %put with the SAS Packages Framework version 20260125.;'''
|
||||
/ ' !! '' %put with the SAS Packages Framework version 20260216.;'''
|
||||
/ ' !! '' %put ****************************************************************************;'''
|
||||
/ ' !! '' %GOTO theEndOfTheMacro;'''
|
||||
/ ' !! '' %end;''' ;
|
||||
@@ -1933,7 +1939,7 @@ data _null_;
|
||||
%end;
|
||||
put +(-1) '`.; '' !!' /
|
||||
''' %put The macro generated: ''' " !! put(dtIML, E8601DT19.-L) !! " '''; '' !! ' /
|
||||
''' %put with the SAS Packages Framework version 20260125.; '' !! ' /
|
||||
''' %put with the SAS Packages Framework version 20260216.; '' !! ' /
|
||||
''' %put ****************************************************************************; '' !! ' /
|
||||
''' %GOTO theEndOfTheMacro; '' !! ' /
|
||||
''' %end; '' !! ' /
|
||||
@@ -2149,6 +2155,66 @@ data _null_;
|
||||
put 'run;';
|
||||
/* KMF -------------------------------------------------------------------------------- end */
|
||||
|
||||
/*=add meta function========================================================================*/
|
||||
isFunction+1;
|
||||
|
||||
length packageName $ 32 packageVersion packageGenerated $ 24
|
||||
packageTitle packageAuthor packageMaintainer $ 2048
|
||||
packageEncoding $ 8 packageLicense $ 128;
|
||||
packageName = quote(strip(symget('packageName')),'"');
|
||||
packageVersion = quote(strip(symget('packageVersion')),'"');
|
||||
packageTitle = quote(strip(symget('packageTitle')),'"');
|
||||
packageAuthor = quote(strip(symget('packageAuthor')),'"');
|
||||
packageMaintainer = quote(strip(symget('packageMaintainer')),'"');
|
||||
packageEncoding = quote(strip(symget('packageEncoding')),'"');
|
||||
packageLicense = quote(strip(symget('packageLicense')),'"');
|
||||
packageGenerated = quote(strip(symget('packageGenerated')),'"');
|
||||
/* add quotes to hide special characters */
|
||||
%if (%superq(packageReqPackages) ne ) %then /* required packages list */
|
||||
%do;
|
||||
packageReqPackages = quote(strip(packageReqPackages));
|
||||
%end;
|
||||
%if (%superq(packageRequired) ne ) %then /* required SAS products */
|
||||
%do;
|
||||
packageRequired = quote(strip(packageRequired));
|
||||
%end;
|
||||
|
||||
put '%if (%str(*)=%superq(cherryPick)) %then %do;'; /* cherryPick 4 ---*/
|
||||
put "proc fcmp outlib = work.&packageName.fcmp.packagemeta ; "
|
||||
/ " function &packageName.META(meta $) $ 32767;"
|
||||
/ ' m = char(upcase(meta),1);'
|
||||
/ " if m = 'V' then return(strip(" packageVersion +(-1) "));"
|
||||
/ " if m = 'D' then return(strip(" packageGenerated +(-1) "));"
|
||||
/ " if m = 'A' then return(strip(" packageAuthor +(-1) "));"
|
||||
/ " if m = 'M' then return(strip(" packageMaintainer +(-1) "));"
|
||||
/ " if m = 'T' then return(strip(" packageTitle +(-1) "));"
|
||||
/ " if m = 'E' then return(strip(" packageEncoding +(-1) "));"
|
||||
/ " if m = 'L' then return(strip(" packageGenerated +(-1) "));"
|
||||
%if (%superq(packageReqPackages) ne ) %then /* required packages list */
|
||||
%do;
|
||||
/ " if m = 'P' then return(strip(" packageReqPackages +(-1) "));"
|
||||
%end;
|
||||
%if (%superq(packageRequired) ne ) %then /* required SAS products */
|
||||
%do;
|
||||
/ " if m = 'S' then return(strip(" packageRequired +(-1) "));"
|
||||
%end;
|
||||
/ ' return(" ");'
|
||||
/ ' endfunc;'
|
||||
/ 'quit;';
|
||||
|
||||
put '%sysfunc(ifc(0<'
|
||||
/ ' %sysfunc(findw((%sysfunc(getoption(cmplib)))'
|
||||
/ " ,work.%sysfunc(lowcase(&packageName.fcmp)),""'( )'"",RIO))"
|
||||
/ ',,%str(options' " APPEND=(cmplib = work.%sysfunc(lowcase(&packageName.fcmp)));)"
|
||||
/ '))' ;
|
||||
|
||||
put '%macro ' "&packageName.META(meta)/parmbuff;" /* returned values are quoted to mask special chars*/
|
||||
/ '%if %superq(meta) = %then %return;'
|
||||
/ '%do;%qsysfunc(strip(%qsysfunc(' "&packageName.META" '&syspbuff.)))%end;'
|
||||
/ '%mend;' / /;
|
||||
put '%end;'; /* cherryPick 4 ---*/
|
||||
/*==========================================================================================*/
|
||||
|
||||
/* list cmplib for functions and fmtsearch for formats*/
|
||||
if isFunction OR isProto then
|
||||
do;
|
||||
@@ -2162,8 +2228,10 @@ data _null_;
|
||||
end;
|
||||
|
||||
/* update SYSloadedPackages global macrovariable */
|
||||
put 'options noNotes;'
|
||||
/ '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
|
||||
|
||||
put '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
|
||||
/ ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ ' options noNotes;'
|
||||
/ ' data _null_ ; '
|
||||
/ ' length SYSloadedPackages stringPCKG $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
@@ -2180,7 +2248,7 @@ data _null_;
|
||||
/ " SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)'); "
|
||||
/ ' SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#")); '
|
||||
/ ' call symputX("SYSloadedPackages", SYSloadedPackages, "G"); '
|
||||
/ ' put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' end ; '
|
||||
/ " else "
|
||||
/ ' do; '
|
||||
@@ -2189,16 +2257,17 @@ data _null_;
|
||||
/ " SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)'); "
|
||||
/ ' SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#")); '
|
||||
/ ' call symputX("SYSloadedPackages", SYSloadedPackages, "G"); '
|
||||
/ ' put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' end ; '
|
||||
/ ' end; '
|
||||
/ ' else '
|
||||
/ ' do; '
|
||||
/ " call symputX('SYSloadedPackages', '&packageName.(&packageVersion.)', 'G'); "
|
||||
/ " put / 'INFO:[SYSLOADEDPACKAGES] &packageName.(&packageVersion.)'; "
|
||||
/ " put / 'INFO: [SYSLOADEDPACKAGES] &packageName.(&packageVersion.)'; "
|
||||
/ ' end; '
|
||||
/ ' stop; '
|
||||
/ ' run; '
|
||||
/ ' options &temp_noNotes_etc.;'
|
||||
/ '%end; ' / ; /* Cherry Pick test3 end */
|
||||
|
||||
put 'options NOTES;'
|
||||
@@ -2314,7 +2383,8 @@ data _null_;
|
||||
/ ' from dictionary.catalogs'
|
||||
/ ' where '
|
||||
/ ' ('
|
||||
/ ' objname in ("*"'
|
||||
/ ' objname in ("*"'
|
||||
/ " ,%UPCASE('&packageName.META')"
|
||||
/ " ,%UPCASE('&packageName.IML')"
|
||||
/ " ,%UPCASE('&packageName.CASLUDF')";
|
||||
/* list of macros */
|
||||
@@ -2416,7 +2486,12 @@ data _null_;
|
||||
/ 'deletefunc ' fileshort ';';
|
||||
isFunction + 1;
|
||||
end;
|
||||
put "run;" /;
|
||||
put "quit;" /;
|
||||
|
||||
put "proc fcmp outlib = work.&packageName.fcmp.packagemeta;"
|
||||
/ "deletefunc &packageName.META;"
|
||||
/ "quit;" /;
|
||||
isFunction + 1;
|
||||
|
||||
/* delete the link to the functions dataset */
|
||||
if isFunction then
|
||||
@@ -2736,7 +2811,7 @@ data _null_;
|
||||
%end;
|
||||
|
||||
put 'put " " / @3 "---------------------------------------------------------------------" / " ";'
|
||||
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260125`*";'
|
||||
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260216`*";'
|
||||
/ "put @3 '*under `&sysscp.`(`&sysscpl.`) operating system,*';"
|
||||
/ "put @3 '*using SAS release: `&sysvlong4.`.*';"
|
||||
/ 'put " " / @3 "---------------------------------------------------------------------";';
|
||||
|
||||
@@ -28,7 +28,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage() for help info.'
|
||||
des = 'Macro to get help about SAS package, version 20260216. Run %helpPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -43,7 +43,7 @@ des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage()
|
||||
%put ### This is short help information for the `helpPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get help about SAS packages, version `20260125` #;
|
||||
%put # Macro to get help about SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -133,18 +133,20 @@ des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage()
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*+installPackage+*/
|
||||
/* Macros to install SAS packages, version 20260125 */
|
||||
/* Macros to install SAS packages, version 20260216 */
|
||||
/* 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
|
||||
@@ -26,7 +26,7 @@
|
||||
/secure
|
||||
minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to install SAS package, version 20260125. Run %%installPackage() for help info.'
|
||||
des = 'Macro to install SAS package, version 20260216. Run %%installPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
%do;
|
||||
@@ -41,7 +41,7 @@ des = 'Macro to install SAS package, version 20260125. Run %%installPackage() fo
|
||||
%put ### This is short help information for the `installPackage` macro #;
|
||||
%put #--------------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to install SAS packages, version `20260125` #;
|
||||
%put # Macro to install SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
vERRb /* indicates if macro should be verbose and report errors */
|
||||
)
|
||||
/ minoperator PARMBUFF
|
||||
des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260125.'
|
||||
des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260216.'
|
||||
;
|
||||
/*** HELP END ***/
|
||||
%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
|
||||
@@ -20,7 +20,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
|
||||
%put ### This is short help information for the `isPackagesFilerefOK` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to check if the `packages` fileref is "correct", version `20260125` #;
|
||||
%put # Macro to check if the `packages` fileref is "correct", version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
Macro to list SAS packages in packages folder.
|
||||
|
||||
Version 20260125
|
||||
Version 20260216
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -21,9 +21,11 @@
|
||||
*//*** HELP END ***/
|
||||
|
||||
|
||||
%macro listPackages(listDataSet, quiet=0)
|
||||
/ secure PARMBUFF
|
||||
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260125.'
|
||||
%macro listPackages(
|
||||
listDataSet /* Name of a data set to save results */
|
||||
, quiet = 0 /* Indicate if results should be printed in log */
|
||||
)/secure parmbuff
|
||||
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260216.'
|
||||
;
|
||||
%if (%QUPCASE(&listDataSet.) = HELP) %then
|
||||
%do;
|
||||
@@ -38,7 +40,7 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
|
||||
%put ### This is short help information for the `listPackages` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to list available SAS packages, version `20260125` #;
|
||||
%put # Macro to list available SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -248,7 +250,7 @@ run;
|
||||
%if 0=&quiet. %then
|
||||
%do;
|
||||
%put %str( );
|
||||
%put # Results ptovided in the &listDataSet. data set. #;
|
||||
%put # Results provided in the &listDataSet. data set. #;
|
||||
%put %str( );
|
||||
%end;
|
||||
%end;
|
||||
|
||||
@@ -36,7 +36,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load SAS package, version 20260125. Run %loadPackage() for help info.'
|
||||
des = 'Macro to load SAS package, version 20260216. Run %loadPackage() for help info.'
|
||||
minoperator
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
@@ -52,7 +52,7 @@ minoperator
|
||||
%put ### This is short help information for the `loadPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *load* SAS packages, version `20260125` #;
|
||||
%put # Macro to *load* SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -180,30 +180,34 @@ minoperator
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
run;
|
||||
/*run;*/ /* moved to line 272 */
|
||||
|
||||
/* convert cherryPick to lower case if needed */
|
||||
%if NOT (%str(*) = %superq(cherryPick)) %then
|
||||
%do;
|
||||
data _null_;
|
||||
/*data _null_;*/
|
||||
call symputX("cherryPick",lowcase(compbl(compress(symget("cherryPick"),". _","KDA"))),"L");
|
||||
run;
|
||||
/*run;*/
|
||||
%end;
|
||||
run;
|
||||
|
||||
/* empty list is equivalent to "*" */
|
||||
%if %superq(cherryPick)= %then
|
||||
%do;
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
is provided in required version */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load additional content for a SAS package, version 20260125. Run %loadPackageAddCnt() for help info.'
|
||||
des = 'Macro to load additional content for a SAS package, version 20260216. Run %loadPackageAddCnt() for help info.'
|
||||
minoperator
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
@@ -35,7 +35,7 @@ minoperator
|
||||
%put ### This is short help information for the `loadPackageAddCnt` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *load* additional content for a SAS package, version `20260125` #;
|
||||
%put # Macro to *load* additional content for a SAS package, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -116,20 +116,22 @@ minoperator
|
||||
options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "A" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
call symputX("_TargetFileref_", "T" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
data _null_;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "A" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
call symputX("_TargetFileref_", "T" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20260125. Run %loadPackages() for help info.'
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20260216. Run %loadPackages() for help info.'
|
||||
parmbuff
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
@@ -27,7 +27,7 @@ parmbuff
|
||||
%put ### This is short help information for the `loadPackageS` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20260125` #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to preview content of a SAS package, version 20260125. Run %previewPackage() for help info.'
|
||||
des = 'Macro to preview content of a SAS package, version 20260216. Run %previewPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -38,7 +38,7 @@ des = 'Macro to preview content of a SAS package, version 20260125. Run %preview
|
||||
%put ### This is short help information for the `previewPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get preview of a SAS packages, version `20260125` #;
|
||||
%put # Macro to get preview of a SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -119,18 +119,20 @@ des = 'Macro to preview content of a SAS package, version 20260125. Run %preview
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
,psMAX=MAX /* pageSise in case executed inside DoSubL() */
|
||||
,ods= /* a data set for results, e.g., work.relocatePackageReport */
|
||||
)
|
||||
/ des = 'Utility macro that locally Copies or Moves Packages, version 20260125. Run %relocatePackage() for help info.'
|
||||
/ des = 'Utility macro that locally Copies or Moves Packages, version 20260216. Run %relocatePackage() for help info.'
|
||||
secure
|
||||
minoperator
|
||||
;
|
||||
@@ -33,7 +33,7 @@
|
||||
%put ### This is short help information for the `relocatePackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260125` #;
|
||||
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -5,7 +5,7 @@ SPFmacroName /* space separated list of names */
|
||||
/
|
||||
minoperator
|
||||
secure
|
||||
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260125. Run %SasPackagesFrameworkNotes(HELP) for help info.'
|
||||
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260216. Run %SasPackagesFrameworkNotes(HELP) for help info.'
|
||||
;
|
||||
%local list N i element;
|
||||
%let list=
|
||||
@@ -51,7 +51,7 @@ SasPackagesFrameworkNotes
|
||||
%put ### This is short help information for the `SasPackagesFrameworkNotes` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro prints help notes for SAS Packages Framework macros, version `20260125` #;
|
||||
%put # Macro prints help notes for SAS Packages Framework macros, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
/*+SPFint_gnPckg_arch+*/
|
||||
%macro SPFint_gnPckg_arch()/secure minoperator
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
/*+SPFint_gnPckg_markdown+*/
|
||||
%macro SPFint_gnPckg_markdown()/secure minoperator
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
@@ -112,7 +112,7 @@ data &filesWithCodes.markdown;
|
||||
%end;
|
||||
|
||||
put " " / "---------------------------------------------------------------------" / " "
|
||||
/ "*SAS package generated by SAS Package Framework, version `20260125`,*"
|
||||
/ "*SAS package generated by SAS Package Framework, version `20260216`,*"
|
||||
/ "*under `&sysscp.`(`&sysscpl.`) operating system,*"
|
||||
/ "*using SAS release: `&sysvlong4.`.*"
|
||||
/ " " / "---------------------------------------------------------------------" / " ";
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
/*+SPFint_gnPckg_tests+*/
|
||||
%macro SPFint_gnPckg_tests()/secure minoperator
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
@@ -73,6 +73,22 @@ run;
|
||||
put @n '%loadpackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation., lazyData=*)" /;
|
||||
|
||||
/* meta */
|
||||
put @n '%put >>>%'"&packageName."'META( )<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(V)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(D)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(A)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(M)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(L)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(E)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(T)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(P)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(S)<<<;'/;
|
||||
|
||||
/* verify */
|
||||
put @n '%verifyPackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation.)" /;
|
||||
|
||||
/* help */
|
||||
put @n '%helpPackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation.)" /;
|
||||
@@ -292,6 +308,23 @@ data _null_;
|
||||
put '%loadpackage'"(&packageName.,"
|
||||
/ " path=&buildLocation., lazyData=*)" /;
|
||||
|
||||
/* meta */
|
||||
put '%put >>null >%'"&packageName."'META( )<<<;'/
|
||||
'%put >>unknown >%'"&packageName."'META(U)<<<;'/ /* test for unknown values */
|
||||
'%put >>version >%'"&packageName."'META(V)<<<;'/
|
||||
'%put >>datetime >%'"&packageName."'META(D)<<<;'/
|
||||
'%put >>authors >%'"&packageName."'META(A)<<<;'/
|
||||
'%put >>maintainers >%'"&packageName."'META(M)<<<;'/
|
||||
'%put >>license >%'"&packageName."'META(L)<<<;'/
|
||||
'%put >>encoding >%'"&packageName."'META(E)<<<;'/
|
||||
'%put >>title >%'"&packageName."'META(T)<<<;'/
|
||||
'%put >>req packages>%'"&packageName."'META(P)<<<;'/
|
||||
'%put >>req SAS >%'"&packageName."'META(S)<<<;'/;
|
||||
|
||||
/* verify */
|
||||
put '%verifyPackage'"(&packageName.,";
|
||||
put " path=&buildLocation.)" /;
|
||||
|
||||
/* help */
|
||||
put '%helpPackage'"(&packageName.,"
|
||||
/ " path=&buildLocation.)" /;
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
,nobs=0 /* technical parameter */
|
||||
)
|
||||
/*** HELP END ***/
|
||||
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260125. Run %splitCodeForPackage() for help info.'
|
||||
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260216. Run %splitCodeForPackage() for help info.'
|
||||
;
|
||||
%if (%superq(codeFile) = ) OR (%qupcase(&codeFile.) = HELP) %then
|
||||
%do;
|
||||
@@ -24,7 +24,7 @@
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Utility macro to *split* single file with SAS package code into multiple #;
|
||||
%put # files with separate snippets, version `20260125` #;
|
||||
%put # files with separate snippets, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -400,7 +400,7 @@ options nomprint nosymbolgen nomlogic notes source ls=MAX ps=MAX msglevel=N ;
|
||||
*/
|
||||
if firstLine[j] then
|
||||
do;
|
||||
put '/* File generated with help of SAS Packages Framework, version 20260125. */';
|
||||
put '/* File generated with help of SAS Packages Framework, version 20260216. */';
|
||||
firstLine[j]=0;
|
||||
end;
|
||||
put _infile_;
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
,ods= /* data set for report file */
|
||||
,verify=0
|
||||
)/
|
||||
des='Macro to extract a bundle of SAS packages, version 20260125. Run %unbundlePackages(HELP) for help info.'
|
||||
des='Macro to extract a bundle of SAS packages, version 20260216. Run %unbundlePackages(HELP) for help info.'
|
||||
secure
|
||||
minoperator
|
||||
;
|
||||
@@ -26,7 +26,7 @@ minoperator
|
||||
%put ### This is short help information for the `unbundlePackages` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *extract* SAS packages from a bundle, version `20260125` #;
|
||||
%put # Macro to *extract* SAS packages from a bundle, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -128,11 +128,10 @@ minoperator
|
||||
%let datetime = %sysfunc(datetime());
|
||||
%let reportFile = WORK.tmpbundlefile%sysfunc(int(&datetime.), b8601dt15.)_;
|
||||
|
||||
data _null_ ;
|
||||
data _null_;
|
||||
datetime=symgetn('datetime');
|
||||
|
||||
length packagesList $ 32767 bundleName $ 128;
|
||||
|
||||
bundleName = compress(symget('bundleName'),"_.","KAD"); /* bundle name is letters, digits, and underscore, up to 128 symbols */
|
||||
|
||||
if bundleName NE symget('bundleName') then /* warn about illegal characters */
|
||||
@@ -140,12 +139,12 @@ if bundleName NE symget('bundleName') then /* warn about illegal characters */
|
||||
put "ERROR: Bundle name contains illegal characters. Exiting";
|
||||
stop;
|
||||
end;
|
||||
|
||||
bundleName=lowcase(bundleName);
|
||||
lbn = length(bundleName); /* to cover lengths < 7 & 11 */
|
||||
/* if there is ".bundle.zip" extension added, remove it */
|
||||
if substr(strip(reverse(bundleName)),1,11) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
|
||||
if substr(strip(reverse(bundleName)),1,min(11,lbn)) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
|
||||
else /* if there is ".bundle" extension added, remove it */
|
||||
if substr(strip(reverse(bundleName)),1,7) = 'eldnub.' then bundleName=scan(bundleName,-2,".");
|
||||
if substr(strip(reverse(bundleName)),1,min(7,lbn)) = 'eldnub.' then bundleName=scan(bundleName,-2,".");
|
||||
|
||||
put / "INFO: Bundle name is: " bundleName / ;
|
||||
|
||||
@@ -153,7 +152,6 @@ length packagesPath $ 32767 packagesRef $ 8;
|
||||
packagesPath = dequote(symget('packagesPath'));
|
||||
packagesRef = upcase(strip(symget('packagesRef')));
|
||||
|
||||
|
||||
/* organize target path (location for packages) */
|
||||
if " "=packagesPath then
|
||||
do;
|
||||
@@ -281,7 +279,6 @@ label package="Package name"
|
||||
hash="SHA256 for the Package";
|
||||
/*--------------------------------------------------*/
|
||||
|
||||
|
||||
if 0=Q.NUM_ITEMS then /* ... if empty then exit */
|
||||
do;
|
||||
put "WARNING: No packages to unbundle. Exiting!";
|
||||
@@ -320,7 +317,6 @@ put / "INFO: The " bundleName "bundle extraction ended.";
|
||||
rc = doSubL(code2);
|
||||
put / "INFO: The " bundleName "bundle verification ended.";
|
||||
%end;
|
||||
|
||||
put " ";
|
||||
rc=sleep(1,1);
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for help info.'
|
||||
des = 'Macro to unload SAS package, version 20260216. Run %unloadPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -35,7 +35,7 @@ des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for h
|
||||
%put ### This is short help information for the `unloadPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to unload SAS packages, version `20260125` #;
|
||||
%put # Macro to unload SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -115,18 +115,20 @@ des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for h
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
|
||||
@@ -8,12 +8,12 @@
|
||||
, path = %sysfunc(pathname(packages)) /* location of a package,
|
||||
by default it looks for
|
||||
location of "packages" fileref */
|
||||
, hash = /* The SHA256 hash digest for
|
||||
, hash = F* /* The SHA256 hash digest for
|
||||
the package generated by
|
||||
hashing_file() function, SAS 9.4M6 */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %verifyPackage() for help info.'
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20260216. Run %verifyPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -28,7 +28,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put ### This is short help information for the `verifyPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20260125` #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -48,7 +48,9 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put # If empty displays this help information. #;
|
||||
%put # #;
|
||||
%put # - `hash=` A value of the package `SHA256` hash. #;
|
||||
%put # Provided by the user. #;
|
||||
%put # Provided by the user. When the value is not provided #;
|
||||
%put # then macro calculates `SHA256`, `SHA1`, and `MD5` #;
|
||||
%put # digests and display then in the log. #;
|
||||
%put # #;
|
||||
%put # - `path=` Location of a package. By default it looks for #;
|
||||
%put # location of the "packages" fileref, i.e. #;
|
||||
@@ -76,7 +78,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put ;
|
||||
%put %nrstr( %%installPackage(SQLinDS) %%* install the package from the Internet; );
|
||||
%put %nrstr( %%verifyPackage%(SQLinDS, %%* verify the package with provided hash; );
|
||||
%put %nrstr( hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%) );
|
||||
%put %nrstr( hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%) );
|
||||
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
|
||||
%put #################################################################################;
|
||||
%put ;
|
||||
@@ -97,19 +99,21 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
|
||||
|
||||
%local _PackageFileref_ checkExist;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
data _null_;
|
||||
length packageName $ 140;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".zip")); /* check on zip files only! */
|
||||
exists + fileexist(catx("/", p, cats(packageName,".zip"))); /* check on zip files only! */
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -142,31 +146,60 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
filename &_PackageFileref_. list;
|
||||
|
||||
data _null_;
|
||||
length providedHash $ 128;
|
||||
length providedHash $ 128 packageName $ 140;
|
||||
providedHash = strip(symget("hash"));
|
||||
select;
|
||||
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
|
||||
SHA256 = 'F*' !! HASHING_FILE("SHA256", pathname("&_PackageFileref_.",'F'), 0);
|
||||
when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */
|
||||
SHA256 = 'C*' !! HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
|
||||
otherwise /* legacy approach, without C or F, digest value equivalent to C */
|
||||
SHA256 = HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
|
||||
end;
|
||||
put "Provided Hash: " providedHash;
|
||||
put "SHA256 digest: " SHA256;
|
||||
put " ";
|
||||
|
||||
if upcase(SHA256) = upcase(providedHash) then
|
||||
do;
|
||||
put "NOTE: Package verification SUCCESSFUL.";
|
||||
put "NOTE- Generated hash is EQUAL to the provided one.";
|
||||
packageName = strip(symget("packageName"));
|
||||
|
||||
emptyHash = (providedHash = " " OR providedHash in ("F*" "f*" "C*" "c*"));
|
||||
|
||||
put 82*"-" / @2 packageName / 82*"-" /;
|
||||
|
||||
if NOT emptyHash then put "Provided Hash: " providedHash;
|
||||
|
||||
length method $ 8 digest $ 128;
|
||||
/* calculate SHA256 */
|
||||
method="SHA256";
|
||||
LINK CalcualteHashDigest; /* go to Link 1 */
|
||||
|
||||
if NOT emptyHash then
|
||||
do; /* step for veryfication */
|
||||
if upcase(digest) = upcase(providedHash) then
|
||||
do;
|
||||
put "NOTE: Verification SUCCESSFUL."
|
||||
/ "NOTE- Generated hash is EQUAL to the provided one." / ;
|
||||
end;
|
||||
else
|
||||
do;
|
||||
pos = 0;
|
||||
do i = 1 to max(lengthn(digest),lengthn(providedHash)) while(pos=0);
|
||||
if char(digest,i) NE char(providedHash,i) then pos = i;
|
||||
end;
|
||||
put "ERROR- " @(pos+15)"^"/"ERROR- " @(pos+15)"| diff @" pos/"ERROR- ";
|
||||
put "ERROR: Verification FAILED!!"
|
||||
/ "ERROR- Generated hash is DIFFERENT than the provided one."
|
||||
/ "ERROR- Check if the ZIP is genuine." / ;
|
||||
end;
|
||||
end;
|
||||
else
|
||||
do;
|
||||
put "ERROR: Package verification FAILED!!";
|
||||
put "ERROR- Generated hash is DIFFERENT than the provided one.";
|
||||
put "ERROR- Confirm if the package is genuine.";
|
||||
do method = "SHA1", "MD5"; /* step for digest display, calcualte also SHA1 and MD5 */
|
||||
LINK CalcualteHashDigest; /* go to Link 1 */
|
||||
end;
|
||||
put 82*"-" /;
|
||||
stop;
|
||||
return;
|
||||
CalcualteHashDigest: /* Link 1 */
|
||||
|
||||
select;
|
||||
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
|
||||
digest = 'F*' !! HASHING_FILE(method, pathname("&_PackageFileref_.",'F'), 0);
|
||||
when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */
|
||||
digest = 'C*' !! HASHING_FILE(method, "&_PackageFileref_.", 4);
|
||||
otherwise /* legacy approach, without C or F, digest value equivalent to C */
|
||||
digest = HASHING_FILE(method, "&_PackageFileref_.", 4);
|
||||
end;
|
||||
put method "digest: " digest /;
|
||||
|
||||
return;
|
||||
run;
|
||||
%let HASHING_FILE_exist = 0;
|
||||
%end;
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
|
||||
---
|
||||
|
||||
# SAS Packages Framework, version `20260125`
|
||||
# SAS Packages Framework, version `20260216`
|
||||
|
||||
---
|
||||
|
||||
@@ -34,7 +34,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
|
||||
|
||||
The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
|
||||
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20260125`**.
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20260216`**.
|
||||
|
||||
**To get started with SAS Packages** try this [**`Introduction to SAS Packages`**](https://youtube.com/playlist?list=PLeMzGEImIT5eV13IGXQIgWmTFCJt_cLZG&si=ElQm0_ifq76mvUbq "Introduction to SAS Packages video series") video series or [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
|
||||
|
||||
@@ -57,7 +57,7 @@ them using the SPF can be found [**HERE**](https://github.com/yabwon/HoW-SASPack
|
||||
## This is short help information for the `installPackage` macro <a name="installpackage"></a>
|
||||
--------------------------------------------------------------------------------------------
|
||||
|
||||
Macro to install SAS packages, version `20260125`
|
||||
Macro to install SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -185,7 +185,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 `20260125`
|
||||
Macro to get help about SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -263,7 +263,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 `20260125`
|
||||
Macro to *load* SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -421,7 +421,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 `20260125`
|
||||
Macro wrapper for the loadPackage macro, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -472,7 +472,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 `20260125`
|
||||
Macro to unload SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -539,7 +539,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 `20260125`
|
||||
Macro to list available SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -588,7 +588,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 `20260125`
|
||||
Macro to verify SAS package with it hash digest, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -609,7 +609,9 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
If empty displays this help information.
|
||||
|
||||
- `hash=` A value of the package `SHA256` hash.
|
||||
Provided by the user.
|
||||
Provided by the user. When the value is not provided
|
||||
then macro calculates `SHA256`, `SHA1`, and `MD5`
|
||||
digests and display then in the log.
|
||||
|
||||
- `path=` Location of a package. By default it looks for
|
||||
location of the "packages" fileref, i.e.
|
||||
@@ -636,13 +638,13 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
|
||||
|
||||
%installPackage(SQLinDS) %* install the package from the Internet;
|
||||
%verifyPackage(SQLinDS, %* verify the package with provided hash;
|
||||
hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4)
|
||||
hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
## This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to get preview of a SAS packages, version `20260125`
|
||||
Macro to get preview of a SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -711,7 +713,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 `20260125`
|
||||
Macro to generate SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -944,7 +946,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 `20260125`
|
||||
Macro to list directories pointed by 'packages' fileref, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -986,7 +988,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 `20260125`
|
||||
Macro to load *additional content* for a SAS package, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1080,7 +1082,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 `20260125`
|
||||
files with separate snippets, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1161,7 +1163,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 `20260125`
|
||||
Macro to *locally copy or move* (relocate) SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1273,7 +1275,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 `20260125`
|
||||
Macro to check if the `packages` fileref is "correct", version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1324,7 +1326,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 `20260125`
|
||||
Macro prints help notes for SAS Packages Framework macros, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1374,7 +1376,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 `20260125`
|
||||
Macro to *create bundles* of SAS packages, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1443,7 +1445,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 `20260125`
|
||||
Macro to *extract* SAS packages from a bundle, version `20260216`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
|
||||
419
SPF/SPFinit.sas
419
SPF/SPFinit.sas
@@ -43,7 +43,7 @@
|
||||
- to unload, or
|
||||
- to generate SAS packages.
|
||||
|
||||
Version 20260125.
|
||||
Version 20260216.
|
||||
See examples below.
|
||||
|
||||
A SAS package is a zip file containing a group of files
|
||||
@@ -101,7 +101,7 @@ Contributors:
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load SAS package, version 20260125. Run %loadPackage() for help info.'
|
||||
des = 'Macro to load SAS package, version 20260216. Run %loadPackage() 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 `20260125` #;
|
||||
%put # Macro to *load* SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -245,30 +245,34 @@ minoperator
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
run;
|
||||
/*run;*/ /* moved to line 272 */
|
||||
|
||||
/* convert cherryPick to lower case if needed */
|
||||
%if NOT (%str(*) = %superq(cherryPick)) %then
|
||||
%do;
|
||||
data _null_;
|
||||
/*data _null_;*/
|
||||
call symputX("cherryPick",lowcase(compbl(compress(symget("cherryPick"),". _","KDA"))),"L");
|
||||
run;
|
||||
/*run;*/
|
||||
%end;
|
||||
run;
|
||||
|
||||
/* empty list is equivalent to "*" */
|
||||
%if %superq(cherryPick)= %then
|
||||
%do;
|
||||
@@ -394,7 +398,7 @@ minoperator
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for help info.'
|
||||
des = 'Macro to unload SAS package, version 20260216. Run %unloadPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -409,7 +413,7 @@ des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for h
|
||||
%put ### This is short help information for the `unloadPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to unload SAS packages, version `20260125` #;
|
||||
%put # Macro to unload SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -489,18 +493,20 @@ des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for h
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -562,7 +568,7 @@ des = 'Macro to unload SAS package, version 20260125. Run %unloadPackage() for h
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage() for help info.'
|
||||
des = 'Macro to get help about SAS package, version 20260216. Run %helpPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -577,7 +583,7 @@ des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage()
|
||||
%put ### This is short help information for the `helpPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get help about SAS packages, version `20260125` #;
|
||||
%put # Macro to get help about SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -667,18 +673,20 @@ des = 'Macro to get help about SAS package, version 20260125. Run %helpPackage()
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -720,7 +728,7 @@ TODO:
|
||||
*/
|
||||
|
||||
/*+installPackage+*/
|
||||
/* Macros to install SAS packages, version 20260125 */
|
||||
/* Macros to install SAS packages, version 20260216 */
|
||||
/* 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
|
||||
@@ -747,7 +755,7 @@ TODO:
|
||||
/secure
|
||||
minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to install SAS package, version 20260125. Run %%installPackage() for help info.'
|
||||
des = 'Macro to install SAS package, version 20260216. Run %%installPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
%do;
|
||||
@@ -762,7 +770,7 @@ des = 'Macro to install SAS package, version 20260125. Run %%installPackage() fo
|
||||
%put ### This is short help information for the `installPackage` macro #;
|
||||
%put #--------------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to install SAS packages, version `20260125` #;
|
||||
%put # Macro to install SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -1414,7 +1422,7 @@ des = 'Macro to install SAS package, version 20260125. Run %%installPackage() fo
|
||||
|
||||
Macro to list SAS packages in packages folder.
|
||||
|
||||
Version 20260125
|
||||
Version 20260216
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1436,7 +1444,7 @@ des = 'Macro to install SAS package, version 20260125. Run %%installPackage() fo
|
||||
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 20260125.'
|
||||
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20260216.'
|
||||
;
|
||||
%if (%QUPCASE(&listDataSet.) = HELP) %then
|
||||
%do;
|
||||
@@ -1451,7 +1459,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 `20260125` #;
|
||||
%put # Macro to list available SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -1661,7 +1669,7 @@ run;
|
||||
%if 0=&quiet. %then
|
||||
%do;
|
||||
%put %str( );
|
||||
%put # Results ptovided in the &listDataSet. data set. #;
|
||||
%put # Results provided in the &listDataSet. data set. #;
|
||||
%put %str( );
|
||||
%end;
|
||||
%end;
|
||||
@@ -1677,7 +1685,7 @@ options ls = &ls_tmp. ps = &ps_tmp. ¬es_tmp. &source_tmp.;
|
||||
|
||||
Macro to generate SAS packages.
|
||||
|
||||
Version 20260125
|
||||
Version 20260216
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1703,7 +1711,7 @@ options ls = &ls_tmp. ps = &ps_tmp. ¬es_tmp. &source_tmp.;
|
||||
if more than one are provided only the first is used */
|
||||
,testResults= /* location where tests results should be stored,
|
||||
if null (the default) the WORK is used */
|
||||
,workInTestResults=0 /* indicates if WORK directories for tests should located
|
||||
,workInTestResults=0 /* indicates if WORK directories for tests should be located
|
||||
in the same place as results */
|
||||
,testWorkPath= /* location where tests SAS sessions' work directories
|
||||
should be stored, if null (the default) the main SAS
|
||||
@@ -1727,7 +1735,7 @@ options ls = &ls_tmp. ps = &ps_tmp. ¬es_tmp. &source_tmp.;
|
||||
when empty takes buildLocation */
|
||||
)/ secure minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to generate SAS packages, version 20260125. Run %generatePackage() for help info.'
|
||||
des = 'Macro to generate SAS packages, version 20260216. Run %generatePackage() for help info.'
|
||||
;
|
||||
%if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
|
||||
%do;
|
||||
@@ -1742,7 +1750,7 @@ des = 'Macro to generate SAS packages, version 20260125. Run %generatePackage()
|
||||
%put ### This is short help information for the `generatePackage` macro #;
|
||||
%put #------------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to generate SAS packages, version `20260125` #;
|
||||
%put # Macro to generate SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -1936,13 +1944,13 @@ filename &_LIC_. "&filesLocation./license.sas" lrecl = 1024;
|
||||
options &qlenmax_fstimer_tmp.;
|
||||
|
||||
/* test for required descriptors */
|
||||
%if (%nrbquote(&packageName.) = )
|
||||
or (%nrbquote(&packageVersion.) = )
|
||||
or (%nrbquote(&packageAuthor.) = )
|
||||
or (%nrbquote(&packageMaintainer.) = )
|
||||
or (%nrbquote(&packageTitle.) = )
|
||||
or (%nrbquote(&packageEncoding.) = )
|
||||
or (%nrbquote(&packageLicense.) = )
|
||||
%if (%superq(packageName) = )
|
||||
or (%superq(packageVersion) = )
|
||||
or (%superq(packageAuthor) = )
|
||||
or (%superq(packageMaintainer) = )
|
||||
or (%superq(packageTitle) = )
|
||||
or (%superq(packageEncoding) = )
|
||||
or (%superq(packageLicense) = )
|
||||
%then
|
||||
%do;
|
||||
%put ERROR: At least one of descriptors is missing!;
|
||||
@@ -2118,10 +2126,10 @@ options NOquotelenmax NOstimer NOfullstimer;
|
||||
*/
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* test if version is a number */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
v = "&packageVersion.";
|
||||
version = coalesce(input(scan(v,1,".","M"), ?? best32.),0)*1e8
|
||||
+ coalesce(input(scan(v,2,".","M"), ?? best32.),0)*1e4
|
||||
@@ -2624,7 +2632,7 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
|
||||
title&_titleNumber_. "Package ZIP file location is: &buildLocation.";
|
||||
%end;
|
||||
|
||||
footnote1 "SAS Packages Framework, version 20260125";
|
||||
footnote1 "SAS Packages Framework, version 20260216";
|
||||
|
||||
proc print
|
||||
data = &filesWithCodes.(drop=base build folderRef fileRef rc folderid _abort_ fileId additionalContent)
|
||||
@@ -2913,7 +2921,7 @@ data _null_;
|
||||
/ ' /* print out setinit */ '
|
||||
/ ' proc setinit %str(;) run %str(;) '
|
||||
/ ' proc printto %str(;) run %str(;) '
|
||||
|
||||
/ ' options ps=min %str(;) '
|
||||
/ ' data _null_ %str(;) '
|
||||
/ ' /* loadup checklist of required SAS components */ '
|
||||
/ ' if _n_ = 1 then '
|
||||
@@ -2972,8 +2980,10 @@ data _null_;
|
||||
packageReqPackages = lowcase(symget('packageReqPackages'));
|
||||
|
||||
/* try to load required packages */
|
||||
put 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages loading."; stop; end; '
|
||||
put '%let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ 'options noNotes;'
|
||||
/ 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages loading."; stop; end; '
|
||||
/ ' length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
/ ' do; '
|
||||
@@ -3015,7 +3025,7 @@ data _null_;
|
||||
|
||||
/ ' if (LP_find ne 0) or (LP_find = 0 and . < versN < verRN) then '
|
||||
/ ' do; '
|
||||
/ ' put "NOTE: Trying to load required SAS package: " req; '
|
||||
/ ' put "INFO: Trying to load required SAS package: " req; '
|
||||
/ ' if LoadPackageExist then '
|
||||
/ ' call execute(cats(''%nrstr(%loadPackage('', name, ", requiredVersion = ", verR, "))")); '
|
||||
/ ' else if ICELoadPackageExist then '
|
||||
@@ -3027,7 +3037,7 @@ data _null_;
|
||||
|
||||
/* test if required packages are loaded */
|
||||
/ 'data _null_ ; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "NOTE: No required packages checking."; stop; end; '
|
||||
/ ' if "*" NE symget("cherryPick") then do; put "INFO: No required packages checking."; stop; end; '
|
||||
/ ' length req name $ 64 vers verR $ 24 versN verRN 8 SYSloadedPackages $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
/ ' do; '
|
||||
@@ -3088,14 +3098,17 @@ data _null_;
|
||||
/ ' end ; '
|
||||
/ ' end; '
|
||||
/ ' stop; '
|
||||
/ 'run; ';
|
||||
/ 'run; '
|
||||
/ 'options &temp_noNotes_etc.;';
|
||||
%end;
|
||||
|
||||
%if (%superq(packageRequired) ne )
|
||||
or (%superq(packageReqPackages) ne )
|
||||
%then
|
||||
%do;
|
||||
put ' data _null_; '
|
||||
put ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ ' options noNotes;'
|
||||
/ ' data _null_; '
|
||||
/ ' if 1 = symgetn("packageRequiredErrors") then '
|
||||
/ ' do; '
|
||||
/ ' put "ERROR: Loading package &packageName. will be aborted!";'
|
||||
@@ -3110,7 +3123,8 @@ data _null_;
|
||||
/ ' else '
|
||||
/ ' call symputX("packageRequiredErrors", " ", "L");'
|
||||
/ ' run; '
|
||||
/ ' &packageRequiredErrors. ';
|
||||
/ ' &packageRequiredErrors. '
|
||||
/ ' options &temp_noNotes_etc.; ';
|
||||
%end;
|
||||
|
||||
|
||||
@@ -3443,7 +3457,7 @@ data _null_;
|
||||
%end;
|
||||
put +(-1) '`.;'''
|
||||
/ ' !! '' %put The macro generated: '' !! put(dtCASLudf, E8601DT19.-L) !! ";"'
|
||||
/ ' !! '' %put with the SAS Packages Framework version 20260125.;'''
|
||||
/ ' !! '' %put with the SAS Packages Framework version 20260216.;'''
|
||||
/ ' !! '' %put ****************************************************************************;'''
|
||||
/ ' !! '' %GOTO theEndOfTheMacro;'''
|
||||
/ ' !! '' %end;''' ;
|
||||
@@ -3607,7 +3621,7 @@ data _null_;
|
||||
%end;
|
||||
put +(-1) '`.; '' !!' /
|
||||
''' %put The macro generated: ''' " !! put(dtIML, E8601DT19.-L) !! " '''; '' !! ' /
|
||||
''' %put with the SAS Packages Framework version 20260125.; '' !! ' /
|
||||
''' %put with the SAS Packages Framework version 20260216.; '' !! ' /
|
||||
''' %put ****************************************************************************; '' !! ' /
|
||||
''' %GOTO theEndOfTheMacro; '' !! ' /
|
||||
''' %end; '' !! ' /
|
||||
@@ -3823,6 +3837,66 @@ data _null_;
|
||||
put 'run;';
|
||||
/* KMF -------------------------------------------------------------------------------- end */
|
||||
|
||||
/*=add meta function========================================================================*/
|
||||
isFunction+1;
|
||||
|
||||
length packageName $ 32 packageVersion packageGenerated $ 24
|
||||
packageTitle packageAuthor packageMaintainer $ 2048
|
||||
packageEncoding $ 8 packageLicense $ 128;
|
||||
packageName = quote(strip(symget('packageName')),'"');
|
||||
packageVersion = quote(strip(symget('packageVersion')),'"');
|
||||
packageTitle = quote(strip(symget('packageTitle')),'"');
|
||||
packageAuthor = quote(strip(symget('packageAuthor')),'"');
|
||||
packageMaintainer = quote(strip(symget('packageMaintainer')),'"');
|
||||
packageEncoding = quote(strip(symget('packageEncoding')),'"');
|
||||
packageLicense = quote(strip(symget('packageLicense')),'"');
|
||||
packageGenerated = quote(strip(symget('packageGenerated')),'"');
|
||||
/* add quotes to hide special characters */
|
||||
%if (%superq(packageReqPackages) ne ) %then /* required packages list */
|
||||
%do;
|
||||
packageReqPackages = quote(strip(packageReqPackages));
|
||||
%end;
|
||||
%if (%superq(packageRequired) ne ) %then /* required SAS products */
|
||||
%do;
|
||||
packageRequired = quote(strip(packageRequired));
|
||||
%end;
|
||||
|
||||
put '%if (%str(*)=%superq(cherryPick)) %then %do;'; /* cherryPick 4 ---*/
|
||||
put "proc fcmp outlib = work.&packageName.fcmp.packagemeta ; "
|
||||
/ " function &packageName.META(meta $) $ 32767;"
|
||||
/ ' m = char(upcase(meta),1);'
|
||||
/ " if m = 'V' then return(strip(" packageVersion +(-1) "));"
|
||||
/ " if m = 'D' then return(strip(" packageGenerated +(-1) "));"
|
||||
/ " if m = 'A' then return(strip(" packageAuthor +(-1) "));"
|
||||
/ " if m = 'M' then return(strip(" packageMaintainer +(-1) "));"
|
||||
/ " if m = 'T' then return(strip(" packageTitle +(-1) "));"
|
||||
/ " if m = 'E' then return(strip(" packageEncoding +(-1) "));"
|
||||
/ " if m = 'L' then return(strip(" packageGenerated +(-1) "));"
|
||||
%if (%superq(packageReqPackages) ne ) %then /* required packages list */
|
||||
%do;
|
||||
/ " if m = 'P' then return(strip(" packageReqPackages +(-1) "));"
|
||||
%end;
|
||||
%if (%superq(packageRequired) ne ) %then /* required SAS products */
|
||||
%do;
|
||||
/ " if m = 'S' then return(strip(" packageRequired +(-1) "));"
|
||||
%end;
|
||||
/ ' return(" ");'
|
||||
/ ' endfunc;'
|
||||
/ 'quit;';
|
||||
|
||||
put '%sysfunc(ifc(0<'
|
||||
/ ' %sysfunc(findw((%sysfunc(getoption(cmplib)))'
|
||||
/ " ,work.%sysfunc(lowcase(&packageName.fcmp)),""'( )'"",RIO))"
|
||||
/ ',,%str(options' " APPEND=(cmplib = work.%sysfunc(lowcase(&packageName.fcmp)));)"
|
||||
/ '))' ;
|
||||
|
||||
put '%macro ' "&packageName.META(meta)/parmbuff;" /* returned values are quoted to mask special chars*/
|
||||
/ '%if %superq(meta) = %then %return;'
|
||||
/ '%do;%qsysfunc(strip(%qsysfunc(' "&packageName.META" '&syspbuff.)))%end;'
|
||||
/ '%mend;' / /;
|
||||
put '%end;'; /* cherryPick 4 ---*/
|
||||
/*==========================================================================================*/
|
||||
|
||||
/* list cmplib for functions and fmtsearch for formats*/
|
||||
if isFunction OR isProto then
|
||||
do;
|
||||
@@ -3836,8 +3910,10 @@ data _null_;
|
||||
end;
|
||||
|
||||
/* update SYSloadedPackages global macrovariable */
|
||||
put 'options noNotes;'
|
||||
/ '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
|
||||
|
||||
put '%if (%str(*)=%superq(cherryPick)) %then %do; ' /* Cherry Pick test3 start */
|
||||
/ ' %let temp_noNotes_etc=%sysfunc(getoption(NOTES));'
|
||||
/ ' options noNotes;'
|
||||
/ ' data _null_ ; '
|
||||
/ ' length SYSloadedPackages stringPCKG $ 32767; '
|
||||
/ ' if SYMEXIST("SYSloadedPackages") = 1 and SYMGLOBL("SYSloadedPackages") = 1 then '
|
||||
@@ -3854,7 +3930,7 @@ data _null_;
|
||||
/ " SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)'); "
|
||||
/ ' SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#")); '
|
||||
/ ' call symputX("SYSloadedPackages", SYSloadedPackages, "G"); '
|
||||
/ ' put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' end ; '
|
||||
/ " else "
|
||||
/ ' do; '
|
||||
@@ -3863,16 +3939,17 @@ data _null_;
|
||||
/ " SYSloadedPackages = catx('#', SYSloadedPackages, '&packageName.(&packageVersion.)'); "
|
||||
/ ' SYSloadedPackages = compbl(translate(SYSloadedPackages, " ", "#")); '
|
||||
/ ' call symputX("SYSloadedPackages", SYSloadedPackages, "G"); '
|
||||
/ ' put / "INFO:[SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' put / "INFO: [SYSLOADEDPACKAGES] " SYSloadedPackages ; '
|
||||
/ ' end ; '
|
||||
/ ' end; '
|
||||
/ ' else '
|
||||
/ ' do; '
|
||||
/ " call symputX('SYSloadedPackages', '&packageName.(&packageVersion.)', 'G'); "
|
||||
/ " put / 'INFO:[SYSLOADEDPACKAGES] &packageName.(&packageVersion.)'; "
|
||||
/ " put / 'INFO: [SYSLOADEDPACKAGES] &packageName.(&packageVersion.)'; "
|
||||
/ ' end; '
|
||||
/ ' stop; '
|
||||
/ ' run; '
|
||||
/ ' options &temp_noNotes_etc.;'
|
||||
/ '%end; ' / ; /* Cherry Pick test3 end */
|
||||
|
||||
put 'options NOTES;'
|
||||
@@ -3988,7 +4065,8 @@ data _null_;
|
||||
/ ' from dictionary.catalogs'
|
||||
/ ' where '
|
||||
/ ' ('
|
||||
/ ' objname in ("*"'
|
||||
/ ' objname in ("*"'
|
||||
/ " ,%UPCASE('&packageName.META')"
|
||||
/ " ,%UPCASE('&packageName.IML')"
|
||||
/ " ,%UPCASE('&packageName.CASLUDF')";
|
||||
/* list of macros */
|
||||
@@ -4090,7 +4168,12 @@ data _null_;
|
||||
/ 'deletefunc ' fileshort ';';
|
||||
isFunction + 1;
|
||||
end;
|
||||
put "run;" /;
|
||||
put "quit;" /;
|
||||
|
||||
put "proc fcmp outlib = work.&packageName.fcmp.packagemeta;"
|
||||
/ "deletefunc &packageName.META;"
|
||||
/ "quit;" /;
|
||||
isFunction + 1;
|
||||
|
||||
/* delete the link to the functions dataset */
|
||||
if isFunction then
|
||||
@@ -4410,7 +4493,7 @@ data _null_;
|
||||
%end;
|
||||
|
||||
put 'put " " / @3 "---------------------------------------------------------------------" / " ";'
|
||||
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260125`*";'
|
||||
/ 'put @3 "*SAS package generated by SAS Package Framework, version `20260216`*";'
|
||||
/ "put @3 '*under `&sysscp.`(`&sysscpl.`) operating system,*';"
|
||||
/ "put @3 '*using SAS release: `&sysvlong4.`.*';"
|
||||
/ 'put " " / @3 "---------------------------------------------------------------------";';
|
||||
@@ -4849,7 +4932,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 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the test part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
@@ -4922,6 +5005,22 @@ run;
|
||||
put @n '%loadpackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation., lazyData=*)" /;
|
||||
|
||||
/* meta */
|
||||
put @n '%put >>>%'"&packageName."'META( )<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(V)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(D)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(A)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(M)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(L)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(E)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(T)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(P)<<<;'/
|
||||
@n '%put >>>%'"&packageName."'META(S)<<<;'/;
|
||||
|
||||
/* verify */
|
||||
put @n '%verifyPackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation.)" /;
|
||||
|
||||
/* help */
|
||||
put @n '%helpPackage'"(&packageName.,";
|
||||
put @n " path=&buildLocation.)" /;
|
||||
@@ -5141,6 +5240,23 @@ data _null_;
|
||||
put '%loadpackage'"(&packageName.,"
|
||||
/ " path=&buildLocation., lazyData=*)" /;
|
||||
|
||||
/* meta */
|
||||
put '%put >>null >%'"&packageName."'META( )<<<;'/
|
||||
'%put >>unknown >%'"&packageName."'META(U)<<<;'/ /* test for unknown values */
|
||||
'%put >>version >%'"&packageName."'META(V)<<<;'/
|
||||
'%put >>datetime >%'"&packageName."'META(D)<<<;'/
|
||||
'%put >>authors >%'"&packageName."'META(A)<<<;'/
|
||||
'%put >>maintainers >%'"&packageName."'META(M)<<<;'/
|
||||
'%put >>license >%'"&packageName."'META(L)<<<;'/
|
||||
'%put >>encoding >%'"&packageName."'META(E)<<<;'/
|
||||
'%put >>title >%'"&packageName."'META(T)<<<;'/
|
||||
'%put >>req packages>%'"&packageName."'META(P)<<<;'/
|
||||
'%put >>req SAS >%'"&packageName."'META(S)<<<;'/;
|
||||
|
||||
/* verify */
|
||||
put '%verifyPackage'"(&packageName.,";
|
||||
put " path=&buildLocation.)" /;
|
||||
|
||||
/* help */
|
||||
put '%helpPackage'"(&packageName.,"
|
||||
/ " path=&buildLocation.)" /;
|
||||
@@ -5498,7 +5614,7 @@ options "elenmax_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 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the markdown documentation part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
@@ -5610,7 +5726,7 @@ data &filesWithCodes.markdown;
|
||||
%end;
|
||||
|
||||
put " " / "---------------------------------------------------------------------" / " "
|
||||
/ "*SAS package generated by SAS Package Framework, version `20260125`,*"
|
||||
/ "*SAS package generated by SAS Package Framework, version `20260216`,*"
|
||||
/ "*under `&sysscp.`(`&sysscpl.`) operating system,*"
|
||||
/ "*using SAS release: `&sysvlong4.`.*"
|
||||
/ " " / "---------------------------------------------------------------------" / " ";
|
||||
@@ -5751,7 +5867,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 20260125.';
|
||||
des='SAS Packages Framework internal macro. Executable only inside the %generatePackage() macro. The macro encapsulates the archive version generation part of the process. Version 20260216.';
|
||||
/* macro picks up all macrovariables from external scope, so from the %generatePackage() macro */
|
||||
%if %sysmexecname(%sysmexecdepth-1) in (GENERATEPACKAGE) %then
|
||||
%do;
|
||||
@@ -5918,7 +6034,7 @@ TODO: (in Polish)
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20260125. Run %loadPackages() for help info.'
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20260216. Run %loadPackages() for help info.'
|
||||
parmbuff
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
@@ -5934,7 +6050,7 @@ parmbuff
|
||||
%put ### This is short help information for the `loadPackageS` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20260125` #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -6027,12 +6143,12 @@ parmbuff
|
||||
, path = %sysfunc(pathname(packages)) /* location of a package,
|
||||
by default it looks for
|
||||
location of "packages" fileref */
|
||||
, hash = /* The SHA256 hash digest for
|
||||
, hash = F* /* The SHA256 hash digest for
|
||||
the package generated by
|
||||
hashing_file() function, SAS 9.4M6 */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %verifyPackage() for help info.'
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20260216. Run %verifyPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -6047,7 +6163,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put ### This is short help information for the `verifyPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20260125` #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -6067,7 +6183,9 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put # If empty displays this help information. #;
|
||||
%put # #;
|
||||
%put # - `hash=` A value of the package `SHA256` hash. #;
|
||||
%put # Provided by the user. #;
|
||||
%put # Provided by the user. When the value is not provided #;
|
||||
%put # then macro calculates `SHA256`, `SHA1`, and `MD5` #;
|
||||
%put # digests and display then in the log. #;
|
||||
%put # #;
|
||||
%put # - `path=` Location of a package. By default it looks for #;
|
||||
%put # location of the "packages" fileref, i.e. #;
|
||||
@@ -6095,7 +6213,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
%put ;
|
||||
%put %nrstr( %%installPackage(SQLinDS) %%* install the package from the Internet; );
|
||||
%put %nrstr( %%verifyPackage%(SQLinDS, %%* verify the package with provided hash; );
|
||||
%put %nrstr( hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%) );
|
||||
%put %nrstr( hash=HDA478ANJ3HKHRY327FGE88HF89VH89HFFFV73GCV98RF390VB4%) );
|
||||
%put ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~;
|
||||
%put #################################################################################;
|
||||
%put ;
|
||||
@@ -6116,19 +6234,21 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
|
||||
|
||||
%local _PackageFileref_ checkExist;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
data _null_;
|
||||
length packageName $ 140;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".zip")); /* check on zip files only! */
|
||||
exists + fileexist(catx("/", p, cats(packageName,".zip"))); /* check on zip files only! */
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -6161,31 +6281,60 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
filename &_PackageFileref_. list;
|
||||
|
||||
data _null_;
|
||||
length providedHash $ 128;
|
||||
length providedHash $ 128 packageName $ 140;
|
||||
providedHash = strip(symget("hash"));
|
||||
select;
|
||||
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
|
||||
SHA256 = 'F*' !! HASHING_FILE("SHA256", pathname("&_PackageFileref_.",'F'), 0);
|
||||
when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */
|
||||
SHA256 = 'C*' !! HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
|
||||
otherwise /* legacy approach, without C or F, digest value equivalent to C */
|
||||
SHA256 = HASHING_FILE("SHA256", "&_PackageFileref_.", 4);
|
||||
end;
|
||||
put "Provided Hash: " providedHash;
|
||||
put "SHA256 digest: " SHA256;
|
||||
put " ";
|
||||
|
||||
if upcase(SHA256) = upcase(providedHash) then
|
||||
do;
|
||||
put "NOTE: Package verification SUCCESSFUL.";
|
||||
put "NOTE- Generated hash is EQUAL to the provided one.";
|
||||
packageName = strip(symget("packageName"));
|
||||
|
||||
emptyHash = (providedHash = " " OR providedHash in ("F*" "f*" "C*" "c*"));
|
||||
|
||||
put 82*"-" / @2 packageName / 82*"-" /;
|
||||
|
||||
if NOT emptyHash then put "Provided Hash: " providedHash;
|
||||
|
||||
length method $ 8 digest $ 128;
|
||||
/* calculate SHA256 */
|
||||
method="SHA256";
|
||||
LINK CalcualteHashDigest; /* go to Link 1 */
|
||||
|
||||
if NOT emptyHash then
|
||||
do; /* step for veryfication */
|
||||
if upcase(digest) = upcase(providedHash) then
|
||||
do;
|
||||
put "NOTE: Verification SUCCESSFUL."
|
||||
/ "NOTE- Generated hash is EQUAL to the provided one." / ;
|
||||
end;
|
||||
else
|
||||
do;
|
||||
pos = 0;
|
||||
do i = 1 to max(lengthn(digest),lengthn(providedHash)) while(pos=0);
|
||||
if char(digest,i) NE char(providedHash,i) then pos = i;
|
||||
end;
|
||||
put "ERROR- " @(pos+15)"^"/"ERROR- " @(pos+15)"| diff @" pos/"ERROR- ";
|
||||
put "ERROR: Verification FAILED!!"
|
||||
/ "ERROR- Generated hash is DIFFERENT than the provided one."
|
||||
/ "ERROR- Check if the ZIP is genuine." / ;
|
||||
end;
|
||||
end;
|
||||
else
|
||||
do;
|
||||
put "ERROR: Package verification FAILED!!";
|
||||
put "ERROR- Generated hash is DIFFERENT than the provided one.";
|
||||
put "ERROR- Confirm if the package is genuine.";
|
||||
do method = "SHA1", "MD5"; /* step for digest display, calcualte also SHA1 and MD5 */
|
||||
LINK CalcualteHashDigest; /* go to Link 1 */
|
||||
end;
|
||||
put 82*"-" /;
|
||||
stop;
|
||||
return;
|
||||
CalcualteHashDigest: /* Link 1 */
|
||||
|
||||
select;
|
||||
when ( 'F*' = upcase(substr(providedHash,1,2)) ) /* F = file digest */
|
||||
digest = 'F*' !! HASHING_FILE(method, pathname("&_PackageFileref_.",'F'), 0);
|
||||
when ( 'C*' = upcase(substr(providedHash,1,2)) ) /* C = content digest */
|
||||
digest = 'C*' !! HASHING_FILE(method, "&_PackageFileref_.", 4);
|
||||
otherwise /* legacy approach, without C or F, digest value equivalent to C */
|
||||
digest = HASHING_FILE(method, "&_PackageFileref_.", 4);
|
||||
end;
|
||||
put method "digest: " digest /;
|
||||
|
||||
return;
|
||||
run;
|
||||
%let HASHING_FILE_exist = 0;
|
||||
%end;
|
||||
@@ -6230,7 +6379,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20260125. Run %
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to preview content of a SAS package, version 20260125. Run %previewPackage() for help info.'
|
||||
des = 'Macro to preview content of a SAS package, version 20260216. Run %previewPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -6245,7 +6394,7 @@ des = 'Macro to preview content of a SAS package, version 20260125. Run %preview
|
||||
%put ### This is short help information for the `previewPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get preview of a SAS packages, version `20260125` #;
|
||||
%put # Macro to get preview of a SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -6326,18 +6475,20 @@ des = 'Macro to preview content of a SAS package, version 20260125. Run %preview
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "P" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -6377,7 +6528,7 @@ des = 'Macro to preview content of a SAS package, version 20260125. Run %preview
|
||||
when empty the "packages" value is used */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to list directories pointed by "packages" fileref, version 20260125. Run %extendPackagesFileref(HELP) for help info.'
|
||||
des = 'Macro to list directories pointed by "packages" fileref, version 20260216. Run %extendPackagesFileref(HELP) for help info.'
|
||||
;
|
||||
|
||||
%if %QUPCASE(&packages.) = HELP %then
|
||||
@@ -6393,7 +6544,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20260125
|
||||
%put ### This is short help information for the `extendPackagesFileref` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to list directories pointed by 'packages' fileref, version `20260125` #;
|
||||
%put # Macro to list directories pointed by 'packages' fileref, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -6495,7 +6646,7 @@ filename packages list;
|
||||
is provided in required version */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load additional content for a SAS package, version 20260125. Run %loadPackageAddCnt() for help info.'
|
||||
des = 'Macro to load additional content for a SAS package, version 20260216. Run %loadPackageAddCnt() for help info.'
|
||||
minoperator
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
@@ -6511,7 +6662,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 `20260125` #;
|
||||
%put # Macro to *load* additional content for a SAS package, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -6592,20 +6743,22 @@ minoperator
|
||||
options NOnotes NOsource ls=MAX ps=MAX NOfullstimer NOstimer msglevel=N NOmautocomploc;
|
||||
|
||||
%local _PackageFileref_;
|
||||
data _null_;
|
||||
call symputX("_PackageFileref_", "A" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
call symputX("_TargetFileref_", "T" !! put(MD5(lowcase("&packageName.")), hex7. -L), "L");
|
||||
run;
|
||||
data _null_;
|
||||
length packageName $ 32;
|
||||
packageName = lowcase(symget("packageName"));
|
||||
call symputX("_PackageFileref_", "A" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
call symputX("_TargetFileref_", "T" !! put(MD5(strip(packageName)), hex7. -L), "L");
|
||||
/*run;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
|
||||
/* when the packages reference is multi-directory search for the first one containing the package */
|
||||
data _null_;
|
||||
/*data _null_;*/ /* <- comment out, because it can be 1 data step, not 2 */
|
||||
exists = 0;
|
||||
length packages $ 32767 p $ 4096;
|
||||
packages = resolve(symget("path"));
|
||||
if char(packages,1) ^= "(" then packages = quote(strip(packages)); /* for paths with spaces */
|
||||
do i = 1 to kcountw(packages, "()", "QS");
|
||||
p = dequote(kscanx(packages, i, "()", "QS"));
|
||||
exists + fileexist(catx("/", p, lowcase("&packageName.") !! ".&zip."));
|
||||
exists + fileexist(catx("/", p, cats(packageName,".&zip.")));
|
||||
if exists then leave;
|
||||
end;
|
||||
if exists then call symputx("path", p, "L");
|
||||
@@ -6880,7 +7033,7 @@ minoperator
|
||||
,nobs=0 /* technical parameter */
|
||||
)
|
||||
/*** HELP END ***/
|
||||
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260125. Run %splitCodeForPackage() for help info.'
|
||||
/ des = 'Utility macro to split "one big" code into multiple files for a SAS package, version 20260216. Run %splitCodeForPackage() for help info.'
|
||||
;
|
||||
%if (%superq(codeFile) = ) OR (%qupcase(&codeFile.) = HELP) %then
|
||||
%do;
|
||||
@@ -6896,7 +7049,7 @@ minoperator
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Utility macro to *split* single file with SAS package code into multiple #;
|
||||
%put # files with separate snippets, version `20260125` #;
|
||||
%put # files with separate snippets, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -7272,7 +7425,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 20260125. */';
|
||||
put '/* File generated with help of SAS Packages Framework, version 20260216. */';
|
||||
firstLine[j]=0;
|
||||
end;
|
||||
put _infile_;
|
||||
@@ -7305,7 +7458,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 20260125. Run %relocatePackage() for help info.'
|
||||
/ des = 'Utility macro that locally Copies or Moves Packages, version 20260216. Run %relocatePackage() for help info.'
|
||||
secure
|
||||
minoperator
|
||||
;
|
||||
@@ -7323,7 +7476,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 `20260125` #;
|
||||
%put # Macro to *locally copy or move* (relocate) SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -7981,7 +8134,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 20260125.'
|
||||
des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFilerefOK(HELP) for help, version 20260216.'
|
||||
;
|
||||
/*** HELP END ***/
|
||||
%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
|
||||
@@ -7997,7 +8150,7 @@ des = 'Macro to check if the PACKAGES fileref is "correct", type %isPackagesFile
|
||||
%put ### This is short help information for the `isPackagesFilerefOK` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to check if the `packages` fileref is "correct", version `20260125` #;
|
||||
%put # Macro to check if the `packages` fileref is "correct", version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -8131,7 +8284,7 @@ SPFmacroName /* space separated list of names */
|
||||
/
|
||||
minoperator
|
||||
secure
|
||||
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260125. Run %SasPackagesFrameworkNotes(HELP) for help info.'
|
||||
des = 'Macro to provide help notes about SAS Packages Framework macros, version 20260216. Run %SasPackagesFrameworkNotes(HELP) for help info.'
|
||||
;
|
||||
%local list N i element;
|
||||
%let list=
|
||||
@@ -8177,7 +8330,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 `20260125` #;
|
||||
%put # Macro prints help notes for SAS Packages Framework macros, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -8300,7 +8453,7 @@ options mlogic symbolgen;
|
||||
,packagesRef=packages
|
||||
,ods= /* data set for report file */
|
||||
)/
|
||||
des='Macro to create a bundle of SAS packages, version 20260125. Run %bundlePackages(HELP) for help info.'
|
||||
des='Macro to create a bundle of SAS packages, version 20260216. Run %bundlePackages(HELP) for help info.'
|
||||
secure minoperator
|
||||
;
|
||||
|
||||
@@ -8317,7 +8470,7 @@ secure minoperator
|
||||
%put ### This is short help information for the `bundlePackages` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *create bundles* of SAS packages, version `20260125` #;
|
||||
%put # Macro to *create bundles* of SAS packages, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -8802,7 +8955,7 @@ filename p2 "R:/dontexist";
|
||||
,ods= /* data set for report file */
|
||||
,verify=0
|
||||
)/
|
||||
des='Macro to extract a bundle of SAS packages, version 20260125. Run %unbundlePackages(HELP) for help info.'
|
||||
des='Macro to extract a bundle of SAS packages, version 20260216. Run %unbundlePackages(HELP) for help info.'
|
||||
secure
|
||||
minoperator
|
||||
;
|
||||
@@ -8820,7 +8973,7 @@ minoperator
|
||||
%put ### This is short help information for the `unbundlePackages` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *extract* SAS packages from a bundle, version `20260125` #;
|
||||
%put # Macro to *extract* SAS packages from a bundle, version `20260216` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -8922,11 +9075,10 @@ minoperator
|
||||
%let datetime = %sysfunc(datetime());
|
||||
%let reportFile = WORK.tmpbundlefile%sysfunc(int(&datetime.), b8601dt15.)_;
|
||||
|
||||
data _null_ ;
|
||||
data _null_;
|
||||
datetime=symgetn('datetime');
|
||||
|
||||
length packagesList $ 32767 bundleName $ 128;
|
||||
|
||||
bundleName = compress(symget('bundleName'),"_.","KAD"); /* bundle name is letters, digits, and underscore, up to 128 symbols */
|
||||
|
||||
if bundleName NE symget('bundleName') then /* warn about illegal characters */
|
||||
@@ -8934,12 +9086,12 @@ if bundleName NE symget('bundleName') then /* warn about illegal characters */
|
||||
put "ERROR: Bundle name contains illegal characters. Exiting";
|
||||
stop;
|
||||
end;
|
||||
|
||||
bundleName=lowcase(bundleName);
|
||||
lbn = length(bundleName); /* to cover lengths < 7 & 11 */
|
||||
/* if there is ".bundle.zip" extension added, remove it */
|
||||
if substr(strip(reverse(bundleName)),1,11) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
|
||||
if substr(strip(reverse(bundleName)),1,min(11,lbn)) = 'piz.eldnub.' then bundleName=scan(bundleName,-3,".");
|
||||
else /* if there is ".bundle" extension added, remove it */
|
||||
if substr(strip(reverse(bundleName)),1,7) = 'eldnub.' then bundleName=scan(bundleName,-2,".");
|
||||
if substr(strip(reverse(bundleName)),1,min(7,lbn)) = 'eldnub.' then bundleName=scan(bundleName,-2,".");
|
||||
|
||||
put / "INFO: Bundle name is: " bundleName / ;
|
||||
|
||||
@@ -8947,7 +9099,6 @@ length packagesPath $ 32767 packagesRef $ 8;
|
||||
packagesPath = dequote(symget('packagesPath'));
|
||||
packagesRef = upcase(strip(symget('packagesRef')));
|
||||
|
||||
|
||||
/* organize target path (location for packages) */
|
||||
if " "=packagesPath then
|
||||
do;
|
||||
@@ -9075,7 +9226,6 @@ label package="Package name"
|
||||
hash="SHA256 for the Package";
|
||||
/*--------------------------------------------------*/
|
||||
|
||||
|
||||
if 0=Q.NUM_ITEMS then /* ... if empty then exit */
|
||||
do;
|
||||
put "WARNING: No packages to unbundle. Exiting!";
|
||||
@@ -9114,7 +9264,6 @@ put / "INFO: The " bundleName "bundle extraction ended.";
|
||||
rc = doSubL(code2);
|
||||
put / "INFO: The " bundleName "bundle verification ended.";
|
||||
%end;
|
||||
|
||||
put " ";
|
||||
rc=sleep(1,1);
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ Packages:
|
||||
|
||||
---
|
||||
|
||||
- **SQLinDS**\[2.3.1\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
|
||||
- **SQLinDS**\[2.3.3\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
|
||||
```sas
|
||||
data class;
|
||||
set %SQL(
|
||||
@@ -22,13 +22,13 @@ data class;
|
||||
WH = weight + height;
|
||||
run;
|
||||
```
|
||||
SHA256 digest for SQLinDS: F*606A24A2A6B06DAAD2D443FA9A9819D9564235A5CD8599FD15586F1EFFCB41BC
|
||||
SHA256 digest for SQLinDS: F*6CC51325BDCE164B2E811896DD1C3A6D44242F50CC313D0721350CA49975F628
|
||||
|
||||
[Documentation for SQLinDS](https://github.com/SASPAC/blob/main/sqlinds.md "Documentation for SQLinDS")
|
||||
|
||||
---
|
||||
|
||||
- **DFA** (Dynamic Function Arrays)\[0.5.7\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
- **DFA** (Dynamic Function Arrays)\[0.5.10\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
```sas
|
||||
%createDFArray(ArrDynamic, resizefactor=17);
|
||||
|
||||
@@ -55,13 +55,13 @@ data _null_;
|
||||
end;
|
||||
run;
|
||||
```
|
||||
SHA256 digest for DFA: F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045BEB958168
|
||||
SHA256 digest for DFA: F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9
|
||||
|
||||
[Documentation for DFA](https://github.com/SASPAC/blob/main/dfa.md "Documentation for DFA")
|
||||
|
||||
---
|
||||
|
||||
- **macroArray**\[1.3.0\], implementation of an array concept in a macro language, e.g.
|
||||
- **macroArray**\[1.3.2\], implementation of an array concept in a macro language, e.g.
|
||||
```sas
|
||||
%array(ABC[17] (111:127), macarray=Y);
|
||||
|
||||
@@ -80,13 +80,13 @@ SHA256 digest for DFA: F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045
|
||||
which = 1:H:2
|
||||
);
|
||||
```
|
||||
SHA256 digest for macroArray: F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24
|
||||
SHA256 digest for macroArray: F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9
|
||||
|
||||
[Documentation for macroArray](https://github.com/SASPAC/blob/main/macroarray.md "Documentation for macroArray")
|
||||
|
||||
---
|
||||
|
||||
- **BasePlus**\[3.1.1\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
- **BasePlus**\[3.1.4\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
```sas
|
||||
call arrMissToRight(myArray);
|
||||
call arrFillMiss(17, myArray);
|
||||
@@ -120,13 +120,13 @@ format x bool.;
|
||||
|
||||
%workLib(ABC)
|
||||
```
|
||||
SHA256 digest for BasePlus: F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F4A561BDDF274A6
|
||||
SHA256 digest for BasePlus: F*BD248E5F8CBD94B5F45467B723A73D97D646CD665BA98679F87C7A03A484E83E
|
||||
|
||||
[Documentation for BasePlus](https://github.com/SASPAC/blob/main/baseplus.md "Documentation for BasePlus")
|
||||
|
||||
---
|
||||
|
||||
- **GSM** (Generate Secure Macros)\[0.22.1\], package allows
|
||||
- **GSM** (Generate Secure Macros)\[0.22.3\], package allows
|
||||
to create secured macros stored in SAS Proc FCMP functions.
|
||||
The dataset with functions can be shared between different operating systems
|
||||
and allows to generate macros on site without showing their code.
|
||||
@@ -135,7 +135,7 @@ SHA256 digest for BasePlus: F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F
|
||||
|
||||
[The WUSS 2023 Conference article describing the idea](https://www.wuss.org/proceedings/2023/WUSS-2023-Paper-189.pdf "Article about the idea GSM")
|
||||
|
||||
SHA256 digest for GSM: F*80197391195C3EC41BD436DF0C8802D3920E4D22B64009A7DE872FBDF8D4B86E
|
||||
SHA256 digest for GSM: F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1
|
||||
|
||||
[Documentation for GSM](https://github.com/SASPAC/blob/main/gsm.md "Documentation for GSM")
|
||||
|
||||
|
||||
@@ -1,3 +1,21 @@
|
||||
/* 20260217 */
|
||||
BasePlus: F*BD248E5F8CBD94B5F45467B723A73D97D646CD665BA98679F87C7A03A484E83E
|
||||
DFA: F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9
|
||||
GSM: F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1
|
||||
macroArray: F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9
|
||||
SQLinDS: F*6CC51325BDCE164B2E811896DD1C3A6D44242F50CC313D0721350CA49975F628
|
||||
|
||||
/* 20260202 */
|
||||
BasePlus: F*B762F900EEFF7035880891D89416C0F973E4D377BCB75486283363A9BDADBA82
|
||||
DFA: F*17C88537F5FA9BCFAA1AC4803D0F1EF47665C8446A44C82B5558A08315DF0C49
|
||||
|
||||
/* 20260126 */
|
||||
BasePlus: F*91A5AD4709A418704315EF37DDCF954522D4FB42808D406B3ED4DA560F6864C6
|
||||
DFA: F*643FBE2B7AE1425FC0240139813B93AE2C6BCFFDF6A0CFAEBEC11F83D3548E57
|
||||
GSM: F*7A4FEC410DEB921613A33F154FBBE332D7EC4C4DAC1351A4E611D986489EE848
|
||||
macroArray: F*9DA64CA9A745E1DB7176F7AF4459BB014F61F71626473ABF6471A32689E14FF1
|
||||
SQLinDS: F*CEAA4C90515F6E8AACBFFD55ABA6544E399EDBE0A7081107B62DCEE6F5430A1D
|
||||
|
||||
/* 20260113 */
|
||||
macroArray: F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24
|
||||
|
||||
|
||||
@@ -9,23 +9,21 @@
|
||||
### Version information:
|
||||
|
||||
- Package: BasePlus
|
||||
- Version: 3.1.1
|
||||
- Generated: 2025-11-05T15:10:31
|
||||
- Version: 3.1.4
|
||||
- Generated: 2026-02-17T12:22:24
|
||||
- Author(s): Bartosz Jablonski (yabwon@gmail.com), contributors are Quentin McMullen (qmcmullen@gmail.com) and Ryo Nakaya (nakaya.ryou@gmail.com)
|
||||
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- License: MIT
|
||||
- File SHA256: `F*6394CE27FBCF48D475F682CBCF8CA8B4FDD6D40D2672EF571F4A561BDDF274A6` for this version
|
||||
- Content SHA256: `C*3CA28DF8F3E6D6670D7FD44788D347452F24F4BCF18115873E7EBC742FE30CA4` for this version
|
||||
- File SHA256: `F*BD248E5F8CBD94B5F45467B723A73D97D646CD665BA98679F87C7A03A484E83E` for this version
|
||||
- Content SHA256: `C*373E1A4CDC1A2462C90D6EC88E2BAA2F9902DFE5C6A4CC70356EE7281337C70A` for this version
|
||||
|
||||
---
|
||||
|
||||
# The `BasePlus` package, version: `3.1.1`;
|
||||
# The `BasePlus` package, version: `3.1.4`;
|
||||
|
||||
---
|
||||
|
||||
|
||||
# The BasePlus package [ver. 3.1.1] <a name="baseplus-package"></a> ###############################################
|
||||
|
||||
The **BasePlus** package implements useful
|
||||
functions and functionalities I miss in the BASE SAS.
|
||||
|
||||
@@ -407,11 +405,13 @@ Package contains additional content, run: `%loadPackageAddCnt(BasePlus)` to lo
|
||||
or look for the `baseplus_AdditionalContent` directory in the `packages` fileref
|
||||
localization (only if additional content was deployed during the installation process).
|
||||
|
||||
--------------------------------------------------------------------
|
||||
---------------------------------------------------------------------
|
||||
|
||||
*SAS package generated by SAS Package Framework, version `20251017`*
|
||||
*SAS package generated by SAS Package Framework, version `20260216`,*
|
||||
*under `WIN`(`X64_10PRO`) operating system,*
|
||||
*using SAS release: `9.04.01M9P06042025`.*
|
||||
|
||||
--------------------------------------------------------------------
|
||||
---------------------------------------------------------------------
|
||||
|
||||
# The `BasePlus` package content
|
||||
The `BasePlus` package consists of the following content:
|
||||
@@ -7738,7 +7738,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
|
||||
# License <a name="license"></a> ######
|
||||
|
||||
Copyright (c) 2020 - 2025 Bartosz Jablonski
|
||||
Copyright (c) 2020 - 2026 Bartosz Jablonski
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
|
||||
Binary file not shown.
352
packages/dfa.md
352
packages/dfa.md
@@ -1,24 +1,28 @@
|
||||
- [The DFA package](#dfa-package)
|
||||
- [Content description](#content-description)
|
||||
* [`%createDFArray()` macro](#createdfarray-macro)
|
||||
* [`%createDHArray()` macro](#createdharray-macro)
|
||||
* [`%createDHFifo()` macro](#createdhfifo-macro)
|
||||
* [`%createDHOrdStack()` macro](#createdhordstack-macro)
|
||||
* [`%createDHPrtQueue()` macro](#createdhprtqueue-macro)
|
||||
* [`%createDHStack()` macro](#createdhstack-macro)
|
||||
* [`bit64orPROTOdfa()` proto function](#bit64orprotodfa-proto-function)
|
||||
* [`bit64andPROTOdfa()` proto function](#bit64andprotodfa-proto-function)
|
||||
* [`bit64orDFA()` subroutine](#bit64ordfa-function)
|
||||
* [`bit64andDFA()` subroutine](#bit64anddfa-function)
|
||||
* [`%createDFBitmap()` macro](#createdfbitmap-macro)
|
||||
* [`generateArrays` exec](#createdhprtqueue-exec)
|
||||
* [`generateArrays` clean](#createdhprtqueue-clean)
|
||||
# Documentation for the `DFA` package.
|
||||
|
||||
----------------------------------------------------------------
|
||||
|
||||
*Dynamic function arrays and other useful data structures*
|
||||
|
||||
----------------------------------------------------------------
|
||||
|
||||
### Version information:
|
||||
|
||||
- Package: DFA
|
||||
- Version: 0.5.10
|
||||
- Generated: 2026-02-17T12:17:54
|
||||
- Author(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- License: MIT
|
||||
- File SHA256: `F*C1E5126D8EDE050A758BCB5DCCA56A37125B3646CE75F1CF41EDE00890901AD9` for this version
|
||||
- Content SHA256: `C*EE048846A8155C317867DCDB8EE1AE9E0352235DC247E4379D101A7296BD0C07` for this version
|
||||
|
||||
* [License](#license)
|
||||
|
||||
---
|
||||
|
||||
# The DFA package [ver. 0.5.7] <a name="dfa-package"></a> ###############################################
|
||||
|
||||
# The `DFA` package, version: `0.5.10`;
|
||||
|
||||
---
|
||||
|
||||
|
||||
The **DFA** (a.k.a. *Dynamic Function Array*) package implements:
|
||||
- dynamic numeric and character arrays,
|
||||
@@ -36,30 +40,50 @@ Few exemplary functions are also generated.
|
||||
See particular macro help for further details.
|
||||
|
||||
---
|
||||
|
||||
Package contains:
|
||||
1. macro createdfarray
|
||||
2. macro createdharray
|
||||
3. macro createdhfifo
|
||||
4. macro createdhordstack
|
||||
5. macro createdhprtqueue
|
||||
6. macro createdhstack
|
||||
7. proto bit64andprotodfa
|
||||
8. proto bit64orprotodfa
|
||||
9. functions bit64anddfa
|
||||
10. functions bit64ordfa
|
||||
11. macro createdfbitmap
|
||||
12. exec generatearrays
|
||||
13. clean generatearrays
|
||||
|
||||
*SAS package generated by generatePackage, version 20231111*
|
||||
|
||||
The SHA256 hash digest for package DFA:
|
||||
`F*012375D87F66EB3A7BF5DDD0CC5AEE28851733EE33CC63231DF9045BEB958168`
|
||||
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
Required SAS Components:
|
||||
- Base SAS Software
|
||||
|
||||
---
|
||||
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
*SAS package generated by SAS Package Framework, version `20260216`,*
|
||||
*under `WIN`(`X64_10PRO`) operating system,*
|
||||
*using SAS release: `9.04.01M9P06042025`.*
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
# The `DFA` package content
|
||||
The `DFA` package consists of the following content:
|
||||
|
||||
1. [`%createdfarray()` macro ](#createdfarray-macro-1 )
|
||||
2. [`%createdharray()` macro ](#createdharray-macro-2 )
|
||||
3. [`%createdhfifo()` macro ](#createdhfifo-macro-3 )
|
||||
4. [`%createdhordstack()` macro ](#createdhordstack-macro-4 )
|
||||
5. [`%createdhprtqueue()` macro ](#createdhprtqueue-macro-5 )
|
||||
6. [`%createdhstack()` macro ](#createdhstack-macro-6 )
|
||||
7. [`bit64andprotodfa()` proto ](#bit64andprotodfa-proto-7 )
|
||||
8. [`bit64orprotodfa()` proto ](#bit64orprotodfa-proto-8 )
|
||||
9. [`bit64anddfa()` function ](#bit64anddfa-functions-9 )
|
||||
10. [`bit64ordfa()` function ](#bit64ordfa-functions-10 )
|
||||
11. [`%createdfbitmap()` macro ](#createdfbitmap-macro-11 )
|
||||
12. [`generatearrays` exec ](#generatearrays-exec-12 )
|
||||
13. [`generatearrays` clean ](#generatearrays-clean-13 )
|
||||
|
||||
|
||||
14. [License note](#license)
|
||||
|
||||
---
|
||||
|
||||
## `%createdfarray()` macro <a name="createdfarray-macro-1"></a> ######
|
||||
|
||||
## >>> `%createDFArray()` macro: <<< <a name="createdfarray-macro"></a> #######################
|
||||
|
||||
The `%createDFArray()` macro allows to generate
|
||||
@@ -122,7 +146,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -172,6 +196,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Searchable, and Immutable array:
|
||||
@@ -309,6 +334,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdharray()` macro <a name="createdharray-macro-2"></a> ######
|
||||
|
||||
## >>> `%createDHArray()` macro: <<< <a name="createdharray-macro"></a> #######################
|
||||
|
||||
The `%createDHArray()` macro allows to generate
|
||||
@@ -360,7 +391,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -397,6 +428,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Hash-based, and Character array:
|
||||
@@ -464,6 +496,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdhfifo()` macro <a name="createdhfifo-macro-3"></a> ######
|
||||
|
||||
## >>> `%createDHFifo()` macro: <<< <a name="createdhfifo-macro"></a> #######################
|
||||
|
||||
The `%createDHFifo()` macro allows to generate
|
||||
@@ -519,7 +557,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -550,7 +588,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Hash-based, and Character fifo:
|
||||
@@ -639,6 +677,12 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdhordstack()` macro <a name="createdhordstack-macro-4"></a> ######
|
||||
|
||||
## >>> `%createDHOrdStack()` macro: <<< <a name="createdhordstack-macro"></a> #######################
|
||||
|
||||
The `%createDHOrdStack()` macro allows to generate
|
||||
@@ -699,7 +743,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -732,7 +776,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Hash-based, and Character Descending Ordered stack:
|
||||
@@ -804,6 +848,12 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdhprtqueue()` macro <a name="createdhprtqueue-macro-5"></a> ######
|
||||
|
||||
## >>> `%createDHPrtQueue()` macro: <<< <a name="createdhprtqueue-macro"></a> #######################
|
||||
|
||||
|
||||
@@ -860,7 +910,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -901,7 +951,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Hash-based, and Character Priority queue:
|
||||
@@ -965,6 +1015,12 @@ The `position` and the `value` arguments are **outargs**, i.e. can be changed by
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdhstack()` macro <a name="createdhstack-macro-6"></a> ######
|
||||
|
||||
## >>> `%createDHStack()` macro: <<< <a name="createdhstack-macro"></a> #######################
|
||||
|
||||
The `%createDHStack()` macro allows to generate
|
||||
@@ -1020,7 +1076,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -1050,7 +1106,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Dynamic, Hash-based, and Character stack:
|
||||
@@ -1128,31 +1184,11 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64orPROTOdfa()` proto function: <<< <a name="bit64orprotodfa-proto-function"></a> #######################
|
||||
|
||||
The **bit64orPROTOdfa()** is external *C* function,
|
||||
this is the implementation of the *bitwise OR* operation
|
||||
on doubles. A double is returned.
|
||||
|
||||
**Caution!** For SAS numeric values *only* operations on first 53 bits are valid!
|
||||
|
||||
The function is used **internally** by functions in the *DFA* package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orPROTOdfa(i, j)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `i` - A double numeric argument.
|
||||
|
||||
2. `j` - A double numeric argument.
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
## `bit64andprotodfa()` proto <a name="bit64andprotodfa-proto-7"></a> ######
|
||||
|
||||
## >>> `bit64andPROTOdfa()` proto function: <<< <a name="bit64andprotodfa-proto-function"></a> #######################
|
||||
|
||||
The **bit64andPROTOdfa()** is external *C* function,
|
||||
@@ -1178,62 +1214,41 @@ bit64andPROTOdfa(i, j)
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64orDFA()` subroutine: <<< <a name="bit64ordfa-function"></a> #######################
|
||||
|
||||
---
|
||||
|
||||
## `bit64orprotodfa()` proto <a name="bit64orprotodfa-proto-8"></a> ######
|
||||
|
||||
## >>> `bit64orPROTOdfa()` proto function: <<< <a name="bit64orprotodfa-proto-function"></a> #######################
|
||||
|
||||
The **bit64orDFA()** function is an alternative to
|
||||
the 32 bit bitwise `BOR()` function working on SAS numerics.
|
||||
Allows to work on *up to* 53 bits of SAS numeric value.
|
||||
The **bit64orPROTOdfa()** is external *C* function,
|
||||
this is the implementation of the *bitwise OR* operation
|
||||
on doubles. A double is returned.
|
||||
|
||||
The `bit64orDFA()` is an *internal* function of the `DFA` package.
|
||||
**Caution!** For SAS numeric values *only* operations on first 53 bits are valid!
|
||||
|
||||
The function is used **internally** by functions in the *DFA* package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orDFA(a, b)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
The basic syntax is the following:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orPROTOdfa(i, j)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `a` - Argument is a SAS numeric values.
|
||||
1. `i` - A double numeric argument.
|
||||
|
||||
2. `B` - Argument is a SAS numeric values.
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
options ls = max ps = max;
|
||||
%let M = 53 ; %* 53 is maximum valid value;
|
||||
data _null_;
|
||||
array bitmask [ 0: &M] _temporary_ ;
|
||||
do P = 1 to &M ;
|
||||
bitmask[P] = 2**(P-1) ;
|
||||
put bitmask[P] = binary54. @;
|
||||
put bitmask[P] = best32.;
|
||||
end ;
|
||||
bitmask[0] = bitmask[&M.] ;
|
||||
put bitmask[0] = best32. /;
|
||||
|
||||
a=0;
|
||||
put a = binary54.;
|
||||
do P = 1 to &M ;
|
||||
a = BIT64ORDFA (a, bitmask[P]) ;
|
||||
put a = binary54.;
|
||||
end;
|
||||
put;
|
||||
|
||||
b = 0;
|
||||
put b = binary54./;
|
||||
do P = 1 to &M ;
|
||||
b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
|
||||
put b = best32.;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
2. `j` - A double numeric argument.
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `bit64anddfa()` function <a name="bit64anddfa-functions-9"></a> ######
|
||||
|
||||
## >>> `bit64andDFA()` subroutine: <<< <a name="bit64anddfa-function"></a> #######################
|
||||
|
||||
The **bit64andDFA()** function is an alternative to
|
||||
@@ -1255,6 +1270,7 @@ bit64andDFA(a, b)
|
||||
|
||||
2. `B` - Argument is a SAS numeric values.
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
|
||||
@@ -1290,6 +1306,73 @@ bit64andDFA(a, b)
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `bit64ordfa()` function <a name="bit64ordfa-functions-10"></a> ######
|
||||
|
||||
## >>> `bit64orDFA()` subroutine: <<< <a name="bit64ordfa-function"></a> #######################
|
||||
|
||||
The **bit64orDFA()** function is an alternative to
|
||||
the 32 bit bitwise `BOR()` function working on SAS numerics.
|
||||
Allows to work on *up to* 53 bits of SAS numeric value.
|
||||
|
||||
The `bit64orDFA()` is an *internal* function of the `DFA` package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orDFA(a, b)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `a` - Argument is a SAS numeric values.
|
||||
|
||||
2. `B` - Argument is a SAS numeric values.
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
options ls = max ps = max;
|
||||
%let M = 53 ; %* 53 is maximum valid value;
|
||||
data _null_;
|
||||
array bitmask [ 0: &M] _temporary_ ;
|
||||
do P = 1 to &M ;
|
||||
bitmask[P] = 2**(P-1) ;
|
||||
put bitmask[P] = binary54. @;
|
||||
put bitmask[P] = best32.;
|
||||
end ;
|
||||
bitmask[0] = bitmask[&M.] ;
|
||||
put bitmask[0] = best32. /;
|
||||
|
||||
a=0;
|
||||
put a = binary54.;
|
||||
do P = 1 to &M ;
|
||||
a = BIT64ORDFA (a, bitmask[P]) ;
|
||||
put a = binary54.;
|
||||
end;
|
||||
put;
|
||||
|
||||
b = 0;
|
||||
put b = binary54./;
|
||||
do P = 1 to &M ;
|
||||
b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
|
||||
put b = best32.;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%createdfbitmap()` macro <a name="createdfbitmap-macro-11"></a> ######
|
||||
|
||||
## >>> `%createDFBitmap()` macro: <<< <a name="createdfbitmap-macro"></a> #######################
|
||||
|
||||
The `%createDFBitmap()` macro allows to generate
|
||||
@@ -1346,7 +1429,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
* `header=` - *Optional*, the default value is `1`. Indicates if
|
||||
the `proc fcmp outlib = &outlib.;` header is added to
|
||||
the executed code. If not 1 then no header is added.
|
||||
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
@@ -1382,6 +1465,7 @@ and accepts the following list of arguments and values:
|
||||
|
||||
The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
|
||||
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Bitmap of type 32:
|
||||
@@ -1534,6 +1618,11 @@ NOTE: DATA statement used (Total process time):
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `generatearrays` exec <a name="generatearrays-exec-12"></a> ######
|
||||
|
||||
## >>> `generateArrays` exec: <<< <a name="createdhprtqueue-exec"></a> #######################
|
||||
|
||||
The generateArrays exec file provides a **list of automatically generated examples** of functions
|
||||
@@ -1563,6 +1652,12 @@ The list of provided examples is the following:
|
||||
The `outlib=` option is set to `work.DFAfcmp.package`. The `cmplib=` option is updated automatically.
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `generatearrays` clean <a name="generatearrays-clean-13"></a> ######
|
||||
|
||||
## >>> `generateArrays` clean: <<< <a name="createdhprtqueue-clean"></a> #######################
|
||||
|
||||
The generateArrays clean file clears the list of automatically generated examples of functions
|
||||
@@ -1572,9 +1667,15 @@ The `cmplib=` option is updated automatically.
|
||||
|
||||
---
|
||||
|
||||
## License ####################################################################
|
||||
|
||||
Copyright (c) 2019 Bartosz Jablonski
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
# License <a name="license"></a> ######
|
||||
|
||||
Copyright (c) 2019 - 2026 Bartosz Jablonski
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
@@ -1593,5 +1694,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
BIN
packages/dfa.zip
BIN
packages/dfa.zip
Binary file not shown.
178
packages/gsm.md
178
packages/gsm.md
@@ -1,20 +1,38 @@
|
||||
- [The GSM package](#gsm-package)
|
||||
- [Content description](#content-description)
|
||||
* [`%GSM()` macro](#gsm-macro)
|
||||
* [`%GSMpck_makeFCMPcode()` macro](#gsmpck-makefcmpcode-macro)
|
||||
|
||||
* [License](#license)
|
||||
# Documentation for the `GSM` package.
|
||||
|
||||
----------------------------------------------------------------
|
||||
|
||||
*Generate Secure Macros - to keep your code secret*
|
||||
|
||||
----------------------------------------------------------------
|
||||
|
||||
### Version information:
|
||||
|
||||
- Package: GSM
|
||||
- Version: 0.22.3
|
||||
- Generated: 2026-02-17T12:08:56
|
||||
- Author(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- License: MIT
|
||||
- File SHA256: `F*411452E8388C181800023A01A3B7DC7904A80A915D506D9606638F27CBC282B1` for this version
|
||||
- Content SHA256: `C*1955721DDAAE32A631A8071BEE3BC6CF83761C2280DA5F823D4E4CFD96838FD3` for this version
|
||||
|
||||
---
|
||||
|
||||
|
||||
# The GSM package [ver. 0.22.1] <a name="gsm-package"></a> ###############################################
|
||||
|
||||
# The `GSM` package, version: `0.22.3`;
|
||||
|
||||
---
|
||||
|
||||
|
||||
The **GSM** (a.k.a. *Generate Secure Macros*) package allows
|
||||
to create secured macros stored in SAS Proc FCMP functions.
|
||||
The dataset with functions can be shared and allows to generate
|
||||
macros without showing their code.
|
||||
|
||||
[Recording of presentation with "how it works" description (in Polish)](https://www.youtube.com/watch?v=LtaWPe2sgRY&t=1s "YouTube").
|
||||
|
||||
[The WUSS 2023 Conference article describing the idea](https://www.wuss.org/wuss-2023-conference-proceedings/ "Article about the idea GSM")
|
||||
|
||||
The GSM package is basically an automated version of the following:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
proc fcmp outlib = work.gsm.secure ENCRYPT;
|
||||
@@ -42,10 +60,6 @@ run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
See examples for more details.
|
||||
|
||||
[Recording of presentation with "how it works" description (in Polish)](https://www.youtube.com/watch?v=LtaWPe2sgRY&t=1s "YouTube").
|
||||
|
||||
[The WUSS 2023 Conference article describing the idea](https://www.lexjansen.com/wuss/2023/WUSS-2023-Paper-189.pdf "Article about the idea GSM")
|
||||
|
||||
|
||||
*How to use it:*
|
||||
- Copy all files with your secured macros code into a directory.
|
||||
@@ -56,53 +70,74 @@ See examples for more details.
|
||||
%GSM(<the path to directory>, cmplib=<name of the dataset>)
|
||||
```
|
||||
- Share generated `ZIP` file (unzip and run the code).
|
||||
|
||||
|
||||
|
||||
**Limitations:**
|
||||
- Single macro file cannot be longer than 32760 bytes.
|
||||
|
||||
- Multiline text variable. Consider the following code text file:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
%macro~test()/SECURE;~#@
|
||||
data~test;~#@
|
||||
a~=~"abc~#@
|
||||
~#@
|
||||
def";~#@
|
||||
put~a~hex20.;~#@
|
||||
run;~#@
|
||||
%mend~test;~#@
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
where `~` symbols the space character,
|
||||
`#` symbols the carriage return (`0D`),
|
||||
and `@` symbols the line feed (`0A`).
|
||||
The code file is scanned and inserted into
|
||||
the `resolve()` function argument in a "byte by byte"
|
||||
fashion hence also the "end of line" characters are included.
|
||||
As the result value of variable `a` will be:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
%macro~test()/SECURE;~#@
|
||||
data~test;~#@
|
||||
a~=~"abc~#@
|
||||
~#@
|
||||
def";~#@
|
||||
put~a~hex20.;~#@
|
||||
run;~#@
|
||||
%mend~test;~#@
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
where `~` symbols the space character,
|
||||
`#` symbols the carriage return (`0D`),
|
||||
and `@` symbols the line feed (`0A`).
|
||||
The code file is scanned and inserted into
|
||||
the `resolve()` function argument in a "byte by byte"
|
||||
fashion hence also the "end of line" characters are included.
|
||||
As the result value of variable `a` will be:
|
||||
|
||||
`a = "abc~#@~#@def"`.
|
||||
|
||||
If you want to use the `GSM` package avoid
|
||||
such "style" of coding in your macros.
|
||||
`a = "abc~#@~#@def"`.
|
||||
|
||||
If you want to use the `GSM` package avoid
|
||||
such "style" of coding in your macros.
|
||||
|
||||
---
|
||||
|
||||
Package contains:
|
||||
1. macro gsm
|
||||
2. macro gsmpck_makefcmpcode
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
Required SAS Components:
|
||||
`Base SAS Software`
|
||||
|
||||
Package contains additional content, run: %loadPackageAddCnt(GSM) to load it
|
||||
or look for the gsm_AdditionalContent directory in the Packages fileref
|
||||
- Base SAS Software
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
Package contains additional content, run: `%loadPackageAddCnt(GSM)` to load it
|
||||
or look for the `gsm_AdditionalContent` directory in the `packages` fileref
|
||||
localization (only if additional content was deployed during the installation process).
|
||||
|
||||
*SAS package generated by generatePackage, version 20231111*
|
||||
|
||||
The SHA256 hash digest for package GSM:
|
||||
`F*80197391195C3EC41BD436DF0C8802D3920E4D22B64009A7DE872FBDF8D4B86E`
|
||||
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
*SAS package generated by SAS Package Framework, version `20260216`,*
|
||||
*under `WIN`(`X64_10PRO`) operating system,*
|
||||
*using SAS release: `9.04.01M9P06042025`.*
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
# The `GSM` package content
|
||||
The `GSM` package consists of the following content:
|
||||
|
||||
1. [`%gsm()` macro ](#gsm-macro-1 )
|
||||
2. [`%gsmpck_makefcmpcode()` macro ](#gsmpckmakefcmpcode-macro-2 )
|
||||
|
||||
|
||||
3. [License note](#license)
|
||||
|
||||
---
|
||||
|
||||
## `%gsm()` macro <a name="gsm-macro-1"></a> ######
|
||||
|
||||
## >>> `%GSM()` macro: <<< <a name="gsm-macro"></a> #######################
|
||||
|
||||
@@ -111,20 +146,22 @@ the **GSM** (a.k.a. *Generate Secure Macros*) package.
|
||||
|
||||
It converts a list of macros provided by the user into
|
||||
a data set of the Proc FCMP functions. The macros are stored
|
||||
in functions are encrypted which allow to share them without
|
||||
showing their code. *Important* thing is that macros provided
|
||||
by the user *has* to be "secure", i.e. the `secure` option has to
|
||||
be added to the macro definition. See the example:
|
||||
as encrypted code which allow to share the macros
|
||||
without showing their code.
|
||||
|
||||
*Important* thing is that macros provided by the user *has* to
|
||||
be "secure", i.e. the `secure` option has to be added to the
|
||||
macro definition and th emacro code has to be written properly.
|
||||
See the example:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%macro secretMacro(x) / SECURE; /* <- the secure option */
|
||||
<... some code ...>
|
||||
%macro secretMacro(x) / SECURE; %* <- the secure option *;
|
||||
<... secure code ...>
|
||||
%mend secretMacro;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
As a result a zip file, containing dataset with functions and
|
||||
code to be executed on site, is generated.
|
||||
code to be executed on site, is generated.
|
||||
|
||||
Since encrypted code is stored in a SAS dataset it has
|
||||
no limitation in sharing between operating systems (like catalogs have).
|
||||
@@ -199,9 +236,11 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
|
||||
* `trim=` - *Deprecated*, the default value is `0`.
|
||||
*Kept for backward compatibility.*
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Example: ###################################################################
|
||||
|
||||
Example 1. Prepare 2 files: `f1.sas` and `f2.sas` and use the `%GSM()` macro.
|
||||
@@ -245,6 +284,11 @@ run;
|
||||
%GSM(&path., cmplib=work.myMacros)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
---
|
||||
|
||||
## `%gsmpck_makefcmpcode()` macro <a name="gsmpckmakefcmpcode-macro-2"></a> ######
|
||||
|
||||
## >>> `%GSMpck_makeFCMPcode()` macro: <<< <a name="GSMpck-makeFCMPcode-macro"></a> #######################
|
||||
|
||||
The `%GSMpck_makeFCMPcode()` macro is an internal macro of
|
||||
@@ -310,10 +354,15 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
|
||||
---
|
||||
|
||||
|
||||
## License ####################################################################
|
||||
|
||||
Copyright (c) Bartosz Jablonski, since 2021
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
# License <a name="license"></a> ######
|
||||
|
||||
Copyright (c) Bartosz Jablonski, since 2021 onward
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
@@ -332,5 +381,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
BIN
packages/gsm.zip
BIN
packages/gsm.zip
Binary file not shown.
@@ -9,17 +9,17 @@
|
||||
### Version information:
|
||||
|
||||
- Package: macroArray
|
||||
- Version: 1.3.0
|
||||
- Generated: 2026-01-13T15:30:15
|
||||
- Version: 1.3.2
|
||||
- Generated: 2026-02-17T08:51:01
|
||||
- Author(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- License: MIT
|
||||
- File SHA256: `F*C6C2B5507B6590365222FC764076E294CCE3AAE99971D9CAA942F8BAEBEFAE24` for this version
|
||||
- Content SHA256: `C*9119F3A4C7C4D859C7FB03373AB4FE6551CD7BDFA42BA9B4303D36C367BC8855` for this version
|
||||
- File SHA256: `F*35A657517CD2B1AB86C4E7C5320B5EDDDFBA9348075AE31DDAF875CF0CC193C9` for this version
|
||||
- Content SHA256: `C*DE477F4E280D438B364320F324C88DA3D336F102BA37810C60BDE15398DE84E9` for this version
|
||||
|
||||
---
|
||||
|
||||
# The `macroArray` package, version: `1.3.0`;
|
||||
# The `macroArray` package, version: `1.3.2`;
|
||||
|
||||
---
|
||||
|
||||
@@ -43,6 +43,14 @@ Some of components are:
|
||||
- `%mcDictionary()`,
|
||||
- etc.
|
||||
|
||||
Read this article to learn more:
|
||||
"Macro Variable Arrays Made Easy with macroArray SAS Package"
|
||||
|
||||
Link to the text:
|
||||
`https://www.lexjansen.com/pharmasug/2024/AP/PharmaSUG-2024-AP-108.pdf`
|
||||
or
|
||||
`https://www.lexjansen.com/wuss/2024/124_FINAL_paper_pdf.pdf`
|
||||
|
||||
*Note:*
|
||||
If you are working with BIG macroarrays do not
|
||||
forget to verify your session setting for macro
|
||||
@@ -75,7 +83,7 @@ Required SAS Components:
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
*SAS package generated by SAS Package Framework, version `20251231`,*
|
||||
*SAS package generated by SAS Package Framework, version `20260216`,*
|
||||
*under `WIN`(`X64_10PRO`) operating system,*
|
||||
*using SAS release: `9.04.01M9P06042025`.*
|
||||
|
||||
|
||||
Binary file not shown.
@@ -9,23 +9,21 @@
|
||||
### Version information:
|
||||
|
||||
- Package: SQLinDS
|
||||
- Version: 2.3.1
|
||||
- Generated: 2025-11-22T12:47:32
|
||||
- Version: 2.3.3
|
||||
- Generated: 2026-02-17T08:25:24
|
||||
- Author(s): Mike Rhoads (RhoadsM1@Westat.com), contributor Bartosz Jablonski
|
||||
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
|
||||
- License: MIT
|
||||
- File SHA256: `F*606A24A2A6B06DAAD2D443FA9A9819D9564235A5CD8599FD15586F1EFFCB41BC` for this version
|
||||
- Content SHA256: `C*4CCCF31DA9D94E0EE2DA612724D395056B7BA07CB593C93947835BB8319B33EB` for this version
|
||||
- File SHA256: `F*6CC51325BDCE164B2E811896DD1C3A6D44242F50CC313D0721350CA49975F628` for this version
|
||||
- Content SHA256: `C*776741E40EB6DCD907640ACA674F092BFAF0F7DE031519B6B453D37F6D6959D9` for this version
|
||||
|
||||
---
|
||||
|
||||
# The `SQLinDS` package, version: `2.3.1`;
|
||||
# The `SQLinDS` package, version: `2.3.3`;
|
||||
|
||||
---
|
||||
|
||||
|
||||
### The SQLinDS package [ver. 2.3.1]
|
||||
|
||||
The **SQLinDS** package is an implementation of
|
||||
the *macro-function-sandwich* concept introduced in the
|
||||
*"Use the Full Power of SAS in Your Function-Style Macros"*,
|
||||
@@ -77,7 +75,7 @@ localization (only if additional content was deployed during the installation pr
|
||||
|
||||
---------------------------------------------------------------------
|
||||
|
||||
*SAS package generated by SAS Package Framework, version `20251122`,*
|
||||
*SAS package generated by SAS Package Framework, version `20260216`,*
|
||||
*under `WIN`(`X64_10PRO`) operating system,*
|
||||
*using SAS release: `9.04.01M9P06042025`.*
|
||||
|
||||
@@ -235,7 +233,7 @@ run he following:
|
||||
|
||||
# License <a name="license"></a> ######
|
||||
|
||||
Copyright (c) 2012 Mike Rhoads
|
||||
Copyright (c) since 2012 onward, Mike Rhoads
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
|
||||
Binary file not shown.
Reference in New Issue
Block a user