kapellmeister 0.9.6 → 0.9.8.pre.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe79b6fb67ba56c68ef8f1ae0c8f617856027bd63092193f32c11ced913db7f8
-  data.tar.gz: 80f2ff06ffcb6b91da5610162d52a5c8648d60a0d22991ffe90a175998424bf3
+  metadata.gz: 99ce5281393820ffbe1e587d005ad8c6f35a4a77bd88017030cb0e24feef6fcb
+  data.tar.gz: bc1a35d749f037cdda5b82269956be5b3c1658838938b865adc41f7104ce8e26
 SHA512:
-  metadata.gz: acfe492025285fe11843ba4bdd3a911f793ae3c980afb46281b9490df7096005f246f585722587d2103d1d56f9b4568aa3082392f29640fff61f35c5fd1926bb
-  data.tar.gz: 916c8280053a15b9fbccfc7ddab4941219d1309331b019e40879523fe0b05300ba802d5ad306e4492245a47871e919aca8c184f0cab17ad581d56fa24dfd18be
+  metadata.gz: 2f8305458750ff7d76137b5f7876408d58f143f62f4df71d6f1b6804ba1833c10bab330a60dc53d547bcb834f518bdd83707a2e8c28d3fe1d44d5453c387dcd5
+  data.tar.gz: 8f28026eb58e6ec347a3ce99afb17ff26809b9e299005203fa15b523241c5c252cb2817cee208785b10a07f9d2b5f87ba2d2cc336ae8607d9fb351f4d24cf17f

data/Gemfile

@@ -6,9 +6,9 @@ gemspec
 
 gem 'dry-schema'
 gem 'faraday'
-gem 'faraday_middleware'
+gem 'faraday-follow_redirects'
 gem 'faraday-cookie_jar'
-gem 'typhoeus'
+gem 'faraday-typhoeus'
 
 # debug
 group :development do
@@ -23,6 +23,6 @@ group :development, :test do
   gem 'rubocop', require: false
   gem 'rubocop-performance'
   gem 'rubocop-rspec'
-  gem 'rubycritic', require: false
+  gem 'rubycritic', '~> 4.9.1', require: false
   gem 'ruby_gntp'
 end

data/README.md

