rjack-tarpit 2.0.0-java

data/lib/rjack-tarpit/spec.rb

@@ -0,0 +1,314 @@
+#--
+# Copyright (c) 2009-2012 David Kellum
+#
+# 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 'rjack-tarpit/base'
+require 'rjack-tarpit/util'
+require 'rjack-tarpit/readme_parser'
+
+require 'fileutils'
+
+module RJack::TarPit
+
+  class << self
+
+    # The result of the last call to specify.
+    attr_reader :last_spec
+
+    # Produce a Gem::Specification embellished with SpecHelper,
+    # ReadmeParser, and yield to block.
+    # The specification name defaults to <name>.gemspec calling this.
+    # Within block, $LOAD_PATH will have the projects lib included.
+    def specify( &block )
+
+      # Embellish a Specification instance with SpecHelper.
+      #
+      # This way spec.to_yaml continues to be a Gem::Specification
+      # object. Deriving our own Specification subclass would cause
+      # problems with to_yaml.
+      spec = Gem::Specification.new
+      class << spec
+        include SpecHelper
+        include ReadmeParser
+      end
+
+      specfile = caller[0] =~ /^(.*\.gemspec)/ && $1
+
+      # Default name to the (name).gemspec that should be calling us
+      spec.name = File.basename( specfile, ".gemspec" )
+
+      # Add project's lib/ to LOAD_PATH for block...
+      $LOAD_PATH.unshift( File.join( File.dirname( specfile ), 'lib' ) )
+
+      spec.tarpit_specify &block
+
+      $LOAD_PATH.shift # ...then remove it to avoid pollution
+
+      @last_spec = spec
+    end
+  end
+
+  # Helper mixin for Gem::Specification, adding Manifest awareness,
+  # maven strategy, jars and other generated_files declarations, as
+  # well as several convenience methods and defaults. Many of these were
+  # Hoe inspired or remain compatible with Hoe.spec
+  module SpecHelper
+
+    # The filename for the project README
+    # (default: README.rdoc or README.txt if present)
+    attr_accessor :readme_file
+
+    # The filename for the project History
+    # (default: History.rdoc or History.txt if present)
+    attr_accessor :history_file
+
+    # The set of jar file names (without path) to include. May be
+    # auto-computed for :no_assembly (default_jar) or
+    # :jars_from_assembly (from Manifest.txt) maven_strategy.
+    attr_writer :jars
+
+    # Destination path for any jar links
+    # (default: lib/<name>)
+    attr_accessor :jar_dest
+
+    # Any additional generated files to be included.
+    # (default: nil)
+    attr_accessor :generated_files
+
+    # Strategy for interacting with maven
+    # (default: nil, none )
+    # :jars_from_assembly:: jars will be found in assembly rather then
+    #                       set in Rakefile.
+    # :no_assembly:: One jar created from source, jars=[default_jar],
+    #                no assembly setup in maven.
+    attr_accessor :maven_strategy
+
+    # The name of the assembly (default: name)
+    attr_accessor :assembly_name
+
+    # The version of the assembly, which might be static, i.e. "1.0",
+    # if the pom is not shared (dependency jars only)
+    # (default: version)
+    attr_accessor :assembly_version
+
+    # The canonical file containing the version number, where changes
+    # should trigger Manifest.txt (re-)generation.
+    # (default: lib/<name>/base.rb or lib/<name>/version.rb if present)
+    attr_accessor :version_file
+
+    # Set defaults, yields self to block, and finalizes
+    def tarpit_specify
+
+      # Better defaults
+      if File.exist?( 'Manifest.txt' )
+        self.files = Util::read_file_list( 'Manifest.txt' )
+      end
+
+      self.executables =
+        self.files.grep( /^bin\/.+/ ) { |f| File.basename( f ) }
+
+      @readme_file  = existing( %w[ README.rdoc README.txt ] )
+      @history_file = existing( %w[ History.rdoc History.txt ] )
+
+      self.extra_rdoc_files += [ Dir[ '*.rdoc' ],
+                                 @readme_file,
+                                 @history_file ].flatten.compact.sort.uniq
+
+      self.rdoc_options += [ '--main', @readme_file ] if @readme_file
+
+      @jars            = nil
+      @jar_dest        = nil
+      @generated_files = nil
+      @maven_strategy  = nil
+
+      parse_readme( @readme_file ) if @readme_file
+
+      yield self if block_given?
+
+      @assembly_name ||= name
+      @assembly_version ||= version
+
+      version_candidates = %w[ base version ].map do |f|
+        File.join( 'lib', name, "#{f}.rb" )
+      end
+      @version_file ||= existing( version_candidates )
+
+      @jar_dest ||= File.join( 'lib', name )
+
+      @jars = Array( @jars ).compact
+      @jars = nil if @jars.empty?
+
+      if ( @jars.nil? &&
+           ( ( @maven_strategy == :no_assembly ) ||
+             ( @maven_strategy.nil? && File.exist?( 'pom.xml' ) ) ) )
+        @jars = [ default_jar ]
+      end
+
+      # The platform must be java if jars are specified.
+      self.platform = :java if !jars.empty?
+
+      # Add tarpit as dev dependency unless already present
+      unless ( name == 'rjack-tarpit' ||
+               dependencies.find { |d| d.name == 'rjack-tarpit' } )
+        depend( 'rjack-tarpit', "~> #{ RJack::TarPit::MINOR_VERSION }", :dev )
+      end
+
+      check_generate_manifest
+
+    end
+
+    # Add developer with optional email.
+    def add_developer( author, email = nil )
+      ( self.authors ||= [] ) << author
+      ( self.email   ||= [] ) << email if email
+    end
+
+    # Add a dependencies by name, version requirements, and a final
+    # optional :dev or :development symbol indicating its for
+    # development.
+    def depend( name, *args )
+      if args.last == :dev || args.last == :development
+        args.pop
+        add_development_dependency( name, *args )
+      else
+        add_dependency( name, *args )
+      end
+    end
+
+    # Set summary. This override cleans up whitespace.
+    def summary=( val )
+      super( val.gsub( /\s+/, ' ' ).strip )
+    end
+
+    # Set summary. This override cleans up whitespace.
+    def description=( val )
+      super( val.gsub( /\s+/, ' ' ).strip )
+    end
+
+    # Override Gem::Specification to support simple platform
+    # symbol/string, i.e. :java
+    def platform=( val )
+      if val.is_a?( Symbol ) || val.is_a?( String )
+        val = Gem::Platform.new( val.to_s )
+      end
+      super( val )
+    end
+
+    # Return set or defaulted jar file names (without path)
+    def jars
+      if @jars.nil? && ( maven_strategy == :jars_from_assembly )
+
+        # Extract jar files from saved Manifest state, since neither
+        # from or dest jars may be available at call time.
+        @jars =
+          Util::read_file_list( 'Manifest.txt' ).
+          select { |f| f =~ /\.jar$/ }.
+          map    { |f| File.basename( f ) }
+
+        #FIXME: Test Manifest.txt exists yet?
+      end
+      @jars ||= Array( @jars )
+    end
+
+    def check_generate_manifest
+      # FIXME: How about diffent aproach: Always build new manifest
+      # list, compare, and report and write if change from read in
+      # list?
+
+      unless @generated_manifest
+        if File.exist?( 'Manifest.static' )
+          mtime = [ 'Manifest.static', version_file ].
+            compact.
+            map { |f| File.stat( f ).mtime }.
+            max
+
+          if ( !File.exist?( 'Manifest.txt' ) ||
+               mtime > File.stat( 'Manifest.txt' ).mtime )
+            generate_manifest
+            self.files = Util::read_file_list( 'Manifest.txt' )
+          end
+        end
+      end
+    end
+
+    # Generate Manifest.txt
+    def generate_manifest
+      unless @generated_manifest #only once
+        remove_dest_jars
+
+        m = []
+        if File.exist?( 'Manifest.static' )
+          m += Util::read_file_list( 'Manifest.static' )
+        end
+        m += Util::clean_list( generated_files ).sort
+        m += dest_jars
+
+        puts "TARPIT: Regenerating #{ File.expand_path( 'Manifest.txt' ) }"
+        open( 'Manifest.txt', 'w' ) { |out| out.puts m }
+        @generated_manifest = true
+      else
+        puts "already generated"
+      end
+    end
+
+    # Remove jars in jar_dest by wildcard expression
+    def remove_dest_jars
+      jars = Dir[ File.join( jar_dest, "*.jar" ) ].sort
+      FileUtils::rm_f jars unless jars.empty?
+    end
+
+    # The target/assembly path from which jars are linked
+    def jar_from
+      dirs = [ 'target' ]
+
+      unless maven_strategy == :no_assembly
+        dirs << [ assembly_name,
+                  assembly_version,
+                  'bin.dir' ].join( '-' )
+      end
+
+      File.join( dirs )
+    end
+
+    private
+
+    # The list of jars in jar_dest path, used during manifest generation
+    def dest_jars
+      if maven_strategy == :jars_from_assembly
+
+        # For manifest, map destination jars from available jars in
+        # (jar_from) target/assembly. These are available since mvn
+        # package will be run first for the :manifest target.
+        Dir[ File.join( jar_from, "*.jar" ) ].
+          map { |j| File.basename( j ) }.
+          sort.
+          map { |j| File.join( jar_dest, j ) }
+      else
+        Util::clean_list( jars ).
+          sort.
+          map { |j| File.join( jar_dest, j ) }
+      end
+    end
+
+    def existing( files )
+      files.find { |f| File.exist?( f ) }
+    end
+
+    # Return a default jar name built from name and version
+    def default_jar
+      "#{name}-#{version}.jar"
+    end
+  end
+end

