dao 4.2.1 → 4.4.2

data/README

@@ -3,104 +3,143 @@ NAME
 
 SYNOPSIS
   a sa-weet-ass library for structuring rails applications using the 'data
-  access object' design pattern.
+  access object' design pattern.  dao consists of two main data access
+  objects, *api* objects and *conducer* objects.  conducers combine the
+  presenter pattern with the conductor pattern.
 
-DESCRITPION
-  applications that are written on dao look like this in ruby
 
-    result = api.call('/posts/new', params)
+  API
 
-  and like this in javascript
+    class Api < Dao::Api
+      call('/posts') do
+        get do
+          data[:posts] = Post.all.map{|post| post.attributes}
+        end
 
-    result = api.call('/posts/new', params)
+        post do
+          post = Post.new(params[:post])
 
-  in command-line applications they look like this
+          if post.save
+            data[:post] = post.attributes
+          else
+            status 420
+          end
+        end
+      end
+    end
 
-    result = api.call('/posts/new', params)
+  CONDUCER
 
-  and in tests this syntax is used
+    # TODO
 
-    result = api.call('/posts/new', params)
 
-  when a developer wants to understand the interface of a dao application she
-  does this
+  wikipedia has this to say about dao in general
 
-    vi app/api.rb
+    "
 
-  when a developer of a dao application wants to play with a dao application
-  interactively she does
+      In computer software, a data access object (DAO) is an object that
+      provides an abstract interface to some type of database or persistence
+      mechanism, providing some specific operations without exposing details
+      of the database.  It provides a mapping from application calls to the
+      persistence layer. This isolation separates the concerns of what data
+      accesses the application needs, in terms of domain-specific objects and
+      data types (the public interface of the DAO), and how these needs can be
+      satisfied with a specific DBMS, database schema, etc. (the
+      implementation of the DAO).
 
-    (rails console)
+    " 
+      - http://en.wikipedia.org/wiki/Data_access_object
 
-    > api = Api.new
-    > result = api.call('/posts/new', params)
+  and
 
-  when a remote client wants to understand the api of a dao application she
-  does
+    "
+      Models are not data access objects...
+    "
 
-    curl --silent http://dao.app.com/api | less
+      - http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller
 
+DESCRITPION
 
+  API
+    applications that are written on dao look like this in ruby
 
-  this kind of brutally consistent interface is made possible by structuring
-  access to data around the finest data structure of all time - the hash.  in
-  the case of dao the hash is a well structured and slightly clever hash, but
-  a simple hash interface is the basis of every bit of goodness dao has to
-  offer.
+      result = api.call('/posts/new', params)
 
-  in dao, application developers do not bring models into controllers and,
-  especially not into views.  instead, a unified interface to application
-  logic and data is used everywhere: in tests, in controllers, from the
-  command-line, and also from javascript.
+    and like this in javascript
 
-  this speration of concerns brings with it many, many desirable qualities:
+      result = api.call('/posts/new', params)
 
-    - total seperation of concerns between the front and back end of a web
-      application.  when developers are using dao changes to the data model
-      have zero effect on controllers and views.
+    in command-line applications they look like this
 
-    - issues related to having models in controllers and views such as
-      difficulty reasoning about caching and n+1 queries in views killing the
-      db simply disappear.
+      result = api.call('/posts/new', params)
 
-    - bad programming practices like using quasi-global variables
-      (current_user) or decorating models with view specific attributes
-      (password_verification) are no longer needed.
+    and in tests this syntax is used
 
-    - developers are able to reason over the abilities of an application by
-      reading only a few source files.
+      result = api.call('/posts/new', params)
 
-    - databases can be swapped, mixed, or alternate storage/caching mechanisms
-      added at any time without affecting the application's controllers or
-      views.
+    when a developer wants to understand the interface of a dao application
+    she does this
 
-    - transition from form based views to semi-ajax ones to fully-ajax ones is
-      direct.
+      vi app/api.rb
 
-    - forms and interfaces that involve dozens of models are as easy to deal
-      with as simple ones.
+    when a developer of a dao application wants to play with a dao application
+    interactively she does
 
-    - code can be optimized at the interface
+      (rails console)
 
+      > api = Api.new result = api.call('/posts/new', params)
 
