yadisk-client 1.10.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 773e6386c0a726ce03bab8d09c68fde2d11aaad6ba41fa68d6088724ca47f9de
+  data.tar.gz: cf5fb42c245ba1649b3327f576003511852ac21f272c7b0d83e24fda8de988d8
+SHA512:
+  metadata.gz: 11149f7f6bcab071cf404c12606617c3a2e6421103ad92b2629e9c737be9a3d67d5b118cfeb968b2cde0766fc97a2187bd6c9b60e044dd8824656efbd5012cd1
+  data.tar.gz: 01526162c291d8ad551288e0a81a71ec5d137e475b5b44548060495d4003eb2be7187b1935a17b4e9c77ca8851bcf9fe86dc80170fa677be2197354aa7800de3

data/.gitignore

@@ -0,0 +1,37 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+## macos
+.DS_Store

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--format doc

data/.rubocop.yml

@@ -0,0 +1,142 @@
+---
+AllCops:
+  NewCops: disable # TODO: change to enable after refactoring
+
+# Commonly used screens these days easily fit more than 80 characters.
+Layout/LineLength:
+  Max: 120
+
+# Too short methods lead to extraction of single-use methods, which can make
+# the code easier to read (by naming things), but can also clutter the class
+Metrics/MethodLength: 
+  Max: 20
+
+# The guiding principle of classes is SRP, SRP can't be accurately measured by LoC
+Metrics/ClassLength:
+  Max: 1500
+
+# No space makes the method definition shorter and differentiates
+# from a regular assignment.
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: no_space
+
+# Single quotes being faster is hardly measurable and only affects parse time.
+# Enforcing double quotes reduces the times where you need to change them
+# when introducing an interpolation. Use single quotes only if their semantics
+# are needed.
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+# We do not need to support Ruby 1.9, so this is good to use.
+Style/SymbolArray:
+  Enabled: true
+
+# Most readable form.
+Style/OptionHash:
+  # A list of parameter names that will be flagged by this cop.
+  SuspiciousParamNames:
+    - options
+    - opts
+    - args
+    - paramsgit sttus
+    - parameters
+
+# Mixing the styles looks just silly.
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys
+
+# has_key? and has_value? are far more readable than key? and value?
+Style/PreferredHashMethods:
+  Enabled: false
+
+# String#% is by far the least verbose and only object oriented variant.
+Style/FormatString:
+  EnforcedStyle: percent
+
+Style/CollectionMethods:
+  Enabled: true
+  PreferredMethods:
+    # inject seems more common in the community.
+    reduce: "inject"
+
+
+# Either allow this style or don't. Marking it as safe with parenthesis
+# is silly. Let's try to live without them for now.
+Style/ParenthesesAroundCondition:
+  AllowSafeAssignment: false
+Lint/AssignmentInCondition:
+  AllowSafeAssignment: false
+
+# A specialized exception class will take one or more arguments and construct the message from it.
+# So both variants make sense. 
+Style/RaiseArgs:
+  Enabled: false
+
+# Indenting the chained dots beneath each other is not supported by this cop,
+# see https://github.com/bbatsov/rubocop/issues/1633
+Layout/MultilineOperationIndentation:
+  Enabled: false
+
+# Fail is an alias of raise. Avoid aliases, it's more cognitive load for no gain.
+# The argument that fail should be used to abort the program is wrong too,
+# there's Kernel#abort for that.
+Style/SignalException:
+  EnforcedStyle: only_raise
+
+# Suppressing exceptions can be perfectly fine, and be it to avoid to
+# explicitly type nil into the rescue since that's what you want to return,
+# or suppressing LoadError for optional dependencies
+Lint/SuppressedException:
+  Enabled: false
+
+Layout/SpaceInsideBlockBraces:
+  # The space here provides no real gain in readability while consuming
+  # horizontal space that could be used for a better parameter name.
+  # Also {| differentiates better from a hash than { | does.
+  SpaceBeforeBlockParameters: false
+
+# No trailing space differentiates better from the block:
+# foo} means hash, foo } means block.
+Layout/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+
+# { ... } for multi-line blocks is okay, follow Weirichs rule instead:
+# https://web.archive.org/web/20140221124509/http://onestepback.org/index.cgi/Tech/Ruby/BraceVsDoEnd.rdoc
+Style/BlockDelimiters:
+  Enabled: false
+
+# do / end blocks should be used for side effects,
+# methods that run a block for side effects and have
+# a useful return value are rare, assign the return
+# value to a local variable for those cases.
+Style/MethodCalledOnDoEndBlock:
+  Enabled: true
+
+# Enforcing the names of variables? To single letter ones? Just no.
+Style/SingleLineBlockParams:
+  Enabled: false
+
+# Shadowing outer local variables with block parameters is often useful
+# to not reinvent a new name for the same thing, it highlights the relation
+# between the outer variable and the parameter. The cases where it's actually
+# confusing are rare, and usually bad for other reasons already, for example
+# because the method is too long.
+Lint/ShadowingOuterLocalVariable:
+  Enabled: false
+
+# Check with yard instead.
+Style/Documentation:
+  Enabled: false 
+
+# This is just silly. Calling the argument `other` in all cases makes no sense.
+Naming/BinaryOperatorParameterName:
+  Enabled: false 
+
+# There are valid cases, for example debugging Cucumber steps,
+# also they'll fail CI anyway
+Lint/Debugger:
+  Enabled: false
+
+# Style preference
+Style/MethodDefParentheses:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# gem "yadisk-client", path: "./" # dev mode
+
+gemspec
+
+gem "addressable", "~> 2.3", ">= 2.3.7"
+gem "minitest", ">= 5.0.5"
+gem "rake"
+gem "standard"
+
+gem "rspec"
+gem "vcr"
+gem "webmock"

