kojac 0.9.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODkyNDY5NGExYzM1NmM2MGU0NTU0ZGM1YTk0Mjk0MzU1OTQwMmQzZQ==
+  data.tar.gz: !binary |-
+    NTRlMTFjNTliMDcxMGU5MTQ0OGYzMWY0ZjM5NmY5M2NhNTJmZDM5Yw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    NzY3MGYyODk2YzJmMzgzYjY0ZTkzNGJmYjgyYTliMTg4NzQ1ZjdlMzFmMmU4
+    ZTljYjQxZTQzNGQxZjZhMTZlYmYyMjA4NTM5MzQ5MjdjODJmNDIxMDVkNDU3
+    Njk5NDJhNGZlMGViY2NkNmU4ZWZlOWVlM2IxZjRlZThkOGY2YWU=
+  data.tar.gz: !binary |-
+    NDkyOWZmOWVjYmUwYmExMDIxNGJlOTM4M2JmY2U0Y2Q4MWRjOTk1YzA5NTNj
+    NTQzZmI0MmQ4NGE2OWYwMmQ1ZjY2ZDg1ZWQ3YzFlNTQwNzQxZDdhODMwNWM4
+    NjQyNGVhZDc3ZTdlMWIxNjk5OTY3OWJkNDE2MTVjYWRiNjBkY2I=

data/.gitignore

