mirror of
https://github.com/yabwon/SAS_PACKAGES.git
synced 2026-01-03 21:30:06 +00:00
SAS Packages Framework, version 20221212
SAS Packages Framework, version 20221212
- New type `CASLUDF` for CASL User Defined Functions added to the framework.
- If a package contains IML modules or CASL user defined functions additional utility macros for IML Modules and CASL UDFs are generated when package is loaded.
- Documentation updated.
- Minor bugfix.
This commit is contained in:
Bartosz Jablonski
@@ -21,7 +21,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 **`20221125`**.
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20221212`**.
|
||||
|
||||
**To get started with SAS Packages** try this [**`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).
|
||||
|
||||
@@ -39,7 +39,7 @@ After assigning the directory do not change them when using the SPF since it may
|
||||
## This is short help information for the `installPackage` macro <a name="installpackage"></a>
|
||||
--------------------------------------------------------------------------------------------
|
||||
|
||||
Macro to install SAS packages, version `20221125`
|
||||
Macro to install SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -141,7 +141,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 `20221125`
|
||||
Macro to get help about SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -207,11 +207,12 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
%unloadPackage(SQLinDS) %* unload the package content from the SAS session;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
## This is short help information for the `loadPackage` macro <a name="loadpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to *load* SAS packages, version `20221125`
|
||||
Macro to *load* SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -303,12 +304,56 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
%loadPackage(BasePlus, cherryPick=getVars) %* cherry pick the content;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
## Utility macros generated during loading a package ###########################
|
||||
|
||||
If a package contains IML modules or CASL user defined functions additional
|
||||
utility macros for IML Modules and CASL UDFs are generated when package is loaded.
|
||||
|
||||
Macros are generated with the following names: `%<packageName>IML()` and `%<packageName>CASLudf()`.
|
||||
|
||||
Their purpose is to make loading of Modules or UDFs (with potentially multiple
|
||||
dependencies) easy in Proc IML and Proc CAS.
|
||||
|
||||
Run them, accordingly, as the first line in the Proc IML or Proc CAS to access the package content.
|
||||
For Proc IML the use is as follows:
|
||||
~~~~~~sas
|
||||
proc IML;
|
||||
%<packageName>IML()
|
||||
|
||||
<... your code using IML modules from the package ...>
|
||||
quit;
|
||||
~~~~~~
|
||||
For Proc CAS the use is as follows:
|
||||
~~~~~~sas
|
||||
proc CAS;
|
||||
%<packageName>CASLudf()
|
||||
|
||||
<... your code using CASL UDFs from the package ...>
|
||||
quit;
|
||||
~~~~~~
|
||||
|
||||
If a utility macro is generated appropriate note and a code snippet
|
||||
is printed in the log of the package loading process.
|
||||
|
||||
In 99% cases macros are used with default parameters values but,
|
||||
in case when deeper insight about macros parameters is needed,
|
||||
help info is printed in the log when the following code is run:
|
||||
~~~~~~sas
|
||||
%<packageName>IML(list=HELP)
|
||||
~~~~~~
|
||||
or
|
||||
~~~~~~sas
|
||||
%<packageName>CASLudf(list=HELP)
|
||||
~~~~~~
|
||||
|
||||
If created, those macros are automatically deleted when the `%unloadPackage()` macro is run.
|
||||
|
||||
---
|
||||
|
||||
## This is short help information for the `loadPackageS` macro <a name="loadpackages"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro wrapper for the loadPackage macro, version `20221125`
|
||||
Macro wrapper for the loadPackage macro, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -357,7 +402,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 `20221125`
|
||||
Macro to unload SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -422,7 +467,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 `20221125`
|
||||
Macro to list available SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -463,7 +508,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 `20221125`
|
||||
Macro to verify SAS package with it hash digest, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -517,7 +562,7 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
|
||||
## This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to get previwe of a SAS packages, version `20221125`
|
||||
Macro to get previwe of a SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -584,7 +629,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 `20221125`
|
||||
Macro to generate SAS packages, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -768,7 +813,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 `20221125`
|
||||
Macro to list directories pointed by 'packages' fileref, version `20221212`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
|
||||
Reference in New Issue
Block a user