solidus_api_v2 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e9a655640cb100a9789b9bb3405ffd13bc3d18ea
+  data.tar.gz: 2f83156cfb6c658aaea29beb12a4d1619a25bf73
+SHA512:
+  metadata.gz: 34999a1b6484f224b0dca93da92d2838683fe11f55c0d966b44c99aa96ac1db8bc1f9658d4a218d4be11870e4517991c9b83f62bac899eec7d341d1f8aaf9def
+  data.tar.gz: 0bb5d23198292cf140e9a40cc946295c89902bfdaa1e0b4579d9a965dff2bb7a1f85a06c834f9f4ef6f664dcc5ec427790be83f07cb9b0a9fc3e44dd4a89321f

data/.gitignore

@@ -0,0 +1,15 @@
+\#*
+*~
+.#*
+.DS_Store
+.idea
+.project
+.sass-cache
+coverage
+Gemfile.lock
+tmp
+nbproject
+pkg
+*.swp
+spec/dummy
+build

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 0.2.0
+
+*   Calling `super` inside fo `#index` and `#show` actions is now deprecated.
+    Since these are methods that are meant to be called, they have been renamed to `#render_collection` and `#render_instance`.
+
+    [Ben A. Morgan](https://github.com/BenMorganIO)
+
+*   Added support for [Solidus](https://github.com/solidusio/solidus).
+
+    [Ben A. Morgan](https://github.com/BenMorganIO)
+
+*   In some instances, you would like to use the helper methods provided by the Spree V2 API, but unable to extend from the controller.
+    The render methods have been moved to a concern.
+    If you would like to include them in a controller without having to extend from the `Spree::Api::V2::BaseController`, then:
+
+    ```ruby
+    module Api
+      class MyController < Api::BaseController
+        # include the concern
+        include Spree::Api::V2::Renderable
+
+        # example usage of rendering all products without calling
+        # +render_instance+ but providing page detail information that conforms
+        # to the JSON API spec.
+        def index
+          render json: @products, meta: { page: page_details(@products) }
+        end
+      end
+    end
+    ```
+
+    [Ben A. Morgan](https://github.com/BenMorganIO)
+
+## 0.1.0
+
+Initial Release

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+if ENV['SOLIDUS_API'].nil?
+  gem 'spree_api', github: 'spree', branch: '3-0-stable'
+  gem 'spree_auth_devise', github: 'spree/spree_auth_devise', branch: '3-0-stable'
+
+  gemspec name: 'spree_api_v2'
+else
+  gem 'solidus_api', github: 'solidusio/solidus'
+  gem 'solidus_auth_devise', github: 'solidusio/solidus_auth_devise'
+
+  gemspec name: 'solidus_api_v2'
+end

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2015 Ben A. Morgan
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name Spree nor the names of its contributors may be used to
+      endorse or promote products derived from this software without specific
+      prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,98 @@
+# Spree::Api::V2
+
+[![Circle CI](https://circleci.com/gh/spree-contrib/spree_api_v2/tree/master.svg?style=svg&circle-token=e2f6283b074ca9febcafab729d466ded2334300c)](https://circleci.com/gh/spree-contrib/spree_api_v2/tree/master)
+
+The second version of the Spree API that's JSON API compatible.
+
+Documentation: [http://spree-contrib.github.io/spree_api_v2](http://spree-contrib.github.io/spree_api_v2)
+
+## Installation
+
+Add spree_api_v2 to your Gemfile:
+
+```ruby
+gem 'spree_api_v2', github: 'spree-contrib/spree_api_v2'
+```
+
+## Road to 1.0
+
+***
+Please note that there actually has been a _lot_ of work done.
+The lack of checked off boxes doesn't give this gem the respect it deserves.
+***
+
+There's several things blocking 1.0.
+Below, you'll see a bullet list of requirements that are both specific to the app, the JSON API spec, and third parties.
+
+- [ ] Manage permissions with CanCanCan.
+- [ ] Add support for XML.
+- [ ] Add support for pagination.
+  - [x] `page` keyword support for pagination.
+  - [ ] `links` document at the root for `self`, `next`, `prev`, `last`, and `first`.
+- [ ] Add support for filtration.
+  - [x] Be able to filter onto the main data object.
+  - [ ] Be able to filter the included relationships.
+- [ ] Provide JSON API specific error objects. Provide support for:
+  - [ ] `id`
+  - [ ] `links`
+     - [ ] `about`
+  - [ ] `status`
+  - [ ] `code`
+  - [x] `title`
+  - [x] `detail`
+  - [ ] `source`
+    - [x] `pointer`
+    - [ ] `parameter`
+  - [x] `meta`
+- [ ] Only accept data in the JSON API format.
+- [ ] Respond with header `Content-Type: application/vnd.api+json`.
+- [ ] Add support for sparse fieldsets.
+- [ ] Add support for sorting.
+
+| Resource         |  index  | create  |  show   | update  | destroy |
+|------------------|:-------:|:-------:|:-------:|:-------:|:-------:|
+| Adjustment       |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Address          |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Checkout         |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Country          |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Image            |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Line Item        |   [ ]   |   nw    |   [ ]   |   [ ]   |   [ ]   |
+| Option Type      |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Option Value     |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Order            |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Payment          |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Price            |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Product          |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Product Property |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Return Auth      |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Shipment         |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| State            |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Stock Location   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Stock Movement   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Stock Item       |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Store            |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Store Credit     |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Tax Category     |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Tax Rate         |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+| Taxon            |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Taxonomy         |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| User             |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Variant          |   [x]   |   [ ]   |   [x]   |   [ ]   |   [ ]   |
+| Zone             |   [ ]   |   [ ]   |   [ ]   |   [ ]   |   [ ]   |
+
+## Testing
+
+First bundle your dependencies, then run `rake`. `rake` will default to building the dummy app if it does not exist, then it will run the specs.
+The dummy app can be regenerated by using `rake test_app`.
+
+```shell
+bundle
+bundle exec rake GEMNAME=spree_api_v2
+bundle exec rake GEMNAME=solidus_api_v2
+```
+
+## Sponsored by:
+
+[![Kabuni](https://assets.kabuni.com/kabuni-secondary-logomark-xlarge.png)](https://kabuni.com?utm_source=SpreeApiV2&utm_medium=sponsor&utm_campaign=opensource)
+
+Copyright © 2015 Ben A. Morgan, released under the New BSD License

data/Rakefile

@@ -0,0 +1,37 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks name: ENV['GEMNAME']
+
+require 'rspec/core/rake_task'
+
+require 'generators/spree/dummy/dummy_generator'
+require 'generators/spree/install/install_generator'
+
+RSpec::Core::RakeTask.new
+
+task :default do
+  if Dir['spec/dummy'].empty?
+    Rake::Task[:test_app].invoke
+    Dir.chdir('../../')
+  end
+  Rake::Task[:spec].invoke
+end
+
+desc 'Generates a dummy app for testing'
+task :test_app do
+  ENV["RAILS_ENV"] = 'test'
+
+  Spree::DummyGeneratorHelper.inject_extension_requirements = true
+  Spree::DummyGenerator.start %w(--lib_name=spree_api_v2 --quiet)
+
+  Spree::InstallGenerator.class_eval do
+    def config_spree_yml() end
+  end
+
+  Spree::InstallGenerator.start %w(
+    --lib_name=spree_api_v2 --auto-accept --migrate=false --seed=false
+    --sample=false --quiet --user_class=Spree::LegacyUser
+  )
+
+  puts 'Setting up dummy database...'
+  system "bundle exec rake db:drop db:create db:migrate > #{File::NULL}"
+end

data/app/controllers/concerns/spree/api/v2/renderable.rb

@@ -0,0 +1,51 @@
+module Spree
+  module Api
+    module V2
+      module Renderable
+        extend ActiveSupport::Concern
+
+        protected
+
+        def render_collection(collection = [])
+          collection = collection.where(filter_params).paginate(page_params)
+          render json: collection, include: params[:include],
+                 meta: { page: page_details(collection) }
+        end
+
+        def render_instance(object = {})
+          render json: object, include: params[:include]
+        end
+
+        private
+
+        def error_response(resource)
+          Spree::ErrorSerializer.new(resource).as_json
+        end
+
+        def filter_params
+          params.fetch(:filter, {}).permit(filter_attributes << :id).transform_values do |value|
+            value.split(',')
+          end
+        end
+
+        def filter_attributes
+          serializer = "Spree::#{controller_name.camelize.singularize}Serializer"
+          serializer.constantize._attributes
+        end
+
+        def page_details(collection)
+          {
+            total_items: collection.total_count,
+            total_pages: collection.total_pages,
+            number: (page_params[:number] || 1).to_i,
+            size: (page_params[:size] || Kaminari.config.default_per_page).to_i
+          }
+        end
+
+        def page_params
+          params.fetch(:page, {}).permit(:number, :size)
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/base_controller.rb

@@ -0,0 +1,31 @@
+module Spree
+  module Api
+    module V2
+      class BaseController < Spree::Api::BaseController
+        include Spree::Api::V2::Renderable
+
+        protected
+
+        def index(collection = [])
+          ActiveSupport::Deprecation.warn <<-TEXT.squish
+            Using `super` is now deprecated. We're aiming to removing as much
+            meta-programming as possible. Please use the `render_collection`
+            method instead. This will be removed in 0.3.0.
+          TEXT
+
+          render_collection collection
+        end
+
+        def show(object = {})
+          ActiveSupport::Deprecation.warn <<-TEXT.squish
+            Using `super` is now deprecated. We're aiming to removing as much
+            meta-programming as possible. Please use the `render_instance`
+            method instead. This will be removed in 0.3.0.
+          TEXT
+
+          render_instance object
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/children_controller.rb

@@ -0,0 +1,29 @@
+module Spree
+  module Api
+    module V2
+      class ChildrenController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection children.includes(:products, :taxonomy, :children, :parent)
+        end
+
+        def show
+          render_instance children.find(params[:id])
+        end
+
+        private
+
+        def children
+          if params[:taxon_id]
+            Spree::Taxon.find(params[:taxon_id])
+          end.children
+        end
+
+        def filter_attributes
+          Spree::TaxonSerializer._attributes
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/countries_controller.rb

@@ -0,0 +1,21 @@
+module Spree
+  module Api
+    module V2
+      class CountriesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection Spree::Country.includes(:states)
+        end
+
+        def show
+          if params[:state_id].present?
+            render_instance Spree::State.find_country(params[:state_id])
+          else
+            render_instance Spree::Country.find(params[:id])
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/images_controller.rb

@@ -0,0 +1,29 @@
+module Spree
+  module Api
+    module V2
+      class ImagesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection images.includes(:viewable)
+        end
+
+        def show
+          render_instance images.find(params[:id])
+        end
+
+        private
+
+        def images
+          if params[:product_id]
+            Spree::Product.find(params[:product_id]).images
+          elsif params[:variant_id]
+            Spree::Variant.find(params[:variant_id]).images
+          else
+            Spree::Image
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/line_items_controller.rb

@@ -0,0 +1,36 @@
+module Spree
+  module Api
+    module V2
+      class LineItemsController < Spree::Api::V2::BaseController
+        rescue_from ActiveRecord::RecordNotFound, with: :render_record_not_found_error
+        rescue_from ActiveRecord::RecordInvalid, with: :render_record_invalid_error
+        rescue_from RangeError, with: :render_range_error
+
+        def create
+          variant = Spree::Variant.find(line_item_params[:variant_id])
+          order = @current_api_user.orders.find(line_item_params[:order_id])
+          line_item = order.contents.add(variant, line_item_params[:quantity])
+          render_instance line_item
+        end
+
+        private
+
+        def line_item_params
+          params.require(:line_item).permit(:variant_id, :order_id, :quantity)
+        end
+
+        def render_range_error
+          render json: error_response(:quantity_too_high), status: 400
+        end
+
+        def render_record_invalid_error
+          render json: error_response(:product_out_of_stock), status: 400
+        end
+
+        def render_record_not_found_error
+          render json: error_response(:record_not_found), status: 400
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/option_types_controller.rb

@@ -0,0 +1,31 @@
+module Spree
+  module Api
+    module V2
+      class OptionTypesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection option_types.includes(:option_values, :products)
+        end
+
+        def show
+          if params[:option_value_id]
+            render_instance Spree::OptionValue.find(params[:option_value_id]).option_type
+          else
+            render_instance option_types.find(params[:id])
+          end
+        end
+
+        private
+
+        def option_types
+          if params[:product_id]
+            Spree::Product.find(params[:product_id]).option_types
+          else
+            Spree::OptionType
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/option_values_controller.rb

@@ -0,0 +1,29 @@
+module Spree
+  module Api
+    module V2
+      class OptionValuesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection option_values.includes(:option_type, :variants)
+        end
+
+        def show
+          render_instance option_values.find(params[:id])
+        end
+
+        private
+
+        def option_values
+          if params[:option_type_id]
+            Spree::OptionType.find(params[:option_type_id]).option_values
+          elsif params[:variant_id]
+            Spree::Variant.find(params[:variant_id]).option_values
+          else
+            Spree::OptionValue
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/orders_controller.rb

@@ -0,0 +1,11 @@
+module Spree
+  module Api
+    module V2
+      class OrdersController < Spree::Api::V2::BaseController
+        def show
+          render_instance @current_api_user.orders.find(params[:id])
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/prices_controller.rb

@@ -0,0 +1,27 @@
+module Spree
+  module Api
+    module V2
+      class PricesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user
+
+        def index
+          render_collection params[:variant_id] ? prices : prices.includes(:variant)
+        end
+
+        def show
+          render_instance prices.find(params[:id])
+        end
+
+        private
+
+        def prices
+          if params[:variant_id]
+            Spree::Variant.find(params[:variant_id]).prices
+          else
+            Spree::Price
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/products_controller.rb

@@ -0,0 +1,37 @@
+module Spree
+  module Api
+    module V2
+      class ProductsController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection products.includes :variants, :master, :taxons, :option_types, master: :images
+        end
+
+        def show
+          if params[:price_id]
+            render_instance Spree::Price.find(params[:price_id]).product
+          elsif params[:variant_id]
+            render_instance Spree::Variant.find(params[:variant_id]).product
+          elsif params[:image_id]
+            render_instance Spree::Image.variants.find(params[:image_id]).viewable.product
+          else
+            render_instance products.find(params[:id])
+          end
+        end
+
+        private
+
+        def products
+          if params[:taxon_id].present?
+            Spree::Taxon.find(params[:taxon_id]).products
+          elsif params[:option_type_id]
+            Spree::OptionType.find(params[:option_type_id]).products
+          else
+            Spree::Product
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/states_controller.rb

@@ -0,0 +1,29 @@
+module Spree
+  module Api
+    module V2
+      class StatesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user
+
+        def index
+          render_collection states
+        end
+
+        def show
+          render_instance states.find(params[:id])
+        end
+
+        private
+
+        def states
+          @states ||= begin
+            if params[:country_id].present?
+              Spree::Country.find(params[:country_id]).states.includes(:country)
+            else
+              Spree::State.includes(:country)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/taxonomies_controller.rb

@@ -0,0 +1,21 @@
+module Spree
+  module Api
+    module V2
+      class TaxonomiesController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection Spree::Taxonomy.includes(:taxons)
+        end
+
+        def show
+          if params[:taxon_id].present?
+            render_instance Spree::Taxon.find(params[:taxon_id]).taxonomy
+          else
+            render_instance Spree::Taxonomy.find(params[:id])
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/spree/api/v2/taxons_controller.rb

@@ -0,0 +1,40 @@
+module Spree
+  module Api
+    module V2
+      class TaxonsController < Spree::Api::V2::BaseController
+        skip_before_action :authenticate_user, only: [:index, :show]
+
+        def index
+          render_collection taxons
+        end
+
+        def show
+          render_instance taxon
+        end
+
+        private
+
+        def taxon
+          if params[:taxon_id].present?
+            taxons.includes(parent: taxon_associations).find(params[:taxon_id]).parent
+          else
+            taxons.find(params[:id])
+          end
+        end
+
+        def taxons
+          if params[:taxonomy_id].present?
+            Spree::Taxonomy.find(params[:taxonomy_id]).taxons
+              .includes(*taxon_associations.-([:taxonomy]))
+          else
+            Spree::Taxon.includes(*taxon_associations)
+          end
+        end
+
+        def taxon_associations
+          [:products, :taxonomy, :parent]
+        end
+      end
+    end
+  end
+end