client-data-adapter 0.0.1 → 0.1.0.pre.beta.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d22c20655882168eee2a1aebb0d9baa020eeb7fc5de989ab7792b0ba0d24714
-  data.tar.gz: 047c8570cfff746117be247f0ae33f2c4730d0a4f5c46a66e2b656541ca3b7d4
+  metadata.gz: ae1af95313ca1dd4dfa4c1fa52e0ef35190f34b18ce6551d4c7a28966b7d5276
+  data.tar.gz: 69288c481e2581cc2f6620363810370d91620ec4de09197382567335030286ce
 SHA512:
-  metadata.gz: c5dfc5fef8188b94dc8c044203848449af5a6428b5e2a7af9f06c212b7df6abbd27830c3244d15f97151906e3c1290d091a3f74b41300ac7e8d925bacee384e6
-  data.tar.gz: 93eb2e996f82fdc2535d7e10e4df89f9e48271a88e15966dddac6956730c997bb11e320188c924648118ceb33b541c94238b84acbed0ef36615f6c5b2ebd8b4a
+  metadata.gz: 453755d6922cae9c97db0bd879c5152008ba5012a661ebc4f47d53860a6e2f36bbcc5ab0a2d03213501845e59ba1197f3336e17e2314e48821613ad46820b46d
+  data.tar.gz: 315ca608ef5326325fa0be42e17e78da389c6e97cd1b43427aeb02b93d0750efa13d31abb1dc2f4c2119eb993082ac1b5e2299cf88cef3220447a92a458c2d84

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -2,3 +2,7 @@
 .vscode
 .idea
 .DS_Store
+coverage
+.yardoc
+Gemfile.lock
+doc

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+env:
+  - IS_CI=1
+rvm:
+  - 2.1
+  - 2.5
+  - 2.6
+script:
+  - bundle exec rspec

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://gems.ruby-china.com/'
+
+group :development, :test do
+  gem 'rspec'
+  gem 'simplecov'
+  gem 'coveralls'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019-present, By shadow
+
+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

@@ -1 +1,361 @@
 # client-data-adapter
