active_data 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7f1d47fec4ebf9836edc6f7fe5ac6d6a35ed1d69
-  data.tar.gz: 5d0be004664a569a8219e3f2437145f361fd935c
+  metadata.gz: 78fecd490979a5391a3de607a19c5e4605198af0
+  data.tar.gz: ebd1d4111fafc03aeb982bdb2965768920f728fd
 SHA512:
-  metadata.gz: fe96cad358ac8a1bf476ffba428f5bd321688c8741e2769673962081b1608789e4bae0b3bb1fd12c00b94b93f1531031710818a4e2d746aeaa7c2bc4205bcd3a
-  data.tar.gz: d8f29ecf02190df7fac8d108fcb1a1e5e54877c31c0775ab6c2045dffe4b21a0759eac793526ed95b9684308ac3b1f7345a85e067e02e77c9a51a0dbcb6be7d9
+  metadata.gz: 4d1583b8f09bf37a44343301be1bb802a62f414a8888f323dd13a1b56537986bf140cf5b238c91441ef298b6c0999883930539a3366303e8e4386863e97e357a
+  data.tar.gz: 3b0d862750cb159de0ab0911a515e80d8a8b30160918d0ab413095932da6f37a44d43c6133bf37943003f44a49977a24c99e09f5561334d07174fbfab9f8491e

data/.gitignore

@@ -3,7 +3,7 @@
 .bundle
 .config
 .yardoc
-Gemfile.lock
+*.lock
 InstalledFiles
 _yardoc
 coverage

data/.rspec

@@ -1,3 +1,2 @@
 --colour
 --backtrace
---order random

data/.rvmrc

@@ -1 +1 @@
-rvm use --create 2.0.0@active_data
+rvm use --create 2.3@active_data

data/.travis.yml

@@ -1,9 +1,16 @@
+sudo: false
+
 rvm:
-  - 1.9.3
-  - 2.0.0
-  - rbx-19mode
-  - rbx-20mode
+  - 2.2.5
+  - 2.3.1
+  - rbx
 
 gemfile:
-  - Gemfile
-  - gemfiles/Gemfile.rails-3
+  - gemfiles/rails.4.0.gemfile
+  - gemfiles/rails.4.1.gemfile
+  - gemfiles/rails.4.2.gemfile
+  - gemfiles/rails.5.0.gemfile
+
+matrix:
+  allow_failures:
+    - rvm: rbx

data/Appraisals

@@ -0,0 +1,7 @@
+%w(4.0 4.1 4.2 5.0).each do |version|
+  appraise "rails.#{version}" do
+    gem 'activesupport', "~> #{version}.0"
+    gem 'activemodel', "~> #{version}.0"
+    gem 'activerecord', "~> #{version}.0"
+  end
+end

data/Gemfile

@@ -1,12 +1,8 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in active_data.gemspec
 gemspec
 
 group :test do
   gem 'guard'
   gem 'guard-rspec'
-  gem 'rb-inotify', require: false
-  gem 'rb-fsevent', require: false
-  gem 'rb-fchange', require: false
-end
+end

data/Guardfile

@@ -1,24 +1,77 @@
 # A sample Guardfile
 # More info at https://github.com/guard/guard#readme
 
-guard :rspec do
-  watch(%r{^spec/.+_spec\.rb$})
-  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb')  { "spec" }
-
-  # Rails example
-  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
-  watch(%r{^app/(.*)(\.erb|\.haml)$})                 { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
-  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
-  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
-  watch('config/routes.rb')                           { "spec/routing" }
-  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features)
+
+## Uncomment to clear the screen before every task
+# clearing :on
+
+## Guard internally checks for changes in the Guardfile and exits.
+## If you want Guard to automatically start up again, run guard in a
+## shell loop, e.g.:
+##
+##  $ while bundle exec guard; do echo "Restarting Guard..."; done
+##
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  # Rails files
+  rails = dsl.rails(view_extensions: %w(erb haml slim))
+  dsl.watch_spec_files_for(rails.app_files)
+  dsl.watch_spec_files_for(rails.views)
+
+  watch(rails.controllers) do |m|
+    [
+      rspec.spec.("routing/#{m[1]}_routing"),
+      rspec.spec.("controllers/#{m[1]}_controller"),
+      rspec.spec.("acceptance/#{m[1]}")
+    ]
+  end
+
+  # Rails config changes
+  watch(rails.spec_helper)     { rspec.spec_dir }
+  watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
+  watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
 
   # Capybara features specs
-  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/features/#{m[1]}_spec.rb" }
+  watch(rails.view_dirs)     { |m| rspec.spec.("features/#{m[1]}") }
 
   # Turnip features and steps
   watch(%r{^spec/acceptance/(.+)\.feature$})
-  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$})   { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance' }
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
+    Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
+  end
 end
-

data/README.md

@@ -1,8 +1,118 @@
 [![Build Status](https://travis-ci.org/pyromaniac/active_data.png?branch=master)](https://travis-ci.org/pyromaniac/active_data)
+[![Code Climate](https://codeclimate.com/github/pyromaniac/active_data.png)](https://codeclimate.com/github/pyromaniac/active_data)
 
 # ActiveData
 
-TODO: Write a gem description
+ActiveData is a ActiveModel-based front-end for your data. You might need to use it in the following cases:
+
+* When you need a form objects pattern.
+
+```ruby
+class ProfileForm
+  include ActiveData::Model
+
+  attribute 'first_name', String
+  attribute 'last_name', String
+  attribute 'birth_date', Date
+
+  def full_name
+    [first_name, last_name].reject(&:blank).join(' ')
+  end
+
+  def full_name= value
+    self.first_name, self.last_name = value.split(' ', 2).map(&:strip)
+  end
+end
+
+class ProfileController < ApplicationController
+  def edit
+    @form = ProfileForm.new current_user.attributes
+  end
+
+  def update
+    result = ProfileForm.new(params[:profile_form]).save do |form|
+      current_user.update_attributes(form.attributes)
+    end
+
+    if result
+      redirect_to ...
+    else
+      render 'edit'
+    end
+  end
+end
+```
+
+* When you need to work with data-storage in ActiveRecord style with
+
+```ruby
+class Flight
+  include ActiveData::Model
+
+  attribute :airline, String
+  attribute :number, String
+  attribute :departure, Time
+  attribute :arrival, Time
+
+  validates :airline, :number, presence: true
+
+  def id
+    [airline, number].join('-')
+  end
+
+  def self.find id
+    source = REDIS.get(id)
+    instantiate(JSON.parse(source)) if source.present?
+  end
+
+  define_save do
+    REDIS.set(id, attributes.to_json)
+  end
+
+  define_destroy do
+    REDIS.del(id)
+  end
+end
+```
+
+* When you need to implement embedded objects for ActiveRecord models
+
+```ruby
+class Answer
+  include ActiveData::Model
+
+  attribute :question_id, Integer
+  attribute :content, String
+
+  validates :question_id, :content, presence: true
+end
+
+class Quiz < ActiveRecord::Base
+  embeds_many :answers
+
+  validates :user_id, presence: true
+  validates :answers, associated: true
+end
+
+q = Quiz.new
+q.answers.build(question_id: 42, content: 'blabla')
+q.save
+```
+
+## Why?
+
+ActiveData is an ActiveModel-based library that provides the following abilities:
+
+  * Standard form objects building toolkit: attributes with typecasting, validations, etc.
+  * High-level universal ORM/ODM library using any data source (DB, http, redis, text files).
+  * Embedding objects into your ActiveRecord entities. Quite useful with PG JSON capabilities.
+
+Key features:
+
+  * Complete objects lifecycle support: saving, updating, destroying.
+  * Embedded and referenced associations.
+  * Backend-agnostic named scopes functionality.
+  * Callbacks, validations and dirty attributes inside.
 
 ## Installation
 
@@ -20,7 +130,39 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+ActiveData has modular architecture, so it is required to include modules to obtain additional features. By default ActiveData supports attributes definition and validations.
+
+### Attributes
+
+
+
+#### Attribute
+#### Collection
+#### Dictionary
+#### Localized
+#### Represents
+
+### Associations
+
+#### EmbedsOne
+#### EmbedsMany
+#### ReferencesOne
+#### ReferencesMany
+#### Interacting with ActiveRecord
+
+### Primary
+
+### Persistence
+
+### Lifecycle
+
+### Callbacks
+
+### Dirty
+
+### Validations
+
+### Scopes
 
 ## Contributing
 

data/active_data.gemspec

@@ -2,21 +2,29 @@
 require File.expand_path('../lib/active_data/version', __FILE__)
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["pyromaniac"]
-  gem.email         = ["kinwizard@gmail.com"]
-  gem.description   = %q{Making object from any hash or hash array}
-  gem.summary       = %q{Working with hashes in AR style}
-  gem.homepage      = ""
+  gem.authors       = ['pyromaniac']
+  gem.email         = ['kinwizard@gmail.com']
+  gem.description   = 'Making object from any hash or hash array'
+  gem.summary       = 'Working with hashes in AR style'
+  gem.homepage      = ''
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
-  gem.name          = "active_data"
-  gem.require_paths = ["lib"]
+  gem.name          = 'active_data'
+  gem.require_paths = ['lib']
   gem.version       = ActiveData::VERSION
 
-  gem.add_development_dependency "rake"
-  gem.add_development_dependency "rspec"
-  gem.add_runtime_dependency "activesupport"
-  gem.add_runtime_dependency "activemodel"
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'appraisal'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rspec-its'
+  gem.add_development_dependency 'rubysl', '~> 2.0' if RUBY_ENGINE == 'rbx'
+  gem.add_development_dependency 'sqlite3'
+  gem.add_development_dependency 'database_cleaner'
+  gem.add_development_dependency 'activerecord', '>= 4.0'
+  gem.add_development_dependency 'uuidtools'
+  gem.add_runtime_dependency 'activesupport', '>= 4.0'
+  gem.add_runtime_dependency 'activemodel', '>= 4.0'
+  gem.add_runtime_dependency 'tzinfo'
 end

data/gemfiles/rails.4.0.gemfile

@@ -0,0 +1,14 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activesupport", "~> 4.0.0"
+gem "activemodel", "~> 4.0.0"
+gem "activerecord", "~> 4.0.0"
+
+group :test do
+  gem "guard"
+  gem "guard-rspec"
+end
+
+gemspec :path => "../"

data/gemfiles/rails.4.1.gemfile

@@ -0,0 +1,14 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activesupport", "~> 4.1.0"
+gem "activemodel", "~> 4.1.0"
+gem "activerecord", "~> 4.1.0"
+
+group :test do
+  gem "guard"
+  gem "guard-rspec"
+end
+
+gemspec :path => "../"

data/gemfiles/rails.4.2.gemfile

@@ -0,0 +1,14 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activesupport", "~> 4.2.0"
+gem "activemodel", "~> 4.2.0"
+gem "activerecord", "~> 4.2.0"
+
+group :test do
+  gem "guard"
+  gem "guard-rspec"
+end
+
+gemspec :path => "../"

data/gemfiles/rails.5.0.gemfile

@@ -0,0 +1,14 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activesupport", "~> 5.0.0"
+gem "activemodel", "~> 5.0.0"
+gem "activerecord", "~> 5.0.0"
+
+group :test do
+  gem "guard"
+  gem "guard-rspec"
+end
+
+gemspec :path => "../"

data/lib/active_data.rb

@@ -1,9 +1,126 @@
-require 'active_support/concern'
+require 'tzinfo'
+require 'active_support'
+require 'active_support/deprecation'
 require 'active_support/core_ext'
+require 'active_support/concern'
+require 'singleton'
+
 require 'active_model'
+
 require 'active_data/version'
-require 'active_data/model'
-require 'active_data/validations'
+require 'active_data/errors'
+require 'active_data/extensions'
+require 'active_data/config'
+require 'active_data/railtie' if defined? Rails
 
 module ActiveData
+  BOOLEAN_MAPPING = {
+    1 => true,
+    0 => false,
+    '1' => true,
+    '0' => false,
+    't' => true,
+    'f' => false,
+    'T' => true,
+    'F' => false,
+    true => true,
+    false => false,
+    'true' => true,
+    'false' => false,
+    'TRUE' => true,
+    'FALSE' => false,
+    'y' => true,
+    'n' => false,
+    'yes' => true,
+    'no' => false,
+  }
+
+  def self.config
+    ActiveData::Config.instance
+  end
+
+  singleton_class.delegate *ActiveData::Config.delegated, to: :config
+
+  typecaster('Object') { |value, attribute| value if value.class < attribute.type }
+  typecaster('String') { |value| value.to_s }
+  typecaster('Array') do |value|
+    case value
+    when ::Array then
+      value
+    when ::String then
+      value.split(',').map(&:strip)
+    else
+      nil
+    end
+  end
+  typecaster('Hash') do |value|
+    case value
+    when ::Hash then
+      value
+    else
+      nil
+    end
+  end
+  typecaster('Date') do |value|
+    begin
+      value.to_date
+    rescue ArgumentError, NoMethodError
+      nil
+    end
+  end
+  typecaster('DateTime') do |value|
+    begin
+      value.to_datetime
+    rescue ArgumentError
+      nil
+    end
+  end
+  typecaster('Time') do |value|
+    begin
+      value.is_a?(String) && ::Time.zone ? ::Time.zone.parse(value) : value.to_time
+    rescue ArgumentError
+      nil
+    end
+  end
+  typecaster('ActiveSupport::TimeZone') do |value|
+    case value
+    when ActiveSupport::TimeZone
+      value
+    when ::TZInfo::Timezone
+      ActiveSupport::TimeZone[value.name]
+    when String, Numeric, ActiveSupport::Duration
+      value = Float(value) rescue value
+      ActiveSupport::TimeZone[value]
+    else
+      nil
+    end
+  end
+  typecaster('BigDecimal') { |value| ::BigDecimal.new Float(value).to_s rescue nil if value }
+  typecaster('Float') { |value| Float(value) rescue nil }
+  typecaster('Integer') { |value| Float(value).to_i rescue nil }
+  typecaster('Boolean') { |value| BOOLEAN_MAPPING[value] }
+  typecaster('ActiveData::UUID') do |value|
+    case value
+    when UUIDTools::UUID
+      ActiveData::UUID.parse_raw value.raw
+    when ActiveData::UUID
+      value
+    when String
+      ActiveData::UUID.parse_string value
+    when Integer
+      ActiveData::UUID.parse_int value
+    else
+      nil
+    end
+  end
+end
+
+require 'active_data/model'
+
+ActiveSupport.on_load :active_record do
+  require 'active_data/active_record/associations'
+  require 'active_data/active_record/nested_attributes'
+
+  include ActiveData::ActiveRecord::Associations
+  include ActiveData::ActiveRecord::NestedAttributes
 end