fnando-pez 0.0.2

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2008-09-01
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Nando Vieira
+
+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.markdown

@@ -0,0 +1,77 @@
+pez
+===
+
+* [http://github.com/fnando/pez](http://github.com/fnando/pez)
+
+DESCRIPTION:
+------------
+
+pez is a simple tool to manage plugins from GIT and Subversion repositories in
+a easy way. Instead of adding plugins to the project repository, pez 
+checkouts/clones the specified version to a temporary directory and 
+creates a symlink to the Ruby on Rails plugin directory.
+
+When pez is asked to update the plugins, it runs the correct command in that
+directory, based on the repository type (GIT or Subversion), which in turn is 
+applied to the project through the symlink.
+
+pez allows different environments to update plugins from a different directory.
+So, when you deploy your Ruby on Rails application, you won't have to 
+checkout/update all plugins again, unless you explicit say so.
+
+pez is based on braid (which I never had it working) but way simpler.
+
+INSTALLATION:
+-------------
+
+	git clone git://github.com/fnando/pez.git
+	cd pez
+	rake gem:install
+
+or
+
+	sudo gem install fnando-pez --source=http://gems.github.com
+
+USAGE:
+------
+
+Run the command `pez setup` from your project root to create the file 
+`config/plugins.yml`. Then you can manage plugins with the following commands:
+
+	pez add git://github.com/fnando/has_cache.git
+	pez add http://some-url.com/fnando/has_cache --type=svn
+	pez update has_cache
+	pez update --all
+	pez show --all
+	pez remove has_cache
+	pez remove --all
+	pez symlink
+
+MAINTAINER
+----------
+ 
+* Nando Vieira ([http://simplesideias.com.br](http://simplesideias.com.br))
+
+LICENSE:
+--------
+
+(The MIT License)
+
+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/Rakefile

@@ -0,0 +1,74 @@
+require 'rake'
+
+PKG_FILES = %w(Rakefile pez.gemspec History.txt License.txt README.markdown TODO.txt templates/plugins.yml) + 
+  Dir["{bin,lib}/**/*"]
+
+spec = Gem::Specification.new do |s|
+  s.name = "pez"
+  s.version = "0.0.2"
+  s.summary = "Manage Ruby on Rails plugins from GIT and Subversion repositories in a simple way"
+  s.authors = ["Nando Vieira"]
+  s.email = ["fnando.vieira@gmail.com"]
+  s.homepage = "http://github.com/fnando/pez"
+  s.description = "A simpler plugin manager that checkouts/clones the repository and just do the updates right in"
+  s.has_rdoc = false
+  s.files = PKG_FILES
+	s.bindir = "bin"
+	s.executables = "pez"
+	
+  s.add_dependency "rubigen"
+  s.add_dependency "main"
+  s.requirements << "You'll need GIT and Subversion installed"
+end
+
+namespace :gem do
+  # Thanks to the Merb project for this code.
+  desc "Update Github Gemspec"
+  task :update_gemspec do
+    skip_fields = %w(new_platform original_platform specification_version loaded required_ruby_version rubygems_version platform )
+    
+    result = "# WARNING : RAKE AUTO-GENERATED FILE. DO NOT MANUALLY EDIT!\n"
+    result << "# RUN : 'rake gem:update_gemspec'\n\n"
+    result << "Gem::Specification.new do |s|\n"
+    
+    spec.instance_variables.each do |ivar|
+      value = spec.instance_variable_get(ivar)
+      name  = ivar.split("@").last
+      value = Time.now if name == "date"
+      
+      next if skip_fields.include?(name) || value.nil? || value == "" || (value.respond_to?(:empty?) && value.empty?)
+      if name == "dependencies"
+        value.each do |d|
+          dep, *ver = d.to_s.split(" ")
+          result <<  "  s.add_dependency #{dep.inspect}, #{ver.join(" ").inspect.gsub(/[()]/, "").gsub(", runtime", "")}\n"
+        end
+      else
+        case value
+        when Array
+          value =  name != "files" ? value.inspect : value.inspect.split(",").join(",\n")
+        when FalseClass
+        when TrueClass
+        when Fixnum
+        when String
+          value = value.inspect
+        else
+          value = value.to_s.inspect
+        end
+        result << "  s.#{name} = #{value}\n"
+      end
+    end
+    
+    result << "end"
+    File.open(File.join(File.dirname(__FILE__), "#{spec.name}.gemspec"), "w"){|f| f << result}
+  end
+  
+  desc "Build gem"
+  task :build => [:update_gemspec] do
+    system "gem build #{spec.instance_variable_get('@name')}.gemspec"
+  end
+  
+  desc "Install gem"
+  task :install => [:update_gemspec, :build] do
+    system "sudo gem install #{spec.instance_variable_get('@name')}"
+  end
+end

data/TODO.txt

@@ -0,0 +1,2 @@
+- Add git branch support
+- Add svn revision checkout

data/bin/pez

@@ -0,0 +1,186 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require 'pez'
+
+# hey, this was taken from braid! thanks guys!
+Main {
+  description <<-TXT
+    pez is a simple tool to manage Ruby on Rails plugins from GIT or Subversion repositories.
+
+    Run 'pez help commandname' for more details.
+  TXT
+
+  mode(:add) {
+    description <<-TXT
+      Add a new mirror to be tracked.
+
+        * adds metadata about the mirror to config/plugins.yml
+        * fetches and merges remote code into given directory
+
+      --type defaults:
+
+        * svn://path          # => svn
+        * git://path          # => git
+        * http://path/trunk   # => svn
+        * http://path.git     # => git
+
+      Name defaults:
+
+        * remote/path         # => path
+        * remote/path/trunk   # => path
+        * remote/path.git     # => path
+    TXT
+
+    examples <<-TXT
+      . pez add svn://remote/path
+      . pez add svn://remote/path --type=git
+      . pez add git://remote/path --name=some_plugin_name
+    TXT
+
+    mixin :argument_url, :option_type, :option_name
+
+    run {
+      Pez::Command.add(url, { :type => type, :name => name })
+    }
+  }
+
+  mode(:update) {
+    description <<-TXT
+      Update a plugin mirror.
+
+        * get new changes from remote
+        * checkout/clone the repository when directory is missing
+    TXT
+
+    examples <<-TXT
+      . pez update plugin_name
+      . pez update --all
+    TXT
+
+    mixin :optional_name, :option_all
+
+    run {
+      Pez::Command.update(name, { :all => all })
+    }
+  }
+
+  mode(:remove) {
+    description <<-TXT
+      Remove a mirror.
+
+        * removes metadata from config/plugins.yml
+        * removes the local directory and commits the removal
+        * removes the vendor/plugin symlink
+    TXT
+
+    examples <<-TXT
+      . pez remove plugin_name
+      . pez remove --all
+    TXT
+
+    mixin :optional_name, :option_all
+
+    run {
+      Pez::Command.remove(name, {:all => all})
+    }
+  }
+  
+  mode(:show) {
+    description <<-TXT
+      Show mirror info.
+    TXT
+
+    examples <<-TXT
+      . pez show plugin_name
+      . pez show --all
+    TXT
+
+    mixin :optional_name, :option_all
+
+    run {
+      Pez::Command.show(name, {:all => all})
+    }
+  }
+
+  mode(:setup) {
+    description <<-TXT
+      Create the config file.
+    TXT
+
+    examples <<-TXT
+      pez setup
+    TXT
+
+    run {
+      Pez::Command.setup
+    }
+  }
+
+  mode(:version) {
+    description 'Show pez version.'
+
+    run {
+      puts "pez #{Pez::VERSION}"
+    }
+  }
+  
+  mode(:symlink) {
+    description <<-TXT
+      Create the symlinks.
+
+        * if a plugin source directory doesn't exist, pez will get it first
+    TXT
+
+    run {
+      Pez::Command.symlink
+    }
+  }
+
+  mixin(:argument_path) {
+    argument(:path) {
+      attr
+    }
+  }
+
+  mixin(:argument_url) {
+    argument(:url) {
+      attr
+    }
+  }
+
+  mixin(:option_type) {
+    option(:type, :t) {
+      optional
+      argument :required
+      desc 'mirror type'
+      attr
+    }
+  }
+  
+  mixin(:option_name) {
+    option(:name, :n) {
+      optional
+      argument :required
+      desc 'plugin name'
+      attr
+    }
+  }
+
+  mixin(:option_all) {
+    option(:all, :a) {
+      optional
+      desc 'apply to all plugins'
+      attr
+    }
+  }
+  
+  mixin(:optional_name) {
+    argument(:name) {
+      optional
+      attr
+    }
+  }
+
+  run { help! }
+}

data/lib/pez/base.rb

@@ -0,0 +1,146 @@
+module Pez
+  VERSION = "0.0.2"
+  CONFIG_FILE = File.dirname(__FILE__) + '/../../templates/plugins.yml'
+  
+  module Base
+    def self.git?(url, options={})
+      options["type"] == "git" || url =~ /^git:/ || url =~ /\.git$/
+    end
+    
+    def self.name(url, options={})
+      return options[:name] if options[:name]
+      
+      if git?(url, options)
+        m, name = *url.match(/\/([^\/]+)\.git$/)
+      else
+        m, name = *url.match(/\/([^\/]+)\/?(?:trunk\/?)?$/)
+      end
+      
+      name
+    end
+    
+    def self.config
+      YAML.load_file('config/plugins.yml')
+    end
+    
+    def self.add_to_config(name, url, options={})
+      c = config
+      c['plugins'] ||= {}
+      c['plugins'][name] = {'repo' => url, 'type' => options[:type]}
+      
+      File.open('config/plugins.yml', 'w+') do |f|
+        f << YAML::dump(c)
+      end
+    end
+    
+    def self.remove_from_config(name)
+      c = config
+      c['plugins'] ||= {}
+      c['plugins'].delete(name)
+      
+      File.open('config/plugins.yml', 'w+') do |f|
+        f << YAML::dump(c)
+      end
+      
+      system "rm -rf #{destination}/#{name}"
+      system "rm vendor/plugins/#{name}"
+    end
+    
+    def self.destination
+      config[Rails.env] || 'tmp/plugins'
+    end
+    
+    def self.plugins(name, options={})
+      if name
+        [name]
+      elsif options[:all]
+        Pez::Base.config["plugins"].keys
+      else
+        []
+      end
+    end
+  end
+  
+  module Command
+    def self.setup
+      puts 'Configuration file already generated at config/plugins.yml' and return if File.exists?('config/plugins.yml')
+      
+      File.open('config/plugins.yml', 'w') do |f|
+        base_path = IO.popen('pwd').read.chomp
+        contents = File.read(CONFIG_FILE)
+        contents.gsub!(/%base_path%/, base_path)
+        
+        f << contents
+      end
+    end
+    
+    def self.add(url, options={}, skip_config=false)
+      name = Pez::Base.name(url, options)
+      
+      puts "Retrieving #{name}..."
+      
+      if Pez::Base.git?(url, options)
+        options[:type] = "git"
+        system "mkdir -p #{Pez::Base.destination}; cd #{Pez::Base.destination}; git clone #{url} #{name}"
+      else
+        options[:type] = "svn"
+        system "mkdir -p #{Pez::Base.destination}; cd #{Pez::Base.destination}; svn co #{url} #{name}"
+      end
+      
+      puts
+      Pez::Base.add_to_config(name, url, options) unless skip_config
+      system "ln -s #{Pez::Base.destination}/#{name} vendor/plugins/#{name}"
+    end
+    
+    def self.remove(name=nil, options={})
+      Pez::Base.plugins(name, options).each {|name| Pez::Base.remove_from_config(name) }
+    end
+    
+    def self.update(name=nil, options={})
+      c = Pez::Base.config
+      
+      Pez::Base.plugins(name, options).each do |name|
+        dirname = "#{Pez::Base.destination}/#{name}"
+        data = c['plugins'][name]
+        
+        puts "Retrieving #{name}..."
+        
+        if File.directory?(dirname)
+          if data['type'] == 'git'
+            system "cd #{dirname}; git pull"
+          else
+            system "cd #{dirname}; svn up"
+          end
+        else
+          add(data['repo'], {:type => data['type'], :name => name}, true)
+        end
+        
+        puts
+      end
+    end
+    
+    def self.symlink
+      c = Pez::Base.config
+      
+      Pez::Base.plugins(nil, {:all => 'all'}).each do |name|
+        dirname = "#{Pez::Base.destination}/#{name}"
+        
+        if File.directory?(dirname)
+          system "ln -s #{dirname} vendor/plugins/#{name}"
+        else
+          add(data['repo'], {:type => data['type'], :name => name}, true)
+        end
+      end
+    end
+    
+    def self.show(name=nil, options={})
+      c = Pez::Base.config
+      
+      Pez::Base.plugins(name, options).each do |name|
+        puts "Plugin: %s" % name
+        puts "Repository: %s" % c['plugins'][name]['repo']
+        puts
+      end
+    end
+  end
+end

data/lib/pez.rb

@@ -0,0 +1,20 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "rubygems"
+require "main"
+require "yaml"
+require "fileutils"
+require "pez/base"
+
+begin
+  require "config/environment"
+rescue LoadError => e
+  nil
+end
+
+begin
+  require "ruby-debug"
+rescue LoadError => e
+  nil
+end

data/pez.gemspec

@@ -0,0 +1,32 @@
+# WARNING : RAKE AUTO-GENERATED FILE. DO NOT MANUALLY EDIT!
+# RUN : 'rake gem:update_gemspec'
+
+Gem::Specification.new do |s|
+  s.date = "Mon Sep 01 21:04:00 -0300 2008"
+  s.executables = ["pez"]
+  s.authors = ["Nando Vieira"]
+  s.required_rubygems_version = ">= 0"
+  s.version = "0.0.2"
+  s.files = ["Rakefile",
+ "pez.gemspec",
+ "History.txt",
+ "License.txt",
+ "README.markdown",
+ "TODO.txt",
+ "templates/plugins.yml",
+ "bin/pez",
+ "lib/pez",
+ "lib/pez/base.rb",
+ "lib/pez.rb"]
+  s.has_rdoc = false
+  s.requirements = ["You'll need GIT and Subversion installed"]
+  s.email = ["fnando.vieira@gmail.com"]
+  s.name = "pez"
+  s.bindir = "bin"
+  s.homepage = "http://github.com/fnando/pez"
+  s.summary = "Manage Ruby on Rails plugins from GIT and Subversion repositories in a simple way"
+  s.description = "A simpler plugin manager that checkouts/clones the repository and just do the updates right in"
+  s.add_dependency "rubigen", ">= 0"
+  s.add_dependency "main", ">= 0"
+  s.require_paths = ["lib"]
+end

data/templates/plugins.yml

@@ -0,0 +1,2 @@
+development: %base_path%/tmp/plugins
+production: %base_path%/tmp/plugins

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: fnando-pez
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Nando Vieira
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-01 17:04:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubigen
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: main
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A simpler plugin manager that checkouts/clones the repository and just do the updates right in
+email: 
+- fnando.vieira@gmail.com
+executables: 
+- pez
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- pez.gemspec
+- History.txt
+- License.txt
+- README.markdown
+- TODO.txt
+- templates/plugins.yml
+- bin/pez
+- lib/pez
+- lib/pez/base.rb
+- lib/pez.rb
+has_rdoc: false
+homepage: http://github.com/fnando/pez
+post_install_message: 
+rdoc_options: []
+
+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: 
+- You'll need GIT and Subversion installed
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Manage Ruby on Rails plugins from GIT and Subversion repositories in a simple way
+test_files: []
+