Release picocli-jansi-graalvm version 1.2.0

remkop · Jul 4, 2020 · b615526 · b615526
1 parent c50dbb3
commit b615526
Show file tree

Hide file tree

Showing 16 changed files with 79 additions and 55 deletions.
diff --git a/README.md b/README.md
@@ -78,11 +78,11 @@ In your project, we recommend you use the following dependencies:
 ```
 // Gradle example
 dependencies {
-    compile "info.picocli:picocli:4.2.0"
-    compile "info.picocli:picocli-jansi-graalvm:1.1.0"
+    compile "info.picocli:picocli:4.3.2"
+    compile "info.picocli:picocli-jansi-graalvm:1.2.0"
     compile "org.fusesource.jansi:jansi:1.18"
 
-    annotationProcessor "info.picocli:picocli-codegen:4.2.0"
+    annotationProcessor "info.picocli:picocli-codegen:4.3.2"
 }
 ```
 
@@ -112,7 +112,7 @@ set GRAAL_HOME=C:\apps\graalvm-ce-19.2.1
 :: compile our my.pkg.MyApp class (assuming the source is in the .\src directory)
 mkdir classes
 javac -cp ^
-  .;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar;jansi-1.18.jar;picocli-jansi-graalvm-1.1.0.jar ^
+  .;picocli-4.3.2.jar;picocli-codegen-4.3.2.jar;jansi-1.18.jar;picocli-jansi-graalvm-1.2.0.jar ^
   -sourcepath src ^
   -d classes src\my\pkg\MyApp.java
 
@@ -121,7 +121,7 @@ cd classes && jar -cvef my.pkg.MyApp ../myapp.jar * && cd ..
 
 :: generate native image
 %GRAAL_HOME%\bin\native-image ^
-  -cp picocli-4.2.0.jar;jansi-1.18.jar;picocli-jansi-graalvm-1.1.0.jar;myapp.jar ^
+  -cp picocli-4.3.2.jar;jansi-1.18.jar;picocli-jansi-graalvm-1.2.0.jar;myapp.jar ^
   my.pkg.MyApp myapp
 ```
 
@@ -164,7 +164,7 @@ The `jni-config.json` file contains JNI configuration for all classes, methods a
 The following command can be used to regenerate it:
 
 ```
-java -cp picocli-4.2.0.jar;jansi-1.18.jar;picocli-codegen-4.2.0.jar ^
+java -cp picocli-4.3.2.jar;jansi-1.18.jar;picocli-codegen-4.3.2.jar ^
   picocli.codegen.aot.graalvm.JniConfigGenerator ^
   org.fusesource.jansi.internal.CLibrary ^
   org.fusesource.jansi.internal.Kernel32 ^

diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
@@ -1,3 +1,27 @@
+# <a name="1.2.0"></a> 1.2.0 - Support `org.fusesource.jansi.Ansi.disable` property
+
+This release adds support for the `org.fusesource.jansi.Ansi.disable` system property: if this property exists and is equal to, ignoring case, the string `"true"`, then no Jansi classes will be loaded.
+
+The use of Jansi may cause problems for applications when running in some restricted Windows environments.
+The problem is that AppLocker can forbid loading of non-signed libraries from the Windows temporary folder.
+
+Jansi extracts a dll to the temporary folder of Windows as soon as one of its class is loaded, like when the `org.fusesource.jansi.AnsiConsole::systemInstall` method is called.
+
+With this version of `picocli-jansi-graalvm`, applications can safely use the `picocli.jansi.graalvm.AnsiConsole::windowsInstall` method as below:
+
+```java
+public static void main(String[] args) {
+    // only loads Jansi classes if `org.fusesource.jansi.Ansi.disable` is not true
+    try (AnsiConsole ansi = AnsiConsole.windowsInstall()) { // enable colors on Windows
+        new CommandLine(new MyApp()).execute(args);
+    }          // Closeable does cleanup when done
+}
+```
+
+This internally checks the value of the `org.fusesource.jansi.Ansi.disable` system property before calling the `org.fusesource.jansi.AnsiConsole::systemInstall` method
+
+End users can use this system property to use the application with reduced functionality, rather than being prevented from using the application altogether.
+
 # <a name="1.1.0"></a> 1.1.0 - Closeable
 
 This release adds a convenience API to reduce code in the application.

