NameDateSize

..16-Mar-201612 KiB

.gitignore30-Dec-20142.5 KiB

benchmark/26-May-20154 KiB

build.gradle26-May-201514.9 KiB

buildSrc/26-May-20154 KiB

config/26-May-20154 KiB

DISCLAIMER26-May-2015536

gradle/26-May-20154 KiB

gradle.properties02-Mar-2015732

gradlew20-Feb-20135 KiB

gradlew.bat29-Dec-20122.3 KiB

LICENSE26-May-201536.4 KiB

licenses/26-May-20154 KiB

NOTICE26-May-20151.4 KiB

README.adoc26-May-20155.1 KiB

security/26-May-20154 KiB

settings.gradle27-Jan-2014700

src/26-May-20154 KiB

subprojects/27-Jan-20144 KiB

xdocs/22-Mar-20124 KiB

README.adoc

1= Groovy
2The Groovy development team
3:revdate: 24-02-2014
4:build-icon: http://ci.groovy-lang.org:8111/app/rest/builds/buildType:(id:Groovy_Jdk7Build)/statusIcon
5:noheader:
6:groovy-www: http://groovy-lang.org/
7:groovy-ci: http://ci.groovy-lang.org?guest=1
8:jdk: http://www.oracle.com/technetwork/java/javase/downloads
9:bintray-latest-version-image: https://api.bintray.com/packages/groovy/maven/groovy/images/download.png
10:bintray-latest-version-link: https://bintray.com/groovy/maven/groovy/_latestVersion
11:bintray-watch-image: https://www.bintray.com/docs/images/bintray_badge_color.png
12:bintray-watch-link: https://bintray.com/groovy/maven/groovy/view?source=watch
13
14[.left.text-left]
15image::http://groovy.codehaus.org/img/groovy-logo.png[]
16{groovy-www}[Groovy] is a powerful, optionally typed and dynamic language, with static-typing and static compilation capabilities, for the Java platform aimed at multiplying developers’ productivity thanks to a concise, familiar and easy to learn syntax.
17
18It integrates smoothly with any Java program, and immediately delivers to your application powerful features, including scripting capabilities, Domain-Specific Language authoring, runtime and compile-time meta-programming and functional programming. 
19
20== Downloading
21
22Latest Groovy version is available on Bintray image:{bintray-latest-version-image}[Bintray latest version, link={bintray-latest-version-link}]
23
24Binary distribution links are on the package page.
25
26Maven, Gradle and Ivy dependency declaration snippets are available on specific files of a particular module.
27
28image:{bintray-watch-image}[Get automatic notifications about new "groovy" versions link={bintray-watch-link}]
29
30== Obtaining the Source
31
32You don't need the source code to use Groovy but if you wish to explore its inner workings or build it for yourself there are two ways to obtain the source files.
33
34=== Checking out from Version Control
35
36Apache Groovy uses Git. The official Git repository is at:
37
38    http://git-wip-us.apache.org/repos/asf/incubator-groovy.git
39
40And a mirror is hosted on Github:
41
42    https://github.com/apache/incubator-groovy
43
44The Github mirror is read-only and provides convenience to users and developers to explore the code and for the community to accept contributions via Github pull requests.
45
46Simply `git clone` the repo (or the repo you forked via the github website) and you will have the complete source.
47
48=== Unpacking the src distribution
49
50Alternatively, you can download the source distribution and unpack it.
51
52If obtaining the source from this distribution and you intend to build from source,
53you also need to https://gradle.org/downloads/[download] and install http://gradle.org/[Gradle] and execute one bootstrap step.
54At the top directory of your unpacked source, you need to run the command:
55
56    gradle
57
58This sets up the Gradle wrapper and from then on you just need the `gradlew` command instead of `gradle`.
59
60== Building from Source
61
62Build is image:{build-icon}[build status, link={groovy-ci}].
63
64To build you will need:
65
66* {jdk}[JDK 1.7+]
67
68To build everything using Gradle:
69
70    gradlew clean dist
71
72Note: The gradlew command automatically downloads the correct Gradle version if needed, you do not need to download it first.
73
74This will generate a distribution similar to the zip you can download on the Groovy download page.
75
76To build everything and launch unit tests, use:
77
78    gradlew test
79
80If you want to launch one unit test, use this. <TestClassName> is like `groovy.GroovyMethodsTest`.
81
82    gradlew :test --tests <TestClassName>
83
84To build from IntelliJ IDEA:
85
86    gradlew jarAll idea
87
88Then open the generated project in IDEA.
89
90To build from Eclipse:
91
92    gradlew jarAll eclipse
93
94Then open the generated project and the generated subprojects in Eclipse. But be aware that Eclipse tends to be more limited in its ability to reproduce a Gradle build structure. The generated project files may contain a circular dependency which may or may not prevent Eclipse from using them. It depends on the Eclipse version, if this is an issue or not.
95
96To build the documentation (Groovy Language Documentation):
97
98    gradlew assembleAsciidoc
99
100All code samples of the documentation guide are pulled from actual test cases.  To run a single documentation test case, take for example `src/spec/test/semantics/PowerAssertTest.groovy`
101
102    gradlew testSinglePowerAssertTest
103
104(Note the omission of package name: class is `semantics.PowerAssertTest` but only `PowerAssertTest` is added to `testSingle`.)
105
106== InvokeDynamic support
107
108The Groovy build supports the new Java 7 JVM instruction `invokedynamic`. If you want to build Groovy with invokedynamic, you can use the project property `indy`:
109
110    gradlew -Pindy=true clean test
111
112Please note that the following Gradle tasks generate both indy and non indy variants of the jars, so you don't need to use the system property:
113
114* dist
115* install
116* uploadArchives
117
118== Continuous Integration Server
119
120The official CI server runs {groovy-ci}[here] (login as user guest and leave the password blank) and is sponsored by http://www.jetbrains.com[JetBrains].
121
122== License
123
124Groovy is licensed under the terms of the http://www.apache.org/licenses/LICENSE-2.0.html[Apache License, Version 2.0]
125