uploadcare-rails 1.2.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 51e5e1bed076e6d97a1ea78f70545bf4e6e1820f
-  data.tar.gz: 8f50c72f63c5a8dfc7fed84861468868eb5477a3
+SHA256:
+  metadata.gz: 350614c535917ec6a0e4967b6c1935520615f7c05f2dde048e2e71049acfb53e
+  data.tar.gz: d76147a67baf18cf174a28ba1a3f1351ecfae7d2b66efb2dbfa2705ea9ed1f47
 SHA512:
-  metadata.gz: b7221fac254b9ff175acafcb165131fffc356520132a5dea2b76b62592e9ebe1995641ae126b758e04ab37059bc2abcec6109fc0a6ca682267d5029383df3cc7
-  data.tar.gz: 0daf1d6084931be84f042650ff2f5fa4f9f948d631574bfc7cb32670cb79561bbdc28a7a3f69167b66de7c06296076543159e85298ac8537b04aa5d29b0ca25d
+  metadata.gz: 5c8da1247c066d6e6224d04ab9d38d59fd18aea135e24e927de0c515f32e7a1544952840bb1b11a44f812bf511fb0fe0c2eb0ff891c2aba3d88b899ed8a2cc7c
+  data.tar.gz: a1974745e61af0f76c8eda6e509db5677f153f6e59ad722463dfd3e1103b3710793eac34a1327e13e10658c0f21e198edf009abfe73898cfbe8cfb748c75e7f3

data/Rakefile

@@ -1,19 +1,8 @@
-#!/usr/bin/env rake
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
+# frozen_string_literal: true
 
-Bundler::GemHelper.install_tasks
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
-APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
-load 'rails/tasks/engine.rake'
-require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
-
-RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  # spec.rspec_opts = ['-cfs --backtrace']
-end
+task default: :spec

