gta 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27c920a2a56f8e301489d77634ce463854a5ffa1
+  data.tar.gz: f548a008605b16f83c651681d97f70447cc3e80d
+SHA512:
+  metadata.gz: 25f6527c6ddc4a6a9165a62a87fe2d5857bf07a959889daa5055b2a780f16cade8384f8ab642c84ef03a2b029a5480872b9c59420d6bccbf325d4c3d8041844b
+  data.tar.gz: 76dc5ee7aebea7764d994cf3b53f4efac5f9d5ddd185c061fba665c90b70d87d20e7009f0959ce089aa3460f645138af61311f5c24b0e10f1eee8578ef74904f

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rvmrc

@@ -0,0 +1,6 @@
+rvm_install_on_use_flag=1
+rvm_trust_rvmrcs_flag=1
+rvm_gemset_create_on_use_flag=1
+
+rvm use 2.0.0@gta --create
+

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 socialchorus
+
+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/README.md

@@ -0,0 +1,42 @@
+# GTA - the Git Transit Authority
+
+GTA is a git-based deploy tool for moving code from stage to stage.
+
+Heroku has made git deploys an awesome standard. Mislav's git-deploy gem
+has made this ease of deploy a possibility for servers that are not
+Heroku too. Despite the easiness of a git deploy system managing a
+series of stages, ie. origin => ci => staging => production, takes some
+care and consideration. Additionally, hotfixing changes in the middle of
+the chain causes a reordering of commits and different push proceedures
+that can car reek havok.
+
+GTA reads git configuration from yml file that should be checked into
+source control, assuring the whole team is sharing configurations. There
+are easy methods for setting up git remotes, and moving code from stage
+to stage. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'gta'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gta
+
+## Usage
+
+Rake tasks are in progress; stay tuned.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/gta.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gta/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gta"
+  spec.version       = GTA::VERSION
+  spec.authors       = ["socialchorus", "Kane Baccigalupi"]
+  spec.email         = ["developers@socialchorus.com"]
+  spec.description   = %q{GTA: the Git Transit Authority - A git based deploy tool for moving code from stage to stage.}
+  spec.summary       = %q{GTA: the Git Transit Authority - A git based deploy tool for moving code from stage to stage.}
+  spec.homepage      = "http://github.com/socialchorus/gta"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/lib/gta.rb

@@ -0,0 +1,4 @@
+require "gta/version"
+require "gta/sh"
+require "gta/manager"
+require "gta/stage"

data/lib/gta/manager.rb

@@ -0,0 +1,37 @@
+module GTA
+  class Manager
+    attr_reader :config_path
+
+    def initialize(config_path = "#{Dir.pwd}/config/gta.yml")
+      @config_path = config_path
+    end
+
+    def config
+      @config ||= YAML.load(File.read(config_path))
+    end
+
+    def stages
+      @stages ||= config.map{ |name, opts| Stage.new(name, self, opts) }
+    end
+
+    def stage(name)
+      stages.detect{|s| s.name == name.to_s}
+    end
+
+    def stage!(name)
+      stage(name) || (raise ArgumentError.new("Stage #{name} not found"))
+    end
+
+    def push_to(name)
+      stage!(name).push
+    end
+
+    def fetch
+      stages.each(&:fetch)
+    end
+
+    def setup
+      stages.each(&:add_remote)
+    end
+  end
+end

data/lib/gta/remote_db.rb

@@ -0,0 +1,22 @@
+module Remote
+  class DB
+    attr_reader :env, :app
+
+    def initialize(env, app)
+      raise "Environment not allowed" unless ['qa', 'staging'].include?(env)
+      @env = env
+      @app = app
+    end
+
+    def reset
+      puts "==> RESETTING the #{app}-#{env} db..."
+      `heroku pg:reset DATABASE --app #{app}-#{env} --confirm #{app}-#{env}`
+    end
+
+    def restore
+      puts "==> RESTORING #{app}-#{env} from latest backup..."
+      `heroku pgbackups:restore DATABASE_URL "#{DB::Config.db_url(app)}" --app #{app}-#{env} --confirm #{app}-#{env}`
+    end
+  end
+end
+

data/lib/gta/sh.rb

