Merge branch 'release/1.20.0'

Author: HenrikBengtsson

.Rbuildignore

@@ -49,7 +49,7 @@ Rplots.pdf$
 # Package specific
 #----------------------------
 ^[.]BatchJobs[.]R$
-[.]future
+^[.]future
 
 #----------------------------
 # Miscellaneous

.github/.travis.yml

@@ -6,7 +6,7 @@ labels: ''
 assignees: ''
 
 ---
-(Please use <https://github.com/HenrikBengtsson/future/discussions> for Q&A)
+(Please use <https://github.com/futureverse/future/discussions> for Q&A)
 
 **Describe the bug**
 A clear and concise description of what the bug is.  

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,5 +1,5 @@
 lank_issues_enabled: true
 contact_links:
   - name: Support & Discussions
-    url: https://github.com/HenrikBengtsson/future/discussions/
+    url: https://github.com/futureverse/future/discussions/
     about: Got a question? Something is not working? Want to share an idea?

.github/ISSUE_TEMPLATE/config.yml

@@ -6,7 +6,7 @@ labels: ''
 assignees: ''
 
 ---
-(Please use <https://github.com/HenrikBengtsson/future/discussions> for Q&A)
+(Please use <https://github.com/futureverse/future/discussions> for Q&A)
 
 **Wish or feature request**
 A clear and concise description of what the problem is. For example, I would like to be able to ...

.github/ISSUE_TEMPLATE/feature_request.md

@@ -22,15 +22,19 @@ jobs:
           - {os: macOS-latest,   r: 'devel'    }
           - {os: macOS-latest,   r: 'release'  }
           - {os: macOS-latest,   r: 'oldrel'   }
-          - {os: ubuntu-latest,  r: 'devel'    }
+#          - {os: ubuntu-latest,  r: 'devel'    }
           - {os: ubuntu-latest,  r: 'release'  }
           - {os: ubuntu-latest,  r: 'oldrel'   }
           - {os: ubuntu-latest,  r: 'oldrel-1' }
           - {os: ubuntu-latest,  r: 'oldrel-2' }
-          - {os: ubuntu-latest,  r: '3.6'      }
+          - {os: ubuntu-latest,  r: '4.0'      }
           - {os: ubuntu-latest,  r: 'release'  , language: ko,    label: ko    }
           - {os: ubuntu-latest,  r: 'release'  , globals_keepWhere: true, label: 'keepWhere' }
           - {os: ubuntu-latest,  r: 'release'  , globals_keepWhere: false, label: '!keepWhere' }
+          - {os: windows-latest, r: 'devel', globals_version: develop, future_version: develop, label: 'w/ future-develop' }
+          - {os: windows-latest, r: 'devel', future_version: develop, label: 'w/ future-develop' }
+          - {os: ubuntu-latest,  r: 'release', globals_version: develop, future_version: develop, label: 'w/ future-develop' }
+          - {os: ubuntu-latest,  r: 'release', future_version: develop, label: 'w/ future-develop' }
 
     env:
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
@@ -48,6 +52,8 @@ jobs:
       ## Specific to futures
       R_FUTURE_RNG_ONMISUSE: error
       R_FUTURE_GLOBALS_KEEPWHERE: ${{ matrix.config.globals_keepWhere }}
+      R_FUTURE_VERSION: ${{ matrix.config.future_version }}
+      R_GLOBALS_VERSION: ${{ matrix.config.globals_version }}
 
     steps:
       - uses: actions/checkout@v4
@@ -70,6 +76,20 @@ jobs:
           install.packages(".", repos = NULL, type = "source")  ## needed by parallel workers
         shell: Rscript {0}
 
+      - name: Test with specific future version?
+        run: |
+          globals_version <- Sys.getenv("R_GLOBALS_VERSION")
+          if (nzchar(globals_version)) {
+            install.packages("remotes")
+            remotes::install_github("futureverse/future", ref=globals_version)
+          }
+          future_version <- Sys.getenv("R_FUTURE_VERSION")
+          if (nzchar(future_version)) {
+            install.packages("remotes")
+            remotes::install_github("futureverse/future", ref=future_version)
+          }
+        shell: Rscript {0}
+
       - name: Session info
         run: |
           options(width = 100)

.github/workflows/R-CMD-check.yaml

@@ -1,4 +1,5 @@
-on: [push]
+on:
+  workflow_dispatch:  # Enables manual triggering
 
 name: test-coverage.yaml
 
@@ -26,9 +27,16 @@ jobs:
 
       - uses: r-lib/actions/setup-r-dependencies@v2
         with:
-          extra-packages: any::covr, any::xml2
+          extra-packages: any::covr, any::xml2, any::remotes
           needs: coverage
 
+      - name: Install itself
+        run: |
+          install.packages(".", repos = NULL, type = "source")
+          remotes::install_github("futureverse/globals", ref = "develop")
+          remotes::install_github("futureverse/future", ref = "develop")
+        shell: Rscript {0}
+
       - name: Test coverage
         run: |
           cov <- covr::package_coverage(

.github/workflows/test-coverage.yaml

@@ -1,18 +1,18 @@
 Package: future.apply
-Version: 1.11.3
+Version: 1.20.0
 Title: Apply Function to Elements in Parallel using Futures
 Depends:
     R (>= 3.2.0),
-    future (>= 1.28.0)
+    future (>= 1.49.0)
 Imports:
-    globals (>= 0.16.1),
+    globals,
     parallel,
     utils
 Suggests:
     datasets,
     stats,
     tools,
-    listenv (>= 0.8.0),
+    listenv,
     R.rsp,
     markdown
 VignetteBuilder: R.rsp
@@ -26,5 +26,7 @@ License: GPL (>= 2)
 LazyLoad: TRUE
 URL: https://future.apply.futureverse.org, https://github.com/futureverse/future.apply
 BugReports: https://github.com/futureverse/future.apply/issues
+Language: en-US
+Encoding: UTF-8
 RoxygenNote: 7.3.2
 Roxygen: list(markdown = TRUE)

DESCRIPTION

@@ -2,11 +2,15 @@
 
 S3method(future_by,data.frame)
 S3method(future_by,default)
+S3method(future_kernapply,default)
+S3method(future_kernapply,ts)
 export(future_.mapply)
+export(future_Filter)
 export(future_Map)
 export(future_apply)
 export(future_by)
 export(future_eapply)
+export(future_kernapply)
 export(future_lapply)
 export(future_mapply)
 export(future_replicate)
@@ -15,17 +19,21 @@ export(future_tapply)
 export(future_vapply)
 importFrom(future,Future)
 importFrom(future,FutureError)
+importFrom(future,FutureInterruptError)
 importFrom(future,as.FutureGlobals)
+importFrom(future,cancel)
 importFrom(future,future)
 importFrom(future,getGlobalsAndPackages)
 importFrom(future,nbrOfWorkers)
 importFrom(future,resolve)
 importFrom(future,value)
 importFrom(globals,findGlobals)
 importFrom(globals,globalsByName)
-importFrom(parallel,nextRNGStream)
-importFrom(parallel,nextRNGSubStream)
 importFrom(parallel,splitIndices)
+importFrom(stats,end)
+importFrom(stats,frequency)
+importFrom(stats,kernapply)
+importFrom(stats,ts)
 importFrom(utils,capture.output)
 importFrom(utils,globalVariables)
 importFrom(utils,head)

NAMESPACE

@@ -1,3 +1,36 @@
+# Version 1.20.0 [2025-06-06]
+
+## Significant changes
+
+ * All **future.apply** functions will now cancel any remaining
+   non-resolved futures if one of the futures produces an error, or a
+   user interrupt (Ctrl-C) is detected. If the backend where the
+   futures are running supports it, the canceled futures are also
+   interrupted, which results in compute resources being freed up
+   sooner and the **future.apply** function returning sooner.
+
+## New Features
+
+ * Added `future_Filter()`, which is parallel version of
+   `base::Filter()`.
+
+ * Added `future_kernapply()`, which is parallel version of
+   `stats::kernapply()`.
+
+ * Now **future.apply** lets **future** take care of the generation of
+   parallel RNG seed. Consolidating random number generation to the
+   core package will allow us to add central support for custom
+   parallel RNG methods beyond the built-in L'Ecuyer-CMRG method.
+
+## Deprecated and Defunct
+
+ * Specifying the function `FUN` for `future_by()` as a character
+   string is defunct. It should be specified as a function, e.g. `FUN
+   = sqrt` and ``FUN = `[[` ``, which is what `base::by()`
+   requires. Use of a string has been deprecated since
+   **future.apply** 1.10.0 (2022-11-04).
+
+
 # Version 1.11.3 [2024-10-27]
 
 ## Bug Fixes
@@ -10,7 +43,8 @@
 
 ## Miscellaneous
 
- * Relaxed on unit test that triggered an error on 32-bit architectures.
+ * Relaxed one unit test that triggered an error on 32-bit
+   architectures.
 
 
 # Version 1.11.1 [2023-12-19]