build_promotion_tool 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 139604ea202fbd5bb530daf19d43f7c3e2a71b8d
+  data.tar.gz: e6363b9f29a86fc0319024c85c42a3306f091824
+SHA512:
+  metadata.gz: f044c063bd5b9c59d47d889bd4bcfcba5dccd7b63c5979f582e307ed5b9f123d256abbee5301b75245d5ee5747321af9f27bfd522fb13d10a9da4df205c9704e
+  data.tar.gz: 68d5e39e0f435a0b37263f0217169a1045f0d7ac2ceb375ad38cb08af4261becd09a3eaae019d936ed917b1b3bb05a2e8140f89f9548fc6d87a9917ee19d6cf7

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.14.3

data/Gemfile

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

data/README.md

@@ -0,0 +1,54 @@
+# BuildPromotionTool
+
+The purpose of this tool is to automate semantic versioning updates to git tags. It will update the tag version number depending on the type of tag to be applied. The types of tags which can be applied are outlined in the config.yml file. A remote repository must exist in order to fetch all tags and to push new tags to the remote repository.
+
+To apply the **first deploy tag (a develop or 'dev' tag)** , a search for all previously applied develop tags is conducted on the repository (local and remote). The tag version number is incremented, depending on the most recent develop tag version number, and on the type of version update selected (major, minor, or patch). Two develop tags cannot be applied to the same commit
+
+To apply a **later tag type (such as stage or test)**, a tag of the preceding tag type must have been applied to the commit e.g. to apply a 'test' tag, a 'dev' tag must exist on the commit. The tag number applied will match that of the preceding tag type.
+
+## Installation
+
+Add the following line to your application's Gemfile:
+
+```ruby
+gem 'build_promotion_tool'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it as:
+
+    $ gem install build_promotion_tool
+
+## Usage
+
+__First Deploy Step: Dev Tag__
+- Run:
+```
+    $ deploy dev
+```
+
+- If no prior develop tag has been assigned, the user will be asked whether they would like to assign the first develop tag. If they select yes, first tag 'dev-v0.0.1' is applied.
+- If previous develop tags have been applied, the latest develop tag is displayed and the user is asked whether they would like to do a _major, minor, or patch_ update. See: [Semantic Versioning](http://semver.org).
+- The user inputs their choice, the user is shown the new tag (e.g. dev-v0.1.2) and is asked to confirm their choice and apply the tag.
+- When the user selects yes to updating the tag, the tag version number is updated.
+- The tag is then added to the repository and pushed to the remote.
+
+__Later Deploy Steps: E.g. Test, Stage Tags__
+- To see the list of tags which can be applied, the config.yml file should be reviewed
+- For example run:
+```
+    $ deploy test
+```
+- A tag can only be applied, if a tag of the preceding type has been applied. E.g. to apply a test tag, a develop tag must exist for this commit; to apply a stage tag, a test tag must exist for this commit. If it does not, an error message is displayed.
+- If the preceding tag type exists for this commit, the user is shown the new tag (e.g. test-v0.1.2) and asked if they would like to apply it.
+- If the user selects yes, then the tag is applied
+- The tag is then added to the repository and pushed to the remote.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "build_promotion_tool"
+
+require "irb"
+IRB.start(__FILE__)

data/bin/deploy

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/build_promotion_tool'
+
+BuildPromotionTool::Deploy.new

data/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/build_promotion_tool.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'build_promotion_tool/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "build_promotion_tool"
+  spec.version       = BuildPromotionTool::VERSION
+  spec.authors       = ["Emily Woods"]
+  spec.email         = ["emily.woods@theappbusiness.com"]
+
+  spec.summary       = %q{Build promotion tool for updating and applying git tags}
+  spec.homepage      = "https://github.com/KITSTABEmilyWoods/build-promotion-gem"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.executables   = ["deploy"]
+  spec.require_paths = ["."]
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.license       = 'MIT'
+end

data/lib/build_promotion_tool/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/lib/build_promotion_tool/comparator/version.rb

@@ -0,0 +1,20 @@
+class Version
+  include Comparable
+  attr_accessor :major, :minor, :patch
+
+  def initialize(version_string)
+    array = version_string.split(".")
+    self.major = array[0].to_i
+    self.minor = array[1].to_i
+    self.patch = array[2].to_i
+  end
+
+  def ==(other)
+    other.class == self.class && other.major == self.major && other.minor == self.minor && other.patch == self.patch
+  end
+
+  def <=>(other)
+    return nil if self.class != other.class
+    [self.major, self.minor, self.patch] <=> [other.major, other.minor, other.patch]
+  end
+end

data/lib/build_promotion_tool/config.rb

@@ -0,0 +1,9 @@
+require 'yaml'
+filepath = File.join(File.dirname(__FILE__), "config.yml")
+CONFIG = YAML.load_file(filepath)
+
+module Config
+  def self.tag_types
+    CONFIG.fetch('tags')
+  end
+end

data/lib/build_promotion_tool/config.yml

@@ -0,0 +1,8 @@
+tags:
+
+  first_deploy_step: dev
+
+  all_tags:
+    - dev
+    - test
+    - stage

data/lib/build_promotion_tool/controller/deploy_controller.rb

@@ -0,0 +1,88 @@
+require_relative '../generator/develop_tag_generator'
+require_relative '../generator/other_tag_generator'
+require_relative '../helper/git_helper'
+require_relative '../helper/user_comms_helper'
+
+class DeployController
+
+  attr_accessor :environ, :tag_types, :git_helper, :user_comms, :develop_tag_generator, :other_tag_generator
+
+  def initialize(environ, git_helper, user_comms, develop_tag_generator, other_tag_generator, tag_types)
+    self.environ = environ
+    self.tag_types = tag_types
+    self.git_helper = git_helper
+    self.user_comms = user_comms
+    self.develop_tag_generator = develop_tag_generator
+    self.other_tag_generator = other_tag_generator
+  end
+
+  def environment_choice
+    environ.downcase
+    @tags_for_this_commit = git_helper.get_tags_for_this_commit
+    dev_tag = tag_types['first_deploy_step']
+    all_tags = tag_types['all_tags']
+
+    case environ
+    when dev_tag
+      if other_tag_generator.tag_exists?(dev_tag, @tags_for_this_commit)
+        @user_comms.error_commit_has_dev_tag
+        return
+      end
+
+      unless develop_tag_generator.develop_tag_exists?
+        @user_comms.tell_user_no_develop_tags
+        apply_tag(develop_tag_generator.first_tag)
+      else
+        to_increment = increment_choice
+        next_tag = develop_tag_generator.next_develop_tag(to_increment)
+        apply_tag(next_tag)
+      end
+
+    else
+      if all_tags.include? environ
+        last_tag_index = all_tags.index(environ) - 1
+        last_tag_type = all_tags[last_tag_index]
+        select_next_tag(last_tag_type, environ)
+      else
+        @user_comms.error_incorrect_environ
+        return
+      end
+
+    end
+    @user_comms.say_thank_you
+  end
+
+  private
+
+  def select_next_tag(last_tag_type, next_tag_type)
+    if !other_tag_generator.tag_exists?(last_tag_type, @tags_for_this_commit)
+      @user_comms.tell_user_no_tag(last_tag_type)
+    elsif other_tag_generator.tag_exists?(next_tag_type, @tags_for_this_commit)
+      @user_comms.tell_user_already_a_tag(next_tag_type)
+    else
+      apply_tag(other_tag_generator.next_tag(last_tag_type, next_tag_type, @tags_for_this_commit))
+    end
+  end
+
+  def increment_choice
+    loop do
+      @user_comms.ask_increment_type
+      @to_increment = @user_comms.user_increment_choice
+      break if ['major', 'minor', 'patch'].include? @to_increment
+    end
+    @to_increment
+  end
+
+  def apply_tag(next_tag)
+    @user_comms.ask_permissison_to_apply(next_tag)
+    loop do
+      answer = @user_comms.user_reply_y_or_n
+      if answer == "y"
+        git_helper.apply_tag(next_tag)
+        git_helper.push_tag_to_remote(next_tag)
+      end
+      @user_comms.say_no_tag_applied if answer =="n"
+      break if ['y', 'n'].include? answer
+    end
+  end
+end

data/lib/build_promotion_tool/generator/develop_tag_generator.rb

@@ -0,0 +1,36 @@
+require_relative '../comparator/version'
+
+class DevelopTagGenerator
+  def initialize(tags)
+    @tags = tags
+  end
+
+  def first_tag
+    "dev-v0.0.1"
+  end
+
+  def next_develop_tag(to_increment)
+    last_version = biggest_version
+    case to_increment
+    when "major"
+      "dev-v#{last_version.major + 1}.0.0"
+    when "minor"
+      "dev-v#{last_version.major}.#{last_version.minor + 1}.0"
+    when "patch"
+      "dev-v#{last_version.major}.#{last_version.minor}.#{last_version.patch + 1}"
+    end
+  end
+
+  def develop_tag_exists?
+    @tags.any? { |tag| /^dev-v\d+.\d+.\d*$/ =~ tag }
+  end
+
+  private
+
+  def biggest_version
+    @tags.select { |tag| /^dev-v\d+.\d+.\d*$/ =~ tag }
+         .map { |tag| tag.split("-v")[1] }
+         .map { |version_string| Version.new(version_string) }
+         .max
+  end
+end

data/lib/build_promotion_tool/generator/other_tag_generator.rb

@@ -0,0 +1,16 @@
+require_relative '../comparator/version'
+
+class OtherTagGenerator
+
+  def tag_exists?(check_tag_type, tags_for_this_commit)
+    tags_for_this_commit.any? {|tag| /^#{check_tag_type}-v\d+.\d+.\d*$/ =~ tag}
+  end
+
+  def next_tag(previous_tag_type, next_tag_type, tags_for_this_commit)
+    tags_for_this_commit.select {|tag| /^#{previous_tag_type}-v\d+.\d+.\d*$/ =~ tag}
+                        .map {|tag| tag.sub(previous_tag_type, next_tag_type)}
+                        .map {|tag| tag.sub(/\n/, "")}
+                        .first
+  end
+
+end

data/lib/build_promotion_tool/helper/git_helper.rb

@@ -0,0 +1,23 @@
+class GitHelper
+
+  def fetch_tags
+    `git fetch --tags`
+  end
+
+  def all_tags
+    `git tag -l`.lines
+  end
+
+  def get_tags_for_this_commit
+    `git tag --points-at HEAD`.lines
+  end
+
+  def apply_tag(tag)
+    `git tag #{tag}`
+  end
+
+  def push_tag_to_remote(tag)
+    `git push origin #{tag}`
+  end
+
+end

