clowne 0.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: cb07a988be474d61f3bbf9360cfc4ab25de047be
-  data.tar.gz: 1a4763ae4bd1537ab0a254d4a0ebcb5ddd56930d
+SHA256:
+  metadata.gz: 3f0d72961e8144605b8f0dbd7953161f17ec4c585c67b3e5bde80d84b3664f1b
+  data.tar.gz: 5981d937f60d54993ab6bee595598dbc0b52ac99e38e29ef84f5007661929c5b
 SHA512:
-  metadata.gz: 1ff3270acfabe0aebebfd272b3cb6eb27c9c7faea337fb59489898e008095d71dbfb835062e6c99c3b0fbc4b63e909073dd7e9e46231a6c3a0ecf5762f7204ef
-  data.tar.gz: 53e267bcb71f9283a64bb95df753e26b38058d5283c0b0b01276209fe6a27a07b3906cfbae881734875fca9a987e25fcbda6b3143f44956ef361102296821860
+  metadata.gz: ecd7010d94b67e2f0c9f19d2dbde4b6b302481156be2657199d6d9fa98c142807f1b006ddb306a2fd8cb3b2d72b3fd4e1708e34c5fe3541ddd0b2320b5e63112
+  data.tar.gz: d56c783b4eed7af9ac5e478cfc2b2154b74644ea03fcc84f9fb7bd54c4e2ac8505355bd0ba0405c96255046232f3eee12c83671ef64173f29097ab859a9e428f

data/.rubocop.yml

@@ -1,62 +1,28 @@
 require:
-- 'rubocop-md'
+  # add after moving docs to another tool
+  - 'standard/cop/semantic_blocks'
+  - 'rubocop-md'
+
+inherit_gem:
+  standard: config/base.yml
+
 AllCops:
   Exclude:
     - 'bin/**/*'
     - 'tmp/**/*'
-    - 'docs/web/**/*'
     - 'vendor/**/*'
     - 'gemfiles/vendor/**/*'
+    - 'clowne.gemspec'
   DisplayCopNames: true
-  StyleGuideCopsOnly: false
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.5
 
 Markdown:
   WarnInvalid: true
 
-Rails:
-  Enabled: false
-
-Naming/AccessorMethodName:
-  Enabled: false
-
-Naming/ClassAndModuleCamelCase:
-  Exclude:
-    - 'spec/**/*.rb'
-
-Style/TrivialAccessors:
-  Enabled: false
-
-Metrics/LineLength:
-  Max: 100
-
-Style/Documentation:
-  Exclude:
-    - 'spec/**/*.rb'
-    - 'README.md'
-
-Style/SymbolArray:
-  Enabled: false
-
-Style/FrozenStringLiteralComment:
-  Exclude:
-    - 'spec/**/*.rb'
-    - 'Gemfile'
-    - 'Rakefile'
-    - '*.gemspec'
-    - 'CHANGELOG.md'
-    - 'README.md'
-
-Metrics/BlockLength:
-  Exclude:
-    - 'spec/**/*.rb'
-
-Bundler/OrderedGems:
-  Enabled: false
-
-Gemspec/OrderedDependencies:
+Standard/SemanticBlocks:
   Enabled: false
 
 Lint/Void:
   Exclude:
+    - 'docs/README.md'
     - 'README.md'

data/.travis.yml

@@ -1,11 +1,12 @@
 sudo: false
 language: ruby
+cache: bundler
 
 notifications:
   email: false
 
 before_install:
-  gem update --system
+  - gem install bundler
 
 before_script:
   # Only generate coverage report for the specified job
@@ -15,38 +16,30 @@ before_script:
 script:
   - bundle exec rake
   - if [ "$CC_REPORT" == "true" ]; then ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT; fi
-  - if [ "$DEPLOY_ME" == "true" ]; then (cd ./docs/web && yarn && yarn run build); fi
 
 matrix:
   fast_finish: true
   include:
     - rvm: ruby-head
       gemfile: gemfiles/railsmaster.gemfile
-    - rvm: jruby-9.1.0.0
+    - rvm: jruby-9.2.8.0
       gemfile: gemfiles/jruby.gemfile
-    - rvm: 2.5.0
+    - rvm: 3.0
       gemfile: Gemfile
-    - rvm: 2.4.3
+    - rvm: 2.7
       gemfile: Gemfile
-      env:
-        - CC_REPORT=true
-        - DEPLOY_ME=true
-    - rvm: 2.4.1
-      gemfile: gemfiles/activerecord42.gemfile
-    - rvm: 2.3.1
+    - rvm: 2.6.5
+      gemfile: Gemfile
+    - rvm: 2.5.7
       gemfile: Gemfile
