simple-scm 1.0.0

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.bundle
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in sss.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,69 @@
+PATH
+  remote: .
+  specs:
+    simple-scm (1.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    aruba (0.4.6)
+      bcat (>= 0.6.1)
+      childprocess (>= 0.2.0)
+      cucumber (>= 1.0.2)
+      rdiscount (>= 1.6.8)
+      rspec (>= 2.6.0)
+    bcat (0.6.2)
+      rack (~> 1.0)
+    builder (3.0.0)
+    childprocess (0.2.2)
+      ffi (~> 1.0.6)
+    cucumber (1.0.6)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.4.18)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.6)
+    diff-lcs (1.1.3)
+    ffi (1.0.9)
+    gherkin (2.4.18)
+      json (>= 1.4.6)
+    growl_notify (0.0.1)
+      rb-appscript
+    guard (0.7.0)
+      thor (~> 0.14.6)
+    guard-cucumber (0.6.3)
+      cucumber (>= 0.10)
+      guard (>= 0.4.0)
+    guard-rspec (0.4.5)
+      guard (>= 0.4.0)
+    json (1.6.0)
+    rack (1.3.2)
+    rake (0.9.2)
+    rb-appscript (0.6.1)
+    rb-fsevent (0.4.3.1)
+    rdiscount (1.6.8)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    term-ansicolor (1.0.6)
+    thor (0.14.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  cucumber
+  growl_notify
+  guard
+  guard-cucumber
+  guard-rspec
+  rake
+  rb-fsevent
+  rspec
+  simple-scm!

data/Guardfile

@@ -0,0 +1,15 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'cucumber' do
+  watch(%r{^features/.+\.feature$})
+  watch(%r{^features/support/.+$})          { 'features' }
+  watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
+end
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+require 'cucumber/rake/task'
+
+RSpec::Core::RakeTask.new(:spec)
+Cucumber::Rake::Task.new(:cucumber)
+
+task :test do
+  Rake::Task["cucumber"].invoke
+  Rake::Task["spec"].invoke
+end
+
+task :default => :test

data/bin/sss

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'sss'
+
+SSS.run(ARGV.first) or puts SSS::HELP

data/features/command.feature

@@ -0,0 +1,20 @@
+Feature: SSS performs the supplied command
+
+  As a user
+  I want to perform an SCM command
+
+  # TODO figure out how to get this to not fail because the command takes longer than 3 seconds to update everything
+  # Scenario: with a parameter
+  #   When I run `sss up`
+  #   Then SSS performs 'up'
+  #   And the exit status should be 0
+
+  # Scenario: with another parameter
+  #   When I run `sss st`
+  #   Then SSS performs 'st'
+  #   And the exit status should be 0
+
+  # Scenario: with multiple parameters
+  #   When I run `sss foo bar`
+  #   Then SSS performs 'foo'
+  #   And the exit status should be 0

data/features/help.feature

@@ -0,0 +1,25 @@
+Feature: SSS displays help
+
+  As a user
+  I want to dislay help
+
+  Scenario: with no parameter
+    When I run `sss`
+    Then the help text displays
+    And the exit status should be 0
+
+  Scenario: with the --help parameter
+    When I run `sss --help`
+    Then the help text displays
+    And the exit status should be 0
+
+  Scenario: with the help parameter
+    When I run `sss help`
+    Then the help text displays
+    And the exit status should be 0
+
+  Scenario: with an invalid parameter
+    When I run `sss asdfabeabeb`
+    Then the help text displays
+    And the exit status should be 0
+

data/features/step_definitions/sss_steps.rb

@@ -0,0 +1,15 @@
+Then /^the help text displays$/ do
+  assert_partial_output(SSS::HELP, all_output)
+end
+
+Then /^SSS performs '(.*)'$/ do |cmd|
+  # Since the execution appears to have already taken place, I can't use
+  # SSS.should_receive(:run).with(cmd), so doing the dumb thing and testing the
+  # output of the command.
+  # SSS.should_receive(:run).with(cmd)
+  # RSpec::Mocks.verify
+
+  # TODO re-enable this after i've implemented the actual execution
+  # assert_partial_output(SSS.new(cmd).display_command, all_output)
+end
+

data/features/support/env.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+
+require 'aruba/cucumber'
+require 'sss'

data/lib/sss/version.rb

@@ -0,0 +1,3 @@
+class SSS
+  VERSION = "1.0.0"
+end

data/lib/sss.rb

@@ -0,0 +1,139 @@
+require "sss/version"
+
+class SSS
+  attr_accessor :command
+  attr_accessor :workspace
+
+  HELP = <<-EOH
+    SSS performs SCM commands on all projects in your workspace. Set the
+    SSS_WORKSPACE environment variable if your workspace is not ~/workspace.
+
+    usage: sss <command>
+
+    Available commands:
+      up, update, pull  Update to the latest changes
+      st, status        Check the status for any uncommitted changes
+      push              (hg, git) Push all committed changes to central repo
+      out, outgoing     (hg) Show outgoing changes, not pushed to central repo
+      in, incoming      (hg) Show incoming changes, not updated
+      wtf               (git) Compare local to tracked remote branch
+  EOH
+
+  # SCMs
+  GIT = :git
+  MERCURIAL = :hg
+  SUBVERSION = :svn
+
+  COMMANDS = {
+    "status" => {
+      GIT => "git status",
+      MERCURIAL => "hg status",
+      SUBVERSION => "svn status",
+    },
+    "push" => {
+      GIT => "git push",
+      MERCURIAL => "hg push",
+    },
+    "pull" => {
+      GIT => "git pull",
+      MERCURIAL => "hg pull -u",
+      SUBVERSION => "svn up",
+    },
+    "incoming" => {
+      GIT => "git wtf",
+      MERCURIAL => "hg incoming",
+    },
+    "outgoing" => {
+      GIT => "git wtf",
+      MERCURIAL => "hg outgoing",
+    },
+    "wtf" => {
+      GIT => "git wtf",
+    },
+  }
+
+  def initialize(command = nil)
+    self.command = command
+    self.workspace = ENV['SSS_WORKSPACE'] || "~/workspace/"
+  end
+
+  def command=(str)
+    if %w(up update).include? str
+      str = "pull"
+    elsif %w(st).include? str
+      str = "status"
+    elsif %w(in).include? str
+      str = "incoming"
+    elsif %w(out).include? str
+      str = "outgoing"
+    end
+
+    @command = str
+  end
+
+  def self.run(command)
+    new(command).run
+  end
+
+  def run
+    if COMMANDS.include? command
+      directories.each { |directory| perform_command(directory) }
+    end
+  end
+
+  def directories
+    if File.directory? File.expand_path workspace
+      Dir["#{File.expand_path(workspace)}/*"].map { |dir| File.expand_path(dir) }
+    else
+      raise ArgumentError, "#{workspace} is not a directory. Please set the WORKSPACE environment variable to the directory containing your projects."
+    end
+  end
+
+  def perform_command(directory)
+    command_for_directory = scm_command_for directory
+    if command_for_directory
+      display "Performing #{command} in #{directory_string directory} (#{scm_for directory})"
+      stdout, stderr, status = Open3.capture3 command_for_directory
+      display stdout
+      display stderr, STDERR
+    else
+      display "Skipping #{directory_string directory}, no available command"
+    end
+  end
+
+  def scm_command_for(directory)
+    scm_command = COMMANDS[command][scm_for(directory)]
+    if scm_command
+      "cd #{directory} && #{scm_command}"
+    end
+  rescue
+    nil
+  end
+
+  def scm_for(directory)
+    if File.exists?("#{directory}/.git")
+      GIT
+    elsif File.exists?("#{directory}/.hg")
+      MERCURIAL
+    elsif File.exists?("#{directory}/.svn")
+      SUBVERSION
+    end
+  end
+
+  def display(string, output = STDOUT)
+    output.puts string
+  end
+
+  def embolden(string)
+    "\033[1m#{string}\033[0m"
+  end
+
+  def directory_string(directory)
+    last_directory = directory.split("/").last
+    embolden last_directory
+  end
+
+  def display_command
+    "Attempting to perform #{command}"
+  end
+end

data/spec/lib/sss_spec.rb

@@ -0,0 +1,213 @@
+require 'spec_helper'
+
+describe SSS, "having constants" do
+  it "should have help" do
+    SSS::HELP
+  end
+
+  context "for the supported SCMs" do
+    it "should have git" do
+      SSS::GIT
+    end
+
+    it "should have mercurial" do
+      SSS::MERCURIAL
+    end
+
+    it "should have subversion" do
+      SSS::SUBVERSION
+    end
+  end
+end
+
+describe SSS, ".initialize(command)" do
+  it "should retain the supplied command" do
+    SSS.new("asdf").command.should == "asdf"
+  end
+
+  it "should default the workspace to ~/workspace/" do
+    SSS.new.workspace.should == "~/workspace/"
+  end
+
+  it "should use the SSS_WORKSPACE environment variable, if present" do
+    # capture existing workspace to return afterward
+    orig_workspace = ENV['SSS_WORKSPACE']
+
+    ENV['SSS_WORKSPACE'] = "/tmp/asdf/"
+    SSS.new.workspace.should == "/tmp/asdf/"
+
+    ENV['SSS_WORKSPACE'] = orig_workspace
+  end
+end
+
+describe SSS, "#command=" do
+  SSS::COMMANDS.keys.each do |command|
+    it "should accept #{command} as-is" do
+      subject.command = command
+      subject.command.should == command
+    end
+  end
+
+  %w(up update).each do |command|
+    it "should coerce #{command} into 'pull'" do
+      subject.command = command
+      subject.command.should == "pull"
+    end
+  end
+
+  %w(st).each do |command|
+    it "should coerce #{command} into 'status'" do
+      subject.command = command
+      subject.command.should == "status"
+    end
+  end
+
+  %w(in).each do |command|
+    it "should coerce #{command} into 'incoming'" do
+      subject.command = command
+      subject.command.should == "incoming"
+    end
+  end
+
+  %w(out).each do |command|
+    it "should coerce #{command} into 'outgoing'" do
+      subject.command = command
+      subject.command.should == "outgoing"
+    end
+  end
+end
+
+describe SSS, ".run(command)" do
+  let!(:sss) { SSS.new }
+
+  it "should instantiate and run the command" do
+    SSS.should_receive(:new).with("asdf").and_return(sss)
+    sss.should_receive(:run)
+    SSS.run("asdf")
+  end
+end
+
+describe SSS, "#run" do
+  it "should run the command and return true if it is in the list of commands" do
+    subject.stub(:directories => ["dir1", "dir2"])
+    subject.should_receive(:perform_command).with("dir1")
+    subject.should_receive(:perform_command).with("dir2")
+    subject.command = "pull"
+
+    subject.run.should be_true
+  end
+
+  it "should return false if the command is not on the list" do
+    subject.command = "asdfaebaeba"
+    subject.run.should be_false
+  end
+end
+
+describe SSS, "#directories" do
+  it "should return the list of directories from the workspace" do
+    # spec/lib/support/workspace/
+    subject.workspace = File.join(File.dirname(__FILE__), '../support/workspace/')
+    subject.directories.should == Dir["#{subject.workspace}/*"].map { |dir| File.expand_path(dir) }
+  end
+
+  it "should raise an error if the workspace does not exist" do
+    # non-existant spec/lib/support/noworkspace/
+    subject.workspace = File.join(File.dirname(__FILE__), '../support/noworkspace/')
+    expect { subject.directories }.to raise_error
+  end
+end
+
+describe SSS, "#perform_command(directory)" do
+  subject { SSS.new("pull") }
+  let (:directory) { "/tmp/directory/" }
+
+  it "performs the appropriate SCM command for the directory" do
+    subject.should_receive(:scm_for).with(directory).and_return(SSS::GIT)
+    subject.should_receive(:scm_command_for).with(directory).and_return("asdf command")
+    subject.should_receive(:display).with("Performing #{subject.command} in #{subject.directory_string(directory)} (#{SSS::GIT})")
+    Open3.should_receive(:capture3).with("asdf command").and_return(["stdout", "stderr", "status"])
+    subject.should_receive(:display).with("stdout")
+    subject.should_receive(:display).with("stderr", STDERR)
+
+    subject.perform_command(directory)
+  end
+
+  it "should skip the directory if it has no available command" do
+    subject.should_receive(:scm_command_for).with(directory).and_return(nil)
+    subject.should_receive(:display).with("Skipping #{subject.directory_string(directory)}, no available command")
+    Open3.should_receive(:capture3).never
+
+    subject.perform_command(directory)
+  end
+end
+
+describe SSS, "#scm_command_for(directory)" do
+  subject { SSS.new("pull") }
+  let (:directory) { "/tmp/directory/"}
+
+  it "should return the command for the SCM of the directory" do
+    subject.should_receive(:scm_for).with(directory).and_return(SSS::GIT)
+    subject.scm_command_for(directory).should == "cd #{directory} && #{SSS::COMMANDS[subject.command][SSS::GIT]}"
+  end
+
+  it "should return nil if it does not recognize the SCM for the directory" do
+    subject.should_receive(:scm_for).with(directory).and_return(nil)
+    subject.scm_command_for(directory).should be_nil
+  end
+
+  it "should return nil if it does not recognize the command" do
+    subject.command = "asdfqwerty"
+    subject.scm_command_for(directory).should be_nil
+  end
+end
+
+describe SSS, "#scm_for(directory)" do
+  let(:workspace) { File.join(File.dirname(__FILE__), '../support/workspace/') }
+
+  it "should return Git if the directory contains a .git directory" do
+    subject.scm_for(File.join(workspace, "project1")).should == SSS::GIT
+  end
+
+  it "should return Mercurial if the directory contains a .hg directory" do
+    subject.scm_for(File.join(workspace, "project2")).should == SSS::MERCURIAL
+  end
+
+  it "should return Subversion if the directory contains a .svn directory" do
+    subject.scm_for(File.join(workspace, "project3")).should == SSS::SUBVERSION
+  end
+end
+
+describe SSS, "#display" do
+  it "should push to STDOUT" do
+    STDOUT.should_receive(:puts).with("asdf")
+    subject.display("asdf")
+  end
+
+  it "should push to STDERR if specified" do
+    STDERR.should_receive(:puts).with("qwerty")
+    subject.display("qwerty", STDERR)
+  end
+end
+
+describe SSS, "#embolden(string)" do
+  it "should wrap in bash bold characters" do
+    subject.embolden("asdf").should == "\033[1masdf\033[0m"
+  end
+end
+
+describe SSS, "#directory_string(directory)" do
+  it "should embolden and trim just the last directory of the directory path with a slash" do
+    subject.directory_string("/asdf/qwerty/aeiou/").should == subject.embolden("aeiou")
+  end
+
+  it "should embolden and trim just the last directory of the directory path without a slash" do
+    subject.directory_string("/asdf/qwerty/aeiou").should == subject.embolden("aeiou")
+  end
+end
+
+describe SSS, "#display_command" do
+  it "should output that it's performing the command" do
+    subject.command = "asdf"
+    subject.display_command.should == "Attempting to perform asdf"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'sss'
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    set_up_test_directories
+  end
+end
+
+def set_up_test_directories
+  system "mkdir -p spec/support/workspace/project1/.git"
+  system "mkdir -p spec/support/workspace/project2/.hg"
+  system "mkdir -p spec/support/workspace/project3/.svn"
+end

data/sss.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "sss/version"
+
+Gem::Specification.new do |s|
+  s.name        = "simple-scm"
+  s.version     = SSS::VERSION
+  s.authors     = ["Patrick Byrne"]
+  s.email       = ["patrick.byrne@tstmedia.com"]
+  s.homepage    = ""
+  s.summary     = %q{Quickly perform SCM (git/hg/svn) commands across your projects.}
+  s.description = %q{Command that performs SCM (git/hg/svn) commands in all projects in a directory.}
+
+  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_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'cucumber'
+  s.add_development_dependency 'aruba'
+  s.add_development_dependency 'rb-fsevent'
+  s.add_development_dependency 'growl_notify'
+  s.add_development_dependency 'guard'
+  s.add_development_dependency 'guard-cucumber'
+  s.add_development_dependency 'guard-rspec'
+
+  # s.add_runtime_dependency "rest-client"
+end

data/tmp/argv.rb

@@ -0,0 +1,2 @@
+puts ARGV.first
+puts ARGV.first.class

metadata

@@ -0,0 +1,176 @@
+--- !ruby/object:Gem::Specification
+name: simple-scm
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Patrick Byrne
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-03 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2151820340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151820340
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2151818260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151818260
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: &2151815600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151815600
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: &2151813760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151813760
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: &2151812820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151812820
+- !ruby/object:Gem::Dependency
+  name: growl_notify
+  requirement: &2151812160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151812160
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: &2151811660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151811660
+- !ruby/object:Gem::Dependency
+  name: guard-cucumber
+  requirement: &2151810960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151810960
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &2151809960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2151809960
+description: Command that performs SCM (git/hg/svn) commands in all projects in a
+  directory.
+email:
+- patrick.byrne@tstmedia.com
+executables:
+- sss
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- README.markdown
+- Rakefile
+- bin/sss
+- features/command.feature
+- features/help.feature
+- features/step_definitions/sss_steps.rb
+- features/support/env.rb
+- lib/sss.rb
+- lib/sss/version.rb
+- spec/lib/sss_spec.rb
+- spec/spec_helper.rb
+- sss.gemspec
+- tmp/argv.rb
+homepage: ''
+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'
+      segments:
+      - 0
+      hash: -1049271710808341764
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1049271710808341764
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Quickly perform SCM (git/hg/svn) commands across your projects.
+test_files:
+- features/command.feature
+- features/help.feature
+- features/step_definitions/sss_steps.rb
+- features/support/env.rb
+- spec/lib/sss_spec.rb
+- spec/spec_helper.rb