data/Gemfile.lock

@@ -0,0 +1,110 @@
+PATH
+  remote: .
+  specs:
+    yadisk-client (1.10.2)
+      addressable (~> 2.3, >= 2.3.7)
+      faraday (~> 1.7)
+      faraday_middleware (~> 1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
+    ast (2.4.2)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.5.0)
+    faraday (1.10.2)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    faraday_middleware (1.2.0)
+      faraday (~> 1.0)
+    hashdiff (1.0.1)
+    json (2.6.2)
+    minitest (5.16.3)
+    multipart-post (2.2.3)
+    parallel (1.22.1)
+    parser (3.1.2.1)
+      ast (~> 2.4.1)
+    public_suffix (5.0.0)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.5.0)
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.1)
+    rubocop (1.35.1)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.1.2.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.20.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.21.0)
+      parser (>= 3.1.1.0)
+    rubocop-performance (1.14.3)
+      rubocop (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    standard (1.16.1)
+      rubocop (= 1.35.1)
+      rubocop-performance (= 1.14.3)
+    unicode-display_width (2.3.0)
+    vcr (6.1.0)
+    webmock (3.18.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  universal-darwin-21
+  x86_64-darwin-17
+
+DEPENDENCIES
+  addressable (~> 2.3, >= 2.3.7)
+  minitest (>= 5.0.5)
+  rake
+  rspec
+  standard
+  vcr
+  webmock
+  yadisk-client!
+
+BUNDLED WITH
+   2.3.22

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2022 Ilya Brin
+
+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,61 @@
+# Yadisk - Yandex.Disk API client (ruby gem)
+
+[![Gem Version](https://badge.fury.io/rb/yadisk-client.svg)](https://badge.fury.io/rb/yadisk-client)
+
+## Install
+
+```sh
+  gem install yadisk-client
+```
+
+## Development
+
+```sh
+  gem build yadisk.gemspec && gem install yadisk-client && bundle exec rake console
+```
+
+## Available methods
+
+> **Note**
+> `**params` not included in requests, but will be later  
+> `**attributes` used in `update_meta` method only
+
+```ruby
+
+client = Yadisk::Client.new(token: 'paste your token here')
+
+client.disk.info
+client.disk.upload(path:)
+client.disk.upload_from_file(upload_link:, src:)
+client.disk.upload_by_url(path:, url:)
+client.disk.delete(path:)
+client.disk.get_meta(path:, **params)
+
+ # client.disk.update_meta(path: "dir_or_file_path", any_key_name: "value", other_key_name: "any_value")
+client.disk.update_meta(path:, **attributes)
+client.disk.create_dir(path:)
+client.disk.copy(from:, to:)
+client.disk.download(path:, **params)
+client.disk.list_files(**params)
+client.disk.last_uploaded(**params)
+client.disk.move(from:, to:)
+client.disk.list_public(**params)
+client.disk.publish(path:)
+client.disk.unpublish(path:)
+
+client.public_resource.meta(public_key:, **params)
+client.public_resource.link(public_key:, **params)
+client.public_resource.save(public_key:, **params)
+
+client.operation.status(operation_id:)
+
+client.trash.delete(path:, **params)
+client.trash.list(path:, **params)
+client.trash.restore(path:)
+```
+
+## TODOs
+
+- tests
+- examples
+- readme

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test
+
+task :console do
+  exec "irb -I lib -r yadisk.rb"
+end

data/lib/yadisk/client.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Client
+    BASE_URL = "https://cloud-api.yandex.net/v1"
+    attr_reader :token, :adapter
+
+    # new client
+    def initialize(token:, adapter: Faraday.default_adapter, stubs: nil)
+      @token = token
+      @adapter = adapter
+      @stubs = stubs # Test stubs for requests
+    end
+
+    def disk
+      DiskRest.new(self)
+    end
+
+    def operation
+      OperationRest.new(self)
+    end
+
+    def trash
+      TrashRest.new(self)
+    end
+
+    def public_resource
+      PublicRest.new(self)
+    end
+
+    def connection
+      @connection ||= Faraday.new(BASE_URL) do |conn|
+        conn.request :authorization, :OAuth, token
+        conn.request :json
+        conn.request :url_encoded
+
+        conn.response :dates
+        conn.response :json, content_type: "application/json"
+
+        conn.adapter adapter, @stubs
+      end
+    end
+  end
+end

data/lib/yadisk/collection.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Collection
+    attr_reader :data, :items, :total, :limit, :offset
+
+    def self.from_response(response, key:, type:)
+      body = response.body
+      new(
+        data: body[key].map {|attrs| type.new(attrs) },
+        items: body["items"],
+        total: body["total"]
+        # limit:  body.dig("limit"),
+        # offset: body.dig("offset")
+      )
+    end
+
+    def initialize(data:, total:, items:)
+      @data   = data
+      @items  = items
+      @total  = total
+      # @limit  = limit.empty? ? nil : limit
+      # @offset = offset.empty? ? nil : offset
+    end
+  end
+end

data/lib/yadisk/error.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Error < StandardError
+  end
+end

data/lib/yadisk/object.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Yadisk
+  class Object < OpenStruct
+    def initialize(attributes)
+      super to_ostruct(attributes)
+    end
+
+    # Convert Array or Hash to OpenStruct
+    def to_ostruct(obj)
+      case obj
+      when Hash
+        # rubocop:disable Style/HashTransformValues
+        OpenStruct.new(obj.map {|key, val| [key, to_ostruct(val)] }.to_h)
+        # rubocop:enable Style/HashTransformValues
+      when Array
+        obj.map {|o| to_ostruct(o) }
+      else
+        obj
+      end
+    end
+  end
+end

data/lib/yadisk/objects/disk.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# TODO: move all object types to one file
+module Yadisk
+  class Disk < Object; end
+end

data/lib/yadisk/objects/link.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Link < Object; end
+end

data/lib/yadisk/objects/operation.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Operation < Object; end
+end

data/lib/yadisk/objects/public.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class PublicResource < Object; end
+  class PublicResourcesList < Object; end
+end

data/lib/yadisk/objects/resource.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Resource < Object; end
+  class ResourceList < Object; end
+  class PublicResource < Object; end
+  class FilesResourceList < Object; end
+  class PublicResourceList < Object; end
+  class ResourceUploadLink < Object; end
+  class LastUploadedResourceList < Object; end
+end

data/lib/yadisk/objects/trash.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class Trash < Object; end
+  class TrashResource < Object; end
+end

data/lib/yadisk/resources/disk.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class DiskRest < Rest
+    def info
+      Disk.new get_request("disk").body
+    end
+
+    # TOOO: more test cases
+    def upload(path:)
+      path = Addressable::URI.parse(path).normalize
+      ResourceUploadLink.new get_request("disk/resources/upload?path=#{path}").body
+    end
+
+    def upload_from_file(upload_link:, src:)
+      put_request(upload_link, body: File.open(src).read).success?
+    end
+
+    def upload_by_url(path:, url:)
+      path = Addressable::URI.parse(path).normalize
+      url  = Addressable::URI.parse(url).normalize
+      Link.new post_request("disk/resources/upload?path=#{path}&url=#{url}", body: "").body
+    end
+
+    def delete(path:)
+      path = Addressable::URI.parse(path).normalize
+      delete_request("disk/resources?path=#{path}")
+    end
+
+    def get_meta(path:, **params)
+      path = Addressable::URI.parse(path).normalize
+      Resource.new get_request("disk/resources?path=#{path}", params: params).body
+    end
+
+    def update_meta(path:, **attributes)
+      path = Addressable::URI.parse(path).normalize
+      payload = {custom_properties: attributes}
+      Resource.new patch_request("disk/resources?path=#{path}", body: payload).body
+    end
+
+    def create_dir(path:)
+      path = Addressable::URI.parse(path).normalize
+      Link.new put_request("disk/resources?path=#{path}", body: "").body
+    end
+
+    def copy(from:, to:)
+      from = Addressable::URI.parse(from).normalize
+      to   = Addressable::URI.parse(to).normalize
+      Link.new post_request("disk/resources/copy?from=#{from}&path=#{to}", body: "").body
+    end
+
+    def download(path:, **params)
+      path = Addressable::URI.parse(path).normalize
+      Link.new get_request("disk/resources/download?path=#{path}", params: params).body
+    end
+
+    def list_files(**params)
+      resp = get_request("disk/resources/files", params: params).body
+      Collection.from_response(resp, key: "items", type: FilesResourceList)
+    end
+
+    def last_uploaded(**params)
+      resp = get_request("disk/resources/last-uploaded", params: params)
+      Collection.from_response(resp, key: "items", type: LastUploadedResourceList)
+    end
+
+    def move(from:, to:)
+      from = Addressable::URI.parse(from).normalize
+      to   = Addressable::URI.parse(to).normalize
+      Link.new post_request("disk/resources/move?from=#{from}&path=#{to}", body: "").body
+    end
+
+    def list_public(**params)
+      resp = get_request("disk/resources/public", params: params)
+      Collection.from_response(resp, key: "items", type: PublicResourcesList)
+    end
+
+    def publish(path:)
+      path = Addressable::URI.parse(path).normalize
+      Link.new put_request("disk/resources/publish?path=#{path}", body: "").body
+    end
+
+    def unpublish(path:)
+      path = Addressable::URI.parse(path).normalize
+      Link.new put_request("disk/resources/unpublish?path=#{path}", body: "").body
+    end
+  end
+end

data/lib/yadisk/resources/operation.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class OperationRest < Rest
+    def status(operation_id:)
+      resp = Operation.new get_request("disk/operations/#{operation_id}").body
+      resp.status
+    end
+  end
+end

data/lib/yadisk/resources/public.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Yadisk
+  class PublicRest < Rest
+    def meta(public_url:, **params)
+      PublicResource.new get_request("disk/public/resources?public_key=#{public_url}", params: params).body
+    end
+
+    def link(public_url:, **params)
+      Link.new get_request("disk/public/resources/download?public_key=#{public_url}", params: params).body
+    end
+
+    def save(public_url:)
+      Link.new post_request("disk/public/resources/save-to-disk?public_key=#{public_url}", body: "").body
+    end
+  end
+end