data/lib/build_promotion_tool/helper/user_comms_helper.rb

@@ -0,0 +1,76 @@
+require_relative '../config'
+
+class UserCommsHelper
+  all_tags = Config.tag_types['all_tags']
+  ERROR_INITIALISE_WITH_STRING_IO = "Initialise with StringIO objects"
+  TELL_USER_NO_DEVELOP_TAGS = "No develop tags exist for this repository"
+  ASK_USER_INCREMENT_TYPE = "Would you like to do a major, minor, or patch increment?"
+  ERROR_SELECT_ACCEPTED_INCREMENT_TYPE = "Error: please select major, minor or patch update"
+  ERROR_NEXT_TAG_NOT_ASSIGNED = "Next tag has not been assigned"
+  ERROR_SELECT_Y_OR_N = "Error: please select y/n"
+  ERROR_INCORRECT_ENVIRON = "Error: please select to apply one of the following tags: #{all_tags}\
+                              \n e.g. ruby deploy.rb #{all_tags.first} \n"
+  ERROR_COMMIT_HAS_DEV_TAG = "Error: a develop tag has already been applied to this commit"
+
+  def initialize(stdout, stdin)
+    @stdout = stdout if stdout.respond_to?(:puts)
+    @stdin = stdin if stdin.respond_to?(:gets)
+    raise ERROR_INITIALISE_WITH_STRING_IO if @stdout.nil? || @stdin.nil?
+  end
+
+  def tell_user_no_develop_tags
+    @stdout.puts TELL_USER_NO_DEVELOP_TAGS
+  end
+
+  def ask_increment_type
+    @stdout.puts ASK_USER_INCREMENT_TYPE
+  end
+
+  def user_increment_choice
+    increment_choice = @stdin.gets.chomp().downcase
+    if increment_choice == "major" || increment_choice == "minor" || increment_choice == "patch"
+      return increment_choice
+    else
+      @stdout.puts ERROR_SELECT_ACCEPTED_INCREMENT_TYPE
+    end
+  end
+
+  def ask_permissison_to_apply(next_tag)
+    raise ERROR_NEXT_TAG_NOT_ASSIGNED if next_tag.nil?
+    @stdout.puts "Do you want to apply tag: #{next_tag}? - y/n"
+  end
+
+  def user_reply_y_or_n
+    user_choice = @stdin.gets.chomp().downcase
+    if user_choice == "y" || user_choice == "n"
+      return user_choice
+    else
+      @stdout.puts ERROR_SELECT_Y_OR_N
+    end
+  end
+
+  def say_thank_you
+    @stdout.puts "Thank you!"
+  end
+
+  def say_no_tag_applied
+    @stdout.puts "No tag applied"
+  end
+
+  def error_incorrect_environ
+    @stdout.puts ERROR_INCORRECT_ENVIRON
+  end
+
+  def error_commit_has_dev_tag
+    @stdout.puts ERROR_COMMIT_HAS_DEV_TAG
+  end
+
+  def tell_user_no_tag(tag_type)
+    @stdout.puts "Error: there are no previous #{tag_type} tags on this commit"
+  end
+
+  def tell_user_already_a_tag(tag_type)
+    @stdout.puts "Error: There is already a #{tag_type} tag on this commit"
+  end
+
+end

