alba 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 405e177e9e1fcadf7dbb164d3ac6924e1b3563547f715fedb698211b527a9604
-  data.tar.gz: 2c534708583345ac9090c83b3ddc939b0c8bd335ed77017f554edb28578d0396
+  metadata.gz: 592412974accb17b359ab871e293e2c839519f7cfffb31a04485bfe261b88202
+  data.tar.gz: d8fbb2ec751eac8e7dbe278e8993da6641eaa88f302b3438055b2062c08bd229
 SHA512:
-  metadata.gz: 71f4712ac28d457fe9bf997fb127288ed66d7d2231ffd6dd438b2eb5c1dd82ff9e3e5c4000415c513012a582cda3d3c3e73fdf0beb4cc96b8583ff9a658dfa75
-  data.tar.gz: '07439ccffc5b48a0d5d4286236acadf4cc3e89ff1afa0a882a87c1fe5640015096a4cd85839cebdc4d6ef350a77043a494bfe4d7b6cff99f8e7db2ab9f8b3db0'
+  metadata.gz: 97c3fc639d1d6b7fa588c78fa84f4be7318982ebf3154b9037e1b9c6ac38d1d9a0528bcf45618a5d1b1dc009df30441589eb27d1bdfbd8afaca1e61a0708e31e
+  data.tar.gz: 7abd201ba80bdfff652840e948e8aede24e90d0cfc26722f08044916f239387fd0bada0a1e9a0d71cf252ced9400d1549124349a1070ea7bd8c8e5a7be0ebc38

data/.rubocop.yml

@@ -4,6 +4,7 @@ inherit_gem:
   rubocop-sensible: 'config/rubocop.yml'
 
 require:
+  - rubocop-minitest
   - rubocop-performance
 
 AllCops:
@@ -18,10 +19,5 @@ Layout/SpaceInsideHashLiteralBraces:
 Metrics/MethodLength:
   Max: 20
 
-Naming/PredicateName:
-  AllowedMethods:
-    - 'has_one'
-    - 'has_many'
-
 Style/FrozenStringLiteralComment:
   Enabled: false

data/.travis.yml

@@ -2,5 +2,7 @@
 language: ruby
 cache: bundler
 rvm:
-  - 2.6.5
+  - 2.5.8
+  - 2.6.6
+  - 2.7.1
 before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -8,5 +8,6 @@ gem 'minitest', '~> 5.0'
 gem 'oj', '~> 3.10'
 gem 'rake', '~> 13.0'
 gem 'rubocop', '>= 0.79.0', require: false
+gem 'rubocop-minitest', '~> 0.10.1', require: false
 gem 'rubocop-performance', '~> 1.7.1', require: false
 gem 'rubocop-sensible', '~> 0.3.0', require: false

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    alba (0.7.0)
+    alba (0.8.0)
 
 GEM
   remote: https://rubygems.org/
@@ -35,6 +35,8 @@ GEM
       unicode-display_width (>= 1.4.0, < 2.0)
     rubocop-ast (0.2.0)
       parser (>= 2.7.0.1)
+    rubocop-minitest (0.10.1)
+      rubocop (>= 0.87)
     rubocop-performance (1.7.1)
       rubocop (>= 0.82.0)
     rubocop-sensible (0.3.0)
@@ -63,6 +65,7 @@ DEPENDENCIES
   oj (~> 3.10)
   rake (~> 13.0)
   rubocop (>= 0.79.0)
+  rubocop-minitest (~> 0.10.1)
   rubocop-performance (~> 1.7.1)
   rubocop-sensible (~> 0.3.0)
 

data/README.md