@@ -0,0 +1,7 @@
+.bundle/
+log/*.log
+pkg/
+spec/demo/db/*.sqlite3
+spec/demo/log/*.log
+spec/demo/tmp/
+spec/demo/.sass-cache

data/Gemfile

@@ -0,0 +1,17 @@
+source "https://rubygems.org"
+
+# Declare your gem's dependencies in kojac.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# jquery-rails is used by the dummy application
+gem "jquery-rails"
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use debugger
+# gem 'debugger'

data/Gemfile.lock

@@ -0,0 +1,158 @@
+PATH
+  remote: .
+  specs:
+    kojac (0.9.0)
+      jquery-rails
+      json2-rails
+      strong_parameters
+      underscore_plus
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (3.2.14)
+      actionpack (= 3.2.14)
+      mail (~> 2.5.4)
+    actionpack (3.2.14)
+      activemodel (= 3.2.14)
+      activesupport (= 3.2.14)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.5)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    active_model_serializers (0.8.1)
+      activemodel (>= 3.0)
+    activemodel (3.2.14)
+      activesupport (= 3.2.14)
+      builder (~> 3.0.0)
+    activerecord (3.2.14)
+      activemodel (= 3.2.14)
+      activesupport (= 3.2.14)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.14)
+      activemodel (= 3.2.14)
+      activesupport (= 3.2.14)
+    activesupport (3.2.14)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    barber (0.4.2)
+      ember-source
+      execjs
+      handlebars-source
+    builder (3.0.4)
+    canjs-rails (1.1.2)
+      railties (>= 3.2.0, < 5.0)
+      thor (~> 0.14)
+    capybara (2.1.0)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    diff-lcs (1.2.4)
+    ember-data-source (0.13)
+      ember-source
+    ember-rails (0.12.0)
+      active_model_serializers
+      barber (>= 0.4.1)
+      ember-data-source
+      ember-source (>= 1.0.0.rc2.2)
+      execjs (>= 1.2)
+      railties (>= 3.1)
+    ember-source (1.0.0.rc7)
+      handlebars-source (= 1.0.12)
+    erubis (2.7.0)
+    execjs (1.4.0)
+      multi_json (~> 1.0)
+    handlebars-source (1.0.12)
+    hike (1.2.3)
+    i18n (0.6.5)
+    journey (1.0.4)
+    jquery-rails (3.0.4)
+      railties (>= 3.0, < 5.0)
+      thor (>= 0.14, < 2.0)
+    json (1.8.0)
+    json2-rails (1.0.0)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.24)
+    multi_json (1.7.9)
+    nokogiri (1.5.9)
+    polyglot (0.3.3)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.3)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.14)
+      actionmailer (= 3.2.14)
+      actionpack (= 3.2.14)
+      activerecord (= 3.2.14)
+      activeresource (= 3.2.14)
+      activesupport (= 3.2.14)
+      bundler (~> 1.0)
+      railties (= 3.2.14)
+    railties (3.2.14)
+      actionpack (= 3.2.14)
+      activesupport (= 3.2.14)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
+    rspec-rails (2.13.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.7)
+    strong_parameters (0.2.1)
+      actionpack (~> 3.0)
+      activemodel (~> 3.0)
+      railties (~> 3.0)
+    thor (0.18.1)
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.37)
+    underscore-rails (1.4.3)
+    underscore_plus (0.9.0)
+      railties (~> 3.1)
+      underscore-rails (= 1.4.3)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  canjs-rails
+  capybara
+  ember-rails
+  jquery-rails
+  kojac!
+  rails (~> 3.2)
+  rspec-rails
+  sqlite3

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+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/README.md

@@ -0,0 +1,69 @@
+> "Sometimes the strategic breakthrough will be a new algorithm ... Much more often, strategic breakthrough will come from redoing the representation of the data or tables. This is where the heart of a program lies."
+> - "The Mythical Man Month" by Fred Brooks
+
+## What is KOJAC ?
+
+KOJAC is an acronym for Key Oriented JSON Application Cache. Yes you may know of [Kojak, the 1970s TV cop show](http://en.wikipedia.org/wiki/Kojak).
+
+KOJAC is an opinionated design and implementation for data management within ["single page"](http://en.wikipedia.org/wiki/Single-page_application) or ["Rich Internet"](http://en.wikipedia.org/wiki/Rich_Internet_application) applications. It relates most heavily to the client and data protocol. The server may continue the key/value style down to a key/value-style database if desired, but that is not necessary. KOJAC also makes sense for the client design when a standard REST-style server is to be used, but naturally multiple operations will require multiple server requests.
+
+Single page applications require a different way of thinking, and present different challenges to traditional server-based applications. In particular, application state and user data must be managed and synchronised with the server. 
+
+Behind the design of KOJAC is the belief that how we structure and identify data has an enormous impact on the size and complexity of the application code.
+
+#### 1) Think REST ...
+
+Like [REST](http://en.wikipedia.org/wiki/Representational_state_transfer), the server has "resources" eg. customers or products that the client may do CRUD (Create, Read, Update, Destroy) operations on. Unlike REST, URLs are replaced by keys. Keys follow a standard format eg. `<resource>__<id>`. 
+
+Values may be of any valid JSON type ie. Null, Int, Number, String, Boolean, Array, Object. Potentially the Client, server and protocol can use the same key/value schema.
+
+#### 2) ...with multiple operations per request...
+
+Multiple operations per http request. Freely specify a mixture of CRUD operations on any resources in a given order, and get back the results (including errors) of any operation. That means your data can be broken down to single values, and you can request just the values you need from the server.
+
+#### 3) ...and an object factory.
+
+An optional custom factory method easily converts raw JSON into your application classes and property types. When KOJAC is used with Ember.js, the included EmberModel class enables application models to be declared with typed properties, and data is intelligently converted (if required) when these properties are set. Model classes serve as a live data dictionary for your app, and provide a meaningful place for related methods. Typed properties simplify application code by reducing the need to check and convert types. 
+
+#### 4) A central cache keeps things responsive
+
+Responses from the server update the cache (by default), keeping it fresh. With frameworks like Ember, the view can bind directly to the cache key eg. {rowIdsBinding: "App.cache.products"} for display as soon as it arrives. 
+
+#### 5) No boiler-plate code
+
+As date in the cache is often up to date and in your application classes, very little code is required to support or use the KOJAC framework once setup.
+
+
+<br/>
+<br/>
+<br/>
+KOJAC is server agnostic, open for hacking and debugging, uses and supports jQuery (especially Deferred Objects/Promises), prefers Ember.js but doesn't require it.
+
+## Code Examples
+
+1) Minimal example:
+
+<pre>
+kojac.read('products')
+</pre>
+
+...the results will eventually appear as kojac.cache.products
+
+2) Full example:
+
+<pre>
+kojac.read(['products','brands','categories__12']).done(function(aContext) {
+ 	// handle eg. aContext.results().products or aContext.ops[0].results.products or kojac.cache.products
+}).fail(function(aContext) {
+	// handle aContext.error()
+});
+</pre>
+
+3) Create
+
+<pre>
+kojac.create(['products']).done(function(aContext) {
+ 	// handle aContext.ops[0].result or kojac.cache[aContext.ops[0].resultKey]
+});
+</pre>
+

data/Rakefile

@@ -0,0 +1,27 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Kojac'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+Bundler::GemHelper.install_tasks
+

data/app/assets/javascripts/can_extensions.js

@@ -0,0 +1,45 @@
+CanUtils = {
+
+	isCanObject: function(aObject) {
+		return aObject instanceof can.Construct;
+	},
+
+	attr: function(aObject,aProperty,aValue) {
+		if (!aObject)
+			return undefined;
+		if (this.isCanObject(aObject)) {
+			return aObject.attr(aProperty,aValue)
+		} else {
+			if (arguments.length===3) {  // set
+				return aObject[aProperty] = aValue;
+			} else {
+				return aObject[aProperty]
+			}
+		}
+	},
+
+	copyProperties: function(aDest,aSource,aProperties,aExclude) {
+		var p;
+		var v;
+		if (aProperties) {
+			for (var i=0;i<aProperties.length;i++) {
+				p = aProperties[i];
+				if (aExclude && aExclude.indexOf(p)>=0)
+					continue;
+				v = this.attr(aSource,p);
+				if (v!==undefined)
+					this.attr(aDest,p,v);
+			}
+		} else {
+			for (p in aSource) {
+				if (aExclude && aExclude.indexOf(p)>=0)
+					continue;
+				v = this.attr(aSource,p);
+				if (v!==undefined)
+					this.attr(aDest,p,v);
+			}
+		}
+		return aDest;
+	}
+
+};