data/lib/build_promotion_tool/spec/deploy_spec.rb

@@ -0,0 +1,180 @@
+require 'rspec'
+require_relative '../controller/deploy_controller.rb'
+
+describe 'DeployController' do
+
+  let(:develop_tag_generator) {spy('develop_tag_generator')}
+  let(:git_helper) { spy('git_helper') }
+  let(:user_comms) { spy('user_comms') }
+  let(:other_tag_generator) { spy('other_tag_generator') }
+  let(:tag_types) { { "first_deploy_step" => 'dev', "all_tags" => ['dev', 'test', 'stage'] } }
+
+  describe 'environment_choice' do
+
+    subject(:deploy) {DeployController.new('dev', git_helper, user_comms, develop_tag_generator, other_tag_generator,tag_types)}
+
+    before(:each) do
+      allow(git_helper).to receive(:get_tags_for_this_commit)
+      tag_types['first_deploy_step']
+    end
+
+    describe 'dev_tag' do
+      context 'when the user request to apply a new develop tag with patch increment' do
+      before(:each) do
+        @dev_tag = 'dev-v0.1.2'
+        allow(other_tag_generator).to receive(:tag_exists?).and_return(false)
+        allow(develop_tag_generator).to receive(:develop_tag_exists?).and_return(true)
+
+        allow(user_comms).to receive(:ask_increment_type)
+        allow(user_comms).to receive(:user_increment_choice).and_return('patch')
+        allow(develop_tag_generator).to receive(:next_develop_tag).and_return(@dev_tag)
+        allow(user_comms).to receive(:ask_permissison_to_apply)
+      end
+
+      context 'when they say yes to applying the tag' do
+        before(:each) do
+          allow(user_comms).to receive(:user_reply_y_or_n).and_return('y')
+        end
+
+        it "asks the user's perimission to apply tag dev-v0.1.2" do
+          deploy.environment_choice
+          expect(user_comms).to have_received(:ask_permissison_to_apply).with(@dev_tag)
+        end
+
+        it 'receives the next tag to apply' do
+          deploy.environment_choice
+          expect(git_helper).to have_received(:apply_tag).with(@dev_tag)
+        end
+
+        it 'pushes next tag to the remote' do
+          deploy.environment_choice
+          expect(git_helper).to have_received(:push_tag_to_remote).with(@dev_tag)
+        end
+
+        it "says 'thank you' to the user" do
+          deploy.environment_choice
+          expect(user_comms).to have_received(:say_thank_you)
+        end
+      end
+
+      context 'when they say no to applying the tag' do
+        before(:each) do
+          allow(user_comms).to receive(:user_reply_y_or_n).and_return('n')
+        end
+
+        it'says that no tag has been applied' do
+          deploy.environment_choice
+          expect(user_comms).to have_received(:say_no_tag_applied)
+        end
+
+        it "says 'thank you' to the user" do
+          deploy.environment_choice
+          expect(user_comms).to have_received(:say_thank_you)
+        end
+      end
+
+      context 'when there is already a develop tag on the commit'do
+        before(:each) do
+          allow(other_tag_generator).to receive(:tag_exists?).and_return(true)
+        end
+
+        it "tells the user that there is already at dev tag on the commit" do
+          deploy.environment_choice
+          expect(user_comms).to have_received(:error_commit_has_dev_tag)
+        end
+      end
+
+        context 'when there are no tags on the repository'do
+          before(:each) do
+            @dev_tag = 'dev-v0.0.1'
+            allow(other_tag_generator).to receive(:tag_exists?).and_return(false)
+            allow(develop_tag_generator).to receive(:develop_tag_exists?).and_return(false)
+
+            allow(user_comms).to receive(:tell_user_no_develop_tags)
+            allow(develop_tag_generator).to receive(:first_tag).and_return(@dev_tag)
+
+            allow(user_comms).to receive(:ask_permissison_to_apply)
+            allow(user_comms).to receive(:user_reply_y_or_n).and_return('y')
+          end
+
+          it "asks the user's permission to apply the first tag" do
+            deploy.environment_choice
+            expect(user_comms).to have_received(:ask_permissison_to_apply).with(@dev_tag)
+          end
+
+          it "applies the first tag" do
+            deploy.environment_choice
+            expect(git_helper).to have_received(:apply_tag).with(@dev_tag)
+          end
+
+          it "pushes the first tag" do
+            deploy.environment_choice
+            expect(git_helper).to have_received(:push_tag_to_remote).with(@dev_tag)
+          end
+        end
+      end
+    end
+
+    describe 'else' do
+      before(:each) do
+        @tags_for_this_commit = ['dev-v0.1.1', 'dev-v0.2.0']
+        allow(git_helper).to receive(:get_tags_for_this_commit).and_return(@tags_for_this_commit)
+        @all_tags = tag_types['all_tags']
+      end
+
+      context ' when the user would like to apply a test tag'do
+
+      subject(:deploy) {DeployController.new('test', git_helper, user_comms, develop_tag_generator, other_tag_generator, tag_types)}
+
+      context 'when there is a develop tag, dev-v0.1.5 on the commit' do
+        before(:each) do
+          @test_tag = 'test-v0.1.5'
+
+          allow(@all_tags).to receive(:include?).and_return(true)
+          allow(@all_tags).to receive(:index).and_return(1)
+
+          allow(other_tag_generator).to receive(:tag_exists?).with('dev', @tags_for_this_commit).and_return(true)
+          allow(other_tag_generator).to receive(:tag_exists?).with('test', @tags_for_this_commit).and_return(false)
+
+          allow(other_tag_generator).to receive(:next_tag).and_return(@test_tag)
+
+          allow(user_comms).to receive(:ask_permissison_to_apply)
+          allow(user_comms).to receive(:user_reply_y_or_n).and_return('y')
+        end
+
+        context 'when the user says yes to applying the next tag' do
+          before(:each) do
+            allow(user_comms).to receive(:user_reply_y_or_n).and_return('y')
+          end
+
+          it 'asks permission to apply test tag, test-v0.1.5' do
+            deploy.environment_choice
+            expect(user_comms).to have_received(:ask_permissison_to_apply).with(@test_tag)
+          end
+
+          it 'applies a test tag, test-v0.1.5' do
+            deploy.environment_choice
+            expect(git_helper).to have_received(:push_tag_to_remote).with(@test_tag)
+          end
+        end
+
+        context 'when the user says no to applying the next tag' do
+          before(:each) do
+            allow(user_comms).to receive(:user_reply_y_or_n).and_return('n')
+          end
+
+          it 'asks permission to apply test tag, test-v0.1.5' do
+            deploy.environment_choice
+            expect(user_comms).to have_received(:ask_permissison_to_apply).with(@test_tag)
+          end
+
+          it 'says no tag has been applied' do
+            deploy.environment_choice
+            expect(user_comms).to have_received(:say_no_tag_applied)
+          end
+        end
+        end
+      end
+    end
+  end
+end

