volt 0.2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4f31285f8d34376239bed9e92cb9dec093f8331e
+  data.tar.gz: 9fe3e6d4e61cf93734a72fd92f41df30ffc672f1
+SHA512:
+  metadata.gz: 098e047b75cf968bdd84634d5b1262600678f2765c73e759d5e5f4fb94503b20485ca1146fcf23fd0e039aee9fc186240c9dbfef732ac567deeed68463b04b03
+  data.tar.gz: 3ef0821f1ec5f15e02d174f6016f2a83a2d9f2c482d805c2baacfdba972b647f69345261bcedd13c9a1763eed7a21fa3df6f2f83c95bbd2185052d45fffbf00e

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea
+.yardoc
+.sass-cache
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.ruby-version

@@ -0,0 +1 @@
+2.1.0

data/Gemfile

@@ -0,0 +1,37 @@
+source 'http://rubygems.org'
+
+gemspec
+
+# gem 'rspec', '3.0.0.beta1'
+# gem 'nokogiri', :require => false
+gem 'opal', git: 'https://github.com/opal/opal.git'
+gem 'opal-jquery', :git => 'https://github.com/opal/opal-jquery.git'
+gem 'sockjs', git: 'https://github.com/kacperk/sockjs-ruby.git', require: false, platforms: :mri
+
+# gem 'thor'
+
+# gem 'rack'
+# gem 'sprockets'
+# gem 'sprockets-sass'
+# gem 'sass'
+
+# gem 'mongo', require: false
+# gem 'pry', require: false
+# gem 'thin', require: false, platforms: :mri
+
+# Json parsing with multi_json, et al
+# gem 'multi_json'
+# gem 'oj', :platforms => :mri, :require => false
+# gem 'jrjackson', :platforms => :jruby, :require => false
+
+# gem 'rake', '10.0.4'
+
+# # Needed to get opal to work on rbx
+# gem 'racc', platforms: :rbx
+
+group :development do
+  # gem 'guard', '2.0.1' # bug in current guard
+  # gem 'guard-rspec'
+  # gem 'opal-rspec', '0.3.0.beta2'#, git: 'https://github.com/adambeynon/opal-rspec.git'
+  # gem 'yard', require: false
+end

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ryan Stout
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'bundler'
+require "bundler/gem_tasks"
+Bundler.require(:development)
+
+
+task :docs do
+  `bundle exec yardoc 'lib/**/*.rb' - Readme.md docs/*`
+  # require 'yard'
+  # require 'yard-docco'
+  # 
+  # YARD::Rake::YardocTask.new do |t|
+  #   t.files   = ['lib/**/*.rb']
+  #   # t.options = ['--any', '--extra', '--opts'] # optional
+  # end
+end
+
+
+# Add our opal/ directory to the load path
+Opal.append_path(File.expand_path('../lib', __FILE__))
+
+require 'opal/rspec/rake_task'
+Opal::RSpec::RakeTask.new(:default)

data/Readme.md

@@ -0,0 +1,34 @@
+# Volt
+
+NOTE: VOLT IS STILL IN DEVELOPMENT, DON'T USE IT FOR ANYTHING SERIOUS YET
+
+Volt is a ruby web framework where your ruby code runs on both the server and the client (via [opal](https://github.com/opal/opal).)  The dom automatically update as the user interacts with the page.  Page state can be stored in the url, if the user hits a url directly, the HTML will first be rendered on the server for faster load times and easier indexing by search engines.
+
+Instead of syncing data between the client and server via HTTP, volt uses a persistent connection between the client and server.  When data updated on one client, it is updated in the database and any other listening clients.  (With almost no setup code needed)
+
+Pages HTML is written in a handlebars like template language.  Volt uses data flow/reactive programming to automatically and intellegently propigate changes to the dom (or anything other code wanting to know when a value updates)  When something in the dom changes, Volt intellegent updates only the nodes that need to be changed.
+
+## Goals
+
+Volt has the following goals:
+
+1. Developer happieness
+2. Write once on the client and the server
+3. Automatic data syncing between client and server
+4. Apps are built as nested components.  Components can be shared (via gems)
+5. Concurrent.  Volt provides tools to simplify concurrency.  Component rendering is done in parallel on the server.
+6. Intellegent asset management
+7. Secure (shouldn't need to be said, but it does)
+8. Be fast/light
+9. Understandable code base
+10. Component Upgradeability
+
+## 10. Component Upgradeability
+
+(seamless promotion)
+Everyone wishes that we could predict the scope and required features for each part of our application, but in the real world, things we don't expect to grow large often do and things we think will be large don't end up that way.  Volt provides an easy way to promote sections of html and code to provide more
+
+- subtemplate
+- template
+- controller
+- component

data/VERSION

@@ -0,0 +1 @@
+0.2.3

data/bin/volt

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), "../lib"))
+require 'volt/cli'