@@ -0,0 +1,7 @@
+module GTA
+  module Sh
+    def sh(command)
+      system(command)
+    end
+  end
+end

data/lib/gta/stage.rb

@@ -0,0 +1,64 @@
+module GTA
+  class Stage
+    include Sh
+
+    attr_reader :name, :repository, :source_name, :branch, :tag, :manager
+
+    def initialize(name, manager, opts)
+      @name = name
+      @manager = manager
+      @repository =   opts['repository']
+      @source_name =  opts['source']
+      @branch =       opts['branch'] || 'master'
+      @tag =          opts['tag']
+    end
+
+    def stages
+      manager.stages
+    end
+
+    def source
+      @source ||= manager.stage!(source_name)
+    end
+
+    def add_remote
+      raise "no name defined for #{self}" unless name
+      raise "no repository defined for #{name}" unless repository
+
+      sh "git remote add #{name} #{repository}"
+    end
+
+    def push(s=source, forced=nil)
+      sh push_command(source_from(s), forced)
+    end
+
+    def force_push(s=source)
+      sh push_command(source_from(s), :force)
+    end
+
+    def fetch
+      sh "git fetch #{name}"
+    end
+
+    def ==(other)
+      name == other.name &&
+        branch == other.branch &&
+        tag == other.tag
+    end
+
+    # -----------
+
+    def source_from(s)
+      s.respond_to?(:source_ref) ? s.source_ref : s
+    end
+
+    def source_ref
+      tag || "#{name}/#{branch}"
+    end
+
+    def push_command(source_ref, forced=nil)
+      force = forced == :force ? " -f" : ""
+      "git push#{force} #{name} #{source_ref}:#{branch}"
+    end
+  end
+end

data/lib/gta/version.rb

@@ -0,0 +1,3 @@
+module GTA
+  VERSION = "0.0.1"
+end

data/spec/fixtures/config/gta.yml

