ambient-xcode 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 98615ee39dc25f247d8064579087ebdf523a796a
+  data.tar.gz: 7c0663d987218c7d8426e4957d12000d04ae7c43
+SHA512:
+  metadata.gz: c504951669259411ab0d46c4c6423356afd05c913b2078fc0f77d7a9715d377d170e23d0fb7b8d7a50f66e9ea8308d447aa337a6db8819163ae0302c8868d16e
+  data.tar.gz: 0b4bf94607805be90413cd7cc3219bfcc5f2f2611be0ee37f8b592447768070113d3fd9276f19f121fa84b8e3f9d87d25a817980f90c25dddc81330e6e2ef8c6

data/README.md

@@ -0,0 +1,59 @@
+Ambient environment for Xcode projects
+======================================
+
+Ambient lets you define all of your xcode project environment settings all in one easy to read Ruby file, and re-apply it to your Xcode project to ensure settings are correct.
+
+An `xcconfig` file can be used in order to help abstract your settings away from the main project file. The disadvantage of `xcconfig` files though is that they can still be overridden by settings defined in the project. Ambient doesn't have this issue as it simply overwrites the values in the project file.
+
+Installation
+============
+
+Add the following to your `Gemfile`:
+```
+gem "ambient-xcode", git: "https://github.com/Dan2552/ambient-xcode"
+```
+
+Usage
+=====
+
+Create an `Ambientfile` defining your project in the same directory as your `*.xcodeproj` file.
+
+Here's an example of the `Ambientfile` structure:
+```ruby
+enable_warnings_and_static_analyser!
+use_defaults_for_everything_not_specified_in_this_file!
+
+option "IPHONEOS_DEPLOYMENT_TARGET", "7.0"
+option "SDKROOT", "iphoneos"
+option "CLANG_ENABLE_OBJC_ARC", true
+option "CLANG_ENABLE_MODULES", true
+
+target "MyProject" do
+  scheme "Debug" do
+    option "PRODUCT_NAME", "Debug"
+    option "BUNDLE_DISPLAY_NAME_SUFFIX", "uk.danielgreen.MyProject"
+  end
+end
+```
+
+run `ambient` from the command line to write your settings into your project.
+
+Notes
+=====
+
+- You can re-run `ambient` as many times as possible.
+- Use the `use_defaults_for_everything_not_specified_in_this_file!` setting to ensure your project file is clean. Warning though: this setting will clear all your targets' settings, so be sure to define absolutely every setting in the `Ambientfile` if you want to use this.
+- When defining settings directly within a target, the setting is set to each scheme.
+
+
+Possible future features
+========================
+
+- Defining capabilities (per target if possible... using `.entitlements` maybe)
+- Helper method to change build phases to default
+- Version number + build number
+- Team ID
+- Provisioning profiles from searching by name rather than storing a uuid (so it actually works across teams)
+- `Info.plist` definitions
+- ?
+- Ability to not have to commit `*.xcodeproj` into version control (maybe too far?)

data/ambient-xcode.gemspec

@@ -0,0 +1,21 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |gem|
+  gem.name          = 'ambient-xcode'
+  gem.version       = '0.1.0'
+  gem.authors       = ['Daniel Green']
+  gem.email         = ['dan2552@gmail.com']
+  gem.description   = %q{CLI for configuring Xcode projects from a Ruby file.}
+  gem.summary       = %q{Define your envrionment settings all in one easy to read Ruby file, and re-apply it to your Xcode project to ensure settings are correct.}
+  gem.homepage      = 'https://github.com/Dan2552/ambient'
+  gem.license       = 'MIT'
+
+  gem.add_dependency 'xcodeproj', '~> 0.25'
+  gem.add_dependency 'highline', '~> 1.6'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+end

data/bin/ambient

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+require 'fileutils'
+
+$:.push File.expand_path("../../lib", __FILE__)
+
+require 'ambient'
+Ambient.setup_project

data/lib/ambient.rb

@@ -0,0 +1,110 @@
+unless Kernel.respond_to?(:require_relative)
+  module Kernel
+    def require_relative(path)
+      require File.join(File.dirname(caller[0]), path.to_str)
+    end
+  end
+end
+
+require_relative 'project_helper'
+require_relative 'dsl'
+
+module Ambient
+  extend self
+  Ambient::ROOT = File.expand_path('.', File.dirname(__FILE__))
+
+  @use_defaults = false
+  @project_options = {}
+  @shared_target_options = {}
+  @target_options = {}
+  @parents = {}
+  def configure(&block)
+    instance_eval &block
+  end
+
+  def project_helper
+    @project_helper ||= ProjectHelper.new
+  end
+
+  def set_parent_target(target, child, parent)
+    @parents[target] ||= {}
+    @parents[target][child] = parent
+  end
+
+  def set_option(option, value, target: nil, scheme: nil, parent: nil)
+    value = "YES" if value == true
+    value = "NO" if value == false
+    value = nil if value == :default
+
+    if target
+      if scheme
+        @target_options[target] ||= {}
+        @target_options[target][scheme] ||= {}
+        @target_options[target][scheme][option] = value
+      else
+        # require 'pry'; binding.pry
+        @shared_target_options[target] ||= {}
+        @shared_target_options[target][option] = value
+      end
+    else
+      @project_options[option] = value
+    end
+  end
+
+  def setup_project
+    project_helper.print_info
+    reset_project_to_defaults
+    reset_targets_to_defaults
+    process_project_options
+    process_shared_target_options
+    process_target_options
+  end
+
+  def reset_project_to_defaults
+    if @use_defaults
+      puts "resetting project settings to xcode default settings"
+      project_helper.reset_project_to_defaults
+    end
+  end
+
+  def reset_targets_to_defaults
+    if @use_defaults
+      puts "resetting target settings to xcode default settings"
+      project_helper.reset_targets_to_defaults
+    end
+  end
+
+  def process_project_options
+    puts "applying ambient project settings"
+    project_helper.process_project_options(@project_options)
+  end
+
+  def process_shared_target_options
+    puts "applying ambient shared target settings"
+    project_helper.process_shared_target_options(@shared_target_options)
+  end
+
+  def process_target_options
+    puts "applying ambient target settings"
+    load_in_parent_target_values
+    project_helper.process_target_options(@target_options)
+  end
+
+  def load_in_parent_target_values
+    @parents.each do |target, parents|
+      parents.each do |child, parent|
+        if parent
+          options = @target_options[target]
+          child_options = options[child]
+          parent_options = options[parent]
+          child_options.merge!(parent_options) { |_, child, _| child }
+        end
+      end
+    end
+  end
+
+  ambient = File.join(Dir.pwd, 'Ambientfile')
+  raise "ambient not found" unless File.exists?(ambient)
+
+  load ambient
+end

data/lib/dsl.rb

@@ -0,0 +1,87 @@
+def option(name, value)
+  Ambient.configure { set_option(name, value) }
+end
+
+def enable_warnings_and_static_analyser!
+  warnings = %w(GCC_WARN_INITIALIZER_NOT_FULLY_BRACKETED
+    GCC_WARN_MISSING_PARENTHESES
+    GCC_WARN_ABOUT_RETURN_TYPE
+    GCC_WARN_SIGN_COMPARE
+    GCC_WARN_CHECK_SWITCH_STATEMENTS
+    GCC_WARN_UNUSED_FUNCTION
+    GCC_WARN_UNUSED_LABEL
+    GCC_WARN_UNUSED_VALUE
+    GCC_WARN_UNUSED_VARIABLE
+    GCC_WARN_SHADOW
+    GCC_WARN_64_TO_32_BIT_CONVERSION
+    GCC_WARN_ABOUT_MISSING_FIELD_INITIALIZERS
+    GCC_WARN_UNDECLARED_SELECTOR
+    GCC_WARN_TYPECHECK_CALLS_TO_PRINTF
+    GCC_WARN_UNINITIALIZED_AUTOS
+    CLANG_WARN_INT_CONVERSION
+    CLANG_WARN_ENUM_CONVERSION
+    CLANG_WARN_CONSTANT_CONVERSION
+    CLANG_WARN_BOOL_CONVERSION
+    CLANG_WARN_EMPTY_BODY
+    CLANG_WARN_SUSPICIOUS_IMPLICIT_CONVERSION
+    CLANG_WARN__DUPLICATE_METHOD_MATCH
+    GCC_WARN_64_TO_32_BIT_CONVERSION
+    RUN_CLANG_STATIC_ANALYZER
+    GCC_TREAT_WARNINGS_AS_ERRORS)
+  warnings.each { |w| option(w, true) }
+end
+
+def target(name, &block)
+  TargetScope.new(name).configure(&block)
+end
+
+def use_defaults_for_everything_not_specified_in_this_file!
+  Ambient.configure { @use_defaults = true }
+end
+
+class TargetScope
+  attr_reader :name
+
+  def initialize(name)
+    @name = name
+  end
+
+  def configure(&block)
+    instance_eval(&block)
+  end
+
+  def option(option_name, value)
+    target_name = @name
+    Ambient.configure { set_option(option_name, value, target: target_name) }
+  end
+
+  def scheme(name, parent: nil, &block)
+    SchemeScope.new(self, name, parent).configure(&block)
+  end
+end
+
+class SchemeScope
+  def initialize(target, name, parent)
+    @target = target
+    @name = name
+    @parent = parent
+
+    child = name
+    Ambient.configure { set_parent_target(target.name, child, parent) }
+  end
+
+  def configure(&block)
+    instance_eval(&block)
+  end
+
+  def option(option_name, value)
+    target = @target
+    name = @name
+    parent = @parent
+
+    Ambient.configure do
+      # require 'pry'; binding.pry
+      set_option(option_name, value, target: target.name, scheme: name, parent: parent)
+    end
+  end
+end

