tramway-api 1.8.2.3 → 1.8.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 022a3e30c40c67f5ea395f36d02ad064888501855af9e9d3cd3c17084ec4ae90
-  data.tar.gz: ce519fcc07c446ca740141be4f737109a3bada820e22b813e497cfc4de5b165c
+  metadata.gz: ed93d90eaaed7aa48a6b22b4961a91ee4ffccb7ca89e5572e605b4fbb438fde7
+  data.tar.gz: 5dfddda7b69e8d16ac6822f33d2980fdf689b10eb6fa207e5c111bc9cb87c69b
 SHA512:
-  metadata.gz: 5b38ee6bf57cbd0d3490c8f92e7d514454a1bbacaef1d792a28128b300ad4280cb15526c259c6fa4f146a297840989ded8104f27dcaa37509a582449356e7d32
-  data.tar.gz: 29869a70b7712a098743976745a9bc497b37ab27154673a4048ccfa608e95529a52d03cef159646a1a1d1db0429e20747d422ce9c1cc2aa045a3e792c380d9d4
+  metadata.gz: e10d5588bf40fd00da3f56deeac9999d64b487e52f053e70f747116b08cef9db8b5673f35a7fb177ac8833089111f0e8c44763981fb95cd1527ab507e80abe03
+  data.tar.gz: '0953fe2122cbda3f51a493978ca23f908d40e8689d48410a518fb41ff05184d579779dc03c2f416af5bd1be691fd2eedc5c783aef70043d4ec7df1917e8b5fc7'

data/README.md

@@ -44,6 +44,7 @@ coming soon...
   gem 'state_machine', github: 'seuros/state_machine'
   gem 'knock'
   gem 'audited'
+  gem 'ransack'
   ```
 
 ## Usage
@@ -64,23 +65,51 @@ gem 'knock'
 
 Run `bundle install`
 
+### Initialize @application object
+
+[How-to](https://github.com/Purple-Magic/tramway-core/blob/develop/README.md#every-tramway-application-need-initialized-application-object-or-if-you-create-tramway-plugin-it-should-be-application_engine-object)
+
+*config/routes.rb*
+
+```ruby
+Rails.application.routes.draw do
+  # ...
+  mount Tramway::Api::Engine, at: '/api'
+  # ...
+end
+```
+
 Then generate User (you use another name, it's just an example) model
 
 ```
-rails g model user email:text password_digest:text username:text state:text uid:text
+rails g model user email:text password_digest:text username:text state:text uuid:uuid
 ```
 
 Enable extension in your database:
 
 *db/migrate/enable_extension.rb*
-```
-def change
-  enable_extension 'uuid-ossp'
+```ruby
+class EnableExtensionUUIDOSSP < ActiveRecord::Migration
+  def change
+    enable_extension 'uuid-ossp'
+  end
 end
 ```
 
+### You can choose a method, which will be using as public ID method
+
+By default, it's a `uuid` method
+
+To choose your own public ID method, just add this line to:
 
-Add generating uuid by default to every model, that is accessible by API
+*config/initializers/tramway.rb*
+
+```ruby
+Tramway::Api.id_methods_of(User => :id)
+```
+If you want to use `uuid` by default, please, add it to your models
+
+#### Add generating uuid by default to every model, that is accessible by API
 
 *db/migrate/add_uuid_to_some_model.rb*
 
@@ -100,11 +129,26 @@ class User < Tramway::Core::ApplicationRecord
 end
 ```
 
-Create file `config/initializers/tramway.rb`
+#### Create file `config/initializers/tramway.rb`
+#### If you need JWT authentication add this line to the `config/initializers/tramway.rb`
 
 ```ruby
 ::Tramway::Api.auth_config = { user_model: User, auth_attributes: %i[email username] }
-::Tramway::Api.set_available_models user: { open: %i[create], closed: %i[update] }
+```
+
+#### Configurate available models. Tramway will create end points according to this config
+
+```
+::Tramway::Api.set_available_models({
+  User => [
+    {
+      show: lambda do |record, current_user|
+        record.id == current_user.id         # shows only current_user profile
+      end
+    }
+  ],
+  project: :your_project_name
+})
 ```
 
 Run `rails g tramway:core:install`
@@ -316,7 +360,7 @@ Create serializer
 *app/serializers/user_serializer.rb*
 
 ```ruby
-class UserSerializer < Tramway::Core::ApplicationSerializer
+class UserSerializer < Tramway::Api::V1::ApplicationSerializer
   attributes :username, :email
 end
 ```
@@ -341,21 +385,125 @@ You have your records in JSON API spec.
 
 ### Create
 
-Production ready
+*config/initializers/tramway.rb*
 
-Docs coming soon
+```ruby
+::Tramway::Api.set_available_models({ YourModel => [ :create ] }, project: :your_project_name })
+```
+
+*app/forms/your_model_form.rb*
+
+```ruby
+class YourModelForm < Tramway::Core::ApplicationForm
+  properties :attribute1, :attribute2, :name
+  
+  association :another_association_model
+  
+  def name=(value)
+    model.first_name = value.split(' ')[0]
+    model.first_name = value.split(' ')[1]
+  end
+end
+```
+
+Now you can your request. It has such structure
+
+**POST** `/api/v1/records?model=YourModel`
+
+```
+Params Structure
+{
+  data: {
+    attributes: {
+      attribute1: 'some value',
+      attribute2: 'some value',
+      name: 'some full name',
+      another_association_model: {
+        # here a list of attributes, which you described in AnotherAssociationModelForm
+      }
+    }
+  }
+}
+```
 
 ### Update
 
-Production ready
+*config/initializers/tramway.rb*
 
-Docs coming soon
+```ruby
+::Tramway::Api.set_available_models({ YourModel => [ :update ] }, project: :your_project_name })
+```
+
+*app/forms/your_model_form.rb*
+
+```ruby
+class YourModelForm < Tramway::Core::ApplicationForm
+  properties :attribute1, :attribute2, :name
+  
+  association :another_association_model
+  
+  def name=(value)
+    model.first_name = value.split(' ')[0]
+    model.first_name = value.split(' ')[1]
+  end
+end
+```
+
+Now you can your request. It has such structure
+
+**PATCH** `/api/v1/records/#{object_id}?model=YourModel`
+
+```
+Params Structure
+{
+  data: {
+    attributes: {
+      attribute1: 'some value',
+      attribute2: 'some value',
+      name: 'some full name',
+      another_association_model: {
+        # here a list of attributes, which you described in AnotherAssociationModelForm
+      }
+    }
+  }
+}
+```
 
 ### Show
 
-Production ready
+#### Description
 
-Docs coming soon
+It returns just one record, if it is not deleted.
+
+#### Using
+
+##### Allow method show in tramway initializer for `YourModel` 
+
+*config/initializers/tramway.rb*
+
+```ruby
+::Tramway::Api.set_available_models({ YourModel => [ :show ] }, project: :your_project_name })
+```
+
+##### Create serializer
+
+*app/serializers/user_serializer.rb*
+
+```ruby
+class UserSerializer < Tramway::Core::ApplicationSerializer
+  attributes :username, :email
+end
+```
+
+##### Run your server on the localhost `rails s`
+##### Made this query to test new API method (for example: you can create file `bin/test_tramway.rb` with this lines):
+
+```ruby
+require 'net/http'
+
+YourModel.create! attribute_1: 'some value', attribute_2: 'some_value'
+Net::HTTP.get('localhost:3000', "/api/v1/records/#{YourModel.last.id}?model=YourModel")
+```
 
 ### Destroy
 

data/app/controllers/tramway/api/application_controller.rb

@@ -58,7 +58,9 @@ module Tramway
 
       def current_user
         Tramway::Api.user_based_models.map do |user_based_model|
-          send("current_#{user_based_model.name.underscore}")
+          unless user_based_model == User
+            send("current_#{user_based_model.name.underscore}")
+          end
         end.compact.first
       end
     end

data/app/controllers/tramway/api/v1/application_controller.rb

@@ -15,7 +15,7 @@ module Tramway
         def snake_case(params)
           hash = {}
           params.each do |attribute, value|
-            key = UUID.validate(attribute) ? attribute : attribute.to_s.gsub('-', '_')
+            key = ::UUID.validate(attribute) ? attribute : attribute.to_s.gsub('-', '_')
             hash.merge! key => value
           end
           hash
@@ -24,12 +24,21 @@ module Tramway
         private
 
         def record
-          @record = model_class.find_by! uuid: params[:id] if params[:id].present?
+          if params[:key].present?
+            if ids_methods_of(model: model_class).include? params[:key]
+              @record = model_class.find_by! params[:key] => params[:id] if params[:id].present?
+            end
+          else
+            default_id_method = Tramway::Api.default_id_method_of(model: model_class) || :uuid
+            @record = model_class.find_by! default_id_method => params[:id] if params[:id].present?
+          end
         end
 
         def records
-          collection = model_class.active.order(id: :desc).send params[:scope] || :all
-          collection = collection.full_text_search params[:search] if params[:search]
+          active_records = model_class.respond_to?(:active) ? model_class.active : model_class.all
+          collection = active_records.order(id: :desc).send params[:scope] || :all
+          collection = collection.page(params[:page]).per(params[:per]) if params[:page].present?
+          collection = collection.full_text_search params[:search] if params[:search].present?
           collection
         end
 
@@ -100,12 +109,10 @@ module Tramway
         protected
 
         def model_class
-          if params[:model].to_s.in? available_models_for_current_user
-            begin
-              params[:model].constantize
-            rescue ActiveSupport::Concern::MultipleIncludedBlocks => e
-              raise "#{e}. Maybe #{params[:model]} model doesn't exists or there is naming conflicts with it"
-            end
+          begin
+            params[:model].constantize
+          rescue ActiveSupport::Concern::MultipleIncludedBlocks => e
+            raise "#{e}. Maybe #{params[:model]} model doesn't exists or there is naming conflicts with it"
           end
         end
 

data/app/serializers/tramway/api/v1/application_serializer.rb

@@ -6,7 +6,8 @@ class Tramway::Api::V1::ApplicationSerializer < ActiveModel::Serializer
   attribute :id
 
   def id
-    object.uuid
+    id_method = Tramway::Api.id_method_of(model: object.class) || :uuid
+    object.send(id_method)
   end
 
   def created_at

data/lib/tramway/api.rb

@@ -83,6 +83,21 @@ module Tramway
           new_hash.merge! pair[0].to_s => pair[1]
         end
       end
+
+      def id_methods_of(options = {})
+        @@id_methods ||= {}
+        @@id_methods.merge!(options.reduce({}) do |hash, pair|
+          hash.merge! pair[0].to_s => pair[1]
+        end)
+      end
+
+      def other_id_methods_of(model:)
+        @@id_methods[model.to_s][:other]
+      end
+
+      def default_id_method_of(model:)
+        @@id_methods[model.to_s][:default]
+      end
     end
   end
 end

data/lib/tramway/api/version.rb

@@ -2,6 +2,6 @@
 
 module Tramway
   module Api
-    VERSION = '1.8.2.3'
+    VERSION = '1.8.6'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tramway-api
 version: !ruby/object:Gem::Version
-  version: 1.8.2.3
+  version: 1.8.6
 platform: ruby
 authors:
 - Pavel Kalashnikov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-30 00:00:00.000000000 Z
+date: 2020-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_model_serializers