maccman-bowline 0.1.1

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,42 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bowline}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Alex MacCaw"]
+  s.date = %q{2009-04-23}
+  s.default_executable = %q{bowline-gen}
+  s.description = %q{My take on Ruby desktop GUIs}
+  s.email = ["info@eribium.org"]
+  s.executables = ["bowline-gen"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.files = ["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_binder.rb", "examples/example.js", "examples/twitter.html", "examples/twitter_binder.rb", "examples/twitter_login.html", "examples/users_binder.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.erb", "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{My take on Ruby desktop GUIs}
+
+  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_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<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<newgem>, [">= 1.3.0"])
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/examples/account_binder.rb

@@ -0,0 +1,29 @@
+class AccountBinder < Bowline::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

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/twitter.html

@@ -0,0 +1,43 @@
+<!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>
+	<meta name="generator" content="TextMate http://macromates.com/">
+	<meta name="author" content="Alex MacCaw">
+	<!-- Date: 2009-01-10 -->
+	<script src="jquery.js" type="text/javascript" charset="utf-8"></script>
+	<script src="chain.js" type="text/javascript" charset="utf-8"></script>
+	<script src="bowline.js" type="text/javascript" charset="utf-8"></script>
+	<script type="text/javascript" charset="utf-8">
+		  jQuery(function($){
+  	    var tweets = $('#tweets').bowline.init('twitter_binder');
+  	  
+        // Update status
+    	  var update = function(){
+    	    tweets.invoke('update', $('#update').val());
+    	  }
+	    
+        // Add event handlers
+  	    $('#updateForm').submit(update);
+	    
+    	  tweets.invoke('index'); 
+	  });
+	</script>
+</head>
+<body>
+  <div id="tweets">
+    <div class="item">
+      <img class="profile_image_url" />
+      <span class="text">Loading...</span>
+    </div>
+  </div>
+  
+  <form action="updateForm" method="get" accept-charset="utf-8">
+    <input type="text" name="update" id="update">
+    <input type="submit" value="Update &rarr;">
+  </form>
+</body>
+</html>

data/examples/twitter_binder.rb

@@ -0,0 +1,40 @@
+class TwitterBinder < Bowline::Collection
+  class << self
+    # What about filters - should they be implemented?
+    cattr_accessor :user, :pass
+    
+    def index
+      self.items = twit.timeline(:user)
+    end
+    
+    def update(text)
+      twit.update(text)
+      index # update timeline
+    end
+    
+    def login
+      self.user, self.pass = params[:user], params[:pass]
+      if logged_in?
+        show_view :twitter
+        index
+      else
+        js.alert('Credentials invalid')
+      end
+    end
+    
+    def logged_in?
+      return false unless self.user && self.pass
+      begin
+        twit.timeline && true
+      rescue Twitter::CantConnect
+        false
+      end
+    end
+    
+    protected
+    
+      def twit
+        Twitter::Base.new(self.user, self.pass)
+      end
+  end
+end

data/examples/twitter_login.html

@@ -0,0 +1,29 @@
+<!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_login</title>
+	<meta name="generator" content="TextMate http://macromates.com/">
+	<meta name="author" content="Alex MacCaw">
+	<!-- Date: 2009-01-10 -->
+	<script src="jquery.js" type="text/javascript" charset="utf-8"></script>
+	<script src="chain.js" type="text/javascript" charset="utf-8"></script>
+	<script src="bowline.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+  <script type="text/javascript" charset="utf-8">
+    jQuery(function($){
+      $.setupForms();
+    });
+  </script>
+  
+  <form action="twitter_binder.login" method="get">
+    <input type="text" name="user" id="user">
+    <input type="password" name="pass" id="pass">
+
+    <p><input type="submit" value="Login &rarr;"></p>
+  </form>
+</body>
+</html>

data/examples/users_binder.rb

@@ -0,0 +1,39 @@
+class UsersBinder < Bowline::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 index(offset)
+    #   self.items = User.all(:conditions => ['id > ?', offset])
+    # 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

data/lib/bowline.rb

@@ -0,0 +1,42 @@
+module Bowline
+  VERSION = '0.1.1'
+
+  # 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