+
+[![Build Status](https://travis-ci.org/jinghua000/client-data-adapter.svg?branch=master)](https://travis-ci.org/jinghua000/client-data-adapter)
+[![Gem Version](https://badge.fury.io/rb/client-data-adapter.svg)](https://rubygems.org/gems/client-data-adapter)
+[![Coverage Status](https://coveralls.io/repos/github/jinghua000/client-data-adapter/badge.svg?branch=master)](https://coveralls.io/github/jinghua000/client-data-adapter?branch=master)
+
+## Table of Contents
+  * [Introduction](#introduction)
+  * [Install](#install)
+  * [Usage](#usage)
+    + [`define_adapter`](#define_adapter)
+    + [`adapter`](#adapter)
+    + [`with`](#with)
+      - [Merge Methods](#merge-methods)
+      - [Pass Arguments](#pass-arguments)
+      - [Use Return](#use-return)
+      - [Read Methods Inside](#read-methods-inside)
+    + [`link_one`](#link_one)
+    + [`link_many`](#link_many)
+    
+## Introduction
+
+For unify data formats to transfer to clients.
+
+## Install 
+
+```bash
+gem install client-data-adapter
+```
+
+or in `Gemfile`
+
+```ruby
+gem 'client-data-adapter'
+```
+
+## Usage
+
+### `define_adapter`
+
+Include library to model and use `define_adapter` to define the adapter.
+
+```ruby
+# book.rb
+
+include ClientDataAdapter
+
+define_adapter do
+
+  # define your adapter here...
+
+end
+
+```
+
+### `adapter`
+
+`adapter` method define the main adapter, and common structure should be a `Hash`. 
+
+```ruby
+# ...
+
+define_adapter do
+
+  adapter do
+    {
+      id: id,
+      title: title,
+    }
+  end
+
+end
+```
+
+In elsewhere
+
+```ruby
+# ...
+
+@book = Book.new(id: 1, title: 'My Book')
+@book.adapter # => { id: 1, title: 'My Book' } 
+
+```
+
+### `with`
+
+And you are probably need some complex calculation or related some other class,
+they maybe need some cost and don't need to load everywhere.
+
+So we need use them *on-demand*.
+
+```ruby
+# ...
+
+define_adapter do
+
+  adapter do
+    {
+      id: id,
+      title: title,
+    }
+  end
+  
+  with :my_complex_calc do
+    'something complex'
+  end
+
+end
+```
+
+Then
+
+```ruby
+# ...
+
+@book = Book.new(id: 1, title: 'My Book')
+@book.adapter(:my_complex_calc) 
+# => { id: 1, title: 'My Book', my_complex_calc: 'something complex' }
+```
+
+#### Merge Methods
+
+And you can merge any instance method of original class to the adapter result, such as
+
+```ruby
+# book.rb
+
+def full_title
+  "<#{title}>"
+end
+```
+
+Then you can use adapter like this
+
+```ruby
+# ... 
+ 
+@book.adapter(:full_title)
+# => { id: 1, title: 'My Book', full_title: '<My Book>' }
+```
+
+It will set the `method name` as the `key`, and `returns` as the `value`.
+
+> But notice that if method name is repeated, will trigger the one inside the adapter.
+
+#### Pass Arguments
+
+Sometimes we need pass some arguments to deal different case, you can write like this
+
+```ruby
+@book.adapter(foo: [:bar, :baz])
+```
+
+Arguments with `Hash` will consider the `key` as the `method name`,
+and `values` as `arguments`.
+
+To work with the method like this  
+
+```ruby
+def foo(*args)
+  args.join(',')
+end
+```
+
+or this
+
+```ruby
+# ...
+
+with :foo do |*args|
+  args.join(',')
+end
+```
+
+The result will be 
+
+```ruby
+@book.adapter(foo: [:bar, :baz]) 
+# => { id: 1, title: 'My Book', foo: 'bar,baz' }
+```
+
+#### Use Return
+
+You can use return in adapter block to flow control.
+
+```ruby
+# ...
+
+with :id do
+  return 'i have no id' unless id 
+  id
+end
+``` 
+
+It is works.
+
+#### Read Methods Inside
+
+If you define something inside the adapter, you can't read it directly.
+
+```ruby
+# book.rb
+
+define_adapter do
+  # ...
+  
+  with :my_method do
+    'invoke me please!'
+  end
+  
+end
+```
+
+```ruby
+@book.my_method # => ERROR! No Method
+```
+
+Since that adapter differentiate the namespace with the original class 
+to make naming more flexible.
+
+It create a wrapper for the adapter named `AdapterWrapper`, 
+and exposed by the instance method `adapter_wrapper`.
+
+```ruby
+@book.adapter_wrapper.class # => Book::AdapterWrapper
+```
+
+And you can read the adapter internal method via it.
+
+```ruby
+@book.adapter_wrapper.my_method # => works
+```
+
+hmm... but i am not very recommend you to use it by this way, 
+if you need some method works alone, 
+maybe you should define it in the original class.
+
+### `link_one`
+
+This method is a syntactic sugar of [`with`](#with), seems like
+
+```ruby
+with :my_link do |*args|
+  my_link.adapter(*args)
+end
+```
+
+is equal with
+
+```ruby
+link_one :my_link
+```
+
+It usual used in one-to-one relationship like `belongs_to` in `rails`.
+
+For example
+
+```ruby
+# book.rb
+
+belongs_to :book_shelf 
+
+define_adapter do
+  link_one :book_shelf
+
+  # ...
+end
+
+```
+
+```ruby
+# book_shelf.rb
+
+define_adapter do
+  
+  adapter do
+    {
+      id: id,
+      desc: desc,
+    }
+  end
+    
+end
+```
+
+Then
+
+```ruby
+@book.adapter(:book_shelf)
+# => { id: 1, title: 'My Book', book_shelf: @book.book_shelf.adapter }
+```
+
+Of course you can pass some arguments, and if you have several links,
+they can also used in nested.
+
+```ruby
+# ...
+ 
+@book.adapter(book_shelf: [library: :some_method])
+```
+
+And can define many links once.
+
+```ruby
+# ...
+
+link_one :my_link1, :my_link2
+```
+
+### `link_many`
+
+Okay, this method is similar with [`link_one`](#link_one) but multiple.
+
+If use `with` to implement likes
+
+```ruby
+with :my_links do |*args|
+  my_links.map { |link| link.adapter(*args) } 
+end
+```
+
+Usual used in one-to-many relationship, such as `has_many` in `rails`.
+
+For example
+
+```ruby
+# book.rb
+
+has_many :categories 
+
+define_adapter do
+  link_many :categories
+
+  # ...
+end
+
+```
+
+```ruby
+# category.rb
+
+define_adapter do
+  
+  adapter do
+    {
+      id: id,
+      desc: desc,
+    }
+  end
+    
+end
+```
+
+Then
+
+```ruby
+@book.adapter(:categories)
+# => { id: 1, title: 'My Book', categories: @book.categories.map(&:adapter) }
+```
+
+Support multiple arguments and other usage, detail above.

data/build.sh

@@ -0,0 +1 @@
+gem build client-data-adapter.gemspec

data/client-data-adapter.gemspec

@@ -1,13 +1,16 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
 Gem::Specification.new do |s|
 
   s.name = 'client-data-adapter'
-  s.version = '0.0.1'
-  s.date = '2019-11-11'
-  s.summary = 'client adapter'
-  s.description = 'Adapter for data transfer to client.'
+  s.version = '0.1.0-beta.0'
+  s.summary = 'client data adapter'
+  s.description = 'For unify data formats to transfer to clients.'
   s.authors = ['shadow']
   s.files = `git ls-files`.split("\n")
-  s.homepage = 'https://github.com/jinghua000/client-adapter'
+  s.homepage = 'https://github.com/jinghua000/client-data-adapter'
   s.license = 'MIT'
+  s.required_ruby_version = '>= 2.1'
 
 end

data/demo/book.rb

@@ -0,0 +1,81 @@
+require_relative '../lib/client-data-adapter'
+require_relative 'book_shelf'
+require_relative 'category'
+
+class Book
+
+  include ClientDataAdapter
+
+  define_adapter do
+
+    link_one :book_shelf
+    link_many :categories
+
+    adapter do
+      {
+        id: id,
+        title: title,
+      }
+    end
+
+    with :full_title do
+      "<#{title}>"
+    end
+
+    with :my_awesome_title do
+      "my_awesome_title"
+    end
+
+    with :pass1 do |*args|
+      args << 'pass1'
+    end
+
+    with :pass2 do |*args|
+      args << 'pass2'
+    end
+
+    with :id do
+      return id
+    end
+
+  end
+
+  attr_accessor :id, :title, :book_shelf_id
+
+  def initialize(**opt)
+
+    self.id = opt[:id]
+    self.title = opt[:title]
+    self.book_shelf_id = opt[:book_shelf_id]
+
+  end
+
+  def self.demo
+    new(
+      id: 1,
+      title: 'My Book',
+      book_shelf_id: 1,
+    )
+  end
+
+  def my_title
+    'my title'
+  end
+
+  def my_awesome_title
+    'no no no'
+  end
+
+  def sub_title(sub)
+    "#{title}-#{sub}"
+  end
+
+  def book_shelf
+    BookShelf.demo
+  end
+
+  def categories
+    [Category.new(id: 1, cat: 'one'), Category.new(id: 2, cat: 'two')]
+  end
+
+end

data/demo/book_shelf.rb

@@ -0,0 +1,46 @@
+require_relative 'library'
+
+class BookShelf
+
+  include ClientDataAdapter
+
+  define_adapter do
+
+    link_one :library
+
+    adapter do
+      {
+        id: id,
+        desc: desc,
+      }
+    end
+
+    with :other_desc do
+      'other desc'
+    end
+
+  end
+
+  attr_accessor :id, :desc, :library_id
+
+  def initialize(**opt)
+
+    self.id = opt[:id]
+    self.desc = opt[:desc]
+    self.library_id = opt[:library_id]
+
+  end
+
+  def self.demo
+    new(
+      id: 1,
+      desc: 'my book shelf',
+      library_id: 1,
+    )
+  end
+
+  def library
+    Library.demo
+  end
+
+end

data/demo/category.rb

@@ -0,0 +1,29 @@
+class Category
+
+  include ClientDataAdapter
+
+  define_adapter do
+
+    adapter do
+      {
+        id: id,
+        cat: cat,
+      }
+    end
+
+  end
+
+  attr_accessor :id, :cat
+
+  def initialize(**opt)
+
+    self.id = opt[:id]
+    self.cat = opt[:cat]
+
+  end
+
+  def summary
+    'summary'
+  end
+
+end

data/demo/library.rb

@@ -0,0 +1,36 @@
+class Library
+
+  include ClientDataAdapter
+
+  define_adapter do
+
+    adapter do
+      {
+        id: id,
+        size: size,
+      }
+    end
+
+    with :welcome do
+      'welcome'
+    end
+
+  end
+
+  attr_accessor :id, :size, :city_id
+
+  def initialize(**opt)
+
+    self.id = opt[:id]
+    self.size = opt[:size]
+
+  end
+
+  def self.demo
+    new(
+      id: 1,
+      size: 'small'
+    )
+  end
+
+end

data/lib/client-data-adapter.rb

@@ -1,7 +1,11 @@
+require_relative 'client-data-adapter/class_methods'
+require_relative 'client-data-adapter/instance_methods'
+
 module ClientDataAdapter
 
-  def self.demo
-    'hello'
+  def self.included(base)
+    base.include(ClientDataAdapter::InstanceMethods)
+    base.extend(ClientDataAdapter::ClassMethods)
   end
 
 end

data/lib/client-data-adapter/class_methods.rb

@@ -0,0 +1,25 @@
+require_relative 'config'
+require_relative 'wrapper'
+
+module ClientDataAdapter
+  module ClassMethods
+
+    # @yield define the adapter in the block
+    # @example
+    #   define_adapter do
+    #     # define your adapter here.
+    #     # ...
+    #   end
+    def define_adapter(&block)
+
+      const_set(ADAPTER_WRAPPER, Class.new(Wrapper))
+
+      # Return the wrapper of adapter.
+      define_method :adapter_wrapper do
+        @__adapter_wrapper__ ||= self.class.const_get(ADAPTER_WRAPPER).new(self, &block)
+      end
+
+    end
+
+  end
+end

data/lib/client-data-adapter/config.rb

@@ -0,0 +1,6 @@
+module ClientDataAdapter
+
+  ADAPTER_WRAPPER = :AdapterWrapper
+  ADAPTER = :adapter
+
+end

data/lib/client-data-adapter/instance_methods.rb

@@ -0,0 +1,45 @@
+require_relative 'util'
+
+module ClientDataAdapter
+  module InstanceMethods
+
+    # Main adapter method.
+    #
+    # @param args [Symbol|String|Hash]
+    # @example
+    #   @book.adapter(:method1, method2: 'payload', method3: [:foo, :bar])
+    def adapter(*args)
+
+      length = args.length
+
+      if length == 0
+        adapter_wrapper.__adapter__
+      else
+        Util.merge(
+          adapter_wrapper.__adapter__,
+          *args.map do |arg|
+            if [String, Symbol].include?(arg.class)
+              __merge_to_adapter__(arg.to_sym, nil)
+            elsif arg.is_a?(Hash)
+              arg.map { |k, v| __merge_to_adapter__(k, v) }
+            else
+              raise '[ERROR] Not available arguments type.'
+            end
+          end.flatten,
+        )
+      end
+    end
+
+    private
+
+    def __merge_to_adapter__(key, params)
+      {}.tap do |hah|
+        hah["#{key}".to_sym] =
+          adapter_wrapper.respond_to?(key) ?
+            adapter_wrapper.public_send(key, *params) :
+            public_send(key, *params)
+      end
+    end
+
+  end
+end

data/lib/client-data-adapter/util.rb

@@ -0,0 +1,36 @@
+module ClientDataAdapter
+  module Util
+
+    module_function
+
+    # Merge some hash.
+    #
+    # @param [Hash] elements
+    def merge(*elements)
+      {}.tap do |hsh|
+        elements.each do |elem|
+          elem.each do |k, v|
+            hsh[k] = v
+          end
+        end
+      end
+    end
+
+    # Convert a Proc to Lambda.
+    #
+    # @param [Proc] source_proc
+    # @return [Lambda]
+    def to_lambda(source_proc)
+      return source_proc if source_proc.lambda?
+
+      unbound_method = Module.new.module_eval do
+        instance_method(define_method(:_, &source_proc))
+      end
+
+      lambda do |*args, &block|
+        unbound_method.bind(self).call(*args, &block)
+      end
+    end
+
+  end
+end

data/lib/client-data-adapter/wrapper.rb

@@ -0,0 +1,108 @@
+require_relative 'util'
+
+module ClientDataAdapter
+  class Wrapper
+
+    # Instance of original class.
+    #
+    # @example
+    #   @book.adapter_wrapper.target == @book # => true
+    attr_reader :target
+
+    def initialize(target, &block)
+      @target = target
+
+      self.class.module_eval(&block)
+    end
+
+
+    # Main adapter method, should return +Hash+.
+    #
+    # Syntactic sugar of +with+.
+    #
+    # @return [Hash]
+    # @see with
+    # @example
+    #   define_adapter do
+    #
+    #     adapter do
+    #       {
+    #         id: id,
+    #         title: title,
+    #       }
+    #     end
+    #
+    #   end
+    def self.adapter(&block)
+      with('__adapter__', &block)
+    end
+
+    # Used in one-to-one relationship.
+    #
+    # Syntactic sugar of +with+.
+    #
+    # @param [Symbol] associations
+    # @see with
+    # @example
+    #   define_adapter do
+    #
+    #     link_one(:link1, :link2)
+    #     # ...
+    #
+    #   end
+    def self.link_one(*associations)
+      associations.each do |assoc|
+        with(assoc) do |*args|
+          public_send(assoc.to_sym).adapter(*args)
+        end
+      end
+    end
+
+    # Used in one-to-many relationship.
+    #
+    # Syntactic sugar of +with+.
+    #
+    # @param [Symbol] associations
+    # @see with
+    # @example
+    #   define_adapter do
+    #
+    #     link_many(:link1, :link2)
+    #     # ...
+    #
+    #   end
+    def self.link_many(*associations)
+      associations.each do |assoc|
+        with(assoc) do |*args|
+          public_send(assoc.to_sym).map do |elem|
+            elem.adapter(*args)
+          end
+        end
+      end
+    end
+
+    # Define a method of +Wrapper+.
+    #
+    # Merged to the result of +adapter+ method.
+    #
+    # @param [Symbol] method_name
+    # @example
+    #   define_adapter do
+    #     # ...
+    #
+    #     with :something do
+    #       # do something
+    #     end
+    #
+    #   end
+    def self.with(method_name, &block)
+      define_method(method_name.to_sym) do |*args|
+        target.instance_exec(
+          *args,
+          &Util.to_lambda(block)
+        )
+      end
+    end
+
+  end
+end

data/spec/adapter_spec.rb

@@ -0,0 +1,81 @@
+require_relative '../demo/book'
+
+RSpec.describe Book do
+
+  before(:each) do
+    @book = Book.demo
+  end
+
+  it "adapter method return adapter wrapper's __adapter__" do
+
+    expect(@book.adapter).to eq(id: @book.id, title: @book.title)
+    expect(@book.adapter).to eq(@book.adapter_wrapper.__adapter__)
+
+  end
+
+  it "adapter can contain `with` method's returns" do
+
+    expect(@book.adapter_wrapper.respond_to? :full_title).to eq(true)
+    expect(@book.adapter(:full_title))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            full_title: @book.adapter_wrapper.full_title
+          )
+
+  end
+
+  it "adapter can contain origin class instance method" do
+
+    expect(@book.adapter_wrapper.respond_to? :my_title).to eq(false)
+    expect(@book.adapter(:my_title))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            my_title: @book.my_title
+          )
+
+  end
+
+  it "methods inside adapter wrapper will override method outside" do
+
+    expect(@book.my_awesome_title).not_to eq(@book.adapter_wrapper.my_awesome_title)
+    expect(@book.adapter(:my_awesome_title))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            my_awesome_title: @book.adapter_wrapper.my_awesome_title
+          )
+
+  end
+
+  it "adapter can pass arguments in `with` method block" do
+
+    expect(@book.adapter(pass1: [:a, :b, :c], pass2: [:x, :y, :z]))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            pass1: @book.adapter_wrapper.pass1(*[:a, :b, :c]),
+            pass2: @book.adapter_wrapper.pass2(*[:x, :y, :z]),
+          )
+
+  end
+
+  it "adapter can pass arguments with origin class instance methods" do
+
+    expect(@book.adapter(sub_title: 'yes'))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            sub_title: @book.sub_title('yes')
+          )
+
+  end
+
+  it "not available arguments type will raise an error" do
+
+    expect { @book.adapter(123) }.to raise_error(RuntimeError)
+
+  end
+
+end

data/spec/adapter_wrapper_spec.rb

@@ -0,0 +1,25 @@
+require_relative '../demo/book'
+
+RSpec.describe Book do
+
+  before(:each) do
+    @book = Book.demo
+  end
+
+  it "adapter wrapper should apply origin instance's self-point" do
+
+    expect(@book.adapter_wrapper.target).to eq(@book)
+
+  end
+
+  it "adapter wrapper's methods can use return inside" do
+
+    expect(@book.adapter_wrapper.id).to eq(@book.id)
+
+  end
+
+  it "adapter wrapper named `AdapterWrapper`" do
+    expect(@book.adapter_wrapper.class).to eq(Book::AdapterWrapper)
+  end
+
+end

data/spec/demo_spec.rb

@@ -0,0 +1,5 @@
+require_relative '../demo/book'
+
+RSpec.describe Book do
+
+end

data/spec/link_spec.rb

@@ -0,0 +1,104 @@
+require_relative '../demo/book'
+
+RSpec.describe Book do
+
+  before(:each) do
+    @book = Book.demo
+  end
+
+  it "link one should call linked target's adapter method" do
+
+    expect(@book.adapter(:book_shelf))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            book_shelf: {
+              id: @book.book_shelf.id,
+              desc: @book.book_shelf.desc,
+            }
+          )
+
+  end
+
+  it "link one can pass arguments" do
+
+    expect(@book.adapter(book_shelf: :other_desc))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            book_shelf: {
+              id: @book.book_shelf.id,
+              desc: @book.book_shelf.desc,
+              other_desc: @book.book_shelf.adapter_wrapper.other_desc,
+            }
+          )
+
+  end
+
+  it "link can be nested" do
+
+    @book_shelf = @book.book_shelf
+    @library = @book_shelf.library
+
+    expect(@book.adapter(book_shelf: [:other_desc, library: :welcome]))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            book_shelf: {
+              id: @book_shelf.id,
+              desc: @book_shelf.desc,
+              other_desc: @book_shelf.adapter_wrapper.other_desc,
+              library: {
+                id: @library.id,
+                size: @library.size,
+                welcome: @library.adapter_wrapper.welcome,
+              },
+            }
+          )
+  end
+
+  it "link many should call all linked targets's adapter method" do
+
+    @categories = @book.categories
+    expect(@book.adapter(:categories))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            categories: [
+              {
+                id: @categories[0].id,
+                cat: @categories[0].cat,
+              },
+              {
+                id: @categories[1].id,
+                cat: @categories[1].cat,
+              },
+            ]
+          )
+
+  end
+
+  it "link many can pass arguments" do
+
+    @categories = @book.categories
+    expect(@book.adapter(categories: :summary))
+      .to eq(
+            id: @book.id,
+            title: @book.title,
+            categories: [
+              {
+                id: @categories[0].id,
+                cat: @categories[0].cat,
+                summary: @categories[0].summary,
+              },
+              {
+                id: @categories[1].id,
+                cat: @categories[1].cat,
+                summary: @categories[1].summary,
+              },
+            ]
+          )
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,112 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'simplecov'
+SimpleCov.start
+SimpleCov.minimum_coverage 100
+
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end
+
+if ENV['IS_CI'].to_i == 1
+
+  require 'coveralls'
+  Coveralls.wear!
+
+end

data/update.sh

@@ -1,4 +1,4 @@
 git add .
-git commit -m 'update'
 git status
+git commit -m 'update'
 git push origin dev

metadata

@@ -1,27 +1,47 @@
 --- !ruby/object:Gem::Specification
 name: client-data-adapter
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0.pre.beta.0
 platform: ruby
 authors:
 - shadow
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-11 00:00:00.000000000 Z
+date: 2019-11-13 00:00:00.000000000 Z
 dependencies: []
-description: Adapter for data transfer to client.
+description: For unify data formats to transfer to clients.
 email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".coveralls.yml"
 - ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
 - README.md
+- build.sh
 - client-data-adapter.gemspec
+- demo/book.rb
+- demo/book_shelf.rb
+- demo/category.rb
+- demo/library.rb
 - lib/client-data-adapter.rb
+- lib/client-data-adapter/class_methods.rb
+- lib/client-data-adapter/config.rb
+- lib/client-data-adapter/instance_methods.rb
+- lib/client-data-adapter/util.rb
+- lib/client-data-adapter/wrapper.rb
+- spec/adapter_spec.rb
+- spec/adapter_wrapper_spec.rb
+- spec/demo_spec.rb
+- spec/link_spec.rb
+- spec/spec_helper.rb
 - update.sh
-homepage: https://github.com/jinghua000/client-adapter
+homepage: https://github.com/jinghua000/client-data-adapter
 licenses:
 - MIT
 metadata: {}
@@ -33,15 +53,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
-summary: client adapter
+summary: client data adapter
 test_files: []