Add preview examples.

Author: beauby

peeks/deserializable.rb

@@ -0,0 +1,16 @@
+class DeserializablePost < JSONAPI::Deserializable::Resource
+  attribute :title
+
+  attriute :date do |attr|
+    field created_at: attr
+  end
+
+  relationship :author do |id, type|
+    field author_id: id
+    field author_type: type
+  end
+
+  relationship :comments do |ids, _types|
+    field comment_ids: ids
+  end
+end

peeks/hanami.rb

@@ -0,0 +1,18 @@
+module API::Controllers::Posts
+  class Create
+    include API::Action
+    include JSONAPI::Hanami::Action
+
+    deserializable_resource :post, DeserializablePost
+
+    def call(params)
+      repo = PostRepository.new
+      post = repo.create(params[:post])
+
+      self.data = post
+      self.include = [:author, comments: [:author]]
+      self.fields = { users: [:name, :email] }
+      self.status = 201
+    end
+  end
+end

peeks/rails.rb

@@ -0,0 +1,15 @@
+class PostsController < ApplicationController
+  deserializable_resource :post, DeserializablePost, only: [:create, :update]
+
+  def create_params
+    params.require(:post).permit!
+  end
+
+  def create
+    post = Post.create(create_params)
+    render jsonapi: post,
+           include: [:author, comments: [:author]],
+           fields: { users: [:name, :email] },
+           status: :created
+  end
+end

peeks/ruby.rb

@@ -0,0 +1,17 @@
+# Serialization
+JSONAPI::Serializable::Renderer.render(posts,
+                                       namespace: 'API',
+                                       expose: { url_helpers: MyUrlHelper.new },
+                                       include: [:author, comments: [:author]],
+                                       fields: { users: [:name, :email] })
+# => { data: [...], included: [...] }
+
+# Deserialization
+DeserializablePost.call(json_hash)
+# => {
+#      title: 'Welcome',
+#      created_at: '2016-11-17',
+#      author_id: '5',
+#      author_type: 'users',
+#      comment_ids: ['13', '29', '31']
+#    }

peeks/serializable.rb

@@ -0,0 +1,33 @@
+class SerializablePost < JSONAPI::Serializable::Model
+  type 'posts'
+
+  attributes :title, :body
+
+  attribute :date do
+    @model.created_at
+  end
+
+  belongs_to :author
+
+  has_many :comments, V2::SerializableComment do
+    resources do
+      @model.published_comments
+    end
+
+    link :related do
+      @url_helpers.user_posts_url(@model.id)
+    end
+
+    meta do
+      { count: @model.published_comments.count }
+    end
+  end
+
+  link :self do
+    @url_helpers.post_url(@model.id)
+  end
+
+  meta do
+    { featured: true }
+  end
+end