motion.h 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3563f032b9abc0292b0a360b3c7314fc6eb8334
-  data.tar.gz: dda1f773593647d5588514b5a625368c7595072a
+  metadata.gz: be4b20cc5a9df900392e473d3bffcc51f5e3a52d
+  data.tar.gz: 409003301af6fdc598cad5d2120568ab8791aefa
 SHA512:
-  metadata.gz: 250a6333b2536b6bab308c0dbbe58cb970e78593f08de68ad4c5bc0b146cc762c1f8b79b57cbc75f23107fd249a51c13e5c8bd95362bd97e28d893aa3194328d
-  data.tar.gz: 6059442158529d4a6b50e9313de1c83740a16d30aceeec7dd5f6c84fce5aea39f533f620656b23e6e0c98995d3241a50c119ccb106839cf81306476431e84dee
+  metadata.gz: a8a11705edb6e7749d15e559d836faf5134ca7c9a22815ea6337248aca3370f34ecc3bfe572bc915d6d61e346d4b81b72dcf16067c0dc7a15a453df6694b3188
+  data.tar.gz: dd945be80a47f5c4880725ad978c58817ccaf37dbb4a8a80b2f6a2b80b2c7d01d91b58e8a0c539f5d46d2c46d79dfeb76f1d3b1b7d60df98992b03b351b14b7e

data/README.md

@@ -1,6 +1,6 @@
 # motion.h
 
-Include iOS system libraries in RubyMotion.
+Expose iOS system C libraries in RubyMotion.
 
 Outside of the usual Apple frameworks, iOS includes many system C libraries,
 with the most well known examples being [SQLite](http://www.sqlite.org/), and
@@ -12,6 +12,13 @@ C API, and this is what `motion.h` takes care of. Simply declare the header
 files needed, just like in C, and now RubyMotion code can call directly into
 the specified system library, without having to write an Objective-C wrapper.
 
+Note, BridgeSupport only supports C libraries, C++ support does not exist.
+
+RubyMotion's Runtime Guide includes a section called [Interfacing with
+C](http://www.rubymotion.com/developer-center/guides/runtime/#_interfacing_with_c),
+which is a must read for learning how to interact with C libraries in
+RubyMotion.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -26,12 +33,12 @@ Or install it yourself as:
 
     $ gem install motion.h
 
-## Examples
-
-In your `Rakefile`:
+## Getting Started
 
 ### SQLite
 
+In the `Rakefile`:
+
 ```ruby
 Motion::Project::App.setup do |config|
   config.libs << '/usr/lib/libsqlite3.dylib'
@@ -39,8 +46,17 @@ Motion::Project::App.setup do |config|
 end
 ```
 
+Example: Creating an in-memory database:
+
+```ruby
+db = Pointer.new(Sqlite3.type)
+sqlite3_open(':memory', db)
+```
+
 ### Objective-C Runtime
 
+In the `Rakefile`:
+
 ```ruby
 Motion::Project::App.setup do |config|
   config.include 'objc/runtime.h'

data/lib/motion.h.rb

@@ -3,8 +3,12 @@ unless defined? Motion::Project::Config
 end
 
 class Motion::Project::Config
-  def include(header_file, output_dir=nil)
-    MotionHeader.new(header_file, self, output_dir).integrate
+  # @param [String] header_file Requested C header file.
+  # @param [Hash] options Options for customizing BridgeSupport file generation
+  # @option options [String] :prefix Subdirectory of /usr/include used for root of included header files.
+  # @option options [String] :bridgesupport_dir Path where the generated bridgesupport file is saved. Defaults to ./build
+  def include(header_file, options={})
+    MotionHeader.new(header_file, self, options).integrate
   end
 end
 
@@ -14,11 +18,14 @@ class MotionHeader
 
   # @param [String] header_file Requested C header file.
   # @param [Motion::Project::Config] config RubyMotion config provided in App.setup.
-  # @param [String] bridgesupport_dir Path where the generated bridgesupport file is saved. Defaults to ./build.
-  def initialize(header_file, config, bridgesupport_dir=BRIDGESUPPORT_DIR)
+  # @param [Hash] options Options for customizing BridgeSupport file generation
+  # @option options [String] :prefix Subdirectory of /usr/include used for root of included header files.
+  # @option options [String] :bridgesupport_dir Path where the generated bridgesupport file is saved. Defaults to ./build
+  def initialize(header_file, config, options={})
     @header_file = header_file
     @config = config
-    @bridgesupport_dir = bridgesupport_dir || BRIDGESUPPORT_DIR
+    @prefix = options[:prefix]
+    @bridgesupport_dir = options[:bridgesupport_dir] || BRIDGESUPPORT_DIR
   end
 
   def integrate
@@ -39,7 +46,12 @@ class MotionHeader
   end
 
   def include_path
-    "#{@config.xcode_dir}/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS#{@config.sdk_version}.sdk/usr/include"
+    path_components = [@config.xcode_dir, *sdk_dir(@config.sdk_version), 'usr', 'include', @prefix].compact
+    File.join(*path_components)
+  end
+
+  def sdk_dir(sdk_version)
+    ['Platforms', 'iPhoneOS.platform', 'Developer', 'SDKs', "iPhoneOS#{sdk_version}.sdk"]
   end
 
   def bridgesupport_file

data/motion.h.gemspec

@@ -1,11 +1,11 @@
 # coding: utf-8
 Gem::Specification.new do |spec|
   spec.name          = "motion.h"
-  spec.version       = '0.0.1'
+  spec.version       = '0.0.2'
   spec.authors       = ["Dave Lee"]
   spec.email         = ['dave@kastiglione.com']
-  spec.description   = 'Include iOS system libraries in RubyMotion'
-  spec.summary       = 'Include iOS system libraries in RubyMotion'
+  spec.description   = 'Expose iOS system C libraries in RubyMotion'
+  spec.summary       = 'Expose iOS system C libraries in RubyMotion'
   spec.homepage      = 'https://github.com/kastiglione/motion.h'
   spec.license       = "MIT"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: motion.h
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Dave Lee
@@ -38,7 +38,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: Include iOS system libraries in RubyMotion
+description: Expose iOS system C libraries in RubyMotion
 email:
 - dave@kastiglione.com
 executables: []
@@ -75,6 +75,6 @@ rubyforge_project:
 rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
-summary: Include iOS system libraries in RubyMotion
+summary: Expose iOS system C libraries in RubyMotion
 test_files: []
 has_rdoc: