versacommerce-theme_api_client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 990ff9457b19aff2773db59aa619d9a7a96879c6
+  data.tar.gz: 5a23a121d1f16b738575552839d33fab9f98197e
+SHA512:
+  metadata.gz: ea312975266e5522796eec6c7ff332627678e0b928c7651a8ffc51526b58b88a1a54c17c7d80429b56a3518fec70b24bc54050119d147209567b10061870cce5
+  data.tar.gz: 0d04b8c38e6a91098c97dabacc951b6fa6740f4b29b1b6cb451fb02ed3916ac87209ba2781f3550f8cfe23af990c69cf334f7eb1c6a669fe7df0853ecc782e7f

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 VersaCommerce
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,229 @@
+# Versacommerce::ThemeAPIClient
+
+[![Gem Version](https://badge.fury.io/rb/versacommerce-theme_api_client.svg)](http://badge.fury.io/rb/versacommerce-theme_api_client)
+
+Versacommerce::ThemeAPIClient is a library to consume the VersaCommerce Theme API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'versacommerce-theme_api_client'
+```
+
+And then execute:
+
+```sh
+$ bundle install
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install versacommerce-theme_api_client
+```
+
+## Usage
+
+Create a client object to work on:
+
+```ruby
+authorization = 'YOUR_AUTHORIZATION'
+client = Versacommerce::ThemeAPIClient.new(authorization: authorization)
+```
+
+The client object is tied to a single theme, depending on the authorization. You can get an authorization from your shop's admin section.
+
+### Working with Directories
+
+#### Finding Directories
+
+Calling `#directories` on the client object will get you a `DirectoryRelation` object that responds to `#each`. As it includes the `Enumerable` module, the following will get you an array of all directories:  
+
+```ruby
+directories = client.directories.to_a
+```
+
+If you want to get an array of a directory's child directories, call:
+
+```ruby
+directories = client.directories.in_path('path/to/directory').to_a
+```
+
+This is practically the same as calling:
+
+```ruby
+directories = client.directories(path: 'path/to/directory')
+```
+
+These calls are recursive and will return all directory children by default. If you don't want this behaviour and instead only get direct child directories, turn it off by calling:
+
+```ruby
+directories = client.directories(recursive: false)
+
+# respectively:
+directories = client.directories.in_path('', recursive: false)
+```
+
+#### Finding a single Directory
+
+If you want to find a single directory, call:
+```ruby
+directory = client.directories.find('path/to/directory')
+```
+
+Nesting with the relation is also possible. The following will try to find the directory `assets/font`:
+
+```ruby
+directory = client.directories(path: 'assets').find('font')
+```
+
+If the directory could be found, a `Directory` instance is returned, else a `RecordNotFoundError` is raised. A `Directory` instance has a `path` instance variable representing its path and responds to `#files`, which returns a `FileRelation` with the directory's path as base for the files.
+
+#### Creating a Directory
+
+In order to create a directory, use `#build` in combination with `#save` or use `#create`:
+
+```ruby
+directory = client.directories.build(path: 'special_font')
+directory.save # => true or false
+
+# which is basically the same as:
+directory = client.directories(path: 'assets/font').create(path: 'special_fonts')
+```
+
+If the directory could not be saved, `false` will be returned and the `directory.errors` object populated with the errors that occured.
+
+#### Updating a Directory
+
+Updating a directory is similar to creating one:
+
+```ruby
+directory.update(path: 'new/path')
+
+# which is basically the same as:
+directory.path = 'new/path'
+directory.save
+```
+
+#### Deleting a Directory
+
+Delete a directory by calling:
+
+```ruby
+directory.delete
+```
+
+If you don't want to prefetch a directory in order to delete it, there's also:
+
+```ruby
+client.directories.delete('path/to/directory')
+```
+
+### Working with Files
+
+#### Finding Files
+
+Working with files is like dealing with directories. You can retrieve all files by calling:
+
+```ruby
+files = client.files.to_a
+```
+
+This will return an array of all files. A significant difference between a directory and a file is that a file can have content. Finding files using the method described above won't load the files' contents though. Reloading the content is possible:
+
+```ruby
+file = client.files.to_a.first
+file.content # => nil
+
+file.reload_content
+file.content # => returns the content as String
+```
+
+Filtering files works like with a directory.
+
+```ruby
+files = client.files(path: 'assets').to_a
+
+# or
+files = client.files.in_path('assets').to_a
+```
+
+will return all files in (or below) the `assets` directory.
+
+#### Finding a single File
+
+```ruby
+file = client.files(path: 'assets').find('fonts/some_font.svg')
+```
+
+will find the file located at `assets/fonts/some_font.svg`. As this will be a text file, the content will be loaded automatically. If the file is an image (or any other file not in text format) the content will not be loaded. If you want to make sure the content is loaded, provide a `load_content` keyword argument:
+
+```ruby
+file = client.files.find('assets/images/banner.png', load_content: true)
+```
+
+or load the content afterwards manually if it is missing:
+
+```ruby
+file = client.files.find('assets/images/banner.png')
+file.reload_content unless file.has_content?
+```
+
+#### Creating a File
+
+In order to create a file, use `#build` in combination with `#save` or use `#create`:
+
+```ruby
+file = client.directories.build(path: 'assets/fonts/some_font.svg', content: 'content here')
+file.save # => true or false
+
+# which is basically the same as:
+file = client.directories.create(path: 'assets/font', content: 'content here')
+```
+
+If the file could not be saved, `false` will be returned and the `file.errors` object populated with the errors that occured.
+
+#### Updating a File
+
+Updating a file is similar to creating one:
+
+```ruby
+file.update(path: 'new/path', content: 'new content')
+
+# which is basically the same as:
+file.path = 'new/path'
+file.content = 'new content'
+file.save
+```
+
+#### Deleting a file
+
+Delete a file by calling:
+
+```ruby
+file.delete
+```
+
+If you don't want to prefetch a file in order to delete it, there's also:
+
+```ruby
+client.files.delete('path/to/file')
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+1. Fork it (https://github.com/versacommerce/versacommerce-theme_api_client/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## License
+
+[MIT](https://github.com/versacommerce/versacommerce-theme_api_client/blob/master/LICENSE.txt "MIT License").

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'versacommerce/theme_api_client'
+require 'pry'
+
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/versacommerce/theme_api_client/client.rb

@@ -0,0 +1,61 @@
+require 'theme_api_client/fetcher'
+require 'theme_api_client/resources/directory'
+require 'theme_api_client/relations/directory_relation'
+require 'theme_api_client/resources/file'
+require 'theme_api_client/relations/file_relation'
+require 'theme_api_client/version'
+
+module Versacommerce
+  class ThemeAPIClient
+    attr_accessor :authorization
+    attr_writer :base_url, :fetcher
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        public_send("#{key}=", value)
+      end
+
+      yield(self) if block_given?
+    end
+
+    def base_url
+      @base_url || 'https://theme-api.versacommerce.de'
+    end
+
+    def directories(path: '', recursive: true)
+      Relations::DirectoryRelation.new(self, path: path, recursive: recursive)
+    end
+
+    def directory_class
+      @directory_class ||= Class.new(Resources::Directory).tap { |dir| dir.client = self }
+    end
+
+    def files(path: '', recursive: true)
+      Relations::FileRelation.new(self, path: path, recursive: recursive)
+    end
+
+    def file_class
+      @file_class ||= Class.new(Resources::File).tap { |dir| dir.client = self }
+    end
+
+    def fetcher
+      @fetcher ||= Fetcher.new(self)
+    end
+
+    def directory_path(path = '')
+      Pathname.new('directories').join(path)
+    end
+
+    def file_path(path = '')
+      Pathname.new('files').join(path)
+    end
+
+    def download_path(path = '')
+      Pathname.new('download').join(path)
+    end
+
+    def tree_path(path = '')
+      Pathname.new('tree').join(path)
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/fetcher.rb

@@ -0,0 +1,101 @@
+require 'json'
+require 'http'
+require 'active_support/core_ext/module/delegation'
+
+module Versacommerce
+  class ThemeAPIClient
+    class Fetcher
+      RecordNotFoundError = Class.new(StandardError)
+      UnauthorizedError   = Class.new(StandardError)
+
+      delegate :authorization, to: :client
+
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      def get(path)
+        url = url_for_path(path)
+        response = with_headers.get(url)
+        handle_response(response, url)
+      end
+
+      def head(path)
+        url = url_for_path(path)
+        response = with_headers.head(url)
+        handle_response(response, url)
+      end
+
+      def post(path, json = {})
+        url = url_for_path(path)
+        response = with_headers.post(url_for_path(path), json: json)
+        handle_response(response, url)
+      end
+
+      def post_form(path, form_data = {})
+        url = url_for_path(path)
+        response = with_headers.post(url_for_path(path), form: form_data)
+        handle_response(response, url)
+      end
+
+      def patch(path, json = {})
+        url = url_for_path(path)
+        response = with_headers.patch(url_for_path(path), json: json)
+        handle_response(response, url)
+      end
+
+      def patch_form(path, form_data = {})
+        url = url_for_path(path)
+        response = with_headers.patch(url_for_path(path), form: form_data)
+        handle_response(response, url)
+      end
+
+      def delete(path = {})
+        url = url_for_path(path)
+        response = with_headers.delete(url)
+        handle_response(response, url)
+      end
+
+      private
+
+      def handle_response(response, url)
+        case response.status
+        when ->(s) { s.unauthorized? }
+          handle_unauthorized(response)
+        when ->(s) { s.not_found? }
+          raise RecordNotFoundError.new('Record for URL %s could not be found.' % url)
+        else
+          response
+        end
+      end
+
+      def handle_unauthorized(response)
+        if response.json.key?('error')
+          raise UnauthorizedError.new('Could not be authorized: %s' % response.json['error'])
+        else
+          raise UnauthorizedError.new('You could not be authorized.')
+        end
+      end
+
+      def url_for_path(path)
+        '%s/%s' % [client.base_url, path.to_s]
+      end
+
+      def with_headers
+        HTTP.with_headers(accept: 'application/json', 'Theme-Authorization' => authorization)
+      end
+    end
+  end
+end
+
+class HTTP::Response
+  def json
+    @json ||= if mime_type == 'application/json'
+      JSON.parse(to_s)
+    else
+      {}
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/relation.rb

@@ -0,0 +1,68 @@
+module Versacommerce
+  class ThemeAPIClient
+    class Relation
+      include Enumerable
+
+      attr_accessor :recursive
+      attr_reader :client, :path
+
+      def initialize(client, attributes = {})
+        @client = client
+
+        attributes.each do |key, value|
+          public_send("#{key}=", value)
+        end
+      end
+
+      def find(path, **options)
+        resource_class.find(combined_path(path), **options)
+      end
+
+      def in_path(path, **options)
+        tap do |relation|
+          relation.path = path
+          relation.recursive = options[:recursive] if options.key?(:recursive)
+        end
+      end
+
+      def build(attributes = {})
+        path = combined_path(attributes[:path])
+        resource_class.new(attributes.merge(path: path))
+      end
+
+      def create(attributes = {})
+        build(attributes).tap do |object|
+          object.save
+        end
+      end
+
+      def delete(path)
+        resource_class.delete(combined_path(path))
+      end
+
+      def each(&block)
+        files = resource_class.in_path(path, recursive)
+        files.each(&block)
+      end
+
+      def path=(value)
+        @path = case value
+        when Pathname
+          value
+        else
+          Pathname.new(value.gsub(/\A\/*/, ''))
+        end
+      end
+
+      def inspect
+        to_s
+      end
+
+      private
+
+      def combined_path(path)
+        self.path.join(path || '')
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/relations/directory_relation.rb

@@ -0,0 +1,13 @@
+require 'versacommerce/theme_api_client/relation'
+
+module Versacommerce
+  class ThemeAPIClient
+    module Relations
+      class DirectoryRelation < Relation
+        def resource_class
+          client.directory_class
+        end
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/relations/file_relation.rb

@@ -0,0 +1,13 @@
+require 'versacommerce/theme_api_client/relation'
+
+module Versacommerce
+  class ThemeAPIClient
+    module Relations
+      class FileRelation < Relation
+        def resource_class
+          client.file_class
+        end
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/resource.rb

@@ -0,0 +1,60 @@
+require 'active_model'
+require 'active_support/core_ext/module/delegation'
+
+module Versacommerce
+  class ThemeAPIClient
+    class Resource
+      include ActiveModel::Model
+      include ActiveModel::Dirty
+
+      class << self
+        attr_accessor :client
+        delegate :fetcher, to: :client
+      end
+
+      attr_writer :new_record
+
+      def initialize(attributes = {})
+        assign_attributes(attributes)
+        clear_changes_information unless new_record?
+      end
+
+      def assign_attributes(attributes = {})
+        attributes.each do |key, value|
+          public_send("#{key}=", value)
+        end
+      end
+
+      def save
+        if valid?(current_context) && commit
+          self.new_record = false
+          changes_applied
+          true
+        else
+          false
+        end
+      end
+
+      def update(attributes = {})
+        assign_attributes(attributes)
+        save
+      end
+
+      def new_record?
+        defined?(@new_record) ? @new_record : true
+      end
+
+      private
+
+      def add_errors(errors)
+        errors.each do |key, errors|
+          errors.each { |error| self.errors[key] << error }
+        end
+      end
+
+      def current_context
+        new_record? ? :create : :update
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/resources/directory.rb

@@ -0,0 +1,104 @@
+require 'active_support/core_ext/module/delegation'
+require 'versacommerce/theme_api_client/fetcher'
+require 'versacommerce/theme_api_client/resources/file_behaviour'
+require 'versacommerce/theme_api_client/relations/file_relation'
+require 'versacommerce/theme_api_client/resource'
+
+module Versacommerce
+  class ThemeAPIClient
+    module Resources
+      class Directory < Resource
+        include FileBehaviour
+
+        delegate :client, :fetcher, :directory_path, to: :class
+
+        class << self
+          delegate :fetcher, :directory_path, :tree_path, to: :client
+
+          def in_path(path = '', recursive = true)
+            recursive ? fetch_recursive(path) : fetch_non_recursive(path)
+          end
+
+          def find(path, **options)
+            fetcher.head(directory_path(path))
+            new(path: path, new_record: false)
+          end
+
+          def delete(path)
+            fetcher.delete(directory_path(path))
+            clear_changes_information
+            self.new_record = true
+          end
+
+          def model_name
+            ActiveModel::Name.new(self, nil, 'Directory')
+          end
+
+          private
+
+          def fetch_recursive(path)
+            directory = fetcher.get(tree_path(path)).json
+            directories_from_tree(directory)
+          end
+
+          def fetch_non_recursive(path)
+            fetcher.get(directory_path(path)).json['directories'].map do |directory|
+              new(directory.merge(new_record: false))
+            end
+          end
+
+          def directories_from_tree(directory, directories = [])
+            directories.tap do |dirs|
+              directory.each do |child|
+                if child['type'] == 'directory'
+                  dirs << new(child.slice('path').merge(new_record: false))
+                  directories_from_tree(child['children'], dirs)
+                end
+              end
+            end
+          end
+        end
+
+        def directories(recursive: false)
+          client.directories(path: path, recursive: recursive)
+        end
+
+        def files(recursive: false)
+          client.files(path: path, recursive: recursive)
+        end
+
+        def delete
+          unless new_record?
+            response = fetcher.delete(directory_path(path))
+            response.status.no_content?
+          end
+        end
+
+        def inspect
+          '#<Directory:0x%x>' % (object_id << 1)
+        end
+
+        private
+
+        def commit
+          response = if new_record?
+            fetcher.post(directory_path, serialized_attributes)
+          else
+            fetcher.patch(directory_path(path_was), serialized_attributes)
+          end
+
+          if response.status.unprocessable_entity?
+            add_errors(response.json['errors']) if response.json.key?('errors')
+            false
+          else
+            true
+          end
+        end
+
+        def serialized_attributes
+          {directory: {path: path.to_s}}
+        end
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/resources/file.rb

@@ -0,0 +1,135 @@
+require 'active_support/core_ext/module/delegation'
+require 'versacommerce/theme_api_client/fetcher'
+require 'versacommerce/theme_api_client/resources/file_behaviour'
+require 'versacommerce/theme_api_client/resource'
+
+module Versacommerce
+  class ThemeAPIClient
+    module Resources
+      class File < Resource
+        include FileBehaviour
+
+        delegate :client, :fetcher, :file_path, :download_path, to: :class
+        define_attribute_methods :content
+
+        class << self
+          delegate :fetcher, :file_path, :tree_path, :download_path, to: :client
+
+          def in_path(path = '', recursive = true)
+            recursive ? fetch_recursive(path) : fetch_non_recursive(path)
+          end
+
+          def find(path, load_content: false)
+            response = fetcher.get(file_path(path))
+            attributes = response.json
+
+            new(attributes.merge(new_record: false)).tap do |file|
+              file.reload_content if load_content && !file.has_content?
+            end
+          end
+
+          def delete(path)
+            fetcher.delete(file_path(path))
+            true
+          end
+
+          def model_name
+            ActiveModel::Name.new(self, nil, 'File')
+          end
+
+          private
+
+          def fetch_recursive(path)
+            directory = fetcher.get(tree_path(path)).json
+            files_from_tree(directory)
+          end
+
+          def fetch_non_recursive(path)
+            directory = fetcher.get(tree_path(path)).json
+
+            directory.map do |child|
+              if child['type'] == 'file'
+                new(child.slice('path', 'stats').merge(new_record: false))
+              end
+            end.compact
+          end
+
+          def files_from_tree(directory, files = [])
+            files.tap do |f|
+              directory.each do |child|
+                case child['type']
+                when 'directory'
+                  files_from_tree(child['children'], f)
+                when 'file'
+                  f << new(child.slice('path', 'content').merge(new_record: false))
+                end
+              end
+            end
+          end
+        end
+
+        attr_reader :content
+        attr_accessor :stats
+
+        def delete
+          unless new_record?
+            response = fetcher.delete(file_path(path))
+            content_will_change!
+            self.new_record = true
+          end
+        end
+
+        def content=(value)
+          unless value == @content
+            content_will_change!
+            @content = value.to_s
+          end
+        end
+
+        def has_content?
+          !!@content
+        end
+
+        def reload_content
+          unless new_record?
+            response = fetcher.get(download_path(path))
+            self.content = response.to_s
+            clear_attribute_changes(:content)
+          end
+
+          self
+        end
+
+        def inspect
+          '#<File:0x%x>' % (object_id << 1)
+        end
+
+        private
+
+        def commit
+          response = if new_record?
+            fetcher.post_form(file_path, serialized_attributes)
+          else
+            fetcher.patch_form(file_path(path_was), serialized_attributes)
+          end
+
+          if response.status.unprocessable_entity?
+            add_errors(response.json['errors']) if response.json.key?('errors')
+            false
+          else
+            true
+          end
+        end
+
+        def serialized_attributes
+          if has_content? && content_changed?
+            content_file = HTTP::FormData::File.new(StringIO.new(content), filename: name)
+            {'file[path]' => path.to_s, 'file[content]' => content_file}
+          else
+            {'file[path]' => path.to_s}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/resources/file_behaviour.rb

@@ -0,0 +1,36 @@
+require 'active_support/concern'
+
+module Versacommerce
+  class ThemeAPIClient
+    module Resources
+      module FileBehaviour
+        extend ActiveSupport::Concern
+
+        included do
+          define_attribute_method :path
+          attr_reader :path
+
+          validates :path, presence: true
+          validates :name, length: {in: 3..64}, if: proc { name.present? }
+        end
+
+        def path=(value)
+          path = Pathname.new(value.sub(/\A\/*/, ''))
+
+          unless path == @path
+            path_will_change!
+            @path = path
+          end
+        end
+
+        def name
+          path.basename.to_s
+        end
+
+        def ==(other)
+          other.kind_of?(self.class) && path == other.path
+        end
+      end
+    end
+  end
+end

data/lib/versacommerce/theme_api_client/version.rb

@@ -0,0 +1,5 @@
+module Versacommerce
+  class ThemeAPIClient
+    VERSION = Gem::Version.new('0.1.0')
+  end
+end

data/lib/versacommerce/theme_api_client.rb

@@ -0,0 +1,61 @@
+require 'versacommerce/theme_api_client/fetcher'
+require 'versacommerce/theme_api_client/resources/directory'
+require 'versacommerce/theme_api_client/relations/directory_relation'
+require 'versacommerce/theme_api_client/resources/file'
+require 'versacommerce/theme_api_client/relations/file_relation'
+require 'versacommerce/theme_api_client/version'
+
+module Versacommerce
+  class ThemeAPIClient
+    attr_accessor :authorization
+    attr_writer :base_url, :fetcher
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        public_send("#{key}=", value)
+      end
+
+      yield(self) if block_given?
+    end
+
+    def base_url
+      @base_url || 'https://theme-api.versacommerce.de'
+    end
+
+    def directories(path: '', recursive: true)
+      Relations::DirectoryRelation.new(self, path: path, recursive: recursive)
+    end
+
+    def directory_class
+      @directory_class ||= Class.new(Resources::Directory).tap { |dir| dir.client = self }
+    end
+
+    def files(path: '', recursive: true)
+      Relations::FileRelation.new(self, path: path, recursive: recursive)
+    end
+
+    def file_class
+      @file_class ||= Class.new(Resources::File).tap { |dir| dir.client = self }
+    end
+
+    def fetcher
+      @fetcher ||= Fetcher.new(self)
+    end
+
+    def directory_path(path = '')
+      Pathname.new('directories').join(path)
+    end
+
+    def file_path(path = '')
+      Pathname.new('files').join(path)
+    end
+
+    def download_path(path = '')
+      Pathname.new('download').join(path)
+    end
+
+    def tree_path(path = '')
+      Pathname.new('tree').join(path)
+    end
+  end
+end

data/versacommerce-theme_api_client.gemspec

@@ -0,0 +1,29 @@
+require_relative 'lib/versacommerce/theme_api_client/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'versacommerce-theme_api_client'
+  spec.version       = Versacommerce::ThemeAPIClient::VERSION
+  spec.authors       = ['Tobias Bühlmann']
+  spec.email         = ['buehlmann@versacommerce.de']
+
+  spec.summary       = 'API Client for the VersaCommercer Theme API.'
+  spec.description   = 'This Gem acts as an API Client for the VersaCommerce Theme API.'
+  spec.homepage      = 'https://github.com/versacommerce/versacommerce-theme_api_client'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(/\Aexe/) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_runtime_dependency 'http', '0.7.2'
+  spec.add_runtime_dependency 'activesupport', '~> 4.2'
+  spec.add_runtime_dependency 'activemodel', '~> 4.2'
+
+  spec.add_development_dependency 'bundler', '~> 1.8'
+  spec.add_development_dependency 'rake', '~> 10.4'
+  spec.add_development_dependency 'pry', '0.10.1'
+  spec.add_development_dependency 'pry-stack_explorer', '0.4.9.2'
+end

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: versacommerce-theme_api_client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tobias Bühlmann
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-03-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+- !ruby/object:Gem::Dependency
+  name: pry-stack_explorer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.4.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.4.9.2
+description: This Gem acts as an API Client for the VersaCommerce Theme API.
+email:
+- buehlmann@versacommerce.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/versacommerce/theme_api_client.rb
+- lib/versacommerce/theme_api_client/client.rb
+- lib/versacommerce/theme_api_client/fetcher.rb
+- lib/versacommerce/theme_api_client/relation.rb
+- lib/versacommerce/theme_api_client/relations/directory_relation.rb
+- lib/versacommerce/theme_api_client/relations/file_relation.rb
+- lib/versacommerce/theme_api_client/resource.rb
+- lib/versacommerce/theme_api_client/resources/directory.rb
+- lib/versacommerce/theme_api_client/resources/file.rb
+- lib/versacommerce/theme_api_client/resources/file_behaviour.rb
+- lib/versacommerce/theme_api_client/version.rb
+- versacommerce-theme_api_client.gemspec
+homepage: https://github.com/versacommerce/versacommerce-theme_api_client
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: API Client for the VersaCommercer Theme API.
+test_files: []