@@ -0,0 +1,15 @@
+ci:
+  repository: git@github.com:socialchorus/activator.git
+
+staging:
+  source_stage: ci
+  tag: staging/*
+  repository: git@heroku.com:activator-staging.git
+
+qa:
+  source_stage: staging
+  repository: git@heroku.com:activator-qa.git
+
+production:
+  source_stage: qa
+  repository: git@heroku.com:activator-production.git

data/spec/manager_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+describe GTA::Manager do
+  let(:config_path) { File.dirname(__FILE__) + "/fixtures/config/gta.yml" }
+  let(:manager) { GTA::Manager.new(config_path) }
+
+  it "builds stages for each entry in the yml" do
+    manager.stages.size.should == 4
+    manager.stages.map(&:class).uniq.should == [GTA::Stage]
+  end
+
+  describe '#fetch' do
+    it "loops through each stage and calls fetch" do
+      manager.stages.each do |stage|
+        stage.should_receive(:fetch)
+      end
+      manager.fetch
+    end
+  end
+
+  describe '#stage' do
+    it "finds the right stage by name" do
+      manager.stage('qa').should be_a(GTA::Stage)
+      manager.stage(:qa).name.should == 'qa'
+    end
+  end
+
+  describe '#stage!' do
+    it 'raises an error if it cannot find the right stage' do
+      expect {
+        manager.stage!(:foo)
+      }.to raise_error
+    end
+
+    it 'finds and return the right stage otherwise' do
+      manager.stage!(:ci).should be_a(GTA::Stage)
+    end
+  end
+
+  describe '#push_to' do
+    it "tells the right stage to push itself" do
+      manager.stage(:qa).should_receive(:push)
+      manager.push_to(:qa)
+    end
+  end
+
+  describe '#setup' do
+    it 'adds a remote for each stage' do
+      manager.stages.each do |stage|
+        stage.should_receive(:add_remote)
+      end
+      manager.setup
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+here = File.dirname(__FILE__)
+
+require "#{here}/../lib/gta"
+Dir["#{here}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.color_enabled = true
+end

data/spec/stage_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+describe GTA::Stage do
+  let(:tag) { nil }
+  let(:branch) { nil }
+  let(:repository) { "git@github.com:socialchorus/activator.git" }
+  let(:opts) {
+    {
+      "source" => "ci",
+      "repository" => repository,
+      "tag" => tag,
+      "branch" => branch
+    }
+  }
+  let(:stage)  { GTA::Stage.new('staging', manager, opts) }
+  let(:source) { GTA::Stage.new('ci', manager, opts.merge('source' => 'origin')) }
+  let(:manager) { double('manager') }
+
+  before do
+    manager.stub(:stage!).and_return(source)
+    stage.stub(:sh)
+  end
+
+  describe 'initalization' do
+    it "has a name" do
+      stage.name.should == 'staging'
+    end
+
+    it "stores the repository" do
+      stage.repository.should == 'git@github.com:socialchorus/activator.git'
+    end
+
+    it "stores the intended source stage" do
+      stage.source_name.should == 'ci'
+    end
+
+    it "creates a default branch" do
+      stage.branch.should == 'master'
+    end
+  end
+
+  describe '#fetch' do
+    it "calls the right git command" do
+      stage.should_receive(:sh).with("git fetch staging")
+      stage.fetch
+    end
+  end
+
+  describe '#source' do
+    it "gets the source based on the source name" do
+      stage.source.should == source
+    end
+  end
+
+  describe '#add_remote' do
+    context 'when the repository is nil' do
+      let(:repository) { nil }
+
+      it "should raise an error" do
+        expect {
+          stage.add_remote
+        }.to raise_error
+      end
+    end
+
+    context 'when all is good' do
+      it "should call #sh with the right git command if there is a repository" do
+        stage.should_receive(:sh).with("git remote add staging #{repository}")
+        stage.add_remote
+      end
+    end
+  end
+
+  describe '#push' do
+    # private ... delete tests after #push fully tested
+    describe '#push_command' do
+      context "without a tag and branch is default" do
+        it "should be a string that allows the interpolation of the source" do
+          stage.push_command('source').should == 'git push staging source:master'
+        end
+      end
+
+      context "with an alternate branch" do
+        let(:branch) { 'alt' }
+
+        it "should push to the other branch instead" do
+          stage.push_command('source').should == 'git push staging source:alt'
+        end
+      end
+    end
+
+    context "when using internally defined source object" do
+      it "sends the right git shell command" do
+        stage.should_receive(:sh).with("git push staging ci/master:master")
+        stage.push
+      end
+    end
+
+    context "when passed an alternative source object" do
+      let(:origin) { GTA::Stage.new('origin', manager, opts.merge('branch' => 'sendit')) }
+
+      it "sends the right git shell command" do
+        stage.should_receive(:sh).with("git push staging origin/sendit:master")
+        stage.push(origin)
+      end
+    end
+
+    context "when passed a string identifying the source (and an alt branch)" do
+      let(:branch) { 'alt_branch' }
+
+      it "sends the right git shell command" do
+        stage.should_receive(:sh).with("git push staging foo:alt_branch")
+        stage.push('foo')
+      end
+    end
+
+    context "when the source has a tag" do
+      let(:tag) { 'my-tag' }
+
+      it "uses the tag as the source reference" do
+        stage.should_receive(:sh).with("git push staging my-tag:master")
+        stage.push
+      end
+    end
+
+    context "force push" do
+      it "adds the -f flag to the git command" do
+        stage.should_receive(:sh).with("git push -f staging ci/master:master")
+        stage.force_push
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: gta
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- socialchorus
+- Kane Baccigalupi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'GTA: the Git Transit Authority - A git based deploy tool for moving
+  code from stage to stage.'
+email:
+- developers@socialchorus.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- gta.gemspec
+- lib/gta.rb
+- lib/gta/manager.rb
+- lib/gta/remote_db.rb
+- lib/gta/sh.rb
+- lib/gta/stage.rb
+- lib/gta/version.rb
+- spec/fixtures/config/gta.yml
+- spec/manager_spec.rb
+- spec/spec_helper.rb
+- spec/stage_spec.rb
+homepage: http://github.com/socialchorus/gta
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: 'GTA: the Git Transit Authority - A git based deploy tool for moving code
+  from stage to stage.'
+test_files:
+- spec/fixtures/config/gta.yml
+- spec/manager_spec.rb
+- spec/spec_helper.rb
+- spec/stage_spec.rb