+ module Buildr::IntellijIdea::ProjectExtension +

+ +

+ + + + +

+ + + + + + + + + +

Public Instance Methods

+ + +

+ +

+ iml() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1490
+def iml
+  if iml?
+    unless @iml
+      inheritable_iml_source = self.parent
+      while inheritable_iml_source && !inheritable_iml_source.iml?
+        inheritable_iml_source = inheritable_iml_source.parent;
+      end
+      @iml = inheritable_iml_source ? inheritable_iml_source.iml.clone : IdeaModule.new
+      @iml.buildr_project = self
+    end
+    return @iml
+  else
+    raise "IML generation is disabled for #{self.name}"
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ iml?() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1514
+def iml?
+  @has_iml = @has_iml.nil? ? true : @has_iml
+end

+ +

+ + + + +

+ + +

+ +

+ ipr() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1478
+def ipr
+  if ipr?
+    @ipr ||= IdeaProject.new(self)
+  else
+    raise 'Only the root project has an IPR'
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ ipr?() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1486
+def ipr?
+  !@no_ipr && self.parent.nil?
+end

+ +

+ + + + +

+ + +

+ +

+ no_iml() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1510
+def no_iml
+  @has_iml = false
+end

+ +

+ + + + +

+ + +

+ +

+ no_ipr() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/ide/idea.rb, line 1506
+def no_ipr
+  @no_ipr = true
+end

+ +

+ + + + +

+ + +

+ +

+ class Buildr::JBehave +

+ +

JBehave is a Java BDD +framework. To use in your project:

+ +

test.using :jbehave
+

+ +

This framework will search in your project for:

+ +

