The GSM package [ver. 0.20]

The GSM package [ver. 0.20]

- internal bug fix.

hash: BE9508C8E37706B2EB2FBCA68B64F7DCF63C65E8E24775C92E28FE34E547893D

README.md

@@ -88,12 +88,12 @@ To create your own package:
 ---
 
 ## Where the SAS Packages Framework is used:
-This is a list of locations where the SAS Packages Framework is used. If you want to share that you are using SPF let me know and I'll update the list.
+This is a list of locations where the SAS Packages Framework is used:
+ - Warsaw (Poland)
 
-The List:
-- Europe
-  - Poland 
-    - Warsaw
+If you want to share that you are using the SPF let me know and I'll update the list.
+
+If you find the SPF usefull **share info** about it or **give it a [star](https://github.com/yabwon/SAS_PACKAGES/stargazers)** so more people will know.
 
 ---
 
@@ -168,12 +168,12 @@ SHA256 digest for BasePlus: A60A300E083628C65DD6899E7EF95588916F8F66B6A25B32B322
 
 [Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
 
-- **GSM** (Generate Secure Macros)\[0.18\], package allows
+- **GSM** (Generate Secure Macros)\[0.20\], 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.
 
-SHA256 digest for GSM: 8D730316043A6523A3AF2AA15D2820BB75A46E06307F2B8916D30AC102AEE31D
+SHA256 digest for GSM: BE9508C8E37706B2EB2FBCA68B64F7DCF63C65E8E24775C92E28FE34E547893D
 
 [Documentation for GSM](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/gsm.md "Documentation for GSM")
 

packages/README.md

@@ -114,12 +114,12 @@ SHA256 digest for BasePlus: A60A300E083628C65DD6899E7EF95588916F8F66B6A25B32B322
 
 ---
 
-- **GSM** (Generate Secure Macros)\[0.18\], package allows
+- **GSM** (Generate Secure Macros)\[0.20\], 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.
 
-SHA256 digest for GSM: 8D730316043A6523A3AF2AA15D2820BB75A46E06307F2B8916D30AC102AEE31D
+SHA256 digest for GSM: BE9508C8E37706B2EB2FBCA68B64F7DCF63C65E8E24775C92E28FE34E547893D
 
 [Documentation for GSM](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/gsm.md "Documentation for GSM")
 

packages/SHA256_for_packages.txt

@@ -1,3 +1,9 @@
+/* 20220406 */
+GSM: BE9508C8E37706B2EB2FBCA68B64F7DCF63C65E8E24775C92E28FE34E547893D
+
+/* 20220307 */
+GSM: F63B8C602C1DB02F4107D9AF78182D87CD64AEA6521163067B7EB6D5C1B368AF
+
 /* 20220307 */
 GSM: 8D730316043A6523A3AF2AA15D2820BB75A46E06307F2B8916D30AC102AEE31D
 

packages/gsm.md

@@ -8,7 +8,7 @@
 ---
 
 
-# The GSM package [ver. 0.18] <a name="gsm-package"></a> ###############################################
+# The GSM package [ver. 0.20] <a name="gsm-package"></a> ###############################################
 
 The **GSM** (a.k.a. *Generate Secure Macros*) package allows
 to create secured macros stored in SAS Proc FCMP functions.
@@ -54,8 +54,33 @@ Recording of presentation with "how it works" description, in Polish, is avaliab
    ```
  - Share generated `ZIP` file (unzip and run the code).
  
-*Limitations:* 
- Single macro file cannot be longer than 32760 bytes.
+**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: 
+
+`a = "abc~#@~#@def"`. 
+
+If you want to use the `GSM` package avoid 
+such "style" of coding in your macros.
+
 
 ---
 
@@ -69,7 +94,7 @@ Required SAS Components:
 * SAS package generated by generatePackage, version 20220113 *
 
 The SHA256 hash digest for package GSM: 
-`8D730316043A6523A3AF2AA15D2820BB75A46E06307F2B8916D30AC102AEE31D` 
+`BE9508C8E37706B2EB2FBCA68B64F7DCF63C65E8E24775C92E28FE34E547893D` 
 
  
 ## >>> `%GSM()` macro: <<< <a name="gsm-macro"></a> #######################
@@ -92,7 +117,7 @@ be added to the macro definition. See the example:
 
 
 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).
@@ -117,6 +142,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
  <,outpath=>
  <,encodingRestricted=>
  <,secret=>
+ <,lineEnd=>
 )
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -125,10 +151,6 @@ The basic syntax is the following, the `<...>` means optional parameters:
 1. `path`               - *Required*, indicates a directory which contains files with macros.
                           Only files with `sas` extension are used.
 
-* `trim=`               - *Optional*, the default value is `0`.
-                          If set to `1` then lines of macro code are trimmed.
-                          If set to `2` then lines of macro code are stripped.
-
 * `cmplib=`             - *Optional*, the default value is `work.generateMacros`. 
                           Names the dataset which will contain generated functions. 
 
@@ -151,8 +173,20 @@ The basic syntax is the following, the `<...>` means optional parameters:
                           Required to execute the `resolve()` function. 
                           User who do not know the value will not be able
                           to run the `_maxro_XX_()` function.
----
 
+* `lineEnd=`            - *Optional*, the default value is `0D0A`, indicates which of:
+                          line feed, carriage return, or both, or a space be inserted 
+                          at the end of line in the intermediate code file that is generated.
+                          Value has to be hexadecimal code (_NOT_ null),
+                          since the value is resolved as `"&lineEnd."x`, so use e.g.
+                          `0A` for line feed, `0D` for carriage return, 
+                          `0D0A` for both, and `20` for space.
+
+* `trim=`               - *Deprecated*, the default value is `0`.
+                          *Kept for backward compatibility.*
+
+
+---
 
 ### Example: ###################################################################
 
@@ -197,8 +231,7 @@ run;
 %GSM(&path., cmplib=work.myMacros)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- 
-## >>> `%GSMpck_makeFCMPcode()` macro: <<< <a name="gsmpck-makefcmpcode-macro"></a> #######################
+## >>> `%GSMpck_makeFCMPcode()` macro: <<< <a name="GSMpck-makeFCMPcode-macro"></a> #######################
 
 The `%GSMpck_makeFCMPcode()` macro is an internal macro of 
 the **GSM** (a.k.a. *Generate Secure Macros*) package. 
@@ -219,11 +252,11 @@ The basic syntax is the following, the `<...>` means optional parameters:
 %GSMpck_makeFCMPcode( 
    path
   ,number
- <,trim=0>
  <,outlib=work.generateMacros.secure>
  <,source2=>
  <,fileNameCode=FNC>
  <,secret=123456789>
+ <,lineEnd=0A>
 )
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -234,9 +267,6 @@ The basic syntax is the following, the `<...>` means optional parameters:
 
 2. `number`       - *Required*, a sequential number.
 
-* `trim=`         - *Optional*, the default value is `0`.
-                     If set to `1` then lines of macro code are trimmed.
-                     If set to `2` then lines of macro code are stripped.
 
 * `cmplib=`       - *Optional*, the default value is `work.generateMacros`. 
                     Names the dataset which will contain generated functions. 
@@ -253,6 +283,17 @@ The basic syntax is the following, the `<...>` means optional parameters:
                     function. User who do not know the value will not be able
                     to run the `_maxro_XX_()` function.
 
+* `lineEnd=`      - *Optional*, the default value is `0D0A`, indicates which of:
+                    line feed, carriage return, or both, or a space be inserted 
+                    at the end of line in the intermediate code file that is generated.
+                    Value has to be hexadecimal code (_NOT_ null),
+                    since the value is resolved as `"&lineEnd."x`, so use e.g.
+                    `0A` for line feed, `0D` for carriage return, 
+                    `0D0A` for both, and `20` for space.
+
+* `trim=`          - *Deprecated*, the default value is `0`.
+                     *Kept for backward compatibility.*
+
 ---