-  wikipedia has this to say about dao in general
+    when a remote client wants to understand the api of a dao application she
+    does
 
-    "
+      curl --silent http://dao.app.com/api | less
 
-      In computer software, a data access object (DAO) is an object that
-      provides an abstract interface to some type of database or persistence
-      mechanism, providing some specific operations without exposing details
-      of the database.  It provides a mapping from application calls to the
-      persistence layer. This isolation separates the concerns of what data
-      accesses the application needs, in terms of domain-specific objects and
-      data types (the public interface of the DAO), and how these needs can be
-      satisfied with a specific DBMS, database schema, etc. (the
-      implementation of the DAO).
 
-    " 
-      - http://en.wikipedia.org/wiki/Data_access_object
+
+    this kind of brutally consistent interface is made possible by structuring
+    access to data around the finest data structure of all time - the hash.
+    in the case of dao the hash is a well structured and slightly clever hash,
+    but a simple hash interface is the basis of every bit of goodness dao has
+    to offer.
+
+    in dao, application developers do not bring models into controllers and,
+    especially not into views.  instead, a unified interface to application
+    logic and data is used everywhere: in tests, in controllers, from the
+    command-line, and also from javascript.
+
+    this seperation of concerns brings with it many, many desirable qualities:
+
+      - total seperation of concerns between the front and back end of a web
+        application.  when developers are using dao changes to the data model
+        have zero effect on controllers and views.
+
+      - issues related to having models in controllers and views such as
+        difficulty reasoning about caching and n+1 queries in views killing
+        the db simply disappear.
+
+      - bad programming practices like using quasi-global variables
+        (current_user) or decorating models with view specific attributes
+        (password_verification) are no longer needed.
+
+      - developers are able to reason over the abilities of an application by
+        reading only a few source files.
+
+      - databases can be swapped, mixed, or alternate storage/caching
+        mechanisms added at any time without affecting the application's
+        controllers or views.
+
+      - transition from form based views to semi-ajax ones to fully-ajax ones
+        is direct.
+
+      - forms and interfaces that involve dozens of models are as easy to deal
+        with as simple ones.
+
+      - code can be optimized at the interface
 
 READING
+  http://blog.plataformatec.com.br/2012/03/barebone-models-to-use-with-actionpack-in-rails-4-0/
+  http://martinfowler.com/eaaCatalog/serviceLayer.html
+  http://blog.firsthand.ca/2011/10/rails-is-not-your-application.html
   http://best-practice-software-engineering.ifs.tuwien.ac.at/patterns/dao.html
   http://www.codefutures.com/data-access-object/
   http://java.sun.com/blueprints/corej2eepatterns/Patterns/DataAccessObject.html
@@ -108,6 +147,7 @@ READING
   http://google-styleguide.googlecode.com/svn/trunk/jsoncstyleguide.xml
   http://pragdave.blogs.pragprog.com/pragdave/2007/03/the_radar_archi.html
 
+
 INSTALL
   gem 'dao', :path => File.expand_path('..') ### Gemfile
   rails generate dao api

data/Rakefile

@@ -29,7 +29,7 @@ def run_tests!(which = nil)
 
   test_rbs.each_with_index do |test_rb, index|
     testno = index + 1
-    command = "#{ This.ruby } -I ./lib -I ./test/lib #{ test_rb }"
+    command = "#{ File.basename(This.ruby) } -I ./lib -I ./test/lib #{ test_rb }"
 
     puts
     say(div, :color => :cyan, :bold => true)
@@ -59,8 +59,8 @@ end
 
 task :gemspec do
   ignore_extensions = ['git', 'svn', 'tmp', /sw./, 'bak', 'gem']
-  ignore_directories = ['pkg']
-  ignore_files = ['test/log', 'a.rb'] + Dir['db/*'] + %w'db'
+  ignore_directories = ['pkg', 'db']
+  ignore_files = ['test/log', 'test/db.yml', 'a.rb', 'b.rb'] + Dir['db/*'] + %w'db'
 
   shiteless = 
     lambda do |list|

data/dao.gemspec

@@ -3,7 +3,7 @@
 
 Gem::Specification::new do |spec|
   spec.name = "dao"