src/spec/java   /*Behaviour.java

+ +

JMock libraries are included on runtime.

+ +

Support the following options:

+
:properties â Hash of properties to the test +suite
+
+
:java_args â Arguments passed to the JVM
+

+ +

+ + + + +

+ + + + + +

Constants

VERSION + +: + + +

+ + + + + +

Public Class Methods

+ + +

+ +

+ dependencies() + + click to toggle source + +

+ + +

+ + + + +

+ Calls superclass method + +

+ + + +

# File lib/buildr/java/bdd.rb, line 298
+def dependencies
+  unless @dependencies
+    super
+    @dependencies |= ["org.jbehave:jbehave:jar:#{version}", 'cglib:cglib-full:jar:2.0.2'] +
+                     JMock.dependencies + JUnit.dependencies
+  end
+  @dependencies
+end

+ +

+ + + + +

+ + +

+ +

+ version() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/bdd.rb, line 294
+def version
+  Buildr.settings.build['jbehave'] || VERSION
+end

+ +

+ + + + +

+ + +

+ +

+ module Buildr::JMock +

+ +

JMock is available when using JUnit and TestNG, JBehave.

+ +

+ + + + +

+ + + + + +

Constants

VERSION + +: + + +

+ + + + + +

Public Class Methods

+ + +

+ +

+ dependencies(versions = {:hamcrest => '1.1'}) + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/tests.rb, line 99
+def dependencies(versions = {:hamcrest => '1.1'})
+  two_or_later = version[0,1].to_i >= 2
+  group = two_or_later ? 'org.jmock' : 'jmock'
+
+  @dependencies ||= ["#{group}:jmock:jar:#{version}"]
+  if two_or_later
+    @dependencies << "org.jmock:jmock-junit#{Buildr::JUnit.version.to_s[0,1]}:jar:#{version}"
+    @dependencies << "org.hamcrest:hamcrest-core:jar:#{versions[:hamcrest]}"
+    @dependencies << "org.hamcrest:hamcrest-library:jar:#{versions[:hamcrest]}"
+  end
+  @dependencies
+end

+ +

+ + + + +

+ + +

+ +

+ version() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/tests.rb, line 95
+def version
+  Buildr.settings.build['jmock'] || VERSION
+end

+ +

+ + + + +

+ + +

+ +

+ module Buildr::JRebel +

+ +

+ + + + +

+ + + + + + + + + +

Public Instance Methods

+ + +

+ +

+ jrebel_args() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/core/jrebel.rb, line 33
+def jrebel_args
+  rebel_jar ? [ '-noverify', "-javaagent:#{rebel_jar}" ] : []
+end

+ +

+ + + + +

+ + +

+ +

+ jrebel_home() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/core/jrebel.rb, line 18
+def jrebel_home
+  unless @jrebel_home
+    @jrebel_home = ENV['REBEL_HOME'] || ENV['JREBEL'] || ENV['JREBEL_HOME']
+  end
+
+  (@jrebel_home && File.exists?(@jrebel_home)) ? @jrebel_home : nil
+end

+ +

+ + + + +

+ + +

+ +

+ jrebel_props(project) + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/core/jrebel.rb, line 37
+def jrebel_props(project)
+  {}
+end

+ +

+ + + + +

+ + +

+ +

+ rebel_jar() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/core/jrebel.rb, line 26
+def rebel_jar
+  if jrebel_home
+    # jrebel_home may point to jrebel.jar directly
+    File.directory?(jrebel_home) ? File.join(jrebel_home, 'jrebel.jar') : jrebel_home
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ class Buildr::JUnit +

+ +

JUnit test framework, the default test framework +for Java tests.

+ +

Support the following options:

+
:fork â If true/:once (default), fork for each test class. If +:each, fork for each individual
+ +
```
test case.  If false, run all tests in the same VM (fast, but dangerous).
```
+
+
:clonevm â If true clone the VM each time it is forked.
+
+
:properties â Hash of system properties +available to the test case.
+
+
:environment â Hash of environment variables +available to the test case.
+
+
:java_args â Arguments passed as is to the JVM.
+

+ +

+ + + + +

+ + + + + +

Constants

VERSION + +: JUnit version number.
+ + +

+ + + + + +

Public Class Methods

+ + +

+ +

+ dependencies() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/tests.rb, line 193
+def dependencies
+  four11_or_newer = version >= '4.11'
+  @dependencies ||= ["junit:junit:jar:#{version}"]+ (four11_or_newer ? JMock.dependencies({:hamcrest => '1.3'}) : JMock.dependencies)
+end

+ +

+ + + + +

+ + +

+ + report() + + + click to toggle source + +

+ + + +

+ +

Returns the Report object used by the +junit:report task. You can use this object to set various options that +affect your report, for example:

+ +

JUnit.report.frames = false
+JUnit.report.params['title'] = 'My App'
+

+ + + + +

# File lib/buildr/java/tests.rb, line 185
+def report
+  @report ||= Report.new
+end

+ +

+ + + + +

+ + +

+ +

+ version() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/tests.rb, line 189
+def version
+  Buildr.settings.build['junit'] || VERSION
+end

+ +

+ + + + +

+ + +

+ +

+ class Buildr::JUnit::Report +

+ +

Used by the junit:report task. Access through JUnit#report if you want to +set various options for that task, for example:

+ +

JUnit.report.frames = false
+

+ +

+ + + + +

+ + + + + + + +

Attributes

+ + +

+ frames[RW] +

+ +

True (default) to produce a report using frames, false to produce a +single-page report.

+ +

+ params[R] +

+ +

Parameters passed to the Ant JUnitReport task.

+ +

+ style_dir[RW] +

+ +

Directory for the report style (defaults to using the internal style).

+ +

+ target[RW] +

+ +

Target directory for generated report.

+ +

+ + + +

Public Class Methods

+ + +

+ +

+ new() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/java/tests.rb, line 140
+def initialize
+  @params = {}
+  @frames = true
+  @target = 'reports/junit'
+end

+ +

+ + + + +

+ + +

+ +

Public Instance Methods

+ + +

+ + generate(projects, target?) + + + click to toggle source + +

+ + + +

+ +

Generates a JUnit report for these projects +(must run JUnit tests first) into the target +directory. You can specify a target, or let it pick the default one from +the target attribute.

+ + + + +

# File lib/buildr/java/tests.rb, line 152
+def generate(projects, target = @target.to_s)
+  html_in = File.join(target, 'html')
+  rm_rf html_in ; mkpath html_in
+
+  Buildr.ant('junit-report') do |ant|
+    ant.taskdef :name=>'junitreport', :classname=>'org.apache.tools.ant.taskdefs.optional.junit.XMLResultAggregator',
+      :classpath=>Buildr.artifacts(JUnit.ant_taskdef).each(&:invoke).map(&:to_s).join(File::PATH_SEPARATOR)
+    ant.junitreport :todir=>target do
+      projects.select { |project| project.test.framework == :junit }.
+        map { |project| project.test.report_to.to_s }.select { |path| File.exist?(path) }.
+        each { |path| ant.fileset(:dir=>path) { ant.include :name=>'TEST-*.xml' }  }
+      options = { :format=>frames ? 'frames' : 'noframes' }
+      options[:styledir] = style_dir if style_dir
+      ant.report options.merge(:todir=>html_in) do
+        params.each { |key, value| ant.param :name=>key, :expression=>value }
+      end
+    end
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ module Buildr::Kotlin +

+ +

The Kotlin Module

+ +

+ + + + +

+ + + + + +

Constants

DEFAULT_VERSION + +: + + +

+ + + + + +

Public Class Methods

+ + +

+ +

+ installed_version() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 22
+def installed_version
+  unless @installed_version
+    @installed_version = if Kotlinc.installed?
+      begin
+        # try to read the value from the build.txt file
+        version_str = File.read(File.expand_path('build.txt', Kotlinc.kotlin_home))
+
+        if version_str
+          md = version_str.match(/\d+\.\d[\d\.]*/) or
+            fail "Unable to parse Kotlin version: #{version_str}"
+
+          md[0].sub(/.$/, "") # remove trailing dot, if any
+        end
+      rescue => e
+        warn "Unable to parse library.properties in $KOTLIN_HOME/build.txt: #{e}"
+        nil
+      end
+    end
+  end
+
+  @installed_version
+end

