angular_sprinkles 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1aa73b9e39b4a5a18d3c3b14d39bce928a4c78d6
-  data.tar.gz: d53aee79dc7d3950758677702a1ee564883a3611
+  metadata.gz: 82a8542cbe3370f7c7a63a7e6b535827297d427d
+  data.tar.gz: 7d47544aeb6a441e35705226756741c849176d12
 SHA512:
-  metadata.gz: c7b5ffa915e647ec7bfc49980e85b3bd93eebd7a349471b3cdbcb176f74422f8a27072dcc7f14007d2f6ccbf2db7237a3212eb409ae1662adfa6ebc5bc502e26
-  data.tar.gz: ba0706e68ba26006a90394b297da96f80b05ff0ea30850200d3cd2c7600e11ed1395d068acfa4dd51c967993a8128d873012bffb9b075e284bfcb6643e5ede2b
+  metadata.gz: 98f6621a65033d9271a6ee611a7f8abaa046686f473c3b5af5cb238ca467247ad53a7569d4113f18e6fda93a79b25c1027d089b08d1407b9e918272bd7a79b22
+  data.tar.gz: 796d155b10422c2c6050dbf526afc110a6a0a1ff4319c58345909915305df22cad10c14dd11e7027ad192907bc085f6b7bcca55de01846fe0528c106661dc619

data/README.md

@@ -91,6 +91,20 @@ Last Name: <input type="text" ng-model="<%= @user.bind(:last_name) %>" />
 
 We've got two-way data binding of persisted data without writing a single line of javascript!
 
+## Binding Collections
+
+You can bind collections with the `bindable_collection` helper
+
+```ruby
+class UserController < ApplicationController
+  include AngularSprinkles::Controller
+
+  def show
+    @users = bindable_collection(User.all)
+  end
+end
+```
+
 ## Custom Directives
 
 Sprinkles also comes packaged with a helper for instantiating custom directives.
