ProMotion 0.0.1 → 0.0.2

data/.gitignore

@@ -15,3 +15,7 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+.repl_history
+build
+build/*
+*.000

data/Gemfile

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

data/ProMotion.gemspec

@@ -2,13 +2,15 @@
 require File.expand_path('../lib/ProMotion/version', __FILE__)
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["Jamon Holmgren"]
+  gem.authors       = ["Jamon Holmgren", "Silas Matson", "ClearSight Studio"]
   gem.email         = ["jamon@clearsightstudio.com"]
-  gem.description   = "ProMotion is a new way to organize RubyMotion apps."
-  gem.summary       = "ProMotion is a new way to organize RubyMotion apps. Instead of dealing
+  gem.description   = "ProMotion is a new way to organize RubyMotion apps. Currently a proof of concept."
+  gem.summary       = "
+                        ProMotion is a new way to organize RubyMotion apps. Instead of dealing
                         with UIViewControllers and UIViews, you work with Screens. Screens are
-                        a logical way to think of your app."
-  gem.homepage      = ""
+                        a logical way to think of your app -- similar in some ways to Storyboards.
+                      "
+  gem.homepage      = "https://github.com/clearsightstudio/ProMotion"
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/README.md

@@ -45,13 +45,13 @@ Or install it yourself as:
 
 ## Usage
 
-It's easy to load your first view with a navigation bar (the view is opened in a UINavigationController):
+It's easy to load your first screen with a navigation bar (the screen is opened in a UINavigationController behind the scenes):
 
 ```ruby
-# In /app/app_delegate.rb:
-class AppDelegate
+# In /app/app_delegate.rb (note that AppDelegate extends ProMotion::AppDelegate)
+class AppDelegate < ProMotion::AppDelegate
   def application(application, didFinishLaunchingWithOptions:launchOptions)
-    @window = HomeScreen.open_with_nav_bar
+    open_with_nav_bar HomeScreen
 
     true
   end
@@ -66,7 +66,7 @@ class HomeScreen < ProMotion::Screen
   # Set the title for use in nav bars and other containers
   title "Home"
 
-  # Called when this view is first "opened" and allows you to set up your view
+  # Called when this screen is first "opened" and allows you to set up your view components
   def on_load
     @default_image = add_image(:default_image, src: "default.png", frame: [10, 50, 100, 100])
   end
@@ -81,7 +81,6 @@ class HomeScreen < ProMotion::Screen
   # Set the title for use in nav bars and other containers
   title "Home"
 
-  # Called when this view is first "opened" and allows you to set up your view
   def on_load
     # Add view items as instance vars so you can access them in other methods
 
@@ -100,7 +99,7 @@ class HomeScreen < ProMotion::Screen
 end
 ```
 
-View items can be bound to events (like jQuery) and run methods or run a block.
+View components can be bound to events (like jQuery) and run methods or run a block.
 
 ```ruby
 # settings_pushed is executed when the button is tapped
@@ -117,11 +116,19 @@ end
 @edit_button.on(:tap, :edit_pushed, id: 4)
 ```
 
-To open other screens, just call their "open" method:
+To open other screens, just call the built-in "open" method on a new instance or class:
 
 ```ruby
 def settings_button_tapped
-  SettingsScreen.open
+  # ...with a class...
+  open SettingsScreen
+
+  # ...or with an instance...
+  @settings_screen = SettingsScreen.new(some_attr: 4)
+  open @settings_screen
+
+  # ...or if you like...
+  open SettingsScreen.new
 end
 ```
 
@@ -146,7 +153,7 @@ class HomeScreen < ProMotion::Screen
   # ...
 
   def settings_button_tapped
-    SettingsScreen.open(user_type: "Admin")
+    open SettingsScreen.new(user_type: "Admin")
   end
 end
 ```
@@ -156,7 +163,7 @@ When you're done with a screen, just close it:
 ```ruby
 def save_and_close
   if @model.save
-    self.close
+    close
   end
 end
 ```
@@ -168,7 +175,7 @@ class SettingsScreen < ProMotion::Screen
   # ...
 
   def save_and_close
-    self.close(saved_changes: true)
+    close(saved_changes: true)
   end
 end
 
@@ -238,7 +245,7 @@ class HomeScreen < ProMotion::Screen
   # Defaults to :normal. :plain_table, :grouped_table are options.
   screen_type :plain_table
 
-  # Called when this view is first "opened" and allows you to set up your view
+  # Called when this screen is first "opened" and allows you to set up your view components
   def on_load
     # Add view items as instance vars so you can access them in other methods
     # This adds a right nav bar button. on_tap allows you to set a method to call when it's tapped.
@@ -294,12 +301,12 @@ class HomeScreen < ProMotion::Screen
     # Assuming some sort of ORM, like ParseModel
     @my_model.save
     
-    # When you want to close the current view (usually in a navigation controller), just run this.
-    self.close
+    # When you want to close the current screen (usually in a navigation controller), just run this.
+    close
 
-    # You can also pass back arguments to the previous view as you close.
+    # You can also pass back arguments to the previous screen as you close.
     # If the previous screen has an `on_return` method, this will be passed into that method
-    self.close(did_stuff: true)
+    close(did_stuff: true)
   end
 
   # This is called any time a screen "above" this screen is closed. args = {} is required.
@@ -312,17 +319,20 @@ class HomeScreen < ProMotion::Screen
   # Custom method
   def settings_pushed
     # Just open a settings screen
-    SettingsScreen.open
+    open SettingsScreen
+
+    # If you prefer to pass in an instance, that works too:
+    open SettingsScreen.new
   end
 
   def close_pushed
-    self.close
+    close
   end
 
   # Custom method with passed in arguments
   def edit_pushed(args)
     # Open a screen and set some of its attributes
-    EditScreen.open(id: args[:id])
+    open EditScreen.new(id: args[:id])
   end
 end
 ```

data/Rakefile

@@ -1,2 +1,5 @@
-#!/usr/bin/env rake
-require "bundler/gem_tasks"
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project'
+require 'bundler/gem_tasks'
+Bundler.setup
+Bundler.require

data/lib/ProMotion.rb

@@ -1,5 +1,11 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
 require "ProMotion/version"
 
-module ProMotion
-  # Your code goes here...
-end
+Motion::Project::App.setup do |app|
+  Dir.glob(File.join(File.dirname(__FILE__), "ProMotion/*.rb")).each do |file|
+    app.files.unshift(file)
+  end
+end

data/lib/ProMotion/AppDelegate.rb

@@ -0,0 +1,7 @@
+module ProMotion
+  class AppDelegate
+    class << self
+      
+    end
+  end
+end

data/lib/ProMotion/Screen.rb

@@ -0,0 +1,11 @@
+module ProMotion
+  class Screen
+    def open_with_nav_bar
+      # Create UINavigationController, insert view
+    end
+
+    def open
+      # Push view onto existing UINavigationController
+    end
+  end
+end

data/lib/ProMotion/version.rb

@@ -1,3 +1,3 @@
 module ProMotion
-  VERSION = "0.0.1"
+  VERSION = "0.0.2" unless defined?(MotionTable::VERSION)
 end

metadata

@@ -1,17 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: ProMotion
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
 - Jamon Holmgren
+- Silas Matson
+- ClearSight Studio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-30 00:00:00.000000000 Z
+date: 2012-08-31 00:00:00.000000000 Z
 dependencies: []
-description: ProMotion is a new way to organize RubyMotion apps.
+description: ProMotion is a new way to organize RubyMotion apps. Currently a proof
+  of concept.
 email:
 - jamon@clearsightstudio.com
 executables: []
@@ -25,8 +28,10 @@ files:
 - README.md
 - Rakefile
 - lib/ProMotion.rb
+- lib/ProMotion/AppDelegate.rb
+- lib/ProMotion/Screen.rb
 - lib/ProMotion/version.rb
-homepage: ''
+homepage: https://github.com/clearsightstudio/ProMotion
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -51,5 +56,5 @@ signing_key:
 specification_version: 3
 summary: ProMotion is a new way to organize RubyMotion apps. Instead of dealing with
   UIViewControllers and UIViews, you work with Screens. Screens are a logical way
-  to think of your app.
+  to think of your app -- similar in some ways to Storyboards.
 test_files: []