buildr 1.2.10 → 1.3.0

data/lib/buildr/java/groovyc.rb

@@ -0,0 +1,137 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+module Buildr
+  module Compiler
+    # Groovyc compiler:
+    #  compile.using(:groovyc)
+    #
+    # You need to require 'buildr/java/groovyc' if you need to use this compiler.
+    #
+    # Used by default if .groovy files are found in the src/main/groovy directory (or src/test/groovy)
+    # and sets the target directory to target/classes (or target/test/classes).
+    #
+    # Groovyc is a joint compiler, this means that when selected for a project, this compiler is used
+    # to compile both groovy and java sources. It's recommended that Groovy sources are placed in the
+    # src/main/groovy directory, even though this compiler also looks in src/main/java
+    #
+    # Groovyc accepts the following options:
+    #
+    # * :encoding          -- Encoding of source files
+    # * :verbose           -- Asks the compiler for verbose output, true when running in verbose mode.
+    # * :fork              -- Whether to execute groovyc using a spawned instance of the JVM; defaults to no
+    # * :memoryInitialSize -- The initial size of the memory for the underlying VM, if using fork mode; ignored otherwise. 
+    #                                     Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)
+    # * :memoryMaximumSize -- The maximum size of the memory for the underlying VM, if using fork mode; ignored otherwise. 
+    #                                     Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)
+    # * :listfiles         -- Indicates whether the source files to be compiled will be listed; defaults to no
+    # * :stacktrace        -- If true each compile error message will contain a stacktrace
+    # * :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.
+    # * :optimise          -- Generates faster bytecode by applying optimisations to the program.
+    # * :source            -- Source code compatibility.
+    # * :target            -- Bytecode compatibility.
+    # * :javac             -- Hash of options passed to the ant javac task
+    #
+    class Groovyc < Base
+      
+      # The groovyc 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::Groovyc'].groovy = '1.5.4'
+      #
+      # namespace before this file is required.
+      REQUIRES = ArtifactNamespace.for(self) do |ns|
+        ns.groovy!       'org.codehaus.groovy:groovy:jar:>=1.5.3'
+        ns.commons_cli!  'commons-cli:commons-cli:jar:>=1.0'
+        ns.asm!          'asm:asm:jar:>=2.2'
+        ns.antlr!        'antlr:antlr:jar:>=2.7.7'
+      end
+      
+      ANT_TASK = 'org.codehaus.groovy.ant.Groovyc'
+      GROOVYC_OPTIONS = [:encoding, :verbose, :fork, :memoryInitialSize, :memoryMaximumSize, :listfiles, :stacktrace]
+      JAVAC_OPTIONS = [:optimise, :warnings, :debug, :deprecation, :source, :target, :javac]
+      OPTIONS = GROOVYC_OPTIONS + JAVAC_OPTIONS
+
+      class << self
+        def dependencies #:nodoc:
+          REQUIRES.artifacts
+        end
+
+        def applies_to?(project, task) #:nodoc:
+          paths = task.sources + [sources].flatten.map { |src| Array(project.path_to(:source, task.usage, src.to_sym)) }
+          paths.flatten!
+          # Just select if we find .groovy files
+          paths.any? { |path| !Dir["#{path}/**/*.groovy"].empty? }
+        end
+      end
+      
+      Java.classpath << dependencies
+      
+      specify :language => :groovy, :sources => [:groovy, :java], :source_ext => [:groovy, :java], 
+              :target => 'classes', :target_ext => 'class', :packaging => :jar
+
+      def initialize(project, options) #:nodoc:
+        super
+        options[:debug] = Buildr.options.debug if options[:debug].nil?
+        options[:deprecation] ||= false
+        options[:optimise] ||= false
+        options[:verbose] ||= Buildr.application.options.trace if options[:verbose].nil?
+        options[:warnings] = verbose if options[:warnings].nil?
+        options[:javac] = OpenObject.new if options[:javac].nil?
+      end
+
+      # http://groovy.codehaus.org/The+groovyc+Ant+Task
+      def compile(sources, target, dependencies) #:nodoc:
+        return if Buildr.application.options.dryrun
+        Buildr.ant 'groovyc' do |ant|
+          classpath = dependencies | self.class.dependencies.map(&:to_s)
+          ant.taskdef :name => 'groovyc', :classname => ANT_TASK, :classpath => classpath.join(File::PATH_SEPARATOR)
+          ant.groovyc groovyc_options(sources, target) do
+            sources.each { |src| ant.src :path => src }
+            ant.classpath do
+              classpath.each { |dep| ant.pathelement :path => dep }
+            end
+            ant.javac(javac_options)
+          end
+        end
+      end
+
+     private 
+      def groovyc_options(sources, target)
+        check_options options, OPTIONS
+        groovyc_options = options.to_hash.only(*GROOVYC_OPTIONS)
+        groovyc_options[:destdir] = File.expand_path(target)
+        groovyc_options
+      end
+
+      def javac_options
+        check_options options, OPTIONS
+        javac_options = options.to_hash.only(*JAVAC_OPTIONS)
+        javac_options[:optimize] = (javac_options.delete(:optimise) || false)
+        javac_options[:nowarn] = (javac_options.delete(:warnings) || verbose).to_s !~ /^(true|yes|on)$/i
+        other = javac_options.delete(:javac) || {}
+        javac_options.merge!(other)
+        javac_options
+      end
+      
+    end
+  end
+end
+
+Buildr::Compiler.compilers.unshift Buildr::Compiler::Groovyc