data/lib/rjack-tarpit/test.rb

@@ -0,0 +1,110 @@
+#--
+# Copyright (c) 2009-2012 David Kellum
+#
+# 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.
+#++
+
+module RJack::TarPit
+
+  module TestTaskDefiner
+
+    # Proc for setting Rake TestTask options
+    # (default: nil, no-op)
+    attr_accessor :test_task_config
+
+    # Support same options as Rake::TestTask, plus tarpit's own
+    # :mini_in_proc (default) option, which loads minitest tests and
+    # runs in (rake) process.
+    attr_accessor :test_loader
+
+    # Proc for setting RSpec::Core::RakeTask options
+    # (default: nil, no-op)
+    attr_accessor :rspec_task_config
+
+    def initialize
+      super
+
+      @test_loader       = :mini_in_proc
+      @test_task_config  = nil
+      @rspec_task_config = nil
+
+      add_define_hook( :define_test_tasks )
+      add_define_hook( :define_spec_tasks )
+    end
+
+    def define_spec_tasks
+
+      if File.directory?( "spec" ) || rspec_task_config
+        require 'rspec/core/rake_task'
+
+        desc "Run RSpec on specifications"
+        RSpec::Core::RakeTask.new( :spec ) do |t|
+          t.rspec_opts ||= []
+          t.rspec_opts += %w[ -Ispec:lib ]
+          rspec_task_config.call( t ) if rspec_task_config
+        end
+
+        desc "Run RSpec on specifications"
+        task :test => [ :spec ]
+
+        task :default => [ :test ]
+      end
+
+    end
+
+    def define_test_tasks
+
+      if test_loader == :mini_in_proc
+
+        tfiles = FileList[ "test/test*.rb" ]
+        if !tfiles.empty?
+
+          desc "Run minitest tests (in rake process)"
+          task :test do |t,args|
+            require 'minitest/unit'
+
+            MiniTest::Unit.class_eval do
+              def self.autorun # :nodoc:
+                # disable autorun, as we are running ourselves
+              end
+            end
+
+            tfiles.each { |f| load f }
+
+            code = MiniTest::Unit.new.run( ( ENV['TESTOPTS'] || '' ).split )
+            fail "test failed (#{code})" if code && code > 0
+            puts
+          end
+
+        else
+          desc "No-op"
+          task :test
+        end
+
+      else
+
+        require 'rake/testtask'
+
+        Rake::TestTask.new do |t|
+          t.loader = test_loader
+          test_task_config.call( t ) if test_task_config
+        end
+
+      end
+
+      task :default => [ :test ]
+    end
+
+  end
+
+end

data/lib/rjack-tarpit/util.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2009-2012 David Kellum
+#
+# 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.
+#++
+
+module RJack::TarPit
+  module Util
+
+    module_function
+
+    # Read a list of files and return a cleaned list.
+    def read_file_list( sfile )
+      clean_list( open( sfile ) { |f| f.readlines } )
+    end
+
+    # Cleanup a list of files
+    def clean_list( l )
+      Array( l ).
+        compact.
+        map { |f| f.strip }.
+        reject { |f| f.empty? }
+    end
+
+  end
+
+end