@@ -139,6 +153,27 @@ sprinkles.directive('blink', function ($interval) {
 <input type="text" ng-model="<%= bind(:blink_text) %>" />
 ```
 
+## Custom Functions
+
+Custom functions can be added to your application with the `sprinkles.func` function
+
+```js
+// some js file
+
+sprinkles.func('alertMe', function (input) {
+  alert(input);
+});
+```
+
+These can then be called with the `bindFunc` helper
+
+```erb
+<%=# some view %>
+
+<%= bindFunc(:alertMe, @user.bind(:first_name));
+```
+
+
 ## Including additional modules
 
 Adding additional modules is just a matter of appending them to `sprinkles.requires`. This is already a feature of Angular and not Sprinkles

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/angular_sprinkles.gemspec

@@ -2,11 +2,11 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: angular_sprinkles 0.0.2 ruby lib
+# stub: angular_sprinkles 0.0.3 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "angular_sprinkles"
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]

data/app/assets/javascripts/angular_sprinkles.js.erb

@@ -1,9 +1,18 @@
 //= require angular
 
+(function (window, document, angular) {
+
+var fnQueue = [];
+
 window.sprinkles = angular.module('<%= AngularSprinkles::APP_NAME %>', []);
 
+window.sprinkles.func = function () {
+  var args = [].slice.call(arguments, 0);
+  fnQueue.push({name: args[0], fn: args[1]});
+};
+
 window.onload = function () {
-  var angular = window.angular,
+  var queue,
     app = angular.module('<%= AngularSprinkles::APP_NAME %>'),
     doc = document.documentElement,
     ctrlName = (doc.attributes['ng-controller'] || doc.attributes['data-ng-controller']) || 'Ctrl';
@@ -11,8 +20,16 @@ window.onload = function () {
   ctrlName = ctrlName.split(' as ')[0];
 
   <%= AngularSprinkles::CONTROLLER_FN %> = <%= AngularSprinkles::CONTROLLER_FN %> || function(){};
+
+  for (var i = 0; i < fnQueue.length; i++) {
+    queue = fnQueue[i];
+    <%= AngularSprinkles::CONTROLLER_FN %>.prototype[queue.name] = queue.fn;
+  }
+
   app.controller(ctrlName, <%= AngularSprinkles::CONTROLLER_FN %>);
   doc.setAttribute('data-ng-controller', ctrlName + ' as <%= AngularSprinkles::CONTROLLER_NAME %>');
 
   angular.bootstrap(doc, [app.name]);
 };
+
+}(window, document, window.angular));

data/lib/angular_sprinkles/helpers/bind_helper.rb

@@ -25,6 +25,11 @@ module AngularSprinkles
         AngularSprinkles::Data::Bind.new(*input)
       end
 
+      def bindFunc(fn, *args)
+        raise ArgumentError unless (fn.is_a?(String) || fn.is_a?(Symbol))
+        "#{AngularSprinkles::CONTROLLER_NAME}.#{fn}(#{args.join(',')})"
+      end
+
       private
 
       def build_chain(input)

data/spec/helpers/bind_helper_spec.rb

@@ -7,95 +7,109 @@ describe AngularSprinkles::Helpers::BindHelper do
 
   let(:stub) { StubClass.new }
 
-  before { allow(stub).to receive(:content_for).and_return(true) }
+  describe '#bind' do
+    before { allow(stub).to receive(:content_for).and_return(true) }
 
-  context 'when 0 arguments' do
-    it 'raises an argument error' do
-      expect { stub.bind }.to raise_error(ArgumentError)
+    context 'when 0 arguments' do
+      it 'raises an argument error' do
+        expect { stub.bind }.to raise_error(ArgumentError)
+      end
     end
-  end
 
-  context 'when 1 argument' do
-    let(:var) { :brewhouse }
+    context 'when 1 argument' do
+      let(:var) { :brewhouse }
 
-    it 'returns the variable name given as a js string' do
-      expect(stub.bind(var).to_json).
-        to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{var}"))
-    end
+      it 'returns the variable name given as a js string' do
+        expect(stub.bind(var).to_json).
+          to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{var}"))
+      end
 
-    it 'only yields the constructor definition to the view' do
-      expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
-      stub.bind(var)
+      it 'only yields the constructor definition to the view' do
+        expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
+        stub.bind(var)
+      end
     end
-  end
 
-  context 'when 2 arguments' do
-    let(:vars) { [:brewhouse, :software] }
+    context 'when 2 arguments' do
+      let(:vars) { [:brewhouse, :software] }
 
-    it 'returns the variables chained together as a js string' do
-      expect(stub.bind(*vars).to_json).
-        to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{vars.join('.')}"))
-    end
+      it 'returns the variables chained together as a js string' do
+        expect(stub.bind(*vars).to_json).
+          to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{vars.join('.')}"))
+      end
 
-    it 'yields the contructor definition and the first variable to the function to prototype' do
-      expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
-      expect(stub).to receive(:yield_to_sprinkles).
-        with("#{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} = #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} || {};")
+      it 'yields the contructor definition and the first variable to the function to prototype' do
+        expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
+        expect(stub).to receive(:yield_to_sprinkles).
+          with("#{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} = #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} || {};")
 
-      stub.bind(*vars)
+        stub.bind(*vars)
+      end
     end
-  end
 
-  context 'when 3 arguments' do
-    let(:vars) { [:brewhouse, :software, :is_neat] }
+    context 'when 3 arguments' do
+      let(:vars) { [:brewhouse, :software, :is_neat] }
 
-    it 'returns the variables chained together as a js string' do
-      expect(stub.bind(*vars).to_json).
-        to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{vars.join('.')}"))
-    end
+      it 'returns the variables chained together as a js string' do
+        expect(stub.bind(*vars).to_json).
+          to(eq("#{AngularSprinkles::CONTROLLER_NAME}.#{vars.join('.')}"))
+      end
 
-    it 'yields the constructor definition and the first variable to the function to prototype' do
-      expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
-      expect(stub).to receive(:yield_to_sprinkles).
-        with(%{#{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} = #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} || {};
+      it 'yields the constructor definition and the first variable to the function to prototype' do
+        expect(stub).to receive(:yield_to_sprinkles).with(AngularSprinkles::CONSTRUCTOR_DEFINITION)
+        expect(stub).to receive(:yield_to_sprinkles).
+          with(%{#{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} = #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first} || {};
 #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first(2).join('.')} = #{AngularSprinkles::CONTROLLER_FN}.prototype.#{vars.first(2).join('.')} || {};})
 
-      stub.bind(*vars)
+        stub.bind(*vars)
+      end
     end
-  end
 
-  context 'when bind is called more than once' do
-    let(:vars) { [:brewhouse, :software, :is_neat] }
+    context 'when bind is called more than once' do
+      let(:vars) { [:brewhouse, :software, :is_neat] }
 
-    context 'and it is with the same variables' do
-      it 'yields the constructor definition and the first variable to the function to prototype' do
-        expect(stub).to receive(:content_for).twice
-        5.times { stub.bind(*vars) }
+      context 'and it is with the same variables' do
+        it 'yields the constructor definition and the first variable to the function to prototype' do
+          expect(stub).to receive(:content_for).twice
+          5.times { stub.bind(*vars) }
+        end
+      end
+
+      context 'and it is called with different sets of variables' do
+        it 'yields the constructor definition, first variable, and a chain of the first two variables' do
+          expect(stub).to receive(:content_for).exactly(3).times
+
+          stub.bind(vars.first) # yields the constructor
+          stub.bind(vars.first) # yields nothing
+          stub.bind(*vars.first(2)) # yields declaration for :brewhouse
+          stub.bind(*vars) # yields declaration for [:brewhouse, :software]
+          stub.bind(*vars) # yields nothing
+        end
       end
     end
 
-    context 'and it is called with different sets of variables' do
-      it 'yields the constructor definition, first variable, and a chain of the first two variables' do
-        expect(stub).to receive(:content_for).exactly(3).times
+    context 'when the constructor has already been yielded' do
+      let(:var) { :brewhouse }
+
+      before { allow(stub).to receive(:app_initialized?).and_return(true) }
 
-        stub.bind(vars.first) # yields the constructor
-        stub.bind(vars.first) # yields nothing
-        stub.bind(*vars.first(2)) # yields declaration for :brewhouse
-        stub.bind(*vars) # yields declaration for [:brewhouse, :software]
-        stub.bind(*vars) # yields nothing
+      it 'does not yield anything with only one argument' do
+        expect(stub).not_to receive(:content_for)
+        stub.bind(var)
       end
     end
   end
 
-  context 'when the constructor has already been yielded' do
-    let(:var) { :brewhouse }
+  describe '#bindFunc' do
+    let(:fn) { :brewhouse }
+    let(:input) { [5, 'software'] }
 
-    before { allow(stub).to receive(:app_initialized?).and_return(true) }
+    it 'returns a javascript function binding string' do
+      expect(stub.bindFunc(fn, *input)).to eq("#{AngularSprinkles::CONTROLLER_NAME}.#{fn}(#{input.join(',')})")
+    end
 
-    it 'does not yield anything with only one argument' do
-      expect(stub).not_to receive(:content_for)
-      stub.bind(var)
+    it 'raises with an input' do
+      expect { stub.bindFunc }.to raise_error(ArgumentError)
     end
   end
-
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: angular_sprinkles
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Gabe Scholz