ovto 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c17abf9bd95d6f8f6cab67b30bd2eb24d176b1d0099c596e6d984248aa401fb1
-  data.tar.gz: 93a8b6b2b6afe491c2385b96728021e10f18f94c01d0db9d0f832954e41550b3
+  metadata.gz: cbe9fd351db11fdad3445d8a44c356e4343c789a4ce0521cbfc1b70d5c72eed1
+  data.tar.gz: 9c37eaf812a82accfc9e9da7ba6c1e5bea62c90a27b5965f13ddd514a38cdba5
 SHA512:
-  metadata.gz: 207bbcbd1cbeb5bcb9d4c9b8e2f48c6e5b44520bda7946d06b8029aeb12c2956c754a15dc6e1e802a88073ee6f8781fdac3e34ec34b18d5a06198e6f130e53ff
-  data.tar.gz: 80b690d5feea528b4fce13873c0008f09f7c503c5dcb686d6eff30a743036b4bf9592d6267f25ffccaafa05b2e64b2217f71a3d5607db23090c30aba23f2e461
+  metadata.gz: 35caabda59fef24ff185b829ce794c4e4cc23645790c33ba544245ecc0fd66d4d78a005190afbba9d07c9edf5e9b33bd62fb4a5496234c1ede06fd14e31d4565
+  data.tar.gz: b5654ce1ffed9aba99eafc4905828bdd525b4b3f461667fc013058ad943455fab6e332e0a20808f779a3128f56225907b89c2c3b0e1daf0139b9ff1cf4a03d92

data/.gitignore

@@ -1 +1,3 @@
+/,
 /.yardoc
+/example/static/app.js

data/CHANGELOG.md

@@ -1,4 +1,12 @@
-## HEAD
+## v0.3.0 (2018-12-24)
+
+Breaking change
+
+- `View` is renamed to `MainComponent`. Please rename `MyApp::View` to `MyApp::MainComponent`.
+
+New features
+
+- `Ovto.debug_trace`
 
 ## v0.2.3 (2018-11-13)
 

data/Gemfile.lock

@@ -1,21 +1,21 @@
 PATH
   remote: .
   specs:
-    ovto (0.2.3)
+    ovto (0.3.0)
       opal (~> 0.11)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.0)
-    concurrent-ruby (1.1.3)
+    concurrent-ruby (1.1.4)
     hike (1.2.3)
-    opal (0.11.3)
+    opal (0.11.4)
       ast (>= 2.3.0)
       hike (~> 1.2)
       parser (= 2.3.3.1)
       sourcemap (~> 0.1.0)
-    opal-rspec (0.6.1)
+    opal-rspec (0.6.2)
       opal (>= 0.10.0, < 0.12)
     opal-sprockets (0.4.2.0.11.0.3.1)
       opal (~> 0.11.0)
@@ -24,12 +24,12 @@ GEM
     parser (2.3.3.1)
       ast (~> 2.2)
     rack (2.0.6)
-    rake (12.3.1)
+    rake (12.3.2)
     sourcemap (0.1.1)
     sprockets (3.7.2)
       concurrent-ruby (~> 1.0)
       rack (> 1, < 3)
-    tilt (2.0.8)
+    tilt (2.0.9)
     yard (0.9.16)
 
 PLATFORMS

data/README.md

@@ -1,6 +1,8 @@
 # Ovto
 
-Client-side web framework for Opal, inspired by hyperapp
+Client-side web framework for Opal
+
+![logo](ovtologo.png)
 
 ## Documents
 