-    - rvm: 2.2.0
+    - rvm: 2.4.9
       gemfile: gemfiles/activerecord42.gemfile
+    - rvm: truffleruby-head
+      gemfile: Gemfile
   allow_failures:
     - rvm: ruby-head
       gemfile: gemfiles/railsmaster.gemfile
-    - rvm: jruby-9.1.0.0
+    - rvm: jruby-9.2.8.0
       gemfile: gemfiles/jruby.gemfile
-deploy:
-  provider: pages
-  skip_cleanup: true
-  github_token: $GITHUB_TOKEN
-  local_dir: "./docs/web/build/clowne"
-  on:
-    branch: master
-    condition: $DEPLOY_ME = true
+    - rvm: truffleruby-head
+      gemfile: Gemfile

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Change log
 
+## 1.1.0 (2019-03-20)
+
+
+- Add `after_clone` declaration. ([@elardo][])
+- Add opporotunity to include belongs_to association for active_record adapter. ([@madding][])
+
+## 1.0.0 (2019-02-26)
+
+- Return `Operation` instance as a rusult of cloning. ([@ssnickolay][])
+
+See [migration guide](https://clowne.evilmartians.io/docs/from_v02_to_v10.html)
+
+- Add `after_persist` declaration. ([@ssnickolay][], [@palkan][])
+
+- Unify interface between adapters. ([@ssnickolay][])
+
+- Deprecate `Operation#save` and `Operation#save!` methods. ([@ssnickolay][])
+
+- Improve Docs ([@ssnickolay][], [@palkan][])
+
+## 0.2.0 (2018-02-21)
+
+- Add `Cloner#partial_apply` method. ([@palkan][])
+
+- Add RSpec matchers `clone_association` / `clone_associations`. ([@palkan][])
+
+- [[#15](https://github.com/palkan/clowne/issues/15)] Add control over nested params. ([@ssnickolay][])
+
 ## 0.1.0 (2018-02-01)
 
 - Add `init_as` declaration. ([@palkan][])
@@ -14,3 +42,5 @@
 
 [@palkan]: https://github.com/palkan
 [@ssnickolay]: https://github.com/ssnickolay
+[@elardo]: https://github.com/elardo
+[@madding]: https://github.com/madding

data/Gemfile

@@ -1,15 +1,19 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in clowne.gemspec
 gemspec
 
-gem 'pry-byebug'
-gem 'sqlite3'
-gem 'activerecord', '>= 5.0'
-gem 'sequel', '>= 5.0'
-gem 'simplecov'
+gem "pry-byebug", platform: :mri
 
-local_gemfile = 'Gemfile.local'
+gem "sqlite3", "~> 1.4.1", platform: :ruby
+gem "activerecord-jdbcsqlite3-adapter", "~> 50.0", platform: :jruby
+gem "jdbc-sqlite3", platform: :jruby
+
+gem "activerecord", ">= 6.0", "< 6.2.0"
+gem "sequel", ">= 5.0"
+gem "simplecov"
+
+local_gemfile = "Gemfile.local"
 
 if File.exist?(local_gemfile)
   eval(File.read(local_gemfile)) # rubocop:disable Security/Eval

data/README.md

@@ -1,14 +1,17 @@
 [![Gem Version](https://badge.fury.io/rb/clowne.svg)](https://badge.fury.io/rb/clowne)
-[![Build Status](https://travis-ci.org/palkan/clowne.svg?branch=master)](https://travis-ci.org/palkan/clowne)
-[![Test Coverage](https://codeclimate.com/github/palkan/clowne/badges/coverage.svg)](https://codeclimate.com/github/palkan/clowne/coverage)
-[![Docs](https://img.shields.io/readthedocs/pip.svg)](https://palkan.github.io/clowne)
+[![Build Status](https://travis-ci.org/clowne-rb/clowne.svg?branch=master)](https://travis-ci.org/clowne-rb/clowne)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/9143c4f91e9d1d2a4bd1/test_coverage)](https://codeclimate.com/github/clowne-rb/clowne/test_coverage)
+[![Maintainability](https://api.codeclimate.com/v1/badges/9143c4f91e9d1d2a4bd1/maintainability)](https://codeclimate.com/github/clowne-rb/clowne/maintainability)
+[![Docs](https://img.shields.io/badge/docs-link-brightgreen.svg)](https://clowne.evilmartians.io)
 
 # Clowne
 
-**NOTE**: this is the documentation for pre-release version **0.1.0.beta1**.
-
 A flexible gem for cloning your models. Clowne focuses on ease of use and provides the ability to connect various ORM adapters.
 
+📖 Read [Evil Martians Chronicles](https://evilmartians.com/chronicles/clowne-clone-ruby-models-with-a-smile) to learn about possible use cases.
+
+📑 [Documentation](https://clowne.evilmartians.io)
+
 <a href="https://evilmartians.com/">
 <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
 
@@ -24,7 +27,7 @@ gem install clowne
 Or add this line to your application's Gemfile:
 
 ```ruby
-gem 'clowne'
+gem "clowne"
 ```
 
 ## Quick Start
@@ -42,6 +45,16 @@ class User < ActiveRecord::Base
   has_one :profile
   has_many :posts
 end
+
+class Profile < ActiveRecord::Base
+  # create_table :profiles do |t|
+  #   t.string :name
+  # end
+end
+
+class Post < ActiveRecord::Base
+  # create_table :posts
+end
 ```
 
 Let's declare our cloners first:
@@ -56,7 +69,7 @@ class UserCloner < Clowne::Cloner
   nullify :login
 
   # params here is an arbitrary Hash passed into cloner
-  finalize do |_source, record, params|
+  finalize do |_source, record, **params|
     record.email = params[:email]
   end
 end
@@ -72,13 +85,20 @@ Now you can use `UserCloner` to clone existing records:
 
 ```ruby
 user = User.last
-#=> <#User(login: 'clown', email: 'clown@circus.example.com')>
+# => <#User id: 1, login: 'clown', email: 'clown@circus.example.com'>
+
+operation = UserCloner.call(user, email: "fake@example.com")
+# => <#Clowne::Utils::Operation...>
+
+operation.to_record
+# => <#User id: nil, login: nil, email: 'fake@example.com'>
+
+operation.persist!
+# => true
 
-cloned = UserCloner.call(user, email: 'fake@example.com')
-cloned.persisted?
-# => false
+cloned = operation.to_record
+# => <#User id: 2, login: nil, email: 'fake@example.com'>
 
-cloned.save!
 cloned.login
 # => nil
 cloned.email
@@ -91,20 +111,20 @@ cloned.profile.name
 # => nil
 ```
 
-Take a look at our [documentation](https://palkan.github.io/clowne) for more information!
+Take a look at our [documentation](https://clowne.evilmartians.io) for more info!
 
 ### Supported ORM adapters
 
-Adapter                                   |1:1         | 1:M         | M:M                     |
-------------------------------------------|------------|-------------|-------------------------|
-[Active Record](https://palkan.github.io/clowne/docs/active_record.html)  | has_one    | has_many    | has_and_belongs_to_many |
-[Sequel](https://palkan.github.io/clowne/docs/sequel.html)           | one_to_one | one_to_many | many_to_many            |
+Adapter                                   |1:1         |*:1         | 1:M         | M:M                     |
+------------------------------------------|------------|------------|-------------|-------------------------|
+[Active Record](https://clowne.evilmartians.io/#/active_record)  | has_one    | belongs_to | has_many    | has_and_belongs_to|
+[Sequel](https://clowne.evilmartians.io/#/sequel)                | one_to_one | -          | one_to_many | many_to_many     |
 
 ## Maintainers
 
 - [Vladimir Dementyev](https://github.com/palkan)
 
-- [Sverchkov Nikolay](https://github.com/ssnickolay)
+- [Nikolay Sverchkov](https://github.com/ssnickolay)
 
 ## License
 

data/Rakefile

@@ -1,6 +1,6 @@
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-require 'rubocop/rake_task'
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 RuboCop::RakeTask.new

data/clowne.gemspec

@@ -1,4 +1,4 @@
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'clowne/version'
 
@@ -8,22 +8,29 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Vladimir Dementyev', 'Sverchkov Nikolay']
   spec.email         = ['palkan@evilmartians.com', 'ssnikolay@gmail.com']
 
-  spec.summary       = 'A flexible gem for cloning your models.'
+  spec.summary       = 'A flexible gem for cloning your models'
   spec.description   = 'A flexible gem for cloning your models.'
-  spec.homepage      = 'https://github.com/palkan/clowne'
+  spec.homepage      = 'https://github.com/clowne-rb/clowne'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.metadata = {
+    "bug_tracker_uri" => "http://github.com/clowne-rb/clowne/issues",
+    "changelog_uri" => "https://github.com/clowne-rb/clowne/blob/master/CHANGELOG.md",
+    "documentation_uri" => "https://clowne.evilmartians.io/",
+    "homepage_uri" => "https://clowne.evilmartians.io/",
+    "source_code_uri" => "http://github.com/clowne-rb/clowne"
+  }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.14'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 12.3', '>= 12.3.3'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'factory_bot', '~> 4.8'
-  spec.add_development_dependency 'rubocop', '~> 0.51'
-  spec.add_development_dependency 'rubocop-md', '~> 0.2'
+  spec.add_development_dependency 'factory_bot', '~> 5'
+  spec.add_development_dependency 'rubocop', '~> 0.75.0'
+  spec.add_development_dependency 'rubocop-md', '~> 0.3.0'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.36.0'
+  spec.add_development_dependency 'standard', '~> 0.1.5'
 end

data/docs/.rubocop.yml

@@ -1,5 +1,5 @@
-Metrics/LineLength:
-  Max: 100
+inherit_gem:
+  standard: config/base.yml
 
 Lint/Void:
   Exclude:
@@ -8,5 +8,11 @@ Lint/Void:
 Metrics/AbcSize:
   Enabled: false
 
+Standard/SemanticBlocks:
+  Enabled: false
+
 Metrics/BlockLength:
   Enabled: false
+
+Metrics/LineLength:
+  Enabled: false

data/docs/CNAME

@@ -0,0 +1 @@
+clowne.evilmartians.io

data/docs/README.md

@@ -0,0 +1,131 @@
+[![Gem Version](https://badge.fury.io/rb/clowne.svg)](https://badge.fury.io/rb/clowne)
+[![Build Status](https://travis-ci.org/clowne-rb/clowne.svg?branch=master)](https://travis-ci.org/clowne-rb/clowne)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/9143c4f91e9d1d2a4bd1/test_coverage)](https://codeclimate.com/github/clowne-rb/clowne/test_coverage)
+[![Maintainability](https://api.codeclimate.com/v1/badges/9143c4f91e9d1d2a4bd1/maintainability)](https://codeclimate.com/github/clowne-rb/clowne/maintainability)
+[![Docs](https://img.shields.io/badge/docs-link-brightgreen.svg)](https://clowne.evilmartians.io)
+
+# Clowne
+
+A flexible gem for cloning your models. Clowne focuses on ease of use and provides the ability to connect various ORM adapters.
+
+📖 Read [Evil Martians Chronicles](https://evilmartians.com/chronicles/clowne-clone-ruby-models-with-a-smile) to learn about possible use cases.
+
+📑 [Documentation](https://clowne.evilmartians.io)
+
+<a href="https://evilmartians.com/">
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
+
+
+## Installation
+
+To install Clowne with RubyGems:
+
+```ruby
+gem install clowne
+```
+
+Or add this line to your application's Gemfile:
+
+```ruby
+gem "clowne"
+```
+
+## Quick Start
+
+Assume that you have the following model:
+
+```ruby
+class User < ActiveRecord::Base
+  # create_table :users do |t|
+  #  t.string :login
+  #  t.string :email
+  #  t.timestamps null: false
+  # end
+
+  has_one :profile
+  has_many :posts
+end
+
+class Profile < ActiveRecord::Base
+  # create_table :profiles do |t|
+  #   t.string :name
+  # end
+end
+
+class Post < ActiveRecord::Base
+  # create_table :posts
+end
+```
+
+Let's declare our cloners first:
+
+```ruby
+class UserCloner < Clowne::Cloner
+  adapter :active_record
+
+  include_association :profile, clone_with: SpecialProfileCloner
+  include_association :posts
+
+  nullify :login
+
+  # params here is an arbitrary Hash passed into cloner
+  finalize do |_source, record, **params|
+    record.email = params[:email]
+  end
+end
+
+class SpecialProfileCloner < Clowne::Cloner
+  adapter :active_record
+
+  nullify :name
+end
+```
+
+Now you can use `UserCloner` to clone existing records:
+
+```ruby
+user = User.last
+# => <#User id: 1, login: 'clown', email: 'clown@circus.example.com'>
+
+operation = UserCloner.call(user, email: "fake@example.com")
+# => <#Clowne::Utils::Operation...>
+
+operation.to_record
+# => <#User id: nil, login: nil, email: 'fake@example.com'>
+
+operation.persist!
+# => true
+
+cloned = operation.to_record
+# => <#User id: 2, login: nil, email: 'fake@example.com'>
+
+cloned.login
+# => nil
+cloned.email
+# => "fake@example.com"
+
+# associations:
+cloned.posts.count == user.posts.count
+# => true
+cloned.profile.name
+# => nil
+```
+
+Take a look at our [documentation](https://clowne.evilmartians.io) for more info!
+
+### Supported ORM adapters
+
+Adapter                                   |1:1         |*:1         | 1:M         | M:M                     |
+------------------------------------------|------------|------------|-------------|-------------------------|
+[Active Record](active_record)  | has_one    | belongs_to | has_many    | has_and_belongs_to|
+[Sequel](sequel)                | one_to_one | -          | one_to_many | many_to_many     |
+
+## Maintainers
+
+- [Vladimir Dementyev](https://github.com/palkan)
+
+- [Nikolay Sverchkov](https://github.com/ssnickolay)
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).