@@ -1,3 +1,132 @@
+# Диспетчер HTTP-запросов
+
+Этот шаблонизатор позволяет вам определять http-запросы к любым сторонним API с помощью упрощенного набора инструкций, включая анализатор маршрутов в формате yaml
+## Использование
+
+Добавьте kapellmeister в свой Gemfile:
+На данный момент послденяя версия 0.9.8 (Проект находится в стадии тестирования работоспособности, beta-test)
+```ruby
+gem 'kapellmeister', '~> 0.9.8'
+```
+
+### Добавьте новую конфигурацию для стороннего API:
+
+    $ bin/rails g kapellmeister:add_service %<ThirdPartyName> %<options> --%<flags>
+
+`ThirdPartyName` — Имя сервиса, может быть указан как КэмелКейсом (CamelCase) так и с нижним_подчёркиванием (under_scored)
+
+`options` — Укажите ключи конфигурации, обычно это хост, ключ и версия
+
+`flags` — Этот шаблонзатор пока что имеет один флаг.
+Флаг `responder`, `false` — значение по-умолчанию.
+Если вы установите для него значение `true`, то будет сгенерирован файл responder.rb используемый для анализа и парсинга ответа.
+
+Все инструкции — это легковесные файлы в каталоге /lib вашего приложения.
+Вот пример структуры:
+
+``` Capfile
+└── app
+    └── lib
+        └── third_party_service
+            ├── client.rb
+            ├── configuration.rb
+            ├── responder.rb (опционально)
+            └── routes.yml
+        └── third_party_service.rb  
+└── initializers
+    └── third_party_service.rb
+```
+
+Если вы используете Rails, в вашем приложении есть папка `initializers`. Добавьте секретные ключи в файле-инициализаторе
+
+    initializers/third_party_service.rb
+
+Основной файл вашей интеграции, миксин, включающий Kapellmeister::Base
+
+    app/lib/third_party_service.rb
+
+Каталог, содержащий `routes scheme`, `client`, `configuration` и опциональный `responder`.
+
+    app/lib/third_party_service
+
+
+
+`routes.yml` — Маршруты к стороннему API во вложенном формате.
+
+``` yaml
+foo:                     => Обёртка для метода
+  bar:                   => Наименование метода
+    scheme:              => Описание схемы
+      method: POST       => Тип запроса (* обязательный параметр!)
+      use_wrapper: true  => Обёрнуть ли метод для обеспечения уникальности. По умолчанию true
+      path: buz          => Настоящий путь (роут). Если параметра нет, то путь будет взят из наименования метода.
+      body:              => Dry-scheme (из набора гемов DRY) для проверки параметров. Если параметра нет, то проверки не будет.
+      query_params:      => Описание query-параметров. Если параметра нет, то подстановки параметров не будет.
+      mock:              => Структура или путь к файлу mock для тестов. Если параметра нет, в среде разработки будет возвращён реальный ответ на запрос.
+
+# Результат из примера выше:
+# client = ThirdParty::Client.new
+# client.foo_bar { a: 'b' } 
+# => POST https://third_party.com/foo/buz DATA: { a: 'b' }
+```
+#### Пояснение к параметрам:
+
+`body` — Вы можете использовать dry-scheme (из набора гемов DRY) для проверки параметров запроса.
+Если этот ключ не существует, проверка будет пропущена.
+Пример:
+
+```yaml
+body: DrySchema
+```
+
+`query_params` — Если для запроса требуется query-параметры.
+Работают как массивы, так и руби-хэши.
+Если этот ключ не существует, то подстановки параметров и их проверки не будет.
+For example:
+
+```yaml
+query_params:
+  dbAct: getCities       => Пример использования известных и неизменяемых параметров
+  optional:              => Пример использования опциональных параметров. Они будут подставлены при передачи их при запросе
+    - city
+    - state
+
+# Результат из примера выше:
+# /api?dbAct=getCities&city=Tokio
+```
+```yaml
+query_params:
+  - dbAct: getTarif
+  - org                => Пример использования обязательных параметров.
+  - dest
+  - weight
+  
+# Результат из примера выше:
+# /api?dbAct=getTarif&org=Tokio&dest=Beijing&weight=100
+```
+
+`mock` — Если вам нужно, чтобы реальные запросы не проходили во время тестирования,
+вы можете заменить их на mocks.
+Можно использовать как структуру yaml, так и путь к файлу yaml.
+Например:
+
+```yaml
+mock: spec/mocks/http_clients/public/cities.yml
+```
+
+#### Объяснение сгенерированных файлов
+
+`client.rb` — Унаследованный файл от главного диспетчера, и вы можете добавить некоторые методы настройки, пользовательские заголовки, параметры запросов, query-параметры.
+
+`configuration.rb` — Добавляем путь к стороннему API, URL-адрес конфигурации и логгер.
+
+`responder.rb` — По умолчанию используется стандартный обработчик ответов, обработанный в формате json. Но вы можете написать свой собственный.
+
+
+
+---
+### english
+
 # HTTP requests dispatcher
 
 This template-service allows you to define http requests to a third party through a lightweight set of instructions, including a route parser in yaml format
@@ -5,20 +134,25 @@ This template-service allows you to define http requests to a third party throug
 ## Usage
 
 Add kapellmeister to your Gemfile:
-
+At the moment, the latest version is 0.9.8 (The project is in the stage of performance testing, beta-test)
 ```ruby
-gem 'kapellmeister', '~> 0.4.1'
+gem 'kapellmeister', '~> 0.9.6'
 ```
 
-### Add new third party configuration:
+### Add a new configuration for the third-party API:
 
     $ bin/rails g kapellmeister:add_service %<ThirdPartyName> %<options> --%<flags>
 
-`ThirdPartyName` — Pass the lib name, either CamelCased or under_scored
-`options` — Pass the configuration keys, usually host, key and version
-`flags` — This generator have one flag. This flag is `responder`, default is `false`. If you set to `true` will be generated responder.rb used for parsing response.
+`ThirdPartyName` — The name of the service, can be specified either CamelCased or under_scored
+
+`options` — Specify the configuration keys, usually `host`, `key` and `version`
 