data/lib/generators/templates/uploadcare_config_template.erb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+# Uncomment this string in case of using locales for locale_translations parameter
+# I18n.load_path += Dir[Rails.root.join('config', 'locales', '*.{rb,yml}').to_s]
+
+Uploadcare::Rails.configure do |config|
+  # Sets your Uploadcare public key.
+  config.public_key = ENV.fetch('UPLOADCARE_PUBLIC_KEY', 'demopublickey')
+  # config.secret_key = ENV.fetch('UPLOADCARE_SECRET_KEY', 'demosecretkey')
+
+  # Stores files to Uploadcare servers after object save.
+  config.store_files_after_save = true
+
+  # Deletes files from Uploadcare servers after object destroy.
+  config.delete_files_after_destroy = true
+
+  # Sets caching for Uploadcare files
+  config.cache_namespace = 'uploadcare'
+  config.cache_files = true
+  config.cache_expires_in = 1.day
+
+  # These options enables ActiveJob background jobs to perform operations in background.
+  # Options work if only the option 'do_not_store' is disabled (false) and
+  # the option 'delete_files_after_destroy' is enabled (true).
+  config.store_files_async = true
+  config.delete_files_async = true
+
+  # If true, only image files are allowed to be uploaded.
+  # config.images_only = false
+
+  # If true, the preview step is present after selecting files.
+  # Otherwise, the file uploader dialog closes when the selection is complete.
+  # config.preview_step = false
+
+  # Defines the file uploader manual crop behavior (see https://uploadcare.com/docs/uploads/file-uploader/#crop-option).
+  # When uploading images, your users can select a crop area.
+  # This option does not force your file uploader to accept images only.
+  # The option also works in the multi-file mode since version 2.3.0.
+  # config.crop = 'disabled'
+
+  # Saves traffic and storage space by resizing images on a client before uploading.
+  # See the detailed option description for details. Using the client-side resize does not force the images only option.
+  # config.image_shrink = '800x600'
+
+  # Allows user to remove uploaded files from the file uploader.
+  # Please note that those files are not deleted from your account.
+  # config.clearable = true
+
+  # Allows you to define which upload sources you want to use with the file uploader.
+  # The value is represented by a space-separated ordered list of upload source names.
+  # See https://uploadcare.com/docs/uploads/file-uploader/#upload-sources for details.
+  # config.tabs = %w[url file facebook]
+
+  # Sets the accept attribute for the file uploader dialog.
+  # If the images only option is disabled, the value is empty.
+  # Otherwise, the default value is image/*.
+  # null means accept should be kept empty regardless of the images only value.
+  # For other possible values, see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Input#attr-accept
+  # Note, this is not a replacement for
+  # our file validation (see https://uploadcare.com/docs/file-uploader-api/file-validation/)
+  # because your users will still be able to choose any file via drag&drop or from URL.
+  # config.input_accept_types = %w[image/*]
+
+  # Defines the list of preferred MIME types.
+  # The list should be ordered and contain space-separated MIME types.
+  # Common parts can be marked with asterisks: image/* application/vnd.openxmlformats-officedocument.*.
+  # If no MIME types match the criteria or preferred types are not set, default formats are used.
+  # Keep in mind that some cloud services can export data in different formats.
+  # For example, Google document can be exported as Word document, PDF or plain text.
+  # config.preferred_types = %w[image/* application/vnd.openxmlformats-officedocument.*]
+
+  # Forces a system-native file picking dialog to show up instead of our file uploader.
+  # That makes the file uploader behavior as close as possible to the generic <input type="file">.
+  # Native behavior is achieved at the expense of support for uploading content
+  # from social media and cloud storage, manual crop, and preview step.
+  # Multi-file selection would still work.
+  # The option does not work in old browser versions: the dialog falls back to the file uploader.
+  # config.system_dialog = false
+
+  # This option sets the file size threshold for multipart uploading.
+  # The value ranges from 10485760 (10 MB), which is default, up to 104857600 (100 MB).
+  # If a file size hits the threshold, it gets uploaded in four parallel chunks by 5 MB.
+  # Multipart upload makes large file uploading faster.
+  # Files go directly to a storage, bypassing our upload servers,
+  # and they're quickly available for further use. All files below the threshold get uploaded in one piece.
+  # Note: Multipart upload works with local sources only (files and camera).
+  # config.multipart_min_size = 10485760
+
+  # Available locales currently are:
+  # ar az ca cs da de el en es et fr he it ja ko lv nb nl pl pt ro ru sk sr sv tr uk vi zhTW zh
+  config.locale = 'en'
+
+  # Sets custom localization options. See https://uploadcare.com/docs/uploads/file-uploader/#localization
+  # config.locale_translations = {}
+
+  # Defines pluralization options. See https://uploadcare.com/docs/uploads/file-uploader/#pluralization
+  # config.locale_pluralize = {}
+
+  # The option can be used with Authenticated URLs. Defines your proxy backend URL.
+  # See https://uploadcare.com/docs/security/secure-delivery/#proxy-backend.
+  # config.preview_proxy = 'https://domain.com/preview?'
+
+  # If true, inputs on your page are initialized automatically, see the article for details -
+  # https://uploadcare.com/docs/file-uploader-api/widget-initialization/
+  config.live = true
+
+  # If true, input initialization is invoked manually.
+  # See https://uploadcare.com/docs/file-uploader-api/widget-initialization/).
+  config.manual_start = false
+
+  # Defines your schema and CDN domain.
+  # Can be changed to one of the predefined values (https://uploadcare.com/docs/delivery/cdn/) or your custom CNAME.
+  # config.cdn_base = 'https://ucarecdn.com/'
+  config.cdn_hostname = 'ucarecdn.com'
+
+  # Forces files uploaded with a file uploader not to be stored.
+  # See https://uploadcare.com/docs/uploads/storage/#storing-uploaded-files.
+  # For instance, you might want to turn this on when automatic file storing is enabled in your project,
+  # but you do not want to store files uploaded with a particular file uploader.
+  # config.do_not_store = false
+
+  # Allows you to adjust the quality of an audio recorded via the file uploader Camera Tab.
+  # Refer the link to learn more - https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/MediaRecorder.
+  # config.audio_bits_per_second = 1
+
+  # Allows you to specify the MIME types.
+  # The first supported by the browser will be used as an option of
+  # video stream captured via the file uploader Camera Tab.
+  # Refer the link to learn more - https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/MediaRecorder.
+  # config.video_preferred_mime_types = []
+
+  # Allows you to adjust the quality of a video stream captured via the file uploader Camera Tab.
+  # Refer the link to learn more - https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/MediaRecorder.
+  # config.video_bits_per_second = 1
+
+  # Allows you to set the default state of image/video mirorring in the camera tab.
+  # config.camera_mirror_default = true
+end

