aiwilliams-plugit 0.0.1

data/README.txt

@@ -0,0 +1,64 @@
+= plugit
+
+* http://github.com/aiwilliams/plugit
+
+== DESCRIPTION:
+
+Having written a number of libraries, I have found that many of them depend on other libraries.
+Often, those other libraries have multiple revisions and the people who use my libraries want
+my libraries to work with all revisions of those other libraries. This can get hard to manage!
+
+The goal of plugit is to make it easy to construct library environments within which you can
+run tests, to show that your code works in more than just one environment. It also allows you
+to keep from having copies of those libraries checked into your own repository. If they are
+available for others to download, and you expect that they will, then you should have no problem
+depending on them being available to you for future download, either!
+
+This may all only prove useful to Rails plugin developers ;)
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+Plugit.describe do |mything|
+  mything.environment :default, 'The one we want everyone using' do |env|
+    env.library :example, '1.0', "cp -R #{File.dirname(__FILE__)}/../../../repositories/example/*"
+    env.library :another, '2.0', "svn co http://something.com/svn/ALibrary"
+  end
+end
+
+The :default environment is loaded unless you specify otherwise through ENV['PLUGIT_ENV']. This is necessary since you will be
+running your specs from Rakefile, which will load independent processes for each environment you want to run.
+
+== REQUIREMENTS:
+
+== INSTALL:
+
+sudo gem install plugit --source=http://gems.github.com
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Adam Williams (aiwilliams)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/plugit/descriptor.rb

@@ -0,0 +1,33 @@
+module Plugit
+  class Descriptor
+    attr_writer :library_root_path
+    
+    def initialize
+      @environments = []
+    end
+    
+    def environment(*init_args, &block)
+      @environments << (env = Environment.new(*init_args))
+      block.call(EnvironmentBuilder.new(env))
+    end
+    
+    def install_environment(name)
+      Environment.library_root_path = @library_root_path || File.expand_path('environments')
+      env = @environments.detect {|e| e.name == name.to_sym}
+      env.libraries.each do |lib|
+        lib.update(env)
+        lib.install(env)
+      end
+    end
+  end
+  
+  class EnvironmentBuilder
+    def initialize(env)
+      @env = env
+    end
+    
+    def library(*init_args)
+      @env.add_library(Library.new(*init_args))
+    end
+  end
+end

data/lib/plugit/environment.rb

@@ -0,0 +1,30 @@
+module Plugit
+  class Environment
+    class UninitializedRootError < StandardError; end
+    
+    class << self
+      attr_accessor :library_root_path
+    end
+    
+    attr_reader :name, :description
+    
+    def initialize(name, description)
+      @name, @description = name, description
+      @libraries = []
+    end
+    
+    def add_library(library)
+      @libraries << library
+    end
+    
+    def libraries
+      @libraries.dup
+    end
+    
+    def library_root_path
+      root_path = self.class.library_root_path
+      raise UninitializedRootError unless root_path
+      File.join(root_path, name.to_s)
+    end
+  end
+end

data/lib/plugit/library.rb

@@ -0,0 +1,49 @@
+require 'fileutils'
+
+module Plugit
+  class Library
+    include FileUtils
+    
+    attr_accessor :load_paths, :requires
+    attr_reader   :name, :version, :scm_export_command
+    
+    def initialize(name, version, scm_export_command)
+      @name, @version, @scm_export_command = name, version, scm_export_command
+      @load_paths = ['/lib']
+      @requires = []
+      yield self if block_given?
+    end
+    
+    def after_update(&block)
+      @after_update = block
+    end
+    
+    def checkout(target_path)
+      command = "#{scm_export_command} #{target_path}"
+      puts "Checking out #{name}: #{command}"
+      `#{command}`
+    end
+    
+    def install(environment)
+      load_paths.each { |l| $LOAD_PATH << File.join(target_path(environment), l) }
+      Object.send :require, *requires unless requires.empty?
+    end
+    
+    def update(environment, force = false)
+      target_path = self.target_path(environment)
+      mkdir_p(File.dirname(target_path))
+      if !File.directory?(target_path) || force
+        rm_rf(target_path)
+        checkout(target_path)
+        cd(target_path) do
+          instance_eval(&@after_update)
+        end if @after_update
+      end
+    end
+    
+    protected
+      def target_path(environment)
+        File.join(environment.library_root_path, name.to_s, version)
+      end
+  end
+end

data/lib/plugit/version.rb

@@ -0,0 +1,9 @@
+module Plugit #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/plugit.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/plugit/library'
+require File.dirname(__FILE__) + '/plugit/environment'
+require File.dirname(__FILE__) + '/plugit/descriptor'
+
+module Plugit
+  def self.describe(&block)
+    descriptor = Descriptor.new
+    block.call(descriptor)
+    descriptor.install_environment(ENV['PLUGIT_ENV'] || :default)
+  end
+end

data/plugit.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |s|
+  s.name = "plugit"
+  s.version = "0.0.1"
+  s.date = "2008-05-19"
+  s.summary = "Helping you write tests for code that depends on libraries"
+  s.email = "adam@thewilliams.ws"
+  s.homepage = "http://github.com/aiwilliams/plugit"
+  s.description = ""
+  s.has_rdoc = false
+  s.authors = ["Adam Williams"]
+  s.files = ["README.txt", "plugit.gemspec", "lib/plugit.rb", "lib/plugit/descriptor.rb", "lib/plugit/environment.rb", "lib/plugit/library.rb", "lib/plugit/version.rb"]
+  s.test_files = []
+  s.rdoc_options = ["--main", "README.txt"]
+  s.extra_rdoc_files = ["README.txt"]
+  # s.add_dependency("mime-types", ["> 0.0.0"])
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: aiwilliams-plugit
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Adam Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-19 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: ""
+email: adam@thewilliams.ws
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- README.txt
+- plugit.gemspec
+- lib/plugit.rb
+- lib/plugit/descriptor.rb
+- lib/plugit/environment.rb
+- lib/plugit/library.rb
+- lib/plugit/version.rb
+has_rdoc: false
+homepage: http://github.com/aiwilliams/plugit
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Helping you write tests for code that depends on libraries
+test_files: []
+