Merge pull request #36 from SASPAC/dev

The BasePlus package [ver. 1.39.0]

README.md

@@ -54,7 +54,7 @@ libname NEW "%workPath()/new";
 ```
 and more.
 
-SHA256 digest for the latest version of `BasePlus`: F*209FB8198270DEAB6151CE31391A352A065B4EE2689F40433FA9550A7F4AAC18
+SHA256 digest for the latest version of `BasePlus`: F*3C3A2050E3FF46E1FC0F936634A66FC3F294A3531EFE0A7DC9CE74F2EF17C687
 
 [**Documentation for BasePlus**](./baseplus.md "Documentation for BasePlus")
 

baseplus.md

@@ -1,28 +1,30 @@
 # Documentation for the `BasePlus` package.
 
----
+----------------------------------------------------------------
 
-### Version information:
-
  *The BASE SAS plus a bunch of functionalities I am missing in BASE SAS* 
 
+----------------------------------------------------------------
+
+### Version information:
+
 - Package: BasePlus
-- Version: 1.38.0
-- Generated: 2024-03-12T14:26:19
+- Version: 1.39.0
+- Generated: 2024-05-29T16:15:54
 - Author(s): Bartosz Jablonski ([email protected]), Quentin McMullen ([email protected])
 - Maintainer(s): Bartosz Jablonski ([email protected])
 - License: MIT
-- File SHA256: `F*209FB8198270DEAB6151CE31391A352A065B4EE2689F40433FA9550A7F4AAC18` for this version
-- Content SHA256: `C*14C505C4EF488A8BE2404A692D55C8B81FC5A6075D8A35F8B6767B34ACF5E48E` for this version
+- File SHA256: `F*3C3A2050E3FF46E1FC0F936634A66FC3F294A3531EFE0A7DC9CE74F2EF17C687` for this version
+- Content SHA256: `C*2396916BBB5BC1FA832FB85EDAF14173D528A6C823BA0BACB84FC9E99A8CFC1B` for this version
 
 ---
 
-# The `BasePlus` package, version: `1.38.0`;
+# The `BasePlus` package, version: `1.39.0`;
 
 ---
 
 
-# The BasePlus package [ver. 1.38.0] <a name="baseplus-package"></a> ###############################################
+# The BasePlus package [ver. 1.39.0] <a name="baseplus-package"></a> ###############################################
 
 The **BasePlus** package implements useful
 functions and functionalities I miss in the BASE SAS.
@@ -382,7 +384,7 @@ localization (only if additional content was deployed during the installation pr
 
 --------------------------------------------------------------------
 
-*SAS package generated by SAS Package Framework, version `20231210`*
+*SAS package generated by SAS Package Framework, version `20240529`*
 
 --------------------------------------------------------------------
 
@@ -835,7 +837,8 @@ The basic syntax is the following, the `<...>` means optional parameters:
                                 in long format, `1` = yes, `0` = no.
 
 * `fileExt=`                  - *Optional*, if not missing then indicates 
-                                file extension to filter out results.
+                                a list of space-separated file extensions 
+                                to filter out results.
 
 * `maxDepth=0`                - *Optional*, if not zero then indicates
                                 maximum depth of search in the root path.
@@ -5427,11 +5430,13 @@ Macro can be executed in two possible ways:
   run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-2) by create a dataset with a list of links and use of `DS=` and `DSvar=` parameters.
+2) by create a dataset with a list of links and use of `DS=`, `DSvar=`, 
+   and `DSout=` parameters:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
   %downloadFilesTo(</path/to/target/directory>
   , DS=<dataset with list>
   , DSvar=<variable with list>
+  , DSout=<variable with names for downloaded files>
   )
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -5449,6 +5454,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
     target
   <,DS=>
   <,DSvar=link>
+  <,DSout=scan(link,-1,"/\")>
   <,inDev=URL>
   <,outDev=DISK>
   <,inOptions=>
@@ -5467,6 +5473,10 @@ The basic syntax is the following, the `<...>` means optional parameters:
 *. `DSvar= `      - *Optional*, name of variable in data set 
                     with list of files to download. 
 
+*. `DSout=`       - *Optional*, name of variable in data set 
+                    with list of names for to downloaded files.
+                    Default value is: `scan(link,-1,"/\")` it is 
+                    an expression to cut last part of the link.
 
 *. `inDev=`       - *Optional*, type of device used by the 
                     `filename()` function to access incoming files.
@@ -5490,8 +5500,8 @@ The basic syntax is the following, the `<...>` means optional parameters:
 
 ### EXAMPLES AND USECASES: ####################################################
 
-**EXAMPLE 1.** Download data from web with diect list and then copy between directories:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+**EXAMPLE 1.** Download data from web with direct list and then copy between directories:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 resetline;
 %downloadFilesTo(~/directoryA)
 datalines4;
@@ -5506,11 +5516,11 @@ datalines4;
 ~/directoryA/WUSS-2023-Paper-189.zip
 ;;;;
 run;
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 **EXAMPLE 2.** Download data from web using data set with list:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 resetline;
 data listOfFiles;
 infile cards;
@@ -5522,7 +5532,7 @@ https://www.lexjansen.com/wuss/2023/WUSS-2023-Paper-109.pdf
 run;
 
 %downloadFilesTo(R:\directoryC, DS=listOfFiles, DSvar=files)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ---