ProMotion 0.4.0 → 0.4.1

data/.gitignore

@@ -13,3 +13,4 @@ pom.xml
 *.clj
 .repl_histroy
 .rvmrc
+*.gem

data/README.md

@@ -13,16 +13,34 @@ Typical app file structure:
 
     app/
       screens/
-        photos/
-          list_photos_screen.rb
-          show_photo_screen.rb
-          edit_photo_screen.rb
+        events/
+          list_events_screen.rb
+          show_event_screen.rb
+          edit_event_screen.rb
         home_screen.rb
         settings_screen.rb
       models/
+        event.rb
       views/
+        buttons/
+          save_event_button_view.rb
       app_delegate.rb
 
+## What's New in 0.4.0?
+
+* Screens are now UIViewControllers (they used to contain UIViewControllers, but that got too funky) so you can do normal UIViewController stuff with them
+* Screen functionality can also be inherited as a module in your own UIViewController, but you need to provide your own methods for viewDidLoad and whatnot.
+* Tons of headlessCamelCaps methods are now properly_ruby_underscored (with an alias to the old name for compatibility)
+* `open_screen` and `close_screen` can now just be `open` and `close` respectively
+* Attempted to keep 100% compatibility with 0.3.x but no guarantees...report issues, please!
+* Revamped the internal folder structure of the gem...more work on this to come
+* Built in a few helpers that were external before, like `content_height(view)`
+* More consistent calling of `on_load` (sometimes doesn't get called in 0.3.x)
+* `fresh_start SomeScreen` is now `open_root_screen SomeScreen`
+* Removed `set_view_controller` as we don't need it anymore
+* Better documentation (still needs work), better error messages
+* Deprecation warnings EVERYWHERE for older apps (upgrade already!)
+
 ## Usage
 
 Loading your home screen:
@@ -164,17 +182,6 @@ class MainScreen < ProMotion::Screen
 end
 ```
 
-Use a custom view controller:
-
-```ruby
-def on_load
-  set_view_controller MyCustomViewController
-  
-  # Note: on_appear will not fire when using a custom 
-  # view controller.
-end
-```
-
 The helper add_element takes any view object and adds it to the current view. You can also use
 the helper ProMotion::ViewHelper.set_attributes(view, attributes) to do the same thing without adding
 it to the current view. Screens include this helper by default.
@@ -245,6 +252,61 @@ your Rakefile and doing this:
   ]
 ```
 
+## Using your own UIViewController or Formotion
+
+Sometimes you want to inherit from a different UIViewController than that provided by ProMotion,
+such as when using [Formotion](https://github.com/clayallsopp/formotion). RubyMotion doesn't currently allow us to override built-in methods
+when including as a module, so there's a workaround for that.
+
+```ruby
+class EventsScreen < Formotion::FormController # Can also be < UIViewController
+  include ProMotion::ScreenModule # Not TableScreenModule since we're using Formotion for that
+
+  # Required functions for ProMotion to work properly
+
+  def viewDidLoad
+    super
+    self.view_did_load if self.respond_to?(:view_did_load)
+  end
+
+  def viewWillAppear(animated)
+    super
+    self.view_will_appear(animated) if self.respond_to?("view_will_appear:")
+  end
+
+  def viewDidAppear(animated)
+    super
+    self.view_did_appear(animated) if self.respond_to?("view_did_appear:")
+  end
+  
+  def viewWillDisappear(animated)
+    self.view_will_disappear(animated) if self.respond_to?("view_will_disappear:")
+    super
+  end
+  
+  def viewDidDisappear(animated)
+    self.view_did_disappear(animated) if self.respond_to?("view_did_disappear:")
+    super      
+  end
+
+  def shouldAutorotateToInterfaceOrientation(orientation)
+    self.should_rotate(orientation)
+  end
+
+  def shouldAutorotate
+    self.should_autorotate
+  end
+
+  def willRotateToInterfaceOrientation(orientation, duration:duration)
+    self.will_rotate(orientation, duration)
+  end
+  
+  def didRotateFromInterfaceOrientation(orientation)
+    self.on_rotate
+  end
+end
+```
+
 # Reference
 (not comprehensive yet...working on this)
 

metadata

@@ -1,27 +1,37 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: ProMotion
-version: !ruby/object:Gem::Version
-  version: 0.4.0
+version: !ruby/object:Gem::Version 
+  hash: 13
   prerelease: 
+  segments: 
+  - 0
+  - 4
+  - 1
+  version: 0.4.1
 platform: ruby
-authors:
+authors: 
 - Jamon Holmgren
 - Silas Matson
 - ClearSight Studio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-05 00:00:00.000000000 Z
+
+date: 2013-02-21 00:00:00 Z
 dependencies: []
+
 description: ProMotion is a new way to easily build RubyMotion iOS apps.
-email:
+email: 
 - jamon@clearsightstudio.com
 - silas@clearsightstudio.com
 - contact@clearsightstudio.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
 - .repl_history
 - Gemfile
@@ -60,29 +70,36 @@ files:
 - lib/ProMotion/version.rb
 homepage: https://github.com/clearsightstudio/ProMotion
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: ProMotion is a new way to organize RubyMotion apps. Instead of dealing with
-  UIViewControllers, you work with Screens. Screens are a logical way to think of
-  your app and include a ton of great utilities to make iOS development more like
-  Ruby and less like Objective-C.
+summary: ProMotion is a new way to organize RubyMotion apps. Instead of dealing with UIViewControllers, you work with Screens. Screens are a logical way to think of your app and include a ton of great utilities to make iOS development more like Ruby and less like Objective-C.
 test_files: []
+