uploadcare-ruby 3.3.2 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3c7c464a8d89a9451f4205ba7f82b3c270d2431eb2b9cf9e31f64fc0542e032
-  data.tar.gz: 5ee0ef07f9194986eaf3742a5a80d01be38cd69a7e951551b791bcf479cf17f0
+  metadata.gz: ed47599fddd9c9b01dc434fffcffc0a323231396105fb028c6c6234ff0faaa6a
+  data.tar.gz: a9c20611bc482f6ee7454616dfdc54995d00a31f5159e943b60af71de4982792
 SHA512:
-  metadata.gz: 6accbd5a9c9c593c252a370947f42756a477cb47d6d1261a54a17df6f7026f9dd5e49ded174718ce159e6f3da9638744c4520673cfc0c81dcac381f129de2016
-  data.tar.gz: c383653917bab7dbc417eeccd16b800066ee07cf3741f3734361b8ae9da2935e369442711071a0ab0453860321b21a7a979265fa2a7f19daaaefb9fd4c5add20
+  metadata.gz: dba20c7fc6fea99e6b487e77dcec4477ec613f925d1dc2e4a1fd33caa6e8ba8844db2e7c579ac7e40427d24c4c88a4742967086face3c1a9d638815ed3d5c3e4
+  data.tar.gz: a4303e9e5b7584b3e5db4f346aff6e1a4bb44be843a762a95edaceec1b04a0400f2ceeb9945b0cfecd03a9ebceb855cc2b126b89f789987d40088f3ecf00eae3

data/.github/workflows/ruby.yml

@@ -12,7 +12,7 @@ on: [push, pull_request]
 jobs:
   test:
 
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-20.04
     strategy:
       matrix:
         ruby-version: [
@@ -25,6 +25,7 @@ jobs:
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
+        bundler: 1.17.3
         ruby-version: ${{ matrix.ruby-version }}
         bundler-cache: true
     - name: Run tests

data/.gitignore

@@ -11,4 +11,6 @@
 # rspec failure tracking
 .rspec_status
 .byebug_history
+
+.idea
 Gemfile.lock

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 4.0.0
+
+### Breaking Сhanges
+
+- For `Uploadcare::File#info`
+  - File information doesn't return `image_info` and `video_info` fields anymore
+  - Removed `rekognition_info` in favor of `appdata`
+  - Parameter `add_fields` was renamed to `include`
+- For `Uploadcare::FileList#file_list`
+  - Removed the option of sorting the file list by file size
+- For `Uploadcare::Group#store`
+  - Changed response format
+- For `Uploadcare::File`
+  - Removed method `copy` in favor of `local_copy` and `remote_copy` methods
+
+### Changed
+
+- For `Uploadcare::File#info`
+  - Field `content_info` that includes mime-type, image (dimensions, format, etc), video information (duration, format, bitrate, etc), audio information, etc
+  - Field `metadata` that includes arbitrary metadata associated with a file
+  - Field `appdata` that includes dictionary of application names and data associated with these applications
+
+### Added
+
+- Add Uploadcare API interface:
+    - `Uploadcare::FileMetadata`
+    - `Uploadcare::Addons`
+- Added an option to delete a Group
+- For `Uploadcare::File` add `local_copy` and `remote_copy` methods
+
 ## 3.3.2 - 2022-07-18
 
 - Fixes dry-configurable deprecation warnings

data/README.md

@@ -25,9 +25,11 @@ wrapping Upload and REST APIs.
     * [File](#file)
     * [FileList](#filelist)
     * [Pagination](#pagination)
+    * [Custom File Metadata](#custom-file-metadata)
     * [Group](#group)
     * [GroupList](#grouplist)
     * [Webhook](#webhook)
+    * [Add-Ons](#add-ons)
     * [Project](#project)
     * [Conversion](#conversion)
 * [Useful links](#useful-links)
@@ -52,13 +54,24 @@ And then execute:
 
     $ bundle
 
+If you have Ruby version >= 3, then you probably will get error:
+```
+ArgumentError: wrong number of arguments (given 2, expected 1)
+```
+
+To fix this errors, add this line to your application's Gemfile:
+```ruby
+gem 'dry-configurable', '0.13.0'
+```
+and run `bundle install`
+
 If already not, create your project in [Uploadcare dashboard](https://app.uploadcare.com/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-ruby) and copy
-its API keys from there.
+its [API keys](https://app.uploadcare.com/projects/-/api-keys/) from there.
 
 Set your Uploadcare keys in config file or through environment variables:
 ```bash
-export UPLOADCARE_PUBLIC_KEY=demopublickey
-export UPLOADCARE_SECRET_KEY=demoprivatekey
+export UPLOADCARE_PUBLIC_KEY=your_public_key
+export UPLOADCARE_SECRET_KEY=your_private_key
 ```
 
 Or configure your app yourself if you are using different way of storing keys.
@@ -67,8 +80,8 @@ settings can be seen in [`lib/uploadcare.rb`](lib/uploadcare.rb)
 
 ```ruby
 # your_config_initializer_file.rb
-Uploadcare.config.public_key = "demopublickey"
-Uploadcare.config.secret_key = "demoprivatekey"
+Uploadcare.config.public_key = "your_public_key"
+Uploadcare.config.secret_key = "your_private_key"
 ```
 
 ## Usage
@@ -143,7 +156,7 @@ After the request for uploading-from-URL is sent, you can check the progress of
 
 ```ruby
 Uploadcare::Uploader.get_upload_from_url_status("1251ee66-3631-4416-a2fb-96ba59f5a515")
-# => Success({:size=>28511, :total=>28511, :done=>28511, :uuid=>"b829753b-6b64-4989-a167-ef15e4f3d190", :file_id=>"b859753b-zb64-4989-a167-ef15e4f3a190", :original_filename=>"video.ogg", :is_image=>false, :is_stored=>false, :image_info=>nil, :video_info=>nil, :is_ready=>true, :filename=>"video.ogg", :mime_type=>"audio/ogg", :status=>"success"})
+# => Success({:size=>453543, :total=>453543, :done=>453543, :uuid=>"5c51a7fe-e45d-42a2-ba5e-79957ff4bdab", :file_id=>"5c51a7fe-e45d-42a2-ba5e-79957ff4bdab", :original_filename=>"2250", :is_image=>true, :is_stored=>false, :image_info=>{:dpi=>[96, 96], :width=>2250, :format=>"JPEG", :height=>2250, :sequence=>false, :color_mode=>"RGB", :orientation=>nil, :geo_location=>nil, :datetime_original=>nil}, :video_info=>nil, :content_info=>{:mime=>{:mime=>"image/jpeg", :type=>"image", :subtype=>"jpeg"}, :image=>{:dpi=>[96, 96], :width=>2250, :format=>"JPEG", :height=>2250, :sequence=>false, :color_mode=>"RGB", :orientation=>nil, :geo_location=>nil, :datetime_original=>nil}}, :is_ready=>true, :filename=>"2250", :mime_type=>"image/jpeg", :metadata=>{}, :status=>"success"})
 ```
 
 In case of the `async` option is disabled, uploadcare-ruby tries to request the upload status several times (depending on the `max_request_tries` config param) and then returns uploaded file attributes.
@@ -188,6 +201,13 @@ You can override global [`:autostore`](#initialization) option for each upload r
 @api.upload_from_url(url, store: :auto)
 ```
 
+You can upload file with custom metadata, for example `subsystem` and `pet`:
+
+```ruby
+@api.upload(files, metadata: { subsystem: 'my_subsystem', pet: 'cat' } )
+@api.upload_from_url(url, metadata: { subsystem: 'my_subsystem', pet: 'cat' })
+```
+
 ### File management
 
 Entities are representations of objects in Uploadcare cloud.
@@ -198,31 +218,107 @@ File entity contains its metadata.
 
 ```ruby
 @file = Uploadcare::File.file("FILE_ID_IN_YOUR_PROJECT")
-{"datetime_removed"=>nil,
- "datetime_stored"=>"2020-01-16T15:03:15.315064Z",
- "datetime_uploaded"=>"2020-01-16T15:03:14.676902Z",
- "image_info"=>
-  {"color_mode"=>"RGB",
-   "orientation"=>nil,
-   "format"=>"JPEG",
-   "sequence"=>false,
-   "height"=>183,
-   "width"=>190,
-   "geo_location"=>nil,
-   "datetime_original"=>nil,
-   "dpi"=>nil},
- "is_image"=>true,
- "is_ready"=>true,
- "mime_type"=>"image/jpeg",
- "original_file_url"=>
-  "https://ucarecdn.com/FILE_ID_IN_YOUR_PROJECT/imagepng.jpeg",
- "original_filename"=>"image.png.jpeg",
- "size"=>5345,
- "url"=>
-  "https://api.uploadcare.com/files/FILE_ID_IN_YOUR_PROJECT/",
- "uuid"=>"8f64f313-e6b1-4731-96c0-6751f1e7a50a"}
-
-@file.copy # copies file, returns a new (copied) file metadata
+{
+  "datetime_removed"=>nil,
+  "datetime_stored"=>"2018-11-26T12:49:10.477888Z",
+  "datetime_uploaded"=>"2018-11-26T12:49:09.945335Z",
+  "is_image"=>true,
+  "is_ready"=>true,
+  "mime_type"=>"image/jpeg",
+  "original_file_url"=>"https://ucarecdn.com/FILE_ID_IN_YOUR_PROJECT/pineapple.jpg",
+  "original_filename"=>"pineapple.jpg",
+  "size"=>642,
+  "url"=>"https://api.uploadcare.com/files/FILE_ID_IN_YOUR_PROJECT/",
+  "uuid"=>"FILE_ID_IN_YOUR_PROJECT",
+  "variations"=>nil,
+  "content_info"=>{
+    "mime"=>{
+      "mime"=>"image/jpeg",
+      "type"=>"image",
+      "subtype"=>"jpeg"
+    },
+    "image"=>{
+      "format"=>"JPEG",
+      "width"=>500,
+      "height"=>500,
+      "sequence"=>false,
+      "orientation"=>6,
+      "geo_location"=>{
+        "latitude"=>55.62013611111111,
+        "longitude"=>37.66299166666666
+      },
+      "datetime_original"=>"2018-08-20T08:59:50",
+      "dpi"=>[72, 72]
+    }
+  },
+  "metadata"=>{
+    "subsystem"=>"uploader",
+    "pet"=>"cat"
+  },
+  "appdata"=>{
+    "uc_clamav_virus_scan"=>{
+      "data"=>{
+        "infected"=>true,
+        "infected_with"=>"Win.Test.EICAR_HDB-1"
+      },
+      "version"=>"0.104.2",
+      "datetime_created"=>"2021-09-21T11:24:33.159663Z",
+      "datetime_updated"=>"2021-09-21T11:24:33.159663Z"
+    },
+    "remove_bg"=>{
+      "data"=>{
+        "foreground_type"=>"person"
+      },
+      "version"=>"1.0",
+      "datetime_created"=>"2021-07-25T12:24:33.159663Z",
+      "datetime_updated"=>"2021-07-25T12:24:33.159663Z"
+    },
+    "aws_rekognition_detect_labels"=>{
+      "data"=>{
+        "LabelModelVersion"=>"2.0",
+        "Labels"=>[
+          {
+            "Confidence"=>93.41645812988281,
+            "Instances"=>[],
+            "Name"=>"Home Decor",
+            "Parents"=>[]
+          },
+          {
+            "Confidence"=>70.75951385498047,
+            "Instances"=>[],
+            "Name"=>"Linen",
+            "Parents"=>[{ "Name"=>"Home Decor" }]
+          },
+          {
+            "Confidence"=>64.7123794555664,
+            "Instances"=>[],
+            "Name"=>"Sunlight",
+            "Parents"=>[]
+          },
+          {
+            "Confidence"=>56.264793395996094,
+            "Instances"=>[],
+            "Name"=>"Flare",
+            "Parents"=>[{ "Name"=>"Light" }]
+          },
+          {
+            "Confidence"=>50.47153854370117,
+            "Instances"=>[],
+            "Name"=>"Tree",
+            "Parents"=>[{ "Name"=>"Plant" }]
+          }
+        ]
+      },
+      "version"=>"2016-06-27",
+      "datetime_created"=>"2021-09-21T11:25:31.259763Z",
+      "datetime_updated"=>"2021-09-21T11:27:33.359763Z"
+    }
+  }
+}
+
+@file.local_copy # copy file to local storage
+
+@file.remote_copy # copy file to remote storage
 
 @file.store # stores file, returns updated metadata
 
@@ -300,8 +396,8 @@ how they should be fetched:
 - **:limit** — Controls page size. Accepts values from 1 to 1000, defaults to 100.
 - **:stored** — Can be either `true` or `false`. When true, file list will contain only stored files. When false — only not stored.
 - **:removed** — Can be either `true` or `false`. When true, file list will contain only removed files. When false — all except removed. Defaults to false.
-- **:ordering** — Controls the order of returned files. Available values: `datetime_updated`, `-datetime_updated`, `size`, `-size`. Defaults to `datetime_uploaded`. More info can be found [here](https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/filesList).
-- **:from** — Specifies the starting point for a collection. Resulting collection will contain files from the given value and to the end in a direction set by an **ordering** option. When files are ordered by `datetime_updated` in any direction, accepts either a `DateTime` object or an ISO 8601 string. When files are ordered by size, accepts non-negative integers (size in bytes). More info can be found [here](https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/filesList).
+- **:ordering** — Controls the order of returned files. Available values: `datetime_uploaded`, `-datetime_uploaded`. Defaults to `datetime_uploaded`. More info can be found [here](https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/filesList).
+- **:from** — Specifies the starting point for a collection. Resulting collection will contain files from the given value and to the end in a direction set by an **ordering** option. When files are ordered by `datetime_updated` in any direction, accepts either a `DateTime` object or an ISO 8601 string. When files are ordered by size, accepts non-negative integers (size in bytes). More info can be found [here](https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/filesList).
 
 Options used to create a file list can be accessed through `#options` method.
 Note that, once set, they don't affect file fetching process anymore and are
@@ -340,6 +436,25 @@ Alternatively, it's possible to iterate through full list of groups or files wit
 end
 ```
 
+#### Custom File Metadata
+
+File metadata is additional, arbitrary data, associated with uploaded file.
+As an example, you could store unique file identifier from your system.
+
+```ruby
+# Get file's metadata keys and values.
+Uploadcare::FileMetadata.index('FILE_ID_IN_YOUR_PROJECT')
+
+# Get the value of a single metadata key.
+Uploadcare::FileMetadata.show('FILE_ID_IN_YOUR_PROJECT', 'KEY')
+
+# Update the value of a single metadata key. If the key does not exist, it will be created.
+Uploadcare::FileMetadata.update('FILE_ID_IN_YOUR_PROJECT', 'KEY', 'VALUE')
+
+# Delete a file's metadata key.
+Uploadcare::FileMetadata.delete('FILE_ID_IN_YOUR_PROJECT', 'KEY')
+```
+
 #### Group
 
 Groups are structures intended to organize sets of separate files. Each group is
@@ -355,6 +470,12 @@ That's a requirement of our API.
 
 # group can be stored by group ID. It means that all files of a group will be stored on Uploadcare servers permanently
 Uploadcare::Group.store(group.id)
+
+# get a file group by its ID.
+Uploadcare::Group.rest_info(group.id)
+
+# group can be deleted by group ID.
+Uploadcare::Group.delete(group.id)
 ```
 
 #### GroupList
@@ -430,15 +551,56 @@ else
 end
 ```
 
+#### Add-Ons
+
+An `Add-On` is an application implemented by Uploadcare that accepts uploaded files as an input and can produce other files and/or appdata as an output.
+
+##### AWS Rekognition
+
+```ruby
+# Execute AWS Rekognition Add-On for a given target to detect labels in an image. Note: Detected labels are stored in the file's appdata.
+Uploadcare::Addons.ws_rekognition_detect_labels('FILE_ID_IN_YOUR_PROJECT')
+
+# Check the status of AWS Rekognition.
+Uploadcare::Addons.ws_rekognition_detect_labels_status('RETURNED_ID_FROM_WS_REKOGNITION_DETECT_LABELS')
+```
+
+##### ClamAV
+
+```ruby
+# ClamAV virus checking Add-On for a given target.
+Uploadcare::Addons.uc_clamav_virus_scan('FILE_ID_IN_YOUR_PROJECT')
+
+# Checking and purge infected file.
+Uploadcare::Addons.uc_clamav_virus_scan('FILE_ID_IN_YOUR_PROJECT', purge_infected: true )
+
+# Check the status ClamAV virus scan.
+Uploadcare::Addons.uc_clamav_virus_scan_status('RETURNED_ID_FROM_UC_CLAMAV_VIRUS_SCAN')
+```
+
+##### Remove.bg
+
+```ruby
+# Remove background image removal Add-On for a given target.
+Uploadcare::Addons.remove_bg('FILE_ID_IN_YOUR_PROJECT')
+
+# You can pass optional parameters.
+# See the full list of parameters here: https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/removeBgExecute
+Uploadcare::Addons.remove_bg('FILE_ID_IN_YOUR_PROJECT', crop: true, type_level: '2')
+
+# Check the status of background image removal.
+Uploadcare::Addons.remove_bg_status('RETURNED_ID_FROM_REMOVE_BG')
+```
+
 #### Project
 
 `Project` provides basic info about the connected Uploadcare project. That
 object is also an Hashie::Mash, so every methods out of
-[these](https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/projectInfo) will work.
+[these](https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/projectInfo) will work.
 
 ```ruby
 @project = Uploadcare::Project.project
-# => #<Uploadcare::Api::Project collaborators=[], name="demo", pub_key="demopublickey", autostore_enabled=true>
+# => #<Uploadcare::Api::Project collaborators=[], name="demo", pub_key="your_public_key", autostore_enabled=true>
 
 @project.name
 # => "demo"
@@ -513,7 +675,7 @@ Params in the response:
   - **original_source** - built path for a particular video with all the conversion operations and parameters.
   - **token** - a processing job token that can be used to get a [job status](https://uploadcare.com/docs/transformations/video-encoding/#status) (see below).
   - **uuid** - UUID of your processed video file.
-  - **thumbnails_group_uuid** - holds :uuid-thumb-group, a UUID of a [file group](https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/groupsList) with thumbnails for an output video, based on the thumbs [operation](https://uploadcare.com/docs/transformations/video-encoding/#operation-thumbs) parameters.
+  - **thumbnails_group_uuid** - holds :uuid-thumb-group, a UUID of a [file group](https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/groupsList) with thumbnails for an output video, based on the thumbs [operation](https://uploadcare.com/docs/transformations/video-encoding/#operation-thumbs) parameters.
 - **problems** - problems related to your processing job, if any.
 
 To convert multiple videos just add params as a hash for each video to the first argument of the `Uploadcare::VideoConverter#convert` method:

data/lib/uploadcare/client/addons_client.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative 'rest_client'
+
+module Uploadcare
+  module Client
+    # API client for handling uploaded files
+    # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/Add-Ons
+    class AddonsClient < RestClient
+      # Execute ClamAV virus checking Add-On for a given target.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/ucClamavVirusScanExecute
+      def uc_clamav_virus_scan(uuid, params = {})
+        content = { target: uuid, params: params }.to_json
+        post(uri: '/addons/uc_clamav_virus_scan/execute/', content: content)
+      end
+
+      # Check the status of an Add-On execution request that had been started using the Execute Add-On operation.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/ucClamavVirusScanExecutionStatus
+      def uc_clamav_virus_scan_status(uuid)
+        get(uri: "/addons/uc_clamav_virus_scan/execute/status/#{query_params(uuid)}")
+      end
+
+      # Execute AWS Rekognition Add-On for a given target to detect labels in an image.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/awsRekognitionExecute
+      def ws_rekognition_detect_labels(uuid)
+        content = { target: uuid }.to_json
+        post(uri: '/addons/aws_rekognition_detect_labels/execute/', content: content)
+      end
+
+      # Check the status of an Add-On execution request that had been started using the Execute Add-On operation.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/awsRekognitionExecutionStatus
+      def ws_rekognition_detect_labels_status(uuid)
+        get(uri: "/addons/aws_rekognition_detect_labels/execute/status/#{query_params(uuid)}")
+      end
+
+      # Execute remove.bg background image removal Add-On for a given target.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/removeBgExecute
+      def remove_bg(uuid, params = {})
+        content = { target: uuid, params: params }.to_json
+        post(uri: '/addons/remove_bg/execute/', content: content)
+      end
+
+      # Check the status of an Add-On execution request that had been started using the Execute Add-On operation.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/removeBgExecutionStatus
+      def remove_bg_status(uuid)
+        get(uri: "/addons/remove_bg/execute/status/#{query_params(uuid)}")
+      end
+
+      private
+
+      def query_params(uuid)
+        "?#{URI.encode_www_form(request_id: uuid)}"
+      end
+    end
+  end
+end

data/lib/uploadcare/client/conversion/base_conversion_client.rb

@@ -8,7 +8,7 @@ module Uploadcare
     module Conversion
       # This is a base client for conversion operations
       #
-      # @see https://uploadcare.com/api-refs/rest-api/v0.6.0/#tag/Conversion
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/Conversion
       class BaseConversionClient < RestClient
         API_VERSION_HEADER_VALUE = 'application/vnd.uploadcare-v0.5+json'
 

data/lib/uploadcare/client/conversion/document_conversion_client.rb

@@ -8,7 +8,7 @@ module Uploadcare
     module Conversion
       # This is client for document conversion
       #
-      # @see https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/documentConvert
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/documentConvert
       class DocumentConversionClient < BaseConversionClient
         def convert_many(
           arr,

data/lib/uploadcare/client/conversion/video_conversion_client.rb

@@ -9,7 +9,7 @@ module Uploadcare
     module Conversion
       # This is client for video conversion
       #
-      # @see https://uploadcare.com/api-refs/rest-api/v0.6.0/#operation/videoConvert
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/videoConvert
       class VideoConversionClient < BaseConversionClient
         def convert_many(
           params,

data/lib/uploadcare/client/file_client.rb

@@ -6,7 +6,7 @@ module Uploadcare
   module Client
     # API client for handling single files
     # @see https://uploadcare.com/docs/api_reference/rest/accessing_files/
-    # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#tag/File
+    # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/File
     class FileClient < RestClient
       # Gets list of files without pagination fields
       def index
@@ -15,27 +15,31 @@ module Uploadcare
       end
 
       # Acquire file info
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/fileInfo
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/fileInfo
       def info(uuid)
         get(uri: "/files/#{uuid}/")
       end
       alias file info
 
-      # 'copy' method is used to copy original files or their modified versions to default storage.
-      # Source files MAY either be stored or just uploaded and MUST NOT be deleted.
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/copyFile
-      def copy(**options)
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/File/operation/createLocalCopy
+      def local_copy(options = {})
         body = options.compact.to_json
-        post(uri: '/files/', content: body)
+        post(uri: '/files/local_copy/', content: body)
       end
 
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/deleteFile
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/File/operation/createRemoteCopy
+      def remote_copy(options = {})
+        body = options.compact.to_json
+        post(uri: '/files/remote_copy/', content: body)
+      end
+
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/deleteFileStorage
       def delete(uuid)
-        request(method: 'DELETE', uri: "/files/#{uuid}/")
+        request(method: 'DELETE', uri: "/files/#{uuid}/storage/")
       end
 
       # Store a single file, preventing it from being deleted in 2 weeks
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/storeFile
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/storeFile
       def store(uuid)
         put(uri: "/files/#{uuid}/storage/")
       end

data/lib/uploadcare/client/file_list_client.rb

@@ -7,13 +7,13 @@ module Uploadcare
     # API client for handling file lists
     class FileListClient < RestClient
       # Returns a pagination json of files stored in project
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/filesList
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/filesList
       #
       # valid options:
       # removed: [true|false]
       # stored: [true|false]
       # limit: (1..1000)
-      # ordering: ["datetime_uploaded"|"-datetime_uploaded"|"size"|"-size"]
+      # ordering: ["datetime_uploaded"|"-datetime_uploaded"]
       # from: number of files skipped
       def file_list(options = {})
         query = options.empty? ? '' : "?#{URI.encode_www_form(options)}"
@@ -21,7 +21,7 @@ module Uploadcare
       end
 
       # Make a set of files "stored". This will prevent them from being deleted automatically
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/filesStoring
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/filesStoring
       # uuids: Array
       def batch_store(uuids)
         body = uuids.to_json
@@ -31,7 +31,7 @@ module Uploadcare
       alias request_delete delete
 
       # Delete several files by list of uids
-      # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/filesDelete
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/filesDelete
       # uuids: Array
       def batch_delete(uuids)
         body = uuids.to_json

data/lib/uploadcare/client/file_metadata_client.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative 'rest_client'
+
+module Uploadcare
+  module Client
+    # API client for handling single metadata_files
+    # @see https://uploadcare.com/docs/file-metadata/
+    # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/File-metadata
+    class FileMetadataClient < RestClient
+      # Get file's metadata keys and values
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/fileMetadata
+      def index(uuid)
+        get(uri: "/files/#{uuid}/metadata/")
+      end
+
+      # Get the value of a single metadata key.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/fileMetadataKey
+      def show(uuid, key)
+        get(uri: "/files/#{uuid}/metadata/#{key}/")
+      end
+
+      # Update the value of a single metadata key. If the key does not exist, it will be created.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/updateFileMetadataKey
+      def update(uuid, key, value)
+        put(uri: "/files/#{uuid}/metadata/#{key}/", content: value.to_json)
+      end
+
+      # Delete a file's metadata key.
+      # @see https://uploadcare.com/api-refs/rest-api/v0.7.0/#operation/deleteFileMetadataKey
+      def delete(uuid, key)
+        request(method: 'DELETE', uri: "/files/#{uuid}/metadata/#{key}/")
+      end
+    end
+  end
+end

data/lib/uploadcare/client/group_client.rb

@@ -10,8 +10,8 @@ module Uploadcare
     class GroupClient < UploadClient
       # Create files group from a set of files by using their UUIDs.
       # @see https://uploadcare.com/api-refs/upload-api/#operation/createFilesGroup
-      def create(file_list, **options)
-        body_hash = group_body_hash(file_list, **options)
+      def create(file_list, options = {})
+        body_hash = group_body_hash(file_list, options)
         body = HTTP::FormData::Multipart.new(body_hash)
         post(path: 'group/',
              headers: { 'Content-Type': body.content_type },
@@ -31,8 +31,8 @@ module Uploadcare
         ids.zip(file_ids).to_h
       end
 
-      def group_body_hash(file_list, **options)
-        { pub_key: Uploadcare.config.public_key }.merge(file_params(parse_file_list(file_list))).merge(**options)
+      def group_body_hash(file_list, options = {})
+        { pub_key: Uploadcare.config.public_key }.merge(file_params(parse_file_list(file_list))).merge(options)
       end
 
       # API accepts only list of ids, but some users may want to upload list of files

data/lib/uploadcare/client/multipart_upload/chunks_client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'parallel'
+require 'dry/monads'
 require 'api_struct'
 
 module Uploadcare