motion-prime 0.4.5 → 0.5.0

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: 7e3edc8658a85c7184310acc029dc5a710be493f
-  data.tar.gz: a76dab2b6f08031d9edbd8c23e730a5cc061ac46
-SHA512:
-  metadata.gz: c55504663d7c290007e2d81c04dd28f1633827ab4605c9c23a1480b736324b734bdfde29212072b03f77b13970a69cb274a648ba14e2ad86ba4d3e0071f4b61b
-  data.tar.gz: 12d135885f5dffa9a9017d5f0df862c846a5d5dc3e4ea9b29777a1b6046f97f3052b5558f77ac75a17e972bfec8369899e81311ebf1ec79b79b8c833a785435d
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDU3YTA1M2Q5YjkyMDM0OTcwNDlkNWUxNDIwM2MwY2I3NWY0NjY3Nw==
+  data.tar.gz: !binary |-
+    NDdkNTIwOTc5ZDA0NmJmY2JiN2RlMmZiMWVjMzkxYmUwNTI0YTc3MQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MmQ2OGQ0Y2M0NzFkMDZlMmM4ODZmMTlkMGNiODczNWQwZGE5YmQxOTM2MjM0
+    ZmM1MWNlNzVlZmQ5NzgwN2QxM2IyMDc2MTQzYjY5M2FiOTg4N2I2MDkyNzUx
+    NTU5MmNmMTZhZGE4MWM1ZjY5MGUyZmQxM2Y1NjZiMmRiYWIwMjQ=
+  data.tar.gz: !binary |-
+    MWMxM2RiMjM5M2QyZWVjNWNmOWU4ZjI3MGM3ZmM4OWQ4YmIwZDFhMzU1MTQ0
+    ZjgzYjg1NjY5ZGExNmQ0MTU4NDhmYzI4NzQ4MzlkNTk2ZDRmZTIwNTdjOGJi
+    Y2MyNzg5ZDM4Nzg4MzUyNGU5YTBkMWY0YzNiZDViNWMzMDRhNWM=

data/.gitignore

@@ -5,6 +5,7 @@ app/pixate_code.rb
 resources/*.nib
 resources/*.momd
 resources/*.storyboardc
+files/vendor/
 .DS_Store
 nbproject
 .redcar

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+=== 0.5.0
+* renamed Prime::BaseModel to Prime::Model.
+* renamed Prime::BaseScreen to Prime::Screen.
+* renamed Prime::BaseSection to Prime::Section.
+* Model: sync/sync! separated to update/update! and fetch/fetch!
+* Model: `fetch_associations` option on fetch renamed to `associations` option.
+* Model: `update_from_response` option on update renamed to `save_response` option.
+* Screen: `navigation: true` by default for screen initialization.
+* Model.new with invalid parameter will not raise exception by default now.
+* "id" attribute always being added to model by default now.
+* screen.open_screen do not support root screen opening now. use app_delegate.open_screen for that.
+* added shorter syntax for opening screens.
+* fix rendering draw section without table.
+
 === 0.4.4
 * Added Prime.env support
 * Added Prime.root support

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    motion-prime (0.4.5)
+    motion-prime (0.5.0)
       bubble-wrap
       cocoapods
       methadone

data/README.md

@@ -2,10 +2,7 @@
 
 ![Prime](https://s3-us-west-2.amazonaws.com/webmate/assets/prime.jpg)
 
-MotionPrime is yet another framework written on RubyMotion.
-
-The main feature of MotionPrime is one more layer on UI elements: Section.
-"Section" is something like "Partial" in Ruby On Rails, but it's smarter and will help you build application UI.
+MotionPrime is yet another framework written on RubyMotion for creating really fast iOS applications.
 
 ## Getting Started
 
@@ -27,12 +24,12 @@ The main feature of MotionPrime is one more layer on UI elements: Section.
   # app/app_delegate.rb
   class AppDelegate < Prime::BaseAppDelegate
     def on_load(app, options)
-      open_screen MainScreen.new
+      open_screen :main
     end
   end
 
   # app/screens/main_screen.rb
-  class MainScreen < Prime::BaseScreen
+  class MainScreen < Prime::Screen
     title 'Main screen'
 
     def render
@@ -42,7 +39,7 @@ The main feature of MotionPrime is one more layer on UI elements: Section.
   end
 
   # app/sections/my_profile.rb
-  class MyProfileSection < Prime::BaseSection
+  class MyProfileSection < Prime::Section
     element :title, text: "Hello World"
     element :avatar, image: "images/avatar.png", type: :image
   end
@@ -58,6 +55,11 @@ The main feature of MotionPrime is one more layer on UI elements: Section.
   end
 ```
 
+## Extensions
+
+* [ECSlidingViewController 2 integration](https://github.com/droidlabs/prime_sliding_menu) (Sidebar)
+* [RESideMenu integration](https://github.com/droidlabs/prime_reside_menu) (Sidebar)
+
 ## Contributing
 
 1. Fork it
@@ -68,7 +70,7 @@ The main feature of MotionPrime is one more layer on UI elements: Section.
 
 ## Documentation
 
-We are using Docco (http://jashkenas.github.io/docco/) to generate documentation.
+We are using [Docco](http://jashkenas.github.io/docco/) to generate documentation.
 
 Please install the tool and run this to update documentation:
 

data/ROADMAP.md

@@ -1,17 +1,16 @@
-=== 0.5.0
-* "id" attribute should always be added to model by default
-* fix issue when draw element without table section in parent will not be drawn.
-* Ability to pass "locals" while opening screen.
-* navigation: true by default for screen initialization.
-* separate screen.open_screen to screen.open_child and screen.open_modal.
-* use model.assign_attributes instead of model.fetch_with_attributes and call it on initialization. 
-* separate sync#update and sync#fetch
-
 === 0.6.0
+* add configuration initializer.
+* add cleanup for section events
+* add computed_options.get(), this will allow to make sure that options is computed.
+* add dsl for push notifications
+* add some extensions/middleware system, at least for networking.
+* create "display_network_error" extension.
+
+=== 0.7.0
 * add testing framework
 * add auth backends to ApiClient: password auth and facebook auth
 
-=== 0.7.0
+=== 0.8.0
 * add sections/screens/models generator
 * add DSL for ViewStyles#setValue conditions
 * add auto-symbol-value for Prime::Config.color items

data/Rakefile

@@ -20,7 +20,7 @@ require 'motion-stump'
 require 'motion-redgreen'
 
 Motion::Project::App.setup do |app|
-  app.name = 'MotionPrime'
+  app.name = 'Prime'
   app.pods do
     pod 'NanoStore', '~> 2.7.7'
     pod 'SDWebImage'

data/doc/code/getting_started.rb

@@ -15,7 +15,7 @@ Visit http://www.rubymotion.com
 
 class AppDelegate < Prime::BaseAppDelegate
   def on_load(app, options)
-    open_screen MainScreen.new
+    open_screen :main
   end
 end
 
@@ -25,7 +25,7 @@ end
 #
 # NOTE: it's recommended to use instance variables for sections, e.g. `@main_section` instead of `main_section`.
 
-class MainScreen < Prime::BaseScreen
+class MainScreen < Prime::Screen
   title 'Main screen'
 
   def render
@@ -40,7 +40,7 @@ end
 #
 # Each element will be added to the parent screen when you run `section.render`
 
-class MyProfileSection < Prime::BaseSection
+class MyProfileSection < Prime::Section
   element :title, text: "Hello World"
   element :avatar, image: "images/avatar.png", type: :image
 end

data/doc/code/screens.rb

@@ -5,11 +5,18 @@
 # For RubyOnRails developers the nearest analogy would be "Controllers".
 ---
 
+# ** Create a screen. **
+#
+# Just inherit it from `Prime::Screen`.
+
+class FooScreen < Prime::Screen
+end
+
 # ** Render the screen. **
 #
-# You should rewrite the `render` method of `Prime::BaseScreen`, which will be runned after first opening screen.
+# You should rewrite the `render` method of `Prime::Screen`, which will be runned after first opening screen.
 
-class FooScreen < Prime::BaseScreen
+class FooScreen < Prime::Screen
   def render
     @main_section = MyProfileSection.new(screen: self, model: User.first)
     @main_section.render
@@ -22,13 +29,13 @@ end
 #
 # NOTE: screen should be created with enabled navigation (see "Initialize screen" block).
 
-class FooScreen < Prime::BaseScreen
+class FooScreen < Prime::Screen
   title 'Foo screen'
 end
 
 # You can pass block to define screen's title
 
-class FooScreen < Prime::BaseScreen
+class FooScreen < Prime::Screen
   title { params[:title] }
 end
 
@@ -36,10 +43,10 @@ end
 #
 # Available options:
 # * `:navigation`. When this options is true, screen will be created with navigation support: it will allow adding title and left/right buttons.
-# This option is false by default.
+# This option is true by default.
 
 def open_foo_screen
-  foo_screen = FooScreen.new(navigation: true)
+  foo_screen = FooScreen.new(navigation: false)
 end
 
 # ** Open screen: using app delegate. **
@@ -51,12 +58,13 @@ end
 # You can use root: true when you have already opened screen with sidebar, and you want to open new screen without sidebar.
 # This option is false by default if you already have root screen and true if not.
 #
-# * `:sidebar`. Send `Prime::BaseScreen` instance to this option if you want to create root screen with sidebar. 
-# Value of this options will be used as sidebar controller.
+# * `:sidebar`. Send `Prime::Screen` instance to this option if you want to create root screen with sidebar. 
+# Value of this options will be used as sidebar controller. 
+# NOTE: you should install some gem providing sidebar functionality, e.g. 'prime_reside_menu'
 
 def open_foo_screen
-  foo_screen = FooScreen.new(navigation: true)
-  sidebar = MySidebar.new
+  foo_screen = FooScreen.new
+  sidebar = MySidebar.new(navigation: false)
   app_delegate.open_screen foo_screen, sidebar: sidebar
 end
 
@@ -70,3 +78,10 @@ def open_second_screen
   foo_screen.open_screen second_screen
 end
 
+# ** Open screen: using short version. **
+
+# Opening screen using short syntax available both for opening via app delegate and via parent screen.
+
+foo_screen.open_screen :hello_world
+app_delegate.open_screen :foo_bar, sidebar: true
+

data/doc/code/sections.rb

@@ -0,0 +1,41 @@
+# ** What is a Section? **
+#
+# "Section" is something like "partial" which you may know from RubyOnRails. 
+# In the first look it's just a list of elements which will be added to the "Screen".
+# But the magic is inside. 
+# When you add "Element" to a "Section", e.g. image or label, 
+# it will try to draw it using CALayer/CGContext/etc, instead of adding new UIView.
+# That way increases application speed (especially on Table elements) by 5-10 times.
+#
+# Let's get started.
+---
+
+# ** Create a section. **
+#
+# Just inherit it from `Prime::Section`.
+
+class FooSection < Prime::Section
+end
+
+# ** Add some elements to the section. **
+#
+# Each element should have name and type: "image", "label", "button", etc. 
+# When you send `:text` option, type will be "label" by default.
+# When you send `:image` option, type will be "image" by default.
+
+class FooSection < Prime::Section
+  element :welcome, text: 'Hello World!'
+  element :avatar, image: 'images/users/avatar.jpg'
+  element :cheer, type: :button
+end
+
+# ** Render Section in Screen **
+# 
+# NOTE: You must send "screen" option on section initialization.
+
+class FooScreen < Prime::Screen
+  def render
+    @main_section = FooSection.new(screen: self)
+    @main_section.render
+  end
+end

data/doc/docs/getting_started.html

@@ -28,6 +28,11 @@
                 screens.rb
               </a>
             
+              
+              <a class="source" href="sections.html">
+                sections.rb
+              </a>
+            
           </div>
         </li>
       </ul>
@@ -105,7 +110,7 @@
             
             <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">AppDelegate</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseAppDelegate</span></span></span>
   <span class="function"><span class="keyword">def</span> <span class="title">on_load</span><span class="params">(app, options)</span></span>
-    open_screen <span class="constant">MainScreen</span>.new
+    open_screen <span class="symbol">:main</span>
   <span class="keyword">end</span>
 <span class="keyword">end</span></pre></div></div>
             
@@ -124,7 +129,7 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">MainScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseScreen</span></span></span>
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">MainScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::Screen</span></span></span>
   title <span class="string">'Main screen'</span>
 
   <span class="function"><span class="keyword">def</span> <span class="title">render</span></span>
@@ -148,7 +153,7 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">MyProfileSection</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseSection</span></span></span>
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">MyProfileSection</span> <span class="inheritance">&lt; <span class="parent">Prime::Section</span></span></span>
   element <span class="symbol">:title</span>, <span class="symbol">text:</span> <span class="string">"Hello World"</span>
   element <span class="symbol">:avatar</span>, <span class="symbol">image:</span> <span class="string">"images/avatar.png"</span>, <span class="symbol">type:</span> <span class="symbol">:image</span>
 <span class="keyword">end</span></pre></div></div>

data/doc/docs/screens.html

@@ -28,6 +28,11 @@
                 screens.rb
               </a>
             
+              
+              <a class="source" href="sections.html">
+                sections.rb
+              </a>
+            
           </div>
         </li>
       </ul>
@@ -66,12 +71,29 @@ For RubyOnRails developers the nearest analogy would be &quot;Controllers&quot;.
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-2">&#182;</a>
               </div>
+              <p><strong> Create a screen. </strong></p>
+<p>Just inherit it from <code>Prime::Screen</code>.</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::Screen</span></span></span>
+<span class="keyword">end</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-3">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-3">&#182;</a>
+              </div>
               <p><strong> Render the screen. </strong></p>
-<p>You should rewrite the <code>render</code> method of <code>Prime::BaseScreen</code>, which will be runned after first opening screen.</p>
+<p>You should rewrite the <code>render</code> method of <code>Prime::Screen</code>, which will be runned after first opening screen.</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseScreen</span></span></span>
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::Screen</span></span></span>
   <span class="function"><span class="keyword">def</span> <span class="title">render</span></span>
     <span class="variable">@main_section</span> = <span class="constant">MyProfileSection</span>.new(<span class="symbol">screen:</span> <span class="keyword">self</span>, <span class="symbol">model:</span> <span class="constant">User</span>.first)
     <span class="variable">@main_section</span>.render
@@ -81,11 +103,11 @@ For RubyOnRails developers the nearest analogy would be &quot;Controllers&quot;.
         </li>
         
         
-        <li id="section-3">
+        <li id="section-4">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-3">&#182;</a>
+                <a class="pilcrow" href="#section-4">&#182;</a>
               </div>
               <p><strong> Set screen&#39;s title </strong></p>
 <p>Title will be used in screen&#39;s navigation controller and will be shown on top of screen.</p>
@@ -93,57 +115,57 @@ For RubyOnRails developers the nearest analogy would be &quot;Controllers&quot;.
 
             </div>
             
-            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseScreen</span></span></span>
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::Screen</span></span></span>
   title <span class="string">'Foo screen'</span>
 <span class="keyword">end</span></pre></div></div>
             
         </li>
         
         
-        <li id="section-4">
+        <li id="section-5">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-4">&#182;</a>
+                <a class="pilcrow" href="#section-5">&#182;</a>
               </div>
               <p>You can pass block to define screen&#39;s title</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::BaseScreen</span></span></span>
+            <div class="content"><div class='highlight'><pre><span class="class"><span class="keyword">class</span> <span class="title">FooScreen</span> <span class="inheritance">&lt; <span class="parent">Prime::Screen</span></span></span>
   title { params[<span class="symbol">:title</span>] }
 <span class="keyword">end</span></pre></div></div>
             
         </li>
         
         
-        <li id="section-5">
+        <li id="section-6">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-5">&#182;</a>
+                <a class="pilcrow" href="#section-6">&#182;</a>
               </div>
               <p><strong> Initialize screen. </strong></p>
 <p>Available options:</p>
 <ul>
 <li><code>:navigation</code>. When this options is true, screen will be created with navigation support: it will allow adding title and left/right buttons.
-This option is false by default.</li>
+This option is true by default.</li>
 </ul>
 
             </div>
             
             <div class="content"><div class='highlight'><pre><span class="function"><span class="keyword">def</span> <span class="title">open_foo_screen</span></span>
-  foo_screen = <span class="constant">FooScreen</span>.new(<span class="symbol">navigation:</span> <span class="keyword">true</span>)
+  foo_screen = <span class="constant">FooScreen</span>.new(<span class="symbol">navigation:</span> <span class="keyword">false</span>)
 <span class="keyword">end</span></pre></div></div>
             
         </li>
         
         
-        <li id="section-6">
+        <li id="section-7">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-6">&#182;</a>
+                <a class="pilcrow" href="#section-7">&#182;</a>
               </div>
               <p><strong> Open screen: using app delegate. </strong></p>
 <p>Opening screen using app delegate is the most basic way, you would use it at least on app load.</p>
@@ -153,7 +175,7 @@ This option is false by default.</li>
 You can use root: true when you have already opened screen with sidebar, and you want to open new screen without sidebar.
 This option is false by default if you already have root screen and true if not.</p>
 </li>
-<li><p><code>:sidebar</code>. Send <code>Prime::BaseScreen</code> instance to this option if you want to create root screen with sidebar. 
+<li><p><code>:sidebar</code>. Send <code>Prime::Screen</code> instance to this option if you want to create root screen with sidebar. 
 Value of this options will be used as sidebar controller.</p>
 </li>
 </ul>
@@ -161,19 +183,19 @@ Value of this options will be used as sidebar controller.</p>
             </div>
             
             <div class="content"><div class='highlight'><pre><span class="function"><span class="keyword">def</span> <span class="title">open_foo_screen</span></span>
-  foo_screen = <span class="constant">FooScreen</span>.new(<span class="symbol">navigation:</span> <span class="keyword">true</span>)
-  sidebar = <span class="constant">MySidebar</span>.new
+  foo_screen = <span class="constant">FooScreen</span>.new
+  sidebar = <span class="constant">MySidebar</span>.new(<span class="symbol">navigation:</span> <span class="keyword">false</span>)
   app_delegate.open_screen foo_screen, <span class="symbol">sidebar:</span> sidebar
 <span class="keyword">end</span></pre></div></div>
             
         </li>
         
         
-        <li id="section-7">
+        <li id="section-8">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-7">&#182;</a>
+                <a class="pilcrow" href="#section-8">&#182;</a>
               </div>
               <p><strong> Open screen: using parent screen. </strong></p>
 <p>Opening screen using parent screen is usefull if you want to create inherited screen. 
@@ -188,6 +210,23 @@ Parent screen should have been initialized with navigation support.</p>
             
         </li>
         
+        
+        <li id="section-9">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-9">&#182;</a>
+              </div>
+              <p><strong> Open screen: using short version. </strong></p>
+<p>Opening screen using short syntax available both for opening via app delegate and via parent screen.</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>foo_screen.open_screen <span class="symbol">:hello_world</span>
+app_delegate.open_screen <span class="symbol">:foo_bar</span>, <span class="symbol">sidebar:</span> <span class="keyword">true</span></pre></div></div>
+            
+        </li>
+        
     </ul>
   </div>
 </body>