-All the instructions are lightweight files in your /lib folder. Here's the example of structure:
+`flags` — This generator has only one flag so far.
+The `responder` flag, `false` is the default value.
+If you set it to `true`, the responder.rb file will be generated, which is used for analyzing and parsing the response.
+
+All instructions are lightweight files in the /lib directory of your application.
+Here is an example of the structure:
 
 ``` Capfile
 └── app
@@ -35,36 +169,86 @@ All the instructions are lightweight files in your /lib folder. Here's the examp
 
     initializers/third_party_service.rb
 
-If you use the Rails gem you have the `initializers` folder in your application. Add the secret keys to config.
+If you are using Rails gem, there is a `initializers` folder in your application. Add the secret keys in the initializer file.
 
     app/lib/third_party_service.rb
 
-Main file of your integration. Make it module and include the Kapellmeister::Base
+The main file of your integration, a mixin that includes Kapellmeister::Base
 
     app/lib/third_party_service
 
-Folder contains `routes scheme`, `client`, `configuration` and optional `responder`.
+A directory containing `routes scheme`, `client`, `configuration` and an optional `responder`.
 
-`routes.yml` — Routes to third party in nested format.
+`routes.yml` — Routes to a third-party API in a nested format.
 
 ``` yaml
-foo:                     => Wrapper for method
-  bar:                   => Method name
-    scheme:              => Scheme description
-      method: POST       => Request type
-      use_wrapper: true  => Default true
-      path: buz          => Real path
-      mock:              => Mock for development
-        token: blablabla
-
-# ThirdParty::Client.foo_bar { a: 'b' } => POST https://third_party.com/foo/buz DATA: { a: 'b' }
+foo:                     => Wrapper of the method
+  bar:                   => Name of the method
+    scheme:              => Description of the scheme
+      method: POST       => Request type (* required)
+      use_wrapper: true  => Whether to wrap the method to ensure uniqueness. By default, true
+      path: buz          => The real path (route). If there is no parameter, the path will be taken from the method name.
+      body:              => Dry-scheme (from the set of DRY gems) to check the parameters. If there is no parameter, then there'll be no verification.
+      query_params:      => Description of the query parameters. If there is no parameter, then there'll be no parameter substitution.
+      mock:              => The structure or path to the mock file for the tests. If there is no parameter, the actual response to the request will be returned in the development environment.
+
+# The result from the example above:
+# client = ThirdParty::Client.new
+# client.foo_bar { a: 'b' } 
+# => POST https://third_party.com/foo/buz DATA: { a: 'b' }
+```
+#### Explanation of the parameters:
+
+`body` — You can use the dry-scheme (from the set of DRY gems) to check the request parameters.
+If this key doesn't exist, the verification will be skipped.
+Example:
+
+```yaml
+body: DrySchema
+```
+
+`query_params` — If the request requires query parameters.
+Both arrays and ruby-hashes work.
+If this key doesn't exist, then there'll be no parameter substitution and validation.
+Example:
+
+```yaml
+query_params:
+  dbAct: getCities       => Example of using known and immutable parameters
+  optional:              => An example of using optional parameters. They'll be substituted when they are transmitted during the request
+    - city
+    - state
+
+# The result from the example above:
+# /api?dbAct=getCities&city=Tokio
+```
+```yaml
+query_params:
+  - dbAct: getTarif
+  - org                => Example of using required parameters.
+  - dest
+  - weight
+
+# The result from the example above:
+# /api?dbAct=getTarif&org=Tokio&dest=Beijing&weight=100
 ```
 
-`client.rb` — Nested from main dispatcher and you can add some configuration methods, custom headers and requests options.
+`mock` —  If you need real requests not to pass during testing,
+you can replace them with mocks.
+You can use both the yaml structure and the path to the yaml-file.
+Example:
+
+```yaml
+mock: spec/mocks/http_clients/public/cities.yml
+```
+
+#### Explanation of the generated files
+
+`client.rb` — An inherited file from the main dispatcher, and you can add some configuration methods, custom headers, request parameters, query-parameters.
 
-`configuration.rb` — Add path to third party, config url and logger
+`configuration.rb` — Add the path to the third-party API, the configuration URL and the logger.
 
-`responder.rb` — By default uses standard responders parsed response in json. But you can write your own.
+`responder.rb` —  By default, a standard response handler is used, parsed in json format. But you can write your own.
 
 ## Contributing
 

data/kapellmeister.gemspec

@@ -14,11 +14,9 @@ Gem::Specification.new do |gem|
 
   gem.license       = 'MIT'
 
-  if gem.respond_to?(:metadata)
-    gem.metadata['allowed_push_host'] = 'https://rubygems.org'
-  else
-    fail 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
-  end
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless gem.respond_to?(:metadata)
+
+  gem.metadata['allowed_push_host'] = 'https://rubygems.org'
 
   gem.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(/^(test|spec|features)/) }
   gem.bindir        = 'exe'
@@ -27,16 +25,16 @@ Gem::Specification.new do |gem|
 
   gem.required_ruby_version = '>= 2.4.2'
 
-  gem.add_dependency 'dry-schema', '~> 1.7'
-  gem.add_dependency 'faraday', '~> 1.0'
+  gem.add_dependency 'dry-schema', '~> 1.9.1'
+  gem.add_dependency 'faraday', '~> 2.10'
   gem.add_dependency 'faraday-cookie_jar', '~> 0.0.7'
-  gem.add_dependency 'faraday_middleware', '~> 1.2'
-  gem.add_dependency 'typhoeus', '~> 1.4.0'
+  gem.add_dependency 'faraday-follow_redirects', '~> 0.3.0'
+  gem.add_dependency 'faraday-typhoeus', '~> 1.1.0'
 
   gem.add_development_dependency 'bundler', '~> 2.0', '>= 2.0.2'
   gem.add_development_dependency 'rake', '~> 13.0'
   gem.add_development_dependency 'redcarpet', '~> 1.17', '>= 1.17.0'
-  gem.add_development_dependency 'rubocop', '~> 1.21'
+  gem.add_development_dependency 'rubocop', '~> 1.6'
   gem.add_development_dependency 'yard', '~> 0.7', '>= 0.7.5'
   gem.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/generators/kapellmeister/add_service_generator.rb

@@ -50,8 +50,3 @@ module Kapellmeister
     end
   end
 end
-
-# ROUTES = Dir['app/lib/yandex_taxi/route_scheme/**/*.yml'].each_with_object({}) do |file, result|
-#   routes = ::Kapellmeister::Base.routes_scheme_parse(file)
-#   result.merge!(routes)
-# end

data/lib/generators/kapellmeister/templates/lib/third_party/routes.yml.tt

@@ -3,8 +3,8 @@
 #     bar:                  => Method name
 #       scheme:             => Scheme description
 #         method: POST      => Request type (* required)
-#         use_wrapper: true => Default true (* required)
-#         path: buz         => Real path (* required)
+#         use_wrapper: true => Default true
+#         path: buz         => Real path
 #         body:             => Dry schema for checking parameters. If key doesn't exist nothing happens
 #         query_params:     => Query params. If key doesn't exist nothing happens
 #         mock:             => Structure or Path to mock file for tests. If key doesn't exist nothing happens

data/lib/kapellmeister/base.rb

@@ -37,10 +37,12 @@ end
 def generate_routes(json_scheme)
   json_scheme.dup.each_with_object({}) do |(key, value), scheme|
     scheme[key] = value.delete(:scheme) if (value.is_a?(Hash) && value.key?(:scheme)) || value.is_a?(String)
-    next if value.nil? || value.length.zero?
+    next if value.nil? || value.empty?
 
     generate_routes(value).map { |deep_key, deep_value| mapping(deep_key, deep_value, key, scheme) }
   end
+rescue TypeError
+  raise "It seems like wrong routes scheme. #{json_scheme}"
 end
 
 def mapping(deep_key, deep_value, key, scheme)

data/lib/kapellmeister/dispatcher.rb

@@ -1,12 +1,12 @@
-require 'faraday_middleware'
-require_relative './requests_extension'
+require 'faraday/follow_redirects'
+require_relative 'requests_extension'
 
 class Kapellmeister::Dispatcher
   def self.new(**args)
-    main_klass = self.module_parent.name.delete('::')
+    main_klass = module_parent.name&.delete('::')
 
-    self.module_parent.requests.each do |request|
-      self.include Kapellmeister::RequestsExtension.request_processing(main_klass, request)
+    module_parent.requests.each do |request|
+      include Kapellmeister::RequestsExtension.request_processing(main_klass, request)
     end
     super(**args)
   end
@@ -44,7 +44,7 @@ class Kapellmeister::Dispatcher
     generated_connection = connection(additional_headers: additional_headers, requests_data: requests_data) # rubocop:disable Style/HashSyntax (for support ruby 2.4+)
 
     process generated_connection.run_request(method_name.downcase.to_sym,
-                                             url_with_params(path),
+                                             url_with_params(path, data, method_name),
                                              data_json,
                                              additional_headers)
 
@@ -60,7 +60,7 @@ class Kapellmeister::Dispatcher
       faraday.request :multipart
       faraday.response :logger, logger
       faraday.response :json, content_type: 'application/json; charset=utf-8'
-      faraday.use FaradayMiddleware::FollowRedirects, limit: 5
+      faraday.response :follow_redirects
       faraday.adapter :typhoeus do |http|
         http.timeout = 20
       end
@@ -90,15 +90,21 @@ class Kapellmeister::Dispatcher
     report(data).result
   end
 
-  def url_with_params(url)
+  def url_with_params(url, data, method_name)
     url = url.split('/').map do |url_part|
       url_part.ascii_only? ? url_part : CGI.escape(url_part)
     end.join('/')
 
+    url = url_repacking(url, data) if method_name == 'GET'
+
     return url if query_params.blank?
 
+    url_repacking(url, query_params)
+  end
+
+  def url_repacking(url, queries)
     uri = URI(url)
-    params = URI.decode_www_form(uri.query || '').to_h.merge(query_params)
+    params = URI.decode_www_form(uri.query || '').to_h.merge(queries)
     uri.query = URI.encode_www_form(params)
     uri.to_s
   end

data/lib/kapellmeister/requests_extension.rb

@@ -3,7 +3,7 @@ module Kapellmeister::RequestsExtension
     mod = if Object.const_defined?("#{self}::#{klass}InstanceMethods")
             const_get("#{self}::#{klass}InstanceMethods")
           else
-            const_set("#{klass}InstanceMethods", Module.new)
+            const_set(:"#{klass}InstanceMethods", Module.new)
           end
 
     mod.module_eval do
@@ -37,7 +37,7 @@ def parsed_query(params, data)
 
   hash_data, filtered_query = *split_hashes(params)
   required_empty_query, default_data = *hash_data.partition { |elem| elem.values.compact_blank.blank? }
-  data = Hash[filtered_query.zip].compact_blank.merge(data) if data.is_a?(Hash)
+  data = filtered_query.zip([]).to_h.compact_blank.merge(data) if data.is_a?(Hash)
   _optional_data, default_data = *split_optional(default_data)
   data = data.merge(default_data) if !data.blank? || !default_data.blank?
 
@@ -63,7 +63,7 @@ end
 def generate_full_path(original_path, data)
   path = generate_path(original_path, data)
   query = data.delete(:query_params)&.to_query
-  return "?#{query}" unless path
+  return "?#{query}" if path.blank?
 
   [path, query].compact_blank!.join('?')
 end
@@ -79,7 +79,7 @@ def generate_path(original_path, data)
 end
 
 def valid_body?(data, body)
-  return if body.blank? || body.is_a?(Hash)
+  return true if body.blank? || body.is_a?(Hash)
 
   schema = Object.const_get(body).schema
   result = schema.call(data)
@@ -89,7 +89,7 @@ def valid_body?(data, body)
 end
 
 def valid_query?(data, query)
-  return if query.blank?
+  return true if query.blank?
 
   required_keys = query.map(&:to_sym)
 
@@ -99,7 +99,7 @@ def valid_query?(data, query)
   data[:query_params] = data[:query_params].to_h.merge!(from_data)
 
   different_keys = data[:query_params].transform_keys(&:to_sym)
-  return if required_keys.all? { |key| different_keys.key? key.to_sym }
+  return true if required_keys.all? { |key| different_keys.key? key.to_sym }
 
   raise ArgumentError, "Query params needs keys #{required_keys}"
 end

data/lib/kapellmeister/version.rb

@@ -1,3 +1,3 @@
 module Kapellmeister
-  VERSION = '0.9.6'.freeze
+  VERSION = '0.9.8-rc1'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kapellmeister
 version: !ruby/object:Gem::Version
-  version: 0.9.6
+  version: 0.9.8.pre.rc1
 platform: ruby
 authors:
 - DarkWater
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-13 00:00:00.000000000 Z
+date: 2024-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-schema
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 1.9.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 1.9.1
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.10'
 - !ruby/object:Gem::Dependency
   name: faraday-cookie_jar
   requirement: !ruby/object:Gem::Requirement
@@ -53,33 +53,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.0.7
 - !ruby/object:Gem::Dependency
-  name: faraday_middleware
+  name: faraday-follow_redirects
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
-  name: typhoeus
+  name: faraday-typhoeus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -140,14 +140,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.21'
+        version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.21'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -206,7 +206,7 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -217,12 +217,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.4.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.3.7
-signing_key: 
+signing_key:
 specification_version: 4
 summary: HTTP requests dispatcher
 test_files: []