data/lib/generators/uploadcare_config_generator.rb

@@ -1,9 +1,12 @@
+# frozen_string_literal: true
+
+# A generator that copies the config template to config directory
 class UploadcareConfigGenerator < Rails::Generators::Base
-  desc "This generator creates an uploadcare config file your_app/config/uploadcare.yml"
+  desc 'This generator creates an uploadcare config file your_app/config/initializers/uploadcare.rb'
 
-  source_root File.expand_path("../templates", __FILE__)
+  source_root File.expand_path('templates', __dir__)
 
   def create_config_file
-    copy_file "uploadcare_config_template.yml", "config/uploadcare.yml"#create_file "config/uploadcare.yml", config_template
+    copy_file 'uploadcare_config_template.erb', 'config/initializers/uploadcare.rb'
   end
-end
+end

data/lib/uploadcare/errors/type_error.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Uploadcare
+  module Errors
+    class TypeError < TypeError; end
+  end
+end

data/lib/uploadcare/rails/action_view/uploadcare_include_tags.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'action_view'
+require 'uploadcare/rails/configuration'
+
+module Uploadcare
+  module Rails
+    module ActionView
+      # A module containing a view include tags helper
+      module UploadcareWidgetTags
+        # A view helper to add a js script tag from CDN with just one string of code.
+        # See https://uploadcare.com/docs/uploads/file-uploader/#cdn for more info.
+        #
+        # Example:
+        #   <%= uploadcare_include_tag %>
+        #   => <script src="https://ucarecdn.com/libs/widget/3.x/uploadcare.full.min.js"></script>
+        #      <script>
+        #        UPLOADCARE_PUBLIC_KEY = 'demopublickey';
+        #        UPLOADCARE_LOCALE = 'en';
+        #      </script>
+        #
+        # Arguments:
+        #   version: (String, default: '3.x') - version of the widget
+        #   bundle: (String, default: 'full') - https://uploadcare.com/docs/uploads/file-uploader/#bundles
+        #     valid options: 'full', 'default', 'ie8', 'api', 'lang.en'
+        #   min: (true/false, default: true) - sets which version to get, minified or not
+
+        def uploadcare_include_tag(version: '3.x', bundle: 'full', min: true)
+          min = min == true ? '.min' : ''
+          bundle = bundle == 'default' ? '' : ".#{bundle}"
+          path = "/libs/widget/#{version}/uploadcare#{bundle}#{min}.js"
+          uri = URI::HTTPS.build(host: Uploadcare::Rails.configuration.cdn_hostname, path: path)
+
+          config_tag = javascript_tag(uploader_settings) if uploader_settings.present?
+          include_tag = javascript_include_tag(uri.to_s.squeeze('.'))
+
+          include_tag.concat(config_tag)
+        end
+
+        def uploader_settings
+          @uploader_settings ||= Uploadcare::Rails.configuration.uploader_parameters
+        end
+      end
+    end
+  end
+end
+
+ActionView::Base.include Uploadcare::Rails::ActionView::UploadcareWidgetTags

data/lib/uploadcare/rails/action_view/uploadcare_uploader_tags.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'action_view'
+require 'uploadcare/rails/configuration'
+
+module Uploadcare
+  module Rails
+    module ActionView
+      # A module containing a view field helper
+      module UploadcareUploaderTags
+        # A view helper to add a uploader button to a html-page
+        # See https://uploadcare.com/docs/uploads/file-uploader/#using-on-page for more info.
+        #
+        # Example:
+        #   <%= uploadcare_uploader_field :post, :title %>
+        #   => <input role="uploadcare-uploader" data-multiple="true" type="hidden" name="post[file]" id="post_file">
+        #      <div class="uploadcare--widget uploadcare--widget_status_ready" ...
+        #
+        # Arguments:
+        #   object_name: (String/Symbol) - object name which a field belongs to
+        #   method_name: (String/Symbol) - object method name
+        #   options: (Hash, default: {}) - options for hidden_field
+
+        DEFAULT_FIELD_OPTIONS = { role: 'uploadcare-uploader' }.freeze
+
+        def uploadcare_uploader_field(object_name, method_name, options = {})
+          hidden_field(
+            object_name,
+            method_name,
+            uploadcare_uploader_options(
+              options.merge(multiple: uploadcare_uploader_multiple?(object_name, method_name).presence)
+            )
+          )
+        end
+
+        def uploadcare_uploader_field_tag(object_name, options = {})
+          hidden_field_tag(object_name, options[:value], uploadcare_uploader_options(options))
+        end
+
+        def uploadcare_uploader_options(options = {})
+          data_options = options.transform_keys { |key| "data-#{key.to_s.underscore.dasherize}" }
+          DEFAULT_FIELD_OPTIONS.merge(data_options)
+        end
+
+        private
+
+        def uploadcare_uploader_multiple?(object_name, method_name)
+          model = object_name.to_s.camelize.safe_constantize
+          method_name = "has_uploadcare_file_group_for_#{method_name}?"
+          model.respond_to?(method_name) && model.public_send(method_name)
+        end
+      end
+    end
+  end
+end
+
+ActionView::Base.include Uploadcare::Rails::ActionView::UploadcareUploaderTags

data/lib/uploadcare/rails/active_record/mount_uploadcare_file.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'active_record'
+require 'active_support/concern'
+require 'uploadcare/rails/services/id_extractor'
+require 'uploadcare/rails/jobs/delete_file_job'
+require 'uploadcare/rails/jobs/store_file_job'
+
+module Uploadcare
+  module Rails
+    module ActiveRecord
+      # A module containing ActiveRecord extension. Allows to use uploadcare file methods in Rails models
+      module MountUploadcareFile
+        extend ActiveSupport::Concern
+
+        def build_uploadcare_file(attribute)
+          cdn_url = attributes[attribute.to_s].to_s
+          return if cdn_url.empty?
+
+          uuid = IdExtractor.call(cdn_url)
+          cache_key = File.build_cache_key(cdn_url)
+          default_attributes = { cdn_url: cdn_url, uuid: uuid.presence }
+          file_attributes = ::Rails.cache.read(cache_key).presence || default_attributes
+          Uploadcare::Rails::File.new(file_attributes)
+        end
+
+        class_methods do
+          # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+          def mount_uploadcare_file(attribute)
+            define_method attribute do
+              build_uploadcare_file attribute
+            end
+
+            define_method "uploadcare_store_#{attribute}!" do |store_job = StoreFileJob|
+              file_uuid = public_send(attribute)&.uuid
+              return unless file_uuid
+              return store_job.perform_later(file_uuid) if Uploadcare::Rails.configuration.store_files_async
+
+              Uploadcare::FileApi.store_file(file_uuid)
+            end
+
+            define_method "uploadcare_delete_#{attribute}!" do |delete_job = DeleteFileJob|
+              file_uuid = public_send(attribute)&.uuid
+              return unless file_uuid
+              return delete_job.perform_later(file_uuid) if Uploadcare::Rails.configuration.delete_files_async
+
+              Uploadcare::FileApi.delete_file(file_uuid)
+            end
+
+            after_save "uploadcare_store_#{attribute}!".to_sym unless Uploadcare::Rails.configuration.do_not_store
+            return unless Uploadcare::Rails.configuration.delete_files_after_destroy
+
+            after_destroy "uploadcare_delete_#{attribute}!".to_sym
+          end
+          # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        end
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.include Uploadcare::Rails::ActiveRecord::MountUploadcareFile

