You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by pa...@apache.org on 2020/07/09 14:25:07 UTC
[groovy] branch GROOVY_3_0_X updated (9a1dcbb -> 684a889)
This is an automated email from the ASF dual-hosted git repository.
paulk pushed a change to branch GROOVY_3_0_X
in repository https://gitbox.apache.org/repos/asf/groovy.git.
from 9a1dcbb Trivial tweak: support cleaning java stubs in parallel
new a010786 move assets so that they are in the correct place "in situ" to help with viewing adoc files on github or IDE (closes #1305)
new 684a889 GROOVY-9633: Refresh the doco for the Groovy Console
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
gradle/asciidoctor.gradle | 4 ++--
src/spec/{ => doc}/assets/css/style.css | 0
src/spec/{ => doc}/assets/css/view-example.css | 0
.../assets/img/ChainOfResponsibilityClasses.gif | Bin
src/spec/{ => doc}/assets/img/CompositeClasses.gif | Bin
.../{ => doc}/assets/img/CompositeComponents.gif | Bin
.../{ => doc}/assets/img/GroovyInterceptions.png | Bin
src/spec/{ => doc}/assets/img/StrategyClasses.gif | Bin
.../{ => doc}/assets/img/TemplateMethodClasses.gif | Bin
src/spec/{ => doc}/assets/img/a380.jpg | Bin
.../{ => doc}/assets/img/additionalmodules.png | Bin
src/spec/{ => doc}/assets/img/b797-hoax.jpg | Bin
src/spec/{ => doc}/assets/img/catalina.gif | Bin
src/spec/{ => doc}/assets/img/fileassociation.png | Bin
.../assets/img/jconsole-implicit-export.png | Bin
src/spec/{ => doc}/assets/img/jconsole.gif | Bin
src/spec/{ => doc}/assets/img/native.jpg | Bin
src/spec/{ => doc}/assets/img/oc4jpie.gif | Bin
src/spec/{ => doc}/assets/img/outdir.png | Bin
src/spec/{ => doc}/assets/img/setup.png | Bin
src/spec/{ => doc}/assets/img/usageMessageSpec.png | Bin
src/spec/{ => doc}/assets/img/variables.jpg | Bin
src/spec/{ => doc}/assets/js/jquery-2.1.1.min.js | 0
src/spec/{ => doc}/assets/js/view-example.js | 0
.../src/spec/assets/img/astbrowser.png | Bin 139859 -> 0 bytes
.../src/spec/assets/img/gconsole-toolbar.png | Bin 7163 -> 0 bytes
.../spec/{ => doc}/assets/img/GroovyConsole.gif | Bin
.../spec/doc/assets/img/astbrowser_bytecode.png | Bin 0 -> 50928 bytes
.../src/spec/doc/assets/img/astbrowser_source.png | Bin 0 -> 53233 bytes
.../src/spec/doc/assets/img/cstbrowser.png | Bin 0 -> 51174 bytes
.../{ => doc}/assets/img/gconsole-sc-with-visu.png | Bin
.../assets/img/gconsole-sc-without-visu.png | Bin
.../src/spec/doc/assets/img/gconsole-toolbar.png | Bin 0 -> 8325 bytes
.../src/spec/doc/groovy-console.adoc | 26 +++++++++++++++++----
.../spec/{ => doc}/assets/img/SwingBuilder001.gif | Bin
35 files changed, 24 insertions(+), 6 deletions(-)
rename src/spec/{ => doc}/assets/css/style.css (100%)
rename src/spec/{ => doc}/assets/css/view-example.css (100%)
rename src/spec/{ => doc}/assets/img/ChainOfResponsibilityClasses.gif (100%)
rename src/spec/{ => doc}/assets/img/CompositeClasses.gif (100%)
rename src/spec/{ => doc}/assets/img/CompositeComponents.gif (100%)
rename src/spec/{ => doc}/assets/img/GroovyInterceptions.png (100%)
rename src/spec/{ => doc}/assets/img/StrategyClasses.gif (100%)
rename src/spec/{ => doc}/assets/img/TemplateMethodClasses.gif (100%)
rename src/spec/{ => doc}/assets/img/a380.jpg (100%)
rename src/spec/{ => doc}/assets/img/additionalmodules.png (100%)
rename src/spec/{ => doc}/assets/img/b797-hoax.jpg (100%)
rename src/spec/{ => doc}/assets/img/catalina.gif (100%)
rename src/spec/{ => doc}/assets/img/fileassociation.png (100%)
rename src/spec/{ => doc}/assets/img/jconsole-implicit-export.png (100%)
rename src/spec/{ => doc}/assets/img/jconsole.gif (100%)
rename src/spec/{ => doc}/assets/img/native.jpg (100%)
rename src/spec/{ => doc}/assets/img/oc4jpie.gif (100%)
rename src/spec/{ => doc}/assets/img/outdir.png (100%)
rename src/spec/{ => doc}/assets/img/setup.png (100%)
rename src/spec/{ => doc}/assets/img/usageMessageSpec.png (100%)
rename src/spec/{ => doc}/assets/img/variables.jpg (100%)
rename src/spec/{ => doc}/assets/js/jquery-2.1.1.min.js (100%)
rename src/spec/{ => doc}/assets/js/view-example.js (100%)
delete mode 100644 subprojects/groovy-console/src/spec/assets/img/astbrowser.png
delete mode 100644 subprojects/groovy-console/src/spec/assets/img/gconsole-toolbar.png
rename subprojects/groovy-console/src/spec/{ => doc}/assets/img/GroovyConsole.gif (100%)
create mode 100644 subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_bytecode.png
create mode 100644 subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_source.png
create mode 100644 subprojects/groovy-console/src/spec/doc/assets/img/cstbrowser.png
rename subprojects/groovy-console/src/spec/{ => doc}/assets/img/gconsole-sc-with-visu.png (100%)
rename subprojects/groovy-console/src/spec/{ => doc}/assets/img/gconsole-sc-without-visu.png (100%)
create mode 100644 subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png
rename subprojects/groovy-swing/src/spec/{ => doc}/assets/img/SwingBuilder001.gif (100%)
[groovy] 02/02: GROOVY-9633: Refresh the doco for the Groovy Console
Posted by pa...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
paulk pushed a commit to branch GROOVY_3_0_X
in repository https://gitbox.apache.org/repos/asf/groovy.git
commit 684a8896846d1348115a35f9d537b855314f415c
Author: Paul King <pa...@asert.com.au>
AuthorDate: Fri Jul 10 00:20:29 2020 +1000
GROOVY-9633: Refresh the doco for the Groovy Console
---
.../src/spec/doc/assets/img/astbrowser.png | Bin 139859 -> 0 bytes
.../spec/doc/assets/img/astbrowser_bytecode.png | Bin 0 -> 50928 bytes
.../src/spec/doc/assets/img/astbrowser_source.png | Bin 0 -> 53233 bytes
.../src/spec/doc/assets/img/cstbrowser.png | Bin 0 -> 51174 bytes
.../src/spec/doc/assets/img/gconsole-toolbar.png | Bin 7163 -> 8325 bytes
.../src/spec/doc/groovy-console.adoc | 26 +++++++++++++++++----
6 files changed, 22 insertions(+), 4 deletions(-)
diff --git a/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser.png b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser.png
deleted file mode 100644
index 2a96295..0000000
Binary files a/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser.png and /dev/null differ
diff --git a/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_bytecode.png b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_bytecode.png
new file mode 100644
index 0000000..beb5c4a
Binary files /dev/null and b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_bytecode.png differ
diff --git a/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_source.png b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_source.png
new file mode 100644
index 0000000..1d852db
Binary files /dev/null and b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser_source.png differ
diff --git a/subprojects/groovy-console/src/spec/doc/assets/img/cstbrowser.png b/subprojects/groovy-console/src/spec/doc/assets/img/cstbrowser.png
new file mode 100644
index 0000000..8c5072a
Binary files /dev/null and b/subprojects/groovy-console/src/spec/doc/assets/img/cstbrowser.png differ
diff --git a/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png b/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png
index c6a0cc3..c7036da 100644
Binary files a/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png and b/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png differ
diff --git a/subprojects/groovy-console/src/spec/doc/groovy-console.adoc b/subprojects/groovy-console/src/spec/doc/groovy-console.adoc
index a77d7df..456b1e9 100644
--- a/subprojects/groovy-console/src/spec/doc/groovy-console.adoc
+++ b/subprojects/groovy-console/src/spec/doc/groovy-console.adoc
@@ -208,17 +208,35 @@ transforms << { result ->
The Groovy Swing console will execute that script on startup, injecting
a transforms list in the binding of the script, so that you can add your
own script results representations. In our case, we transform the Map
-into a nice-looking Swing JTable. And we’re now able to visualize maps
+into a nice-looking Swing JTable. We’re now able to visualize maps
in a friendly and attractive fashion, as the screenshot below shows:
image:assets/img/gconsole-sc-with-visu.png[image]
[[GroovyConsole-ASTbrowser]]
-== AST browser
+== Advanced debugging: AST browser
Groovy Console can visualize the AST (Abstract Syntax Tree) representing
the currently edited script, as shown by the screenshot below. This is
-particularly handy when you want to develop AST transformations.
+useful when you want to understand how an AST transformation
+is working and particularly handy if you are developing your own AST transform.
+In the example below, we have annotated our class with the `@Immutable` annotation
+and the Groovy compiler has generated a lot of boilerplate code for us.
+We can see the code for the generated equals method in the `Source` tab.
-image:assets/img/astbrowser.png[AST Browser]
+image:assets/img/astbrowser_source.png[AST Browser]
+
+We can even examine the JVM bytecode generated by the compiler.
+In the image below we are looking at the bytecode for the Groovy
+expression `LocalDate.parse('2020/02/10', 'yyyy/MM/dd')`.
+
+image:assets/img/astbrowser_bytecode.png[AST Browser]
+
+[[GroovyConsole-CSTbrowser]]
+== Advanced debugging: CST browser
+
+Groovy Console can visualize the CST (Concrete Syntax Tree) representing
+the initial parsing of the script. This is mainly useful for parsing gurus.
+
+image:assets/img/cstbrowser.png[CST Browser]
[groovy] 01/02: move assets so that they are in the correct place
"in situ" to help with viewing adoc files on github or IDE (closes #1305)
Posted by pa...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
paulk pushed a commit to branch GROOVY_3_0_X
in repository https://gitbox.apache.org/repos/asf/groovy.git
commit a010786a70f5a4012d8267d2345856720d1c0f95
Author: Paul King <pa...@asert.com.au>
AuthorDate: Thu Jul 9 23:35:03 2020 +1000
move assets so that they are in the correct place "in situ" to help with viewing adoc files on github or IDE (closes #1305)
---
gradle/asciidoctor.gradle | 4 ++--
src/spec/{ => doc}/assets/css/style.css | 0
src/spec/{ => doc}/assets/css/view-example.css | 0
.../{ => doc}/assets/img/ChainOfResponsibilityClasses.gif | Bin
src/spec/{ => doc}/assets/img/CompositeClasses.gif | Bin
src/spec/{ => doc}/assets/img/CompositeComponents.gif | Bin
src/spec/{ => doc}/assets/img/GroovyInterceptions.png | Bin
src/spec/{ => doc}/assets/img/StrategyClasses.gif | Bin
src/spec/{ => doc}/assets/img/TemplateMethodClasses.gif | Bin
src/spec/{ => doc}/assets/img/a380.jpg | Bin
src/spec/{ => doc}/assets/img/additionalmodules.png | Bin
src/spec/{ => doc}/assets/img/b797-hoax.jpg | Bin
src/spec/{ => doc}/assets/img/catalina.gif | Bin
src/spec/{ => doc}/assets/img/fileassociation.png | Bin
src/spec/{ => doc}/assets/img/jconsole-implicit-export.png | Bin
src/spec/{ => doc}/assets/img/jconsole.gif | Bin
src/spec/{ => doc}/assets/img/native.jpg | Bin
src/spec/{ => doc}/assets/img/oc4jpie.gif | Bin
src/spec/{ => doc}/assets/img/outdir.png | Bin
src/spec/{ => doc}/assets/img/setup.png | Bin
src/spec/{ => doc}/assets/img/usageMessageSpec.png | Bin
src/spec/{ => doc}/assets/img/variables.jpg | Bin
src/spec/{ => doc}/assets/js/jquery-2.1.1.min.js | 0
src/spec/{ => doc}/assets/js/view-example.js | 0
.../src/spec/{ => doc}/assets/img/GroovyConsole.gif | Bin
.../src/spec/{ => doc}/assets/img/astbrowser.png | Bin
.../src/spec/{ => doc}/assets/img/gconsole-sc-with-visu.png | Bin
.../spec/{ => doc}/assets/img/gconsole-sc-without-visu.png | Bin
.../src/spec/{ => doc}/assets/img/gconsole-toolbar.png | Bin
.../src/spec/{ => doc}/assets/img/SwingBuilder001.gif | Bin
30 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/gradle/asciidoctor.gradle b/gradle/asciidoctor.gradle
index b0cb0bc..0fad8aa 100644
--- a/gradle/asciidoctor.gradle
+++ b/gradle/asciidoctor.gradle
@@ -84,10 +84,10 @@ asciidoctor {
asciidoctor.onlyIf { project.file('src/spec/doc').exists() }
task asciidoctorAssets(type:Copy) {
- from project.fileTree('src/spec/assets')
+ from project.fileTree('src/spec/doc/assets')
into "${asciidoctor.outputDir}/html5/assets"
}
-asciidoctor.finalizedBy asciidoctorAssets
+asciidoctor.dependsOn asciidoctorAssets
def adocSanityCheck = { file, text, errors ->
Set localErrors = []
diff --git a/src/spec/assets/css/style.css b/src/spec/doc/assets/css/style.css
similarity index 100%
rename from src/spec/assets/css/style.css
rename to src/spec/doc/assets/css/style.css
diff --git a/src/spec/assets/css/view-example.css b/src/spec/doc/assets/css/view-example.css
similarity index 100%
rename from src/spec/assets/css/view-example.css
rename to src/spec/doc/assets/css/view-example.css
diff --git a/src/spec/assets/img/ChainOfResponsibilityClasses.gif b/src/spec/doc/assets/img/ChainOfResponsibilityClasses.gif
similarity index 100%
rename from src/spec/assets/img/ChainOfResponsibilityClasses.gif
rename to src/spec/doc/assets/img/ChainOfResponsibilityClasses.gif
diff --git a/src/spec/assets/img/CompositeClasses.gif b/src/spec/doc/assets/img/CompositeClasses.gif
similarity index 100%
rename from src/spec/assets/img/CompositeClasses.gif
rename to src/spec/doc/assets/img/CompositeClasses.gif
diff --git a/src/spec/assets/img/CompositeComponents.gif b/src/spec/doc/assets/img/CompositeComponents.gif
similarity index 100%
rename from src/spec/assets/img/CompositeComponents.gif
rename to src/spec/doc/assets/img/CompositeComponents.gif
diff --git a/src/spec/assets/img/GroovyInterceptions.png b/src/spec/doc/assets/img/GroovyInterceptions.png
similarity index 100%
rename from src/spec/assets/img/GroovyInterceptions.png
rename to src/spec/doc/assets/img/GroovyInterceptions.png
diff --git a/src/spec/assets/img/StrategyClasses.gif b/src/spec/doc/assets/img/StrategyClasses.gif
similarity index 100%
rename from src/spec/assets/img/StrategyClasses.gif
rename to src/spec/doc/assets/img/StrategyClasses.gif
diff --git a/src/spec/assets/img/TemplateMethodClasses.gif b/src/spec/doc/assets/img/TemplateMethodClasses.gif
similarity index 100%
rename from src/spec/assets/img/TemplateMethodClasses.gif
rename to src/spec/doc/assets/img/TemplateMethodClasses.gif
diff --git a/src/spec/assets/img/a380.jpg b/src/spec/doc/assets/img/a380.jpg
similarity index 100%
rename from src/spec/assets/img/a380.jpg
rename to src/spec/doc/assets/img/a380.jpg
diff --git a/src/spec/assets/img/additionalmodules.png b/src/spec/doc/assets/img/additionalmodules.png
similarity index 100%
rename from src/spec/assets/img/additionalmodules.png
rename to src/spec/doc/assets/img/additionalmodules.png
diff --git a/src/spec/assets/img/b797-hoax.jpg b/src/spec/doc/assets/img/b797-hoax.jpg
similarity index 100%
rename from src/spec/assets/img/b797-hoax.jpg
rename to src/spec/doc/assets/img/b797-hoax.jpg
diff --git a/src/spec/assets/img/catalina.gif b/src/spec/doc/assets/img/catalina.gif
similarity index 100%
rename from src/spec/assets/img/catalina.gif
rename to src/spec/doc/assets/img/catalina.gif
diff --git a/src/spec/assets/img/fileassociation.png b/src/spec/doc/assets/img/fileassociation.png
similarity index 100%
rename from src/spec/assets/img/fileassociation.png
rename to src/spec/doc/assets/img/fileassociation.png
diff --git a/src/spec/assets/img/jconsole-implicit-export.png b/src/spec/doc/assets/img/jconsole-implicit-export.png
similarity index 100%
rename from src/spec/assets/img/jconsole-implicit-export.png
rename to src/spec/doc/assets/img/jconsole-implicit-export.png
diff --git a/src/spec/assets/img/jconsole.gif b/src/spec/doc/assets/img/jconsole.gif
similarity index 100%
rename from src/spec/assets/img/jconsole.gif
rename to src/spec/doc/assets/img/jconsole.gif
diff --git a/src/spec/assets/img/native.jpg b/src/spec/doc/assets/img/native.jpg
similarity index 100%
rename from src/spec/assets/img/native.jpg
rename to src/spec/doc/assets/img/native.jpg
diff --git a/src/spec/assets/img/oc4jpie.gif b/src/spec/doc/assets/img/oc4jpie.gif
similarity index 100%
rename from src/spec/assets/img/oc4jpie.gif
rename to src/spec/doc/assets/img/oc4jpie.gif
diff --git a/src/spec/assets/img/outdir.png b/src/spec/doc/assets/img/outdir.png
similarity index 100%
rename from src/spec/assets/img/outdir.png
rename to src/spec/doc/assets/img/outdir.png
diff --git a/src/spec/assets/img/setup.png b/src/spec/doc/assets/img/setup.png
similarity index 100%
rename from src/spec/assets/img/setup.png
rename to src/spec/doc/assets/img/setup.png
diff --git a/src/spec/assets/img/usageMessageSpec.png b/src/spec/doc/assets/img/usageMessageSpec.png
similarity index 100%
rename from src/spec/assets/img/usageMessageSpec.png
rename to src/spec/doc/assets/img/usageMessageSpec.png
diff --git a/src/spec/assets/img/variables.jpg b/src/spec/doc/assets/img/variables.jpg
similarity index 100%
rename from src/spec/assets/img/variables.jpg
rename to src/spec/doc/assets/img/variables.jpg
diff --git a/src/spec/assets/js/jquery-2.1.1.min.js b/src/spec/doc/assets/js/jquery-2.1.1.min.js
similarity index 100%
rename from src/spec/assets/js/jquery-2.1.1.min.js
rename to src/spec/doc/assets/js/jquery-2.1.1.min.js
diff --git a/src/spec/assets/js/view-example.js b/src/spec/doc/assets/js/view-example.js
similarity index 100%
rename from src/spec/assets/js/view-example.js
rename to src/spec/doc/assets/js/view-example.js
diff --git a/subprojects/groovy-console/src/spec/assets/img/GroovyConsole.gif b/subprojects/groovy-console/src/spec/doc/assets/img/GroovyConsole.gif
similarity index 100%
rename from subprojects/groovy-console/src/spec/assets/img/GroovyConsole.gif
rename to subprojects/groovy-console/src/spec/doc/assets/img/GroovyConsole.gif
diff --git a/subprojects/groovy-console/src/spec/assets/img/astbrowser.png b/subprojects/groovy-console/src/spec/doc/assets/img/astbrowser.png
similarity index 100%
rename from subprojects/groovy-console/src/spec/assets/img/astbrowser.png
rename to subprojects/groovy-console/src/spec/doc/assets/img/astbrowser.png
diff --git a/subprojects/groovy-console/src/spec/assets/img/gconsole-sc-with-visu.png b/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-sc-with-visu.png
similarity index 100%
rename from subprojects/groovy-console/src/spec/assets/img/gconsole-sc-with-visu.png
rename to subprojects/groovy-console/src/spec/doc/assets/img/gconsole-sc-with-visu.png
diff --git a/subprojects/groovy-console/src/spec/assets/img/gconsole-sc-without-visu.png b/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-sc-without-visu.png
similarity index 100%
rename from subprojects/groovy-console/src/spec/assets/img/gconsole-sc-without-visu.png
rename to subprojects/groovy-console/src/spec/doc/assets/img/gconsole-sc-without-visu.png
diff --git a/subprojects/groovy-console/src/spec/assets/img/gconsole-toolbar.png b/subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png
similarity index 100%
rename from subprojects/groovy-console/src/spec/assets/img/gconsole-toolbar.png
rename to subprojects/groovy-console/src/spec/doc/assets/img/gconsole-toolbar.png
diff --git a/subprojects/groovy-swing/src/spec/assets/img/SwingBuilder001.gif b/subprojects/groovy-swing/src/spec/doc/assets/img/SwingBuilder001.gif
similarity index 100%
rename from subprojects/groovy-swing/src/spec/assets/img/SwingBuilder001.gif
rename to subprojects/groovy-swing/src/spec/doc/assets/img/SwingBuilder001.gif