data/lib/build_promotion_tool/spec/develop_spec.rb

@@ -0,0 +1,81 @@
+require 'rspec'
+require_relative '../generator/develop_tag_generator'
+
+describe 'DevelopTagGenerator' do
+  describe 'develop_tag_exists' do
+    context 'When there are no tags' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new([]) }
+
+      it 'says that there are no develop tags' do
+        expect(develop_tag_generator.develop_tag_exists?).to eql(false)
+      end
+    end
+
+    context 'When there is a develop tag' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new(['dev-v0.1.1']) }
+
+      it 'says there is a develop tag' do
+        expect(develop_tag_generator.develop_tag_exists?).to eql(true)
+      end
+    end
+
+    context 'When there is a tag kind of like dev-v0.1.1' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new(['dev-v0.1.1fjasjafsjaf']) }
+
+      it "says there isn't a develop tag" do
+        expect(develop_tag_generator.develop_tag_exists?).to eql(false)
+      end
+    end
+
+    context 'When there is a test tag' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new(['test-v0.1.1']) }
+
+      it "says there isn't a develop tag" do
+        expect(develop_tag_generator.develop_tag_exists?).to eql(false)
+      end
+    end
+
+    context 'When there are multiple tags and one develop tag' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new(['test-v0.1.1', 'stage-v0.0.1', 'hello', 'dev-v0.0.1']) }
+
+      it 'says there is a develop tag' do
+        expect(develop_tag_generator.develop_tag_exists?).to eql(true)
+      end
+    end
+  end
+
+  describe 'first_tag' do
+    subject(:develop_tag_generator) { DevelopTagGenerator.new([]) }
+
+    context 'When the first develop tag is required' do
+      it 'says the first develop tag is dev-v0.0.1' do
+        expect(develop_tag_generator.first_tag).to match('dev-v0.0.1')
+      end
+
+      it 'says the first develop tag is not blank' do
+        expect(develop_tag_generator.first_tag).not_to match(" ")
+      end
+    end
+  end
+
+  describe 'next_develop_tag' do
+    context 'When there are multiple tags' do
+      subject(:develop_tag_generator) { DevelopTagGenerator.new(['hello', 'test-v0.0.1', 'dev-v0.0.1', 'dev-v1.1.1', 'dev-v0.0.1']) }
+
+      it 'returns the next version for major update' do
+        next_tag = develop_tag_generator.next_develop_tag("major")
+        expect(next_tag).to eq("dev-v2.0.0")
+      end
+
+      it 'returns the next version for minor update' do
+        next_tag = develop_tag_generator.next_develop_tag("minor")
+        expect(next_tag).to eq("dev-v1.2.0")
+      end
+
+      it 'returns the next version for patch update' do
+        next_tag = develop_tag_generator.next_develop_tag("patch")
+        expect(next_tag).to eq("dev-v1.1.2")
+      end
+    end
+  end
+end