data/lib/buildr/java/jruby.rb

@@ -0,0 +1,99 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+require 'java'
+require 'jruby'
+
+
+# Buildr runs along side a JVM, using either RJB or JRuby.  The Java module allows
+# you to access Java classes and create Java objects.
+#
+# Java classes are accessed as static methods on the Java module, for example:
+#   str = Java.java.lang.String.new('hai!')
+#   str.toUpperCase
+#   => 'HAI!'
+#   Java.java.lang.String.isInstance(str)
+#   => true
+#   Java.com.sun.tools.javac.Main.compile(args)
+#
+# The classpath attribute allows Buildr to add JARs and directories to the classpath,
+# for example, we use it to load Ant and various Ant tasks, code generators, test
+# frameworks, and so forth.
+#
+# When using an artifact specification, Buildr will automatically download and
+# install the artifact before adding it to the classpath.
+#
+# For example, Ant is loaded as follows:
+#   Java.classpath << 'org.apache.ant:ant:jar:1.7.0'
+#
+# Artifacts can only be downloaded after the Buildfile has loaded, giving it
+# a chance to specify which remote repositories to use, so adding to classpath
+# does not by itself load any libraries.  You must call Java.load before accessing
+# any Java classes to give Buildr a chance to load the libraries specified in the
+# classpath.
+#
+# When building an extension, make sure to follow these rules:
+# 1. Add to the classpath when the extension is loaded (i.e. in module or class
+#    definition), so the first call to Java.load anywhere in the code will include
+#    the libraries you specify.
+# 2. Call Java.load once before accessing any Java classes, allowing Buildr to
+#    set up the classpath.
+# 3. Only call Java.load when invoked, otherwise you may end up loading the JVM
+#    with a partial classpath, or before all remote repositories are listed.
+# 4. Check on a clean build with empty local repository.
+module Java
+
+  class << self
+
+    # Returns the classpath, an array listing directories, JAR files and
+    # artifacts.  Use when loading the extension to add any additional
+    # libraries used by that extension.
+    #
+    # For example, Ant is loaded as follows:
+    #   Java.classpath << 'org.apache.ant:ant:jar:1.7.0'
+    def classpath
+      @classpath ||= []
+    end
+
+    # Loads the JVM and all the libraries listed on the classpath.  Call this
+    # method before accessing any Java class, but only call it from methods
+    # used in the build, giving the Buildfile a chance to load all extensions
+    # that append to the classpath and specify which remote repositories to use.
+    def load
+      return self if @loaded
+      cp = Buildr.artifacts(classpath).map(&:to_s).each { |path| file(path).invoke }
+      #cp ||= java.lang.System.getProperty('java.class.path').split(':').compact
+      # Use system ClassLoader to add classpath.
+      sysloader = java.lang.ClassLoader.getSystemClassLoader
+      add_url_method = java.lang.Class.forName('java.net.URLClassLoader').
+        getDeclaredMethod('addURL', [java.net.URL].to_java(java.lang.Class))
+      add_url_method.setAccessible(true)
+      add_path = lambda { |path| add_url_method.invoke(sysloader, [java.io.File.new(path).toURI.toURL].to_java(java.net.URL)) }
+      # Include tools (compiler, Javadoc, etc) for all platforms except OS/X.
+      unless Config::CONFIG['host_os'] =~ /darwin/i
+        home = ENV['JAVA_HOME'] or fail 'Are we forgetting something? JAVA_HOME not set.'
+        tools = File.expand_path('lib/tools.jar', home)
+        raise "Missing #{tools}, perhaps your JAVA_HOME is not correclty set" unless File.file?(tools)
+        add_path[tools]
+      end
+      cp.each { |path| add_path[path] }
+      @loaded = true
+      self
+    end
+
+  end
+
+end

data/lib/buildr/java/org/apache/buildr/BuildrNail.java

@@ -0,0 +1,41 @@
+/* Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with this
+ * work for additional information regarding copyright ownership.  The ASF
+ * licenses this file to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+
+package org.apache.buildr;
+
+import com.martiansoftware.nailgun.NGContext;
+
+public interface BuildrNail {
+  
+  public void main(NGContext ctx);
+
+  public static class Main {
+     private static BuildrNail nail;
+     public static void  setNail(BuildrNail _nail) { nail = _nail; }
+     public static void nailMain(NGContext ctx) {
+       nail.main(ctx);
+     }
+  }
+
+}
+
+/* 
+ * Local Variables:
+ * indent-tabs-mode: nil
+ * c-basic-offset: 2
+ * End:
+ */

