raven 1.0

data/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

data/README.rdoc

@@ -0,0 +1,68 @@
+# = Raven -- Build Java with Rake and Gem
+# 
+# Raven is a build tool for Java programs based on Rake and Ruby Gems
+# (and a bit of Maven but only for the good part). 
+# 
+# First it wraps jar  files in a Ruby Gem. You can then start manage your 
+# java jar library  just like a Gem library. Tools are provided to convert 
+# a Maven jar repository to a Gem repository (both local on your machine 
+# or on a public server). This allows users to both start quickly working 
+# with Raven if they were using Maven, but also to produce easily very 
+# complete Gem central repositories with a lot of jars.
+# 
+# Second, you declare your dependencies in a Rakefile. You basically say 
+# which gems you need (and so which jars will be included in your classpath) 
+# for building. When building, if some Gems are missing, they are automatically 
+# installed in your local Gem repository. Just like Maven.
+# 
+# Third, Raven gives you a small library of Rake tasks that you can use to 
+# compile your java classes, build a jar file, build a war file, produce javadoc, 
+# wrap the jar you built in a Gem, ...
+# 
+# This effectively gives you everything you need to build Java 
+# projects, using Gems for dependencies management and Rake for scripts.
+# 
+# Example of Rakefile using Raven:
+# 
+# -------------------------------------------------------------
+# require 'raven'
+# require 'rake/clean'
+# 
+# set_sources(["http://localhost:2233"])
+# 
+# CLEAN.include('target')
+# 
+# dependency 'compile_deps' do |t| 
+#     t.deps << [{'commons-logging' => '1.1'}, 'commons-pool']
+#     t.deps << ['commons-lang', 'wsdl4j', 'log4j']
+# end
+# 
+# javac 'compile' => 'compile_deps' do |t|
+#     t.build_path << "src/main/java"
+# end
+# 
+# jar 'ode-utils.jar' => 'compile'
+# 
+# jar_source 'ode-utils-source.jar' => 'compile'
+# 
+# lib_dir 'build_lib' => 'compile_deps' do |t|
+#     t.target = 'dist/lib'
+# end
+# 
+# war 'utils.war' => ['compile', 'compile_deps'] do |t|
+#     t.webapp_dir = 'src/test'
+# end
+# 
+# javadoc 'jdoc' => 'deps'
+# 
+# gem_wrap_inst 'gem' => 'ode-utils.jar' do |t|
+#     t.version = '1.0'
+#     t.group = 'ode'
+# end
+# -------------------------------------------------------------
+# 
+# See Raven::DependencyTask, Raven::JavacTask, Raven::JarTask, 
+# Raven::JarSourceTask, Raven::WarTask, Raven::LibDirTask, 
+# Raven::JavaDocTask, Raven::GemWrapTask and Raven::GemInstallTask 
+# for more information.
+

data/bin/raven

@@ -0,0 +1,5 @@
+!#/usr/bin/env ruby
+require 'rubygems'
+require 'raven'
+
+Raven::Command.run(ARGV)

data/lib/raven.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+#  Copyright 2006 Matthieu Riou
+#
+#  Licensed 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.
+
+# $:.unshift File.dirname(__FILE__)
+
+require 'raven/gem_init'
+require 'raven/deps_tasks'
+require 'raven/repo_builder'
+require 'raven/java_tasks'
+require 'raven/index_gem_repository'
+
+require 'optparse'
+
+module Raven
+  module Command
+    def self.run(args)
+      opts = OptionParser.new
+      opts.banner = "Usage: raven [options] (import | repository * | server)"
+      repo_url = ''
+      opts.on('-m=ARG', '--mavenrepo repo_url') { |val| puts'x';repo_url = val }
+      
+      rest = opts.parse(*args)
+      
+      ARGV.pop while ARGV.length > 0      
+      if (rest[0] == 'import')
+        Raven::MavenLocalRepoImport.run() 
+      else
+        if (rest[0] == 'repository')
+          if (repo_url.length > 0)
+            puts 'repodef'
+            match = repo_url.match('http://([^/]*)(/.*)')
+            server = match[1]
+            rel_url = match[2]
+            rel_url = rel_url + '/' if rel_url[-1..-1] != '/'
+          else
+            server = 'www.ibiblio.org'
+            rel_url = '/maven2/'
+          end
+          
+          puts "Using server #{server} and url #{rel_url}"
+          builder = Raven::GemRepoBuilder.new(server, rel_url)
+          if (rest.size > 1)
+            rest.shift
+            puts "Packages #{rest}"
+            builder.group_filters = rest
+          end
+          builder.build
+          main_index(ARGV)
+        else
+          if (rest[0] == 'server')
+            require 'webrick'
+            include WEBrick
+            s = HTTPServer.new(
+                 :Port         => 2233,
+                 :DocumentRoot => Dir.pwd )
+            trap("INT") { s.shutdown }
+            s.start            
+          else
+            puts opts.to_s
+          end
+        end
+      end      
+    end
+  end
+end

data/lib/raven/deps_tasks.rb

@@ -0,0 +1,153 @@
+#!/usr/bin/env ruby
+
+#  Copyright 2006 Matthieu Riou
+#
+#  Licensed 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 'rubygems'
+require 'rake'
+require 'set'
+require 'fileutils'
+
+module Raven
+
+  class GemNotFoundException < RuntimeError; end
+  class AmbiguousGemException < RuntimeError; end
+  
+  # Task used to declare a set of dependencies your project relies
+  # upon. As many dependency tasks as necessary can be declared
+  # (each grouping as many dependency as you like). For each declared
+  # dependency, a Gem is searched in your local repository and then if
+  # it can't be found, in the specified remote repositories (by setting
+  # <em>sources</em>). Gems are searched by name ENDING with the name
+  # you provided.
+  # 
+  # As an example, specifying 'wsdl4j' will correctly find the Gem
+  # named wsdl4j-wsdl4j but specifying 'axis2' WILL NOT give you all
+  # axis2 Gems. Actually only one Gem can be selected by each of the
+  # specified Gem, otherwise you'll see an error asking you to be more
+  # specific.
+  # 
+  # Once the correct Gem has been found, if it's not local it will be
+  # automatically be downloaded and installed.
+  # 
+  # If no version is provided, and the Gem isn't present locally, the 
+  # latest version will be fetched. If a local version can be found 
+  # locally, this version will be used without any download.
+  # 
+  # Example of dependency specification:
+  # 
+  # dependency 'deps' do |t| 
+  #   t.deps << [{'commons-logging' => '1.1'}, 'commons-pool']
+  #   t.deps << ['commons-lang', 'wsdl4j', 'log4j']
+  # end
+  # 
+  # See also Raven::MavenLocalRepoImport and Raven::GemRepoBuilder to 
+  # learn more about how to build a Gem repository to get started.
+  class DependencyTask < Rake::Task
+    attr_reader :gem_deps
+  
+    # Check dependencies and installs them sometimes.
+    def execute
+      super
+      ambiguous, notfound = [], []
+      # Installing missing Gems (if there are)
+      @gem_deps = @deps.flatten.collect do |dep|
+        # Wrapping in an array, we might not have an array with version
+        # as dependency.
+        deparr = dep.respond_to?(:to_a) ? dep.to_a.flatten : [dep]
+        begin
+          Raven::GemInstaller.install_or_not(*deparr)
+        rescue GemNotFoundException => gnfe
+          notfound << gnfe.message
+        rescue AmbiguousGemException => age
+          ambiguous << age
+        end
+      end
+      unless notfound.empty? && ambiguous.empty?
+        raise(RuntimeError, notfound.join($/) + $/ + ambiguous.join($/))
+      end
+    end
+    
+    def deps
+      @deps ||= []
+    end
+  end
+    
+  # Calls Gem installer to install a Gem (very predictible behaviour).
+  # Well, but if the Gem is already there, it won't be installed. This 
+  # guy's a smart one.
+  module GemInstaller
+  
+    # Possibly installs a Gem... or not. If it's already present installation
+    # will just be skipped. The path to the gem root is always returned though.
+    # The provided gem name is first looked up with a query in the repositories
+    # to support partial names (i.e only artifactId).
+    def self.install_or_not(gemname, version='*')
+      # TODO Add support for regular expressions for gem name, allows multiple 
+      # selected gems
+      hems = resolve(gemname, version)
+      gem_spec = hems[0]
+      # TODO Handle Gem dependencies
+      unless hems[1]
+        installer = Gem::RemoteInstaller.new
+        params = [gem_spec.name, gem_spec.version.to_s, false]
+        params << USER_HOME + '/.raven_gems' if defined?(GEMS_IN_HOME)
+        gem_spec = installer.install(*params)[0]
+      end
+      gem_spec.full_gem_path
+    end
+    
+    # Resolves a Gem partial name (like only the artifactId) to a full name 
+    # and eventually checks its versions. Returns an array with the found Gem
+    # in the first position and a boolean indicating whether the array has
+    # been found locally or not in second position.
+    def self.resolve(gemname, version)
+      # Search local occurences first, it's faster. Moreover we'll only
+      # return local versions, avoiding a constant download of latest versions
+      # when nothing specific is provided.
+      gems = Gem::cache.search(/.*#{gemname}$/)
+      local = select_gem(gemname, version, gems, true)
+      puts "Using local gem #{local[0].name} (#{local[0].version}) to satisfy dependency #{gemname}" if RakeFileUtils.verbose_flag && local
+      return local if local
+      gems = Gem::RemoteInstaller.new().search(/.*#{gemname}$/)
+      remote = select_gem(gemname, version, gems.flatten, false)
+      puts "Downloading remote gem #{remote[0].name} (#{remote[0].version}) to satisfy dependency #{gemname}" if RakeFileUtils.verbose_flag && remote
+      return remote if remote
+      
+      # Nothing found: Houston, we have a problem
+      raise(GemNotFoundException, "Couldn't find any Gem from name #{gemname} and version #{version}") unless remote
+    end
+    
+    private
+    
+    def self.select_gem(gemname, version, gems, local)
+      # We can only have different versions of the same Gem, different Gems 
+      # is a problem.      
+      if gems.collect{|gem| gem.name}.uniq.size > 1
+        raise(AmbiguousGemException, "Several different Gems can be found from name #{gemname} (#{gems.collect{|gem| gem.name}.uniq.join(' ')}), please be more specific.") 
+      end
+      version_gems = Hash[*gems.collect{ |gem| [gem.version.to_s, gem] }.flatten]
+      # Latest one will do when no version has been given.
+      return [version_gems.sort.reverse[0][1], local] if (version == '*' && !version_gems.empty?)
+      return [version_gems[version], local] if (version_gems[version] && !version_gems.empty?)
+      nil
+    end
+  end
+  
+end
+
+# Shortcut to the dependency task creation.
+def dependency(args, &block)
+  Raven::DependencyTask.define_task(args, &block)
+end