-  spec.version = "4.2.1"
+  spec.version = "4.4.2"
   spec.platform = Gem::Platform::RUBY
   spec.summary = "dao"
   spec.description = "description: dao kicks the ass"
@@ -11,27 +11,30 @@ Gem::Specification::new do |spec|
   spec.files =
 ["README",
  "Rakefile",
- "b.rb",
  "dao.gemspec",
- "db",
  "lib",
  "lib/dao",
  "lib/dao.rb",
  "lib/dao/active_record.rb",
  "lib/dao/api",
  "lib/dao/api.rb",
+ "lib/dao/api/call.rb",
  "lib/dao/api/context.rb",
  "lib/dao/api/dsl.rb",
- "lib/dao/api/endpoints.rb",
  "lib/dao/api/initializers.rb",
  "lib/dao/api/modes.rb",
  "lib/dao/api/routes.rb",
  "lib/dao/blankslate.rb",
  "lib/dao/conducer",
  "lib/dao/conducer.rb",
+ "lib/dao/conducer/active_model.rb",
  "lib/dao/conducer/attributes.rb",
- "lib/dao/conducer/crud.rb",
- "lib/dao/current.rb",
+ "lib/dao/conducer/autocrud.rb",
+ "lib/dao/conducer/callback_support.rb",
+ "lib/dao/conducer/collection.rb",
+ "lib/dao/conducer/controller_support.rb",
+ "lib/dao/conducer/nav_support.rb",
+ "lib/dao/conducer/view_support.rb",
  "lib/dao/data.rb",
  "lib/dao/db.rb",
  "lib/dao/endpoint.rb",
@@ -40,13 +43,13 @@ Gem::Specification::new do |spec|
  "lib/dao/exceptions.rb",
  "lib/dao/extractor.rb",
  "lib/dao/form.rb",
- "lib/dao/image_cache.rb",
  "lib/dao/instance_exec.rb",
  "lib/dao/mode.rb",
  "lib/dao/mongo_mapper.rb",
  "lib/dao/name.rb",
  "lib/dao/params.rb",
  "lib/dao/path.rb",
+ "lib/dao/path_map.rb",
  "lib/dao/rack",
  "lib/dao/rack.rb",
  "lib/dao/rack/middleware",
@@ -63,7 +66,6 @@ Gem::Specification::new do |spec|
  "lib/dao/rails/lib/generators/dao/templates/api.rb",
  "lib/dao/rails/lib/generators/dao/templates/api_controller.rb",
  "lib/dao/rails/lib/generators/dao/templates/conducer.rb",
- "lib/dao/rails/lib/generators/dao/templates/conducer_controller.rb",
  "lib/dao/rails/lib/generators/dao/templates/dao.css",
  "lib/dao/rails/lib/generators/dao/templates/dao.js",
  "lib/dao/rails/lib/generators/dao/templates/dao_helper.rb",
@@ -73,16 +75,19 @@ Gem::Specification::new do |spec|
  "lib/dao/status.rb",
  "lib/dao/stdext.rb",
  "lib/dao/support.rb",
+ "lib/dao/upload.rb",
  "lib/dao/validations",
  "lib/dao/validations.rb",
  "lib/dao/validations/callback.rb",
  "lib/dao/validations/common.rb",
+ "lib/dao/validations/instance.rb",
  "lib/dao/validations/validator.rb",
  "test",
  "test/active_model_conducer_lint_test.rb",
  "test/api_test.rb",
  "test/conducer_test.rb",
- "test/db.yml",
+ "test/data",
+ "test/data/han-solo.jpg",
  "test/form_test.rb",
  "test/helper.rb",
  "test/leak.rb",
@@ -97,19 +102,25 @@ Gem::Specification::new do |spec|
   spec.test_files = nil
 
   
-    spec.add_dependency(*["rails", "~> 3.0"])
+    spec.add_dependency(*["rails", " >= 3.1"])
   
-    spec.add_dependency(*["uuidtools", "~> 2.1"])
+    spec.add_dependency(*["map", " >= 5.4"])
   
-    spec.add_dependency(*["tagz", "~> 9.0"])
+    spec.add_dependency(*["fattr", " >= 2.2"])
   
-    spec.add_dependency(*["fattr", "~> 2.2"])
+    spec.add_dependency(*["tagz", " >= 9.3"])
   
-    spec.add_dependency(*["map", "~> 4.4"])
+    spec.add_dependency(*["multi_json", " >= 1.0.3"])
   
-    spec.add_dependency(*["unidecode", "~> 1.0"])
+    spec.add_dependency(*["uuidtools", " >= 2.1.2"])
   
-    spec.add_dependency(*["yajl-ruby", "~> 0.8"])
+    spec.add_dependency(*["wrap", " >= 1.5.0"])
+  
+    spec.add_dependency(*["rails_current", " >= 1.6"])
+  
+    spec.add_dependency(*["rails_nav", " >= 1.0.1"])
+  
+    spec.add_dependency(*["rails_helper", " >= 1.3.0"])
   
 
   spec.extensions.push(*[])

data/lib/dao.rb

@@ -1,12 +1,16 @@
+# -*- encoding : utf-8 -*-
 # built-ins
 #
   require 'enumerator'
   require 'set'
+  require 'fileutils'
+  require 'cgi'
+  require 'tmpdir'
 
 # dao libs
 #
   module Dao
-    Version = '4.2.1' unless defined?(Version)
+    Version = '4.4.2' unless defined?(Version)
 
     def version
       Dao::Version
@@ -14,13 +18,16 @@
 
     def dependencies
       {
-        'rails'       =>  [ 'rails'       , '~> 3.0' ],
-        'map'         =>  [ 'map'         , '~> 4.4' ],
-        'fattr'       =>  [ 'fattr'       , '~> 2.2' ],
-        'tagz'        =>  [ 'tagz'        , '~> 9.0' ],
-        'yajl'        =>  [ 'yajl-ruby'   , '~> 0.8' ],
-        'unidecode'   =>  [ 'unidecode'   , '~> 1.0' ],
-        'uuidtools'   =>  [ 'uuidtools'   , '~> 2.1' ]
+        'rails'         => [ 'rails'         , ' >= 3.1'   ] ,
+        'map'           => [ 'map'           , ' >= 5.4'   ] ,
+        'fattr'         => [ 'fattr'         , ' >= 2.2'   ] ,
+        'tagz'          => [ 'tagz'          , ' >= 9.3'   ] ,
+        'multi_json'    => [ 'multi_json'    , ' >= 1.0.3' ] ,
+        'uuidtools'     => [ 'uuidtools'     , ' >= 2.1.2' ] ,
+        'wrap'          => [ 'wrap'          , ' >= 1.5.0' ] ,
+        'rails_current' => [ 'rails_current' , ' >= 1.6'   ] ,
+        'rails_nav'     => [ 'rails_nav'     , ' >= 1.0.1' ] ,
+        'rails_helper'  => [ 'rails_helper'  , ' >= 1.3.0' ]
       }
     end
 
@@ -61,9 +68,6 @@
     end
   end
 
-  #active_record
-  #action_mailer
-  #rails/test_unit
   %w[
     action_controller
     active_resource
@@ -74,11 +78,8 @@
     rescue LoadError
     end
   end
-#require 'rails/all'
 
 
-  require 'yajl/json_gem'
-
   Dao.load %w[
     blankslate.rb
     instance_exec.rb
@@ -90,6 +91,7 @@
 
     name.rb
     status.rb
+    path_map.rb
     errors.rb
     form.rb
     validations.rb
@@ -97,8 +99,6 @@
     result.rb
     params.rb
 
-    current.rb
-
     mode.rb
     route.rb
     path.rb
@@ -112,7 +112,7 @@
     mongo_mapper.rb
 
     conducer.rb
-    image_cache.rb
+    upload.rb
   ]
 
 # protect against rails' too clever reloading

data/lib/dao/active_record.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 begin
   ActiveRecord
   ActiveRecord::Base

data/lib/dao/api.rb

@@ -1,10 +1,11 @@
+# -*- encoding : utf-8 -*-
 module Dao
   class Api
     Dao.load 'api/initializers.rb'
     Dao.load 'api/modes.rb'
     Dao.load 'api/routes.rb'
     Dao.load 'api/context.rb'
-    Dao.load 'api/endpoints.rb'
+    Dao.load 'api/call.rb'
     Dao.load 'api/dsl.rb'
   end
 end