cardiac 0.2.0.pre2

data/lib/cardiac/resource/subresource.rb

@@ -0,0 +1,88 @@
+module Cardiac
+  
+  # If a subresource has any path or query values, it will treat the base resource's path
+  # as being a *directory*.  
+  class Subresource < Resource
+
+		begin
+			remove_method :subresource, :subresources_values
+			private :subresources_values=
+		rescue
+		end
+    
+    def initialize(base)
+      @_base_resource = base
+      super base.base_value
+      self.method_value = base.method_value
+    end
+     
+    # Overridden to enforce the appending of subresource paths.
+    def base_value
+      base_path = @_base_resource.build_path
+      base_path+='/' if @path_values.any? && base_path[-1]!='/'
+      super.merge URI::Generic.build(path: base_path)
+    end
+  
+    # Lazily builds the parent module, then redefines this method as an attr_reader.
+    def __parent_module__
+      build_parent_module
+    ensure
+      singleton_class.class_eval "attr_reader :__parent_module__"
+    end
+      
+  protected
+  
+    def build_scheme
+      @https_value.nil? ? @_base_resource.build_scheme : super
+    end
+    
+    def build_host
+      @host_value.nil? ? @_base_resource.build_host : super
+    end
+    
+    def build_port(scheme=nil)
+      @port_value.nil? ? @_base_resource.build_port(scheme) : super
+    end
+    
+    def build_query_values
+      @_base_resource.build_query_values + @query_values.select(&:present?)
+    end
+  
+    def build_options(base_options=nil)
+      super @_base_resource.send(:build_options, base_options||{})
+    end
+    
+    def build_headers(base_headers=nil)
+      super @_base_resource.send(:build_headers, base_headers||{})
+    end
+    
+    def build_config(base_config=nil)
+      super @_base_resource.send(:build_config, base_config||{})
+    end
+    
+    def build_parent_module
+      @__parent_module__ ||= Module.new.tap{|x| @_base_resource.build_extensions_for_module x }
+    end
+    
+    def build_subresources_for_module mod
+      raise NotImplementedError
+    end
+
+		def build_encoder(*previous)
+			result = @_base_resource.send :build_encoder, *previous
+			result[0] = encoder_search_value || result[0]
+			result
+		end
+    
+  private
+  
+    # Overridden to omit any subresources.    
+    def apply_extensions_to_module! mod=Module.new
+      mod.send :include, build_parent_module
+      build_extensions_for_module mod
+      build_operations_for_module mod
+      mod
+    end
+      
+  end
+end

data/lib/cardiac/resource/uri_methods.rb

