crowdin-api 1.2.1 → 1.3.0

data/spec/api_resources/users_spec.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+describe Crowdin::ApiResources::Users do
+  describe 'Default endpoints' do
+    describe '#get_authenticated_user' do
+      it 'when request are valid', :default do
+        stub_request(:get, "https://api.crowdin.com/#{target_api_url}/user")
+        get_authenticated_user = @crowdin.get_authenticated_user
+        expect(get_authenticated_user).to eq(200)
+      end
+    end
+
+    describe '#list_project_members' do
+      it 'when request are valid', :default do
+        stub_request(:get, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/members")
+        list_project_members = @crowdin.list_project_members({}, project_id)
+        expect(list_project_members).to eq(200)
+      end
+    end
+
+    describe '#get_member_info' do
+      let(:member_id) { 1 }
+
+      it 'when request are valid', :default do
+        stub_request(:get, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/members/#{member_id}")
+        get_member_info = @crowdin.get_member_info(member_id, project_id)
+        expect(get_member_info).to eq(200)
+      end
+    end
+  end
+
+  describe 'Enterprise endpoints' do
+    describe '#add_project_member' do
+      it 'when request are valid', :enterprise do
+        stub_request(:post, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/members")
+        add_project_member = @crowdin.add_project_member({}, project_id)
+        expect(add_project_member).to eq(200)
+      end
+    end
+
+    describe '#get_project_member_permissions' do
+      let(:member_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/members/#{member_id}")
+        get_project_member_permissions = @crowdin.get_project_member_permissions(member_id, project_id)
+        expect(get_project_member_permissions).to eq(200)
+      end
+    end
+
+    describe '#replace_project_permissions' do
+      let(:member_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:put, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/members/#{member_id}")
+        replace_project_permissions = @crowdin.replace_project_permissions(member_id, {}, project_id)
+        expect(replace_project_permissions).to eq(200)
+      end
+    end
+
+    describe '#delete_member_from_project' do
+      let(:member_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:delete, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/members/#{member_id}")
+        delete_member_from_project = @crowdin.delete_member_from_project(member_id, {}, project_id)
+        expect(delete_member_from_project).to eq(200)
+      end
+    end
+
+    describe '#list_users' do
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/users")
+        list_users = @crowdin.list_users
+        expect(list_users).to eq(200)
+      end
+    end
+
+    describe '#invite_user' do
+      it 'when request are valid', :enterprise do
+        stub_request(:post, "https://domain.api.crowdin.com/#{target_api_url}/users")
+        invite_user = @crowdin.invite_user
+        expect(invite_user).to eq(200)
+      end
+    end
+
+    describe '#get_user' do
+      let(:user_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/users/#{user_id}")
+        get_user = @crowdin.get_user(user_id)
+        expect(get_user).to eq(200)
+      end
+    end
+
+    describe '#delete_user' do
+      let(:user_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:delete, "https://domain.api.crowdin.com/#{target_api_url}/users/#{user_id}")
+        delete_user = @crowdin.delete_user(user_id)
+        expect(delete_user).to eq(200)
+      end
+    end
+
+    describe '#edit_user' do
+      let(:user_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:patch, "https://domain.api.crowdin.com/#{target_api_url}/users/#{user_id}")
+        edit_user = @crowdin.edit_user(user_id)
+        expect(edit_user).to eq(200)
+      end
+    end
+  end
+end

data/spec/api_resources/vendors_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+describe Crowdin::ApiResources::Vendors do
+  describe 'Enterprise endpoints' do
+    describe '#list_vendors' do
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/vendors")
+        list_vendors = @crowdin.list_vendors
+        expect(list_vendors).to eq(200)
+      end
+    end
+  end
+end

data/spec/api_resources/webhooks_spec.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+describe Crowdin::ApiResources::Webhooks do
+  describe 'Default endpoints' do
+    describe '#list_webhooks' do
+      it 'when request are valid', :default do
+        stub_request(:get, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/webhooks")
+        list_webhooks = @crowdin.list_webhooks({}, project_id)
+        expect(list_webhooks).to eq(200)
+      end
+    end
+
+    describe '#add_webhook' do
+      it 'when request are valid', :default do
+        stub_request(:post, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/webhooks")
+        add_webhook = @crowdin.add_webhook({}, project_id)
+        expect(add_webhook).to eq(200)
+      end
+    end
+
+    describe '#get_webhook' do
+      let(:webhook_id) { 1 }
+
+      it 'when request are valid', :default do
+        stub_request(:get, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/webhooks/#{webhook_id}")
+        get_webhook = @crowdin.get_webhook(webhook_id, project_id)
+        expect(get_webhook).to eq(200)
+      end
+    end
+
+    describe '#delete_webhook' do
+      let(:webhook_id) { 1 }
+
+      it 'when request are valid', :default do
+        stub_request(:delete, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/webhooks/#{webhook_id}")
+        delete_webhook = @crowdin.delete_webhook(webhook_id, project_id)
+        expect(delete_webhook).to eq(200)
+      end
+    end
+
+    describe '#edit_webhook' do
+      let(:webhook_id) { 1 }
+
+      it 'when request are valid', :default do
+        stub_request(:patch, "https://api.crowdin.com/#{target_api_url}/projects/#{project_id}/webhooks/#{webhook_id}")
+        edit_webhook = @crowdin.edit_webhook(webhook_id, {}, project_id)
+        expect(edit_webhook).to eq(200)
+      end
+    end
+  end
+end

data/spec/api_resources/workflows_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+describe Crowdin::ApiResources::Workflows do
+  describe 'Enterprise endpoints' do
+    describe '#list_workflow_steps' do
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/workflow-steps")
+        list_workflow_steps = @crowdin.list_workflow_steps({}, project_id)
+        expect(list_workflow_steps).to eq(200)
+      end
+    end
+
+    describe '#get_workflow_step' do
+      let(:step_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/projects/#{project_id}/workflow-steps/#{step_id}")
+        get_workflow_step = @crowdin.get_workflow_step(step_id, project_id)
+        expect(get_workflow_step).to eq(200)
+      end
+    end
+
+    describe '#list_workflow_templates' do
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/workflow-templates")
+        list_workflow_templates = @crowdin.list_workflow_templates
+        expect(list_workflow_templates).to eq(200)
+      end
+    end
+
+    describe '#get_workflow_template' do
+      let(:template_id) { 1 }
+
+      it 'when request are valid', :enterprise do
+        stub_request(:get, "https://domain.api.crowdin.com/#{target_api_url}/workflow-templates/#{template_id}")
+        get_workflow_template = @crowdin.get_workflow_template(template_id)
+        expect(get_workflow_template).to eq(200)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,9 +1,27 @@
 # frozen_string_literal: true
 
 require 'simplecov'
-SimpleCov.start
-
 require 'codecov'
+
+SimpleCov.start
 SimpleCov.formatter = SimpleCov::Formatter::Codecov
 
+require 'webmock/rspec'
 require 'crowdin-api'
+
+RSpec.shared_context 'crowdin_client_options' do
+  let(:api_token) { 'api_token' }
+  let(:project_id) { 1 }
+  let(:organization_domain) { 'domain' }
+  let(:full_organization_domain) { 'domain.com' }
+  let(:target_api_url) { 'api/v2' }
+end
+
+RSpec.configure do |config|
+  config.include_context 'crowdin_client_options'
+
+  config.before(:each) do |spec|
+    @crowdin = Crowdin::Client.new { |cfg| cfg.organization_domain = 'domain' } if spec.metadata[:enterprise]
+    @crowdin = Crowdin::Client.new if spec.metadata[:default]
+  end
+end

data/spec/unit/client_spec.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+describe 'Crowdin Client' do
+  it 'should have a list of API Resources' do
+    expect(Crowdin::API_RESOURCES_MODULES).to_not be_nil
+  end
+
+  it 'should have a list of Error Raisers' do
+    expect(Crowdin::ERROR_RAISERS_MODULES).to_not be_nil
+  end
+
+  it 'should have a version' do
+    expect(Crowdin::Client::VERSION).to_not be_nil
+  end
+
+  describe 'Crowdin Client with a default options' do
+    it 'should have a RestClient connection', :default do
+      expect(@crowdin.connection.class).to eq(RestClient::Resource)
+    end
+
+    it 'should have options and headers for RestClient', :default do
+      expect(@crowdin.options.class).to eq(Hash)
+      expect(@crowdin.options).to include(:headers)
+    end
+
+    it 'should have a Config instance', :default do
+      expect(@crowdin.config.class).to eq(Crowdin::Configuration)
+    end
+
+    it 'should have a disabled Logger by default', :default do
+      expect(@crowdin.logger_enabled?).to be_falsey
+      expect(@crowdin.logger).to be_nil
+    end
+
+    it 'should have a disabled Enterprise mode by default', :default do
+      expect(@crowdin.enterprise_mode?).to be_falsey
+    end
+
+    it 'should have a default target api url', :default do
+      expect(@crowdin.config.target_api_url).to eq('/api/v2')
+    end
+    it 'should have a default base url', :default do
+      expect(@crowdin.config.base_url).to eq('https://api.crowdin.com')
+    end
+  end
+
+  describe 'Crowdin Client with enabled Logger' do
+    before do
+      @crowdin = Crowdin::Client.new do |config|
+        config.enable_logger = true
+      end
+    end
+
+    it 'should have a Logger instance' do
+      expect(@crowdin.logger_enabled?).to be_truthy
+      expect(@crowdin.logger.class).to eq(Logger)
+    end
+  end
+
+  describe 'Crowdin Client with enabled Enterprise mode' do
+    before do
+      @crowdin = Crowdin::Client.new do |config|
+        config.organization_domain = organization_domain
+      end
+    end
+
+    it 'should have a generated Enterprise url' do
+      expect(@crowdin.enterprise_mode?).to be_truthy
+      expect(@crowdin.config.base_url).to eq("https://#{organization_domain}.api.crowdin.com")
+    end
+  end
+
+  describe 'Crowdin Client with enabled Enterprise mode and specified full organization domain' do
+    before do
+      @crowdin = Crowdin::Client.new do |config|
+        config.organization_domain = full_organization_domain
+      end
+    end
+
+    it 'should have a generated Enterprise url' do
+      expect(@crowdin.enterprise_mode?).to be_truthy
+      expect(@crowdin.config.base_url).to eq("https://#{full_organization_domain}")
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: crowdin-api
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Crowdin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-10 00:00:00.000000000 Z
+date: 2022-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: open-uri
@@ -84,6 +84,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -132,20 +146,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.23'
-- !ruby/object:Gem::Dependency
-  name: sinatra
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -182,42 +182,63 @@ files:
 - README.md
 - Rakefile
 - bin/crowdin-console
-- bin/setup
 - crowdin-api.gemspec
 - lib/crowdin-api.rb
-- lib/crowdin-api/api-resources/dictionaries.rb
-- lib/crowdin-api/api-resources/distributions.rb
-- lib/crowdin-api/api-resources/glossaries.rb
-- lib/crowdin-api/api-resources/labels.rb
-- lib/crowdin-api/api-resources/languages.rb
-- lib/crowdin-api/api-resources/machine_translation_engines.rb
-- lib/crowdin-api/api-resources/projects.rb
-- lib/crowdin-api/api-resources/reports.rb
-- lib/crowdin-api/api-resources/screenshots.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/string_comments.rb
-- lib/crowdin-api/api-resources/string_translations.rb
-- lib/crowdin-api/api-resources/tasks.rb
-- lib/crowdin-api/api-resources/teams.rb
-- lib/crowdin-api/api-resources/translation_memory.rb
-- lib/crowdin-api/api-resources/translation_status.rb
-- lib/crowdin-api/api-resources/translations.rb
-- lib/crowdin-api/api-resources/users.rb
-- lib/crowdin-api/api-resources/vendors.rb
-- lib/crowdin-api/api-resources/webhooks.rb
-- lib/crowdin-api/api-resources/workflows.rb
+- lib/crowdin-api/api_resources/dictionaries.rb
+- lib/crowdin-api/api_resources/distributions.rb
+- lib/crowdin-api/api_resources/glossaries.rb
+- lib/crowdin-api/api_resources/labels.rb
+- lib/crowdin-api/api_resources/languages.rb
+- lib/crowdin-api/api_resources/machine_translation_engines.rb
+- lib/crowdin-api/api_resources/projects.rb
+- lib/crowdin-api/api_resources/reports.rb
+- lib/crowdin-api/api_resources/screenshots.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/string_comments.rb
+- lib/crowdin-api/api_resources/string_translations.rb
+- lib/crowdin-api/api_resources/tasks.rb
+- lib/crowdin-api/api_resources/teams.rb
+- lib/crowdin-api/api_resources/translation_memory.rb
+- lib/crowdin-api/api_resources/translation_status.rb
+- lib/crowdin-api/api_resources/translations.rb
+- lib/crowdin-api/api_resources/users.rb
+- lib/crowdin-api/api_resources/vendors.rb
+- lib/crowdin-api/api_resources/webhooks.rb
+- lib/crowdin-api/api_resources/workflows.rb
 - lib/crowdin-api/client/client.rb
 - lib/crowdin-api/client/configuration.rb
 - lib/crowdin-api/client/version.rb
 - lib/crowdin-api/core/errors.rb
 - lib/crowdin-api/core/errors_raisers.rb
 - lib/crowdin-api/core/request.rb
-- lib/crowdin-api/core/utils.rb
-- spec/client/client-instance_spec.rb
-- spec/client/configuration-instance_spec.rb
+- lib/crowdin-api/core/send_request.rb
+- spec/api_resources/dictionaries_spec.rb
+- spec/api_resources/distributions_spec.rb
+- spec/api_resources/glossaries_spec.rb
+- spec/api_resources/labels_spec.rb
+- spec/api_resources/languages_spec.rb
+- spec/api_resources/machine_translation_engines_spec.rb
+- spec/api_resources/projects_spec.rb
+- spec/api_resources/reports_spec.rb
+- spec/api_resources/screenshots_spec.rb
+- spec/api_resources/source_files_spec.rb
+- spec/api_resources/source_strings_spec.rb
+- spec/api_resources/storages_spec.rb
+- spec/api_resources/string_comments_spec.rb
+- spec/api_resources/string_translations_spec.rb
+- spec/api_resources/tasks_spec.rb
+- spec/api_resources/teams_spec.rb
+- spec/api_resources/translation_memory_spec.rb
+- spec/api_resources/translation_status_spec.rb
+- spec/api_resources/translations_spec.rb
+- spec/api_resources/users_spec.rb
+- spec/api_resources/vendors_spec.rb
+- spec/api_resources/webhooks_spec.rb
+- spec/api_resources/workflows_spec.rb
 - spec/spec_helper.rb
+- spec/unit/client_spec.rb
 homepage: https://github.com/crowdin/crowdin-api-client-ruby
 licenses:
 - MIT

data/bin/setup

@@ -1,6 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-IFS=$'\n\t'
-
-bundle install

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

@@ -1,82 +0,0 @@
-# frozen_string_literal: true
-
-module Crowdin
-  module ApiResources
-    module Languages
-      def list_languages(query = {})
-        request = Web::Request.new(
-          self,
-          :get,
-          '/languages',
-          query
-        )
-
-        request.perform
-      end
-
-      #
-      # Add custom language.
-      #
-      # === Parameters
-      #
-      # * +:name+ [String] - Language name
-      # * +:code+ [String] - Custom language code
-      # * +:localeCode+ [String] - Custom language locale code
-      # * +:textDirection+ [String ltr/rtl] - Text direction in custom language
-      # * +:pluralCategoryNames+ [String] - Array with category names
-      # * +:threeLettersCode+ [String] - Custom language 3 letters code. Format: ISO 6393 code
-      #
-      # === Example
-      #
-      #  crowdin.add_custom_language(name: 'your_name', code: 'your_code' ..)
-      #
-      def add_custom_language(query = {})
-        request = Web::Request.new(
-          self,
-          :post,
-          '/languages',
-          query
-        )
-
-        request.perform
-      end
-
-      def get_language(language_id = nil)
-        language_id || raise_parameter_is_required_error(:language_id)
-
-        request = Web::Request.new(
-          self,
-          :get,
-          "/languages/#{language_id}"
-        )
-
-        request.perform
-      end
-
-      def delete_custom_language(language_id = nil)
-        language_id || raise_parameter_is_required_error(:language_id)
-
-        request = Web::Request.new(
-          self,
-          :delete,
-          "/languages/#{language_id}"
-        )
-
-        request.perform
-      end
-
-      def edit_custom_language(language_id = nil)
-        language_id || raise_parameter_is_required_error(:language_id)
-
-        request = Web::Request.new(
-          self,
-          :patch,
-          "/languages/#{language_id}",
-          query
-        )
-
-        request.perform
-      end
-    end
-  end
-end

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

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-module Crowdin
-  module ApiResources
-    # -- For Enterprise mode only --
-    module MachineTranslationEngines
-      def list_mts(query = {})
-        config.enterprise_mode? || raise_only_for_enterprise_mode_error
-
-        request = Web::Request.new(
-          self,
-          :get,
-          '/mts',
-          query
-        )
-
-        request.perform
-      end
-
-      def add_mt(query = {})
-        config.enterprise_mode? || raise_only_for_enterprise_mode_error
-
-        request = Web::Request.new(
-          self,
-          :post,
-          '/mts',
-          query
-        )
-
-        request.perform
-      end
-
-      def get_mt(mt_id = nil)
-        config.enterprise_mode? || raise_only_for_enterprise_mode_error
-        mt_id                   || raise_parameter_is_required_error(:mt_id)
-
-        request = Web::Request.new(
-          self,
-          :get,
-          "/mts/#{mt_id}"
-        )
-
-        request.perform
-      end
-
-      def delete_mt(mt_id = nil)
-        config.enterprise_mode? || raise_only_for_enterprise_mode_error
-        mt_id                   || raise_parameter_is_required_error(:mt_id)
-
-        request = Web::Request.new(
-          self,
-          :delete,
-          "/mts/#{mt_id}"
-        )
-
-        request.perform
-      end
-
-      def edit_mt(mt_id = nil, query = {})
-        config.enterprise_mode? || raise_only_for_enterprise_mode_error
-        mt_id                   || raise_parameter_is_required_error(:mt_id)
-
-        request = Web::Request.new(
-          self,
-          :patch,
-          "/mts/#{mt_id}",
-          query
-        )
-
-        request.perform
-      end
-    end
-  end
-end