freshdesk_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cba704113b86c43fdeab78e8cd4361dc661d1092
+  data.tar.gz: e839a871d07cd30b70810f1b072f1dce280bf7ea
+SHA512:
+  metadata.gz: dcb1084b51ccacb63daf5ea6389e2f950c0b054b1e68dd32cb9ce035a9d15f67e986b957401abc0131dde69df3bb75b812866ca67e674a57761f70a039c0b279
+  data.tar.gz: 1c02e24825451683e430ad138607db79412d6ec4fae42294a7b703272c8b1593aaba4258dfe857371241fc7cad6187516d22415e63e07e26da5bff4ad61600d6

data/.rspec

@@ -0,0 +1,3 @@
+--tty
+--colour
+--format <%= ENV["CI"] ? 'progress' : 'documentation'%>

data/.ruby-gemset

@@ -0,0 +1 @@
+freshdesk_api

data/.ruby-version

@@ -0,0 +1 @@
+ruby

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in freshdesk_api.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Anton Maminov
+
+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,97 @@
+# Freshdesk API Client
+
+
+A Ruby API client that interfaces with freshdesk.com web service. This client supports regular CRUD operation.
+
+Please see [API documentation](http://freshdesk.com/api) for more information.
+
+As of now,it supports the following:
+
+* Solution Category
+* Solution Folder
+* Solution Article
+
+
+To experiment with that code, run `bin/console` for an interactive prompt.
+
+## Installation
+
+The Freshdesk API client can be installd using Bundler or Rubygems.
+
+### Bundler
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'freshdesk_api'
+```
+
+And then execute:
+
+```
+$ bundle
+```
+
+### Rubygems
+
+Or install it yourself as:
+
+```
+$ gem install freshdesk_api
+```
+
+## Configuration
+
+Configuration is done through a block returning an instance of `FreshdeskAPI::Client`. The block is mandatory and if not passed, an `ArgumentError` will be thrown.
+
+```ruby
+require 'freshdesk_api'
+
+client = FreshdeskAPI::Client.new do |config|
+  config.base_url = '<- your-freshdesk-url ->' # e.g. 'https://mydesk.freshdesk.com'
+  config.username = 'login.email@freshdesk.com'
+  config.password = 'your freshdesk password'
+end
+```
+
+Note: This FreshdeskAPI API client only supports basic authentication at the moment.
+
+## Usage
+
+The result of configuration is an instance of `FreshdeskAPI::Client` which can then be used in two different methods.
+
+One way to use the client is to pass it in as an argument to individual classes.
+
+```ruby
+FreshdeskAPI::SolutionCategory.create!(client, name: 'API', description: 'API related documents')
+FreshdeskAPI::SolutionArticle.find!(client, id: 1, 1: category_id, folder_id: 1)
+FreshdeskAPI::SolutionFolder.update!(client, id: 1, category_id: 1, name: 'Folder API')
+FreshdeskAPI::SolutionArticle.destroy!(client, id: 1, category_id: 1, folder_id: 1)
+```
+Another way is to use the instance methods under client.
+
+```ruby
+categories = client.solution_categories
+category = categories.create!(name: 'API', description: 'API related documents')
+category.update!(name: 'API v2', description: 'API related documents v2')
+category = categories.find!(id: 1)
+category.destroy!
+```
+
+The methods under `FreshdeskAPI::Client` (such as `.solution_categories`) return an instance of `FreshdeskAPI::Collection` a lazy-loaded list of that resource.
+
+Actual requests may not be sent until an explicit `FreshdeskAPI::Collection#all!`.
+
+## 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.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/mamantoha/freshdesk_api_client_rb/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

data/Rakefile

@@ -0,0 +1,17 @@
+require 'rake/testtask'
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+rescue LoadError
+end
+
+if defined?(RSpec)
+  desc "Run specs"
+  RSpec::Core::RakeTask.new("spec") do |t|
+    t.pattern = "spec/core/**/*_spec.rb"
+  end
+
+  desc 'Default: run specs.'
+  task default: 'spec'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "freshdesk_api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.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/freshdesk_api.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'freshdesk_api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "freshdesk_api"
+  spec.version       = FreshdeskAPI::VERSION
+  spec.authors       = ["Anton Maminov"]
+  spec.email         = ["anton.linux@gmail.com"]
+
+  spec.summary       = %q{Freshdesk REST API Client}
+  spec.description   = %q{Ruby wrapper for the REST API at http://freshdesk.com. Documentation at http://freshdesk.com/api.}
+  spec.homepage      = "https://github.com/mamantoha/freshdesk_api_client_rb"
+
+  spec.required_ruby_version     = ">= 2.0.0"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "activesupport"
+  spec.add_runtime_dependency "rest-client"
+  spec.add_runtime_dependency "multi_json"
+  spec.add_runtime_dependency "deep_merge"
+
+  spec.add_development_dependency "byebug"
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "webmock"
+end

data/lib/freshdesk_api.rb

@@ -0,0 +1,3 @@
+module FreshdeskAPI; end
+
+require "freshdesk_api/client"

data/lib/freshdesk_api/actions.rb

@@ -0,0 +1,194 @@
+module FreshdeskAPI
+
+  module ResponseHandler
+    def handle_response(response)
+      response = MultiJson.load(response, symbolize_keys: true)
+      if response[response_namespace]
+        @attributes.replace(@attributes.deep_merge(response[response_namespace]))
+      end
+    end
+  end
+
+  module Read
+    def self.extended(klass)
+      klass.send(:include, ResponseHandler)
+    end
+
+    # Finds a resource by an id and any options passed in
+    # @param [Client] client The {Client} object to be used
+    # @param [Hash] option Any additional GET parameters to be added
+    def find!(client, options = {})
+      @client = client # so we can use client.logger in rescue
+      raise ArgumentError, 'No :id given' unless options[:id]
+
+      path = api_url(options) + "/#{options[:id]}"
+
+      response = client.make_request!(path, :get)
+
+      new(@client).tap do |resource|
+        resource.attributes.merge!(options)
+        resource.handle_response(response)
+      end
+    end
+
+    # Finds, returning nil if it fails
+    def find(client, options = {}, &block)
+      find!(client, options, &block)
+    rescue FreshdeskAPI::Error::ClientError => e
+      nil
+    end
+  end
+
+  module Save
+    include ResponseHandler
+
+    # If this resource hasn't been deleted, then create or save it.
+    # Executes a POST if it is a {Data#new_record?}, otherwise a PUT.
+    # @return [Resource] created or updated object
+    def save!(options = {})
+      return false if respond_to?(:destroyed?) && destroyed?
+
+      options = { request_namespace => attributes }
+
+      if new_record?
+        method = :post
+        req_path = api_url(options)
+      else
+        method = :put
+        req_path = api_url(options) + "/#{id}"
+      end
+
+      response = @client.make_request!(req_path, method, options)
+
+      handle_response(response)
+      return self
+    end
+
+    # Saves, returning false if it fails and attachibg the errors
+    def save(options = {}, &block)
+      save!(options, &block)
+    rescue FreshdeskAPI::Error::RecordInvalid => e
+      @errors = e.errors
+      false
+    rescue FreshdeskAPI::Error::ClientError
+      false
+    end
+  end
+
+  module Create
+    include Save
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      # Create a resource given the attributes passed in.
+      # @param [Client] client The {Client} object to be used
+      # @param [Hash] attributes The attributes to create.
+      def create!(client, attributes = {}, &block)
+        response = nil
+        new(client, attributes).tap do |resource|
+          response = resource.save!(&block)
+        end
+
+        response
+      end
+
+      # Create a resource, returning nil if it fails
+      def create(client, attributes = {}, &block)
+        create!(client, attributes, &block)
+      rescue FreshdeskAPI::Error::ClientError
+        nil
+      end
+    end
+  end
+
+  module Update
+    include Save
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    def update!(attributes = {})
+      self.attributes.merge!(attributes)
+      self.save!
+    end
+
+    def update(attributes = {})
+      update!(attributes = {})
+    rescue FreshdeskAPI::Error::ClientError
+      false
+    end
+
+    module ClassMethods
+      # Updates a resource given the id passed in
+      # @params [Client] client The {Client} object to be used
+      # @param [Hash] attributes The attributes to update. Default to {}
+      def update!(client, attributes = {}, &block)
+        response = nil
+        new(client, id: attributes.delete(:id)).tap do |resource|
+          resource.attributes.merge!(attributes)
+          response = resource.save!(&block)
+        end
+
+        response
+      end
+
+      # Updates a resource, returning nil if it fails
+      def update(client, attributes = {}, &block)
+        update!(client, attributes, &block)
+      rescue FreshdeskAPI::Error::ClientError
+        false
+      end
+    end
+  end
+
+  module Destroy
+    def self.included(klass)
+      klass.extend(ClassMethods)
+    end
+
+    # Has this object been deleted?
+    def destroyed?
+      @destroyed ||= false
+    end
+
+    # If this resource hasn't already been deleted, then do so.
+    # instance method
+    # @return [Boolean] Success?
+    def destroy!
+      return false if destroyed? || new_record?
+
+      path = api_url + "/#{id}"
+      @client.make_request!(path, :delete)
+
+      @destroyed = true
+    end
+
+    # instance method
+    def destroy
+      destroy!
+    rescue FreshdeskAPI::Error::ClientError
+      false
+    end
+
+    module ClassMethods
+      # Deteles a resource given the id passed in.
+      # @params [Client] client The {Client} object to be used
+      # @param [Hash] attributes The optional parameters to pass. Defaults to {}
+      def destroy!(client, attributes = {}, &block)
+        new(client, attributes).destroy!(&block)
+        true
+      end
+
+      def destroy(client, attributes = {}, &block)
+        destroy!(client, attributes, &block)
+      rescue FreshdeskAPI::Error::ClientError
+        false
+      end
+    end
+
+  end
+end

data/lib/freshdesk_api/client.rb

@@ -0,0 +1,113 @@
+require 'active_support/core_ext/string'
+require 'rest_client'
+require 'multi_json'
+require 'deep_merge'
+
+require 'freshdesk_api/version'
+require 'freshdesk_api/helpers'
+require 'freshdesk_api/configuration'
+require 'freshdesk_api/resource'
+require 'freshdesk_api/collection'
+require 'freshdesk_api/error'
+
+# Supported API resources
+require 'freshdesk_api/resources/solution_category'
+require 'freshdesk_api/resources/solution_folder'
+require 'freshdesk_api/resources/solution_article'
+
+module FreshdeskAPI
+  # The top-level class that handles configuration and connection to the Freshdesk API.
+  class Client
+    # @return [Configuration] Config instance
+    attr_reader :config
+
+    # Handles resources such as 'tickets'.
+    # @return [Collection] Collection instance for resource
+    def method_missing(method, *args, &block)
+      method = method.to_s
+      method_class = method_as_class(method)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+
+      FreshdeskAPI::Collection.new(self, method_class, options)
+    end
+
+    # Creates a new {Client} instance and yields {#config}.
+    #
+    # Requires a block to be given.
+    #
+    # Does basic configuration constraints:
+    # * {Configuration#base_url} must be https unless {Configuration#allow_http} is set.
+    def initialize
+      raise ArgumentError, 'block not given' unless block_given?
+
+      @config = FreshdeskAPI::Configuration.new
+
+      yield config
+
+      check_url
+      set_default_logger
+    end
+
+    # Creates a connection if there is none, otherwise returns the existing connection.
+    #
+    # @return [RestClient::Resouce] RestClient connection for the client
+    def connection
+      @connection ||= build_connection
+    end
+
+    def make_request!(path, method, options = {})
+      response = nil
+      connection[path].send(method, options) { |resp, req, result|
+        case resp.code
+        when 302
+          # Connection to the server failed. Please check username/password
+        when 404
+          raise Error::ResourceNotFound
+        when 406
+          raise Error::NotAcceptable
+        when 400...600
+          raise Error::NetworkError
+        end
+        response = resp
+      }
+      return response
+    rescue Exception => e
+      raise Error::ClientError.new(e)
+    end
+
+    protected
+
+    # Called by {#connection} to build a connection.
+    #
+    # Request logger if logger is not nil
+    def build_connection
+      RestClient::Resource.new(config.base_url, config.options.merge(auth_options))
+    end
+
+    # HTTP Basic Authentication credentials
+    def auth_options
+      { user: config.username, password: config.password }
+    end
+
+    private
+
+    def method_as_class(method)
+      klass_as_string = ("FreshdeskAPI::" + method.to_s.singularize.classify).constantize
+    end
+
+    def check_url
+      if !config.allow_http && config.base_url !~ /^https/
+        raise ArgumentError, "freshdesk_api is ssl only; url must begin with https://"
+      end
+    end
+
+    def set_default_logger
+      if config.logger.nil? || config.logger == true
+        require 'logger'
+        config.logger = Logger.new($stderr)
+        config.logger.level = Logger::WARN
+      end
+    end
+
+  end
+end

data/lib/freshdesk_api/collection.rb

@@ -0,0 +1,89 @@
+module FreshdeskAPI
+  # Represents a collection of resources
+  class Collection
+    attr_reader :resources
+    attr_reader :resource_class
+
+    # Creates a new Collection instance. Does not fetch resources.
+    # @param [Client] client The {Client} to use.
+    # @param [String] resource The resource being collected.
+    # @param [Hash] options Any additional options to be passed in.
+    def initialize(client, resource, options = {})
+      @client = client
+      @resource_class = resource
+      @resource = resource.resource_name
+      @options = options
+
+      methods = %w{ create find update destroy }
+      methods += methods.map { |method| method + '!' }
+      methods.each do |deferrable|
+        # Passes arguments and the proper path to the resource class method.
+        # @param [Hash] options Options or attributes to pass
+        define_singleton_method deferrable do |*args|
+          unless @resource_class.respond_to?(deferrable)
+            raise NoMethodError.new("undefined method \"#{deferrable}\" for #{@resource_class}", deferrable, args)
+          end
+
+          opts = args.last.is_a?(Hash) ? args.pop : {}
+          @resource_class.send(deferrable, @client, opts)
+        end
+      end
+
+    end
+
+    # The API path to this collection
+    def path
+      @resource_class.api_url(@options)
+    end
+
+    # Execute actual GET from API and load resources into proper class.
+    # # @return [Array] All resource
+    def all!(options = {})
+      @options.merge!(options)
+
+      response = get_response(path)
+      handle_response(response.body)
+
+      @resources
+    end
+
+    def get_response(path)
+      @client.connection[path].send(:get, @options)
+    end
+
+    def handle_response(response_body)
+      results = MultiJson.load(response_body, symbolize_keys: true)
+
+      if results.is_a?(Hash)
+        results = FreshdeskAPI::Helpers.deep_hash_access(results, @resource_class.collection_namespace)
+      elsif results.is_a?(Array)
+        results = results.map { |r| r[@resource_class.collection_namespace.to_sym] }
+      else
+        raise "Expected a Hash or Array for response body, got #{result.inspect}"
+      end
+
+      @resources = results.map do |res|
+        wrap_resource(res)
+      end
+    end
+
+    def wrap_resource(res)
+      @resource_class.new(@client, res)
+    end
+
+    # @private
+    def to_s
+      if @resources
+        @resources.inspect
+      else
+        inspect = []
+        inspect << "options=#{@options.inspect}" if @options.any?
+        "#{@resource.singularize} collection [#{inspect.join(',')}]"
+      end
+
+    end
+    alias :inspect :to_s
+
+  end
+
+end

data/lib/freshdesk_api/configuration.rb

@@ -0,0 +1,51 @@
+module FreshdeskAPI
+  # Holds the configuration options for the client and connection
+  class Configuration
+    # @return [String] The basic auth username
+    attr_accessor :username
+
+    # @return [String] The basic auth password.
+    attr_accessor :password
+
+    # @return [String] The basic auth token.
+    attr_accessor :apitoken
+
+    # @return [String] The API url. Must be https unless {#allow_http} is set.
+    attr_accessor :base_url
+
+    # @return [Logger] Logger to use when logging requests.
+    attr_accessor :logger
+
+    # @return [Hash] Client configurations
+    attr_accessor :client_options
+
+    # @return [Boolean] Whether to allow non-HTTPS connections for development purposes.
+    attr_accessor :allow_http
+
+    # :read_timeout and :open_timeout are how long to wait for a response and
+    # to open a connection, in seconds. Pass nil to disable the timeout.
+    attr_accessor :open_timeout
+    attr_accessor :read_timeout
+
+    def initialize
+      @client_options = {}
+    end
+
+    # Sets accept and user_agent headers, and url
+    #
+    # @return [Hash] RestClient-formatted hash of options.
+    def options
+      {
+        headers: {
+          accept: :json,
+          content_type: :json,
+          accept_encoding: 'gzip ,deflate',
+          user_agent: "FreshdeskAPI API #{FreshdeskAPI::VERSION}"
+        },
+        read_timeout: nil,
+        open_timeout: nil,
+        base_url: @base_url
+      }.merge(client_options)
+    end
+  end
+end

data/lib/freshdesk_api/error.rb

@@ -0,0 +1,23 @@
+module FreshdeskAPI
+  module Error
+    class ClientError < StandardError; end
+
+    class RecordInvalid < ClientError
+      attr_accessor :response, :errors
+
+      def initialize(response)
+        @response = response
+        binding.pry
+      end
+
+      def to_s
+        "#{self.class.name}: #{@errors.to_s}"
+      end
+    end
+
+    class NotAcceptable < ClientError; end
+    class ResourceNotFound < ClientError; end
+    class NetworkError < ClientError; end
+
+  end
+end

data/lib/freshdesk_api/helpers.rb

@@ -0,0 +1,16 @@
+module FreshdeskAPI
+  # @private
+  module Helpers
+    def self.deep_hash_access(hash, path)
+      path.split('/').each do |p|
+        if p.to_i.to_s == p
+          hash = hash[p.to_i]
+        else
+          hash = hash[p.to_s] || hash[p.to_sym]
+        end
+        break unless hash
+      end
+      hash
+    end
+  end
+end

data/lib/freshdesk_api/resource.rb

@@ -0,0 +1,80 @@
+require 'freshdesk_api/actions'
+
+module FreshdeskAPI
+  # Represents a resource that only holds data.
+  class Data
+    # @return [Hash] The resource's attributes
+    attr_reader :attributes
+
+    # @return [Array] The last received errors
+    attr_accessor :errors
+
+    class << self
+      # The singular resource name taken from the class name (e.g. FreshdeskAPI::SoulutionCategory -> solution_category)
+      def singular_resource_name
+        @singular_respurce_name ||= to_s.split('::').last.underscore
+
+      end
+
+      # The resource name taken from the class name (e.g. FreshdeskAPI::SolutionCatogory -> solution_categories)
+      def resource_name
+        @resource_name ||= singular_resource_name.pluralize
+      end
+    end
+
+    # Create a new resource instance.
+    # @param [Client] client The client to use
+    # @param [Hash] attributes The optional attributes that describe the resource
+    def initialize(client, attributes = {})
+      raise "Expected a Hash for attributes, got #{attributes.inspect}" unless attributes.is_a?(Hash)
+      @client = client
+      @attributes = attributes
+    end
+
+    # Returns the resource id of the object or nil
+    def id
+      attributes.key?(:id) ? attributes[:id] : nil
+    end
+
+    # Has this been object been created server-side? Does this by checking for an id.
+    def new_record?
+      id.nil?
+    end
+
+    # @private
+    def to_s
+      "#{self.class.singular_resource_name}: #{attributes.inspect}"
+    end
+    alias :inspect :to_s
+
+    # @private
+    def inspect
+      "#<#{self.class.name} #{@attributes.to_hash.inspect}>"
+    end
+
+    # Compares resources by class and id. If id is nil, then by object_id
+    def ==(other)
+      return true if other.object_id == self.object_id
+
+      if other && !other.is_a?(Data)
+        warn "Trying to compare #{other.class} to a Resource from #{caller.first}"
+      end
+
+      if other.is_a?(Data)
+        other.id && other.id == id
+      else
+        false
+      end
+    end
+
+  end
+
+  # Represents a resource that can CRUD (create, read, update, destroy)
+  class Resource < Data
+    include Create
+    extend  Read
+    include Update
+    include Destroy
+  end
+
+end

data/lib/freshdesk_api/resources/solution_article.rb

@@ -0,0 +1,31 @@
+require 'freshdesk_api/resource'
+
+module FreshdeskAPI
+  class SolutionArticle < Resource
+    # Need to specify the category_id and folder_id in url
+
+    def api_url(options = {})
+      "/solution/categories/%{category_id}/folders/%{folder_id}/articles" % attributes
+    end
+
+    def request_namespace
+      'solution_article'
+    end
+
+    def response_namespace
+      :article
+    end
+
+    class << self
+      def api_url(options = {})
+        "/solution/categories/%{category_id}/folders/%{folder_id}/articles" % options
+      end
+
+      def collection_namespace
+        'folder/articles'
+      end
+
+    end
+
+  end
+end

data/lib/freshdesk_api/resources/solution_category.rb

@@ -0,0 +1,29 @@
+require 'freshdesk_api/resource'
+
+module FreshdeskAPI
+  class SolutionCategory < Resource
+    def api_url(options = {})
+      "/solution/categories"
+    end
+
+    def request_namespace
+      'solution_category'
+    end
+
+    def response_namespace
+      :category
+    end
+
+
+    class << self
+      def api_url(options = {})
+        "/solution/categories"
+      end
+
+      def collection_namespace
+        'category'
+      end
+    end
+
+  end
+end

data/lib/freshdesk_api/resources/solution_folder.rb

@@ -0,0 +1,31 @@
+require 'freshdesk_api/resource'
+
+module FreshdeskAPI
+  class SolutionFolder < Resource
+    # Need to specify category_id in url
+
+    def api_url(options = {})
+      "/solution/categories/%{category_id}/folders" % attributes
+    end
+
+    def request_namespace
+      'solution_folder'
+    end
+
+    def response_namespace
+      :folder
+    end
+
+    class << self
+      def api_url(options = {})
+        "/solution/categories/%{category_id}/folders" % options
+      end
+
+      def collection_namespace
+        'category/folders'
+      end
+
+    end
+
+  end
+end

data/lib/freshdesk_api/version.rb

@@ -0,0 +1,3 @@
+module FreshdeskAPI
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,193 @@
+--- !ruby/object:Gem::Specification
+name: freshdesk_api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Anton Maminov
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-05-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: deep_merge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper for the REST API at http://freshdesk.com. Documentation
+  at http://freshdesk.com/api.
+email:
+- anton.linux@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- freshdesk_api.gemspec
+- lib/freshdesk_api.rb
+- lib/freshdesk_api/actions.rb
+- lib/freshdesk_api/client.rb
+- lib/freshdesk_api/collection.rb
+- lib/freshdesk_api/configuration.rb
+- lib/freshdesk_api/error.rb
+- lib/freshdesk_api/helpers.rb
+- lib/freshdesk_api/resource.rb
+- lib/freshdesk_api/resources/solution_article.rb
+- lib/freshdesk_api/resources/solution_category.rb
+- lib/freshdesk_api/resources/solution_folder.rb
+- lib/freshdesk_api/version.rb
+homepage: https://github.com/mamantoha/freshdesk_api_client_rb
+licenses: []
+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.6
+signing_key: 
+specification_version: 4
+summary: Freshdesk REST API Client
+test_files: []
+has_rdoc: