Package: bpUTiL, Version: 0.1.0

Package: bpUTiL, Version: 0.1.0

Changes:
- New parameters and algorithm added to `%bpUTiL_includeSASNotebook()` macro.

---

- File SHA256: `F*4E6AC11BC57EEB26D9E11DD59F8602115493388AA73C07A14A3DBA512E9CE77D` for this version
- Content SHA256: `C*EBE428F497DBE0690DAA28729B09716644901F144D9D2CAEB506B4841707C4C6` for this version

README.md

@@ -6,8 +6,8 @@ The `bpUTiL` package, supported by `basePlus` and `macroArray` packages,
 provides a set of basic popular utility programs to make daily programming
 work easier.
 
-SHA256 digest for the latest version of `bpUTiL`: F*EB9ADD68FB2537663EC1AF735E896F8F7D49E9E712391A3AE14086022508D3BD
+SHA256 digest for the latest version of `bpUTiL`: F*4E6AC11BC57EEB26D9E11DD59F8602115493388AA73C07A14A3DBA512E9CE77D
 
-[**Documentation for bpUTiL**](./bputil.md "Documentation for GSM")
+[**Documentation for bpUTiL**](./bputil.md "Documentation for bpUTiL")
 
 To work with a package use the [**SAS Packages Framework**](https://github.com/yabwon/SAS_PACKAGES/blob/main/README.md "SPFinit").

bputil.md

@@ -9,17 +9,17 @@
 ### Version information:
 
 - Package: bpUTiL
-- Version: 0.0.1
-- Generated: 2024-12-03T16:37:17
+- Version: 0.1.0
+- Generated: 2024-12-04T16:48:14
 - Author(s): Bartosz Jablonski (yabwon@gmail.com)
 - Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
 - License: MIT
-- File SHA256: `F*EB9ADD68FB2537663EC1AF735E896F8F7D49E9E712391A3AE14086022508D3BD` for this version
-- Content SHA256: `C*99C572492F27D0EFB360EDB4CE0263337D78A2ACDBD75620DABF4FD8A3EB63B7` for this version
+- File SHA256: `F*4E6AC11BC57EEB26D9E11DD59F8602115493388AA73C07A14A3DBA512E9CE77D` for this version
+- Content SHA256: `C*EBE428F497DBE0690DAA28729B09716644901F144D9D2CAEB506B4841707C4C6` for this version
 
 ---
 
-# The `bpUTiL` package, version: `0.0.1`;
+# The `bpUTiL` package, version: `0.1.0`;
 
 ---
 
@@ -422,10 +422,16 @@ ENDSUBMIT;
 QUIT;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+*Inspirations.*
+
 Idea for the macro was inspired by Chris Hemedinger's post:
 https://communities.sas.com/t5/SAS-Viya-Workbench-Discussion/Weekly-Workbench-Tip-Run-a-SAS-Notebook-INCLUDE-style/m-p/943690
-but with implementation done from scratch.
 
+Implementation for "small" notebooks (every single code 
+cell in a notebook has length no longer than 32767 bytes)
+is based on Chris idea, implementation for "big" notebooks
+(direct code extraction is used in that case) has been 
+written from scratch.
 
 ### SYNTAX: ###################################################################
 
@@ -434,18 +440,41 @@ The basic syntax is the following, the `<...>` means optional parameters:
 %bpUTiL_includeSASNotebook(
    path
  <,print=>
+ <,big=0>
+ <,outpath=>
+ <,source2=>
 )
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 **Arguments description**:
 
 1. `path`    - *Required.* Valid path to SAS 
-                Notebook `*.sasnb` file.
+                Notebook `*.sasnb` file or an 
+                existing fileref.
 
 * `print=`    - *Optional.* Indicates weather notebook code
                 should be printed (`1`) or included (`0`).
                 The default is `0`.
 
+* `big=`      - *Optional.* Indicates which algorithm for 
+                source code extraction should be used.
+                If every single code cell in the notebook 
+                has length no longer than 32767 bytes
+                use `big=0` (the `JSON` libname is used in
+                that case). If at least one code cell is 
+                bigger than 32767 bytes use `big=1` (direct 
+                code extraction is used in that case)
+                The default is `0`.
+
+* `outpath=`  - *Optional.* Valid path to a file where
+                the extracted code should be saved.
+                The default is null and a temporary file 
+                in work directory is used in that case.
+
+* `source2=`  - *Optional.* Indicates weather source2 option
+                should be used for `%include` (`1`) or not (`0`).
+                The default is `0`.
+
 ---