ed 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.travis.yml

@@ -0,0 +1,13 @@
+
+rvm: 
+  - 1.8.7 # (current default)
+  - 1.9.2
+  - 1.9.3
+  - rbx-2.0
+  - ruby-head
+  - ree
+
+notifications:
+  irc: "irc.freenode.org#flowof.info"
+  recipients:
+    - rob@flowof.info

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/README.md

@@ -0,0 +1,91 @@
+__OVERVIEW__
+
+
+| Project         | Ed 
+|:----------------|:--------------------------------------------------
+| Homepage        | https://github.com/robgleeson/ed
+| Wiki            | https://github.com/robgleeson/ed/wiki
+| Documentation   | http://rubydoc.info/gems/ed/frames 
+| Author          | Rob Gleeson             
+
+
+__DESCRIPTION__
+
+  A Domain Specific Language(DSL) that you can use to talk to Git from Ruby.  
+  It isn't intended to be a full interface to Git, but a very small subset of
+  one that allows you to profile code from tag A against tag B (for example).
+
+
+__WHY?__
+
+  So I could: 
+
+  * Profile different tags, commits, and branches against one another inside Ruby. 
+  * Explore code in different tags, commits, and branches using a REPL 
+    like [Pry](https://github.com/pry/pry).
+
+__PLATFORM SUPPORT__  
+
+_supported_ 
+
+* Rubinius
+* CRuby (1.8 / 1.9)
+
+_unsupported_
+
+* JRuby
+* MacRuby
+
+__EXAMPLES__
+
+__1.__
+
+Travel time and explore, with the aid of [Pry](https://github.com/pry/pry).  
+(The calling scope is lost in this example, through use of instance\_eval):
+
+    Repository "git://github.com/robgleeson/barney.git" do  
+      before do |path|
+        $: << File.join(path, "lib/")
+        require "barney" 
+      end
+
+      tag "0.1.0" do
+        binding.pry
+      end
+
+      tag "0.2.0" do
+        binding.pry
+      end
+  end
+
+__2.__
+
+Travel time and explore, with the aid of [Pry](https://github.com/pry/pry).  
+(The calling scope is kept in this example by accepting a block parameter):
+
+    Ed.new do |repo|
+      repo.before do |path|
+        $: << File.join(path, "lib/")
+        require "barney" 
+      end
+
+      repo.tag "0.1.0" do
+        binding.pry
+      end
+
+      repo.tag "0.2.0" do
+        binding.pry
+      end
+    end
+
+__INSTALL__
+
+  gem install ed
+
+__LICENSE__
+
+  
+  See LICENSE.txt
+
+
+ 

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.name       = :test
+  t.test_files = FileList["test/*.rb"]
+end
+
+task :default => :test

data/ed.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ed/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ed"
+  s.version     = Ed::VERSION
+  s.authors     = ["Rob Gleeson"]
+  s.email       = ["rob@flowof.info"]
+  s.homepage    = "https://github.com/robgleeson/ed"
+  s.summary     = %q{A Domain Specific Language(DSL) that you can use to talk to Git from Ruby.}  
+  s.description = s.summary
+
+  s.rubyforge_project = "Ed"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+
+  #s.add_runtime_dependency     "scm"     , "~> 0.1.0.pre1"
+  
+  s.add_runtime_dependency     "observe" , "~> 0.2.0"
+  s.add_development_dependency "rake"    , "~> 0.9.2"
+  s.add_development_dependency "minitest", "~> 2.6"
+end

data/examples/benchmark.rb

@@ -0,0 +1,27 @@
+require "ed"
+require "pry"
+require "benchmark"
+
+Repository "git://github.com/robgleeson/barney.git" do  
+  before do |path|
+    $: << File.join(path, "lib/")
+    require "barney" 
+  end
+
+  tag "0.1.0" do
+    Benchmark.bm do |r| 
+      r.report("0.1.0") {
+        Barney::Share.new
+      }
+    end
+  end
+
+  tag "0.2.0" do
+    Benchmark.bm do |r| 
+      r.report("0.2.0") {
+        Barney::Share.new
+      }
+    end
+  end
+end
+

data/examples/pry.rb

@@ -0,0 +1,17 @@
+require "ed"
+require "pry"
+
+Repository "git://github.com/robgleeson/barney.git" do  
+  before do |path|
+    $: << File.join(path, "lib/")
+    require "barney" 
+  end
+
+  tag "0.1.0" do
+    binding.pry
+  end
+
+  tag "0.2.0" do
+    binding.pry
+  end
+end

data/lib/ed.rb

@@ -0,0 +1,65 @@
+require 'observe'
+require 'ed/version'
+require 'ed/repository'
+require 'ed/context'
+require 'ed/core_ext/object'
+
+class Ed
+
+  include Observe
+
+  #
+  # @param [String] path
+  #   The path to a git repository.
+  #
+  # @yieldparam [Ed] _self
+  #   Yields self, if a block is given.
+  #
+  # @return [Ed::Repository] 
+  #
+  def initialize path
+    @repo = Ed::Repository.new(path)
+
+    if block_given? 
+      yield(self)
+    end
+  end
+
+  #
+  # @param [Proc] block
+  #   A block executed before {#commit}, {#branch}, or {#tag} is called. 
+  #
+  # @return [void]
+  #
+  def before &block
+    add_observer(:before_filter, &block)
+  end
+
+  #
+  # @param [String] commit 
+  #   Any string that is passable to 'git checkout'.
+  #
+  # @param [Proc] block
+  #   A block executed while the repository has switched to 'commit'.
+  #
+  def commit commit, &block
+    switch(commit, &block)
+  end
+  alias_method :tag   , :commit
+  alias_method :branch, :commit
+
+  
+  def switch(commit, &block)
+    pid = fork do
+      @repo.checkout '-q', commit 
+      notify_observers(:before_filter, @repo.path)
+      block.call
+    end
+
+    Process.wait(pid)
+  end
+  private :switch
+
+end
+
+

data/lib/ed/context.rb

@@ -0,0 +1,35 @@
+class Ed::Context 
+
+  def initialize path, &block
+    @__ed__ = Ed.new(path) 
+    instance_eval(&block)
+  end
+
+  #
+  # @param block
+  #   (see Ed#before)
+  #
+  # @return 
+  #   (see Ed#before) 
+  #
+  def before &block
+    @__ed__.before(&block)
+  end
+
+  #
+  # @param commit
+  #   (see Ed#commit)
+  #
+  # @param block
+  #   (see Ed#commit)
+  #
+  # @return 
+  #   (see Ed#commit) 
+  #
+  def commit commit, &block
+    @__ed__.commit(commit, &block)
+  end
+  alias_method :tag   , :commit
+  alias_method :branch, :commit
+
+end

data/lib/ed/core_ext/object.rb

@@ -0,0 +1,22 @@
+#
+# @param [String] path 
+#   The path to the repository.
+#
+# @param [Proc] block
+#   A block executed within an instance of {Ed::Repository}.
+#
+# @yieldparam [Ed] repo
+#   Yields instance of {Ed}.  
+#   If not given, 'block' is run through instance_eval on {Ed::Context} instead.
+#
+# @return [void]
+#
+def Repository path, &block
+  if block.arity == 1
+    block.call Ed.new(path)
+  else
+    Ed::Context.new(path, &block) 
+  end
+end
+
+

data/lib/ed/repository.rb

@@ -0,0 +1,76 @@
+require 'fileutils'
+
+class Ed::Repository
+
+  #
+  # @return [String]
+  #   The path to the repository on a local disk.
+  #
+  attr_reader  :path
+  
+  #
+  # @return [Boolean] 
+  #   Has the repository been copied?
+  #
+  attr_reader  :copy
+  alias_method :copy?, :copy
+
+  #
+  # @param [String, #to_s] path
+  #   The URI to a git repository.
+  #
+  # @param [Boolean] copy
+  #   If true, a copy of the repository is created.
+  #
+  def initialize path, copy = true
+    if copy
+      @path = copy!(path.to_s)
+      @copy = true
+    else
+      @path = path.to_s
+      @copy = false
+    end
+  end
+
+  #
+  # @param [String] *options
+  #   The same commands given to 'git checkout' 
+  #
+  # @return [void]
+  #
+  def checkout *options
+    git "checkout", *options
+  end
+
+  #
+  # @param [String] from 
+  #   The path to copy from.
+  #
+  # @param [String] to
+  #   The path to copy to.
+  #
+  # @return [String]
+  #   The path to the copied repository.
+  #
+  def copy! from, to = "/tmp/#{Process.pid}-#{Thread.current.object_id}.ed" 
+    unless File.exists? to
+      FileUtils.mkdir_p(to) 
+      system 'git', 'clone', '-q', from, to
+    end
+
+    to
+  end
+  private :copy!
+
+  # 
+  # Provides low-level access to the git binary in the context of {#path}. 
+  # @return [void]
+  #
+  def git *args
+    Dir.chdir(@path) do
+      system "git", *args
+    end
+  end
+  private :git
+
+end

data/lib/ed/version.rb

@@ -0,0 +1,3 @@
+class Ed
+  VERSION = "0.1.0"
+end

data/test/setup.rb

@@ -0,0 +1,7 @@
+require 'bundler/setup'
+require 'minitest/spec'
+require 'minitest/autorun'
+require 'tempfile'
+require 'ed'
+
+alias :context :describe

data/test/test_ed.rb

@@ -0,0 +1,32 @@
+context Ed do
+
+  context 'When given a git:// URI.' do
+    before do 
+      @ed   = Ed.new "git://github.com/robgleeson/barney.git"
+      @repo = @ed.instance_variable_get(:@repo)  
+    end
+
+    it 'must clone and store the repository locally.' do
+      File.exists?(@repo.path).must_equal(true)   
+    end
+
+    it 'must checkout the "0.1.0" tag.' do
+      Tempfile.open "assertion" do |tmpfile|
+        @ed.before do |path|
+          $: << File.join(path, "lib")
+          require 'thread'  
+          require 'barney'
+        end
+
+        @ed.tag "0.1.0" do
+          tmpfile.write Barney::VERSION
+        end
+
+        tmpfile.rewind
+        version = tmpfile.read
+        version.must_equal("0.1.0")
+      end
+    end
+  end
+
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: ed
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Rob Gleeson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: observe
+  requirement: &70110727518460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70110727518460
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70110727517060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *70110727517060
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &70110727515260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *70110727515260
+description: A Domain Specific Language(DSL) that you can use to talk to Git from
+  Ruby.
+email:
+- rob@flowof.info
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- ed.gemspec
+- examples/benchmark.rb
+- examples/pry.rb
+- lib/ed.rb
+- lib/ed/context.rb
+- lib/ed/core_ext/object.rb
+- lib/ed/repository.rb
+- lib/ed/version.rb
+- test/setup.rb
+- test/test_ed.rb
+homepage: https://github.com/robgleeson/ed
+licenses: []
+post_install_message: 
+rdoc_options: []
+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: '0'
+requirements: []
+rubyforge_project: Ed
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: A Domain Specific Language(DSL) that you can use to talk to Git from Ruby.
+test_files:
+- test/setup.rb
+- test/test_ed.rb
+has_rdoc: