objc-referee 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 36c9f2903bc7f510e0a34800fce52cf0a878f39d
+  data.tar.gz: ced79e3acb02c3044e7b8dd26c6e19a7dfc10088
+SHA512:
+  metadata.gz: 20f102e50fcc1886f61ba630cb8676ded8b29587fa223176fb84d267cbeeaf45332fb9c85e12be6870416c886e8ad7769f07981df54d693fd283cdafd30ee850
+  data.tar.gz: b9f6a89b2a98626348b7b8cbc8dd7fa91b8bf610c25c24f7f9e0c3f51e682b9932175d163a082eff47fb9612414ba35bfe6c01f4470d5a9bff3934ed576df1fe

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/bin/*
+!/bin/console
+!/bin/setup

data/.rubocop.yml

@@ -0,0 +1,14 @@
+inherit_from: .rubocop_todo.yml
+
+# Files to exclude - all executable dependencies from Rubygems.
+AllCops:
+  Exclude:
+    - 'bin/*'
+
+# Give us... a little more room.
+Metrics/LineLength:
+  Max: 120
+
+# This cop seems to produce a few false-positives.
+Style/Next:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,16 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2015-08-20 17:16:11 -0400 using RuboCop version 0.33.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 3
+Metrics/AbcSize:
+  Max: 23
+
+# Offense count: 3
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 32

data/.travis.yml

@@ -0,0 +1,12 @@
+sudo: false
+cache: bundler
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1
+  - 2.2
+before_install: gem update --remote bundler
+install:
+  - bundle install --retry=3
+script:
+  - bundle exec rubocop

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+This project adheres to [Semantic Versioning](http://semver.org/) and this file attempts to follow the guidelines provided by [Keep a CHANGELOG](http://keepachangelog.com/).
+
+## [0.1.1] - 2015-09-02
+Initial public release.
+
+[0.1.1]: https://github.com/dynamit/referee/v0.1.1

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,65 @@
+PATH
+  remote: .
+  specs:
+    objc-referee (0.1.0)
+      mustache (~> 1.0, >= 1.0.2)
+      nokogiri (~> 1.6, >= 1.6.6.2)
+      xcodeproj (~> 0.20.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.2.4)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    ast (2.1.0)
+    astrolabe (1.3.1)
+      parser (~> 2.2)
+    coderay (1.1.0)
+    colored (1.2)
+    i18n (0.7.0)
+    json (1.8.3)
+    method_source (0.8.2)
+    mini_portile (0.6.2)
+    minitest (5.8.0)
+    mustache (1.0.2)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    parser (2.2.2.6)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.1)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rainbow (2.0.0)
+    rake (10.4.2)
+    rubocop (0.33.0)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.2.5, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.4)
+    ruby-progressbar (1.7.5)
+    rubygems-tasks (0.2.4)
+    slop (3.6.0)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    xcodeproj (0.20.2)
+      activesupport (>= 3)
+      colored (~> 1.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.8)
+  objc-referee!
+  pry (~> 0.10.1)
+  rake (~> 10.0)
+  rubocop (~> 0.33.0)
+  rubygems-tasks (~> 0.2.4)

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Dynamit, LLC
+
+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,109 @@
+# Referee
+
+[![Build Status](https://travis-ci.org/Dynamit/referee.svg?branch=master)](https://travis-ci.org/Dynamit/referee) [![Gem Version](https://badge.fury.io/rb/objc-referee.svg)](http://badge.fury.io/rb/objc-referee)
+
+Referee is a script that generates Objective-C classes and macros for easily referencing your resources in code, providing IDE auto-complete and compile-time safety for your app.
+
+The currently supported resource types are:
+
+- Storyboards
+- View Controllers
+- Segue Identifiers
+- Table View Cell Identifiers
+- Collection View Cell Identifiers
+
+The inspiration for this script was provided by [R.swift](https://github.com/mac-cain13/R.swift).
+
+## Demo
+
+Without `referee`, you can either maintain your own constants file in parallel with your storyboards or write code as such:
+
+```objc
+UIStoryboard *mainStoryboard = [UIStoryboard storyboardWithName:@"Main" bundle:[NSBundle mainBundle]];
+UIViewController *someViewController = [mainStoryboard instantiateViewControllerWithIdentifier:@"Some View Controller"];
+[someViewController performSegue:@"Some Segue"];
+```
+
+With `referee`, you can replace this with references to a few automatically generated classes:
+
+```objc
+UIViewController *someViewController = TSTResources.viewControllers.SomeViewController;
+[someViewController performSegue:TSTResources.segues.SomeSegue];
+```
+
+Now, if you change an identifier in your storyboard, your code won't compile unless it matches as well, providing you with the confidence that your code and UI are in sync.
+
+## Installation
+
+`referee` is distributed through [RubyGems](https://rubygems.org/). To install it, execute the following command:
+
+    $ gem install objc-referee
+
+As a reminder, if you are using [rbenv](https://github.com/sstephenson/rbenv) to manage your Gems, you may additionally need to run:
+
+    $ rbenv rehash
+
+Note that Xcode does not use your standard user `$PATH`, so we'll need to place `referee` in a standard place that we can reference in our build scripts. `/usr/local/bin/` is a good place for this executable:
+
+    $ ln -s $(which referee) /usr/local/bin/referee
+
+Or if you'd rather do the above manually, here is an example using `rbenv`:
+
+    $ which referee
+    /Users/colindrake/.rbenv/shims/referee
+    $ ln -s /Users/colindrake/.rbenv/shims/referee /usr/local/bin/referee
+
+Finally, if you are using a `Gemfile` to manage Ruby dependencies for your app or build system, make sure to add the following:
+
+    source 'https://rubygems.org'
+    gem 'objc-referee'
+
+## Xcode Integration
+This script was designed to be easily integrated into your Xcode project workflow.
+
+Begin by adding a Run Script to your Build Phases. For the script portion, enter:
+
+    /usr/local/bin/referee --prefix <your class prefix>
+
+_**Ensure that this Run Script runs before the Compile Sources step. Otherwise, your new changes won't get compiled!**_
+
+Build the project and open your source folder. By default, at the root of that folder there should be two new files: `<Prefix>Resources.h` and `<Prefix>Resources.m`. Add these files to the Xcode project, ensuring "Copy Files" is _not_ selected.
+
+From now on, when you make changes in your Storyboard files, they will be reflected in these source files upon compiling.
+
+If you need to setup different paths or configure `referee` further, check the `--help` flag for more information and documentation.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Todos
+
+- [ ] Add in Image support
+- [ ] More robust method name generation
+- [ ] NIB support
+- [ ] Localized Strings?
+- [ ] Per-category toggle flags, i.e. something to the effect of `--table-cells=NO`
+
+## Caveats
+
+A word of caution: using Referee on your project can make your project's binary size balloon. This is a consequence of what Referee does for you - it creates convenience classes for you, thus increasing your symbol count. On most smaller projects, this won't matter. On large ones, however, please be cautious.
+
+## Contributing
+
+1. Fork it ( https://github.com/dynamit/referee/fork )
+2. Create your feature branch (`git checkout -b feature/my-new-feature`)
+3. Ensure you adhere to the style guidelines (run `rubocop`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin feature/my-new-feature`)
+6. Create a new Pull Request
+
+Note: The [Rubocop](https://github.com/bbatsov/rubocop) adherence can always be improved! Please see `.rubocop_todo.yml` for areas that need improvement.
+
+## License
+
+This project is MIT licensed. Please see `LICENSE.txt` for details.
+
+## Sponsorship
+
+This project is sponsored by the iOS Mobile group at [Dynamit, LLC](http://dynamit.com).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'rubygems/tasks'
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __FILE__))
+require 'referee/version'
+
+Gem::Tasks.new

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "referee"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/referee

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'referee'
+Referee::CLI.new(ARGV).execute

data/lib/referee/buildoutput.rb

@@ -0,0 +1,29 @@
+module Referee
+  # Class providing an Xcode-parseable output mechanism.
+  class BuildOutput
+    def initialize(config)
+      @config = config
+    end
+
+    # Outputs an informational message.
+    def info(msg)
+      puts msg if @config.verbose
+    end
+
+    # Outputs a message tagged as a warning for Xcode.
+    def warn(msg)
+      puts "warning: #{msg}"
+    end
+
+    # Outputs a message tagged as an error for Xcode.
+    def error(msg)
+      puts "error: #{msg}"
+    end
+
+    # Outputs an error message and quits with an error status.
+    def die(msg, status = 1)
+      error msg
+      Kernel.exit status
+    end
+  end
+end

data/lib/referee/cli.rb

@@ -0,0 +1,108 @@
+module Referee
+  # Command line interface.
+  # Thanks to http://pewpewthespells.com/blog/buildsettings.html for the list
+  # of valid Xcode build variables.
+  class CLI
+    def initialize(args)
+      @config = parse_args(args)
+      validate_config
+    end
+
+    public
+
+    def execute
+      build_output.info "referee v#{VERSION} starting..."
+      load_project
+      generate_code
+    end
+
+    private
+
+    def parse_args(args)
+      # Build optparse instance to go through all command line parameters.
+      options = { project: default_project_directory,
+                  prefix: nil,
+                  output: default_output_directory,
+                  error_on_missing_storyboard_ids: false,
+                  verbose: false }
+
+      optparse = OptionParser.new do |opts|
+        opts.on('-x', '--xcode-project PROJECT', 'Set the Xcode project to parse') do |proj|
+          options[:project] = proj
+        end
+
+        opts.on('-p', '--prefix PREFIX', 'Set the class prefix for generated code') do |prefix|
+          options[:prefix] = prefix
+        end
+
+        opts.on('-o', '--output OUTPUT', 'Output generated files to this directory') do |output|
+          options[:output] = output
+        end
+
+        opts.on('-e', '--error-on-missing-ids', 'Issue errors on missing storyboard IDs') do
+          options[:error_on_missing_storyboard_ids] = true
+        end
+
+        opts.on('-v', '--verbose', 'Enable verbose mode') do
+          options[:verbose] = true
+        end
+
+        opts.on('-h', '--help', 'Display this screen') do
+          puts opts
+          Kernel.exit
+        end
+
+        opts.on('--version', 'Display version info') do
+          puts "v#{VERSION}"
+          Kernel.exit
+        end
+      end
+
+      # Parse arguments and convert to `Configuration` type.
+      optparse.parse!(args)
+      Configuration.new(options)
+    end
+
+    def validate_config
+      output_valid = File.exist?(@config.output) && File.writable?(@config.output)
+      build_output.die 'Class prefix must be provided' unless @config.prefix
+      build_output.die 'Output directory must exist and be writable' unless output_valid
+      build_output.die 'An Xcode project is required!' unless @config.project
+      build_output.die 'Xcode project must exist!' unless File.exist?(@config.project)
+      build_output.info 'Loaded and validated configuration...'
+    end
+
+    def default_project_directory
+      # Attempt to find a compiling project.
+      ENV['PROJECT_FILE_PATH']
+    end
+
+    def default_output_directory
+      # Assume standard <project_directory>/<project_name>/... for source.
+      # Otherwise, just output to the current directory.
+      proj_dir = ENV['PROJECT_DIR']
+      proj_name = ENV['PROJECT_NAME']
+
+      if proj_dir && proj_name
+        File.join proj_dir, proj_name
+      else
+        Dir.pwd
+      end
+    end
+
+    def load_project
+      build_output.info 'Parsing project resources...'
+      @project = Project.new_with_config(@config)
+    end
+
+    def generate_code
+      build_output.info 'Generating code...'
+      @generator = CodeGenerator.new(@project, @config)
+      @generator.generate!
+    end
+
+    def build_output
+      @build_output ||= BuildOutput.new(@config)
+    end
+  end
+end

data/lib/referee/codegenerator.rb

@@ -0,0 +1,60 @@
+module Referee
+  # Code generation module. Outputs to a .h/.m file specified by configuration.
+  class CodeGenerator
+    def initialize(project, config)
+      @project = project
+      @config = config
+    end
+
+    public
+
+    def generate!
+      # Substitute out template information.
+      iface = renderer.render_interface(dictionary_representation)
+      impl = renderer.render_implementation(dictionary_representation)
+
+      # Generate paths.
+      interface_path = resource_file('h')
+      implementation_path = resource_file('m')
+
+      # Write to files.
+      File.write(interface_path, iface)
+      File.write(implementation_path, impl)
+    end
+
+    private
+
+    def dictionary_representation
+      @dictionary_representation ||= create_dictionary_representation
+    end
+
+    # Converts the resources into a Mustache-compatible template dictionary.
+    def create_dictionary_representation
+      dict = { storyboards: [],
+               table_cells: [],
+               collection_cells: [],
+               view_controllers: [],
+               segues: [],
+               prefix: @config.prefix }
+
+      @project.resources.each do |group|
+        dict[:storyboards] << group.storyboard
+        dict[:table_cells] += group.table_cells
+        dict[:collection_cells] += group.collection_cells
+        dict[:view_controllers] += group.view_controllers
+        dict[:segues] += group.segues
+      end
+
+      dict
+    end
+
+    def resource_file(extension)
+      filename = "#{@config.prefix}Resources.#{extension}"
+      File.join(@config.output, filename)
+    end
+
+    def renderer
+      @render ||= TemplateRenderer.new
+    end
+  end
+end

data/lib/referee/configuration.rb

@@ -0,0 +1,12 @@
+module Referee
+  # Configuration container.
+  class Configuration
+    attr_accessor :project, :prefix, :output, :error_on_missing_storyboard_ids, :verbose
+
+    def initialize(config)
+      config.each do |key, value|
+        send("#{key}=", value)
+      end
+    end
+  end
+end

data/lib/referee/project.rb

@@ -0,0 +1,94 @@
+module Referee
+  # Helper subclass of `Xcode::Project`.
+  # Provides accessors into resources, etc.
+  class Project < ::Xcodeproj::Project
+    STORYBOARD_FILETYPE = 'file.storyboard'
+    VIEW_CONTROLLER_TAGS = %w(viewController
+                              tableViewController
+                              navigationController
+                              glkViewController
+                              pageViewController
+                              collectionViewController
+                              splitViewController
+                              avPlayerViewController
+                              tabBarController)
+
+    attr_accessor :config, :resources
+
+    # Instantiate a new `Project` instance given a `Configuration`.
+    def self.new_with_config(config)
+      project = new(config.project)
+      project.initialize_from_file
+      project.config = config
+      project.parse_project
+      project
+    end
+
+    def parse_project
+      @resources = []
+
+      find_storyboards.each do |storyboard|
+        # Parse out XML representation.
+        xml = storyboard_xml(storyboard)
+        table_cells = table_cells(xml)
+        collection_cells = collection_cells(xml)
+        view_controllers = view_controllers(xml)
+        non_empty_view_controllers = view_controllers.compact.uniq
+        segues = segues(xml)
+
+        # Add to resources collection
+        group = ResourceGroup.new(storyboard, table_cells, collection_cells, non_empty_view_controllers, segues)
+        @resources << group
+
+        # Check for missing view controller IDs in this storyboard.
+        if non_empty_view_controllers.count != view_controllers.count
+          msg = "Missing view controller ID(s) in '#{group.storyboard_name}' storyboard!"
+
+          if @config.error_on_missing_storyboard_ids
+            build_output.die msg
+          else
+            build_output.warn msg
+          end
+        end
+      end
+    end
+
+    private
+
+    # Search project for files matching the known storyboard type.
+    def find_storyboards
+      all_files = files
+      all_files.keep_if { |f| f.last_known_file_type == STORYBOARD_FILETYPE }
+    end
+
+    def storyboard_xml(storyboard)
+      file = File.open(storyboard.real_path)
+      Nokogiri::XML(file)
+    end
+
+    def table_cells(xml)
+      cells = xml.css('tableViewCell')
+      cells.map { |n| n['reuseIdentifier'] }.compact.uniq
+    end
+
+    def collection_cells(xml)
+      cells = xml.css('collectionViewCell')
+      cells.map { |n| n['reuseIdentifier'] }.compact.uniq
+    end
+
+    def view_controllers(xml)
+      selector = VIEW_CONTROLLER_TAGS.join(',')
+      controllers = xml.css(selector)
+      controllers.map { |n| n['storyboardIdentifier'] }
+    end
+
+    def segues(xml)
+      segues = xml.css('segue')
+      segues.map { |n| n['identifier'] }.compact.uniq
+    end
+
+    def build_output
+      @build_output ||= BuildOutput.new(@config)
+    end
+  end
+end

data/lib/referee/renderable.rb

@@ -0,0 +1,34 @@
+module Referee
+  # Abstract class defining how renderable resources must behave.
+  class Renderable
+    attr_accessor :type
+
+    def initialize
+      fail 'Abstract class Renderable may not be instantiated!'
+    end
+
+    # NOTE: Subclasses must implement this method.
+    def declaration
+      fail 'Subclasses must implement declaration()!'
+    end
+
+    # NOTE: Subclasses must implement this method.
+    def implementation
+      fail 'Subclasses must implement implementation()!'
+    end
+
+    def methodize_name(name)
+      name.gsub(/[^a-zA-Z0-9]/, '')
+    end
+
+    def simple_method_declaration(name)
+      clean_name = methodize_name(name)
+      "- (#{@type})#{clean_name};"
+    end
+
+    def simple_method_implementation(name, body)
+      clean_name = methodize_name(name)
+      "- (#{@type})#{clean_name}\n{\n\treturn #{body};\n}"
+    end
+  end
+end

data/lib/referee/renderables/collectioncell.rb

@@ -0,0 +1,17 @@
+module Referee
+  # Renderable implementation for UICollectionViewCell identifiers embedded in storyboards.
+  class CollectionCell < Renderable
+    def initialize(identifier)
+      @identifier = identifier
+      @type = 'NSString *'
+    end
+
+    def declaration
+      simple_method_declaration @identifier
+    end
+
+    def implementation
+      simple_method_implementation @identifier, "@\"#{@identifier}\""
+    end
+  end
+end

data/lib/referee/renderables/segue.rb

@@ -0,0 +1,17 @@
+module Referee
+  # Renderable implementation for segue identifiers embedded in storyboards.
+  class Segue < Renderable
+    def initialize(identifier)
+      @identifier = identifier
+      @type = 'NSString *'
+    end
+
+    def declaration
+      simple_method_declaration @identifier
+    end
+
+    def implementation
+      simple_method_implementation @identifier, "@\"#{@identifier}\""
+    end
+  end
+end

data/lib/referee/renderables/storyboard.rb

@@ -0,0 +1,18 @@
+module Referee
+  # Renderable implementation for UIStoryboards in a project.
+  class Storyboard < Renderable
+    def initialize(name)
+      @name = name
+      @type = 'UIStoryboard *'
+    end
+
+    def declaration
+      simple_method_declaration @name
+    end
+
+    def implementation
+      body = "[UIStoryboard storyboardWithName:@\"#{@name}\" bundle:[NSBundle mainBundle]]"
+      simple_method_implementation @name, body
+    end
+  end
+end

data/lib/referee/renderables/tablecell.rb

@@ -0,0 +1,17 @@
+module Referee
+  # Renderable implementation for UITableViewCell identifiers embedded in storyboards.
+  class TableCell < Renderable
+    def initialize(identifier)
+      @identifier = identifier
+      @type = 'NSString *'
+    end
+
+    def declaration
+      simple_method_declaration @identifier
+    end
+
+    def implementation
+      simple_method_implementation @identifier, "@\"#{@identifier}\""
+    end
+  end
+end

data/lib/referee/renderables/viewcontroller.rb

@@ -0,0 +1,22 @@
+module Referee
+  # Renderable implementation for UIViewControllers embedded in storyboards.
+  class ViewController < Renderable
+    attr_accessor :name, :storyboard
+
+    def initialize(name, storyboard)
+      @name = name
+      @storyboard = storyboard
+      @type = 'UIViewController *'
+    end
+
+    def declaration
+      simple_method_declaration @name
+    end
+
+    def implementation
+      body = "[[UIStoryboard storyboardWithName:@\"#{@storyboard}\" bundle:[NSBundle mainBundle]] " \
+             "instantiateViewControllerWithIdentifier:@\"#{@name}\"]"
+      simple_method_implementation @name, body
+    end
+  end
+end

data/lib/referee/resourcegroup.rb

@@ -0,0 +1,39 @@
+module Referee
+  # Representation of all of the resources contained in a given storyboard.
+  class ResourceGroup
+    attr_accessor :storyboard, :table_cells, :collection_cells, :view_controllers, :segues
+
+    def initialize(storyboard, table_cells, collection_cells, view_controllers, segues)
+      @storyboard = storyboard
+      @table_cells = table_cells
+      @collection_cells = collection_cells
+      @view_controllers = view_controllers
+      @segues = segues
+    end
+
+    def storyboard_name
+      basename = File.basename(@storyboard.real_path)
+      basename.gsub(/\.storyboard/, '')
+    end
+
+    def storyboard
+      Storyboard.new(storyboard_name)
+    end
+
+    def table_cells
+      @table_cells.map { |c| TableCell.new(c) }
+    end
+
+    def collection_cells
+      @collection_cells.map { |c| CollectionCell.new(c) }
+    end
+
+    def view_controllers
+      @view_controllers.map { |c| ViewController.new(c, storyboard_name) }
+    end
+
+    def segues
+      @segues.map { |c| Segue.new(c) }
+    end
+  end
+end

data/lib/referee/templaterenderer.rb

@@ -0,0 +1,32 @@
+module Referee
+  # Manages finding and rendering code templates to strings.
+  class TemplateRenderer
+    INTERFACE_TEMPLATE_NAME = 'interface.h'
+    IMPLEMENTATION_TEMPLATE_NAME = 'implementation.m'
+
+    private
+
+    def filepath_from_root(path)
+      app_dir = File.dirname(File.expand_path(__FILE__))
+      File.join(app_dir, '../..', path)
+    end
+
+    def template(name)
+      path = filepath_from_root(File.join('resources', name))
+      contents = File.read(path)
+      proc { |dict| ::Mustache.render(contents, dict) }
+    end
+
+    public
+
+    # Renders the implementation (.m) file as a string.
+    def render_implementation(dict)
+      template(IMPLEMENTATION_TEMPLATE_NAME).call(dict)
+    end
+
+    # Renders the interface (.h) file as a string.
+    def render_interface(dict)
+      template(INTERFACE_TEMPLATE_NAME).call(dict)
+    end
+  end
+end

data/lib/referee/version.rb

@@ -0,0 +1,4 @@
+# Version information.
+module Referee
+  VERSION = '0.1.1'
+end

data/lib/referee.rb

@@ -0,0 +1,28 @@
+# Standard library dependencies.
+require 'optparse'
+
+# Third party dependencies.
+require 'mustache'
+require 'nokogiri'
+require 'rubygems'
+require 'xcodeproj'
+
+# Internal modules, etc.
+require 'referee/buildoutput'
+require 'referee/cli'
+require 'referee/configuration'
+require 'referee/codegenerator'
+require 'referee/project'
+require 'referee/renderable'
+require 'referee/renderables/collectioncell'
+require 'referee/renderables/segue'
+require 'referee/renderables/storyboard'
+require 'referee/renderables/tablecell'
+require 'referee/renderables/viewcontroller'
+require 'referee/resourcegroup'
+require 'referee/templaterenderer'
+require 'referee/version'
+
+# Main module declaration.
+module Referee
+end

data/objc-referee.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'referee/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'objc-referee'
+  spec.version       = Referee::VERSION
+  spec.authors       = ['Colin Drake']
+  spec.email         = ['colin.f.drake@gmail.com']
+
+  spec.summary       = 'Resource file generator for Objective-C.'
+  spec.description   = 'Resource file generator for Objective-C. Parses Xcode projects and ' \
+                       'creates a .m/.h file of compile-time checked resources.'
+  spec.homepage      = 'http://dynamit.com'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.8'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rubocop', '~> 0.33.0'
+  spec.add_development_dependency 'pry', '~> 0.10.1'
+  spec.add_development_dependency 'rubygems-tasks', '~> 0.2.4'
+
+  spec.add_runtime_dependency 'xcodeproj', '~> 0.20.1'
+  spec.add_runtime_dependency 'mustache', '~> 1.0', '>= 1.0.2'
+  spec.add_runtime_dependency 'nokogiri', '~> 1.6', '>= 1.6.6.2'
+end

data/resources/implementation.m

@@ -0,0 +1,76 @@
+#import "{{ prefix }}Resources.h"
+
+/** UIStoryboard accessors. */
+@implementation __{{ prefix }}Storyboards
+
+{{# storyboards #}}
+{{{ implementation }}}
+{{/ storyboards }}
+
+@end
+
+/** UITableViewCell identifier accessors. */
+@implementation __{{ prefix }}TableViewCells
+
+{{# table_cells #}}
+{{{ implementation }}}
+{{/ table_cells }}
+
+@end
+
+/** UICollectionViewCell identifier accessors. */
+@implementation __{{ prefix }}CollectionViewCells
+
+{{# collection_cells #}}
+{{{ implementation }}}
+{{/ collection_cells }}
+
+@end
+
+/** UIViewController accessors. */
+@implementation __{{ prefix }}ViewControllers
+
+{{# view_controllers #}}
+{{{ implementation }}}
+{{/ view_controllers }}
+
+@end
+
+/** Segue identifier accessors. */
+@implementation __{{ prefix }}Segues
+
+{{# segues #}}
+{{{ implementation }}}
+{{/ segues }}
+
+@end
+
+/** Main resource reference class. */
+@implementation __{{ prefix }}Resources
+
+- (instancetype)init
+{
+    self = [super init];
+
+    if (self) {
+        self.storyboards = [[__{{ prefix }}Storyboards alloc] init];
+        self.tableCells = [[__{{ prefix }}TableViewCells alloc] init];
+        self.collectionCells = [[__{{ prefix }}CollectionViewCells alloc] init];
+        self.viewControllers = [[__{{ prefix }}ViewControllers alloc] init];
+        self.segues = [[__{{ prefix }}Segues alloc] init];
+    }
+
+    return self;
+}
+
++ (instancetype)sharedInstance
+{
+    static id _self = nil;
+    static dispatch_once_t once_Token;
+    dispatch_once(&once_Token, ^{
+      _self = [[super alloc] init];
+    });
+    return _self;
+}
+
+@end

data/resources/interface.h

@@ -0,0 +1,59 @@
+@import UIKit;
+
+/** ATTENTION: Use this macro to access resources. */
+#define {{ prefix }}Resources ([__{{ prefix }}Resources sharedInstance])
+
+@interface __{{ prefix }}Storyboards : NSObject
+
+{{# storyboards #}}
+{{{ declaration }}}
+{{/ storyboards }}
+
+@end
+
+@interface __{{ prefix }}TableViewCells : NSObject
+
+{{# table_cells #}}
+{{{ declaration }}}
+{{/ table_cells }}
+
+@end
+
+@interface __{{ prefix }}CollectionViewCells : NSObject
+
+{{# collection_cells #}}
+{{{ declaration }}}
+{{/ collection_cells }}
+
+@end
+
+@interface __{{ prefix }}ViewControllers : NSObject
+
+{{# view_controllers #}}
+{{{ declaration }}}
+{{/ view_controllers }}
+
+@end
+
+@interface __{{ prefix }}Segues : NSObject
+
+{{# segues #}}
+{{{ declaration }}}
+{{/ segues }}
+
+@end
+
+/** Global resource reference accessor class. */
+@interface __{{ prefix }}Resources : NSObject
+
+/** Singleton accessor. */
++ (instancetype)sharedInstance;
+
+/** Resource accessors. */
+@property (nonatomic, strong) __{{ prefix }}Storyboards *storyboards;
+@property (nonatomic, strong) __{{ prefix }}TableViewCells *tableCells;
+@property (nonatomic, strong) __{{ prefix }}CollectionViewCells *collectionCells;
+@property (nonatomic, strong) __{{ prefix }}ViewControllers *viewControllers;
+@property (nonatomic, strong) __{{ prefix }}Segues *segues;
+
+@end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: objc-referee
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Colin Drake
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-09-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.33.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.33.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+- !ruby/object:Gem::Dependency
+  name: xcodeproj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.1
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !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'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.6.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.6.2
+description: Resource file generator for Objective-C. Parses Xcode projects and creates
+  a .m/.h file of compile-time checked resources.
+email:
+- colin.f.drake@gmail.com
+executables:
+- referee
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/referee
+- lib/referee.rb
+- lib/referee/buildoutput.rb
+- lib/referee/cli.rb
+- lib/referee/codegenerator.rb
+- lib/referee/configuration.rb
+- lib/referee/project.rb
+- lib/referee/renderable.rb
+- lib/referee/renderables/collectioncell.rb
+- lib/referee/renderables/segue.rb
+- lib/referee/renderables/storyboard.rb
+- lib/referee/renderables/tablecell.rb
+- lib/referee/renderables/viewcontroller.rb
+- lib/referee/resourcegroup.rb
+- lib/referee/templaterenderer.rb
+- lib/referee/version.rb
+- objc-referee.gemspec
+- resources/implementation.m
+- resources/interface.h
+homepage: http://dynamit.com
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Resource file generator for Objective-C.
+test_files: []