data/lib/build_promotion_tool/spec/other_tag_spec.rb

@@ -0,0 +1,84 @@
+require 'rspec'
+require_relative '../generator/other_tag_generator'
+
+describe 'OtherTagGenerator' do
+  subject(:other_tag_generator) { OtherTagGenerator.new }
+
+  describe 'tag_exists?' do
+    before(:each) do
+      @check_tag_type = 'dev'
+    end
+
+    context 'when there are no develop tags on the commit but there are other tags' do
+      it 'says there are no develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['test-v1.1.1', 'test-v1.2.1'])).to eql(false)
+      end
+    end
+
+    context 'when there are no tags on the commit' do
+      it 'says there are no develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, [])).to eql(false)
+      end
+    end
+
+    context 'when there is a develop tag on the commit' do
+      it 'says there is a develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['dev-v0.1.1'])).to eql(true)
+      end
+    end
+
+    context 'when there is both a develop and test tag on the commit' do
+      it 'says there is a develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['dev-v0.1.1', 'test-v0.1.1'])).to eql(true)
+      end
+    end
+
+    context 'when there is a tag kind of like deveop' do
+      it 'says there is a develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['dev-v0.1.1adljalal'])).to eql(false)
+      end
+    end
+
+    context 'when there is a different tag type' do
+      it 'says there is a develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['hello'])).to eql(false)
+      end
+    end
+
+    context 'when there are more than one dev tags' do
+      it 'says there is a develop tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['dev-v0.1.1', 'dev-v0.1.2'])).to eql(true)
+      end
+    end
+
+    context 'when there is already a test tag' do
+      before(:each) do
+        @check_tag_type = 'test'
+      end
+
+      it 'says there is a test tag' do
+        expect(other_tag_generator.tag_exists?(@check_tag_type, ['test-v0.1.1'])).to eql(true)
+      end
+    end
+  end
+
+  describe 'next_tag' do
+    before(:each) do
+      @previous_tag_type = 'dev'
+      @next_tag_type  = 'test'
+    end
+
+    context 'when there is a develop tag: dev-v0.1.1' do
+      it 'returns a test tag: test-v0.1.1' do
+        expect(other_tag_generator.next_tag(@previous_tag_type, @next_tag_type, ['dev-v0.1.1'])).to eql('test-v0.1.1')
+      end
+    end
+
+    context 'when there are more than one dev tags' do
+      it 'returns the first' do
+        expect(other_tag_generator.next_tag(@previous_tag_type, @next_tag_type,['dev-v0.1.1', 'dev-v0.1.2', 'dev-v0.2.1'])).to eql('test-v0.1.1')
+      end
+    end
+
+  end
+end

