bowline 0.1.6

data/bin/bowline-gen

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require File.join(File.dirname(__FILE__), *%w[.. lib bowline])
+require 'bowline/generators'
+
+Bowline::Generators.run_cli(Dir.pwd, 'bowline', Bowline::VERSION, ARGV)

data/bowline.gemspec

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bowline}
+  s.version = "0.1.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Alex MacCaw"]
+  s.date = %q{2009-04-24}
+  s.default_executable = %q{bowline-gen}
+  s.description = %q{Ruby desktop application framework}
+  s.email = ["info@eribium.org"]
+  s.executables = ["bowline-gen"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.files = [".gitignore", "History.txt", "MIT-LICENSE", "Manifest.txt", "README.txt", "Rakefile", "assets/jquery.bowline.js", "assets/jquery.chain.js", "assets/jquery.js", "bin/bowline-gen", "bowline.gemspec", "examples/account.rb", "examples/example.js", "examples/twitter.html", "examples/tweets.rb", "examples/users.rb", "lib/bowline.rb", "lib/bowline/binders.rb", "lib/bowline/binders/collection.rb", "lib/bowline/binders/singleton.rb", "lib/bowline/commands/console.rb", "lib/bowline/commands/generate.rb", "lib/bowline/commands/run.rb", "lib/bowline/ext/array.rb", "lib/bowline/ext/class.rb", "lib/bowline/ext/object.rb", "lib/bowline/ext/string.rb", "lib/bowline/gem_dependency.rb", "lib/bowline/generators.rb", "lib/bowline/generators/application.rb", "lib/bowline/generators/binder.rb", "lib/bowline/generators/migration.rb", "lib/bowline/generators/model.rb", "lib/bowline/initializer.rb", "lib/bowline/jquery.rb", "lib/bowline/observer.rb", "lib/bowline/tasks/app.rake", "lib/bowline/tasks/bowline.rb", "lib/bowline/tasks/database.rake", "lib/bowline/tasks/log.rake", "lib/bowline/tasks/misk.rake", "templates/Rakefile", "templates/binder.rb", "templates/config/application.yml", "templates/config/boot.rb", "templates/config/database.yml", "templates/config/environment.rb", "templates/config/manifest", "templates/config/tiapp.xml", "templates/gitignore", "templates/migration.rb", "templates/model.rb", "templates/public/index.html", "templates/public/javascripts/application.js", "templates/public/stylesheets/application.css", "templates/script/console", "templates/script/init", "templates/script/run"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/maccman/bowline}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{maccman}
+  s.rubygems_version = %q{1.3.2}
+  s.summary = %q{Ruby desktop application framework}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<templater>, [">= 0.3.2"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.2"])
+      s.add_development_dependency(%q<newgem>, [">= 1.3.0"])
+      s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
+    else
+      s.add_dependency(%q<templater>, [">= 0.3.2"])
+      s.add_dependency(%q<activesupport>, [">= 2.3.2"])
+      s.add_dependency(%q<newgem>, [">= 1.3.0"])
+      s.add_dependency(%q<hoe>, [">= 1.8.0"])
+    end
+  else
+    s.add_dependency(%q<templater>, [">= 0.3.2"])
+    s.add_dependency(%q<activesupport>, [">= 2.3.2"])
+    s.add_dependency(%q<newgem>, [">= 1.3.0"])
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/examples/account.rb

@@ -0,0 +1,31 @@
+module Binders
+  class Account < Bowline::Binders::Singleton  
+    class << self
+      # self.collection is a special method
+      # Basically it'll update users on the client side
+      def index
+        self.item = current_account
+      end
+ 
+      def destroy
+        current_account.destroy
+        self.item = nil
+      end
+    end
+  
+    # Everything has a js_id which is basically the lowercase classname + _ + self.id
+    def highlight
+      # Calls $(element).highlight()
+      self.element.highlight
+    end
+  
+    # Overrides charge on user
+    def charge!
+      # calls charge on model (i.e. do sql commit )
+      self.item.charge!
+      # Now gui stuff
+      flash[:notice] = "Successfully charged"
+      highlight
+    end
+  end
+end

data/examples/example.js

@@ -0,0 +1,24 @@
+$('#users').bowline('users_binder');
+
+var user = $('#users').items(10);
+user.update({name: 'Alex'}); // will automatiinvokey 
+user.item().errors //=> []
+
+// Deletes item from DOM too
+item.destroy()
+
+// invoke collection method
+// This will invoke UserBinder.admins and fill #users with admins
+$('#users').invoke('admins');
+
+// invoke singleton method
+$('#users').items(10).invoke('charge!');
+
+// invoke charge! on every user
+$('#users').items().invoke('charge!')
+
+// // For binding over a http connection - an async invoke
+// // last argument is a function
+// $('#users').items(10).invoke('charge!', function(){
+//   
+// })

data/examples/tweets.rb

@@ -0,0 +1,28 @@
+module Binders
+  class Tweets < Bowline::Binders::Collection
+    class << self
+      def index
+        self.items = timeline
+      end
+      
+      def update(status)
+        twitter.update(status)
+        index # update timeline
+      end
+      
+      protected
+        def twitter
+          httpauth = Twitter::HTTPAuth.new('user', 'pass')
+          Twitter::Base.new(httpauth)
+        end
+        
+        def timeline
+          twitter.friends_timeline.collect {|t|
+            t.delete('user')
+            t.to_hash
+          }
+        end
+    end
+    
+  end
+end # Binders

data/examples/twitter.html

@@ -0,0 +1,39 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
+   "http://www.w3.org/TR/html4/strict.dtd">
+
+<html lang="en">
+<head>
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+	<title>Twitter</title>
+  <!-- 
+	<script src="http://getfirebug.com/releases/lite/1.2/firebug-lite-compressed.js" type="text/javascript"></script>
+	 -->
+	<script src="javascripts/jquery.js" type="text/javascript" charset="utf-8"></script>
+	<script src="javascripts/jquery.chain.js" type="text/javascript" charset="utf-8"></script>
+  <script src="javascripts/jquery.bowline.js" type="text/javascript" charset="utf-8"></script>
+  <script src="../script/init" type="text/ruby" charset="utf-8"></script>
+  <script src="javascripts/application.js" type="text/javascript" charset="utf-8"></script>
+  <link rel="stylesheet" href="stylesheets/application.css" type="text/css" charset="utf-8">
+  <script type="text/javascript" charset="utf-8">
+    jQuery(function($){
+      var tweets = $('#tweets').bowline('tweets');
+      tweets.invoke('index');
+
+      $('#updateSubmit').click(function(){
+        tweets.invoke('update', $('#updateText').val());
+        return false;
+      })
+    });
+  </script>
+</head>
+  <body>
+    <div id="tweets">
+      <div class="item">
+        <span class="text"></span>
+      </div>
+    </div>
+
+    <input type="text" id="updateText">
+    <input type="submit" value="Update &rarr;" id="updateSubmit">
+</body>
+</html>

data/examples/users.rb

@@ -0,0 +1,37 @@
+module Binders
+  class Users < Bowline::Binders::Collection    
+    class << self
+      # self.items is a special method
+      # Basically it'll update users on the client side
+      def index
+        self.items = User.all
+      end
+ 
+      def admins
+        self.items = User.admins.all
+      end
+    end
+  
+    def update(attrs)
+      if @item.update_attributes(attrs)
+        flash[:notice] = "Successfully updated"
+      else
+        flash[:notice] = "Errors updating users"
+      end
+    end
+ 
+    def highlight
+      # Calls $('user_1').highlight()
+      self.element.highlight
+    end
+  
+    # Overrides charge on user
+    def charge!
+      # calls charge! on model (i.e. do sql commit )
+      self.item.charge!
+      # Now gui stuff
+      flash[:notice] = "Successfully charged"
+      highlight
+    end
+  end
+end

data/lib/bowline.rb

@@ -0,0 +1,42 @@
+module Bowline
+  VERSION = '0.1.6'
+
+  # The raw JavaScript window object
+  def self.js
+    if defined?($app_window)
+      $app_window
+    else
+      Class.new { 
+        def self.method_missing(*a)
+          Bowline.logger.info "Sending to Window: #{a.inspect}"
+          self
+        end 
+      }
+    end
+  end
+  
+  # Change which page we're on
+  def self.show_view(name)
+    js.window.location = "app://public/#{name}.html"
+  end
+  
+  class Base
+  end
+end
+
+$LOAD_PATH << File.dirname(__FILE__)
+
+require 'bowline/ext/object'
+require 'bowline/ext/array'
+require 'bowline/ext/class'
+require 'bowline/ext/string'
+
+require 'bowline/gem_dependency'
+require 'bowline/initializer'
+
+require 'bowline/jquery'
+require 'bowline/observer'
+
+require 'bowline/binders'
+require 'bowline/binders/collection'
+require 'bowline/binders/singleton'

data/lib/bowline/binders.rb

@@ -0,0 +1,177 @@
+module Bowline
+  module Binders
+    class Base
+      cattr_accessor :params
+    
+      class << self
+        # See Bowline::js
+        def js
+          Bowline::js
+        end
+      
+        # Equivalent of the 'jQuery' function
+        def jquery
+          @@jquery ||= JQuery.new
+        end
+      
+        # See the Observer class
+        def observer
+          @@observer ||= Observer.new
+        end
+        
+        # See Bowline::logger
+        def logger
+          Bowline::logger
+        end
+      
+        # See Bowline::show_view
+        def show_view(*args)
+          Bowline::show_view(*args)
+        end
+      
+        def params=(p)
+          case p
+          when String
+            # Params comes in a string (since it's a
+            # serialized form) - we need to make it into
+            # a nestled hash.
+            # Stolen from Ramaze
+            m = proc {|_,o,n|o.merge(n,&m)}
+            @@params = params.inject({}) do |hash, (key, value)|
+              parts = key.split(/[\]\[]+/)
+              hash.merge(parts.reverse.inject(value) { |x, i| {i => x} }, &m) 
+            end
+          else
+            @@params = p
+          end
+        end
+      
+        def setup(d)
+          @@elements ||= []
+          @@elements << d
+          self.item_sync!
+        end
+      
+        def instance(el)
+          self.new(el).method(:send)
+        end
+      
+        # todo - flash?
+      
+        def inherited(child)
+          return if self == Bowline::Binders::Base
+          return if child == Bowline::Binders::Singleton
+          return if child == Bowline::Binders::Collection
+          name = child.name.underscore
+          name = name.split('/').last
+          js.send("bowline_#{name}_setup=",    child.method(:setup))
+          js.send("bowline_#{name}_instance=", child.method(:instance))
+          js.send("bowline_#{name}=",          child.method(:send))
+        end    
+      end
+    
+      attr_reader :element
+      attr_reader :item
+    
+      # Todo
+      # We want initialize method to take
+      # no argument, and for every item in items
+      # to have initialize called on startup,
+      # so they can set up event handlers etc
+      def self.new(element, *args) #:nodoc:
+        allocate.instance_eval do
+          # jQuery element
+          @element = element
+          # Calling chain.js 'item' function
+          @item    = element.item()
+          if @item
+            @item.with_indifferent_access
+            # If possible, find Ruby object
+            if @item[:id] && respond_to?(:find)
+              @item = find(@item[:id])
+            end
+          end
+        
+          initialize(*args)
+          self
+        end
+      end    
+
+      # Trigger jQuery events on this element
+      def trigger(event, data = nil)
+        self.element.trigger(event, data)
+      end
+    
+      # Bind event to element:
+      # bind(:click) { puts "element clicked" }
+      # todo - two events with the same item/event overwrite each other
+      # todo - need initalize method on class - so we can set events there
+      def bind(event, method_name, &block)
+        event_name = [event, item_id].join(":")
+        callback = block
+        callback ||= begin
+          method_name.is_a?(Method) ? 
+            method_name : method(method_name)
+        end
+        self.observer.append(event_name, callback)
+        self.element.bind(
+          event.to_s, 
+          event_name, 
+          self.observer.method(:call)
+        )
+      end
+    
+      def click(method_name = nil, &block)
+        bind(:click, method, &block)
+      end
+    
+      # Raw DOM element
+      def dom
+        self.element[0]
+      end
+    
+      # Shortcut methods
+    
+      # See self.class.show_view
+      def show_view(*args)
+        self.class.show_view(*args)
+      end
+    
+      # See self.class.js
+      def js
+        self.class.js
+      end
+      alias :page :js
+    
+      # See self.class.jquery
+      def jquery
+        self.class.jquery
+      end
+    
+      # See self.class.observer
+      def observer
+        self.class.observer
+      end
+      
+      # See self.class.logger
+      def logger
+        self.class.logger
+      end
+    
+      private
+        # This is just a unique identifier
+        # for the item - and isn't
+        # used in the dom
+        def item_id
+          if item.respond_to?(:dom_id)
+            item.dom_id
+          else
+            [
+              item.id, 
+              self.class.name.underscore
+            ].join("_")
+          end
+        end
+    end
+  end
+end

data/lib/bowline/binders/collection.rb

@@ -0,0 +1,27 @@
+module Bowline
+  module Binders
+    class Collection < Base
+      cattr_accessor :items
+      class << self
+        def items=(args)
+          @@items = args
+          self.item_sync!
+          @@items
+        end
+    
+        def item_sync!
+          return unless @@items && @@elements
+          @@elements.each {|i| 
+            i.updateCollection(@@items.to_js) 
+          }
+        end
+    
+        def find(id)
+          @@items.find {|item| 
+            item.id == id if item.respond_to?(:id) 
+          }
+        end
+      end
+    end
+  end
+end