evoker 0.0.1

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2010, Maciej Pasternacki <maciej@pasternacki.net>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the copyright holder nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL MACIEJ PASTERNACKI BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/lib/evoker.rb

@@ -0,0 +1,143 @@
+# @author Maciej Pasternacki <maciej@pasternacki.net>
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) ||
+  $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'date'
+
+require 'rake'
+require 'rake/clean'
+
+require 'evoker/version'
+
+# Evoker is a tool to manage external dependencies of a project using
+# Rake to run downloads.
+module Evoker
+  # {Rake::FileList} of defined entities
+  # @example can be used as dependency for the default target
+  #   task :default => Evoker::ENTITIES
+  ENTITIES = Rake::FileList[]
+
+  class EntityTask < Rake::FileTask
+    ##
+    # Parsed yaml config for the task
+    attr_reader :config
+
+    def initialize(*args, &block)
+      super(*args, &block)
+      @stampname = "#{@name}.stamp"
+      @actions << lambda { rm_rf @name }
+      CLOBBER.add([@stampname, @name])
+      ENTITIES.add(@name)
+
+      if File.exists? "#{@name}.yaml"
+        require 'yaml'
+        @config = YAML::load_file("#{@name}.yaml")
+        self.enhance [Rake.application.intern(Rake::FileTask, "#{@name}.yaml")]
+      end
+    end
+
+    # Executes task and writes its timestamp file
+    def execute(args=nil)
+      super
+      File.open(@stampname, 'w') { |f| f.write(DateTime::now.to_s) }
+    end
+
+    # Use @stampname instead of task name to determine whether to re-do the task
+    def needed?
+      ! File.exist?(name) || ! File.exist?(@stampname) || out_of_date?(timestamp)
+    end
+
+    # Time stamp for file task is on the stamp file, not on target.
+    def timestamp
+      if File.exist?(@stampname)
+        File.mtime(@stampname)
+      else
+        Rake::EARLY
+      end
+    end
+  end
+
+  # Base entity definition (wrapper over {EntityTask})
+  # 
+  # @param [#to_s] name name of task and directory
+  # @param *args arguments for {EntityTask#initialize}
+  # @yield [Rake::Task] block executed to populate target directory
+  # @return [EntityTask] defined task
+  def entity(name, *args, &block)
+    Evoker::EntityTask.define_task(name, *args, &block)
+  end
+  module_function :entity
+
+  # Download a file using wget.
+  # 
+  # @param [#to_s] url address to download from
+  # @param [Hash] opts options
+  # @option opts [#to_s] :output_file (basename of `url`) name of target file
+  # @option opts [#to_s] :wget ('wget') wget command to use
+  # @option opts [#to_s] :args (nil) custom command line arguments for wget
+  # @option opts [True, False] :no_entity (false)
+  #   do not add task to {Evoker::ENTITIES}
+  def wget(url, opts={})
+    opts[:output_file] ||= begin
+                             require 'uri'
+                             URI.parse(url).path.split('/').last
+                           end
+    opts[:wget] ||= 'wget'
+
+    wget_command = "#{opts[:wget]} -O #{opts[:output_file]}"
+    wget_command << " #{opts[:args]}" if opts[:args]
+    wget_command << " #{url} && touch #{opts[:output_file]}"
+
+    CLOBBER.add(opts[:output_file])
+    ENTITIES.add(opts[:output_file]) unless opts[:no_entity]
+
+    desc "Download #{url} as #{opts[:output_file]}"
+    file opts[:output_file] do
+      sh wget_command
+      touch opts[:output_file]
+    end
+  end
+  module_function :wget
+
+  # Check out Subversion repository
+  def subversion(name, opts={})
+    opts[:svn] ||= "svn"
+    entity name do |t|
+      cmd = "#{opts[:svn]}"
+      cmd << " #{opts[:svn_args]}" if opts[:svn_args]
+      cmd << " #{t.config[:svn_args]}" if t.config[:svn_args]
+      cmd << " checkout -q"
+      cmd << " #{opts[:checkout_args]}" if opts[:checkout_args]
+      cmd << " #{t.config[:checkout_args]}" if t.config[:checkout_args]
+      cmd << " -r #{opts[:revision]}" if opts[:revision]
+      cmd << " -r #{t.config[:revision]}" if t.config[:revision]
+      cmd << " #{opts[:url]}" if opts[:url]
+      cmd << " #{t.config[:url]}" if t.config[:url]
+      cmd << " #{t.name}"
+      sh cmd
+    end
+  end
+  module_function :subversion
+
+  # Check out Git repository
+  def git(name, opts={})
+    opts[:git] ||= "git"
+    entity name do |t|
+      cmd = "#{opts[:git]} clone"
+      cmd << " #{opts[:clone_args]}" if opts[:clone_args]
+      cmd << " #{t.config[:clone_args]}" if t.config[:clone_args]
+      cmd << " #{opts[:url]}" if opts[:url]
+      cmd << " #{t.config[:url]}" if t.config[:url]
+      cmd << " #{t.name}"
+
+      if rev = opts[:revision] || t.config[:revision]
+        cmd << " && cd #{t.name}" \
+          " && #{opts[:git]} checkout -b evoker-checkout #{rev}"
+      end
+      sh cmd
+    end
+  end
+  module_function :git
+end

data/lib/evoker/python.rb

@@ -0,0 +1,78 @@
+# Python stuff
+
+require 'evoker'
+
+module Evoker
+
+  # Create Python virtual environment
+  def virtualenv(*args)
+    if args.last.is_a? Hash
+      opts = args.pop
+    else
+      opts = {}
+    end
+    
+    if opts[:download_virtualenv]
+      opts[:python] ||= 'python'
+      opts[:virtualenv] = "#{opts[:python]} ./virtualenv.py"
+      opts[:virtualenv_version] ||= '1.6'
+      opts[:virtualenv_url] ||= "http://github.com/pypa/virtualenv/raw/#{opts[:virtualenv_version]}/virtualenv.py"
+      wget_virtualenv = wget opts[:virtualenv_url],
+        :args => '--no-check-certificate',
+        :no_entity => true
+      CLOBBER.add(['virtualenv.pyc', 'setuptools-*.egg'])
+    else
+      opts[:virtualenv] ||= 'virtualenv'
+      wget_virtualenv = nil
+    end
+    opts[:args] ||= nil
+
+    virtualenv_command = "#{opts[:virtualenv]}"
+    virtualenv_command << " #{opts[:args]}" if opts[:args]
+
+    desc "Python virtual environment"
+    venv = entity(*args) do |t|
+      sh "#{virtualenv_command} #{t.name}"
+    end
+
+    task venv => wget_virtualenv if wget_virtualenv
+    venv
+  end
+  module_function :virtualenv
+
+  # Create a symbolic link to virtualenv's site-packages dir
+  def virtualenv_site_package(path, opts={})
+    opts[:target] ||= File.basename(path)
+    opts[:virtualenv] ||= :python
+    venv = Rake::Task[opts[:virtualenv]].name
+    ln_sf File.join('..', '..', '..', '..', path),
+          File.join(Dir["#{venv}/lib/python*/site-packages"].first,
+                    opts[:target])
+  end
+  module_function :virtualenv_site_package
+
+  # Download Python requirements using pip
+  def pip_requirements(file, args={})
+    stampfile = "#{file}.stamp"
+    if args[:virtualenv]
+      args[:pip] = "#{args[:virtualenv]}/bin/pip"
+    else
+      args[:pip] ||= 'pip'
+    end
+    pip_cmd = "#{args[:pip]}"
+    pip_cmd << " #{args[:args]}" if args[:args]
+    pip_cmd << " install"
+    pip_cmd << " #{args[:install_args]}" if args[:install_args]
+    pip_cmd << " -r #{file}"
+
+    t = file stampfile => file do
+      sh pip_cmd
+      File.open(stampfile, 'w') { |f| f.write(DateTime::now.to_s) }
+    end
+    task t => args[:virtualenv] if args[:virtualenv]
+    CLOBBER.add t.name
+    ENTITIES.add t.name
+    t
+  end
+  module_function :pip_requirements
+end

data/lib/evoker/version.rb

@@ -0,0 +1,14 @@
+module Evoker
+  module VERSION
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+    STRING = [MAJOR, MINOR, TINY].join('.')
+
+    def VERSION.require_version(major, minor=0, tiny=0)
+      unless ([MAJOR, MINOR, TINY] <=> [major, minor, tiny]) >= 0
+        raise Capistrano::Error, "capistrano-offroad version #{MAJOR}.#{MINOR}.#{TINY} is below required #{major}.#{minor}.#{tiny}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: evoker
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Maciej Pasternacki
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-19 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: |
+  Evoker is an add-on to Rake to download and manage project's external
+  dependencied, update them as needed, cache them, etc.
+
+email: maciej@pasternacki.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/evoker/python.rb
+- lib/evoker/version.rb
+- lib/evoker.rb
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/mpasternacki/evoker
+licenses: 
+- BSD
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Rake add-on to download and manage project's external dependencies
+test_files: []
+