data/lib/build_promotion_tool/spec/user_comms_spec.rb

@@ -0,0 +1,145 @@
+require 'rspec'
+require_relative '../helper/user_comms_helper.rb'
+
+describe 'UserCommsHelper' do
+  let(:stdout) {spy('STDOUT')}
+  let(:stdin) {spy('STDIN')}
+
+  describe 'initialize' do
+    context 'when all class arguments received are null' do
+      it 'raises an error' do
+        expect { UserCommsHelper.new(nil, nil) }.to raise_error.with_message(UserCommsHelper::ERROR_INITIALISE_WITH_STRING_IO)
+      end
+    end
+
+    context 'when STDOUT is null but STDIN is not' do
+      it 'raises an error' do
+        expect { UserCommsHelper.new(nil, stdin) }.to raise_error.with_message(UserCommsHelper::ERROR_INITIALISE_WITH_STRING_IO)
+      end
+    end
+
+    context 'when STDIN is null but STDOUT is not' do
+      it 'raises an error' do
+        expect { UserCommsHelper.new(stdout, nil) }.to raise_error.with_message(UserCommsHelper::ERROR_INITIALISE_WITH_STRING_IO)
+      end
+    end
+  end
+
+  subject(:user_comms) { UserCommsHelper.new(stdout, stdin) }
+
+  describe 'tell_user_no_develop_tags' do
+    context 'when there are no develop tags in the repository' do
+      it 'outputs a response that there are no develop tags' do
+        user_comms.tell_user_no_develop_tags
+        expect(stdout).to have_received(:puts).with(UserCommsHelper::TELL_USER_NO_DEVELOP_TAGS)
+      end
+    end
+
+    describe 'ask_user_to_increment' do
+      context 'when the user is asked to select an increment choice' do
+        it "outputs 'major, minor, or patch?' to the console" do
+          user_comms.ask_increment_type
+          expect(stdout).to have_received(:puts).with(UserCommsHelper::ASK_USER_INCREMENT_TYPE)
+        end
+      end
+    end
+
+    describe 'user_increment_choice' do
+      before(:each) do
+        allow(stdin).to receive(:gets).and_return("major")
+      end
+
+      context 'when the user inputs their increment choice as major' do
+        it "should accept the user's input as 'major'" do
+          expect(user_comms.user_increment_choice).to eq("major")
+        end
+
+        it "should not return minor as a response" do
+          expect(user_comms.user_increment_choice).not_to eql("minor")
+        end
+      end
+
+      context "when the user inputs a choice which is not major, minor, or patch" do
+        it "returns an error asking the user to choose major, minor, or patch" do
+          allow(stdin).to receive(:gets).and_return("hello")
+          user_comms.user_increment_choice
+          expect(stdout).to have_received(:puts).with(UserCommsHelper::ERROR_SELECT_ACCEPTED_INCREMENT_TYPE)
+        end
+      end
+    end
+
+    describe 'ask_permissison_to_apply' do
+      context 'when asked permission to apply tag: dev-v1.1.1' do
+        before(:each) do
+          @next_tag = "dev-v1.1.1"
+        end
+
+        it 'asks if user would like to apply the next tag' do
+          user_comms.ask_permissison_to_apply(@next_tag)
+          expect(stdout).to have_received(:puts).with("Do you want to apply tag: #{@next_tag}? - y/n")
+        end
+      end
+
+      context 'when a null value is received for the next tag' do
+        before(:each) do
+          @next_tag = nil
+        end
+
+        it 'raises an exception if no value assigned to tag' do
+          expect{user_comms.ask_permissison_to_apply(@next_tag)}.to raise_error.with_message(UserCommsHelper::ERROR_NEXT_TAG_NOT_ASSIGNED)
+        end
+      end
+    end
+
+    describe 'user_reply_y_or_n' do
+      context "when the user inputs their choice as yes 'y'" do
+        it "should accept the user's input as 'y'" do
+          allow(stdin).to receive(:gets).and_return("y")
+          expect(user_comms.user_reply_y_or_n).to eq("y")
+        end
+
+        it "should not accept the user's input as negative, 'n'" do
+          allow(stdin).to receive(:gets).and_return("y")
+          expect(user_comms.user_reply_y_or_n).not_to eql("n")
+        end
+      end
+
+      context "when the user inputs their choice as something other than 'y' or 'n'" do
+        it "returns an error telling the user that they need to input yes or no" do
+          allow(stdin).to receive(:gets).and_return('u')
+          user_comms.user_reply_y_or_n
+          expect(stdout).to have_received(:puts).with(UserCommsHelper::ERROR_SELECT_Y_OR_N)
+        end
+      end
+    end
+
+    describe 'tell_user_no_tag'do
+     context 'when the there are no develop tags on the commit' do
+       @tag_type = 'develop'
+       it 'tells the user that there is no develop tag' do
+         user_comms.tell_user_no_tag(@tag_type)
+         expect(stdout).to have_received(:puts).with("Error: there are no previous #{@tag_type} tags on this commit")
+       end
+     end
+    end
+
+    describe 'tell_user_already_a_tag'do
+     context 'when there is already a test tag on the commit' do
+       @tag_type = 'test'
+       it 'tells the user that there is already a test tag' do
+         user_comms.tell_user_already_a_tag(@tag_type)
+         expect(stdout).to have_received(:puts).with("Error: There is already a #{@tag_type} tag on this commit")
+       end
+     end
+    end
+
+    describe 'say_thank_you' do
+      context 'when the user has made a decision' do
+        it 'outputs thank you' do
+          user_comms.say_thank_you
+          expect(stdout).to have_received(:puts).with("Thank you!")
+        end
+      end
+    end
+  end
+end

