sasjs/core
1
0
Fork 0
mirror of https://github.com/sasjs/core.git synced 2026-01-05 00:20:05 +00:00
Code Issues Projects Releases Wiki Activity

chore(docs): assertscope

Browse Source
This commit is contained in:
munja
2022-01-19 10:55:52 +01:00
parent e3991c46e2
commit 75f712a305
2 changed files with 53 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
base/mp_assertscope.sas
View File

@@ -1,18 +1,18 @@
/**
@file
@brief Used to capture scope leakage of macro variables
@details A common 'difficult to detect' bug in macros is where a nested
macro over-writes variables in a higher level macro.
@details
This assertion takes a snapshot of the macro variables before and after
a macro invocation. This makes it easy to detect whether any macro
variables were modified or changed.
A common 'difficult to detect' bug in macros is where a nested macro
over-writes variables in a higher level macro.
Currently, the macro only checks for global scope variables. In the future
it may be extended to work at multiple levels of nesting.
This assertion takes a snapshot of the macro variables before and after
a macro invocation. Differences are captured in the `&outds` table. This
makes it easy to detect whether any macro variables were modified or
changed.
If you would like this feature, feel free to contribute / raise an issue /
engage the SASjs team directly.
If you would like this feature, feel free to contribute / raise an issue /
engage the SASjs team directly.
Example usage:
@@ -24,6 +24,9 @@
desc=Checking macro variables against previous snapshot
)
This macro is designed to work alongside `sasjs test` - for more information
about this facility, visit [cli.sasjs.io/test](https://cli.sasjs.io/test).
@param [in] action (SNAPSHOT) The action to take. Valid values:
@li SNAPSHOT - take a copy of the current macro variables
@li COMPARE - compare the current macro variables against previous values