+ +

+ + + + +

+ + +

+ +

+ version() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 45
+def version
+  Buildr.settings.build['kotlin.version'] || installed_version || DEFAULT_VERSION
+end

+ +

+ + + + +

+ + +

+ +

+ version?(*v) + + click to toggle source + +

+ + +

+ +

check if version matches any of the given prefixes

+ + + + +

# File lib/buildr/kotlin/compiler.rb, line 50
+def version?(*v)
+  v.any? { |v| version.index(v.to_s) == 0 }
+end

+ +

+ + + + +

+ + +

+ +

+ class Buildr::Kotlin::Kotlinc +

+ +

Kotlin compiler:

+ +

compile.using(:kotlin)
+

+ +

Used by default if .kt files are found in the src/main/kotlin directory (or +src/test/kotlin) and sets the target directory to target/classes (or +target/test/classes). Accepts the following options:

+
:warnings â Issue warnings when compiling. True when running in verbose +mode.
+
+
:debug â Generates bytecode with debugging information. Set from the +debug
+

+ +

environment variable/global option.

+
:optimize â Optimize the byte code generation. False by default.
+
+
:target â Bytecode compatibility.
+
+
:noStdlib â Include the Kotlin runtime. +False by default.
+
+
:javac â Arguments for javac compiler.
+

+ +

+ + + + +

+ + + + + +

Constants

Javac + +

Javac compiler:

+ +

compile.using(:javac)
+

+ +

Used by default if .java files are found in the src/main/java directory (or +src/test/java) and sets the target directory to target/classes (or +target/test/classes).

+ +

Accepts the following options:

+
:warnings â Issue warnings when compiling. True when running in verbose +mode.
+
+
:debug â Generates bytecode with debugging information. Set from the +debug
+

+ +

environment variable/global option.

+
:deprecation â If true, shows deprecation messages. False by default.
+
+
:source â Source code compatibility.
+
+
:target â Bytecode compatibility.
+
+
:lint â Lint option is one of true, false (default), name (e.g. +'cast') or array.
+
+
:other â Array of options passed to the compiler
+

+ +

(e.g. ['-implicit:none', '-encoding', +'iso-8859-1'])

+ + +

OPTIONS + +

+ + +

REQUIRES + +

The kotlin compiler jars are added to classpath at load time, if you want +to customize artifact versions, you must set them on the

+ +

artifact_ns['Buildr::Compiler::Kotlinc'].library = '1.1.3-2'
+

+ +

namespace before this file is required. This is of course, only if +KOTLIN_HOME is not set or invalid.

+ + +

+ + + + + +

Public Class Methods

+ + +

+ +

+ dependencies() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 93
+def dependencies
+  kotlin_dependencies = if use_installed?
+    %w(kotlin-stdlib kotlin-compiler).map { |s| File.expand_path("lib/#{s}.jar", kotlin_home) }
+  else
+    REQUIRES.artifacts.map(&:to_s)
+  end
+  # Add Java utilities (eg KotlinMessageCollector)
+  kotlin_dependencies |= [ File.join(File.dirname(__FILE__)) ]
+  (kotlin_dependencies).compact
+end

+ +

+ + + + +

+ + +

+ +

+ installed?() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 81
+def installed?
+  !kotlin_home.nil?
+end

+ +

+ + + + +

+ + +

+ +

+ kotlin_home() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 71
+def kotlin_home
+  env_home = ENV['KOTLIN_HOME']
+
+  @home ||= if !env_home.nil? && File.exists?(env_home + '/lib/kotlin-compiler.jar')
+    env_home
+  else
+    nil
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ use_installed?() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 85
+def use_installed?
+  if installed? && Buildr.settings.build['kotlin.version']
+    Buildr.settings.build['kotlin.version'] == Kotlin.installed_version
+  else
+    Buildr.settings.build['kotlin.version'].nil? && installed?
+  end
+end

+ +

+ + + + +

+ + +

+ +

+ class Buildr::Kotlin::KotlincOptions +

+ +

+ + + + +

+ + + + + + + +

Attributes

+ + +

+ incremental[W] +

+ +

+ + + +

+ +

+ + + +

Public Class Methods

+ + +

+ +

+ new(project) + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 266
+def initialize(project)
+  @project = project
+end

+ +

+ + + + +

+ + +

+ +

Public Instance Methods

+ + +

+ +

+ incremental() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 270
+def incremental
+  @incremental || (@project.parent ? @project.parent.kotlinc_options.incremental : nil)
+end

+ +

+ + + + +

+ + +

+ +

+ module Buildr::Kotlin::ProjectExtension +

+ +

+ + + + +

+ + + + + + + + + +

Public Instance Methods

+ + +

+ +

+ kotlinc_options() + + click to toggle source + +

+ + +

+ + + + + + +

# File lib/buildr/kotlin/compiler.rb, line 258
+def kotlinc_options
+  @kotlinc ||= KotlincOptions.new(self)
+end

+ +

+ + + + +

+ + +

+ +