@@ -1,10 +1,11 @@
+[![Gem Version](https://badge.fury.io/rb/alba.svg)](https://badge.fury.io/rb/alba)
 [![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 stupid, fast and easy to use JSON serializer.
+`Alba` is the fastest JSON serializer for Ruby.
 
 ## Installation
 
@@ -126,13 +127,25 @@ Although this might be useful sometimes, it's generally recommended to define a
 
 ## 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.
+Alba is 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.
 
+## Alba internals
+
+Alba has three component, `Serializer`, `Resource` and `Value` (`Value` is conceptual and not implemented directly).
+
+`Serializer` is a component responsible for rendering JSON output with `Resource`. `Serializer` can add more data to `Resource` such as `metadata`. Users can define one single `Serializer` and reuse it for all `Resource`s. The main interface is `#serialize`.
+
+`Resource` is a component responsible for defining how an object (or a collection of objects) is converted into JSON. The difference between `Serializer` and `Resource` is that while `Serializer` can add arbitrary data into JSON, `Resource` can get data only from the object under it. The main interface is `#serializable_hash`.
+
+`Value` is either `Attribute`, `One` or `Many`. They are responsible for fetching data from the object for `Resource`. The main interface is `#to_hash`.
+
+The main `Alba` module holds config values and one convenience method, `.serialize`.
+
 ## 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/alba.gemspec

@@ -1,27 +1,27 @@
 require_relative 'lib/alba/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "alba"
+  spec.name          = 'alba'
   spec.version       = Alba::VERSION
-  spec.authors       = ["OKURA Masafumi"]
-  spec.email         = ["masafumi.o1988@gmail.com"]
+  spec.authors       = ['OKURA Masafumi']
+  spec.email         = ['masafumi.o1988@gmail.com']
 
-  spec.summary       = "Fast and flexible JSON serializer"
-  spec.description   = "Fast and flexible JSON serializer"
-  spec.homepage      = "https://github.com/okuramasafumi/alba"
-  spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.summary       = 'Alba is the fastest JSON serializer for Ruby.'
+  spec.description   = "Alba is designed to be a simple, easy to use and fast alternative to existing JSON serializers. Its performance is better than almost all gems which do similar things. The internal is so simple that it's easy to hack and maintain."
+  spec.homepage      = 'https://github.com/okuramasafumi/alba'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.8')
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/okuramasafumi/alba"
-  spec.metadata["changelog_uri"] = "https://github.com/okuramasafumi/alba/CHANGELOG.md"
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/okuramasafumi/alba'
+  spec.metadata['changelog_uri'] = 'https://github.com/okuramasafumi/alba/CHANGELOG.md'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 end

data/lib/alba/resource.rb

@@ -27,8 +27,10 @@ module Alba
 
     # Instance methods
     module InstanceMethods
-      def initialize(resource)
-        @_resource = resource
+      attr_reader :_object
+
+      def initialize(object)
+        @_object = object
         DSLS.each { |name| instance_variable_set("@#{name}", self.class.public_send(name)) }
       end
 
@@ -53,9 +55,9 @@ module Alba
           end
         end
         serializable_hash = if collection?
-                              @_resource.map(&get_attribute)
+                              @_object.map(&get_attribute)
                             else
-                              get_attribute.call(@_resource)
+                              get_attribute.call(@_object)
                             end
         with_key && @_key ? {@_key => serializable_hash} : serializable_hash
       end
@@ -74,16 +76,16 @@ module Alba
       end
 
       def collection?
-        @_resource.is_a?(Enumerable)
+        @_object.is_a?(Enumerable)
       end
     end
 
     # Class methods
     module ClassMethods
-      attr_accessor(*DSLS)
+      attr_reader(*DSLS)
 
       def inherited(subclass)
-        DSLS.each { |name| subclass.public_send("#{name}=", instance_variable_get("@#{name}")) }
+        DSLS.each { |name| subclass.instance_variable_set("@#{name}", instance_variable_get("@#{name}")) }
       end
 
       def attributes(*attrs)

data/lib/alba/serializer.rb

@@ -10,6 +10,8 @@ module Alba
     module InstanceMethods
       def initialize(resource)
         @_opts = self.class._opts || {}
+        @_metadata = self.class._metadata || {}
+        @_metadata = @_metadata.transform_values { |block| block.call(resource._object) }
         key = case @_opts[:key]
               when true
                 resource.key
@@ -18,6 +20,8 @@ module Alba
               end
         @hash = resource.serializable_hash(with_key: false)
         @hash = {key.to_sym => @hash} if key
+        # @hash is either Hash or Array
+        @hash.is_a?(Hash) ? @hash.merge!(@_metadata.to_h) : @hash << @_metadata
       end
 
       def serialize
@@ -41,12 +45,21 @@ module Alba
 
     # Class methods
     module ClassMethods
-      attr_reader :_opts
+      attr_reader :_opts, :_metadata
+
+      def inherited(subclass)
+        %w[_opts _metadata].each { |name| subclass.instance_variable_set("@#{name}", instance_variable_get("@#{name}")) }
+      end
 
       def set(key: false)
         @_opts ||= {}
         @_opts[:key] = key
       end
+
+      def metadata(name, &block)
+        @_metadata ||= {}
+        @_metadata[name] = block
+      end
     end
   end
 end

data/lib/alba/version.rb

@@ -1,3 +1,3 @@
 module Alba
-  VERSION = '0.7.0'.freeze
+  VERSION = '0.8.0'.freeze
 end

metadata

@@ -1,16 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: alba
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - OKURA Masafumi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-07-31 00:00:00.000000000 Z
+date: 2020-08-06 00:00:00.000000000 Z
 dependencies: []
-description: Fast and flexible JSON serializer
+description: Alba is designed to be a simple, easy to use and fast alternative to
+  existing JSON serializers. Its performance is better than almost all gems which
+  do similar things. The internal is so simple that it's easy to hack and maintain.
 email:
 - masafumi.o1988@gmail.com
 executables: []
@@ -54,7 +56,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.5.8
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -64,5 +66,5 @@ requirements: []
 rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
-summary: Fast and flexible JSON serializer
+summary: Alba is the fastest JSON serializer for Ruby.
 test_files: []