alba 3.5.0 → 3.6.0

data/docs/migrate_from_jbuilder.md

@@ -1,237 +0,0 @@
----
-title: Upgrading from Jbuilder
----
-
-<!-- @format -->
-
-This guide is aimed at helping Jbuilder users transition to Alba, and it consists of four parts:
-
-1. Basic serialization
-2. Complex serialization
-3. Key transformation
-4. Unsupported features
-
-## Example class
-
-This example will also be replaced by ActiveRecord.
-
-```rb
-class User
-  attr_reader :id, :created_at, :updated_at
-  attr_accessor :profile, :articles
-
-  def initialize(id)
-    @id = id
-    @created_at = Time.now
-    @updated_at = Time.now
-    @articles = []
-  end
-end
-
-class Profile
-  attr_reader :email
-
-  def initialize(email)
-    @email = email
-  end
-end
-
-class Article
-  attr_accessor :title, :body
-
-  def initialize(title, body)
-    @title = title
-    @body = body
-  end
-end
-```
-
-## 1. Basic serialization
-
-#### Jbuilder
-
-```rb
-# show.json.jbuilder
-# With block
-@user = User.new(id)
-json.user do |user|
-  user.id @user.id
-  user.created_at @user.created_at
-  user.updated_at @user.updated_at
-end
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at}'
-# or #extract!
-json.extract! @user, :id, :created_at, :updated_at
-# => '{"id":id, "created_at": created_at, "updated_at": updated_at}'
-```
-
-#### Alba
-
-```rb
-# With block
-user = User.new(id)
-Alba.serialize(user, root_key: :user) do
-  attributes :id, :created_at, :updated_at
-end
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at}'
-# or with resourceClass.
-# Infer and use by "#{MODEL_NAME}Resource"
-class UserResource
-  include Alba::Resource
-  root_key :user
-  attributes :id, :created_at, :updated_at
-end
-UserResource.new(user).serialize
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at}'
-```
-
-## 2. Complex serialization
-
-### Serialize collections
-
-#### Jbuilder
-
-```rb
-@users = ids.map { |id| User.new(id) }
-# index.json.jbuilder
-json.array! @users, :id, :created_at, :updated_at
-# => '[{"id":id, "created_at": created_at, "updated_at": updated_at}, {"id":id, "created_at": created_at, "updated_at": updated_at}, {"id":id, "created_at": created_at, "updated_at": updated_at}]'
-```
-
-#### Alba
-
-```rb
-class UserResource
-  include Alba::Resource
-  root_key :user
-  attributes :id, :created_at, :updated_at
-end
-users = ids.map { |id| User.new(id) }
-UserResource.new(users).serialize
-# => '[{"id":id, "created_at": created_at, "updated_at": updated_at}, {"id":id, "created_at": created_at, "updated_at": updated_at}, {"id":id, "created_at": created_at, "updated_at": updated_at}]'
-
-```
-
-### Nested serialization
-
-#### Jbuilder
-
-```rb
-# show.json.jbuilder
-@user = User.new(id)
-@user.profile = Profile.new(email)
-@user.articles = [Article.new(title, body)]
-json.user do |user|
-  user.id @user.id
-  user.created_at @user.created_at
-  user.updated_at @user.updated_at
-  json.profile do
-    json.email @user.profile.email
-  end
-  json.articles do
-    json.array! @user.articles, :title, :body
-  end
-end
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at, "profile": {"email": email}, articles: [{"title": title, "body": body}]}'
-# or #merge!
-profile_hash = { profile: { email: @user.profile.email } }
-articles_hash = { articles: @user.articles.map { |article| { title: article.title, body: article.body } } }
-json.user do |user|
-  user.id @user.id
-  user.created_at @user.created_at
-  user.updated_at @user.updated_at
-  json.merge! profile_hash
-  json.merge! articles_hash
-end
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at, "profile": {"email": email}, articles: [{"title": title, "body": body}]}'
-# or #partial!
-# profiles/_profile.json.jbuilder
-json.profile do
-  json.email @profile.email
-end
-# articles/_article.json.jbuilder
-json.extract! article, :title, :body
-# user/show.json.jbuilder
-json.user do |user|
-  user.id @user.id
-  user.created_at @user.created_at
-  user.updated_at @user.updated_at
-  json.partial! @user.profile, as: :profile
-  json.articles @user.articles do |article|
-    json.partial! article, partial: 'articles/article'
-  end
-end
-```
-
-#### Alba
-
-```rb
-# With ResourceClass by each resources
-class ProfileResource
-  include Alba::Resource
-  root_key :profile
-  attributes :email
-end
-class ArticleResource
-  include Alba::Resource
-  root_key :article
-  attributes :title, :body
-end
-class UserResource
-  include Alba::Resource
-  root_key :user
-  attributes :id, :created_at, :updated_at
-  one :profile, resource: ProfileResource
-  many :articles, resource: ArticleResource
-end
-user = User.new(id)
-user.profile = Profile.new(email)
-user.articles = [Article.new(title, body)]
-UserResource.new(user).serialize
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at, "profile": {"email": email}, articles: [{"title": title, "body": body}]}'
-
-# or #attribute
-class UserResource
-  include Alba::Resource
-  root_key :user
-  attributes :id, :created_at, :updated_at
-
-  attribute :profile do
-    {
-      email: object.profile.email # Can access to received resource by #object method
-    }
-  end
-
-  attribute :articles do
-    object.articles.map do |article|
-      {
-        title: article.title,
-        body: article.body,
-      }
-    end
-  end
-end
-user = User.new(id)
-user.profile = Profile.new(email)
-UserResource.new(user).serialize
-# => '{"user":{"id":id, "created_at": created_at, "updated_at": updated_at, "profile": {"email": email}, articles: [{"title": title, "body": body}]}'
-```
-
-## 3. Key transformation
-
-See the README for more information, but it's possible to migrate the `Jbuilder.key_format!` behavior with the `transform_keys` macro.
-
-```rb
-class UserResource
-  include Alba::Resource
-  root_key :user
-  attributes :id, :created_at, :updated_at
-
-  transform_keys :lower_camel
-end
-```
-
-## 4. Unsupported features
-
-- Jbuilder#ignore_nil!
-- Jbuilder#cache!

data/docs/rails.md

@@ -1,56 +0,0 @@
----
-title: Alba for Rails
-author: OKURA Masafumi
----
-
-# Alba for Rails
-
-While Alba is NOT designed for Rails specifically, you can definitely use Alba with Rails. This document describes in detail how to use Alba with Rails to be more productive.
-
-## Initializer
-
-You might want to add some configurations to initializer file such as `alba.rb` with something like below:
-
-```ruby
-# alba.rb
-Alba.backend = :active_support
-Alba.inflector = :active_support
-```
-
-You can also use `:oj_rails` for backend if you prefer using Oj.
-
-Alba 2.2 introduced new Rails integration so that you don't have to add initializer file for setting inflector. You still need to add initializer file if you want to set backend or configure inflector with something different from `active_support`.
-
-## Rendering JSON
-
-You can render JSON with Rails in two ways. One way is to pass JSON String.
-
-```ruby
-render json: FooResource.new(foo).serialize
-```
-
-But you can also render JSON passing `Alba::Resource` object. Rails automatically calls `to_json` on a resource.
-
-```ruby
-render json: FooResource.new(foo)
-```
-
-Note that almost all options given to this `render` are ignored. The only exceptions are `layout`, `prefixes`, `template` and `status`.
-
-```ruby
-# This `only` option is ignored
-render json: FooResource.new(foo), only: [:id]
-
-# This is OK
-render json: FooResource.new(foo), status: 200
-```
-
-### Shorthand for rendering JSON with Alba
-
-Now you can render JSON with shorthand.
-
-First, using `render json: serialize(target)` renders JSON for given target object. You can pass `with: SomeSerializer` option to render with `SomeSerializer` in this case. If you skip `with` option Alba tries to find the correct serialize automatically.
-
-There is a shorter version: `render_serialized_json(target)`. It also accepts `with` option.
-
-It's recommended to use `with` option now since it cannot automatically find correct serializers sometimes.

data/gemfiles/without_active_support.gemfile

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gem 'minitest', '~> 5.14' # For test
-gem 'rake', '~> 13.0' # For test and automation
-gem 'rubocop', '>= 0.79.0', require: false # For lint
-gem 'rubocop-minitest', '~> 0.11.0', require: false # For lint
-gem 'rubocop-performance', '~> 1.10.1', require: false # For lint
-gem 'rubocop-rake', '>= 0.5.1', require: false # For lint
-gem 'rubocop-sensible', '~> 0.3.0', require: false # For lint
-gem 'simplecov', '~> 0.21.0', require: false # For test coverage
-gem 'simplecov-cobertura', require: false # For test coverage
-gem 'yard', require: false # For documentation
-
-platforms :ruby do
-  gem 'oj', '~> 3.11', require: false # For backend
-  gem 'ruby-prof', require: false # For performance profiling
-end

data/gemfiles/without_oj.gemfile

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gem 'activesupport', require: false # For backend
-gem 'minitest', '~> 5.14' # For test
-gem 'rake', '~> 13.0' # For test and automation
-gem 'rubocop', '>= 0.79.0', require: false # For lint
-gem 'rubocop-minitest', '~> 0.11.0', require: false # For lint
-gem 'rubocop-performance', '~> 1.10.1', require: false # For lint
-gem 'rubocop-rake', '>= 0.5.1', require: false # For lint
-gem 'rubocop-sensible', '~> 0.3.0', require: false # For lint
-gem 'simplecov', '~> 0.21.0', require: false # For test coverage
-gem 'simplecov-cobertura', require: false # For test coverage
-gem 'yard', require: false # For documentation
-
-platforms :ruby do
-  gem 'ruby-prof', require: false # For performance profiling
-end