data/lib/uploadcare/rails/active_record/mount_uploadcare_file_group.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'active_record'
+require 'active_support/concern'
+require 'uploadcare/rails/services/id_extractor'
+require 'uploadcare/rails/services/files_count_extractor'
+require 'uploadcare/rails/jobs/store_group_job'
+
+module Uploadcare
+  module Rails
+    module ActiveRecord
+      # A module containing ActiveRecord extension. Allows to use uploadcare group methods in Rails models
+      module MountUploadcareFileGroup
+        extend ActiveSupport::Concern
+
+        GROUP_ID_REGEX = /\b[0-9a-f]{8}\b-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-\b[0-9a-f]{12}\b~\d/.freeze
+
+        def build_uploadcare_file_group(attribute)
+          cdn_url = attributes[attribute.to_s].to_s
+          return if cdn_url.empty?
+
+          group_id = IdExtractor.call(cdn_url, GROUP_ID_REGEX).presence
+          cache_key = File.build_cache_key(cdn_url)
+          files_count = FilesCountExtractor.call(group_id)
+          default_attributes = { cdn_url: cdn_url, id: group_id, files_count: files_count }
+          file_attributes = ::Rails.cache.read(cache_key).presence || default_attributes
+          Uploadcare::Rails::Group.new(file_attributes)
+        end
+
+        class_methods do
+          # rubocop:disable Metrics/MethodLength
+          def mount_uploadcare_file_group(attribute)
+            define_singleton_method "has_uploadcare_file_group_for_#{attribute}?" do
+              true
+            end
+
+            define_method attribute do
+              build_uploadcare_file_group attribute
+            end
+
+            define_method "uploadcare_store_#{attribute}!" do |store_job = StoreGroupJob|
+              group_id = public_send(attribute)&.id
+              return unless group_id
+              return store_job.perform_later(group_id) if Uploadcare::Rails.configuration.store_files_async
+
+              Uploadcare::GroupApi.store_group(group_id)
+            end
+
+            after_save "uploadcare_store_#{attribute}!".to_sym unless Uploadcare::Rails.configuration.do_not_store
+          end
+          # rubocop:enable Metrics/MethodLength
+        end
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.include Uploadcare::Rails::ActiveRecord::MountUploadcareFileGroup

data/lib/uploadcare/rails/api/rest/base.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'uploadcare'
+
+module Uploadcare
+  module Rails
+    module Api
+      module Rest
+        class Base
+        end
+      end
+    end
+  end
+end

data/lib/uploadcare/rails/api/rest/conversion_api.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'uploadcare/rails/api/rest/base'
+
+module Uploadcare
+  module Rails
+    module Api
+      module Rest
+        # A class that contains Conversion related methods for Uploadcare REST API
+        class ConversionApi < Base
+          class << self
+            # Converts video files
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/videoConvert
+            def convert_video(video_params, **options)
+              Uploadcare::VideoConverter.convert(video_params, **options)
+            end
+
+            # Returns a status of video conversion job
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/videoConvertStatus
+            def get_video_conversion_status(token)
+              Uploadcare::VideoConverter.status(token)
+            end
+
+            # Converts documents
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/documentConvert
+            def convert_document(document_params, **options)
+              Uploadcare::DocumentConverter.convert(document_params, **options)
+            end
+
+            # Returns a status of video conversion job
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/documentConvertStatus
+            def get_document_conversion_status(token)
+              Uploadcare::DocumentConverter.status(token)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+Uploadcare::ConversionApi = Uploadcare::Rails::Api::Rest::ConversionApi