data/lib/buildr/java/org/apache/buildr/JavaTestFilter.java

@@ -0,0 +1,116 @@
+/* Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with this
+ * work for additional information regarding copyright ownership.  The ASF
+ * licenses this file to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+
+package org.apache.buildr;
+
+import java.lang.reflect.Method;
+import java.io.File;
+import java.io.IOException;
+import java.net.URL;
+import java.net.URLClassLoader;
+import java.net.MalformedURLException;
+import java.util.Iterator;
+import java.util.Vector;
+
+public class JavaTestFilter {
+
+  private ClassLoader _loader;
+  private Vector methodAnnotations = new Vector();
+  private Vector classAnnotations = new Vector();
+  private Vector interfaces = new Vector();
+
+  public JavaTestFilter(String[] paths) throws IOException {
+    URL[] urls = new URL[paths.length];
+    for (int i = 0 ; i < paths.length ; ++i) {
+      File file = new File(paths[i]).getCanonicalFile();
+      if (file.exists())
+        urls[i] = file.toURL();
+      else
+        throw new IOException("No file or directory with the name " + file);
+    }
+    _loader = new URLClassLoader(urls, getClass().getClassLoader());
+  }
+
+  public JavaTestFilter addInterfaces(String[] names) throws ClassNotFoundException {
+    for (int i = names.length; i -- > 0;) {
+      String name = names[i];
+      interfaces.add(_loader.loadClass(name));
+    }
+    return this;
+  }
+
+  public JavaTestFilter addClassAnnotations(String[] names) throws ClassNotFoundException {
+    for (int i = names.length; i -- > 0;) {
+      String name = names[i];
+      classAnnotations.add(_loader.loadClass(name));
+    }
+    return this;
+  }
+
+  public JavaTestFilter addMethodAnnotations(String[] names) throws ClassNotFoundException {
+    for (int i = names.length; i -- > 0;) {
+      String name = names[i];
+      methodAnnotations.add(_loader.loadClass(name));
+    }
+    return this;
+  }
+  
+  private boolean isTest(Class cls) {
+    if (interfaces != null) {
+      for (Iterator it = interfaces.iterator(); it.hasNext(); ) {
+        Class iface = (Class) it.next();
+        if (iface.isAssignableFrom(cls)) { return true; }
+      }
+    }
+    if (classAnnotations != null) { 
+      for (Iterator it = classAnnotations.iterator(); it.hasNext(); ) {
+        Class annotation = (Class) it.next();
+        if (cls.isAnnotationPresent(annotation)) { return true; }
+      }
+    } 
+    if (methodAnnotations != null) {
+      Method[] methods = cls.getMethods();
+      for (int j = methods.length ; j-- > 0 ;) {
+        for (Iterator it = methodAnnotations.iterator(); it.hasNext(); ) {
+          Class annotation = (Class) it.next();
+          if (methods[j].isAnnotationPresent(annotation)) { return true; }
+        }
+      }
+    }
+    return false;
+  }
+
+
+  public String[] filter(String[] names) throws ClassNotFoundException {
+    Vector testCases = new Vector();
+    for (int i = names.length ; i-- > 0 ;) {
+      Class cls = _loader.loadClass(names[i]);
+      if (isTest(cls)) { testCases.add(names[i]); }
+    }
+    String[] result = new String[testCases.size()];
+    testCases.toArray(result);
+    return result;
+  }
+
+}
+
+/* 
+ * Local Variables:
+ * indent-tabs-mode: nil
+ * c-basic-offset: 2
+ * End:
+ */

data/lib/buildr/java/packaging.rb