@@ -0,0 +1,176 @@
+require 'uri'
+require 'active_support/core_ext/hash/deep_merge'
+
+module Cardiac
+  module UriMethods
+
+    # Scheme selection.
+    def ssl(z)  self.https_value = z.nil? ? z : !!z; self end
+    def http()  ssl(false) end
+    def https() ssl(true)  end
+    def scheme(word)
+      case word
+      when /^http$/i then http
+      when /^https$/i then https
+      when NilClass then ssl(nil)
+      else raise ArgumentError
+      end
+    end
+
+    # HTTP method selection.
+    def http_method(k) self.method_value = k.to_s.downcase.to_sym ; self end
+
+    # Userinfo selection.
+    def user(s) self.user_value = s ; self end
+    def password(s) self.password_value = s ; self end
+    def userinfo(userinfo)
+      if userinfo
+        self.user_value, _password = userinfo.split(':',2)
+        self.password_value ||= _password
+      else
+        self.user_value = self.password_value = nil
+      end
+      self
+    end
+
+    # Host and port selection.
+    def host(s) self.host_value = s ; self end
+
+    def port(n) self.port_value = n ; self end
+
+    # Path selection.
+    def path(s,*rest) self.path_values += check_paths(rest.unshift(s)) ; self end
+
+    # Query parameter selection.
+    def query(q,*rest) self.query_values += check_queries(rest.unshift(q)) ; self end
+    def reset_query(*q) query_values.replace check_queries(q) ; self end
+
+    # Relative resource selection.
+    def at(rel)
+      apply_uri_components! check_at(rel) if rel.present?
+      self
+    end
+
+    # Convert this resource into a URI.
+    def to_uri
+      build_uri
+    end
+    
+    # Convert this resource into an URL string.
+    def to_url
+      to_uri.to_s
+    end
+
+    # Convert this resource into a relative URI.
+    def to_relative_uri
+      build_uri.route_from base_value
+    end
+    
+    # Convert this resource into a relative URL string
+    def to_relative_url
+      to_relative_uri.to_s
+    end
+
+    protected
+
+    # Derives the userinfo from the user_value and password_value.
+    def build_userinfo
+      @password_value ? "#{@user_value}:#{@password_value}" : @user_value if @user_value
+    end
+    
+    # Derives the scheme from the base_value and https_value.
+    def build_scheme
+      case @https_value
+      when FalseClass then 'http'
+      when NilClass then base_value.scheme || 'http'
+      else 'https'
+      end
+    end
+    
+    # Derives the path from the base_value and paths_value.
+    def build_path
+      @path_values.inject(base_value){|uri,path| uri.merge URI::Generic.build(path: path) }.path
+    end
+    
+    # Needed by Subresource
+    def build_query_values
+      @query_values.select(&:present?)
+    end
+    
+    # Derives the query from the built-up query_values.
+    def build_query
+      case query = build_query_values.inject{|q,v| query_coder.decode(q).deep_merge(query_coder.decode(v)) }
+      when Hash
+        query_coder.encode(query)
+      when String, NilClass
+        query
+      else
+        raise InvalidRepresentationError, 'expected Hash, String, or NilClass but got: '+query.class.name
+      end
+    end
+
+    # Derives a URI from the built-up values in this resource.    
+    def build_uri
+      # Validate the scheme.
+      scheme = build_scheme.upcase
+      raise UnresolvableResourceError, 'scheme must be http or https' if scheme!='HTTP' && scheme!='HTTPS'
+      
+      # Build and normalize the URI.
+      URI.const_get(scheme).
+        build2(host: build_host, port: build_port(scheme), userinfo: build_userinfo, path: build_path, query: build_query).
+        normalize
+    end
+    
+    # Derives a host from the built-up values in this resource, requiring it to be present.
+    def build_host
+      host = @host_value || base_value.host
+      raise UnresolvableResourceError, 'no HTTP host specified' if host.blank?
+      host
+    end
+    
+    # Derives a port from the built-up values in this resource, but omits default ports.
+    def build_port(scheme=nil)
+      non_default_port(scheme, @port_value || non_default_port(base_value.scheme, base_value.port))
+    end
+
+  private
+
+    # Returns nil if the given port is the default for the scheme, otherwise returns the port itself.
+    def non_default_port(scheme,port)
+      case scheme
+      when /^http$/i  then port==80  ? nil : port
+      when /^https$/i then port==443 ? nil : port
+      else port
+      end
+    end
+    
+    def query_coder
+      ::Cardiac::Representation::Codecs::UrlEncoded
+    end
+    
+    def apply_uri_components! other
+      other, base = to_uri.coerce(other)
+      base.component.each do |part|
+        next if part == :fragment
+        value = other.send(part)
+        send(part, value) if base.merge!(URI::Generic.build(part => value))
+      end
+      base
+    end
+
+    def check_at(rel)
+      raise ArgumentError unless String===rel or URI===rel
+      rel
+    end
+
+    def check_paths(paths)
+      raise ArgumentError unless paths.all?{|s| String===s }
+      paths
+    end
+
+    def check_queries(queries)
+      raise ArgumentError unless queries.all?{|q| String===q || Hash===q }
+      queries
+    end
+  end
+end

data/lib/cardiac/resource.rb