data/lib/build_promotion_tool/spec/version_spec.rb

@@ -0,0 +1,39 @@
+require 'rspec'
+require_relative '../comparator/version'
+
+def expectBigger(smaller, bigger)
+  expect(smaller <=> bigger).to eql(-1)
+  expect(bigger <=> smaller).to eql(1)
+  expect(smaller <=> smaller).to eql(0)
+  expect(bigger <=> bigger).to eql(0)
+end
+
+describe 'Version' do
+  it 'initializes with version string' do
+    version = Version.new("1.1.2")
+    expect(version.major).to eql(1)
+    expect(version.minor).to eql(1)
+    expect(version.patch).to eql(2)
+  end
+
+  it 'compares' do
+    version1 = Version.new("1.1.2")
+    version2 = Version.new("1.1.3")
+    version3 = Version.new("1.2.1")
+    version4 = Version.new("1.2.3")
+    version5 = Version.new("4.1.1")
+    version6 = Version.new("4.2.1")
+
+    expectBigger(version1, version2)
+    expectBigger(version2, version3)
+    expectBigger(version3, version4)
+    expectBigger(version4, version5)
+    expectBigger(version5, version6)
+    expectBigger(version2, version6)
+  end
+
+  it 'does not compare with strings' do
+    version1 = Version.new("1.1.2")
+    expect(version1 <=> "hello").to eql(nil)
+  end
+end

