version bump and meta update

Author: e-kotov

CITATION.cff

@@ -8,7 +8,7 @@ message: 'To cite package "rJavaEnv" in publications use:'
 type: software
 license: MIT
 title: 'rJavaEnv: ''Java'' Environments for R Projects'
-version: 0.1.2
+version: 0.2.0
 doi: 10.32614/CRAN.package.rJavaEnv
 abstract: 'Solve common issues with ''Java'' environment management in ''R'' for users
   of ''Java''/''rJava''-dependent ''R'' packages such as ''r5r'', ''opentripplanner'',
@@ -56,6 +56,17 @@ keywords:
 - reproducibility
 - reproducible-research
 references:
+- type: software
+  title: 'R: A Language and Environment for Statistical Computing'
+  notes: Depends
+  url: https://www.R-project.org/
+  authors:
+  - name: R Core Team
+  institution:
+    name: R Foundation for Statistical Computing
+    address: Vienna, Austria
+  year: '2024'
+  version: '>= 4.0'
 - type: software
   title: checkmate
   abstract: 'checkmate: Fast and Versatile Argument Checks'

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: rJavaEnv
 Title: 'Java' Environments for R Projects
-Version: 0.1.2
+Version: 0.2.0
 Authors@R: c(
     person("Egor", "Kotov", , "[email protected]", role = c("aut", "cre", "cph"),
            comment = c(ORCID = "0000-0001-6690-5345")),
@@ -28,6 +28,8 @@ Description: Solve common issues with 'Java' environment management in 'R'
 License: MIT + file LICENSE
 URL: https://github.com/e-kotov/rJavaEnv, https://www.ekotov.pro/rJavaEnv/
 BugReports: https://github.com/e-kotov/rJavaEnv/issues
+Depends: 
+    R (>= 4.0)
 Imports: 
     checkmate,
     cli,
@@ -45,5 +47,3 @@ Encoding: UTF-8
 Language: en-US
 Roxygen: list(markdown = TRUE)
 RoxygenNote: 7.3.2
-Depends: 
-    R (>= 4.0)

NEWS.md

@@ -1,4 +1,4 @@
-# rJavaEnv 0.1.3 (2024-08-28)
+# rJavaEnv 0.2.0 (2024-08-28)
 
 * Breaking change: `java_check_version_cmd()` and `java_check_version_rjava()` now return detected `Java` version instead of `TRUE`/`FALSE`
 

README.md

@@ -23,15 +23,15 @@ alt="CRAN/METACRAN Total downloads" /></a>
 <!-- [![pkgcheck](https://github.com/e-kotov/rJavaEnv/workflows/pkgcheck/badge.svg)](https://github.com/e-kotov/rJavaEnv/actions?query=workflow%3Apkgcheck) -->
 [![codecov](https://codecov.io/github/e-kotov/rJavaEnv/graph/badge.svg?token=2UKGZVNO5V)](https://app.codecov.io/github/e-kotov/rJavaEnv)
 
-[![DOI](https://zenodo.org/badge/DOI/10.32614/CRAN.package.rJavaEnv.svg)](https://doi.org/10.32614/CRAN.package.rJavaEnvi)
+[![DOI](https://zenodo.org/badge/DOI/10.32614/CRAN.package.rJavaEnv.svg)](https://doi.org/10.32614/CRAN.package.rJavaEnv)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11403009.svg)](https://doi.org/10.5281/zenodo.11403009)
 
 <!-- badges: end -->
 
 Solve common issues with `Java` environment management in `R` for users
 of `Java`/`{rJava}`-dependent `R` packages such as `{r5r}`,
 `{opentripplanner}`, `{xlsx}`, `{openNLP}`, `{rWeka}`, `{RJDBC}`,
-`{tabulapdf}`, and many more. `{rJavaENv}` prevents common problems like
+`{tabulapdf}`, and many more. `{rJavaEnv}` prevents common problems like
 `Java` not found, `Java` version conflicts, missing `Java`
 installations, and the inability to install `Java` due to lack of
 administrative privileges. `rJavaEnv` automates the download,
@@ -124,10 +124,32 @@ Just insert this line into the begining of any script that you run with
 rJavaEnv::use_java("21")
 ```
 
+This acts exactly like `java_quick_install()`, but only sets the
+environment variables in the current session and does not copy or link
+`Java` binaries into the project directory.
+
 More details are in the vignette [Multiple `Java` environments in one
 project with `targets` and
 `callr`](https://www.ekotov.pro/rJavaEnv/articles/multiple-java-with-targets-callr.qmd).
 
+## Cleanup
+
+If you do not want to use `rJavaEnv` anymore, please clear the cache
+folders before removing the package:
+
+``` r
+java_clear("project", delete_all = TRUE)
+java_clear("installed", delete_all = TRUE)
+java_clear("distrib", delete_all = TRUE)
+```
+
+Also, clear the `.Rprofile` file in the projects there you used the
+package:
+
+``` r
+java_env_unset()
+```
+
 ## Functions Overview
 
 The package has several core functions:
@@ -166,6 +188,12 @@ The package has several core functions:
 9.  `java_clear()`
     - Removes all or some `Java` versions linked in the current project
       (or cached distributions or installations).
+10. `use_java()`
+
+- Same as `java_quick_install()`, but in a less intrusive way. Does not
+  copy or link the `Java` installation folder from cache into the
+  project directory and does not create or edit your `.Rprofile` file.
+  Only sets requested java in the current R session.
 
 See more details on all the functions in the
 <a href="https://www.ekotov.pro/rJavaEnv/reference/index.html"

README.qmd

@@ -29,12 +29,12 @@ is_html <- knitr::is_html_output()
 <!-- [![pkgcheck](https://github.com/e-kotov/rJavaEnv/workflows/pkgcheck/badge.svg)](https://github.com/e-kotov/rJavaEnv/actions?query=workflow%3Apkgcheck) -->
 [![codecov](https://codecov.io/github/e-kotov/rJavaEnv/graph/badge.svg?token=2UKGZVNO5V)](https://app.codecov.io/github/e-kotov/rJavaEnv)
 
-[![DOI](https://zenodo.org/badge/DOI/10.32614/CRAN.package.rJavaEnv.svg)](https://doi.org/10.32614/CRAN.package.rJavaEnvi)
+[![DOI](https://zenodo.org/badge/DOI/10.32614/CRAN.package.rJavaEnv.svg)](https://doi.org/10.32614/CRAN.package.rJavaEnv)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11403009.svg)](https://doi.org/10.5281/zenodo.11403009)
 
 <!-- badges: end -->
 
-Solve common issues with `Java` environment management in `R` for users of `Java`/`{rJava}`-dependent `R` packages such as `{r5r}`, `{opentripplanner}`, `{xlsx}`, `{openNLP}`, `{rWeka}`, `{RJDBC}`, `{tabulapdf}`, and many more. `{rJavaENv}` prevents common problems like `Java` not found, `Java` version conflicts, missing `Java` installations, and the inability to install `Java` due to lack of administrative privileges. `rJavaEnv` automates the download, installation, and setup of the `Java Development Kit` (`JDK`) on a per-project basis by setting the relevant `JAVA_HOME` in the current `R` session or the current working directory (via `.Rprofile`, with the user's consent). Similar to what `renv` does for `R` packages, `rJavaEnv` allows different `Java` versions to be used across different projects, but can also be configured to allow multiple versions within the same project (e.g. with the help of `{targets}` package). **Note: there are a few extra steps for 'Linux' users, who don't have any 'Java' previously installed in their system, and who prefer package installation from source, rather then installing binaries from 'Posit Package Manager'. See [documentation](https://www.ekotov.pro/rJavaEnv/articles/rJavaEnv.html#note-linux) for details.**
+Solve common issues with `Java` environment management in `R` for users of `Java`/`{rJava}`-dependent `R` packages such as `{r5r}`, `{opentripplanner}`, `{xlsx}`, `{openNLP}`, `{rWeka}`, `{RJDBC}`, `{tabulapdf}`, and many more. `{rJavaEnv}` prevents common problems like `Java` not found, `Java` version conflicts, missing `Java` installations, and the inability to install `Java` due to lack of administrative privileges. `rJavaEnv` automates the download, installation, and setup of the `Java Development Kit` (`JDK`) on a per-project basis by setting the relevant `JAVA_HOME` in the current `R` session or the current working directory (via `.Rprofile`, with the user's consent). Similar to what `renv` does for `R` packages, `rJavaEnv` allows different `Java` versions to be used across different projects, but can also be configured to allow multiple versions within the same project (e.g. with the help of `{targets}` package). **Note: there are a few extra steps for 'Linux' users, who don't have any 'Java' previously installed in their system, and who prefer package installation from source, rather then installing binaries from 'Posit Package Manager'. See [documentation](https://www.ekotov.pro/rJavaEnv/articles/rJavaEnv.html#note-linux) for details.**
 
 
 
@@ -112,15 +112,15 @@ More details are in the vignette [Multiple `Java` environments in one project wi
 
 If you do not want to use `rJavaEnv` anymore, please clear the cache folders before removing the package:
 
-```{r}
+```r
 java_clear("project", delete_all = TRUE)
 java_clear("installed", delete_all = TRUE)
 java_clear("distrib", delete_all = TRUE)
 ```
 
 Also, clear the `.Rprofile` file in the projects there you used the package:
 
-```{r}
+```r
 java_env_unset()
 ```
 

codemeta.json

@@ -4,11 +4,11 @@
   "identifier": "rJavaEnv",
   "description": "Solve common issues with 'Java' environment management in 'R' for users of 'Java'/'rJava'-dependent 'R' packages such as 'r5r', 'opentripplanner', 'xlsx', 'openNLP', 'rWeka', 'RJDBC', 'tabulapdf', and many more. `rJavaEnv` prevents common problems like 'Java' not found, 'Java' version conflicts, missing 'Java' installations, and the inability to install 'Java' due to lack of administrative privileges. 'rJavaEnv' automates the download, installation, and setup of the 'Java Development Kit' ('JDK') on a per-project basis by setting the relevant 'JAVA_HOME' in the current 'R' session or the current working directory (via '.Rprofile', with the user's consent). Similar to what 'renv' does for 'R' packages, 'rJavaEnv' allows different 'Java' versions to be used across different projects, but can also be configured to allow multiple versions within the same project (e.g. with the help of 'targets' package). Note: there are a few extra steps for 'Linux' users, who don't have any 'Java' previously installed in their system, and who prefer package installation from source, rather then installing binaries from 'Posit Package Manager'. See documentation for details.",
   "name": "rJavaEnv: 'Java' Environments for R Projects",
-  "relatedLink": ["https://www.ekotov.pro/rJavaEnv/", "https://CRAN.R-project.org/package=rJavaEnv"],
+  "relatedLink": "https://www.ekotov.pro/rJavaEnv/",
   "codeRepository": "https://github.com/e-kotov/rJavaEnv",
   "issueTracker": "https://github.com/e-kotov/rJavaEnv/issues",
   "license": "https://spdx.org/licenses/MIT",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "programmingLanguage": {
     "@type": "ComputerLanguage",
     "name": "R",
@@ -98,6 +98,12 @@
   ],
   "softwareRequirements": {
     "1": {
+      "@type": "SoftwareApplication",
+      "identifier": "R",
+      "name": "R",
+      "version": ">= 4.0"
+    },
+    "2": {
       "@type": "SoftwareApplication",
       "identifier": "checkmate",
       "name": "checkmate",
@@ -109,7 +115,7 @@
       },
       "sameAs": "https://CRAN.R-project.org/package=checkmate"
     },
-    "2": {
+    "3": {
       "@type": "SoftwareApplication",
       "identifier": "cli",
       "name": "cli",
@@ -121,7 +127,7 @@
       },
       "sameAs": "https://CRAN.R-project.org/package=cli"
     },
-    "3": {
+    "4": {
       "@type": "SoftwareApplication",
       "identifier": "curl",
       "name": "curl",
@@ -133,7 +139,7 @@
       },
       "sameAs": "https://CRAN.R-project.org/package=curl"
     },
-    "4": {
+    "5": {
       "@type": "SoftwareApplication",
       "identifier": "jsonlite",
       "name": "jsonlite",
@@ -145,14 +151,14 @@
       },
       "sameAs": "https://CRAN.R-project.org/package=jsonlite"
     },
-    "5": {
+    "6": {
       "@type": "SoftwareApplication",
       "identifier": "utils",
       "name": "utils"
     },
     "SystemRequirements": null
   },
-  "fileSize": "381.063KB",
+  "fileSize": "528.471KB",
   "citation": [
     {
       "@type": "SoftwareSourceCode",

inst/schemaorg.json

@@ -36,7 +36,7 @@
         "url": "https://cran.r-project.org"
       },
       "runtimePlatform": "R version 4.4.1 (2024-06-14)",
-      "version": "0.1.2"
+      "version": "0.2.0"
     },
     {
       "id": "https://doi.org/10.32614/CRAN.package.rJavaEnv",