github-xcode-bot-builder 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 59137bad110f52349a68bd7159f7bf012bf64524
+  data.tar.gz: 70ac9923f4199f55fa8e1369048a4d3cc5a27c33
+SHA512:
+  metadata.gz: e00b616e8f1bb4b6faf15604b190a335c5f7f5c2a8b25e47d46bc14e377c838e1ba779f070f3a8989783bf670ab67b2afd6f9261613e1f63e94b7c7712bbfd21
+  data.tar.gz: ae108e20b23815b6c2d3c922d4d497cdca8d7868aea4b469909f2d8ae8a46f9556d55f9ba169b86d0b6f74a8c2e02737cbef9d122439f33e44ad76cf7b586fcb

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "octokit", "~> 2.0"
+gem "parseconfig", "~> 1.0.2"
+
+group :development do
+  gem "rspec", "~> 2.8.0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+  #gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,71 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    builder (3.2.2)
+    diff-lcs (1.1.3)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.20)
+    httpauth (0.2.0)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    octokit (2.5.0)
+      sawyer (~> 0.5.1)
+    parseconfig (1.0.2)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    sawyer (0.5.1)
+      addressable (~> 2.3.5)
+      faraday (~> 0.8, < 0.10)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  jeweler (~> 1.8.7)
+  octokit (~> 2.0)
+  parseconfig (~> 1.0.2)
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 ModCloth, Inc.
+
+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,77 @@
+Github Xcode Bot Builder
+========================
+
+A command line tool that creates/manages/deletes Xcode 5 server bots for each Github pull request. When a pull request is opened
+a corresponding Xcode bot is created. When a new commit is pushed the bot is re-run. When the build finishes the github
+pull request status is updated with a comment if there's an error. Users can request that a pull request be retested by
+adding a comment that includes the word "retest" (case insensitive). When a pull request is closed the corresponding
+bot is deleted.
+
+Setup
+=====
+Make sure your Xcode server is correctly setup to allow ANYONE to create a build (without a username or password, see suggested features below).
+Then make sure you can manually create and execute a build and run it.
+
+Create a ~/.bot-sync-github.cfg
+
+Go to your [Github Account Settings](https://github.com/settings/applications) and create a personal access token which
+you will use as your *github_access_token* so that the **bot-sync-github** script can access your github repo
+
+```
+github_access_token = 57244a72a7ca33931a40eb4ec21621505ab9f6b3
+github_url = https://github.com/someuser/Some-Repo.git
+github_repo = someuser/Some-Repo
+xcode_server = 192.168.10.123
+xcode_devices = iphonesimulator iPhone Retina (4-inch) 7.0|iphonesimulator iPhone Retina (4-inch) 6.1
+xcode_scheme = Some-Scheme-Name-app
+xcode_project_or_workspace = SomeProject.xcworkspace # or SomeProject.xcproject
+```
+
+Note that *xcode_devices* need to be pipe delimited. To get the list of available devices run the bot-devices command.
+The *xcode_server* can either be an ip address or a hostname.
+
+Manually run **bot-sync-github** from the command line to make sure it works
+
+Schedule **bot-sync-github** to run in cron every couple of minutes. For example if you're using RVM:
+
+```
+*/2 * * * * $HOME/.rvm/bin/ruby-2.0.0-p247 $HOME/.rvm/gems/ruby-2.0.0-p247/bin/bot-sync-github >> /tmp/bot-sync-github.log 2>&1
+```
+
+Troubleshooting
+===============
+Send us a pull request with your troubleshooting tips here!
+
+Contributing
+============
+
+* Github Xcode Bot Builder uses [Jeweler](https://github.com/technicalpickles/jeweler) for managing the Gem, versioning,
+  generating the Gemspec, etc. so do not manually edit the gemspec since it is auto generated from the Rakefile.
+* Check out the latest **master** to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Don't forget to add yourself to the contributors section below
+
+Suggested features to contribute
+================================
+* Support for configuring username and password to use with your Xcode server
+* Add specs that use VCR to help us add test coverage
+* Add support for multiple repositories
+* Add better error handling
+* Update this README.md to make it easier for new users to get started and troubleshoot
+
+Contributors
+============
+ - [ModCloth](http://www.modcloth.com/)
+ - [Geoffery Nix](http://github.com/geoffnix)
+ - [Two Bit Labs](http://twobitlabs.com/)
+ - [Todd Huss](http://github.com/thuss)
+
+Copyright
+=========
+
+Copyright (c) 2013 ModCloth. See LICENSE for further details.
+
+

data/Rakefile

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "github-xcode-bot-builder"
+  gem.homepage = "http://github.com/ModCloth/github-xcode-bot-builder"
+  gem.license = "MIT"
+  gem.summary = %Q{Create Xcode bots to run when github pull requests are created or updated}
+  gem.description = %Q{A command line tool that can be run via cron that configures and manages Xcode server bots for each pull request}
+  gem.email = ""
+  gem.authors = ["ModCloth", "Two Bit Labs", "Geoffery Nix", "Todd Huss"]
+  gem.executables = ['bot-sync-github', 'bot-devices', 'bot-status', 'bot-delete']
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "github-xcode-bot-builder #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/bot-delete

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2013-10-23.
+#  Copyright (c) 2013. All rights reserved.
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require "bot_cli"
+
+BotCli.new.delete(ARGV)

data/bin/bot-devices

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2013-10-23.
+#  Copyright (c) 2013. All rights reserved.
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require "bot_cli"
+
+BotCli.new.devices(ARGV)

data/bin/bot-status

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2013-10-23.
+#  Copyright (c) 2013. All rights reserved.
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require "bot_cli"
+
+BotCli.new.status(ARGV)

data/bin/bot-sync-github

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2013-10-23.
+#  Copyright (c) 2013. All rights reserved.
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require "bot_cli"
+
+BotCli.new.sync_github(ARGV)

data/lib/bot_builder.rb

@@ -0,0 +1,215 @@
+require 'net/http'
+require 'uri'
+require 'cgi/cookie'
+require 'SecureRandom'
+require 'json'
+require 'pp'
+require 'bot_config'
+require 'singleton'
+require 'ostruct'
+
+class BotBuilder
+  include Singleton
+
+  def delete_bot(guid)
+    success = false
+    service_requests = [ service_request('deleteBotWithGUID:', [guid]) ]
+    delete_info = batch_service_request(service_requests)
+    if (delete_info['responses'][0]['responseStatus'] == 'succeeded')
+      puts "BOT Deleted #{guid}"
+      success = true
+    else
+      puts "Error deleting BOT #{guid}"
+    end
+  end
+
+  def create_bot(short_name, long_name, branch, scm_url, project_path, scheme_name, devices = [])
+    device_guids = find_guids_for_devices(devices)
+    if (device_guids.count != devices.count)
+      puts "Some of the following devices could not be found on the server: #{devices}"
+      exit 1
+    end
+
+    scm_guid = find_guid_for_scm_url(scm_url)
+    if (scm_guid.nil? || scm_guid.empty?)
+      puts "Could not find repository on the server #{scm_url}"
+      exit 1
+    end
+
+    # Create the bot
+    buildSchemeKey = (project_path =~ /xcworkspace/) ? :buildWorkspacePath : :buildProjectPath
+
+    service_requests = [
+        service_request('createBotWithProperties:', [
+            {
+                shortName: short_name,
+                longName: long_name,
+                extendedAttributes: {
+                    scmInfo: {
+                        "/" => {
+                            scmBranch: branch,
+                        }
+                    },
+                    scmInfoGUIDMap: {
+                        "/" => scm_guid
+                    },
+                    buildSchemeKey => project_path,
+                    buildSchemeName: scheme_name,
+                    pollForSCMChanges: false,
+                    buildOnTrigger: false,
+                    buildFromClean: true,
+                    integratePerformsAnalyze: true,
+                    integratePerformsTest: true,
+                    integratePerformsArchive: false,
+                    deviceSpecification: "specificDevices",
+                    deviceInfo: device_guids
+                },
+                notifyCommitterOnSuccess: false,
+                notifyCommitterOnFailure: false,
+                type: "com.apple.entity.Bot"
+            }
+
+
+        ])
+    ]
+    bot_info = batch_service_request(service_requests)
+    bot_guid = bot_info['responses'][0]['response']['guid']
+    puts "BOT Created #{bot_guid} #{short_name}"
+
+    # Start the bot
+    start_bot bot_guid
+
+    bot_guid
+  end
+
+  def start_bot(bot_guid)
+    service_requests = [ service_request('startBotRunForBotGUID:', [bot_guid]) ]
+    bot_start_info = batch_service_request(service_requests)
+    puts "BOT Started #{bot_guid}"
+  end
+
+  def status_of_all_bots
+    # After immediately creating: latest_run_status "" run_sub_status ""
+    # While running: latest_run_status "running" run_sub_status ""
+    # After completion: latest_run_status "completed" run_sub_status "build-failed|build-errors|test-failures|warnings|analysis-issues|succeeded"
+    service_requests = [ service_request('query:', [
+        {
+            fields: ['guid','tinyID','latestRunStatus','latestRunSubStatus'],
+            entityTypes: ["com.apple.entity.Bot"]
+        }
+    ], 'SearchService') ]
+    status_info = batch_service_request(service_requests)
+    results =  status_info['responses'][0]['response']['results']
+    statuses = {}
+    results.each do |result|
+      bot = OpenStruct.new result['entity']
+      bot.status_url = "http://#{BotConfig.instance.xcode_server_hostname}/xcode/bots/#{bot.tinyID}"
+      bot.latest_run_status = (bot.latestRunStatus.nil? || bot.latestRunStatus.empty?) ? :unknown : bot.latestRunStatus.to_sym
+      bot.latest_run_sub_status = (bot.latestRunSubStatus.nil? || bot.latestRunSubStatus.empty?) ? :unknown : bot.latestRunSubStatus.to_sym
+      bot.short_name = bot.tinyID
+      bot.short_name_without_version = bot.short_name.sub(/_v\d*$/, '_v')
+      statuses[bot.short_name_without_version] = bot
+    end
+    statuses
+  end
+
+  def status
+    status_of_all_bots.values.each do |bot|
+      puts "#{bot.status_url} #{bot.latest_run_status} #{bot.latest_run_sub_status}"
+    end
+  end
+
+  def devices
+    device_info = get_device_info
+    device_info.each do |device|
+      puts device_string_for_device(device)
+    end
+  end
+
+  private
+
+  def find_guid_for_scm_url(scm_url)
+    scm_info = get_scm_info
+    scm_guid = nil
+    scm_info.each do |scm|
+      if (scm['scmRepoPath'] == scm_url)
+        scm_guid = scm['scmGUID']
+      end
+    end
+    scm_guid
+  end
+
+  def find_guids_for_devices(devices)
+    device_info = get_device_info
+    device_guids = []
+    device_info.each do |device|
+      device_string = device_string_for_device device
+      if (devices.include? device_string)
+        device_guids << device['guid']
+      end
+    end
+    device_guids
+  end
+
+  def device_string_for_device(device)
+    "#{device['adcDevicePlatform']} #{device['adcDeviceName']} #{device['adcDeviceSoftwareVersion']}"
+  end
+
+  def get_device_info
+    # Put to get device and Device Info
+    service_requests = [
+        service_request('allDevices', [])
+    ]
+    device_info = batch_service_request(service_requests)['responses'][0]['response']
+    device_info
+  end
+
+  def get_scm_info
+    # Put to get device and Device Info
+    service_requests = [
+        service_request('findAllSCMInfos', [])
+    ]
+    scm_info = batch_service_request(service_requests)['responses'][0]['response']
+    scm_info
+  end
+
+  def get_session_guid
+    # Get the guid
+    if (@session_guid == nil)
+      response = Net::HTTP.get_response(URI.parse("http://#{BotConfig.instance.xcode_server_hostname}/xcode"))
+      cookies = CGI::Cookie::parse(response['set-cookie'])
+      @session_guid = cookies['cc.collabd_session_guid']
+    end
+    @session_guid
+  end
+
+  def batch_service_request(service_requests)
+    payload = {
+        type: 'com.apple.BatchServiceRequest' ,
+        requests: service_requests
+    }
+    http = Net::HTTP.new(BotConfig.instance.xcode_server_hostname)
+    request = Net::HTTP::Put.new('/collabdproxy')
+    request['Content-Type'] = 'application/json; charset=UTF-8'
+    request['Cookie'] = "cc.collabd_session_guid=#{@session_guid}"
+    request.body = payload.to_json
+    response = http.request(request)
+    json = JSON.parse(response.body)
+    # response_status = json['responses'][0]['responseStatus']
+    # puts "Result status #{response_status}"
+    json
+  end
+
+  def service_request(name, arguments, service = 'XCBotService')
+    get_session_guid
+    {
+        type: 'com.apple.ServiceRequest',
+        arguments: arguments,
+        sessionGUID: @session_guid,
+        serviceName: service,
+        methodName: name,
+        expandReferencedObjects: false
+    }
+  end
+
+end

data/lib/bot_cli.rb

@@ -0,0 +1,39 @@
+require 'bot_builder'
+require 'bot_github'
+
+# Patch net/http to set a reasonable open_timeout to prevent hanging
+module Net
+    class HTTP
+        alias old_initialize initialize
+
+        def initialize(*args)
+            old_initialize(*args)
+            @open_timeout = 60
+        end
+    end
+end
+
+class BotCli
+
+def delete(args)
+    guid = args[0]
+    if (guid == nil || guid.empty?)
+      $stderr.puts "Missing guid of bot to delete"
+      exit 1
+    end
+    BotBuilder.instance.delete_bot guid
+  end
+
+  def status(args)
+    BotBuilder.instance.status
+  end
+
+  def devices(args)
+    BotBuilder.instance.devices
+  end
+
+  def sync_github(args)
+    BotGithub.instance.sync
+  end
+
+end

data/lib/bot_config.rb

@@ -0,0 +1,58 @@
+require 'singleton'
+require 'parseconfig'
+
+class BotConfig
+  include Singleton
+
+  def initialize
+    @filename = File.expand_path('~/.bot-sync-github.cfg')
+    if (!File.exists? @filename)
+      $stderr.puts "Missing configuration file #{@filename}"
+      exit 1
+    end
+
+    @config = ParseConfig.new(@filename)
+
+    # Make sure every param is configured properly since param will throw an error for a missing key
+    [:xcode_server, :github_url, :github_repo, :github_access_token, :xcode_devices, :xcode_scheme, :xcode_project_or_workspace].each do |key|
+      param key
+    end
+  end
+
+  def xcode_server_hostname
+    param :xcode_server
+  end
+
+  def github_access_token
+    param :github_access_token
+  end
+
+  def scm_path
+    param :github_url
+  end
+
+  def github_repo
+    param :github_repo
+  end
+
+  def xcode_devices
+    param(:xcode_devices).split('|')
+  end
+
+  def xcode_scheme
+    param :xcode_scheme
+  end
+
+  def xcode_project_or_workspace
+    param :xcode_project_or_workspace
+  end
+
+  def param(key)
+    value = @config[key.to_s]
+    if (value.nil?)
+      $stderr.puts "Missing configuration key #{key} in #{@filename}"
+      exit 1
+    end
+    value
+  end
+end

data/lib/bot_github.rb

@@ -0,0 +1,208 @@
+require 'octokit'
+require 'singleton'
+require 'bot_config'
+require 'bot_builder'
+require 'ostruct'
+
+class BotGithub
+  include Singleton
+
+  def initialize
+    @client = Octokit::Client.new :access_token => BotConfig.instance.github_access_token
+    @client.login
+  end
+
+  def sync
+    puts "\nStarting Github Xcode Bot Builder #{Time.now}\n-----------------------------------------------------------"
+    # Check to see if we're already running and skip this run if so
+    running_instances = `ps aux | grep [b]ot-sync-github | grep -v bin/sh`.split("\n")
+    if (running_instances.count > 1)
+      $stderr.puts "Skipping run since bot-sync-github is already running"
+      PP.pp(running_instances, STDERR)
+      exit 1
+    end
+
+    bot_statuses = BotBuilder.instance.status_of_all_bots
+    bots_processed = []
+    pull_requests.each do |pr|
+      # Check if a bot exists for this PR
+      bot = bot_statuses[pr.bot_short_name_without_version]
+      bots_processed << pr.bot_short_name
+      if (bot.nil?)
+        # Create a new bot
+        BotBuilder.instance.create_bot(pr.bot_short_name, pr.bot_long_name, pr.branch,
+                                       BotConfig.instance.scm_path,
+                                       BotConfig.instance.xcode_project_or_workspace,
+                                       BotConfig.instance.xcode_scheme,
+                                       BotConfig.instance.xcode_devices)
+        create_status_new_build(pr)
+      else
+        github_state_cur = latest_github_state(pr).state # :unknown :pending :success :error :failure
+        github_state_new = convert_bot_status_to_github_state(bot)
+        if (github_state_new == :pending && github_state_cur != github_state_new)
+          # User triggered a new build by clicking Integrate on the Xcode server interface
+          create_status(pr, github_state_new, convert_bot_status_to_github_description(bot), bot.status_url)
+        elsif (github_state_new != :unknown && github_state_cur != github_state_new)
+          # Build has passed or failed so update status and comment on the issue
+          create_comment_for_bot_status(pr, bot)
+          create_status(pr, github_state_new, convert_bot_status_to_github_description(bot), bot.status_url)
+        elsif (github_state_cur == :unknown)
+          # Unknown state occurs when there's a new commit so trigger a new build
+          BotBuilder.instance.start_bot(bot.guid)
+          create_status_new_build(pr)
+        elsif (user_requested_retest(pr, bot))
+          BotBuilder.instance.start_bot(bot.guid)
+        else
+          puts "PR #{pr.number} (#{github_state_cur}) is up to date for bot #{bot.short_name}"
+        end
+      end
+    end
+
+    # Delete bots that no longer have open pull requests
+    bots_unprocessed = bot_statuses.keys - bots_processed
+    bots_unprocessed.each do |bot_short_name|
+      bot = bot_statuses[bot_short_name]
+      BotBuilder.instance.delete_bot(bot.guid) unless !is_managed_bot(bot)
+    end
+
+    puts "-----------------------------------------------------------\nFinished Github Xcode Bot Builder #{Time.now}\n"
+  end
+
+  private
+
+  def convert_bot_status_to_github_description(bot)
+    bot_run_status = bot.latest_run_status # :unknown :running :completed
+    bot_run_sub_status = bot.latest_run_sub_status # :unknown :build-failed :build-errors :test-failures :warnings :analysis-issues :succeeded
+    github_description = bot_run_status == :running ? "Build Triggered." : ""
+    if (bot_run_status == :completed || bot_run_status == :failed)
+      github_description = bot_run_sub_status.to_s.split('-').map(&:capitalize).join(' ') + "."
+    end
+    github_description
+  end
+
+  def convert_bot_status_to_github_state(bot)
+    bot_run_status = bot.latest_run_status # :unknown :running :completed
+    bot_run_sub_status = bot.latest_run_sub_status # :unknown :build-failed :build-errors :test-failures :warnings :analysis-issues :succeeded
+    github_state = bot_run_status == :running ? :pending : :unknown
+    if (bot_run_status == :completed || bot_run_status == :failed)
+      github_state = case bot_run_sub_status
+                       when :"test-failures", :"warnings", :"analysis-issues"
+                         :failure
+                       when :"succeeded"
+                         :success
+                       else
+                         :error
+                     end
+    end
+    github_state
+  end
+
+  def create_comment_for_bot_status(pr, bot)
+    message = "Build " + convert_bot_status_to_github_state(bot).to_s.capitalize + ": " + convert_bot_status_to_github_description(bot)
+    message += "\n#{bot.status_url}"
+    @client.add_comment(BotConfig.instance.github_repo, pr.number, message)
+    puts "PR #{pr.number} added comment \"#{message}\""
+  end
+
+  def create_status_new_build(pr)
+    create_status(pr, :pending, "Build Triggered.")
+  end
+
+  def create_status(pr, github_state, description = nil, target_url = nil)
+    options = {}
+    if (!description.nil?)
+      options['description'] = description
+    end
+    if (!target_url.nil?)
+      options['target_url'] = target_url
+    end
+    @client.create_status(BotConfig.instance.github_repo, pr.sha, github_state.to_s, options)
+    puts "PR #{pr.number} status updated to \"#{github_state}\" with description \"#{description}\""
+  end
+
+  def latest_github_state(pr)
+    statuses = @client.statuses(BotConfig.instance.github_repo, pr.sha)
+    status = OpenStruct.new
+    status.state = statuses[0].state.to_sym
+    status.updated_at = statuses[0].updated_at
+    status
+  end
+
+  def pull_requests
+    github_repo = BotConfig.instance.github_repo
+    responses = @client.pull_requests(github_repo)
+    prs = []
+    responses.each do |response|
+      pr = OpenStruct.new
+      pr.sha = response.head.sha
+      pr.branch = response.head.ref
+      pr.title = response.title
+      pr.state = response.state
+      pr.number = response.number
+      pr.updated_at = response.updated_at
+      pr.bot_short_name = bot_short_name(pr)
+      pr.bot_short_name_without_version = bot_short_name_without_version(pr)
+      pr.bot_long_name = bot_long_name(pr)
+      prs << pr
+    end
+    prs
+  end
+
+  def user_requested_retest(pr, bot)
+    should_retest = false
+    github_repo = BotConfig.instance.github_repo
+
+    # Check for a user retest request comment
+    comments = @client.issue_comments(github_repo, pr.number)
+    latest_retest_time = Time.at(0)
+    found_retest_comment = false
+    comments.each do |comment|
+      if (comment.body =~ /retest/i)
+        latest_retest_time = comment.updated_at
+        found_retest_comment = true
+      end
+    end
+
+    return should_retest unless found_retest_comment
+
+    # Get the latest status time
+    latest_status_time = latest_github_state(pr)
+    if (latest_status_time.nil? || latest_status_time.updated_at.nil?)
+      latest_status_time = Time.at(0)
+    end
+
+    if (latest_retest_time > latest_status_time.updated_at)
+      should_retest = true
+      puts "PR #{pr.number} user requested a retest"
+    end
+
+    should_retest
+  end
+
+  def bot_long_name(pr)
+    github_repo = BotConfig.instance.github_repo
+    "PR #{pr.number} #{pr.title} #{github_repo}"
+  end
+
+  def bot_short_name(pr)
+    short_name = "#{pr.number}-#{pr.branch}".gsub(/[^[:alnum:]]/, '_') + bot_short_name_suffix
+    short_name
+  end
+
+# For duplicate bot names xcode server appends a version
+# bot_short_name_v, bot_short_name_v1, bot_short_name_v2. This method converts bot_short_name_v2 to bot_short_name_v
+  def bot_short_name_without_version(pr)
+    bot_short_name(pr).sub(/_v\d*$/, '_v')
+  end
+
+  def is_managed_bot(bot)
+    # Check the suffix of the bot to see if it matches the bot_short_name_suffix
+    bot.short_name =~ /#{bot_short_name_suffix}\d*$/
+  end
+
+  def bot_short_name_suffix
+    github_repo = BotConfig.instance.github_repo.downcase
+    ('_' + github_repo + '_v').gsub(/[^[:alnum:]]/, '_')
+  end
+
+end

data/spec/github_xcode_bot_builder_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "GithubXcodeBotBuilder" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'github-xcode-bot-builder'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: github-xcode-bot-builder
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- ModCloth
+- Two Bit Labs
+- Geoffery Nix
+- Todd Huss
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: parseconfig
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+description: A command line tool that can be run via cron that configures and manages
+  Xcode server bots for each pull request
+email: ''
+executables:
+- bot-sync-github
+- bot-devices
+- bot-status
+- bot-delete
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- bin/bot-delete
+- bin/bot-devices
+- bin/bot-status
+- bin/bot-sync-github
+- lib/bot_builder.rb
+- lib/bot_cli.rb
+- lib/bot_config.rb
+- lib/bot_github.rb
+- spec/github_xcode_bot_builder_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/ModCloth/github-xcode-bot-builder
+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: Create Xcode bots to run when github pull requests are created or updated
+test_files: []