@@ -0,0 +1,706 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+require 'buildr/packaging'
+
+
+module Buildr
+  module Packaging
+
+    # Adds packaging for Java projects: JAR, WAR, AAR, EAR, Javadoc.
+    module Java
+
+      class Manifest
+
+        STANDARD_HEADER = "Manifest-Version: 1.0\nCreated-By: Buildr\n"
+        LINE_SEPARATOR = /\r\n|\n|\r[^\n]/ #:nodoc:
+        SECTION_SEPARATOR = /(#{LINE_SEPARATOR}){2}/ #:nodoc:
+
+        class << self
+
+          # :call_seq:
+          #   parse(str) => manifest
+          #
+          # Parse a string in MANIFEST.MF format and return a new Manifest.
+          def parse(str)
+            sections = str.split(SECTION_SEPARATOR).reject { |s| s.strip.empty? }
+            new sections.map { |section|
+              lines = section.split(LINE_SEPARATOR).inject([]) { |merged, line|
+                if line[0] == 32
+                  merged.last << line[1..-1]
+                else
+                  merged << line
+                end
+                merged
+              }
+              lines.map { |line| line.scan(/(.*?):\s*(.*)/).first }.
+                inject({}) { |map, (key, value)| map.merge(key=>value) }
+            }
+          end
+
+          # :call_seq:
+          #   from_zip(file) => manifest
+          #
+          # Parse the MANIFEST.MF entry of a ZIP (or JAR) file and return a new Manifest.
+          def from_zip(file)
+            Zip::ZipFile.open(file.to_s) do |zip|
+              return Manifest.new unless zip.get_entry('META-INF/MANIFEST.MF')
+              Manifest.parse zip.read('META-INF/MANIFEST.MF')
+            end
+          end
+
+          # :call_seq:
+          #   update_manifest(file) { |manifest| ... }
+          #
+          # Updates the MANIFEST.MF entry of a ZIP (or JAR) file.  Reads the MANIFEST.MF,
+          # yields to the block with the Manifest object, and writes the modified object
+          # back to the file.
+          def update_manifest(file)
+            manifest = from_zip(file)
+            result = yield manifest
+            Zip::ZipFile.open(file.to_s) do |zip|
+              zip.get_output_stream('META-INF/MANIFEST.MF') do |out|
+                out.write manifest.to_s
+                out.write "\n"
+              end
+            end
+            result
+          end
+
+        end
+
+        # Returns a new Manifest object based on the argument:
+        # * nil         -- Empty Manifest.
+        # * Hash        -- Manifest with main section using the hash name/value pairs.
+        # * Array       -- Manifest with one section from each entry (must be hashes).
+        # * String      -- Parse (see Manifest#parse).
+        # * Proc/Method -- New Manifest from result of calling proc/method.
+        def initialize(arg = nil)
+          case arg
+          when nil, Hash then @sections = [arg || {}]
+          when Array then @sections = arg
+          when String then @sections = Manifest.parse(arg).sections
+          when Proc, Method then @sections = Manifest.new(arg.call).sections
+          else
+            fail 'Invalid manifest, expecting Hash, Array, file name/task or proc/method.'
+          end
+        end
+
+        # The sections of this manifest.
+        attr_reader :sections
+
+        # The main (first) section of this manifest.
+        def main
+          sections.first
+        end
+
+        include Enumerable
+
+        # Iterate over each section and yield to block.
+        def each(&block)
+          @sections.each(&block)
+        end
+
+        # Convert to MANIFEST.MF format.
+        def to_s
+          @sections.map { |section|
+            keys = section.keys
+            keys.unshift('Name') if keys.delete('Name')
+            lines = keys.map { |key| manifest_wrap_at_72("#{key}: #{section[key]}") }
+            lines + ['']
+          }.flatten.join("\n")
+        end
+
+      private
+
+        def manifest_wrap_at_72(line)
+          return [line] if line.size < 72
+          [ line[0..70] ] + manifest_wrap_at_72(' ' + line[71..-1])
+        end
+
+      end
+
+
+      # Adds support for MANIFEST.MF and other META-INF files.
+      module WithManifest #:nodoc:
+
+        class << self
+          def included(base)
+            base.class_eval do
+              alias :initialize_without_manifest :initialize
+              alias :initialize :initialize_with_manifest
+            end
+          end
+
+        end
+
+        # Specifies how to create the manifest file.
+        attr_accessor :manifest
+
+        # Specifies files to include in the META-INF directory.
+        attr_accessor :meta_inf
+
+        def initialize_with_manifest(*args) #:nodoc:
+          initialize_without_manifest *args
+          @manifest = false
+          @meta_inf = []
+          @dependencies = FileList[]
+
+          prepare do
+            @prerequisites << manifest if String === manifest || Rake::Task === manifest
+            [meta_inf].flatten.map { |file| file.to_s }.uniq.each { |file| path('META-INF').include file }
+          end
+        
+          enhance do
+            if manifest
+              # Tempfiles gets deleted on garbage collection, so we're going to hold on to it
+              # through instance variable not closure variable.
+              Tempfile.open 'MANIFEST.MF' do |@manifest_tmp|
+                self.manifest = File.read(manifest.to_s) if String === manifest || Rake::Task === manifest
+                self.manifest = Manifest.new(manifest) unless Manifest === manifest
+                @manifest_tmp.write Manifest::STANDARD_HEADER
+                @manifest_tmp.write manifest.to_s
+                @manifest_tmp.write "\n"
+                path('META-INF').include @manifest_tmp.path, :as=>'MANIFEST.MF'
+              end
+            end
+          end
+        end
+
+      end
+
+      class ::Buildr::ZipTask
+        include WithManifest
+      end
+
+
+      # Extends the ZipTask to create a JAR file.
+      #
+      # This task supports two additional attributes: manifest and meta-inf.
+      #
+      # The manifest attribute specifies how to create the MANIFEST.MF file.
+      # * A hash of manifest properties (name/value pairs).
+      # * An array of hashes, one for each section of the manifest.
+      # * A string providing the name of an existing manifest file.
+      # * A file task can be used the same way.
+      # * Proc or method called to return the contents of the manifest file.
+      # * False to not generate a manifest file.
+      #
+      # The meta-inf attribute lists one or more files that should be copied into
+      # the META-INF directory.
+      #
+      # For example:
+      #   package(:jar).with(:manifest=>'src/MANIFEST.MF')
+      #   package(:jar).meta_inf << file('README')
+      class JarTask < ZipTask
+
+        def initialize(*args) #:nodoc:
+          super
+        end
+
+        # :call-seq:
+        #   with(options) => self
+        #
+        # Additional 
+        # Pass options to the task. Returns self. ZipTask itself does not support any options,
+        # but other tasks (e.g. JarTask, WarTask) do.
+        #
+        # For example:
+        #   package(:jar).with(:manifest=>'MANIFEST_MF')
+        def with(*args)
+          super args.pop if Hash === args.last
+          include :from=>args
+          self
+        end
+
+      end
+
+
+      # Extends the JarTask to create a WAR file.
+      #
+      # Supports all the same options as JarTask, in additon to these two options:
+      # * :libs -- An array of files, tasks, artifact specifications, etc that will be added
+      #   to the WEB-INF/lib directory.
+      # * :classes -- A directory containing class files for inclusion in the WEB-INF/classes
+      #   directory.
+      #
+      # For example:
+      #   package(:war).with(:libs=>'log4j:log4j:jar:1.1')
+      class WarTask < JarTask
+
+        # Directories with class files to include under WEB-INF/classes.
+        attr_accessor :classes
+
+        # Artifacts to include under WEB-INF/libs.
+        attr_accessor :libs
+
+        def initialize(*args) #:nodoc:
+          super
+          @classes = []
+          @libs = []
+          prepare do
+            @classes.to_a.flatten.each { |classes| path('WEB-INF/classes').include classes, :as=>'.' }
+            path('WEB-INF/lib').include Buildr.artifacts(@libs) unless @libs.nil? || @libs.empty?
+          end
+        end
+
+        def libs=(value) #:nodoc:
+          @libs = Buildr.artifacts(value)
+        end
+
+        def classes=(value) #:nodoc:
+          @classes = [value].flatten.map { |dir| file(dir.to_s) }
+        end
+  
+      end
+
+
+      # Extends the JarTask to create an AAR file (Axis2 service archive).
+      #
+      # Supports all the same options as JarTask, with the addition of :wsdls, :services_xml and :libs.
+      #
+      # * :wsdls -- WSDL files to include (under META-INF).  By default packaging will include all WSDL
+      #   files found under src/main/axis2.
+      # * :services_xml -- Location of services.xml file (included under META-INF).  By default packaging
+      #   takes this from src/main/axis2/services.xml.  Use a different path if you genereate the services.xml
+      #   file as part of the build.
+      # * :libs -- Array of files, tasks, artifact specifications, etc that will be added to the /lib directory.
+      #
+      # For example:
+      #   package(:aar).with(:libs=>'log4j:log4j:jar:1.1')
+      #
+      #   filter.from('src/main/axis2').into('target').include('services.xml', '*.wsdl').using('http_port'=>'8080')
+      #   package(:aar).wsdls.clear
+      #   package(:aar).with(:services_xml=>_('target/services.xml'), :wsdls=>_('target/*.wsdl'))
+      class AarTask < JarTask
+        # Artifacts to include under /lib.
+        attr_accessor :libs
+        # WSDLs to include under META-INF (defaults to all WSDLs under src/main/axis2).
+        attr_accessor :wsdls
+        # Location of services.xml file (defaults to src/main/axis2/services.xml).
+        attr_accessor :services_xml
+
+        def initialize(*args) #:nodoc:
+          super
+          @libs = []
+          @wsdls = []
+          prepare do
+            path('META-INF').include @wsdls
+            path('META-INF').include @services_xml, :as=>['services.xml'] if @services_xml
+            path('lib').include Buildr.artifacts(@libs) unless @libs.nil? || @libs.empty?
+          end
+        end
+
+        def libs=(value) #:nodoc:
+          @libs = Buildr.artifacts(value)
+        end
+
+        def wsdls=(value) #:nodoc:
+          @wsdls |= Array(value)
+        end
+      end
+
+
+      # Extend the JarTask to create an EAR file.
+      #
+      # The following component types are supported by the EARTask:
+      #
+      # * :war -- A J2EE Web Application
+      # * :ejb -- An Enterprise Java Bean
+      # * :jar -- A J2EE Application Client.[1]
+      # * :lib -- An ear scoped shared library[2] (for things like logging,
+      #           spring, etc) common to the ear components
+      #
+      # The EarTask uses the "Mechanism 2: Bundled Optional Classes" as described on [2].
+      # All specified libraries are added to the EAR archive and the Class-Path manifiest entry is
+      # modified for each EAR component. Special care is taken with WebApplications, as they can
+      # contain libraries on their WEB-INF/lib directory, libraries already included in a war file
+      # are not referenced by the Class-Path entry of the war in order to avoid class collisions
+      #
+      # EarTask supports all the same options as JarTask, in additon to these two options:
+      #
+      # * :display_name -- The displayname to for this ear on application.xml
+      #
+      # * :map -- A Hash used to map component type to paths within the EAR.
+      #     By default each component type is mapped to a directory with the same name,
+      #     for example, EJBs are stored in the /ejb path.  To customize:
+      #                       package(:ear).map[:war] = 'web-applications' 
+      #                       package(:ear).map[:lib] = nil # store shared libraries on root of archive
+      #
+      # EAR components are added by means of the EarTask#add, EarTask#<<, EarTask#push methods
+      # Component type is determined from the artifact's type. 
+      #
+      #      package(:ear) << project('coolWebService').package(:war)
+      #
+      # The << method is just an alias for push, with the later you can add multiple components
+      # at the same time. For example.. 
+      #
+      #      package(:ear).push 'org.springframework:spring:jar:2.6', 
+      #                                   projects('reflectUtils', 'springUtils'),
+      #                                   project('coolerWebService').package(:war)
+      #
+      # The add method takes a single component with an optional hash. You can use it to override
+      # some component attributes.
+      #
+      # You can override the component type for a particular artifact. The following example
+      # shows how you can tell the EarTask to treat a JAR file as an EJB:
+      #
+      #      # will add an ejb entry for the-cool-ejb-2.5.jar in application.xml
+      #      package(:ear).add 'org.coolguys:the-cool-ejb:jar:2.5', :type=>:ejb
+      #      # A better syntax for this is: 
+      #      package(:ear).add :ejb=>'org.coolguys:the-cool-ejb:jar:2.5'
+      #
+      # By default, every JAR package is assumed to be a library component, so you need to specify
+      # the type when including an EJB (:ejb) or Application Client JAR (:jar).
+      #
+      # For WebApplications (:war)s, you can customize the context-root that appears in application.xml.
+      # The following example also specifies a different directory inside the EAR where to store the webapp.
+      #
+      #      package(:ear).add project(:remoteService).package(:war), 
+      #                                 :path=>'web-services', :context_root=>'/Some/URL/Path'
+      #
+      # [1] http://java.sun.com/j2ee/sdk_1.2.1/techdocs/guides/ejb/html/Overview5.html#10106
+      # [2] http://java.sun.com/j2ee/verified/packaging.html
+      class EarTask < JarTask
+        
+        SUPPORTED_TYPES = [:war, :ejb, :jar, :rar, :lib]
+
+        # The display-name entry for application.xml
+        attr_accessor :display_name
+        # Map from component type to path inside the EAR.
+        attr_accessor :dirs
+
+        def initialize(*args)
+          super
+          @dirs = Hash.new { |h, k| k.to_s }
+          @libs, @components = [], []
+          prepare do
+            @components.each do |component|
+              path(component[:path]).include(component[:clone] || component[:artifact])
+            end
+            path('META-INF').include(descriptor)
+          end
+        end
+
+        # Add an artifact to this EAR.
+        def add(*args)
+          options = Hash === args.last ? args.pop.clone : {}
+          args.flatten!
+          args.map! do |pkg|
+            case pkg
+            when Project
+              pkg.packages.select { |pp| JarTask === pp && SUPPORTED_TYPES.include?(pp.type) }
+            when Rake::FileTask
+              pkg # add the explicitly provided file
+            when Hash
+              Buildr.artifact(pkg)
+            when String
+              begin
+                Buildr.artifact(pkg)
+              rescue # not an artifact spec, it must me a filename
+                file(pkg)
+              end
+            else 
+              raise "Invalid EAR component #{pkg.class}: #{pkg}"
+            end
+          end
+          args.flatten!
+          args.compact!
+          if args.empty?
+            raise ":type must not be specified for type=>component argument style" if options.key?(:type)
+            raise ":as must not be specified for type=>component argument style" if options.key?(:as)
+            comps = {}
+            options.delete_if { |k, v| comps[k] = v if SUPPORTED_TYPES.include?(k) }
+            raise "You must specify at least one valid component to add" if comps.empty?
+            comps.each { |k, v| add(v, {:as => k}.merge(options)) }
+          else
+            args.each do |artifact|
+              type = options[:as] || options[:type]
+              unless type
+                type = artifact.respond_to?(:type) ? artifact.type : artifact.to_s.pathmap('%x').to_sym
+                type = :lib if type == :jar
+              end
+              raise "Unknown EAR component type: #{type}. Perhaps you may explicity tell what component type to use." unless
+                SUPPORTED_TYPES.include?(type)
+              component = options.merge(:artifact => artifact, :type => type, 
+                :id=>artifact.respond_to?(:to_spec) ? artifact.id : artifact.to_s.pathmap('%n'),
+                :path=>options[:path] || dirs[type].to_s)
+              component[:clone] = component_clone(component) unless :lib == type
+              # update_classpath(component) unless :lib == type || Artifact === artifact
+              @components << component
+            end
+          end
+          self
+        end
+        
+        alias_method :push, :add
+        alias_method :<<, :push
+
+      protected
+
+        def component_clone(component)
+          file(path_to(component[:path], component[:artifact].to_s.pathmap('%f')) => component[:artifact]) do |task|
+            mkpath task.to_s.pathmap('%d'), :verbose => false
+            cp component[:artifact].to_s, task.to_s, :verbose => false
+            Manifest.update_manifest(task) do |manifest|
+              class_path = manifest.main['Class-Path'].to_s.split
+              included_libs = class_path.map { |fn| fn.pathmap('%f') }
+              Zip::ZipFile.foreach(task.to_s) do |entry|
+                included_libs << entry.name.pathmap('%f') if entry.file? && entry.name =~ /^WEB-INF\/lib\/[^\/]+$/
+              end
+              # Include all other libraries in the classpath.
+              class_path += libs_classpath(component).reject { |path| included_libs.include?(File.basename(path)) }
+              manifest.main['Class-Path'] = class_path.join(' ')
+            end
+          end
+        end
+
+        def associate(project)
+          @project = project
+        end
+
+        def path_to(*args) #:nodoc:
+          @project.path_to(:target, :ear, name.pathmap('%n'), *args)
+        end
+        alias_method :_, :path_to
+
+        def update_classpath(component)
+          package = file(component[:artifact].to_s)
+          package.manifest = (package.manifest || {}).dup # avoid mofifying parent projects manifest  
+          package.prepare do
+            header = case package.manifest
+              when Hash then package.manifest
+              when Array then package.manifest.first
+            end
+            if header
+              # Determine which libraries are already included.
+              class_path = header['Class-Path'].to_s.split
+              included_libs = class_path.map { |fn| File.basename(fn) }
+              included_libs += package.path('WEB-INF/lib').sources.map { |fn| File.basename(fn) }
+              # Include all other libraries in the classpath.
+              class_path += libs_classpath(component).reject { |path| included_libs.include?(File.basename(path)) }
+              header['Class-Path'] = class_path.join(' ')
+            end
+          end
+        end
+
+      private
+
+        # Classpath of all packages included as libraries (type :lib).
+        def libs_classpath(component)
+          from = component[:path]
+          @classpath = @components.select { |comp| comp[:type] == :lib }.
+            map do |lib| 
+            basename = lib[:artifact].to_s.pathmap('%f')
+            full_path = lib[:path].empty? ? basename : File.join(lib[:path], basename)
+            Util.relative_path(full_path, from)
+          end
+        end
+
+        def descriptor_xml
+          buffer = ""
+          xml = Builder::XmlMarkup.new(:target=>buffer, :indent => 2)
+          xml.declare! :DOCTYPE, :application, :PUBLIC, 
+          "-//Sun Microsystems, Inc.//DTD J2EE Application 1.2//EN",
+          "http://java.sun.com/j2ee/dtds/application_1_2.dtd"
+          xml.application do
+            xml.tag! 'display-name', display_name
+            @components.each do |comp|
+              basename = comp[:artifact].to_s.pathmap('%f')
+              uri = comp[:path].empty? ? basename : File.join(comp[:path], basename)
+              case comp[:type]
+              when :war
+                xml.module :id=>comp[:id] do
+                  xml.web do 
+                    xml.tag! 'web-uri', uri
+                    xml.tag! 'context-root', File.join('', (comp[:context_root] || comp[:id])) unless comp[:context_root] == false
+                  end
+                end
+              when :ejb
+                xml.module :id=>comp[:id] do
+                  xml.ejb uri
+                end
+              when :jar
+                xml.jar uri
+              end
+            end
+          end
+          buffer
+        end
+        
+        # return a FileTask to build the ear application.xml file
+        def descriptor
+          return @descriptor if @descriptor
+          descriptor_path = path_to('META-INF/application.xml')
+          @descriptor = file(descriptor_path) do |task|
+            puts "Creating EAR Descriptor: #{task.to_s}" if Buildr.application.options.trace
+            mkpath File.dirname(task.name), :verbose=>false
+            File.open(task.name, 'w') { |file| file.print task.xml }
+          end
+          class << @descriptor
+            attr_accessor :ear
+
+            def xml
+              @xml ||= ear.send :descriptor_xml
+            end
+            
+            def needed?
+              super || xml != File.read(self.to_s) rescue true
+            end
+          end
+          @descriptor.ear = self
+          @descriptor
+        end
+        
+      end
+
+
+      include Extension
+
+      before_define do |project|
+        ::Java.load
+        project.manifest ||= project.parent && project.parent.manifest ||
+          { 'Build-By'=>ENV['USER'], 'Build-Jdk'=>ENV_JAVA['java.version'],
+            'Implementation-Title'=>project.comment || project.name,
+            'Implementation-Version'=>project.version }
+        project.meta_inf ||= project.parent && project.parent.meta_inf ||
+          [project.file('LICENSE')].select { |file| File.exist?(file.to_s) }
+      end
+
+
+      # Manifest used for packaging. Inherited from parent project. The default value is a hash that includes
+      # the Build-By, Build-Jdk, Implementation-Title and Implementation-Version values.
+      # The later are taken from the project's comment (or name) and version number.
+      attr_accessor :manifest
+
+      # Files to always include in the package META-INF directory. The default value include
+      # the LICENSE file if one exists in the project's base directory.
+      attr_accessor :meta_inf
+
+      # :call-seq:
+      #   package_with_sources(options?)
+      #
+      # Call this when you want the project (and all its sub-projects) to create a source distribution.
+      # You can use the source distribution in an IDE when debugging.
+      #
+      # A source distribution is a ZIP package with the classifier 'sources', which includes all the
+      # sources used by the compile task.
+      #
+      # Packages use the project's manifest and meta_inf properties, which you can override by passing
+      # different values (e.g. false to exclude the manifest) in the options.
+      #
+      # To create source distributions only for specific projects, use the :only and :except options,
+      # for example:
+      #   package_with_sources :only=>['foo:bar', 'foo:baz']
+      #
+      # (Same as calling package :sources on each project/sub-project that has source directories.)
+      def package_with_sources(options = nil)
+        options ||= {}
+        enhance do
+          selected = options[:only] ? projects(options[:only]) :
+            options[:except] ? ([self] + projects - projects(options[:except])) :
+            [self] + projects
+          selected.reject { |project| project.compile.sources.empty? }.
+            each { |project| project.package(:sources) }
+        end
+      end
+
+      # :call-seq:
+      #   package_with_javadoc(options?)
+      #
+      # Call this when you want the project (and all its sub-projects) to create a JavaDoc distribution.
+      # You can use the JavaDoc distribution in an IDE when coding against the API.
+      #
+      # A JavaDoc distribution is a ZIP package with the classifier 'javadoc', which includes all the
+      # sources used by the compile task.
+      #
+      # Packages use the project's manifest and meta_inf properties, which you can override by passing
+      # different values (e.g. false to exclude the manifest) in the options.
+      #
+      # To create JavaDoc distributions only for specific projects, use the :only and :except options,
+      # for example:
+      #   package_with_javadoc :only=>['foo:bar', 'foo:baz']
+      #
+      # (Same as calling package :javadoc on each project/sub-project that has source directories.)
+      def package_with_javadoc(options = nil)
+        options ||= {}
+        enhance do
+          selected = options[:only] ? projects(options[:only]) :
+            options[:except] ? ([self] + projects - projects(options[:except])) :
+            [self] + projects
+          selected.reject { |project| project.compile.sources.empty? }.
+            each { |project| project.package(:javadoc) }
+        end
+      end
+
+    protected
+
+      def package_as_jar(file_name) #:nodoc:
+        Java::JarTask.define_task(file_name).tap do |jar|
+          jar.with :manifest=>manifest, :meta_inf=>meta_inf
+          jar.with [compile.target, resources.target].compact
+        end
+      end
+
+      def package_as_war(file_name) #:nodoc:
+        Java::WarTask.define_task(file_name).tap do |war|
+          war.with :manifest=>manifest, :meta_inf=>meta_inf
+          # Add libraries in WEB-INF lib, and classes in WEB-INF classes
+          war.with :classes=>[compile.target, resources.target].compact
+          war.with :libs=>compile.dependencies
+          # Add included files, or the webapp directory.
+          webapp = path_to(:source, :main, :webapp)
+          war.with webapp if File.exist?(webapp)
+        end
+      end
+
+      def package_as_aar(file_name) #:nodoc:
+        Java::AarTask.define_task(file_name).tap do |aar|
+          aar.with :manifest=>manifest, :meta_inf=>meta_inf
+          aar.with :wsdls=>path_to(:source, :main, :axis2, '*.wsdl')
+          aar.with :services_xml=>path_to(:source, :main, :axis2, 'services.xml') 
+          aar.with [compile.target, resources.target].compact
+          aar.with :libs=>compile.dependencies
+        end
+      end
+
+      def package_as_ear(file_name) #:nodoc:
+        Java::EarTask.define_task(file_name).tap do |ear|
+          ear.send :associate, self
+          ear.with :display_name=>id, :manifest=>manifest, :meta_inf=>meta_inf
+        end
+      end
+
+      def package_as_javadoc_spec(spec) #:nodoc:
+        spec.merge(:type=>:zip, :classifier=>'javadoc')
+      end
+
+      def package_as_javadoc(file_name) #:nodoc:
+        ZipTask.define_task(file_name).tap do |zip|
+          zip.include :from=>javadoc.target
+          javadoc.options[:windowtitle] ||= project.comment || project.name
+        end
+      end
+
+    end
+
+  end
+end
+
+
+class Buildr::Project
+  include Buildr::Packaging::Java
+end