data/lib/uploadcare/rails/api/rest/file_api.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'uploadcare/rails/api/rest/base'
+
+module Uploadcare
+  module Rails
+    module Api
+      module Rest
+        # A class that contains File related methods for Uploadcare REST API
+        class FileApi < Base
+          class << self
+            # Returns a pagination json of files stored in project
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/filesList
+            #
+            # valid options:
+            # removed: [true|false]
+            # stored: [true|false]
+            # limit: (1..1000)
+            # ordering: ["datetime_uploaded"|"-datetime_uploaded"|"size"|"-size"]
+            # from: A starting point for filtering files. The value depends on your ordering parameter value.
+            def get_files(**options)
+              Uploadcare::FileList.file_list(**options)
+            end
+
+            # Acquire file info
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/fileInfo
+            def get_file(uuid)
+              Uploadcare::File.info(uuid)
+            end
+
+            # '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_file(source, **options)
+              Uploadcare::File.copy(source, **options)
+            end
+
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/deleteFile
+            def delete_file(uuid)
+              Uploadcare::File.delete(uuid)
+            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
+            def store_file(uuid)
+              Uploadcare::File.store(uuid)
+            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
+            # uuids: Array
+            def store_files(uuids)
+              Uploadcare::FileList.batch_store(uuids)
+            end
+
+            # Delete several files by list of uids
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/filesDelete
+            # uuids: Array
+            def delete_files(uuids)
+              Uploadcare::FileList.batch_delete(uuids)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+Uploadcare::FileApi = Uploadcare::Rails::Api::Rest::FileApi

data/lib/uploadcare/rails/api/rest/group_api.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'uploadcare/rails/api/rest/base'
+
+module Uploadcare
+  module Rails
+    module Api
+      module Rest
+        # A class that contains Group related methods for Uploadcare REST API
+        class GroupApi < Base
+          class << self
+            # Returns paginated list of groups
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#operation/groupsList
+            #
+            # valid options:
+            # limit: (1..1000)
+            # ordering: ["datetime_created"|"-datetime_created"]
+            # from: A starting point for filtering group lists. MUST be a datetime value with T used as a separator.
+            #   example: '2015-01-02T10:00:00'
+            def get_groups(**options)
+              Uploadcare::GroupList.list(**options)
+            end
+
+            # Get group info
+            # @see https://uploadcare.com/api-refs/upload-api/#operation/filesGroupInfo
+            def get_group(uuid)
+              Uploadcare::Group.info(uuid)
+            end
+
+            # Stores all files in a group
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#tag/Group/paths/~1groups~1%3Cuuid%3E~1storage~1/put
+            def store_group(uuid)
+              Uploadcare::Group.store(uuid)
+            end
+
+            # Create files group from a set of files by using their UUIDs.
+            # @see https://uploadcare.com/api-refs/upload-api/#operation/createFilesGroup
+            def create_group(files, **options)
+              Uploadcare::Group.create(files, **options)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+Uploadcare::GroupApi = Uploadcare::Rails::Api::Rest::GroupApi

data/lib/uploadcare/rails/api/rest/project_api.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'uploadcare/rails/api/rest/base'
+
+module Uploadcare
+  module Rails
+    module Api
+      module Rest
+        # A class that contains Project related methods for Uploadcare REST API
+        class ProjectApi < Base
+          class << self
+            # Get information about the current project.
+            # Current project is determined by public and secret keys combination.
+            # @see https://uploadcare.com/api-refs/rest-api/v0.5.0/#tag/Project
+            # rubocop:disable Naming/AccessorMethodName
+            def get_project
+              Uploadcare::Project.show
+            end
+            # rubocop:enable Naming/AccessorMethodName
+          end
+        end
+      end
+    end
+  end
+end
+
+Uploadcare::ProjectApi = Uploadcare::Rails::Api::Rest::ProjectApi