@@ -0,0 +1,77 @@
+require 'active_support/core_ext/array/wrap'
+require 'active_support/core_ext/object/blank'
+
+module Cardiac
+  class Resource
+    
+    attr_accessor :base_value,
+      
+      # built by: UriMethods
+      :https_value, :user_value, :password_value,
+      :host_value, :port_value, :path_values, :query_values,
+      
+      # built by: RequestMethods
+      :method_value, :headers_values, :options_values, :accepts_values,
+      
+      # built by: CodecMethods
+      :decoders_values, :encoder_search_value, :encoder_handler_value,
+        
+      # built by: ExtensionMethods
+      :extensions_values, :operations_values, :subresources_values
+      
+    include UriMethods
+    include RequestMethods
+    include CodecMethods
+    include ExtensionMethods
+    include ConfigMethods
+    
+    # Configure our allowed builder methods.
+    self.allowed_builder_methods = [
+      :scheme, :ssl, :https, :user, :password, :host, :port, :path, :query, :reset_query,
+      :http_method, :headers, :header, :reset_headers, :options, :option, :reset_options,
+      :decoders, :encoder, :extending
+    ].freeze
+    
+    def initialize(base)
+      self.base_value = ::URI::Generic===base ? base.dup : URI(base) # compatibility with 1.9.2 and below
+      self.path_values = []
+      self.query_values = []
+      self.headers_values = []
+      self.accepts_values = []
+      self.options_values = []
+      self.decoders_values = []
+      self.operations_values = []
+      self.subresources_values = []
+      self.extensions_values = []
+      extract_from_base!
+    end
+    
+    def to_resource
+      self
+    end
+
+		def to_s
+			to_url
+		end
+		
+		def to_reflection(verb=method_value)
+		  ResourceReflection.new(to_resource, verb)
+		end
+    
+  protected
+
+    # Builds client options, without a payload.
+    def build_client_options(verb=build_http_method)
+      build_options.merge method: verb, url: to_url, headers: build_headers
+    end
+    
+  private
+  
+    # Separate userinfo and query from the base_value.
+    def extract_from_base!(base=@base_value)
+      self.user_value, self.password_value = base.user, base.password if base.userinfo
+      query_values << base.query if base.query
+      base.userinfo = base.query = nil
+    end
+  end
+end

data/lib/cardiac/util.rb