data/lib/build_promotion_tool/version.rb

@@ -0,0 +1,3 @@
+module BuildPromotionTool
+  VERSION = "0.1.1"
+end

data/lib/build_promotion_tool.rb

@@ -0,0 +1,22 @@
+require_relative "./build_promotion_tool/version"
+require_relative "./build_promotion_tool/config.rb"
+require_relative './build_promotion_tool/controller/deploy_controller'
+
+module BuildPromotionTool
+  class Deploy
+    include Config
+
+    user_comms  = UserCommsHelper.new(STDOUT, STDIN)
+    git_helper = GitHelper.new
+    git_helper.fetch_tags
+    tags = git_helper.all_tags
+    tags.select {|tag| /^dev|test|stage-v\d+.\d+.\d*$/ =~ tag}
+    develop_tag_generator = DevelopTagGenerator.new(tags)
+    if ARGV[0].nil?
+      user_comms.error_incorrect_environ
+    else
+      deploy = DeployController.new(ARGV[0], git_helper, user_comms, develop_tag_generator, OtherTagGenerator.new, Config.tag_types)
+      deploy.environment_choice
+    end
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: build_promotion_tool
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Emily Woods
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- emily.woods@theappbusiness.com
+executables:
+- deploy
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/deploy
+- bin/setup
+- build_promotion_tool.gemspec
+- lib/build_promotion_tool.rb
+- lib/build_promotion_tool/.rspec
+- lib/build_promotion_tool/comparator/version.rb
+- lib/build_promotion_tool/config.rb
+- lib/build_promotion_tool/config.yml
+- lib/build_promotion_tool/controller/deploy_controller.rb
+- lib/build_promotion_tool/generator/develop_tag_generator.rb
+- lib/build_promotion_tool/generator/other_tag_generator.rb
+- lib/build_promotion_tool/helper/git_helper.rb
+- lib/build_promotion_tool/helper/user_comms_helper.rb
+- lib/build_promotion_tool/spec/deploy_spec.rb
+- lib/build_promotion_tool/spec/develop_spec.rb
+- lib/build_promotion_tool/spec/other_tag_spec.rb
+- lib/build_promotion_tool/spec/user_comms_spec.rb
+- lib/build_promotion_tool/spec/version_spec.rb
+- lib/build_promotion_tool/version.rb
+homepage: https://github.com/KITSTABEmilyWoods/build-promotion-gem
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- "."
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Build promotion tool for updating and applying git tags
+test_files: []