crowdin-api 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc71aeec74dd34cef85bb90b9accdd273d18ce3fd8ba9888eb3ce6a073e6aff0
-  data.tar.gz: 39e8290a34930ad659e1ad5879f4f91283f82f88f2316c7f64f03ef524de35cc
+  metadata.gz: 12e4090258b99a1702202afb42fa199658b4afcd544372b9c5360d1807f65960
+  data.tar.gz: a11f40b227a80f556e4947c05189df7ac226d9141f4103d2aa6f93d3f08ca164
 SHA512:
-  metadata.gz: d95cbb784a0148eab14bce79dff1dd70735e60aecad95f3be2402ac525581bae5c42dfce8f888ab7255fa3096f7153201a3256d3a6f41821a35f9eaec215abab
-  data.tar.gz: 4b9604fa346136d64a69beb7643beff66433cbbc9102242f56bac6b3f9ebd23e29cc70339e63b9c1a754ce77cf71a6c624d1b97120a5b7f82fb3dbdcb3b23054
+  metadata.gz: 34da514b4e85ea10655d92971b6b495c3d8c141c7c7e195128ff0668883bda4bb9966433899e2f4c8297ad669d2c9af0f72ab6eaa6e07e2f5e9d4ab83ed0b963
+  data.tar.gz: 74e30dac5d1d2c0bba0c0a47c8eae3adb359770272165eb3506cf7e0ff918555cc204d7d0e3bdcbc16bc549d563d9140dd9d9bc3392dfb3a3912ec1373cf2f28

data/.github/workflows/test-and-lint.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: ['2.6', '2.7', '3.0']
+        ruby-version: [ '2.6', '2.7', '3.0' ]
     steps:
       - name: Checkout code
         uses: actions/checkout@v2

data/.gitignore

@@ -1,12 +1,12 @@
 # Ignore Ruby logs
-.ruby-version
 .idea
 
 # Ignore MacOS logs
 .DS_Store
 
-# Ignore versioning file
+# Ignore versioning files
 Gemfile.lock
+.ruby-version
 
 # Ignore tests coverage folder
 coverage

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2021-12-13 20:26:23 UTC using RuboCop version 1.23.0.
+# on 2022-02-14 06:05:44 UTC using RuboCop version 1.23.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -21,12 +21,15 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'crowdin-api.gemspec'
 
-# Offense count: 2
+# Offense count: 4
 # Cop supports --auto-correct.
-# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
-Layout/ExtraSpacing:
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
   Exclude:
-    - 'bin/crowdin-console'
+    - 'lib/crowdin-api/client/configuration.rb'
 
 # Offense count: 1
 # Cop supports --auto-correct.
@@ -47,24 +50,26 @@ Metrics/AbcSize:
 Metrics/BlockLength:
   Max: 54
 
-# Offense count: 4
+# Offense count: 12
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 Metrics/MethodLength:
   Max: 18
 
-# Offense count: 2
+# Offense count: 8
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 205
+  Max: 199
 
-# Offense count: 1
-# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+# Offense count: 2
+# Configuration parameters: CountKeywordArgs.
 Metrics/ParameterLists:
+  MaxOptionalParameters: 4
   Max: 6
 
-# Offense count: 1
+# Offense count: 2
 Naming/AccessorMethodName:
   Exclude:
+    - 'lib/crowdin-api/api-resources/users.rb'
     - 'lib/crowdin-api/core/request.rb'
 
 # Offense count: 3
@@ -74,8 +79,8 @@ Naming/AccessorMethodName:
 Naming/FileName:
   Exclude:
     - 'lib/crowdin-api.rb'
-    - 'spec/core/config-instance_spec.rb'
-    - 'spec/crowdin-api_spec.rb'
+    - 'spec/client/client-instance_spec.rb'
+    - 'spec/client/configuration-instance_spec.rb'
 
 # Offense count: 3
 # Configuration parameters: EnforcedStyleForLeadingUnderscores.
@@ -91,7 +96,7 @@ Naming/RescuedExceptionsVariableName:
   Exclude:
     - 'lib/crowdin-api/core/request.rb'
 
-# Offense count: 7
+# Offense count: 8
 # Cop supports --auto-correct.
 # Configuration parameters: EnforcedStyle.
 # SupportedStyles: separated, grouped
@@ -106,24 +111,10 @@ Style/CollectionCompact:
   Exclude:
     - 'lib/crowdin-api/core/request.rb'
 
