sc-frank-cucumber 1.2.1.00af28c

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_reset.scss

@@ -0,0 +1,32 @@
+/* css reset based on the work by eric meyer */
+html,body {position:relative;margin:0;padding:0;min-height:100%;width:100%;height:100%;}
+div,p,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,p,blockquote,th,td, keygen, select, button, button::-moz-focus-inner, isindex, hr {margin:0;padding:0;}
+table {border-collapse:collapse;border-spacing:0;}
+fieldset,img {border:0;}
+input, textarea{border:none;outline:none;padding:none;background-color:#fff;}
+address,caption,cite,code,dfn,th,var {font-style:normal;font-weight:normal;}
+ol,ul {list-style:none;}
+li {list-style-type: none;}
+caption,th {text-align:left;}
+em, strong {font-style: normal; font-weight: normal;}
+h1,h2,h3,h4,h5,h6 {font-size:100%;font-weight:normal;}
+q:before,q:after {content:'';}
+abbr,acronym {border:0;}
+a, a:hover, a:visited, a:active, a:link {text-decoration:none;}
+form {display: block;}
+textarea:focus, input:focus, select:focus {outline: none;}
+input, textarea, keygen, select, button, isindex { font: inherit; color: inherit; letter-spacing: inherit; word-spacing: inherit; line-height: inherit; text-transform: none; text-indent: 0; text-shadow: inherit; display: inline-block; text-align: inherit; border: none; }
+/* html5 block elements for IE. Stop using IE. */
+article, aside, details, figcaption, figure, footer, header, hgroup, nav, section, address {display: block;}
+.clear, .clearfloat {clear:both;}
+h1,h2,h3,h4,h5,h6 {font-size: 1.0em; }
+
+/* save your sanity */
+* {
+  -webkit-box-sizing: border-box;
+   -khtml-box-sizing: border-box;
+    -icab-box-sizing: border-box;
+     -moz-box-sizing: border-box;
+       -o-box-sizing: border-box;
+          box-sizing: border-box;
+}

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_selector_test_toolbar.scss

@@ -0,0 +1,81 @@
+//----------------------------------------------
+// horizontal layout
+$wrap-middle-width: 60%;
+$wrap-outter-width: (100% - $wrap-middle-width)/2;
+//----------------------------------------------
+
+#selector-test {
+  position: relative;
+  text-align: center;
+  padding: $selector-test-toolbar-vt-padding 0;
+  .wrap {
+    display: inline-block;
+    position: relative;
+    vertical-align: middle;
+    padding: 0 .5em;
+    &.middle { width: $wrap-middle-width; }
+    &.outter { width: $wrap-outter-width; }
+  }//.wrap
+
+  #query { width: 100%; }
+
+  label {
+    display: block;
+    text-align: left;
+    text-transform: capitalize;
+    &:after {
+      content: "#{$arrow-right-down}";
+      font-size: .8em;
+      font-weight: bold;
+      padding-left: .3em;
+    }
+  }//label
+}//#selector-test
+
+$drop-indicator-width: 2em;
+
+.dropdown {
+  position: relative;
+  display: block;
+  width: 100%;
+
+  * { z-index: $dropdown-child-z; }
+
+  button {
+    position: relative;
+    width: 100%;
+    padding-left: .8em;
+    padding-right: $drop-indicator-width;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }//button
+
+  ul {
+    position: absolute;
+    top: 100%;
+    width: 100%;
+    float: left;
+    opacity: 0;
+    visibility: hidden;
+    @include transition-two( visibility 0s linear 0.2s,opacity 0.2s linear );
+    &.shown {
+      opacity: 1;
+      visibility:visible;
+      @include transition-delay( 0s );
+    }//&.shown
+  }//ul
+
+  .drop-indicator {
+    color: #eee;
+    position: absolute;
+    width: $drop-indicator-width;
+    right: 0;
+    top: 6px;
+    bottom: 6px;
+    border-left: 1px solid white;
+    text-align: center;
+    cursor: pointer;
+    @include user-select( none );
+  }//.drop-indicator
+}//.dropdown

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_solarized.scss

@@ -0,0 +1,16 @@
+$base03:          #002b36 !default; //darkest blue
+$base02:          #073642 !default; //dark blue
+$base01:          #586e75 !default; //darkest gray
+$base00:          #657b83 !default; //dark gray
+$base0:           #839496 !default; //medium gray
+$base1:           #93a1a1 !default; //medium light gray
+$base2:           #eee8d5 !default; //cream
+$base3:           #fdf6e3 !default; //white
+$solar-yellow:    #b58900 !default;
+$solar-orange:    #cb4b16 !default;
+$solar-red:       #dc322f !default;
+$solar-magenta:   #d33682 !default;
+$solar-violet:    #6c71c4 !default;
+$solar-blue:      #268bd2 !default;
+$solar-cyan:      #2aa198 !default;
+$solar-green:     #859900 !default;

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_typography.scss

@@ -0,0 +1,11 @@
+$sans: "Helvetica Neue", "HelveticaNeue", Arial;
+
+$base-font-size: 16px;
+$base-line-height: 24px;
+$label-line-height: $base-line-height;
+
+
+@mixin light-text {
+  color: #fff;
+  text-shadow: 0 -1px rgba(0,0,0, .3);
+}

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_unicode.scss

@@ -0,0 +1,3 @@
+$arrow-right-down: "\21b4";
+$arrow-down-right: "\21b3";
+$arrow-right: "\2192";

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/_z_index.scss

@@ -0,0 +1,2 @@
+$ui-locator-view-z: -1;
+$dropdown-child-z: 1;

data/frank-skeleton/frank_static_resources.bundle/stylesheets/sass/symbiote.scss

@@ -0,0 +1,26 @@
+//-------------------------------
+// primary application file
+// all partials should be loaded here.
+//-------------------------------
+// base
+@import "_unicode.scss";
+@import "_mixins.sass";
+@import "_solarized.scss";
+@import "_typography.scss";
+@import "_z_index.scss";
+//----------------------------------
+@import "_reset.scss";
+@import "_elements.scss";
+//----------------------------------
+// global layout affords control
+// over container heights.
+@import "_layout.scss";
+//----------------------------------
+// partials
+@import "_header.scss";
+@import "_selector_test_toolbar.scss";
+@import "_inspect_tabs_list_tabs.scss";
+//-------------------------------
+// vender
+@import "_jquery.treeview.scss";
+@import "_jqui.scss";

data/frank-skeleton/frankify.xcconfig.tt

@@ -0,0 +1,6 @@
+INSTALL_PATH = /./
+
+FRANK_CORE_LDFLAGS = -all_load -ObjC -framework CFNetwork -framework Security <%= @libs.map { |lib| "-l#{lib}" }.join(' ') %>
+FRANK_CORE_MAC_LDFLAGS = -all_load -ObjC -framework CFNetwork -framework Security <%= @libsMac.map { |lib| "-l#{lib}" }.join(' ') %>
+
+GCC_PREPROCESSOR_DEFINITIONS_NOT_USED_IN_PRECOMPS = FRANKIFIED

data/lib/frank-cucumber.rb

@@ -0,0 +1,15 @@
+require 'frank-cucumber/rect'
+require 'frank-cucumber/color_helper'
+require 'frank-cucumber/frank_helper'
+require 'frank-cucumber/frank_mac_helper'
+require 'frank-cucumber/launcher'
+require 'frank-cucumber/mac_launcher'
+
+World(Frank::Cucumber::ColorHelper)
+World(Frank::Cucumber::FrankHelper)
+World(Frank::Cucumber::FrankMacHelper)
+World(Frank::Cucumber::Launcher)
+
+AfterConfiguration do
+  require 'frank-cucumber/core_frank_steps'
+end

data/lib/frank-cucumber/app_bundle_locator.rb

@@ -0,0 +1,58 @@
+module Frank module Cucumber
+  class XCode4Project
+    def initialize( workspace_path, derived_dir )
+      @workspace_path, @derived_dir = workspace_path, derived_dir 
+    end
+
+    def derived_name
+      File.basename( @derived_dir )
+    end
+
+    def project_name
+      derived_name.split('-')[0]
+    end
+
+    def workspace_dir
+      File.dirname( @workspace_path )
+    end
+
+    def available_app_bundles
+      Dir.glob( File.join( @derived_dir, "Build", "Products", "*", "*.app" ) )
+    end
+
+  end
+
+  # utility class which will find all XCode4 projects which are using DerivedData to store their
+  # build output, and present information about those projects
+  class AppBundleLocator
+    def initialize
+      @projects = find_all_known_xcode_projects
+    end
+
+    def find_all_known_xcode_projects
+      require 'plist'
+
+      projects = []
+      Dir.glob( File.expand_path( "~/Library/Developer/Xcode/DerivedData/*/info.plist" ) ) do |plist_path|
+        workspace_path = Plist::parse_xml(plist_path)['WorkspacePath']
+        projects << XCode4Project.new( workspace_path, File.dirname(plist_path) )
+      end
+      projects
+    end
+
+    def guess_possible_app_bundles_for_dir( dir )
+      return [] if dir == '/'
+
+      project = @projects.find do |project|
+        project.workspace_dir == dir
+      end
+
+      if project.nil?
+        return guess_possible_app_bundles_for_dir( File.dirname(dir) )
+      end
+
+      return project.available_app_bundles
+    end
+
+  end
+end end

data/lib/frank-cucumber/bonjour.rb

@@ -0,0 +1,73 @@
+require 'timeout'
+require 'uri'
+
+module Frank module Cucumber
+class Bonjour
+
+  FRANK_SERVICE_NAME = 'Frank UISpec server'
+  FRANK_PORT = 37265
+  LOOKUP_TIMEOUT = 10
+
+  def debug string
+    puts string if $DEBUG
+  end
+
+  def found_a_frank( reply )
+    debug reply.inspect
+    unless reply.flags.add?
+      debug 'got a non-add reply'
+      debug "flags: #{reply.flags.to_a.inspect}"
+      return nil
+    end
+
+    resolve_service = DNSSD::Service.new
+    addr_service = DNSSD::Service.new
+    resolve_service.resolve reply do |r|
+      debug "#{r.name} on #{r.target}:#{r.port}"
+
+      address = nil
+      addr_service.getaddrinfo r.target do |addrinfo|
+        address = addrinfo.address
+        break
+      end
+
+      debug "first address for #{r.target} is #{address}"
+      return address
+    end
+  end
+
+  def browse_for_franks_address
+    require 'dnssd'
+
+    DNSSD.browse! '_http._tcp.' do |reply|
+      debug 'got a reply'
+      if reply.name == FRANK_SERVICE_NAME 
+        address = found_a_frank(reply)
+        if address
+          debug "OK WE HAVE AN ADDRESS: #{address}"
+          return address
+        end
+      end
+    end
+  end
+
+  def lookup_frank_base_uri
+    puts "finding Frank server via Bonjour..."
+    address = begin
+      Timeout::timeout(LOOKUP_TIMEOUT){ address = browse_for_franks_address }
+    rescue Timeout::Error
+      puts "could not find Frank within #{LOOKUP_TIMEOUT} seconds"
+    end
+
+    if address
+      puts "...found Frank via Bonjour: #{address}"
+      return URI::HTTP.new( 'http', nil, address, FRANK_PORT, nil, nil, nil, nil, nil )
+    else
+      puts '...failed to find Frank server via Bonjour'
+      return nil
+    end
+  end
+
+end
+
+end end

data/lib/frank-cucumber/cli.rb

@@ -0,0 +1,299 @@
+begin
+  require 'pry'
+rescue LoadError
+end
+
+require 'thor'
+require 'frank-cucumber/launcher'
+require 'frank-cucumber/console'
+require 'frank-cucumber/frankifier'
+require 'frank-cucumber/mac_launcher'
+require 'frank-cucumber/plugins/plugin'
+
+module Frank
+  class CLI < Thor
+    include Thor::Actions
+
+    def self.source_root
+      File.join( File.dirname(__FILE__), '..','..','frank-skeleton' )
+    end
+
+    # included just because the old setup script was called frank-skeleton
+    desc "skeleton", "an alias for setup"
+    def skeleton
+      invoke :setup
+    end
+
+    WITHOUT_SERVER = "without-cocoa-http-server"
+    WITHOUT_ASYNC_SOCKET = "without-cocoa-async-socket"
+    WITHOUT_LUMBERJACK = "without-cocoa-lumberjack"
+    desc "setup", "set up your iOS app by adding a Frank subdirectory containing everything Frank needs"
+    method_option WITHOUT_SERVER, :type => :boolean
+    method_option WITHOUT_ASYNC_SOCKET, :type => :boolean
+    method_option WITHOUT_LUMBERJACK, :type => :boolean
+    method_option :build_configuration, :aliases=>'--conf', :type=>:string, :default => 'Debug'
+    method_option :target, :type=>:string
+    method_option :project, :type=>:string
+    def setup
+      @libs = %w(Shelley CocoaAsyncSocket CocoaLumberjack CocoaHTTPServer Frank)
+      @libsMac = %w(ShelleyMac CocoaAsyncSocketMac CocoaLumberjackMac CocoaHTTPServerMac FrankMac)
+      @libs -= %w(CocoaHTTPServer) if options[WITHOUT_SERVER]
+      @libsMac -= %w(CocoaHTTPServerMac) if options[WITHOUT_SERVER]
+      @libs -= %w(CocoaAsyncSocket) if options[WITHOUT_ASYNC_SOCKET]
+      @libsMac -= %w(CocoaAsyncSocketMac) if options[WITHOUT_ASYNC_SOCKET]
+      @libs -= %w(CocoaLumberjack) if options[WITHOUT_LUMBERJACK]
+      @libsMac -= %w(CocoaLumberjackMac) if options[WITHOUT_LUMBERJACK]
+      directory ".", "Frank"
+
+      Frankifier.frankify!( File.expand_path('.'), :build_config => options[:build_configuration], :target => options[:target], :project => options[:project] )
+    end
+
+    desc "update", "updates the frank server components inside your Frank directory"
+    long_desc "This updates the parts of Frank that are embedded inside your app (e.g. libFrank.a and frank_static_resources.bundle)"
+    def update
+      %w{libFrank.a libCocoaAsyncSocket.a libCocoaLumberjack.a libCocoaHTTPServer.a libShelley.a libFrankMac.a libShelleyMac.a libCocoaAsyncSocketMac.a libCocoaLumberjackMac.a libCocoaHTTPServerMac.a}.each do |f|
+        copy_file f, File.join( 'Frank', f ), :force => true
+      end
+      directory( 'frank_static_resources.bundle', 'Frank/frank_static_resources.bundle', :force => true )
+
+      if yes? "\nOne or more static libraries may have been updated. For these changes to take effect the 'frankified_build' directory must be cleaned. Would you like me to do that now? Type 'y' or 'yes' to delete the contents of frankified_build."
+        remove_file('Frank/frankified_build')
+      end
+    end
+
+    XCODEBUILD_OPTIONS = %w{workspace project scheme target configuration}
+    desc "build [<buildsetting>=<value>]...", "builds a Frankified version of your native app"
+    XCODEBUILD_OPTIONS.each do |option|
+      method_option option
+    end
+
+    WITHOUT_DEPS = 'without-dependencies'
+    method_option 'no-plugins', :type => :boolean, :default => false, :aliases => '--np', :desc => 'Disable plugins'
+    method_option 'arch', :type => :string, :default => 'i386'
+    method_option 'mac', :type => :string, :default => false
+    method_option :noclean, :type => :boolean, :default => false, :aliases => '--nc', :desc => "Don't clean the build directory before building"
+    method_option WITHOUT_DEPS, :type => :array, :desc => 'An array (space separated list) of plugin dependencies to exclude'
+    def build(*args)
+      clean = !options['noclean']
+      use_plugins = !options['no-plugins']
+      exclude_dependencies = options[WITHOUT_DEPS] || []
+
+      in_root do
+        unless File.directory? 'Frank'
+          if yes? "You don't appear to have set up a Frank directory for this project. Would you like me to set that up now? Type 'y' or 'yes' if so."
+            invoke :skeleton
+          else
+            say "OK, in that case there's not much I can do for now. Whenever you change your mind and want to get your project setup with Frank simply run `frank setup` from the root of your project directory."
+            say "Bye bye for now!"
+            exit 11
+          end
+        end
+      end
+
+      static_bundle = 'frank_static_resources.bundle'
+
+      if clean
+        remove_dir build_output_dir
+      end
+
+      build_steps = 'build'
+      if clean
+        build_steps = 'clean ' + build_steps
+      end
+
+      plugins = use_plugins ? gather_plugins : []
+
+      say "Detected plugins: #{plugins.map {|p| p.name}.join(', ')}" unless plugins.empty?
+
+      say "Excluding plugin dependencies: #{exclude_dependencies.join(', ')}" unless exclude_dependencies.empty?
+
+      plugins.each {|plugin| plugin.write_xcconfig(exclude_dependencies)}
+
+      xcconfig_data = Frank::Plugins::Plugin.generate_core_xcconfig(plugins)
+
+      xcconfig_file = 'Frank/frank.xcconfig'
+      File.open(xcconfig_file,'w') {|f| f.write(xcconfig_data) }
+
+      extra_opts = XCODEBUILD_OPTIONS.map{ |o| "-#{o} \"#{options[o]}\"" if options[o] and (o != "target" or options['workspace'] == nil)}.compact.join(' ')
+
+      # If there is a scheme specified we don't want to inject the default configuration
+      # If there is a configuration specified, we also do not want to inject the default configuration
+      if options['scheme'] || options['configuration']
+        separate_configuration_option = ""
+      else
+        separate_configuration_option = "-configuration Debug"
+      end
+
+      xcodebuild_args = args.join(" ")
+
+      if options['mac']
+        run %Q|xcodebuild -xcconfig #{xcconfig_file} #{build_steps} #{extra_opts} #{separate_configuration_option} DEPLOYMENT_LOCATION=YES DSTROOT="#{build_output_dir}" FRANK_LIBRARY_SEARCH_PATHS="#{frank_lib_search_paths}" #{xcodebuild_args}|
+      else
+        extra_opts += " -arch #{options['arch']}"
+
+        run %Q|xcodebuild -xcconfig #{xcconfig_file} #{build_steps} #{extra_opts} #{separate_configuration_option} -sdk iphonesimulator ONLY_ACTIVE_ARCH=NO DEPLOYMENT_LOCATION=YES DSTROOT="#{build_output_dir}" FRANK_LIBRARY_SEARCH_PATHS="#{frank_lib_search_paths}" #{xcodebuild_args}|
+      end
+      exit $?.exitstatus if not $?.success?
+
+      app = Dir.glob("#{build_output_dir}/*.app").delete_if { |x| x =~ /\/#{app_bundle_name}$/ }
+      app = app.first
+      FileUtils.cp_r("#{app}/.", frankified_app_dir)
+
+      if options['mac']
+        in_root do
+          FileUtils.cp_r(
+            File.join( 'Frank',static_bundle),
+            File.join( frankified_app_dir, "Contents", "Resources", static_bundle )
+          )
+        end
+      else
+        fix_frankified_apps_bundle_identifier
+
+        in_root do
+          FileUtils.cp_r(
+            File.join( 'Frank',static_bundle),
+            File.join( frankified_app_dir, static_bundle )
+          )
+        end
+      end
+    end
+
+    desc "build_and_launch", "rebuild a Frankfied version of your app then launch"
+    def build_and_launch
+      invoke :build
+      invoke :launch
+    end
+
+    desc "launch", "open the Frankified app in the simulator"
+    method_option :debug, :type => :boolean, :default => false
+    method_option :idiom, :banner => 'iphone|ipad', :type => :string, :default => (ENV['FRANK_SIM_IDIOM'] || 'iphone')
+    def launch
+      $DEBUG = options[:debug]
+      launcher = case options[:idiom].downcase
+      when 'iphone'
+        SimLauncher::DirectClient.for_iphone_app( frankified_app_dir )
+      when 'ipad'
+        SimLauncher::DirectClient.for_ipad_app( frankified_app_dir )
+      else
+        say "idiom must be either iphone or ipad. You supplied '#{options[:idiom]}'", :red
+        exit 10
+      end
+
+      in_root do
+        unless File.exists? frankified_app_dir
+          say "A Frankified version of the app doesn't appear to have been built. Building one now"
+          say "..."
+          invoke :build
+        end
+
+        if built_product_is_mac_app( frankified_app_dir )
+          launcher = Frank::MacLauncher.new( frankified_app_dir )
+          say "LAUNCHING APP..."
+        else
+          say "LAUNCHING IN THE SIMULATOR..."
+        end
+
+        launcher.relaunch
+      end
+    end
+
+    desc "inspect", "launch Symbiote in the browser"
+    long_desc "launch Symbiote in the browser so you can inspect the live state of your Frankified app"
+    def inspect
+      # TODO: check whether app is running (using ps or similar), and launch it if it's not
+      run 'open http://localhost:37265'
+    end
+
+    desc 'console', "launch a ruby console connected to your Frankified app"
+    method_option :bonjour, :type => :boolean, :default => false, :aliases => :b, :desc => "find Frank via Bonjour." 
+    method_option :server, :type => :string, :default => false, :aliases => :s, :desc => "server URL for Frank."
+    def console
+      # TODO: check whether app is running (using ps or similar), and launch it if it's not
+
+      begin
+        require 'pry'
+      rescue LoadError
+        say 'The Frank console requires the pry gem.'
+        say 'Simply run `sudo gem install pry` (the `sudo` bit might be optional), and then try again. Thanks!'
+        exit 41
+      end
+
+      Frank::Cucumber::FrankHelper.use_shelley_from_now_on
+      console = Frank::Console.new
+      Frank::Cucumber::FrankHelper.test_on_physical_device_via_bonjour if options[:bonjour]
+      Frank::Cucumber::FrankHelper.server_base_url = options[:server] if options[:server]
+      if console.check_for_running_app
+        console.pry
+      end
+    end
+
+    private
+
+    def product_name
+      "Frankified"
+    end
+
+    def app_bundle_name
+      "#{product_name}.app"
+    end
+
+    def frank_lib_directory
+      File.expand_path "Frank"
+    end
+
+    def frank_lib_search_paths
+      paths = [frank_lib_directory]
+      each_plugin_path do |path|
+        paths << path
+      end
+
+      paths.map {|path| %Q[\\"#{path}\\"]}.join(' ')
+    end
+
+    def build_output_dir
+      File.expand_path "Frank/frankified_build"
+    end
+
+    def frankified_app_dir
+      File.join( build_output_dir, app_bundle_name )
+    end
+
+    def plugin_dir
+      File.expand_path 'Frank/plugins'
+    end
+
+    def built_product_is_mac_app ( app_dir )
+        return File.exists? File.join( app_dir, "Contents", "MacOS" )
+    end
+
+    def fix_frankified_apps_bundle_identifier
+      # as of iOS 6 the iOS Simulator locks up with a black screen if you try and launch an app which has the same
+      # bundle identifier as a previously installed app but which is in fact a different app. This impacts us because our
+      # Frankified app is different but has the same bundle identifier as the standard non-Frankified app which most users
+      # will want to have installed in the simulator as well.
+      #
+      # We work around this by modifying the Frankified app's bundle identifier inside its Info.plist.
+      inside frankified_app_dir do
+        existing_bundle_identifier = `/usr/libexec/PlistBuddy -c 'Print :CFBundleIdentifier' Info.plist`.chomp
+        new_bundle_identifier = existing_bundle_identifier + '.frankified'
+        run %Q|/usr/libexec/PlistBuddy -c 'Set :CFBundleIdentifier #{new_bundle_identifier}' Info.plist|
+        run %Q|/usr/libexec/PlistBuddy -c 'Set :CFBundleDisplayName Frankified' Info.plist|
+      end
+    end
+
+    def each_plugin_path(&block)
+      plugin_glob = File.join("#{plugin_dir}",'*')
+      Dir[plugin_glob].map do |plugin_path|
+        yield plugin_path
+      end
+    end
+
+    def gather_plugins
+      each_plugin_path do |plugin_path|
+        Frank::Plugins::Plugin.from_plugin_directory(plugin_path)
+      end
+    end
+
+  end
+end
+