data/docs/GETTING_STARTED.md

@@ -0,0 +1,7 @@
+# Getting Started
+
+Volt relies on a few concepts to take make web development faster and easier.  The first of these is reactive programming.  Data on the front and back end is stored in models.  Instead of manually updating a page when the data changes, the page is coded using a handlebars like templating language which automatically updates when the data changes.
+
+## Reactive Values
+
+The key to making these updates happen is something we call "Reactive Values."  A ReactiveValue wraps another v

data/docs/GUIDE.md

@@ -0,0 +1,33 @@
+# VOLT guide
+
+This guide will take you through creating a basic web application in Volt.  This tutorial assumes a basic knowledge of ruby and web development.
+
+To get started, install volt:
+
+    gem install voltframework
+
+Then create a new project:
+
+    volt new project_name
+    
+This will setup a basic project.  Now lets run the server.
+
+    volt server
+
+
+## Bindings
+
+When a user interacts with a web page, typically we want to do two things:
+
+1) Change application state
+2) Update the DOM
+
+For example when a user clicks to add a new todo item to a todo list, we might create a JavaScript object to represent the todo item, then add an item to the list's DOM.  A lot of work needs to be done to make sure that the JavaScript object and the DOM always stay in sync.
+
+Recently the idea of "reactive programming" has been used to simplify maintaining the DOM.  The idea is instead of having event handlers that manage a model (or JavaScript object) and manage the DOM, we have event handlers that manage reactive data models.  We describe our DOM layer in a declaritive way so that it automatically knows how to render our data models.
+
+
+
+## Components
+
+Apps are broken up into components.  Each folder under app/ represents a component.  You can think of components like a single page app.  When a page within a component is loaded, all the controllers, models, and views within a component are loaded on the front end.  The initial page load will be rendered on the backend for quick loading, then any future updates will be rendered on the front end.

data/lib/volt.rb

@@ -0,0 +1,15 @@
+class Volt
+  def self.root
+    @root ||= File.expand_path(Dir.pwd)
+    
+    # File.expand_path(File.join(File.dirname(__FILE__), "../"))
+  end
+  
+  def self.server?
+    !ENV['CLIENT']
+  end
+  
+  def self.client?
+    !!ENV['CLIENT']
+  end
+end

data/lib/volt/benchmark/benchmark.rb

@@ -0,0 +1,25 @@
+class Benchmark
+  def self.bm(iterations=1)
+    puts "BM"
+    
+    times = []
+    total_time = nil
+    result = nil
+    
+    iterations.times do
+      start_time = `Date.now()`
+      result = yield
+      end_time = `Date.now()`
+      total_time = `end_time - start_time`
+      times << total_time
+    end
+    
+    if iterations == 1
+      puts "TOTAL TIME: #{total_time}ms"
+    else
+      puts "Times: #{times.inspect}"
+    end
+    
+    return result
+  end
+end

data/lib/volt/cli.rb

@@ -0,0 +1,34 @@
+require 'bundler/setup'
+require 'thor'
+
+class CLI < Thor
+  include Thor::Actions
+  
+  desc "new PROJECT_NAME", "generates a new project."
+  def new(name)
+    directory(".", name)
+    
+    say "Bundling Gems...."
+    `cd #{name} ; bundle`
+  end
+  
+  desc "console", "run the console on the project in the current directory"
+  def console
+    require 'volt/console'
+    Console.start
+  end
+
+  desc "server", "run the server on the project in the current directory"
+  def server
+    require 'thin'
+
+    ENV['SERVER'] = 'true'
+    Thin::Runner.new(['start']).run!
+  end
+  
+  def self.source_root
+    File.expand_path(File.join(File.dirname(__FILE__), '../../templates'))
+  end
+end
+
+CLI.start(ARGV)

data/lib/volt/console.rb

@@ -0,0 +1,19 @@
+class Console
+  def self.start
+    require 'pry'
+
+    $LOAD_PATH << 'lib'
+    ENV['SERVER'] = 'true'
+
+    require 'volt/extra_core/extra_core'
+    require 'volt/models'
+    require 'volt/models/params'
+    require 'volt/server/template_parser'
+    require 'volt'
+
+    Pry.config.prompt_name = 'volt'
+
+    # start a REPL session
+    Pry.start
+  end
+end

data/lib/volt/controllers/model_controller.rb

@@ -0,0 +1,29 @@
+class ModelController
+  def initialize(model=nil)
+    @model = model
+  end
+  
+  def page
+    $page.page
+  end
+
+  def store
+    $page.store
+  end
+
+  def params
+    $page.params 
+  end
+
+  def url
+    $page.url 
+  end
+  
+  def controller
+    @controller ||= ReactiveValue.new(Model.new)
+  end
+
+  def method_missing(method_name, *args, &block)
+    return @model.send(method_name, *args, &block)      
+  end
+end

data/lib/volt/extra_core/array.rb

@@ -0,0 +1,10 @@
+class Array
+  def sum
+    total = 0
+    self.each do |val|
+      total += val
+    end
+    
+    return total
+  end
+end 

data/lib/volt/extra_core/blank.rb

@@ -0,0 +1,88 @@
+class Object
+  # An object is blank if it's false, empty, or a whitespace string.
+  # For example, '', '   ', +nil+, [], and {} are all blank.
+  #
+  # This simplifies:
+  #
+  #   if address.nil? || address.empty?
+  #
+  # ...to:
+  #
+  #   if address.blank?
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+
+  # An object is present if it's not <tt>blank?</tt>.
+  def present?
+    !blank?
+  end
+
+end
+
+class NilClass
+  # +nil+ is blank:
+  #
+  #   nil.blank? # => true
+  def blank?
+    true
+  end
+end
+
+class FalseClass
+  # +false+ is blank:
+  #
+  #   false.blank? # => true
+  def blank?
+    true
+  end
+end
+
+class TrueClass
+  # +true+ is not blank:
+  #
+  #   true.blank? # => false
+  def blank?
+    false
+  end
+end
+
+class Array
+  # An array is blank if it's empty:
+  #
+  #   [].blank?      # => true
+  #   [1,2,3].blank? # => false
+  alias_method :blank?, :empty?
+end
+
+class Hash
+  # A hash is blank if it's empty:
+  #
+  #   {}.blank?                # => true
+  #   { key: 'value' }.blank?  # => false
+  alias_method :blank?, :empty?
+end
+
+class String
+  # A string is blank if it's empty or contains whitespaces only:
+  #
+  #   ''.blank?                 # => true
+  #   '   '.blank?              # => true
+  #   '　'.blank?               # => true
+  #   ' something here '.blank? # => false
+  def blank?
+    # self !~ /[^[:space:]]/
+    # TODO: Opal fails with the previous regex
+    self.strip == ''
+  end
+end
+
+class Numeric #:nodoc:
+  # No number is blank:
+  #
+  #   1.blank? # => false
+  #   0.blank? # => false
+  def blank?
+    false
+  end
+end