-# Offense count: 12
+# Offense count: 22
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
-  Exclude:
-    - 'spec/**/*'
-    - 'test/**/*'
-    - 'lib/crowdin-api/api-resources/languages.rb'
-    - 'lib/crowdin-api/api-resources/projects.rb'
-    - 'lib/crowdin-api/api-resources/source_files.rb'
-    - 'lib/crowdin-api/api-resources/source_strings.rb'
-    - 'lib/crowdin-api/api-resources/storages.rb'
-    - 'lib/crowdin-api/api-resources/translation_status.rb'
-    - 'lib/crowdin-api/api-resources/translations.rb'
-    - 'lib/crowdin-api/api-resources/workflows.rb'
-    - 'lib/crowdin-api/client/client.rb'
-    - 'lib/crowdin-api/client/configuration.rb'
-    - 'lib/crowdin-api/core/api_errors_raiser.rb'
-    - 'lib/crowdin-api/core/request.rb'
+  Enabled: false
 
 # Offense count: 1
 # Cop supports --auto-correct.
@@ -137,3 +128,19 @@ Style/FrozenStringLiteralComment:
 Style/MixinUsage:
   Exclude:
     - 'bin/crowdin-console'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: implicit, explicit
+Style/RescueStandardError:
+  Exclude:
+    - 'lib/crowdin-api/api-resources/labels.rb'
+    - 'lib/crowdin-api/api-resources/string_translations.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 122

data/README.md

@@ -10,7 +10,7 @@ For more about Crowdin API v2 see the documentation:
 - [Crowdin](https://support.crowdin.com/api/v2/)
 - [Crowdin Enterprise](https://support.crowdin.com/enterprise/api/)
 
-### Status
+## Status
 
 [![Gem](https://img.shields.io/gem/v/crowdin-api?logo=ruby&cacheSeconds=1800)](https://rubygems.org/gems/crowdin-api)
 [![Gem](https://img.shields.io/gem/dt/crowdin-api?cacheSeconds=1800)](https://rubygems.org/gems/crowdin-api)
@@ -22,21 +22,25 @@ For more about Crowdin API v2 see the documentation:
 [![GitHub](https://img.shields.io/github/license/crowdin/crowdin-api-client-ruby?cacheSeconds=1800)](https://github.com/crowdin/crowdin-api-client-ruby/blob/main/LICENSE)
 
 ## Table of Contents
+* [Requirements](#requirements)
 * [Installation](#installation)
 * [Quick Start](#quick-start)
   * [Initialization](#initialization)
-  * [How to call methods](#how-to-call-methods)
+  * [Usage](#usage)
   * [Command-Line Client](#command-line-client)
 * [Seeking Assistance](#seeking-assistance)
 * [Contributing](#contributing)
 * [License](#license)
 
+## Requirements
+* Ruby >= 2.4
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```gemfile
-gem 'crowdin-api', '~> 1.1.0'
+gem 'crowdin-api', '~> 1.2.1'
 ```
 
 And then execute:
@@ -70,12 +74,13 @@ crowdin = Crowdin::Client.new do |config|
   config.api_token = 'YourApiToken'
 end
 
-# Or you can intialize Enterprise Client instance by specifying your organization_domain in config options
+# Or you can intialize Enterprise Client instance by specifying your
+# organization_domain in config options
 crowdin = Crowdin::Client.new do |config|
   config.api_token = 'YourEnterpriseApiToken'
   config.organization_domain = 'YourOrganizationDomain'
 end
-# Note: we use full specified organization domain if that includes .com
+# Note: we use full specified organization domain if that includes '.com'
 # config.organization_domain = your_domain -> https://your_domain.api.crowdin.com
 # config.organization_domain = your_domain.com -> your_domain.com
 
@@ -86,8 +91,8 @@ crowdin = Crowdin::Client.new do |config|
   config.project_id = 'YourProjectId' # [Integer] nil by default
   config.enable_logger = true # [Boolean] false by default
 end
-# Note: Client will initialize default Logger instance if you have specify enable_logger to true,
-# you can change it by crowdin.logger = YourLogger
+# Note: Client will initialize default Logger instance if you have specify
+# enable_logger to true, you can change it by crowdin.logger = YourLogger
 
 # Also you can specify proxy by adding it to ENV['http_proxy'] before Client initialization
 ```
@@ -115,14 +120,20 @@ projects = crowdin.list_projects(offset: 10, limit: 20)
 # Get specified project
 project = crowdin.get_project(your_project_id)
 
+# Edit project
+project = crowdin.edit_project(project_id, [{op: 'replace',
+                                             path: '/name',
+                                             value: 'your_new_project_name'}])
+
 # Add Storage
 storage = crowdin.add_storage(File.open('YourFilename.extension', 'r'))
-# or you can specify only filename
+# or you can specify only absolute path to file
 storage = crowdin.add_storage('YourFilename.extension')
 
 # Download file
-filename = crowdin.download_file(your_destination, your_file_id, your_project_id)
-# your_destination - filename or full path to file
+file = crowdin.download_file(your_file_id, your_destination, your_project_id)
+# your_destination - filename or absolute path to file, optional
+# Without destination option file will be saved to the current directory with a default filename
 # project_id is optional, as it can be initialized with a Crowdin Client
 
 # File revisions
@@ -143,9 +154,9 @@ $ bundle exec crowdin-console --enable-logger --api-token API_TOKEN --project-id
 Or Crowdin Enterprise
 
 ```console
-$ bundle exec crowdin-console --enable-logger --enterprise --api-token API_TOKEN --organization-domain YOUR_DOMAIN --project-id PROJECT_ID
+$ bundle exec crowdin-console --enable-logger --enterprise --api-token API_TOKEN --organization-domain DOMAIN --project-id PROJECT_ID
 ```
-Note: you can specify full organization domain by adding .com
+Note: you can specify full organization domain by adding '.com'
 
 When execute you'll have IRB console with configured *@crowdin* instance
 

data/bin/crowdin-console

@@ -17,7 +17,7 @@ require 'optparse'
 #  bundle exec crowdin-console --enterprise --api-token YOUR_ENTERPRISE_API_TOKEN --organization-domain YOUR_DOMAIN
 #
 
-include Crowdin::Errors::ApiErrorsRaiser
+include Crowdin::Errors::ClcErrorsRaiser
 
 options = {}
 
@@ -27,7 +27,7 @@ OptionParser.new do |opts|
   opts.on('--enterprise', 'Enterprise API')                      { |v| options[:enterprise] = v }
   opts.on('--api-token TOKEN', 'API Token')                      { |v| options[:api_token] = v }
   opts.on('--organization-domain DOMAIN', 'Organization Domain') { |v| options[:organization_domain] = v }
-  opts.on('--project-id ID', 'Project ID')                      { |v| options[:project_id] = v }
+  opts.on('--project-id ID', 'Project ID')                       { |v| options[:project_id] = v }
   opts.on('--enable-logger', 'Enable logger')                    { |v| options[:enable_logger] = v }
 end.parse!
 
@@ -39,8 +39,8 @@ if options[:enterprise]
   @crowdin = Crowdin::Client.new do |config|
     config.api_token           = options[:api_token]
     config.organization_domain = options[:organization_domain]
-    config.enable_logger       = options[:enable_logger]       || false
-    config.project_id          = options[:project_id]          || nil
+    config.enable_logger       = options[:enable_logger] || false
+    config.project_id          = options[:project_id]    || nil
   end
 else
   @crowdin = Crowdin::Client.new do |config|

data/lib/crowdin-api/api-resources/dictionaries.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module ApiResources
+    module Dictionaries
+      def list_dictionaries(query = {}, project_id = config.project_id)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/dictionaries",
+          query
+        )
+
+        request.perform
+      end
+
+      def edit_dictionary(language_id = nil, query = {}, project_id = config.project_id)
+        language_id || raise_parameter_is_required_error(:language_id)
+        project_id  || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :patch,
+          "/projects/#{project_id}/dictionaries/#{language_id}",
+          query
+        )
+
+        request.perform
+      end
+    end
+  end
+end

data/lib/crowdin-api/api-resources/distributions.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module ApiResources
+    module Distributions
+      def list_distributions(query = {}, project_id = config.project_id)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/distributions",
+          query
+        )
+
+        request.perform
+      end
+
+      def add_distribution(query = {}, project_id = config.project_id)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/distributions",
+          query
+        )
+
+        request.perform
+      end
+
+      def get_distribution(hash = nil, project_id = config.project_id)
+        hash       || raise_parameter_is_required_error(:hash)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/distributions/#{hash}"
+        )
+
+        request.perform
+      end
+
+      def delete_distribution(hash = nil, project_id = config.project_id)
+        hash       || raise_parameter_is_required_error(:hash)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :delete,
+          "/projects/#{project_id}/distributions/#{hash}"
+        )
+
+        request.perform
+      end
+
+      def edit_distribution(hash = nil, query = {}, project_id = config.project_id)
+        hash       || raise_parameter_is_required_error(:hash)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :patch,
+          "/projects/#{project_id}/distributions/#{hash}",
+          query
+        )
+
+        request.perform
+      end
+
+      def get_destribution_release(hash = nil, project_id = config.project_id)
+        hash       || raise_parameter_is_required_error(:hash)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/distributions/#{hash}/release"
+        )
+
+        request.perform
+      end
+
+      def release_distribution(hash = nil, project_id = config.project_id)
+        hash       || raise_parameter_is_required_error(:hash)
+        project_id || raise_project_id_is_required_error
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/distributions/#{hash}/release"
+        )
+
+        request.perform
+      end
+    end
+  end
+end

data/lib/crowdin-api/api-resources/glossaries.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module ApiResources
+    module Glossaries
+      def list_glossaries(query = {})
+        request = Web::Request.new(
+          self,
+          :get,
+          '/glossaries',
+          query
+        )
+
+        request.perform
+      end
+
+      def add_glossary(query = {})
+        request = Web::Request.new(
+          self,
+          :post,
+          '/glossaries',
+          query
+        )
+
+        request.perform
+      end
+
+      def get_glossary(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}",
+          query
+        )
+
+        request.perform
+      end
+
+      def delete_glossary(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :delete,
+          "/glossaries/#{glossary_id}",
+          query
+        )
+
+        request.perform
+      end
+
+      def edit_glossary(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :patch,
+          "/glossaries/#{glossary_id}",
+          query
+        )
+
+        request.perform
+      end
+
+      def export_glossary(query = {}, glossary_id = nil, destination = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/glossaries/#{glossary_id}/exports",
+          query,
+          {},
+          destination
+        )
+
+        request.perform
+      end
+
+      def check_glossary_export_status(glossary_id = nil, export_id = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        export_id   || raise_parameter_is_required_error(:export_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}/exports/#{export_id}"
+        )
+
+        request.perform
+      end
+
+      def download_glossary(glossary_id = nil, export_id = nil, destination = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        export_id   || raise_parameter_is_required_error(:export_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}/exports/#{export_id}/download",
+          {},
+          {},
+          destination
+        )
+
+        request.perform
+      end
+
+      def import_glossary(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/glossaries/#{glossary_id}/imports",
+          query
+        )
+
+        request.perform
+      end
+
+      def check_glossary_import_status(glossary_id = nil, import_id = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        import_id   || raise_parameter_is_required_error(:import_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}/imports/#{import_id}"
+        )
+
+        request.perform
+      end
+
+      def list_terms(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}/terms",
+          query
+        )
+
+        request.perform
+      end
+
+      def add_term(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/glossaries/#{glossary_id}/terms",
+          query
+        )
+
+        request.perform
+      end
+
+      def clear_glossary(glossary_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+
+        request = Web::Request.new(
+          self,
+          :delete,
+          "/glossaries/#{glossary_id}/terms",
+          query
+        )
+
+        request.perform
+      end
+
+      def get_term(glossary_id = nil, term_id = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        term_id     || raise_parameter_is_required_error(:term_id)
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/glossaries/#{glossary_id}/terms/#{term_id}"
+        )
+
+        request.perform
+      end
+
+      def delete_term(glossary_id = nil, term_id = nil)
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        term_id     || raise_parameter_is_required_error(:term_id)
+
+        request = Web::Request.new(
+          self,
+          :delete,
+          "/glossaries/#{glossary_id}/terms/#{term_id}"
+        )
+
+        request.perform
+      end
+
+      def edit_term(glossary_id = nil, term_id = nil, query = {})
+        glossary_id || raise_parameter_is_required_error(:glossary_id)
+        term_id     || raise_parameter_is_required_error(:term_id)
+
+        request = Web::Request.new(
+          self,
+          :patch,
+          "/glossaries/#{glossary_id}/terms/#{term_id}",
+          query
+        )
+
+        request.perform
+      end
+    end
+  end
+end