diff --git a/docs/apidocs/allclasses-frame.html b/docs/apidocs/allclasses-frame.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>All Classes (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>All Classes (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/apidocs/allclasses-noframe.html b/docs/apidocs/allclasses-noframe.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>All Classes (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>All Classes (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/apidocs/constant-values.html b/docs/apidocs/constant-values.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>Constant Field Values (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>Constant Field Values (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Constant Field Values (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="Constant Field Values (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/deprecated-list.html b/docs/apidocs/deprecated-list.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>Deprecated List (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>Deprecated List (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Deprecated List (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="Deprecated List (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/help-doc.html b/docs/apidocs/help-doc.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>API Help (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>API Help (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="API Help (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="API Help (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/index-all.html b/docs/apidocs/index-all.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>Index (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>Index (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Index (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="Index (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/index.html b/docs/apidocs/index.html
@@ -2,8 +2,8 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>picocli-jansi-graalvm 1.1.0 API</title>
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>picocli-jansi-graalvm 1.2.0 API</title>
 <script type="text/javascript">
     tmpTargetPage = "" + window.location.search;
     if (tmpTargetPage != "" && tmpTargetPage != "undefined")

diff --git a/docs/apidocs/overview-tree.html b/docs/apidocs/overview-tree.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>Class Hierarchy (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>Class Hierarchy (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Class Hierarchy (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="Class Hierarchy (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/picocli/jansi/graalvm/AnsiConsole.html b/docs/apidocs/picocli/jansi/graalvm/AnsiConsole.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>AnsiConsole (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>AnsiConsole (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="AnsiConsole (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="AnsiConsole (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/picocli/jansi/graalvm/Workaround.html b/docs/apidocs/picocli/jansi/graalvm/Workaround.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>Workaround (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>Workaround (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Workaround (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="Workaround (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/picocli/jansi/graalvm/package-frame.html b/docs/apidocs/picocli/jansi/graalvm/package-frame.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>picocli.jansi.graalvm (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>picocli.jansi.graalvm (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>

diff --git a/docs/apidocs/picocli/jansi/graalvm/package-summary.html b/docs/apidocs/picocli/jansi/graalvm/package-summary.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>picocli.jansi.graalvm (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>picocli.jansi.graalvm (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="picocli.jansi.graalvm (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="picocli.jansi.graalvm (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/docs/apidocs/picocli/jansi/graalvm/package-tree.html b/docs/apidocs/picocli/jansi/graalvm/package-tree.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Thu Nov 07 22:02:34 JST 2019 -->
-<title>picocli.jansi.graalvm Class Hierarchy (picocli-jansi-graalvm 1.1.0 API)</title>
-<meta name="date" content="2019-11-07">
+<!-- Generated by javadoc (1.8.0_202) on Sat Jul 04 14:07:38 JST 2020 -->
+<title>picocli.jansi.graalvm Class Hierarchy (picocli-jansi-graalvm 1.2.0 API)</title>
+<meta name="date" content="2020-07-04">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="picocli.jansi.graalvm Class Hierarchy (picocli-jansi-graalvm 1.1.0 API)";
+            parent.document.title="picocli.jansi.graalvm Class Hierarchy (picocli-jansi-graalvm 1.2.0 API)";
         }
     }
     catch(err) {

diff --git a/gradle.properties b/gradle.properties
@@ -2,5 +2,5 @@ gradleBintrayPluginVersion=1.+
 jansiVersion=1.18
 junitJupiterVersion = 5.5.2
 palantirGradleGraalVersion = 0.6.0
-picocliVersion=4.0.4
-projectVersion=1.1.1-SNAPSHOT
+picocliVersion=4.3.2
+projectVersion=1.2.0