moysklad 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d4466dae399f6e8ec4819ce0c42eb53c9efafb6
-  data.tar.gz: 6652461f2c0a089662cbe54e608da6f9e500e6a1
+  metadata.gz: 0434de2e989bb1cb0ca34205101ee8c0e978540b
+  data.tar.gz: ccd6cc1de782b6baf31c331b7e20fe9d7a5c5698
 SHA512:
-  metadata.gz: 8400a264b733e8eb015d072de499eb6f0896e15a6b1f7d2f095d5c2bc9968c23ce6710db3853b08e1a916b025267c21277dc6a7a16bebf4ff5c4cf57cc29d121
-  data.tar.gz: 32ba29c475f85b439b3f5239225c854762c93988d80d332112d163b02a7a7103ead308a1458ad964f555db63f394e5223780aad79a7bd798a5d5fefb3b6ad812
+  metadata.gz: 9beac30a1c510af7d1aff68e5a24ede6d24ec6cf86fdee7486e0e6826c5410a9b0212523ea649076f6575935af3c7ad751c01c58f78e086a54f77cdc9bd9970b
+  data.tar.gz: cf62d29570bae5e6f4dfae85ee1ca4f283a55a95e28a7b898c1f2bb768d530a011aaae5f72b5ec9a9880b66d310f197788861e62e08ce835e2f9276c3276090c

data/.gitignore

@@ -1,4 +1,5 @@
 *.gem
+.byebug_history
 *.rbc
 tags
 gems.tags

data/.travis.yml

@@ -2,3 +2,4 @@ language: ruby
 rvm:
   - 2.0.0
   - 2.1.0
+  - 2.2.0

data/README.md

@@ -1,8 +1,8 @@
 #  Ruby-клиент для REST XML API Moysklad
 
