rakext 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 by Domizio Demichelis
+
+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/README.md

@@ -0,0 +1,86 @@
+# rakext
+
+Lite and powerful rake extension.
+
+Rakext allows you to create rake tasks by just writing methods. Besides, you can pass tasks arguments as ruby code, YAML or JSON strings and they will be evaluated as you expect.
+
+## Task Usage
+
+You can define your own modules and `include Rakext::Tasks` in order to create your tasks:
+
+```ruby
+# file 'my_tasks.rb'
+module MyTasks
+  include Rakext::Tasks
+  # the default prefix would be 'my_tasks:'
+  prefix 'my_pref:'
+
+  desc 'this is the my_pref:foo - args(opts)'
+  def foo(opts)
+    print 'received arguments: '
+    p opts
+  end
+
+  module NestedNamespace
+    include Rakext::Tasks
+    # uses the default prefix 'my_task:nested_namespace:'
+
+    desc 'this is the my_task:nested_namespace:bar - args(a,b,c)'
+    def bar(a, b, c)
+      print 'received arguments: '
+      p a, b, c
+    end
+
+  end
+end
+```
+
+In the Rakefile:
+
+```ruby
+require 'rakext'
+require 'my_tasks'
+```
+
+Check the tasks:
+
+```sh
+$ rake -T
+rake my_pref:foo                    # this is the my_pref:foo - args(opts)
+rake my_tasks:nested_namespace:bar  # this is the my_task:nested_namespace:bar - args(a,b,c)
+```
+
+## CLI Usage
+
+A few examples about passing args:
+
+```sh
+# pure rake
+$ rake my_pref:foo RUBY_ARGS='a:"foo", b: "bar"'
+$ rake my_task:nested_namespace:bar RUBY_ARGS='{a:4,b:3}, "a", "b"'
+
+# need rakext for multiline args (rake does not parse them correctly)
+$ rakext my_pref:foo YAML_ARGS='
+---
+:a: foo
+:b: bar
+'
+
+$ rakext my_task:nested_namespace:bar JSON_ARGS='
+[{"a":4,"b":3}, "a", "b"]
+'
+```
+
+## Try it
+
+Look at the 2 files in [test](./rakext/blob/master/test) to see how it works. You may also run `. text.sh` to try it.
+
+## Tips and tricks
+
+Since the `rakext` bin is exactly the same `rake` bin with just an added `m` multiline flag, you can symlink it so you will always use `rakext` when you type `rake`.
+
+## Copyright
+
+Copyright (c) 2012 by [Domizio Demichelis](mailto://dd.nexus@gmail.com)<br>
+See [LICENSE](./rakext/blob/master/LICENSE) for details.
+

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/rakext

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+# This bin does exactly what rake does, but allows to use multiline arguments that
+# rake does not parse correctly, so we fix the collect_tasks method.
+
+begin
+  require 'rubygems'
+rescue LoadError
+end
+
+require 'rake'
+
+require 'rake/application'
+module Rake
+  class Application
+    # Fixes the RegEx that doesn't parse correctly multiline args
+    def collect_tasks
+      @top_level_tasks = []
+      ARGV.each do |arg|
+        if arg =~ /^(\w+)=(.*)$/m  # m is needed for multiline parsing
+          ENV[$1] = $2
+        else
+          @top_level_tasks << arg unless arg =~ /^-/
+        end
+      end
+      @top_level_tasks.push("default") if @top_level_tasks.size == 0
+    end
+  end
+end
+
+Rake.application.run

data/lib/rakext.rb

@@ -0,0 +1,53 @@
+require 'rake'
+require 'yaml'
+require 'multi_json'
+
+module Rakext
+  module Tasks
+    def self.included(base)
+      base.class_eval do
+        extend self
+        @prefix = ( p = name.gsub('::', ':')
+                    p.gsub!(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+                    p.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+                    p.downcase!
+                    "#{p}:" )
+      end
+    end
+
+    def method_added(meth)
+      return unless public_instance_methods.include?(meth) || public_instance_methods.include?(meth.to_sym)
+      args = Rakext.get_args
+      m    = method(meth.to_sym)
+      Rake::Task.define_task("#{@prefix}#{meth}") do
+        args.is_a?(Hash) ? m.call(args) : m.call(*args)
+      end
+    end
+
+    def desc(description)
+      Rake.application.last_description = description
+    end
+
+    def prefix(p=nil)
+      p.nil? ? @prefix : @prefix = p
+    end
+  end
+
+  def self.get_args
+    case
+    when ENV['RUBY_ARGS']
+      a = ENV['RUBY_ARGS'].strip
+      a = a[1..-2] if a =~ /^\(.*\)$/
+      eval("echo(#{a})")
+    when ENV['YAML_ARGS']
+      YAML.load(ENV['YAML_ARGS'])
+    when ENV['JSON_ARGS']
+      MultiJson.decode(ENV['JSON_ARGS'])
+    end
+  end
+
+private
+  def self.echo(*a); a end
+
+end
+

data/rakext.gemspec

@@ -0,0 +1,22 @@
+require 'date'
+
+Gem::Specification.new do |s|
+  s.name                      = 'rakext'
+  s.authors                   = ["Domizio Demichelis"]
+  s.email                     = 'dd.nexus@gmail.com'
+  s.homepage                  = 'http://github.com/ddnexus/ake'
+  s.summary                   = 'Lite and powerful rake extension'
+  s.description               = 'Rakext allows you to create rake tasks by just writing methods. Besides, you can pass tasks arguments as ruby code, YAML or JSON strings and they will be evaluated as you expect.'
+  s.executables               = ['rakext']
+  s.extra_rdoc_files          = ["README.md"]
+  s.require_paths             = ["lib"]
+  s.files                     = `git ls-files -z`.split("\0")
+  s.version                   = File.read(File.expand_path('../VERSION', __FILE__)).strip
+  s.date                      = Date.today.to_s
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rdoc_options              = ["--charset=UTF-8"]
+
+  s.add_runtime_dependency 'multi_json', '~> 1.3.4'
+  s.add_runtime_dependency 'rake', '~> 0.9.2.2'
+end
+

data/test/Rakefile

@@ -0,0 +1,29 @@
+require 'rakext'
+
+module TopLevel
+  include Rakext::Tasks
+  prefix 'my_pref:'
+
+  desc 'this is the my_pref:task_a - args(opts)'
+  def task_a(opts)
+    print 'received arguments: '
+    p opts
+  end
+
+  module NestedNamespace
+    include Rakext::Tasks
+
+    desc 'this is the top_level:nested_namespace:task_b - args(a,b,c)'
+    def task_b(a, b, c)
+      print 'received arguments: '
+      p a, b, c
+    end
+
+  end
+end
+
+desc 'get_args task, will just echo the passed args'
+task 'get_args' do
+  print 'received arguments: '
+  p Rakext.get_args
+end

data/test/test.sh

@@ -0,0 +1,49 @@
+echo %%% RAKEXT TRANSFORMS YOUR METHODS IN RAKE TASKS %%%
+echo
+echo $ rakext -T
+RUBYLIB=../lib ../bin/rakext -T
+echo
+
+echo %%% YOU CAN PASS ARGUMENTS IN RUBY CODE %%%
+echo
+echo $ rakext my_pref:task_a RUBY_ARGS=\'\{a:4,b:3\'\}
+RUBYLIB=../lib ../bin/rakext my_pref:task_a RUBY_ARGS='{a:4,b:3}'
+echo
+
+echo $ rakext my_pref:task_a RUBY_ARGS=\"a:4,b:3\"
+RUBYLIB=../lib ../bin/rakext my_pref:task_a RUBY_ARGS="a:4,b:3"
+echo
+
+echo $ rakext my_pref:task_a RUBY_ARGS='(a:"4",b:3)'
+RUBYLIB=../lib ../bin/rakext my_pref:task_a RUBY_ARGS='(a:"4",b:3)'
+echo
+
+echo $ rakext top_level:nested_namespace:task_b RUBY_ARGS=\'1,2,3\'
+RUBYLIB=../lib ../bin/rakext top_level:nested_namespace:task_b RUBY_ARGS='1,2,3'
+echo
+
+echo $ rakext top_level:nested_namespace:task_b RUBY_ARGS=\'[1,2,3], \"foo\", \"bar\"\'
+RUBYLIB=../lib ../bin/rakext top_level:nested_namespace:task_b RUBY_ARGS='[1,2,3], "foo", "bar"'
+echo
+
+echo %%% YOU CAN PASS ARGUMENTS IN YAML %%%
+echo
+echo $ rakext my_pref:task_a YAML_ARGS=\'---
+echo :a: 4
+echo :b: 3
+echo \'
+RUBYLIB=../lib ../bin/rakext get_args YAML_ARGS='---
+:a: 4
+:b: 3
+'
+echo
+echo %%% YOU CAN PASS ARGUMENTS IN JSON %%%
+echo
+
+echo $ rakext my_pref:task_a JSON_ARGS=\'
+echo {\"a\": 4, \"b\": 3}
+echo \'
+RUBYLIB=../lib ../bin/rakext my_pref:task_a JSON_ARGS='
+{"a": 4, "b": 3}
+'
+echo

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: rakext
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Domizio Demichelis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &70356619482580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *70356619482580
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70356619482120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70356619482120
+description: Rakext allows you to create rake tasks by just writing methods. Besides,
+  you can pass tasks arguments as ruby code, YAML or JSON strings and they will be
+  evaluated as you expect.
+email: dd.nexus@gmail.com
+executables:
+- rakext
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- LICENSE
+- README.md
+- VERSION
+- bin/rakext
+- lib/rakext.rb
+- rakext.gemspec
+- test/Rakefile
+- test/test.sh
+homepage: http://github.com/ddnexus/ake
+licenses: []
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Lite and powerful rake extension
+test_files: []
+has_rdoc: