cinder 0.5.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+source 'https://raw.github.com/detroit-labs/erebor/gems/'
+
+# Specify your gem's dependencies in cinder.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Detroit Labs
+
+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,79 @@
+Cinder
+========
+
+Continuous Delivery for iOS Apps.
+
+Cinder favors convention over configuration. Of the myriad ways to organize an iOS project, Cinder supports a subset that still gets the job done.
+
+<a href="http://www.flickr.com/photos/cindy_cinder/6063851300/" title="Flaming Butterfly and Flowers by Cinder's, on Flickr"><img src="http://farm7.staticflickr.com/6204/6063851300_6c81f2360d.jpg" width="150" height="200" alt="Flaming Butterfly and Flowers"></a>
+
+iOS projects using Cinder:
+
+* have developers up and running after running a single command following `git clone`
+* build your app's ipa whenever code is pushed to your GitHub repo
+* publish successful builds of `master` as versions in [TestFlight](https://testflightapp.com/). <span style="color:#999">The "What's New" shows changes since the last build and since the last release.</span>
+* <span style="color:#999">publish successful builds of *topic branches* as comments in the pull request with links to install a version of the app with that feature</span>
+* <span style="color:#999">comment and close pull requests of failed builds</span>
+
+Items in <span style="color:#999">de-emphasized text</span> are still being developed.
+
+Usage
+-----
+
+* `script/setup` - run this after cloning a project and you're ready to develop in Xcode. Re-run it whenever project dependencies have changed.
+
+* `script/cibuild` - is the two-liner shell script which tells the [Janky continuous integration server](https://github.com/github/janky) how to build Ad Hoc or Enterprise versions of your app:
+
+        #!/bin/bash
+        exec "$(dirname $0)/build" --configuration Enterprise
+
+* `bin/cinder lint` - will guide you through setting up a new project or modifying an existing project to work with Cinder.
+
+
+New Project Quickstart
+----------------------
+
+In the top-level of your project run:
+
+    ruby -e "$(curl -fsSL https://raw.github.com/detroit-labs/cinder/hot)"
+
+This is a one-time initialization that only one developer must complete. Afterwards, anyone cloning the project can simply run:
+
+    script/setup
+
+Installation for Existing Projects
+----------------------------------
+
+If your project doesn't use Bundler (e.g. doesn't have a `Gemfile`) then follow **New Project Quickstart** above.
+
+Add this line to the top of `Gemfile`:
+
+    source 'https://raw.github.com/detroit-labs/erebor/gems/'
+
+Add this line to the gems portion of `Gemfile`:
+
+    gem 'cinder'
+
+Cinder expects that you use binstubs with Bundler and vendor gems under `.bundle`. Run:
+
+    bundle install --binstubs --path .bundle
+    git add .bundle/config
+    echo '/.bundle/ruby/' >>.gitignore
+    
+Henceforth `bundle install` without flags is sufficient.
+
+The `cinder` CLI should now be available under `bin/`. It will guide you the rest of the way:
+
+    bin/cinder lint
+    # 10 fix errors
+    # 20 bin/cinder lint
+    # 30 if errors GOTO 10
+
+Cinder is Opinionated
+-----------------------
+
+* Ruby is an integral part of the development, build, and
+  release toolchain for native iOS apps
+* Ruby versions are managed by [rbenv](https://github.com/sstephenson/rbenv)
+* Automation always wins
+* Convention over configuration; when there's more than one way to do it, pick one

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+desc "Run all specs"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = %w[--color]
+  t.verbose = false
+end
+
+task :default => :spec

data/bin/cinder

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+require 'commander/import'
+
+$:.push File.expand_path("../../lib", __FILE__)
+require 'cinder'
+
+HighLine.track_eof = false # Fix for built-in Ruby
+
+program :version, Cinder::VERSION
+program :description, 'Continuous Delivery for iOS Apps'
+
+program :help, 'Author', 'Tim Taylor <tim@detroitlabs.com>'
+program :help, 'Website', 'https://github.com/detroit-labs/cinder'
+program :help_formatter, :compact
+
+default_command :help
+
+require 'cinder/commands'

data/cinder.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$:.unshift(lib) unless $:.include?(lib)
+
+require 'cinder/version'
+
+Gem::Specification.new do |s|
+  s.name          = "cinder"
+  s.version       = Cinder::VERSION
+  s.authors       = ["Tim Taylor"]
+  s.email         = ["tim@detroitlabs.com"]
+  s.description   = "Continuous Delivery for iOS Apps"
+  s.summary       = "Cinder"
+  s.homepage      = "https://github.com/detroit-labs/cinder"
+  s.license       = "MIT"
+
+  s.add_dependency "commander", "~> 4.1.3"
+  s.add_dependency "extlib", "~> 0.9.16"
+  s.add_dependency "plist", "~> 3.1.0"
+  s.add_dependency "dotenv", "~> 0.5.0"
+  s.add_dependency "cocoapods", "~> 0.19.0"
+  s.add_dependency "shenzhen", "~> 0.3.0"
+  s.add_dependency "rugged", "~> 0.17.0.b8"
+
+  s.add_development_dependency "bundler", "~> 1.3"
+  s.add_development_dependency "rake"
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'fakefs', '~> 0.3.2'
+
+  s.files         = `git ls-files`.split($/)
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ["lib"]
+end

data/lib/cinder.rb

@@ -0,0 +1,5 @@
+require "cinder/version"
+
+module Cinder
+  # Your code goes here...
+end

data/lib/cinder/commands.rb

@@ -0,0 +1,13 @@
+$:.push File.expand_path('../', __FILE__)
+
+require 'dotenv'
+Dotenv.load File.join(ENV['JENKINS_HOME'] || '.', '.env.ios')
+
+require 'extlib/string'
+require 'openssl'
+require 'plist'
+require 'external_commands'
+
+require 'commands/build'
+require 'commands/setup'
+require 'commands/lint'

data/lib/cinder/commands/build.rb

@@ -0,0 +1,69 @@
+module Cinder
+  command :build do |c|
+    c.syntax = 'cinder build [OPTIONS]'
+    c.summary = 'Build & publish a release.'
+    c.description = 'Build a release. For AdHoc or Enterprise builds against `master`, publish to TestFlight.'
+
+    c.option '-c', '--configuration CONFIGURATION', 'Configuration used to build. One of AdHoc, AppStore, or Enterprise. Defaults to AdHoc.'
+
+    c.action do |args, options|
+      options.default :configuration => 'AdHoc'
+
+      name = determine_workspace
+      use_keychain options.configuration.snake_case
+      set_bundle_version name
+      build_ipa options.configuration, name
+      publish_ipa name
+      say_ok "Did all the things for #{name}"
+    end
+
+    private
+
+    def self.determine_workspace
+      workspaces = Dir["*.xcworkspace"].grep(/^(.*)\.xcworkspace$/){$1}
+      say_error "No Xcode workspace found" and abort if workspaces.empty?
+      say_error "There can be only one workspace" and abort if workspaces.length > 1
+      workspaces.first
+    end
+
+    def self.use_keychain keychain_name
+      keychain_file = "#{ENV['HOME']}/Library/Keychains/#{keychain_name}.keychain"
+      if File.exists?(keychain_file)
+        args = [
+                keychain_file,
+                "/Library/Keychains/System.keychain"
+               ]
+        log 'security', "Using #{keychain_name}.keychain"
+        # TODO: restore original keychains
+        security! "list-keychains -s #{args.join(" ")}"
+        security! %{default-keychain -s "#{keychain_file}"}
+        security! %{unlock-keychain -p "#{ENV['CI_KEYCHAIN_PASSWORD']}" "#{keychain_file}"}
+      end
+    end
+
+    def self.set_bundle_version name
+      short_sha1 = git!("rev-parse --short #{ENV['JANKY_SHA1'] || 'HEAD'}").strip
+      log 'plist', "Setting CFBundleVersion to `#{short_sha1}'"
+      PlistBuddy! %{-c "Set :CFBundleVersion #{short_sha1}" "#{name}/#{name}-Info.plist"}
+    end
+
+    def self.build_ipa configuration, name
+      log 'ipa', "Building an ipa with configuration `#{configuration}' and scheme `#{name}'"
+      ipa! "build --trace -c #{configuration} -s #{name}"
+    end
+
+    def self.publish_ipa name
+      master_sha1 = git!('rev-parse origin/master').strip
+      if master_sha1 == ENV['JANKY_SHA1']
+        team_token = ENV['CI_TESTFLIGHT_TEAM_TOKEN']
+        api_token = ENV['CI_TESTFLIGHT_API_TOKEN']
+        build_number = ENV['JANKY_ID']
+        build_output_url = "#{ENV['CI_JANKY_BASE_URL']}#{build_number}/output"
+        notes = "Automated Build ##{build_number}\n#{build_output_url}"
+
+        log 'ipa', 'Distribute ipa to TestFlight'
+        ipa! %{distribute:testflight --team_token #{team_token} --api_token #{api_token} --replace --lists "#{name}" --notify --notes "#{notes}"}
+      end
+    end
+  end
+end

data/lib/cinder/commands/lint.rb

@@ -0,0 +1,284 @@
+# -*- coding: utf-8 -*-
+require 'xcodeproj'
+require 'extlib'
+require 'cocoapods-core'
+require 'rugged'
+
+module Cinder
+
+  class ProvisioningProfile
+    attr_reader :distribution
+    attr_reader :devices
+
+    def self.from_file f
+      begin
+        p7 = OpenSSL::PKCS7.new(File.read(f))
+        p7.verify([], OpenSSL::X509::Store.new)
+        new Plist::parse_xml(p7.data)
+      rescue
+        new
+      end
+    end
+
+    def initialize profile = nil
+      if profile
+        @valid = true
+        @devices = []
+        if profile['ProvisionsAllDevices']
+          @distribution = :enterprise
+        elsif profile['ProvisionedDevices']
+          @distribution = :ad_hoc
+          @devices = profile['ProvisionedDevices']
+        else
+          # FIXME: could be a developer provisioning profile; need a better check
+          @distribution = :app_store
+        end
+      else
+        @valid = false
+      end
+    end
+
+    def valid?
+      @valid == true
+    end
+
+    def ad_hoc?
+      @distribution == :ad_hoc
+    end
+  end
+
+  class Linter
+    DISTRIBUTION_METHODS = {
+      :ad_hoc => 'AdHoc',
+      :app_store => 'AppStore',
+      :enterprise => 'Enterprise'
+    }
+
+    def lint options, args
+      abort unless acc = _lint(detect_repository({}))
+      say <<-EOS.margin if `git ls-files .cinder`.split($/).empty?
+
+        Additional Steps
+        ================
+
+        1. Add ‘deckard’ group to #{acc[:repo_company]}/#{acc[:repo_name]} in GitHub
+
+        2. Tell Hubot to set it up in Janky
+
+                @bot ci setup #{acc[:repo_company]}/#{acc[:repo_name]}
+                @bot ci set room #{acc[:repo_name]} #{acc[:name]}
+
+        3. Create a distribution list named ‘#{acc[:name]}’ in TestFlight
+
+        4. Create `setup` and `build` scripts
+
+                mkdir -p script
+                curl -L http://git.io/dqT6SA >script/.cinder-exec
+                ( cd script ; \\
+                  chmod +x .cinder-exec ; \\
+                  ln -s .cinder-exec setup ; \\
+                  ln -s .cinder-exec build )
+
+        5. Create `script/cibuild`
+
+                #!/bin/bash
+                exec "$(dirname $0)/build" --configuration #{acc[:build_configs].keys.grep(/ad_hoc|enterprise/).sort.first.to_s.camel_case}
+
+        6. Add the following to `.gitignore`
+
+                /.bundle/ruby/
+                /Pods/
+                /bin/
+
+        7. Add and commit a `.cinder` file to repository to turn off this message
+
+        EOS
+    end
+
+    def _lint acc = {}
+      acc &&=  detect_projects               acc
+      acc &&=  detect_workspaces             acc
+      acc &&=  determine_name                acc
+      acc &&=  check_podfile                 acc
+      acc &&=  check_workspace               acc
+      acc &&=  check_single_project          acc
+      acc &&=  check_multiple_projects       acc
+      acc &&=  load_project                  acc
+      acc &&=  detect_targets                acc
+      acc &&=  check_single_target           acc
+      acc &&=  check_multiple_targets        acc
+      acc &&=  detect_build_configs          acc
+      acc &&=  check_app_store_config        acc
+      acc &&=  check_testing_configs         acc
+      acc &&=  detect_provisioning_profiles  acc
+      acc &&=  check_provisioning_profiles   acc
+      acc &&=  check_scheme                  acc
+
+      say_ok 'OK to go' if acc
+      acc
+    end
+
+    private
+
+    def detect_repository acc
+      begin
+        path = Rugged::Repository.discover
+      rescue
+        say_error "Must be in a git repository" and return nil
+      end
+      acc[:repo] = repo = Rugged::Repository.new path
+      acc[:root] = root = File.expand_path '..', repo.path
+
+      say_error "Must be at the root of the project at `#{root}'" and return nil unless root == Dir.getwd
+      upstream = repo.remotes.grep(/upstream/).first
+      upstream ||= repo.remotes.grep(/origin/).first
+      upstream &&= Rugged::Remote.lookup repo, upstream
+      if upstream.url =~ %r{github.com[:/]([\w-]+)/([\w-]+).git}
+        acc[:repo_company], acc[:repo_name] = $1, $2
+      end
+      say_error "Must have `upstream' or `origin' remote on GitHub" and return nil unless acc[:repo_name]
+      acc
+    end
+
+    def detect_projects acc
+      acc[:projects] = projects = Dir["*.xcodeproj"].map {|f| File.basename(f)}.grep(/^(.*)\.xcodeproj$/){$1}
+      say_error "No Xcode project found" and return nil if projects.empty?
+      acc
+    end
+
+    def detect_workspaces acc
+      acc[:workspaces] = Dir["*.xcworkspace"].map {|f| File.basename(f)}.grep(/^(.*)\.xcworkspace$/){$1}
+      acc
+    end
+
+    def determine_name acc
+      if acc[:workspaces].length == 1
+        acc[:name] = acc[:workspaces].first
+      elsif acc[:projects].length == 1
+        acc[:name] = acc[:projects].first
+      end
+      acc
+    end
+
+    def check_podfile acc
+      result = acc
+      file = Dir['Podfile'].first
+      say_error "No CocoaPods Podfile found" and return nil unless file
+      podfile = Pod::Podfile.from_file file
+      target = podfile.root_target_definitions.first
+      platform = target.platform.name if target.platform
+      say_error 'CocoaPods platform must be iOS' and result = nil unless platform == :ios
+      say_error 'Must have at least one CocoaPods dependency' and result = nil if target.dependencies.empty?
+      result
+    end
+
+    def check_workspace acc
+      workspaces = Dir["*.xcworkspace"].map {|f| File.basename(f)}.grep(/^(.*)\.xcworkspace$/){$1}
+      say_error "No Xcode workspace found" and return nil if workspaces.empty?
+      say_error "There can be only one Xcode workspace" and return nil if workspaces.length > 1
+      acc[:workspace] = workspace = workspaces.first
+      say_error "Workspace name `#{workspace}' must not contain whitespace" and return nil if workspace =~ /\s/
+      say_warning "Workspace name `#{workspace}' should be CamelCase" unless workspace =~ /^[[:upper:]]\S*(?:[[:upper:]]\s*)*$/
+      acc
+    end
+
+    def check_single_project acc
+      return acc if acc[:projects].length > 1
+
+      acc[:project] = acc[:projects].find { |p| p == acc[:workspace] }
+      say_error "Xcode project name `#{acc[:projects].first}' must match workspace name `#{acc[:workspace]}'" and return nil unless acc[:project]
+      acc
+    end
+
+    def check_multiple_projects acc
+      return acc if acc[:projects].length == 1
+
+      acc[:project] = acc[:projects].find { |p| p == acc[:workspace] }
+      say_error "One Xcode project name must match workspace name `#{acc[:workspace]}'" and return nil unless acc[:project]
+      acc
+    end
+
+    def load_project acc
+      acc[:xcodeproj] = Xcodeproj::Project.new "#{acc[:project]}.xcodeproj"
+      acc
+    end
+
+    def detect_targets acc
+      acc[:targets] = acc[:xcodeproj].targets
+      say_error "Xcode project must have at least one target" and return nil if acc[:targets].empty?
+      acc
+    end
+
+    def check_single_target acc
+      return acc if acc[:targets].length > 1
+
+      acc[:target] = target = acc[:targets].first
+      say_error "Target name `#{target.name}' must match workspace name `#{acc[:workspace]}'" and return nil unless target.name == acc[:workspace]
+      acc
+    end
+
+    def check_multiple_targets acc
+      return acc if acc[:targets].length == 1
+
+      acc[:target] = acc[:targets].find { |t| t.name == acc[:workspace] }
+      say_error "One Xcode target name must match workspace name `#{acc[:workspace]}'" and return nil unless acc[:target]
+      acc
+    end
+
+    def detect_build_configs acc
+      a = acc[:xcodeproj].build_configurations
+      acc[:build_configs] = a.find_all { |c| c.name =~ /^(?:AdHoc|AppStore|Enterprise)$/ }.each_with_object({}) { |c,h| h[c.name.snake_case.to_sym] = c }
+      acc
+    end
+
+    def check_testing_configs acc
+      configs = acc[:build_configs].find_all { |k,v| k == :ad_hoc || k == :enterprise }
+      say_error "Must have `AdHoc', `Enterprise', or both build configurations" and return nil if configs.empty?
+      acc
+    end
+
+    def check_app_store_config acc
+      say_warning "Should have `AppStore' build configuration" unless acc[:build_configs][:app_store]
+      acc
+    end
+
+    def detect_provisioning_profiles acc
+      a = Dir['*.mobileprovision'].grep(/^(ad_hoc|app_store|enterprise)\./){$1.to_sym}
+      acc[:provisioning_profiles] = a.each_with_object({}) { |p,h| h[p] = "#{p}.mobileprovision" }
+      acc
+    end
+
+    def check_provisioning_profiles acc
+      result = acc
+
+      acc[:build_configs].each do |name, config|
+        file = acc[:provisioning_profiles][name]
+        if file
+          profile = ProvisioningProfile.from_file file
+          if profile.valid?
+            say_error "`#{file}' appears to be an #{DISTRIBUTION_METHODS[profile.distribution]} provisioning profile" and result = nil unless name == profile.distribution
+            say_error "AdHoc provisioning must have at least 1 device provisioned" and result = nil if profile.ad_hoc? && profile.devices.empty?
+          else
+            say_error "Invalid provisioning profile `#{file}'" and result = nil
+          end
+        else
+          say_error "`#{config.name}' build configuration must have an `#{name}.mobileprovision' in project root" and result = nil
+        end
+      end
+      result
+    end
+
+    def check_scheme acc
+      schemes = Dir["#{acc[:name]}.xcodeproj/xcshareddata/xcschemes/#{acc[:name]}.xcscheme"].grep(/^(.*)\.xcscheme$/){$1}
+      say_error "Must have a shared Xcode scheme named `#{acc[:name]}'" and return nil if schemes.empty?
+      acc
+    end
+  end
+
+  command :lint do |c|
+    c.syntax = 'cinder lint'
+    c.summary = 'Check for CI problems'
+    c.description = 'Report if your project is missing or deviating from Cinder conventions.'
+    c.action Linter, :lint
+  end
+end