alba 0.1.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62d87c709e80629fa4f9373e113a141da7489703d309fd1ed6b9b411e427a101
-  data.tar.gz: 3aacb3b018632b50cd2c71052c783e6aae97d6d79c2d1f0bb107ba07cc0d5bbd
+  metadata.gz: efa21967c65ad6880f19fbb2ec2fd795ed1b71f477084056068b23984df60834
+  data.tar.gz: 556f95a3ad12a7fdc591f8b7e336a7bc2d6c4b99710198f9bdc4e36b1389e0d2
 SHA512:
-  metadata.gz: 3eb9360c0f0a608252d521b89911308b45584c4456040579d844cc7cf09fc839f12f8a908cd20c9f6fd421123f17ca6248948d80e7d36e82adb5a6a42e82b460
-  data.tar.gz: d5ec4be5ede9d7cd359ed5f50af51d37c6926b99d5130f679655fec3949962c57d4c215dc212413e76f85ef20b74aa036e2b1955837ff113bcf41d3dc6f180bc
+  metadata.gz: 9f2bc512373e64a1ecda15c5797a5e9a1944f9fdc2a81f34f4af063d54c288fa53710bba9645fdbdec922b2642491bf0983830b7b806c3e6706099d48ed31c29
+  data.tar.gz: 99c355f1ad8d2c26786b79d3f7889ac00b08444f72352a14f300eb25049efbe81792242d48c0c9bf760e5bce3e93d61f408a99ac38a93a252ca55954c0880162

data/.rubocop.yml

@@ -10,6 +10,7 @@ AllCops:
   Exclude:
     - 'Rakefile'
     - 'alba.gemspec'
+  NewCops: enable
 
 Layout/SpaceInsideHashLiteralBraces:
   EnforcedStyle: no_space
@@ -17,5 +18,10 @@ Layout/SpaceInsideHashLiteralBraces:
 Metrics/MethodLength:
   Max: 20
 
+Naming/PredicateName:
+  AllowedMethods:
+    - 'has_one'
+    - 'has_many'
+
 Style/FrozenStringLiteralComment:
   Enabled: false

data/Gemfile

@@ -3,8 +3,10 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in alba.gemspec
 gemspec
 
+gem 'coveralls', require: false
 gem 'minitest', '~> 5.0'
+gem 'oj', '~> 3.10'
 gem 'rake', '~> 13.0'
 gem 'rubocop', '>= 0.79.0', require: false
-gem 'rubocop-performance', '~> 1.5.0', require: false
+gem 'rubocop-performance', '~> 1.7.1', require: false
 gem 'rubocop-sensible', '~> 0.3.0', require: false

data/Gemfile.lock

@@ -1,42 +1,69 @@
 PATH
   remote: .
   specs:
-    alba (0.1.0)
+    alba (0.6.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.0)
-    jaro_winkler (1.5.4)
-    minitest (5.14.0)
-    parallel (1.19.1)
-    parser (2.7.0.2)
-      ast (~> 2.4.0)
+    ast (2.4.1)
+    coveralls (0.8.23)
+      json (>= 1.8, < 3)
+      simplecov (~> 0.16.1)
+      term-ansicolor (~> 1.3)
+      thor (>= 0.19.4, < 2.0)
+      tins (~> 1.6)
+    docile (1.3.2)
+    json (2.3.1)
+    minitest (5.14.1)
+    oj (3.10.8)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
     rainbow (3.0.0)
     rake (13.0.1)
-    rubocop (0.79.0)
-      jaro_winkler (~> 1.5.1)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rubocop (0.88.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 2.7.1.1)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.1.0, < 1.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    rubocop-performance (1.5.2)
-      rubocop (>= 0.71.0)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.2.0)
+      parser (>= 2.7.0.1)
+    rubocop-performance (1.7.1)
+      rubocop (>= 0.82.0)
     rubocop-sensible (0.3.0)
       rubocop (>= 0.60.0)
     ruby-progressbar (1.10.1)