@@ -0,0 +1,120 @@
+require 'rack/utils'
+require 'active_support/builder'
+require 'blankslate'
+
+module Cardiac
+  
+  # Specialized version(s) of Rack utility functions.
+  module RackUtils
+    include ::Rack::Utils
+    
+    # Overridden to work with false, true and nil, and otherwise call :to_param on single values that are not strings.
+    def build_nested_query(value,prefix=nil)
+      case value
+      when Hash, Array, String
+        super
+      when TrueClass
+        "#{prefix}=true"
+      when FalseClass
+        "#{prefix}=false"
+      when NilClass
+        "#{prefix}="
+      else
+        super value.to_param, prefix
+      end
+    end
+  end
+  
+  # Base proxy class.
+  #
+  # On Ruby 2.0 and above, we can use ActiveSupport's ProxyObject, otherwise we must use BlankSlate.
+  class Proxy < (RUBY_VERSION>='2.0' && defined?(::ActiveSupport::ProxyObject) ? ::ActiveSupport::ProxyObject : ::BlankSlate)
+    
+    # We at least would like some basics here.
+    %w(kind_of? is_a? inspect class method send).each do |k|
+      define_method k, ::Kernel.instance_method(k)
+    end
+    %w(class extend send object_id public_send).each do |k|
+      define_method :"__#{k}__", ::Kernel.instance_method(k)
+    end
+
+    # By default, do not advertise methods on this proxy object.     
+    def respond_to?(name,include_all=false)
+      respond_to_missing?(name,include_all)
+    end
+  end
+  
+  # A specialized proxy class for building extension modules while supporting method_missing.
+  class ExtensionBuilder < Proxy
+    def initialize(builder,extension_module=nil)
+      @builder = builder
+      @extension_module = extension_module
+    end
+    
+    # Performs a :module_eval on the extension module,
+    # temporarily defining :method_missing on it's singleton class for the duration of the block.
+    def extension_eval(&block)
+      extension_exec(&block)
+    end
+
+    # Performs a :module_eval or :module_exec on the extension module,
+    # temporarily defining :method_missing on it's singleton class for the duration of the block.
+    def extension_exec(*args, &block)
+      orig_missing = build_method_missing
+      begin
+        args.empty? ? __extension_module__.module_eval(&block) : __extension_module__.module_exec(*args,&block)
+      ensure
+        __extension_module__.singleton_class.send(:remove_method, :method_missing)
+        __extension_module__.define_singleton_method :method_missing, orig_missing if orig_missing
+      end
+      @builder
+    end
+    
+    # Lazily creates the extension module.
+    def __extension_module__
+      @extension_module ||= ::Module.new
+    end
+
+  protected
+
+    # Called to build a :method_missing implementation on the extension module.
+    def build_method_missing
+      if __extension_module__.singleton_methods(false).include?(:method_missing)
+        orig = __extension_module__.method(:method_missing)
+      end
+      self.class.build_method_missing(self)
+      orig
+    end
+    
+    # This method's arguments are minimal closure needed to build :method_missing.
+    # The instance version of this method delegates here.
+    def self.build_method_missing(adapter)
+      # NOTE: Your editor may not like the |name,*args,&block| syntax below. Ignore any errors it reports.
+      adapter.__extension_module__.define_singleton_method :method_missing do |name,*args,&block|
+        if adapter.respond_to?(name)
+          adapter.__send__(name, *args, &block)
+        else
+          super(name, *args, &block)
+        end
+      end
+    end
+    
+  private
+  
+    # Delegates to the builder.
+    def respond_to_missing?(name,include_private=false)
+      @builder.respond_to?(name, include_private)
+    end
+    
+    # Delegates to the builder, saves it's return value as the new builder, and returns self.
+    def method_missing(name, *args, &block)
+      if @builder.respond_to?(name)
+        @builder = @builder.__send__(name, *args, &block)
+        self
+      else
+        super
+      end
+    end
+  end
+  
+end

data/lib/cardiac/version.rb

@@ -0,0 +1,3 @@
+module Cardiac
+  VERSION = '0.2.0.pre2'
+end

data/lib/cardiac.rb

@@ -0,0 +1,61 @@
+require 'active_support/core_ext/object/blank'
+require 'active_support/dependencies/autoload'
+require 'active_support/concern'
+require 'active_support/core_ext/class/attribute'
+require 'active_support/core_ext/module/delegation'
+
+require 'cardiac/version'
+require 'cardiac/errors'
+
+module Cardiac
+  extend ActiveSupport::Autoload
+  
+  # Utility classes.
+  autoload_at 'cardiac/util' do
+    autoload :RackUtils
+    autoload :Proxy
+    autoload :ExtensionBuilder
+    autoload :Mixin
+  end
+  
+  # Resources and builder DSL.
+  autoload :Resource
+  autoload_under 'resource' do
+    autoload :Subresource
+    autoload :UriMethods
+    autoload :RequestMethods
+    autoload :CodecMethods
+    autoload :ExtensionMethods
+    autoload :ConfigMethods
+    autoload :ResourceBuilder, 'cardiac/resource/builder'
+    autoload :ResourceAdapter, 'cardiac/resource/adapter'
+  end
+  autoload :Representation
+  autoload_at 'cardiac/declarations' do
+    autoload :DeclarationMethods
+    autoload :DeclarationBuilder
+    autoload :Declarations
+  end
+  
+  # Operations and execution.
+  autoload :OperationHandler
+  autoload :OperationResult, 'cardiac/operation_handler'
+  autoload :OperationBuilder
+  autoload :OperationProxy, 'cardiac/operation_builder'
+  autoload :LogSubscriber
+  
+  # Reflections, models and definitions.
+  autoload_at 'cardiac/reflections' do
+    autoload :BaseReflection
+    autoload :ChainReflection
+    autoload :ResourceReflection
+    autoload :OperationReflection
+  end
+  autoload :Model
+end
+
+require 'cardiac/railtie' if defined? ::Rails
+
+ActiveSupport.on_load(:i18n) do
+  I18n.load_path << File.dirname(__FILE__) + '/cardiac/model/locale/en.yml'
+end

