yandex-delivery 0.0.1 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91748eda3052b17b15c0ce0e8516329bd1b87e9d533ac9d14bbbb1c6ba81f636
-  data.tar.gz: f31f190ec14dc44f6fbfd34bfa3ec5cc48c99fc18eb9eb8d1e2d439da68ef97b
+  metadata.gz: 7a2fc2639ef507d2e4f38a0f344aadcf214f861ffd8a62cc628dd26f547b6c92
+  data.tar.gz: 1efaafc00e1454ea7df4cd58eac5eb5b35aca08fce8d3ac4ec0c94e3f3aa0c36
 SHA512:
-  metadata.gz: ee08aee6c2591bec0a92e7be892a2c3ea8a29a1d7979d1164a556f1e50ecb7ed91ca733d07792d8e26d57b5e7314be504df7a26034cc1cd5d54bb98bb4cb2b73
-  data.tar.gz: 4b88e75219b26960b6ef886b1f79392e4750b726169622250e817960b49fa069efbd4cceaca6a1dd0f212fee1fcb711174c4a8d65fd57e2e0bdb47aa32c1a7f6
+  metadata.gz: 66bd2349a7c9dcd081f5bc25ea0baab44121701386e2d281da43e8481ff632faaac800563ffe38682b23ad809110a31d1bb3b39ce3736eab8e37216bbebe0e9e
+  data.tar.gz: 63b9aa136866b19245b485a6843a7bf2f5b075986eb87cdca991ff05ffdf6c2f509ff102f216849a033d2737c2ba1134a4667fb6839c27f35d6f6717fa82cd1e

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Pavel Osetrov
+
+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.markdown

