antbird 0.15.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e72bd2b5755abdb64e991345baab5cdca8320fa1f511753e9c8845245b03427
-  data.tar.gz: 427b4282927adafe574eda5151c6b9abe5023bf03c148348deee995569264adb
+  metadata.gz: 472e058c1be7a6fdadf9949dc8c73c644ba5c82f3eea3b76fc502623fac4bea8
+  data.tar.gz: 35d0eff4b83b58a11f9299fca6210922f3243b3c166d7cc20385492bebf80570
 SHA512:
-  metadata.gz: 23752fde1a9a786036e97cc0fb3fd5d99ed803d5cdfdf2c5cdde557f4ffca28653f929e97f77d818eb5ee2437d10a6f7937a499b4f48be828674da984c84c00a
-  data.tar.gz: 0e6472c29d2ea5736a24898b0306310ce13b1f26bd93d2c84d09d54a8bfa8ddbb8b3defa0f0ed27389429bef1e434568f6ec11910e75f083f00b27d102f39575
+  metadata.gz: 569096a452fa059ee7527a8fc48a372fc0c7aa1c6001f467b0ce355240656ac787ae6a4ecdc7065d54d1c3daeecc31bbdc812304e023b5fafe32a0669b770838
+  data.tar.gz: d0c653d432e0ea31f1e98cc56b5486f126d1697483efae7a4f66f31e0b73669d2a5387be8d41b19e8a9759374df635791d88e3814c16d149001ac0b380c7de28

data/.github/workflows/build-os.yml

@@ -13,34 +13,12 @@ jobs:
       matrix:
         # https://github.com/opensearch-project/OpenSearch/releases
         search_versions:
+          - 3.5.0
+          - 3.4.0
           - 3.3.2
           - 3.2.0
           - 3.1.0
           - 3.0.0
-          - 2.19.4
-          - 2.18.0
-          - 2.17.1
-          - 2.16.0
-          - 2.15.0
-          - 2.14.0
-          - 2.13.0
-          - 2.12.0
-          - 2.11.1
-          - 2.10.0
-          - 2.9.0
-          - 2.8.0
-          - 2.7.0
-          - 2.6.0
-          - 2.5.0
-          - 2.4.1
-          - 2.3.0
-          - 2.2.1
-          - 2.1.0
-          - 2.0.1
-          - 1.3.20
-          - 1.2.4
-          - 1.1.0
-          - 1.0.0
     services:
       opensearch:
         image: opensearchproject/opensearch:${{matrix.search_versions}}
@@ -49,7 +27,8 @@ jobs:
         env:
           discovery.type: single-node
           plugins.security.disabled: true
-          OPENSEARCH_INITIAL_ADMIN_PASSWORD: StrongPassowrd123
+          # a minimum 8 character password and must contain at least one uppercase letter, one lowercase letter, one digit, and one special character that is strong. Password strength can be tested here: https://lowe.github.io/tryzxcvbn
+          OPENSEARCH_INITIAL_ADMIN_PASSWORD: "antbird@123Antbird"
     steps:
       - name: Configure sysctl limits
         run: |
@@ -60,8 +39,8 @@ jobs:
       - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: "3.2"
+          ruby-version: "4.0"
           bundler-cache: true
       - name: Wait for OpenSearch
-        run: timeout 60 bash -c "until curl --silent --output /dev/null 'localhost:9200/_cat/health?h=st'; do printf '.'; sleep 5; done; printf '\n'"
+        run: timeout 120 bash -c "until curl --silent --output /dev/null 'localhost:9200/_cat/health?h=st'; do printf '.'; sleep 5; done; printf '\n'"
       - run: bundle exec rspec

data/.gitignore

@@ -10,6 +10,6 @@
 # rspec failure tracking
 .rspec_status
 
-Gemfile.lock
-
 .envrc
+
+.claude/settings.local.json

data/Gemfile.lock

@@ -0,0 +1,66 @@
+PATH
+  remote: .
+  specs:
+    antbird (1.0.0)
+      faraday (>= 2.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    connection_pool (3.0.2)
+    diff-lcs (1.6.2)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    faraday-net_http_persistent (2.3.1)
+      faraday (~> 2.5)
+      net-http-persistent (>= 4.0.4, < 5)
+    faraday-retry (2.4.0)
+      faraday (~> 2.0)
+    json (2.19.2)
+    logger (1.7.0)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    net-http-persistent (4.0.8)
+      connection_pool (>= 2.2.4, < 4)
+    octokit (10.0.0)
+      faraday (>= 1, < 3)
+      sawyer (~> 0.9)
+    public_suffix (7.0.5)
+    rake (13.3.1)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    sawyer (0.9.3)
+      addressable (>= 2.3.5)
+      faraday (>= 0.17.3, < 3)
+    uri (1.1.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  antbird!
+  faraday-net_http_persistent
+  faraday-retry
+  octokit
+  rake (~> 13.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+  4.0.8

data/README.md

@@ -1,8 +1,8 @@
 # Antbird
 
-Nearly auto-generated Elasticsearch/OpenSearch client
+Nearly auto-generated OpenSearch client (supports OpenSearch 3.x)
 
-[![Build Status](https://github.com/fukayatsu/antbird/workflows/build/badge.svg)](https://github.com/fukayatsu/antbird/actions)
+[![Build Status](https://github.com/fukayatsu/antbird/workflows/build-os/badge.svg)](https://github.com/fukayatsu/antbird/actions)
 
 ## Installation
 
@@ -29,7 +29,7 @@ client = Antbird::Client.new
 
 # OR
 
-client = Antbird::Client.new.scoped(index: 'test-index', type: 'test-type')
+client = Antbird::Client.new.scoped(index: 'test-index')
 
 # OR
 
@@ -37,19 +37,17 @@ client = Antbird::Client.new(
   url: 'http://localhost:9200',
   scope: {
     index: 'test-index',
-    type: 'test-type'
   }
 )
 
-# OR
+# OR with AWS OpenSearch Service
 
 require 'faraday/net_http_persistent'
 require 'faraday_middleware/aws_sigv4'
 client = Antbird::Client.new(
-  url: ENV['AMAZON_ELASTICSEARCH_SERVICE_URL'],
+  url: ENV['AMAZON_OPENSEARCH_SERVICE_URL'],
   scope: {
     index: 'test-index',
-    type: 'test-type'
   },
   adapter: :net_http_persistent
 ) do |f|
@@ -68,7 +66,7 @@ end
 
 ```ruby
 client = Antbird::Client.new(
-  scope: { index: 'test-index', type: 'test-type' }
+  scope: { index: 'test-index' }
 )
 
 client.indices_exists? # => false
@@ -76,10 +74,8 @@ client.indices_create(
   body: {
     settings: { number_of_shards: 1 },
     mappings: {
-      'test-type': {
-        properties: {
-          field1: { type: :text }
-        }
+      properties: {
+        field1: { type: :text }
       }
     }
   }
@@ -113,9 +109,9 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/fukayatsu/antbird. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
-### How to support newer version of Elasticsearch/OpenSearch
+### How to support newer version of OpenSearch
 
-1. Add Elasticsearch version to `jobs.build.strategy.matrix.search_versions` on `.github/workflows/build.yml` / `.github/workflows/build-os.yml`
+1. Add OpenSearch version to `jobs.build.strategy.matrix.search_versions` on `.github/workflows/build-os.yml`
    - Only one line for `x.y.*` version
 1. `script/generate_api_methods`
    - Set `GITHUB_TOKEN=***` env for GitHub API Limit
@@ -126,4 +122,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Antbird project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/fukayatsu/antbird/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Antbird project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/fukayatsu/antbird/blob/master/CODE_OF_CONDUCT.md).

data/antbird.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["fukayatsu"]
   spec.email         = ["fukayatsu@gmail.com"]
 
-  spec.summary       = %q{Nearly auto-generated Elasticsearch client}
-  spec.description   = %q{Antbird is a yet another low level API client for the Elasticsearch HTTP interface.}
+  spec.summary       = %q{Nearly auto-generated OpenSearch client}
+  spec.description   = %q{Antbird is a yet another low level API client for the OpenSearch HTTP interface.}
   spec.homepage      = "https://github.com/fukayatsu/antbird"
   spec.license       = "MIT"
 
@@ -20,13 +20,12 @@ Gem::Specification.new do |spec|
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
-  spec.required_ruby_version = ">= 2.7.0"
+  spec.required_ruby_version = ">= 3.3.0"
 
   spec.add_dependency "faraday", ">= 2.0.1"
 
   spec.add_development_dependency "faraday-retry"
   spec.add_development_dependency "faraday-net_http_persistent"
-  spec.add_development_dependency "bundler", "> 1.16", "< 3.0"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "octokit"

data/lib/antbird/client.rb

@@ -7,7 +7,6 @@ module Antbird
       scope: {},
       url: "http://localhost:9200",
       version: nil,
-      distribution: nil,
       read_timeout: 5,
       open_timeout: 2,
       adapter: ::Faraday.default_adapter,
@@ -21,14 +20,11 @@ module Antbird
 
       @scope        = scope.transform_keys(&:to_sym)
 
-      if version
-        @version      = version
-        @distribution = distribution
-      end
+      @version = version
 
       @api_specs = {}
     end
-    attr_reader :scope, :url, :distribution
+    attr_reader :scope, :url
     attr_reader :read_timeout, :open_timeout, :adapter
     attr_reader :api_specs, :last_request
 
@@ -37,17 +33,18 @@ module Antbird
         scope: new_scope,
         url: url,
         version: version,
-        distribution: distribution,
         read_timeout: read_timeout,
-        open_timeout: open_timeout
+        open_timeout: open_timeout,
+        adapter: adapter,
+        &@block
       )
     end
 
-    def request(api_name, api_spec, params)
-      validate_params(api_spec, params)
+    def request(api_name, api_spec, params, path_params = [:index, :type, :id])
+      validate_params(api_spec, params, path_params)
 
       body   = extract_body(params)
-      scopes = extract_scopes(params)
+      scopes = extract_scopes(params, path_params)
       forced_method = extract_method(params)
 
       # Greedy match
@@ -148,9 +145,9 @@ module Antbird
       params.delete(:method)&.to_sym
     end
 
-    def extract_scopes(params)
+    def extract_scopes(params, path_params = [:index, :type, :id])
       scopes = {}
-      [:index, :type, :id].each do |s|
+      path_params.each do |s|
         scope = params.delete(s)
         next unless scope
         scopes[s] = scope
@@ -195,32 +192,10 @@ module Antbird
       end
     end
 
-    def elasticsearch?
-      !opensearch?
-    end
-
-    def opensearch?
-      ensure_version_and_distribution
-
-      distribution == 'opensearch'
-    end
-
-    def elasticsearch_v7_0_compatible?
-      return true if opensearch?
-
-      elasticsearch? && Gem::Version.new(version) >= Gem::Version.new('7.0.0')
-    end
-
-    def elasticsearch_v7_6_compatible?
-      return true if opensearch?
-
-      elasticsearch? && Gem::Version.new(version) >= Gem::Version.new('7.6.0')
-    end
-
     def version
       return @version if @version
 
-      ensure_version_and_distribution
+      ensure_version
       @version
     end
 
@@ -246,16 +221,50 @@ module Antbird
       end
     end
 
-    def validate_params(api_spec, params)
-      # TODO case: required parameter is missing
-      # TODO case: invalid parameter name
-      # TODO case: invalid parameter format
+    SPECIAL_PARAMS = %i[body method read_timeout].freeze
+
+    def validate_params(api_spec, params, path_params)
       if api_spec.dig('body', 'required') && !params.key?(:body)
         raise ArgumentError, 'Body is missing'
       end
+
+      return unless api_spec.key?('params')
+
+      api_params = api_spec['params']
+      common = respond_to?(:common_params) ? common_params.fetch('params', {}).keys.map(&:to_sym) : []
+      valid_keys = api_params.keys.map(&:to_sym) + path_params + SPECIAL_PARAMS + common
+
+      unknown = params.keys - valid_keys
+      unless unknown.empty?
+        raise ArgumentError, "Unknown parameters: #{unknown.join(', ')}"
+      end
+
+      api_params.each do |name, defn|
+        if defn['required'] && !params.key?(name.to_sym)
+          raise ArgumentError, "Required parameter missing: #{name}"
+        end
+
+        value = params[name.to_sym]
+        next if value.nil?
+
+        validate_param_type(name, value, defn['type'])
+      end
     end
 
-    def ensure_version_and_distribution
+    def validate_param_type(name, value, type)
+      case type
+      when 'boolean'
+        unless value == true || value == false
+          raise ArgumentError, "Parameter '#{name}' must be a boolean"
+        end
+      when 'number', 'integer', 'int'
+        unless value.is_a?(Numeric)
+          raise ArgumentError, "Parameter '#{name}' must be a number"
+        end
+      end
+    end
+
+    def ensure_version
       return if @version
 
       response = connection.get('/')
@@ -265,26 +274,27 @@ module Antbird
 
       version_hash = response.body.dig('version')
       @version = version_hash['number']
-      @distribution = version_hash['distribution']
     end
 
     def class_version
       version.split('.')[0, 2].join('_')
     end
 
+    SUPPORTED_MAJOR_VERSION = 3
+
     def ensure_api_spec_loaded
       return if api_specs_loaded?
 
-      ensure_version_and_distribution
+      ensure_version
 
-      if opensearch?
-        require "antbird/rest_api/rest_api_opensearch_v#{class_version}"
-        extend Antbird::RestApi.const_get "RestApiOpensearchV#{class_version}"
-      else
-        require "antbird/rest_api/rest_api_v#{class_version}"
-        extend Antbird::RestApi.const_get "RestApiV#{class_version}"
+      major = version.split('.').first.to_i
+      unless major == SUPPORTED_MAJOR_VERSION
+        raise "Unsupported OpenSearch version: #{version}. Antbird currently supports OpenSearch #{SUPPORTED_MAJOR_VERSION}.x only."
       end
 
+      require "antbird/rest_api/rest_api_opensearch_v#{class_version}"
+      extend Antbird::RestApi.const_get "RestApiOpensearchV#{class_version}"
+
       @api_specs_loaded = true
     end