-    unicode-display_width (1.6.1)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    sync (0.5.0)
+    term-ansicolor (1.7.1)
+      tins (~> 1.0)
+    thor (1.0.1)
+    tins (1.25.0)
+      sync
+    unicode-display_width (1.7.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   alba!
+  coveralls
   minitest (~> 5.0)
+  oj (~> 3.10)
   rake (~> 13.0)
   rubocop (>= 0.79.0)
-  rubocop-performance (~> 1.5.0)
+  rubocop-performance (~> 1.7.1)
   rubocop-sensible (~> 0.3.0)
 
 BUNDLED WITH

data/README.md

@@ -1,6 +1,10 @@
+[![Build Status](https://travis-ci.com/okuramasafumi/alba.svg?branch=master)](https://travis-ci.com/okuramasafumi/alba)
+[![Coverage Status](https://coveralls.io/repos/github/okuramasafumi/alba/badge.svg?branch=master)](https://coveralls.io/github/okuramasafumi/alba?branch=master)
+[![Maintainability](https://api.codeclimate.com/v1/badges/fdab4cc0de0b9addcfe8/maintainability)](https://codeclimate.com/github/okuramasafumi/alba/maintainability)
+
 # Alba
 
-`Alba` is a fast and flexible JSON serializer.
+`Alba` is a stupid, fast and easy to use JSON serializer.
 
 ## Installation
 
@@ -20,6 +24,8 @@ Or install it yourself as:
 
 ## Usage
 
+### Simple serialization with key
+
 ```ruby
 class User
   attr_accessor :id, :name, :email, :created_at, :updated_at
@@ -53,6 +59,80 @@ UserResource.new(user).serialize
 # => "{\"id\":1,\"name\":\"Masafumi OKURA\",\"name_with_email\":\"Masafumi OKURA: masafumi@example.com\"}"
 ```
 
+### Serialization with associations
+
+```ruby
+class User
+  attr_reader :id, :created_at, :updated_at
+  attr_accessor :articles
+
+  def initialize(id)
+    @id = id
+    @created_at = Time.now
+    @updated_at = Time.now
+    @articles = []
+  end
+end
+
+class Article
+  attr_accessor :user_id, :title, :body
+
+  def initialize(user_id, title, body)
+    @user_id = user_id
+    @title = title
+    @body = body
+  end
+end
+
+class ArticleResource
+  include Alba::Resource
+
+  attributes :title
+end
+
+class UserResource1
+  include Alba::Resource
+
+  attributes :id
+
+  many :articles, resource: ArticleResource
+end
+
+user = User.new(1)
+article1 = Article.new(1, 'Hello World!', 'Hello World!!!')
+user.articles << article1
+article2 = Article.new(2, 'Super nice', 'Really nice!')
+user.articles << article2
+
+UserResource1.new(user).serialize
+# => '{"id":1,"articles":[{"title":"Hello World!"},{"title":"Super nice"}]}'
+```
+
+### Inline definition with `Alba.serialize`
+
+`Alba.serialize` method is a shortcut to define everything inline.
+
+```ruby
+Alba.serialize(user, with: proc { set key: :foo }) do
+  attributes :id
+  many :articles do
+    attributes :title, :body
+  end
+end
+# => '{"foo":{"id":1,"articles":[{"title":"Hello World!","body":"Hello World!!!"},{"title":"Super nice","body":"Really nice!"}]}}'
+```
+
+Although this might be useful sometimes, it's generally recommended to define a class for both Resource and Serializer.
+
+## Comparison
+
+Since Alba is intended to be stupid, there are many things Alba can't do while other gems can. However, from the same reason, it's extremely faster than alternatives.
+For a performance benchmark, see https://gist.github.com/okuramasafumi/4e375525bd3a28e4ca812d2a3b3e5829.
+
+## Why named "Alba"?
+
+The name "Alba" comes from "albatross", a kind of birds. In Japanese, this bird is called "Aho-dori", which means "stupid bird". I find it funny because in fact albatrosses fly really fast. I hope Alba looks stupid but in fact it does its job quick.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/alba.rb

@@ -1,6 +1,8 @@
 require 'alba/version'
+require 'alba/serializers/default_serializer'
+require 'alba/serializer'
 require 'alba/resource'
-require 'json'
+require 'alba/resources/default_resource'
 
 # Core module
 module Alba
@@ -8,24 +10,25 @@ module Alba
 
   class << self
     attr_reader :backend
-  end
+    attr_accessor :default_serializer
 
-  def self.backend=(backend)
-    @backend = backend&.to_sym
-  end
+    def backend=(backend)
+      @backend = backend&.to_sym
+    end
+
+    def serialize(object, with: nil, &block)
+      raise ArgumentError, 'Block required' unless block
+
+      resource_class.class_eval(&block)
+      resource = resource_class.new(object)
+      with ||= @default_serializer
+      resource.serialize(with: with)
+    end
+
+    private
 
-  def self.serialize(object)
-    fallback = ->(resource) { resource.to_json }
-    case backend
-    when :oj
-      begin
-        require 'oj'
-        ->(resource) { Oj.dump(resource) }
-      rescue LoadError
-        fallback
-      end
-    else
-      fallback
-    end.call(object)
+    def resource_class
+      ::Alba::Resources::DefaultResource.clone
+    end
   end
 end

data/lib/alba/attribute.rb

@@ -7,12 +7,12 @@ module Alba
       @method = method
     end
 
-    def serialize(target)
+    def to_hash(target)
       case @method
       when Symbol, String
         target.public_send(@method)
       when Proc
-        @method.call(target)
+        @method.arity.zero? ? target.instance_exec(&@method) : @method.call(target)
       end
     end
   end

data/lib/alba/many.rb

@@ -0,0 +1,26 @@
+module Alba
+  # Representing many association
+  class Many
+    def initialize(name:, resource: nil, &block)
+      @name = name
+      @resource = resource
+      @block = block
+      raise ArgumentError, 'resource or block is required' if @resource.nil? && @block.nil?
+    end
+
+    def to_hash(target)
+      objects = target.public_send(@name)
+      @resource ||= resource_class
+      objects.map { |o| @resource.new(o).to_hash }
+    end
+
+    private
+
+    def resource_class
+      klass = Class.new
+      klass.include(::Alba::Resource)
+      klass.class_exec(&@block)
+      klass
+    end
+  end
+end

data/lib/alba/one.rb

@@ -0,0 +1,26 @@
+module Alba
+  # Representing one association
+  class One
+    def initialize(name:, resource: nil, &block)
+      @name = name
+      @resource = resource
+      @block = block
+      raise ArgumentError, 'resource or block is required' if @resource.nil? && @block.nil?
+    end
+
+    def to_hash(target)
+      object = target.public_send(@name)
+      @resource ||= resource_class
+      @resource.new(object).to_hash
+    end
+
+    private
+
+    def resource_class
+      klass = Class.new
+      klass.include(::Alba::Resource)
+      klass.class_exec(&@block)
+      klass
+    end
+  end
+end

data/lib/alba/resource.rb

@@ -1,11 +1,26 @@
 require 'alba/serializer'
 require 'alba/attribute'
+require 'alba/one'
+require 'alba/many'
 require 'alba/serializers/default_serializer'
 
 module Alba
   # This module represents what should be serialized
   module Resource
+    DSLS = [:_attributes, :_serializer, :_key].freeze
     def self.included(base)
+      base.class_eval do
+        # Initialize
+        DSLS.each do |name|
+          initial = case name
+                    when :_attributes
+                      {}
+                    when :_serializer, :_name
+                      nil
+                    end
+          instance_variable_set("@#{name}", initial) unless instance_variable_defined?("@#{name}")
+        end
+      end
       base.include InstanceMethods
       base.extend ClassMethods
     end
@@ -14,42 +29,53 @@ module Alba
     module InstanceMethods
       def initialize(resource)
         @_resource = resource
-        @_attributes = self.class._attributes
-        @_serializer_class = self.class._serializer_class
+        DSLS.each { |name| instance_variable_set("@#{name}", self.class.public_send(name)) }
       end
 
       def serialize(with: nil)
-        serializer_class = case with
-                           when ->(obj) { obj.is_a?(Class) && obj.ancestors.include?(Alba::Serializer) }
-                             with
-                           when Symbol
-                             const_get(with.to_s.capitalize)
-                           when String
-                             const_get(with)
-                           when nil
-                             @_serializer_class || Alba::Serializers::DefaultSerializer
-                           end
-        # opts = serializer.opts
-        serialiable_hash = @_attributes.map do |name, attribute|
-          [name, attribute.serialize(@_resource)]
-        end.to_h
-        serializer_class.new(serialiable_hash).serialize
+        serializer = case with
+                     when nil
+                       @_serializer || Alba::Serializers::DefaultSerializer
+                     when ->(obj) { obj.is_a?(Class) && obj <= Alba::Serializer }
+                       with
+                     when Proc
+                       inline_extended_serializer(with)
+                     else
+                       raise ArgumentError, 'Unexpected type for with, possible types are Class or Proc'
+                     end
+        serializer.new(self).serialize
+      end
+
+      def serializable_hash(with_key: true)
+        serializable_hash = @_attributes.transform_values do |attribute|
+          attribute.to_hash(@_resource)
+        end
+        with_key && @_key ? {@_key => serializable_hash} : serializable_hash
+      end
+      alias to_hash serializable_hash
+
+      def key
+        @_key || self.class.name.delete_suffix('Resource').downcase.gsub(/:{2}/, '_').to_sym
+      end
+
+      private
+
+      def inline_extended_serializer(with)
+        klass = ::Alba::Serializers::DefaultSerializer.clone
+        klass.class_eval(&with)
+        klass
       end
     end
 
     # Class methods
     module ClassMethods
-      attr_accessor :_attributes, :_serializer_class
+      attr_accessor(*DSLS)
 
       def inherited(subclass)
-        @_attributes = {} unless defined?(@_attributes)
-        @_serializer_class = nil unless defined?(@_serializer_class)
-        subclass._attributes = @_attributes
-        subclass._serializer_class = @_serializer_class
+        DSLS.each { |name| subclass.public_send("#{name}=", instance_variable_get("@#{name}")) }
       end
 
       def attributes(*attrs)
-        @_attributes = {} unless defined? @_attributes
         attrs.each { |attr_name| @_attributes[attr_name] = Attribute.new(name: attr_name, method: attr_name) }
       end
 
@@ -59,8 +85,20 @@ module Alba
         @_attributes[name] = Attribute.new(name: name, method: block)
       end
 
+      def one(name, resource: nil, &block)
+        @_attributes[name.to_sym] = One.new(name: name, resource: resource, &block)
+      end
+
+      def many(name, resource: nil, &block)
+        @_attributes[name.to_sym] = Many.new(name: name, resource: resource, &block)
+      end
+
       def serializer(name)
-        @_serializer_class = name.ancestors.include?(Alba::Serializer) ? name : nil
+        @_serializer = name <= Alba::Serializer ? name : nil
+      end
+
+      def key(key)
+        @_key = key.to_sym
       end
     end
   end

data/lib/alba/resources/default_resource.rb

@@ -0,0 +1,9 @@
+module Alba
+  module Resources
+    # Empty resource class, use this with `class_eval` for
+    # inline associations and serializations.
+    class DefaultResource
+      include ::Alba::Resource
+    end
+  end
+end

data/lib/alba/serializer.rb

@@ -1,6 +1,5 @@
 module Alba
   # This module represents how a resource should be serialized.
-  #
   module Serializer
     def self.included(base)
       base.include InstanceMethods
@@ -10,19 +9,27 @@ module Alba
     # Instance methods
     module InstanceMethods
       def initialize(resource)
-        @_resource = resource
         @_opts = self.class._opts || {}
-        key = @_opts[:key]
-        @_resource = {key.to_sym => @_resource} if key
+        key = case @_opts[:key]
+              when true
+                resource.key
+              else
+                @_opts[:key]
+              end
+        @hash = resource.serializable_hash(with_key: false)
+        @hash = {key.to_sym => @hash} if key
       end
 
       def serialize
-        fallback = -> { @_resource.to_json }
+        fallback = lambda do
+          require 'json'
+          JSON.dump(@hash)
+        end
         case Alba.backend
         when :oj
           begin
             require 'oj'
-            -> { Oj.dump(@_resource) }
+            -> { Oj.dump(@hash, mode: :strict) }
           rescue LoadError
             fallback
           end

data/lib/alba/serializers/default_serializer.rb

@@ -1,3 +1,5 @@
+require 'alba/serializer'
+
 module Alba
   module Serializers
     # DefaultSerializer class is used when a user doesn't specify serializer opt.

data/lib/alba/version.rb

@@ -1,3 +1,3 @@
 module Alba
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.6.0'.freeze
 end

data/sider.yml

@@ -0,0 +1,60 @@
+linter:
+# # https://help.sider.review/getting-started/custom-configuration
+
+#   # https://help.sider.review/tools/ruby/rubocop
+  rubocop:
+    gems:
+      - "rubocop-performance"
+      - "rubocop-sensible"
+    safe: false
+
+#   # https://help.sider.review/tools/ruby/reek
+#   reek:
+#     gems:
+#       - name: "reek"
+#         version: "5.2.0"
+#     target:
+#       - lib/
+#       - test/
+#     config: config/.reek.yml
+
+#   # https://help.sider.review/tools/ruby/querly
+#   querly:
+#     gems:
+#       - "slim"
+
+#   # https://help.sider.review/tools/others/misspell
+#   misspell:
+#     exclude:
+#       - vendor
+#       - "**/*.min.js"
+#       - exclude_file.rb
+#     targets:
+#       - target_directory
+#       - another_target_directory/foo.rb
+#       - bar.rb
+#     locale: UK
+#     ignore: center,behavior
+
+#   # https://help.sider.review/tools/shellscript/shellcheck
+#   shellcheck:
+#     target: "src/**/*.{sh,bash}"
+#     include: "SC2104,SC2105"
+#     exclude: "SC1000,SC1118"
+#     enable: "all"
+#     shell: "bash"
+#     severity: "error"
+#     norc: true
+
+# # https://help.sider.review/getting-started/custom-configuration#ignore
+# ignore:
+#   - "*.pdf"
+#   - "*.mp4"
+#   - "images/**"
+
+# # https://help.sider.review/getting-started/custom-configuration#branchesexclude
+# branches:
+#   exclude:
+#     - master
+#     - development
+#     - /^release-.*$/

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: alba
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.6.0
 platform: ruby
 authors:
 - OKURA Masafumi
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-02-11 00:00:00.000000000 Z
+date: 2020-07-31 00:00:00.000000000 Z
 dependencies: []
 description: Fast and flexible JSON serializer
 email:
@@ -31,10 +31,14 @@ files:
 - bin/setup
 - lib/alba.rb
 - lib/alba/attribute.rb
+- lib/alba/many.rb
+- lib/alba/one.rb
 - lib/alba/resource.rb
+- lib/alba/resources/default_resource.rb
 - lib/alba/serializer.rb
 - lib/alba/serializers/default_serializer.rb
 - lib/alba/version.rb
+- sider.yml
 homepage: https://github.com/okuramasafumi/alba
 licenses:
 - MIT
@@ -42,7 +46,7 @@ metadata:
   homepage_uri: https://github.com/okuramasafumi/alba
   source_code_uri: https://github.com/okuramasafumi/alba
   changelog_uri: https://github.com/okuramasafumi/alba/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -57,8 +61,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Fast and flexible JSON serializer
 test_files: []