@@ -0,0 +1,254 @@
+# Yandex-delivery
+
+API wrapper для Яндекс.доставки [API](https://yandex.ru/dev/delivery-3/doc/dg/).
+
+## Установка Ruby
+
+    $ gem install yandex-delivery
+
+## Установка Rails
+
+добавьте в Gemfile:
+
+    gem 'yandex-delivery'
+
+и запустите `bundle install`.
+
+Затем:
+
+    rails g yandex_delivery:install
+
+## Требования
+
+Необходимо получить [токен авторизации](https://yandex.ru/dev/delivery-3/doc/dg/concepts/access.html).
+
+## Использование Rails
+
+В файл `config/yandex_delivery2.yml` вставьте ваши данные из настоек яндекс доставки и токен авторизации
+
+## Использование Ruby
+
+Сначала создайте экземпляр объекта `YandexDelivery::Request`:
+
+```ruby
+delivery = YandexDelivery::Request.new(api_key: "your_access_token")
+```
+
+Вы можете изменять `api_key`, `timeout`, `open_timeout`, `faraday_adapter`, `proxy`, `symbolize_keys`, `logger`, и `debug`:
+
+```ruby
+YandexDelivery::Request.api_key = "your_access_token"
+YandexDelivery::Request.timeout = 15
+YandexDelivery::Request.open_timeout = 15
+YandexDelivery::Request.symbolize_keys = true
+YandexDelivery::Request.debug = false
+```
+
+Либо в файле `config/initializers/yandex_delivery2.rb` для Rails.
+
+## Debug Logging
+
+Pass `debug: true` to enable debug logging to STDOUT.
+
+```ruby
+delivery = YandexDelivery::Request.new(api_key: "your_access_token", debug: true)
+```
+
+### Custom logger
+
+Ruby `Logger.new` is used by default, but it can be overrided using:
+
+```ruby
+delivery = YandexDelivery::Request.new(api_key: "your_access_token", debug: true, logger: MyLogger.new)
+```
+
+Logger can be also set by globally:
+
+```ruby
+YandexDelivery::Request.logger = MyLogger.new
+```
+
+## Примеры
+
+### Варианты доставки
+
+#### Поиск вариантов доставки
+
+```ruby
+# для Rails senderId указывать не обязательно, в запрос подставится значение из config/yandex_delivery2.yml
+body = {
+  :to=>{:location=>"Санкт-Петербург"}, 
+  :dimensions=>{:length=>1, :height=>1, :width=>1, :weight=>1}
+}
+
+YandexDelivery::Request.delivery_options.upsert(body: body)
+```
+
+#### Поиск пунктов выдачи заказов
+
+```ruby
+YandexDelivery::Request.pickup_points.upsert(body: {locationId: 2})
+```
+
+### Операции с заказами
+
+#### Создать черновик заказа
+
+```ruby
+response = YandexDelivery::Request.orders.create(body: {deliveryType: 'COURIER'})
+order_id = response.body
+```
+
+#### Обновить черновик заказа
+
+```ruby
+YandexDelivery::Request.orders(order_id).upsert(body: {deliveryType: 'PICKUP'})
+```
+
+#### Оформить заказ
+
+```ruby
+YandexDelivery::Request.orders.submit.create(body: {orderIds: [order_id]})
+```
+
+#### Получить данные о заказе
+
+```ruby
+response = YandexDelivery::Request.orders(order_id).retrieve
+order = response.body
+```
+
+#### Удалить заказ
+
+```ruby
+YandexDelivery::Request.orders(order_id).delete
+```
+
+#### Получить ярлык заказа
+
+```ruby
+YandexDelivery::Request.orders(order_id).label.retrieve
+```
+
+#### Поиск заказов
+
+```ruby
+sender_ids = YandexDelivery.senders.map{|sender| sender['id']}
+YandexDelivery::Request.orders.search.upsert(body: {senderIds: sender_ids, orderIds: [order_id]})
+```
+
+#### Получить историю статусов заказа
+
+```ruby
+YandexDelivery::Request.orders(order_id).statuses.retrieve
+```
+
+#### Получить статус заказов
+
+```ruby
+YandexDelivery::Request.orders.status.upsert
+```
+
+### Операции с отгрузками
+
+#### Создать заявку на отгрузку
+
+```ruby
+body = {
+  cabinetId: YandexDelivery.client['id'],
+  shipment: {
+                type: "WITHDRAW",
+                date: "2020-10-05",
+                warehouseFrom: YandexDelivery.warehouses.first['id'],
+                warehouseTo: 123,
+                partnerTo: 678
+              },
+  intervalId: 765478,
+  dimensions: {
+                length: 10,
+                width: 15,
+                height: 40,
+                weight: 5.5
+               },
+  courier: {
+                type: "CAR",
+                firstName: "Василий",
+                middleName: "Иванович",
+                lastName: "Пупкин",
+                phone: "+79998887766",
+                carNumber: "о000оо",
+                carBrand: "Maybach"
+            },
+  comment: "comment"
+}
+response = YandexDelivery::Request.shipments.application.create(body: body)
+shipment_id = response.body['id']
+```
+
+#### Подтвердить отгрузку
+
+```ruby
+body = {
+  cabinetId: YandexDelivery.client['id'],
+  shipmentApplicationIds: [shipment_id]
+}
+YandexDelivery::Request.shipments.application.submit.create(body: body)
+```
+
+#### Получить список отгрузок
+
+```ruby
+body = {
+          cabinetId: YandexDelivery.client['id'],
+          shipmentType: "IMPORT",
+          dateFrom: "2020-10-05",
+          "dateTo": "2020-11-05",
+          "partnerIds": 
+          [
+            239847,
+            98234,
+            54968
+          ]
+       }
+YandexDelivery::Request.shipments.search.upsert(body: body)
+```
+
+#### Получить интервалы самопривозов
+
+```ruby
+warehouse_id = YandexDelivery.warehouses.first['id']
+YandexDelivery::Request.shipments.intervals.import.retrieve(params: {warehouseId: warehouse_id, date: '2020-10-06'})
+```
+
+#### Получить интервалы заборов
+
+```ruby
+YandexDelivery::Request.shipments.intervals.withdraw.retrieve(params: {partnerId: 106, date: '2020-10-06'})
+```
+
+#### Получить акт передачи заказов
+
+```ruby
+YandexDelivery::Request.shipments.applications(shipment_id).act.retrieve(params: {cabinetId: YandexDelivery.client['id']})
+```
+
+### Справочные данные
+
+#### Получить полный адрес
+
+```ruby
+YandexDelivery::Request.location.retrieve(params: {term: 'Санкт-Петербург'})
+```
+
+#### Получить индекс по адресу
+
+```ruby
+response = YandexDelivery::Request.location.postal_code.retrieve(params: {address: 'Санкт-Петербург, ул. Профессора Попова, д. 37Щ, БЦ "Сенатор"'})
+postal_code = response.body.first[:postalCode]
+```
+
+#### Получить список служб доставки
+
+```ruby
+YandexDelivery::Request.delivery_services.retrieve(params: {cabinetId: YandexDelivery.client['id']})
+```

data/lib/generators/yandex_delivery/install/templates/yandex_delivery.rb

@@ -1,7 +1,7 @@
 require 'yandex_delivery'
 
 YandexDelivery.setup do |config|
-  if File.exist?('config/yandex_delivery.yml')
+  if File.exist?('config/yandex_delivery2.yml')
     template = ERB.new(File.new('config/yandex_delivery2.yml').read)
     processed = YAML.safe_load(template.result(binding))
 
@@ -11,11 +11,6 @@ YandexDelivery.setup do |config|
     config::Request.symbolize_keys = true
     config::Request.debug = false
 
-    # processed['YANDEX_DELIVERY_API_KEY'].each do |k, v|
-    #   config::create_method k.underscore.to_sym
-    #   config::register "#{k.underscore}_key".to_sym, v
-    # end
-
     processed['YANDEX_DELIVERY'].each do |k, v|
       config::register k.underscore.to_sym, v
     end

data/lib/yandex-delivery/api_request.rb

@@ -140,12 +140,11 @@ module YandexDelivery
       if request
         request.params.merge!(params) if params
         request.headers['Content-Type'] = 'application/json'
-        request.headers['Authorization: OAuth'] = self.api_key
+        request.headers['Authorization'] = "OAuth #{self.api_key}"
         request.headers.merge!(headers) if headers
         request.body = body if body
         request.options.timeout = self.timeout
         request.options.open_timeout = self.open_timeout
-        p request
       end
     end
 
@@ -179,8 +178,7 @@ module YandexDelivery
     end
 
     def validate_api_key
-      api_key = self.api_key
-      unless api_key && (api_key["-"] || self.api_endpoint)
+      unless self.api_key
         raise YandexDelivery::YandexDeliveryError, "You must set an api_key prior to making a call"
       end
     end

data/lib/yandex-delivery/request.rb

@@ -7,7 +7,7 @@ module YandexDelivery
 
     def initialize(api_key: nil, api_endpoint: nil, timeout: nil, open_timeout: nil, proxy: nil, faraday_adapter: nil, symbolize_keys: false, debug: false, logger: nil)
       @path_parts = []
-      @api_key = api_key || self.class.api_key || ENV['YANDEX_DELIVERY_API_KEY']
+      @api_key = api_key || self.class.api_key || ENV['YANDEX_DELIVERY_ACCESS_TOKEN']
       @api_key = @api_key.strip if @api_key
       @api_endpoint = api_endpoint || self.class.api_endpoint
       @timeout = timeout || self.class.timeout || DEFAULT_TIMEOUT

data/lib/yandex-delivery/version.rb

@@ -1,3 +1,3 @@
 module YandexDelivery
-  VERSION = "0.0.1"
+  VERSION = "0.0.5"
 end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: yandex-delivery
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.6
 platform: ruby
 authors:
 - Pavel Osetrov
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2020-08-11 00:00:00.000000000 Z
@@ -44,6 +44,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.markdown
 - lib/generators/yandex_delivery/install/USAGE
 - lib/generators/yandex_delivery/install/install_generator.rb
 - lib/generators/yandex_delivery/install/templates/yandex_delivery.rb
@@ -59,7 +61,7 @@ homepage: https://github.com/osetrov/yandex-delivery
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -75,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.4
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Yandex delivery
 test_files: []