-[![Build Status](https://travis-ci.org/BrandyMint/moysklad.svg)](https://travis-ci.org/BrandyMint/moysklad)
+[![Build Status](https://travis-ci.org/BrandyMint/moysklad.svg)](https://travis-ci.org/dapi/moysklad)
 [![Dependency Status](https://www.versioneye.com/user/projects/548225818674a4b5b90004dd/badge.svg?style=flat)](https://www.versioneye.com/user/projects/548225818674a4b5b90004dd)
-[![Code Climate](https://codeclimate.com/github/BrandyMint/moysklad/badges/gpa.svg)](https://codeclimate.com/github/BrandyMint/moysklad)
+[![Code Climate](https://codeclimate.com/github/dapi/moysklad/badges/gpa.svg)](https://codeclimate.com/github/dapi/moysklad)
 
 * http://www.rubydoc.info/gems/moysklad
 
@@ -12,8 +12,9 @@
 * Все используемые сущности описаны и структурированы. Например [Good](lib/moysklad/entities/good.rb)
 * Любые действия с ресурсами (Create, Read, Update, Delete, List).
 * Виртуальные действия с ресурсами (`where`, `findWhere`)
+* Автоматическая подгрузка списка если все данные не уместились в один запрос (метод `all`)
 * _Кеширование и предзагрузка_ ресурса со всеми записями (используем ресурс как локальную базу)
-* Работа с нескольмими аккаунтами на склада одновременно (отсуствие глобальных переменных).
+* Работа с нескольмими аккаунтами склада одновременно (отсуствие глобальных переменных).
 * Удобная работа с подресурсами (например справочником свойств товара)
 * _Ассоциации_ между сущностями автоматически получают данные по API (`good.features`).
 * [Client](lib/moysklad/client.rb) для прямого обращения к API в случае крайней необходимости.
@@ -282,10 +283,20 @@ dictionary.entities(universe)
 
     > MS_LOGON=логин MS_PASSWORD=пароль ./script/rest.sh Country list > ./spec/fixtures/Country_list.raw
 
+Если получаете 429 ошибку (too many requests) - лимит обращений по API от одного
+аккаунта - 5 или 10 запросов в секунду (в секунду, Карл). Если не превышать его,
+все будет хорошо - минутных или часовых лимитов нет.
+
 ## Ссылочки
 
 * Картапамяти по API http://www.mindmeister.com/246618635/online-moysklad-ru
 * Документация для разработчииков https://support.moysklad.ru/hc/ru/sections/200561443-Разработчикам
+* Неплохая схема API в json https://gist.github.com/dapi/22a0790db19a4ff51a37
+
+## Другие биллиотеки
+
+* PHP https://github.com/Tooyz/moysklad
+* JavaScript/nodejs https://github.com/wmakeev/moysklad-client
 
 ## Присылайте пул-реквесты )
 

data/lib/moysklad.rb

@@ -1,4 +1,4 @@
-require 'happymapper'
+require 'virtus'
 require 'active_support'
 require "moysklad/version"
 
@@ -8,7 +8,8 @@ module Moysklad
   mattr_accessor :custom_logger
   extend ActiveSupport::Autoload
 
-  autoload :Entities
+  require_relative 'moysklad/entities'
+  autoload :Error
   autoload :Resources
   autoload :Client
   autoload :Universe

data/lib/moysklad/client.rb

@@ -4,31 +4,55 @@ require_relative 'client/errors'
 
 class Moysklad::Client
 
-  URL = 'https://online.moysklad.ru'
+  # URL = 'https://online.moysklad.ru'
+  URL  ='https://online.moysklad.ru/api/remap/1.1/'
 
   def initialize login: nil, password: nil
     @client = Faraday.new URL
     @client.basic_auth login, password
   end
 
+  def download(path, filename)
+    response = client.get path
+    File.open(filename, 'wb') { |fp| fp.write(response.body) }
+  end
+
   def get path, params={}
     logger.debug "Client: GET #{path} #{params}"
-    validate client.get path, params
+    parse_response client.get path, params
+  end
+
+  def post path, data
+    logger.debug "Client: POST #{path}"
+    result = client.post do |req|
+      req.url path
+      req.headers['Content-Type'] = 'application/json'
+      req.headers['Accept'] = '*/*'
+      puts data
+      req.body = data
+    end
+    parse_response result
   end
 
   def put path, data
     logger.debug "Client: PUT #{path}"
     result = client.put do |req|
       req.url path
-      req.headers['Content-Type'] = 'application/xml'
+      req.headers['Content-Type'] = 'application/json'
       req.headers['Accept'] = '*/*'
       req.body = data
     end
-    validate result
+    parse_response result
   end
 
   def delete path
-    validate client.delete path
+    logger.debug "Client: DELETE #{path}"
+    result = client.delete do |req|
+      req.url path
+      req.headers['Content-Type'] = 'application/json'
+      req.headers['Accept'] = '*/*'
+    end
+    parse_response result
   end
 
   private
@@ -39,10 +63,13 @@ class Moysklad::Client
     Moysklad.logger
   end
 
-  def validate res
-    return res.body if res.status == 200
-
-    Moysklad::Client::Errors.build res
+  def parse_response res
+    if res.status == 200
+      Moysklad.logger.info "Response: #{res.body}"
+      return if res.body.blank?
+      JSON.parse res.body
+    else
+      Moysklad::Client::Errors.build res
+    end
   end
-
 end

data/lib/moysklad/client/errors.rb

@@ -1,23 +1,44 @@
 class Moysklad::Client
   class Errors
     def self.build res
-      Moysklad.logger.warn "Moyskad::Client: #{res.status}: #{res.env.url.to_s}\n#{res.body}"
+      body = res.body.force_encoding('utf-8')
+      content_type = res.headers['content-type']
+
+      if content_type.start_with? 'application/json'
+        # ok
+      elsif content_type.start_with? 'text/html'
+        raise HtmlParsedError, body
+      else
+        raise UnknownError, body
+      end
+
+      # Encoding::UndefinedConversionError
+      # "\xD0" from ASCII-8BIT to UTF-8
+      begin
+        body = JSON.parse body
+        Moysklad.logger.debug "Moysklad::Client: #{res.status}: #{res.headers}, #{res.env.url.to_s}\n#{body}"
+      rescue Encoding::UndefinedConversionError => err
+        Moysklad.logger.error "#{err}"
+      rescue JSON::ParserError => err
+        Moysklad.logger.error "#{err}: #{res.headers}, body:#{body}"
+        raise ParsingError, body
+      end
 
       case res.status
-      when 401 
-        raise UnauthorizedError.new res
+      when 401
+        raise UnauthorizedError.new body
       when 403
-        raise ResourceForbidden.new res
-      when 404 
-        raise NoResourceFound.new res.body
-      when 405
-        raise MethodNotAllowedError.new res
+        raise ResourceForbidden.new body
+      when 404
+        raise NoResourceFound.new body
+      when 405, 412
+        raise MethodNotAllowedError.new body
       when 500
-        raise InternalServerError.new res
+        raise InternalServerError.new body
       when 502
-        raise BadGatewayError.new res
-      else 
-        raise ParsedError.new res
+        raise BadGatewayError.new body
+      else
+        raise JsonParsedError.new body
       end
     end
   end
@@ -32,39 +53,48 @@ class Moysklad::Client
     end
 
     def to_s
-      message
+      message.to_s.encode('utf-8')
+      # <?xml version="1.0" encoding="UTF-8"?> <error> <uid>kiiiosk@wannabemoscow</uid> <moment>20150609112728449</moment> <message>������������ ���� ���������� �������� ������������.</message> </error>
+    rescue Encoding::CompatibilityError
+      message.to_s.force_encoding('cp1251').encode('utf-8')
     end
   end
+  class ParsingError < Error; end
+
+  class UnknownError < Error; end
 
   class NoResourceFound < Error; end
 
+  class JsonParsedError < Error
+    def initialize result
+      super result.to_json
+    end
+
+    attr_reader :error
+  end
+
   class HtmlParsedError < Error
-    def initialize res
-      @result  = res
-      @message = "[#{res.status}] #{parse_title res.body}"
+    def initialize body
+      @message = parse_title body
     end
 
     private
 
     def parse_title body
-      doc = Nokogiri::HTML body
-      # у ResourceForbidden есть <u>
-      # у wrong_password <u> несколько
-      # Можно ошибку разбирать более грамотно по свойствам type, message, description: http://i.gyazo.com/e9d5d08bd610882d87f39d9002cdf25a.png
-      [doc.css('body').css('h1').text,doc.css('body').css('u').to_a.map(&:text).compact.last].join('; ')
+      Nokogiri::HTML(body).css('body').text
     rescue => err
-      Moysklad.logger.debug "Moyskad::Client parse error #{err}: #{body}"
+      Moysklad.logger.debug "Moysklad::Client parse error #{err}: #{body}"
       body.force_encoding('utf-8')
     end
   end
 
-  class MethodNotAllowedError < HtmlParsedError
+  class MethodNotAllowedError < JsonParsedError
   end
 
-  class UnauthorizedError < HtmlParsedError
+  class UnauthorizedError < JsonParsedError
   end
 
-  class ResourceForbidden < HtmlParsedError
+  class ResourceForbidden < JsonParsedError
   end
 
   class ParsedError < Error
@@ -72,24 +102,24 @@ class Moysklad::Client
       @status = result.status
       @result = result
       case result.headers['content-type']
-        
+
       when /application\/xml/
         @error = Moysklad::Entities::Error.parse result.body
         @message = @error.message
       when /text\/html/
-        doc = Nokogiri::HTML body
+        doc = Nokogiri::HTML result.body
         @message = doc.css('body').css('h1').text
       else
         raise "Unknown content-type #{result.headers['content-type']} to parse error #{result.body}"
       end
     rescue => err
-      @message = "error in init #{err}: #{result.body}"
+      @message = "error in init #{err}: #{result}"
     end
 
     attr_reader :error
   end
 
 
-  class BadGatewayError < HtmlParsedError; end
-  class InternalServerError < ParsedError; end
+  class BadGatewayError < JsonParsedError; end
+  class InternalServerError < JsonParsedError; end
 end

data/lib/moysklad/entities.rb

@@ -1,46 +1,42 @@
 module Moysklad
   module Entities
     extend ActiveSupport::Autoload
-
-    autoload :XmlFix
-    autoload :CommonObject
-    autoload :CompanyConcern
-    autoload :Common
-
     %w{
-      Slot
+      AttachmentDocument
       Uom
-      Country
-      Contact
-      GoodFolder
-      Good
+      Productfolder
+      Product
+      Bundle
       Barcode
-      SalePrices
-      SalePrice
       Error
-      CustomerOrderPosition
       Consignment
       MyCompany
       Attribute
       GoodRef
       Base
+      Counterparty
+      Organization
       CustomerOrder
+      CustomerOrderPosition
       CustomEntity
-      CustomEntityMetadata
-      Feature
+      Variant
       AttributeMetadata
       EmbeddedEntityMetadata
+      CompanySettingsMetadata
       Price
-      PriceType
-      StockTO
+      Currency
       Company
-      Warehouse
+      Store
+      Service
+      Owner
+      Group
       Collection
-      CustomEntity
       Page
+      ResourceMetadata
+      Attribute
+      Characteristic
     }.each do |m|
       autoload m
     end
   end
-
 end

data/lib/moysklad/entities/assortment.rb

@@ -0,0 +1,6 @@
+require_relative 'entity'
+
+module Moysklad::Entities
+  class Assortment < Entity
+  end
+end

data/lib/moysklad/entities/attachment_document.rb

@@ -0,0 +1,16 @@
+module Moysklad::Entities
+  class AttachmentDocument < Base
+    include Moysklad::Entities::Common
+
+    tag 'file'
+
+    attribute :filename,       String
+    attribute :miniatureUuid,  String
+    attribute :name,           String
+
+    #def self.parse node, options
+      ## TODO create AttachmentDocument
+      #''
+    #end
+  end
+end

data/lib/moysklad/entities/attribute.rb

@@ -1,47 +1,124 @@
+require_relative 'attribute_value'
+require_relative 'meta'
+
+# Атрибут товара (ссылка на его тип и его значение)
 module Moysklad::Entities
   class Attribute < Base
-    include Moysklad::Entities::Common
+    attribute :meta, Meta
+    attribute :id, String
+    attribute :name, String
+    attribute :customEntityMeta, Meta
+    attribute :type, String #attributemetadata
+    attribute :value, AttributeValue
+    attribute :required, Boolean
 
-    tag 'attribute'
+    def to_s
+      "#{name} (#{type}): #{value}"
+    end
 
-    attribute :metadataUuid,    String
-    attribute :valueString,     String
-    attribute :valueText,       String
+    def is_dictionary?
+      type == 'customentity'
+    end
 
-    attribute :entityValueUuid, String
+    ### Если это свойство типа ID_CUSTOM, то возвращается пользовательский справочник
+    ###
+    ### @return Moysklad::Entities::CustomEntityMetadata
+    ##def dictionatyMetadata universe
+    ##raise "Это свойства не типа справочник" unless dictionaryMetadataUuid
+    ##universe.custom_entity_metadata.find dictionaryMetadataUuid
+    ##end
 
-    # Объект описывающий тип атритуба
-    #
-    # @return Moysklad::Entities::AttributeMetadata
-    #
-    def metadata universe
-      universe.embedded_entity_metadata.subresource_by_name(:GoodFolder).find metadataUuid
-    end
+    ### Справочник к которому принадлежит это ссвойство
+    ###
+    ### @return Moysklad::Entities::EmbeddedEntityMetadata
+    ##def entityMetadata universe
+    ##universe.embedded_entity_metadata.find entityMetadataUuid
+    ##end
 
-    # Название свойства, полученное из AttributeMetadata
-    #
-    # @return String
-    #
-    def attributeName universe
-      metadata(universe).name
-    end
 
-    # Значение свойства согласно его типу
-    #
-    # @return [String | Moysklad::Entities::CustomEntity | Integer | Decimal ]
-    def get_value universe
-      md = metadata universe
-      case md.attrType
-      when 'ID_CUSTOM'
-        universe.custom_entities.find( entityValueUuid ).name
-      when 'TEXT'
-        valueText
-      when 'STRING'
-        valueString
-        # TODO Другие типы
-      else
-        raise "Не известный тип мета-аттрибута #{md.uuid}: #{md.attrType}"
-      end
-    end
+    ### Объект описывающий тип атритуба
+    ###
+    ### @return Moysklad::Entities::AttributeMetadata
+    ###
+    ##def metadata universe
+    ##universe.embedded_entity_metadata.subresource_by_name(:GoodFolder).find metadataUuid
+    ##end
+
+    ### Название свойства, полученное из AttributeMetadata
+    ###
+    ### @return String
+    ###
+    ##def attributeName universe
+    ##metadata(universe).name
+    ##end
+
+    ### Значение свойства согласно его типу
+    ###
+    ### @return [String | Moysklad::Entities::CustomEntity | Integer | Decimal ]
+    #def get_value universe
+      #md = metadata universe
+      #case md.attrType
+      #when 'ID_CUSTOM'
+        #universe.custom_entities.find( entityValueUuid ).name
+      #when 'LINK'
+        #valueText
+      #when 'TEXT'
+        #valueText
+      #when 'STRING'
+        #valueString
+      #when 'DOUBLE'
+        #doubleValue
+      #when 'LONG'
+        #longValue
+      #when 'TIME'
+        #timeValue
+      #when 'FILE'
+        #file
+      #else
+        #raise "Не известный тип мета-аттрибута #{md.uuid}: #{md.attrType}"
+      #end
+    #end
+    ### Объект описывающий тип атритуба
+    ###
+    ### @return Moysklad::Entities::AttributeMetadata
+    ###
+    ##def metadata universe
+    ##universe.embedded_entity_metadata.subresource_by_name(:GoodFolder).find metadataUuid
+    ##end
+
+    ### Название свойства, полученное из AttributeMetadata
+    ###
+    ### @return String
+    ###
+    ##def attributeName universe
+    ##metadata(universe).name
+    ##end
+
+    ### Значение свойства согласно его типу
+    ###
+    ### @return [String | Moysklad::Entities::CustomEntity | Integer | Decimal ]
+    ##def get_value universe
+    ##md = metadata universe
+    ##case md.attrType
+    ##when 'ID_CUSTOM'
+    ##universe.custom_entities.find( entityValueUuid ).name
+    ##when 'LINK'
+    ##valueText
+    ##when 'TEXT'
+    ##valueText
+    ##when 'STRING'
+    ##valueString
+    ##when 'DOUBLE'
+    ##doubleValue
+    ##when 'LONG'
+    ##longValue
+    ##when 'TIME'
+    ##timeValue
+    ##when 'FILE'
+    ##file
+    ##else
+    ##raise "Не известный тип мета-аттрибута #{md.uuid}: #{md.attrType}"
+    ##end
+    ##end
   end
 end