@@ -34,7 +36,7 @@ class MyApp < Ovto::App
     end
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'span', 'Celcius:'
@@ -54,7 +56,7 @@ class MyApp < Ovto::App
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 See the [book](https://yhara.github.io/ovto/guides/tutorial.html) for details.
@@ -63,12 +65,12 @@ See the [book](https://yhara.github.io/ovto/guides/tutorial.html) for details.
 
 ### Static
 
-[./example/static](./example/static) demonstrates how to convert Ovto app
+[./examples/static](./examples/static) demonstrates how to convert Ovto app
 into a .js file.
 
 ### Ovto + Sinatra
 
-[./example/sinatra](./example/sinatra) demonstrates how to serve Ovto app
+[./examples/sinatra](./examples/sinatra) demonstrates how to serve Ovto app
 from Sinatra.
 
 ### Ovto + Rails

data/Rakefile

@@ -26,6 +26,8 @@ end
 
 desc "git ci, git tag and git push"
 task :release do
+  cd('examples/sinatra'){ sh 'bundle update' }
+  cd('examples/static'){ sh 'bundle update' }
   load 'lib/ovto/version.rb'
   sh "git diff"
   v = "v#{Ovto::VERSION}"

data/book/api/actions.md

@@ -24,7 +24,7 @@ class MyApp < Ovto::App
     end
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'span', state.count
       o 'button', onclick: ->{ actions.increment(by: 1) }
@@ -32,7 +32,7 @@ class MyApp < Ovto::App
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 ## Calling actions

data/book/api/app.md

@@ -1,7 +1,7 @@
 # Ovto::App
 
 First of all, you need to define a subclass of `Ovto::App` and define `class State`,
-`class Actions` and `class View` in it.
+`class Actions` and `class MainComponent` in it.
 
 ## Example
 
@@ -18,14 +18,14 @@ class MyApp < Ovto::App
   class Actions < Ovto::Actions
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'input', type: 'button', value: 'Hello'
     end
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 It renders a button and does nothing else. Let's have some fun:
@@ -48,7 +48,7 @@ class MyApp < Ovto::App
     end
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'input', {
         type: 'button',
@@ -60,7 +60,7 @@ class MyApp < Ovto::App
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 Here we added `color_idx` to app state and `update_color` action to change it.
@@ -82,5 +82,5 @@ class MyApp < Ovto::App
   ...
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```

data/book/api/component.md

@@ -1,14 +1,14 @@
 # Ovto::Component
 
-Your app must have a `View` class, a subclass of `Ovto::Component`.
+An Ovto app must have `MainComponent` class, a subclass of `Ovto::Component`.
 
 ## 'render' method
 
-`render` is the only method you need to define in the `View` class.
+`render` is the only method you need to define in the `MainComponent` class.
 It must take the global app state as a keyword argument `state:`.
 
 ```rb
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'h1', 'Your todos'
@@ -36,7 +36,7 @@ If you missed the surrounding 'div' tag, Ovto raises an `MoreThanOneNode` error.
       end
     end
 
-#=> $MoreThanOneNode {name: "MoreThanOneNode", message: "MyApp::View#render must generate a single DOM node. Please wrap the tags with a 'div' or something.", stack: "MoreThanOneNode: MyApp::View#render must generate …opbox/proj/ovto/example/tutorial/app.js:22887:18)"}
+#=> $MoreThanOneNode {name: "MoreThanOneNode", ...}
 ```
 
 ## The 'o' method
@@ -139,8 +139,8 @@ https://github.com/hyperapp/hyperapp#keys
     end
   end
 
-  # Main View class
-  class View < Ovto::Component
+  # Main component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'h1', 'Your todos'

data/book/guides/debugging.md

@@ -21,3 +21,12 @@ JavaScript objects too.
 ## ovto-debug
 
 If the page has a tag with `id='ovto-debug'`, exception is shown in the tag.
+
+## Ovto.debug_trace
+
+If `Ovto.debug_trace` is set to `true`, some diagnostic messages are shown in the browser console.
+
+```rb
+Ovto.debug_trace = true
+MyApp.run(id: 'ovto')
+```

data/book/guides/tutorial.md

@@ -1,7 +1,7 @@
 # Getting Started
 
 This is a tutorial of making an Ovto app. We create a static app (.html + .js) here,
-but you can embed Ovto apps into a Rails or Sinatra app (See `./example/*`).
+but you can embed Ovto apps into a Rails or Sinatra app (See `./examples/*`).
 
 This is the final Ruby code.
 
@@ -28,7 +28,7 @@ class MyApp < Ovto::App
     end
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'span', 'Celcius:'
@@ -48,7 +48,7 @@ class MyApp < Ovto::App
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 Let's take a look step-by-step.
@@ -82,7 +82,7 @@ Make an index.html:
     <script type='text/javascript' src='app.js'></script>
   </head>
   <body>
-    <div id='ovto-view'></div>
+    <div id='ovto'></div>
     <div id='ovto-debug'></div>
   </body>
 </html>
@@ -102,7 +102,7 @@ class MyApp < Ovto::App
   class Actions < Ovto::Actions
   end
 
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)   # Don't miss the `:`. This is not a typo but
       o 'div' do         # a "mandatory keyword argument".
         o 'h1', "HELLO"  # All of the Ovto methods take keyword arguments.
@@ -111,11 +111,11 @@ class MyApp < Ovto::App
   end
 end
 
-MyApp.run(id: 'ovto-view')
+MyApp.run(id: 'ovto')
 ```
 
 - The name `MyApp` is arbitrary.
-- The id `ovto-view` corresponds to the `div` tag in `index.html`.
+- The id `ovto` corresponds to the `div` tag in `index.html`.
 
 ## Compile
 
@@ -165,10 +165,10 @@ each other. First, add an item to `MyApp::State`.
 
 Now an item `celsius` is added to the global app state. Its value is `0` when
 the app starts. You can read this value by `state.celsius`. Let's display the
-value with `MyApp::View`.
+value with `MyApp::MainComponent`.
 
 ```rb
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'span', 'Celcius:'
@@ -195,10 +195,10 @@ convert.
   end
 ```
 
-Now you can know the value by `state.fahrenheit`. Update the `View` to show the value too.
+Now you can know the value by `state.fahrenheit`. Update `MainComponent` to show the value too.
 
 ```
-  class View < Ovto::Component
+  class MainComponent < Ovto::Component
     def render(state:)
       o 'div' do
         o 'span', 'Celcius:'
@@ -230,7 +230,7 @@ the updates to the state. This return value is `merge`d into the global app stat
   end
 ```
 
-This action can be called by `actions.set_celsius` from the View. Replace the
+This action can be called by `actions.set_celsius` from MainComponent. Replace the
 first input tag with this:
 
 ```rb

data/docs/api/Ovto.html

@@ -107,7 +107,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.2.3</span><span class='tstring_end'>&#39;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.3.0</span><span class='tstring_end'>&#39;</span></span></pre></dd>
       
     </dl>
   
@@ -147,6 +147,72 @@
 <p>Create an Opal Promise to call fetch API.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#debug_trace-class_method" title="debug_trace (class method)">.<strong>debug_trace</strong>  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#debug_trace=-class_method" title="debug_trace= (class method)">.<strong>debug_trace=</strong>(bool)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#debug_trace_log-class_method" title="debug_trace_log (class method)">.<strong>debug_trace_log</strong>(msg)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'></div></span>
+  
 </li>
 
       
@@ -302,6 +368,88 @@
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="debug_trace-class_method">
+  
+    .<strong>debug_trace</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+19</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 19</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_debug_trace'>debug_trace</span><span class='semicolon'>;</span> <span class='ivar'>@debug_trace</span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="debug_trace=-class_method">
+  
+    .<strong>debug_trace=</strong>(bool)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+20</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 20</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_debug_trace='>debug_trace=</span><span class='lparen'>(</span><span class='id identifier rubyid_bool'>bool</span><span class='rparen'>)</span><span class='semicolon'>;</span> <span class='ivar'>@debug_trace</span> <span class='op'>=</span> <span class='id identifier rubyid_bool'>bool</span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="debug_trace_log-class_method">
+  
+    .<strong>debug_trace_log</strong>(msg)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+21
+22
+23</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 21</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_debug_trace_log'>debug_trace_log</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_console'><span class='object_link'><a href="top-level-namespace.html#console-instance_method" title="#console (method)">console</a></span></span><span class='period'>.</span><span class='id identifier rubyid_log'>log</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Ovto: </span><span class='tstring_end'>&quot;</span></span><span class='op'>+</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='ivar'>@debug_trace</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -408,16 +556,16 @@
       <pre class="lines">
 
 
-18
-19
-20
-21
-22
-23
-24</pre>
+26
+27
+28
+29
+30
+31
+32</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 18</span>
+      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 26</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_inspect'>inspect</span><span class='lparen'>(</span><span class='id identifier rubyid_obj'>obj</span><span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='backtick'>`</span><span class='tstring_content'>obj.$inspect</span><span class='tstring_end'>`</span></span>
@@ -458,14 +606,6 @@
       <pre class="lines">
 
 
-28
-29
-30
-31
-32
-33
-34
-35
 36
 37
 38
@@ -479,10 +619,18 @@
 46
 47
 48
-49</pre>
+49
+50
+51
+52
+53
+54
+55
+56
+57</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 28</span>
+      <pre class="code"><span class="info file"># File 'lib/ovto.rb', line 36</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_log_error'>log_error</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span>
@@ -516,7 +664,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Nov 13 16:32:29 2018 by
+  Generated on Mon Dec 24 21:23:44 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.16 (ruby-2.5.3).
 </div>