apicasso 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 918cf0c81232e0e147d5bf174b7759e189cc82933d8d7341b64e6765bcd5af57
+  data.tar.gz: 929566ab3bfde9f9980263a2304072be2a6d21e5e82198e89e43ecfecfc7c588
+SHA512:
+  metadata.gz: bdfae676999589bce579a57c07adb0d58ecf2e1a18c94a4f754cd8428b3708d92d745a521ebc419c739ae1e08e30c36c93c6013c84afac4056252d770ebc0671
+  data.tar.gz: 6a7fb2af0119e03ae6ba657c713d7dc03b0e4331475b582d826f28486f40c33f4a22d17584ce7a5ccfef37e90fbabdd6db0c9f42cb4e42e631765cb53de5b911

data/README.md

@@ -0,0 +1,84 @@
+<img src="https://raw.githubusercontent.com/ErvalhouS/APIcasso/master/APIcasso.png" width="300" />
+
+JSON API development can get boring and time consuming. If you think it through, every time you make one you use almost the same route structure, pointing to the same controller actions, with the same ordering, filtering and pagination features.
+
+**APIcasso** is intended to be used as a full-fledged CRUD JSON API or as a base controller to speed-up development.
+It is a route-based resource abstraction using API key scoping. This makes it possible to make CRUD-only applications just by creating functional Rails' models. It is a perfect candidate for legacy Rails projects that do not have an API. Access to your application's resources is managed by a `.scope` JSON object per API key. It uses that permission scope to restrict and extend access.
+
+## Installation
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'apicasso'
+```
+
+And then execute this to generate the required migrations:
+```bash
+$ rails g apicasso:install
+```
+You will need to use a database with JSON fields support to use this gem.
+
+## Usage
+After installing APIcasso into your application you can mount a full-fledged CRUD JSON API just by attaching into some route. Usually you will have it under a scoped route like `/api/v1` or a subdomain. You can do that by adding this into your `config/routes.rb`:
+```ruby
+  # To mount your APIcasso routes under the path scope `/api/v1`
+  mount Apicasso::Engine, at: "/api/v1"
+  # or, if you prefer subdomain scope isolation
+  constraints subdomain: 'apiv1' do
+    mount Apicasso::Engine, at: "/"
+  end
+```
+Your API will reflect very similarly a `resources :resource` statement with the following routes:
+```ruby
+  get '/:resource/' # Index action, listing a `:resource` collection from your application
+  post '/:resource/' # Create action for one `:resource` from your application
+  get '/:resource/:id' # Show action for one `:resource` from your application
+  patch '/:resource/:id' # Update action for one `:resource` from your application
+  delete '/:resource/:id' # Destroy action for one `:resource` from your application
+  get '/:resource/:id/:nested/' # Index action, listing a collection of a `:nested` relation from one of your application's `:resource`
+  options '/:resource/' # A schema dump for the required `:resource`
+  options '/:resource/:id/:nested/' # A schema dump for the required `:nested` relation from one of your application's `:resource`
+```
+This means all your application's models will be exposed as `:resource` and it's relations will be exposed as `:nested`. It will enable you to CRUD and get schema metadata from your records.
+
+ > But this is permissive as hell! I do not want to expose my entire application like this, haven't you thought about security?
+
+*Sure!* The API is being exposed using authentication through `Authorization: Token` [HTTP header authentication](http://tools.ietf.org/html/draft-hammer-http-token-auth-01). The API key objects are manageable through the `Apicasso::Key` model, which gets setup at install. When a new key is created a `.token` is generated using an [Universally Unique Identifier(RFC 4122)](https://tools.ietf.org/html/rfc4122).
+
+Your API is then exposed based on each `Apicasso::Key.scope` definition
+```ruby
+  Apicasso::Key.create(scope:
+                        { manage:
+                            [{ order: true }, { user: { account_id: 1 } }],
+                          read:
+                            [{ account: { id: 1 } }]
+                        })
+```
+This translates directly into which parts of your application is exposed to each APIcasso keys.
+
+The key from this example will have full access to all orders and to users with `account_id == 1`. It will have also read-only access to accounts with `id == 1`.
+
+This saves you the trouble of having to setup each and every controller for each model. And even if your application really need it, just make your controllers inherit from `Apicasso::CrudController` and extend it's functionalities. This authorization feature is why one of the dependencies for this gem is [CanCanCan](https://github.com/CanCanCommunity/cancancan), that abstracts the scope field into authorization for your application's resources.
+
+The `crud#index` and `crud#nested_index` actions are already equipped with pagination, ordering and filtering.
+
+ - You can pass `params[:sort]` with field names preffixed with `+` or `-` to configure custom ordering per request. I.E.: `?sort=+updated_at,-name`
+ - You can pass `params[:q]` using [ransack's search matchers](https://github.com/activerecord-hackery/ransack#search-matchers) to build a search query. I.E.: `?q[full_name_start]=Picasso`
+ - You can pass `params[:page]` and `params[:per_page]` to build pagination options. I.E.: `?page=2&per_page=12`
+
+## Contributing
+Bug reports and pull requests are welcome on GitHub at https://github.com/ErvalhouS/APIcasso. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant code of conduct](http://contributor-covenant.org/).
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of conduct
+Everyone interacting in the APIcasso project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/ErvalhouS/APIcasso/blob/master/CODE_OF_CONDUCT.md).
+
+## TODO
+
+ - Add gem options like: Token rotation, Alternative authentication methods
+ - Response fields selecting
+ - Rate limiting
+ - Testing suite
+ - Travis CI

data/Rakefile

@@ -0,0 +1,32 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Apicasso'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load 'rails/tasks/engine.rake'
+
+load 'rails/tasks/statistics.rake'
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/assets/config/apicasso_manifest.js

@@ -0,0 +1,2 @@
+//= link_directory ../javascripts/apicasso .js
+//= link_directory ../stylesheets/apicasso .css

data/app/assets/javascripts/apicasso/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require rails-ujs
+//= require activestorage
+//= require_tree .

data/app/assets/stylesheets/apicasso/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/apicasso/apidocs_controller.rb

@@ -0,0 +1,472 @@
+# frozen_string_literal: true
+
+module Apicasso
+  # Controller used to generate an application Swagger JSON, used by
+  # SwaggerUI to generate beautiful API documentation
+  class ApidocsController < ActionController::API
+    include Swagger::Blocks
+
+    swagger_root do
+      key :swagger, '2.0'
+      info do
+        key :version, ENV.fetch('VERSION', I18n.t('application.version'))
+        key :title, ENV.fetch('APP_NAME', I18n.t('application.name'))
+        key :description, ENV.fetch('APP_DESCRIPTION', I18n.t('application.description'))
+        key :termsOfService, I18n.t('application.terms_of_service')
+        contact do
+          key :name, I18n.t('application.contact_name')
+        end
+        license do
+          key :name, I18n.t('application.license')
+        end
+      end
+      ActiveRecord::Base.descendants.each do |model|
+        tag do
+          key :name, I18n.t("activerecord.models.#{model.name.underscore}", default: model.name.underscore)
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.description", default: model.name)
+        end
+      end
+      key :host, I18n.t('application.apicasso_host', default: ENV.fetch('ROOT', 'localhost:3000'))
+      key :basePath, I18n.t('application.apicasso_path', default: '/')
+      key :consumes, ['application/json']
+      key :produces, ['application/json']
+    end
+
+    # Eager load application to be able to list all models
+    Rails.application.eager_load! unless Rails.configuration.cache_classes
+    # A list of all classes that have swagger_* declarations, which gets injected
+    # by this gem in all `ActiveRecord::Base` classes
+    SWAGGERED_CLASSES = [
+      *ActiveRecord::Base.descendants,
+      self
+    ].freeze
+
+    swagger_schema :ErrorModel do
+      key :required, [:code, :message]
+      property :code do
+        key :type, :integer
+        key :format, :int32
+      end
+      property :message do
+        key :type, :string
+      end
+    end
+
+    ActiveRecord::Base.descendants do |model|
+      swagger_path "/#{model.name.underscore}" do
+        operation :get do
+          key :summary, I18n.t("activerecord.models.#{model.name.underscore}.index.summary", default: model.name)
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.index.description", default: model.name)
+          key :operationId, "find#{model.name.pluralize}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          parameter do
+            key :name, :sort
+            key :in, :query
+            key :description, I18n.t('apicasso.sort.description',
+                                     default: 'Parameters sorting splitted by `,` preffixed by `+` or `-` which translates into ascending or descending order')
+            key :required, false
+            key :type, :string
+            key :collectionFormat, :json
+          end
+          parameter do
+            key :name, :q
+            key :in, :query
+            key :description, I18n.t('apicasso.q.description',
+                                     default: 'Records filtering by attribute and search query as affix. Usage: `?q[{attribute}{search_affix}]={matcher}`. All available search affixes are listed on: https://github.com/activerecord-hackery/ransack#search-matchers')
+            key :required, false
+            key :type, :json
+          end
+          parameter do
+            key :name, :page
+            key :in, :query
+            key :description, I18n.t('apicasso.page.description',
+                                     default: 'Records pagination paging, which offsets collection based on `params[:per_page]`')
+            key :required, false
+            key :type, :integer
+          end
+          parameter do
+            key :name, :per_page
+            key :in, :query
+            key :description, I18n.t('apicasso.per_page.description',
+                                     default: 'Records pagination size, which sets how many records will be rendered per request')
+            key :required, false
+            key :type, :integer
+          end
+          response 200 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.index.response",
+                                     default: "#{model.name} response, which include records matching current query and pagination metadata")
+            parameter do
+              key :name, :total
+              key :description, I18n.t('apicasso.total.description',
+                                      default: 'Total records contained in current collection, as if there was no pagination.')
+              key :required, true
+              key :type, :integer
+            end
+            parameter do
+              key :name, :total_pages
+              key :description, I18n.t('apicasso.total_pages.description',
+                                      default: 'How many pages of data the current collection has.')
+              key :required, true
+              key :type, :integer
+            end
+            parameter do
+              key :name, :last_page
+              key :description, I18n.t('apicasso.last_page.description',
+                                      default: 'An indication if current request is the last to paginate in the current collection')
+              key :required, true
+              key :type, :boolean
+            end
+            parameter do
+              key :name, :previous_page
+              key :description, I18n.t('apicasso.previous_page.description',
+                                      default: "The link of the previous page for the current collection. It can be null if there isn't any")
+              key :required, false
+              key :type, :string
+            end
+            parameter do
+              key :name, :next_page
+              key :description, I18n.t('apicasso.next_page.description',
+                                      default: "The link of the next page for the current collection. It can be null if there isn't any")
+              key :required, false
+              key :type, :string
+            end
+            parameter do
+              key :name, :out_of_bounds
+              key :description, I18n.t('apicasso.out_of_bounds.description',
+                                      default: 'An indication if current request is out of pagination bounds for the current collection')
+              key :required, true
+              key :type, :boolean
+            end
+            parameter do
+              key :name, :offset
+              key :description, I18n.t('apicasso.offset.description',
+                                      default: 'How many records were offsetted from the collection to render the current page')
+              key :required, true
+              key :type, :integer
+            end
+            parameter do
+              key :name, :entries
+              key :description, I18n.t('apicasso.entries.description',
+                                      default: 'The records collection in the current pagination scope.')
+              key :required, true
+              key :type, :array
+              items do
+                key :'$ref', model.name.to_sym
+              end
+            end
+          end
+          response :default do
+            key :description, I18n.t("activerecord.errors.models.#{model.name.underscore}",
+                                     default: "Unexpected error in #{model.name}")
+            schema do
+              key :'$ref', :ErrorModel
+            end
+          end
+        end
+        operation :options do
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.schema.description",
+                                   default: "#{model.name} metadata information.")
+          key :operationId, "schema#{model.name.pluralize}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          response 200 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.schema.response",
+                                     default: "#{model.name} metadata as a json with field names as keys and field types as values.")
+            schema do
+              key :'$ref', "#{model.name}Metadata".to_sym
+            end
+          end
+          response :default do
+            key :description, I18n.t("activerecord.errors.models.#{model.name.underscore}",
+                                     default: "Unexpected error in #{model.name}")
+            schema do
+              key :'$ref', :ErrorModel
+            end
+          end
+        end
+        operation :post do
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.create.response",
+                                   default: "Creates a #{model.name}")
+          key :operationId, "add#{model.name}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          parameter do
+            key :name, model.name.underscore.to_sym
+            key :in, :body
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.create.description",
+                                   default: "#{model.name} to add into application")
+            key :required, true
+            schema do
+              key :'$ref', "#{model.name}Input".to_sym
+            end
+          end
+          response 201 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.show.description",
+                                     default: "#{model.name} response")
+            schema do
+              key :'$ref', model.name.to_sym
+            end
+          end
+          response :default do
+            key :description, I18n.t("activerecord.errors.models.#{model.name.underscore}",
+                                     default: "Unexpected error in #{model.name}")
+            schema do
+              key :'$ref', :ErrorModel
+            end
+          end
+        end
+      end
+      swagger_path "/#{model.name.underscore}/{id}" do
+        operation :patch do
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.update.response",
+                                   default: "Updates a #{model.name}")
+          key :operationId, "edit#{model.name}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          parameter do
+            key :name, :id
+            key :in, :path
+            key :description, I18n.t("activerecord.models.attributes.#{model.name.underscore}.id",
+                                     default: "ID of #{model.name} to update on the application")
+            key :required, true
+            schema do
+              key :'$ref', "#{model.name}Input".to_sym
+            end
+          end
+          parameter do
+            key :name, model.name.underscore.to_sym
+            key :in, :body
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.update.description",
+                                     default: "Existing #{model.name} to update on the application")
+            key :required, true
+            schema do
+              key :'$ref', "#{model.name}Input".to_sym
+            end
+          end
+          response 200 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.show.description",
+                                     default: "#{model.name} response")
+            schema do
+              key :'$ref', model.name.to_sym
+            end
+          end
+        end
+        operation :get do
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.show.response",
+                                   default: "Creates a #{model.name}")
+          key :operationId, "show#{model.name}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          parameter do
+            key :name, :id
+            key :in, :path
+            key :description, I18n.t("activerecord.models.attributes.#{model.name.underscore}.id",
+                                     default: "ID of #{model.name} to fetch on the application")
+            key :required, true
+            schema do
+              key :'$ref', "#{model.name}Input".to_sym
+            end
+          end
+          response 200 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.show.description",
+                                     default: "#{model.name} response")
+            schema do
+              key :'$ref', model.name.to_sym
+            end
+          end
+          response :default do
+            key :description, I18n.t("activerecord.errors.models.#{model.name.underscore}",
+                                     default: "Unexpected error in #{model.name}")
+            schema do
+              key :'$ref', :ErrorModel
+            end
+          end
+        end
+        operation :delete do
+          key :description, I18n.t("activerecord.models.#{model.name.underscore}.destroy.response",
+                                   default: "Deletes a #{model.name}")
+          key :operationId, "destroy#{model.name}"
+          key :produces, ['application/json']
+          key :tags, [model.name.underscore]
+          parameter do
+            key :name, :id
+            key :in, :path
+            key :description, I18n.t("activerecord.models.attributes.#{model.name.underscore}.id",
+                                     default: "ID of #{model.name} to delete on the application")
+            key :required, true
+            schema do
+              key :'$ref', "#{model.name}Input".to_sym
+            end
+          end
+          response 200 do
+            key :description, I18n.t("activerecord.models.#{model.name.underscore}.destroy.description",
+                                     default: "#{model.name} response")
+          end
+          response :default do
+            key :description, I18n.t("activerecord.errors.models.#{model.name.underscore}",
+                                     default: "Unexpected error in #{model.name}")
+            schema do
+              key :'$ref', :ErrorModel
+            end
+          end
+        end
+      end
+
+      model.reflect_on_all_associations.map(&:name) do |association|
+        inner_name = extract_klass_name(model: model, association: association)
+        inner_klass = extract_klass(model: model, association: association)
+        swagger_path "/#{model.name.underscore}/{id}/#{association}" do
+          operation :get do
+            key :summary, I18n.t("activerecord.models.#{inner_name.underscore}.index.summary", default: inner_name)
+            key :description, I18n.t("activerecord.models.#{inner_name.underscore}.index.description", default: inner_name)
+            key :operationId, "find#{inner_name.pluralize}"
+            key :produces, ['application/json']
+            key :tags, [inner_name.underscore]
+            parameter do
+              key :name, :sort
+              key :in, :query
+              key :description, I18n.t('apicasso.sort.description',
+                                      default: 'Parameters sorting splitted by `,` preffixed by `+` or `-` which translates into ascending or descending order')
+              key :required, false
+              key :type, :string
+              key :collectionFormat, :json
+            end
+            parameter do
+              key :name, :q
+              key :in, :query
+              key :description, I18n.t('apicasso.q.description',
+                                      default: 'Records filtering by attribute and search query as affix. Usage: `?q[{attribute}{search_affix}]={matcher}`. All available search affixes are listed on: https://github.com/activerecord-hackery/ransack#search-matchers')
+              key :required, false
+              key :type, :json
+            end
+            parameter do
+              key :name, :page
+              key :in, :query
+              key :description, I18n.t('apicasso.page.description',
+                                      default: 'Records pagination paging, which offsets collection based on `params[:per_page]`')
+              key :required, false
+              key :type, :integer
+            end
+            parameter do
+              key :name, :per_page
+              key :in, :query
+              key :description, I18n.t('apicasso.per_page.description',
+                                      default: 'Records pagination size, which sets how many records will be rendered per request')
+              key :required, false
+              key :type, :integer
+            end
+            response 200 do
+              key :description, I18n.t("activerecord.models.#{inner_name.underscore}.index.response",
+                                      default: "#{inner_name} response, which include records matching current query and pagination metadata")
+              parameter do
+                key :name, :total
+                key :description, I18n.t('apicasso.total.description',
+                                        default: 'Total records contained in current collection, as if there was no pagination.')
+                key :required, true
+                key :type, :integer
+              end
+              parameter do
+                key :name, :total_pages
+                key :description, I18n.t('apicasso.total_pages.description',
+                                        default: 'How many pages of data the current collection has.')
+                key :required, true
+                key :type, :integer
+              end
+              parameter do
+                key :name, :last_page
+                key :description, I18n.t('apicasso.last_page.description',
+                                        default: 'An indication if current request is the last to paginate in the current collection')
+                key :required, true
+                key :type, :boolean
+              end
+              parameter do
+                key :name, :previous_page
+                key :description, I18n.t('apicasso.previous_page.description',
+                                        default: "The link of the previous page for the current collection. It can be null if there isn't any")
+                key :required, false
+                key :type, :string
+              end
+              parameter do
+                key :name, :next_page
+                key :description, I18n.t('apicasso.next_page.description',
+                                        default: "The link of the next page for the current collection. It can be null if there isn't any")
+                key :required, false
+                key :type, :string
+              end
+              parameter do
+                key :name, :out_of_bounds
+                key :description, I18n.t('apicasso.out_of_bounds.description',
+                                        default: 'An indication if current request is out of pagination bounds for the current collection')
+                key :required, true
+                key :type, :boolean
+              end
+              parameter do
+                key :name, :offset
+                key :description, I18n.t('apicasso.offset.description',
+                                        default: 'How many records were offsetted from the collection to render the current page')
+                key :required, true
+                key :type, :integer
+              end
+              parameter do
+                key :name, :entries
+                key :description, I18n.t('apicasso.entries.description',
+                                        default: 'The records collection in the current pagination scope.')
+                key :required, true
+                key :type, :array
+                items do
+                  key :'$ref', inner_name.to_sym
+                end
+              end
+            end
+            response :default do
+              key :description, I18n.t("activerecord.errors.models.#{inner_name.underscore}",
+                                      default: "Unexpected error in #{inner_name}")
+              schema do
+                key :'$ref', :ErrorModel
+              end
+            end
+          end
+          operation :options do
+            key :description, I18n.t("activerecord.models.#{inner_name.underscore}.schema.description",
+                                    default: "#{inner_name} metadata information.")
+            key :operationId, "schema#{inner_name.pluralize}"
+            key :produces, ['application/json']
+            key :tags, [inner_name.underscore]
+            response 200 do
+              key :description, I18n.t("activerecord.models.#{inner_name.underscore}.schema.response",
+                                      default: "#{inner_name} metadata as a json with field names as keys and field types as values.")
+              schema do
+                key :'$ref', "#{inner_name}Metadata".to_sym
+              end
+            end
+            response :default do
+              key :description, I18n.t("activerecord.errors.models.#{inner_name.underscore}",
+                                      default: "Unexpected error in #{inner_name}")
+              schema do
+                key :'$ref', :ErrorModel
+              end
+            end
+          end
+        end
+      end
+    end
+
+    def index
+      render json: Swagger::Blocks.build_root_json(SWAGGERED_CLASSES)
+    end
+
+    private
+
+    def extract_klass_name(opts = {})
+      association = opts[:model].reflect_on_all_associations.select{ |ass| ass.name == opts[:association] }.first
+      association.class_name
+    end
+
+    def extract_klass(opts = {})
+      extract_klass_name(opts).constantize
+    rescue NameError
+      return false
+    end
+  end
+end