data/lib/project_helper.rb

@@ -0,0 +1,79 @@
+require 'xcodeproj'
+require 'highline/import'
+
+class ProjectHelper
+  PROJECTS = Dir.glob('*.xcodeproj')
+
+  def initialize
+    @project = Xcodeproj::Project.open(PROJECTS.first)
+  end
+
+  def reset_project_to_defaults
+    @project.build_configurations.each do |configuration|
+      build_settings = configuration.build_settings
+      build_settings.each { |k, _| build_settings.delete(k) }
+    end
+    save_changes
+  end
+
+  def reset_targets_to_defaults
+    @project.targets.each do |target|
+      @project.build_configurations.each do |configuration|
+        build_settings = target.build_configuration_list.build_settings(configuration.to_s)
+        build_settings.each { |k, _| build_settings.delete(k) }
+      end
+    end
+  end
+
+  def process_project_options(options)
+    @project.build_configurations.each do |configuration|
+      options.each do |key, value|
+        configuration.build_settings[key] = value
+        configuration.build_settings.delete(key) if value == nil
+      end
+    end
+    save_changes
+  end
+
+  def process_shared_target_options(shared_target_options)
+    @project.targets.each do |target|
+      options = shared_target_options[target.to_s]
+      if options
+        @project.build_configurations.each do |configuration|
+          target.build_configuration_list.build_settings(configuration.to_s).merge!(options)
+        end
+      end
+    end
+    save_changes
+  end
+
+  def process_target_options(target_options)
+    @project.targets.each do |target|
+      options = target_options[target.to_s]
+      if options
+        @project.build_configurations.each do |configuration|
+          scheme_options = options[configuration.to_s]
+          if scheme_options
+            target.build_configuration_list.build_settings(configuration.to_s).merge!(scheme_options)
+          end
+        end
+      end
+    end
+    save_changes
+  end
+
+  def print_info
+    puts "Targets:"
+    @project.targets.each { |t| puts "- #{t.to_s}" }
+    puts ""
+    puts "Build configurations:"
+    @project.build_configurations.each { |c| puts "- #{c.to_s}" }
+    puts ""
+  end
+
+  private
+
+  def save_changes
+    @project.save
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: ambient-xcode
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Green
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: xcodeproj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: CLI for configuring Xcode projects from a Ruby file.
+email:
+- dan2552@gmail.com
+executables:
+- ambient
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- ambient-xcode.gemspec
+- bin/ambient
+- lib/ambient.rb
+- lib/dsl.rb
+- lib/project_helper.rb
+homepage: https://github.com/Dan2552/ambient
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Define your envrionment settings all in one easy to read Ruby file, and re-apply
+  it to your Xcode project to ensure settings are correct.
+test_files: []