data/spec/rails-3.2/Gemfile

@@ -0,0 +1,9 @@
+source 'http://rubygems.org'
+
+gem 'sqlite3'
+gem 'rails', '~> 3.2', '< 4.0'
+gem 'rspec', '~> 3.0', '< 3.1'
+gem 'rspec-rails', '~> 3.0', '< 3.1'
+gem 'rspec-collection_matchers', '~> 1.0'
+gem 'awesome_print'
+gem 'cardiac', :path => '../..'

data/spec/rails-3.2/Gemfile.lock

@@ -0,0 +1,136 @@
+PATH
+  remote: ../..
+  specs:
+    cardiac (0.2.0.pre1)
+      active_attr (>= 0.8.2)
+      activemodel (>= 3.2, < 4.1)
+      activesupport (>= 3.2, < 4.1)
+      i18n (~> 0.6, >= 0.6.4)
+      json (> 1.8.0)
+      mime-types (> 1.1)
+      multi_json (~> 1.0)
+      rack (>= 1.4.5)
+      rack-cache (~> 1.2)
+      rack-client (~> 0.4.2)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.19)
+      actionpack (= 3.2.19)
+      mail (~> 2.5.4)
+    actionpack (3.2.19)
+      activemodel (= 3.2.19)
+      activesupport (= 3.2.19)
+      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_attr (0.8.4)
+      activemodel (>= 3.0.2, < 4.2)
+      activesupport (>= 3.0.2, < 4.2)
+    activemodel (3.2.19)
+      activesupport (= 3.2.19)
+      builder (~> 3.0.0)
+    activerecord (3.2.19)
+      activemodel (= 3.2.19)
+      activesupport (= 3.2.19)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.19)
+      activemodel (= 3.2.19)
+      activesupport (= 3.2.19)
+    activesupport (3.2.19)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    arel (3.0.3)
+    awesome_print (1.2.0)
+    builder (3.0.4)
+    diff-lcs (1.2.5)
+    erubis (2.7.0)
+    hike (1.2.3)
+    i18n (0.6.11)
+    journey (1.0.4)
+    json (1.8.1)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.25.1)
+    multi_json (1.10.1)
+    polyglot (0.3.5)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-client (0.4.2)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.4)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.19)
+      actionmailer (= 3.2.19)
+      actionpack (= 3.2.19)
+      activerecord (= 3.2.19)
+      activeresource (= 3.2.19)
+      activesupport (= 3.2.19)
+      bundler (~> 1.0)
+      railties (= 3.2.19)
+    railties (3.2.19)
+      actionpack (= 3.2.19)
+      activesupport (= 3.2.19)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.3.2)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-collection_matchers (1.0.0)
+      rspec-expectations (>= 2.99.0.beta1)
+    rspec-core (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-rails (3.0.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.4)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.9)
+    thor (0.19.1)
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.41)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  cardiac!
+  rails (~> 3.2, < 4.0)
+  rspec (~> 3.0, < 3.1)
+  rspec-collection_matchers (~> 1.0)
+  rspec-rails (~> 3.0, < 3.1)
+  sqlite3

data/spec/rails-3.2/Rakefile

@@ -0,0 +1,10 @@
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc 'Default: Run all specs for rails 3.2'
+task :default => :spec
+
+desc 'Run all specs for rails 3.2'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = defined?(SPEC) ? SPEC : ['**/*_spec.rb', '../shared/**/*_spec.rb']
+end

data/spec/rails-3.2/app_root/app/assets/javascripts/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .