influxdb-client 2.1.0.pre.3409 → 2.2.0.pre.3845

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08a280cc5c4053e62531d6f2859dc7bebfe96b7a65ea2a1741b8b7ede68d0023'
-  data.tar.gz: e58d5f43ca4d789948adb50441f2fec8b2a62eeda084543eacac837d84e7caa7
+  metadata.gz: e0e228772c8d102ecf07e3179adde5114ba29e2a6e8e50e2e6e3f7b24afbf16f
+  data.tar.gz: 5a266a027f3b789c68c65e3e21ddd551a307eff3747c65b47cf1f85e96da1f05
 SHA512:
-  metadata.gz: d0cb88c00590fa1512fa83290d1fb050a2c537f097370a6f466708235f9f62f755cdbe43bb48a16f83f5e327e257499510af27852e6b8da9e6d12f35e750ac99
-  data.tar.gz: 581679b325261a29d8dc5edf43f24ae104cb2a333df902555b16192a8ba8148ddc262cce79752371b792aa51316395f4e9268093595b54842c3a474588549253
+  metadata.gz: 796c53b19fabae84db3d8333abc9d0246c794c80c63f8349c0464fba4a5d3576edb00e7c243806862f2e9859430ac82a236b983a91aa5cfdeb10fc5f90be671c
+  data.tar.gz: 87722335447bf97002d60a1221927ab2dd8c06cfdeb64ab7e2f8f953bb5b6dc9006412b243b9b0e0a00263a2f2acfb18e91f96e7b7c4eca6789b5afb0070fd87

data/CHANGELOG.md

@@ -1,7 +1,13 @@
-## 2.1.0 [unreleased]
+## 2.2.0 [unreleased]
+
+## 2.1.0 [2021-10-22]
+
+### Features
+1. [#93](https://github.com/influxdata/influxdb-client-ruby/pull/93): Add `PingApi` to check status of OSS and Cloud instance
 
 ### CI
 1. [#91](https://github.com/influxdata/influxdb-client-ruby/pull/91): Switch to next-gen CircleCI's convenience images
+1. [#95](https://github.com/influxdata/influxdb-client-ruby/pull/95): Update `jruby` to `9.3.1.0-jdk11`
 
 ## 2.0.0 [2021-09-13]
 

data/README.md

@@ -64,13 +64,13 @@ The client can be installed manually or with bundler.
 To install the client gem manually:
 
 ```
-gem install influxdb-client -v 2.0.0
+gem install influxdb-client -v 2.1.0
 ```
 
 For management API:
 
 ```
-gem install influxdb-client-apis -v 2.0.0
+gem install influxdb-client-apis -v 2.1.0
 ```
 
 ## Usage
@@ -400,7 +400,7 @@ client.close!
 
 ### Check the server status 
 
-Server availability can be checked using the `client.health` method. That is equivalent of the [influx ping](https://v2.docs.influxdata.com/v2.0/reference/cli/influx/ping/).
+Server availability can be checked using the `client.ping` method. That is equivalent of the [influx ping](https://v2.docs.influxdata.com/v2.0/reference/cli/influx/ping/).
 
 ### Proxy configuration
 

data/lib/influxdb-client.rb

@@ -26,6 +26,7 @@ require 'influxdb2/client/write_api'
 require 'influxdb2/client/query_api'
 require 'influxdb2/client/delete_api'
 require 'influxdb2/client/health_api'
+require 'influxdb2/client/ping_api'
 require 'influxdb2/client/point'
 require 'influxdb2/client/flux_table'
 require 'influxdb2/client/write_retry'

data/lib/influxdb2/client/client.rb

@@ -87,11 +87,20 @@ module InfluxDB2
 
     # Get the health of an instance.
     #
+    # @deprecated Use `ping` instead
     # @return [HealthCheck]
     def health
       HealthApi.new(options: @options).health
     end
 
+    # Checks the status of InfluxDB instance and version of InfluxDB.
+    #
+    # @deprecated Use `ping` instead
+    # @return [Ping]
+    def ping
+      PingApi.new(options: @options).ping
+    end
+
     # Close all connections into InfluxDB 2.
     #
     # @return [ true ] Always true.

data/lib/influxdb2/client/health_api.rb

@@ -22,6 +22,7 @@ require_relative 'models/health_check'
 module InfluxDB2
   # The client of the InfluxDB 2.0 that implement Health HTTP API endpoint.
   #
+  # @deprecated Use `PingApi` instead
   class HealthApi < DefaultApi
     # @param [Hash] options The options to be used by the client.
     def initialize(options:)

data/lib/influxdb2/client/ping_api.rb

@@ -0,0 +1,65 @@
+# The MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require_relative 'models/health_check'
+
+module InfluxDB2
+  # The client of the InfluxDB 2.0 that implement Ping HTTP API endpoint.
+  #
+  class PingApi < DefaultApi
+    # @param [Hash] options The options to be used by the client.
+    def initialize(options:)
+      super(options: options)
+    end
+
+    # Checks the status of InfluxDB instance and version of InfluxDB.
+    #
+    # @return [Ping]
+    def ping
+      uri = _parse_uri('/ping')
+      headers = _get(uri)
+      Ping.new.tap do |model|
+        model.status = 'ok'
+        model.build = headers['X-Influxdb-Build']
+        model.version = headers['X-Influxdb-Version']
+        model.message = 'ready for queries and writes'
+      end
+    rescue StandardError => e
+      Ping.new.tap do |model|
+        model.status = 'fail'
+        model.message = e.message
+      end
+    end
+  end
+
+  # The status of InfluxDB instance and version of InfluxDB.
+  class Ping
+    # The type of InfluxDB build.
+    attr_accessor :build
+
+    # The version of InfluxDB.
+    attr_accessor :version
+
+    # The status of InfluxDB.
+    attr_accessor :status
+
+    # The error message.
+    attr_accessor :message
+  end
+end

data/lib/influxdb2/client/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module InfluxDB2
-  VERSION = '2.1.0'.freeze
+  VERSION = '2.2.0'.freeze
 end

data/test/influxdb/client_test.rb

@@ -90,6 +90,26 @@ class ClientTest < Minitest::Test
     assert_equal 'fail', health.status
   end
 
+  def test_ping
+    client = InfluxDB2::Client.new('http://localhost:8086', 'my-token', use_ssl: false)
+
+    ping = client.ping
+    assert_equal 'ready for queries and writes', ping.message
+    assert_equal 'OSS, oss2', ping.build
+    assert_equal 'ok', ping.status
+    refute_empty ping.version
+  end
+
+  def test_ping_not_running
+    client_not_running = InfluxDB2::Client.new('http://localhost:8099', 'my-token', use_ssl: false)
+    ping = client_not_running.ping
+
+    assert_match 'Failed to open TCP connection to localhost:8099', ping.message
+    assert_equal 'fail', ping.status
+    assert_nil ping.build
+    assert_nil ping.version
+  end
+
   def test_trailing_slash_in_url
     uri = URI.parse(File.join('http://localhost:8099', '/api/v2/write'))
     assert_equal 'http://localhost:8099/api/v2/write', uri.to_s

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: influxdb-client
 version: !ruby/object:Gem::Version
-  version: 2.1.0.pre.3409
+  version: 2.2.0.pre.3845
 platform: ruby
 authors:
 - Jakub Bednar
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-13 00:00:00.000000000 Z
+date: 2021-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -146,6 +146,7 @@ files:
 - lib/influxdb2/client/models/dialect.rb
 - lib/influxdb2/client/models/health_check.rb
 - lib/influxdb2/client/models/query.rb
+- lib/influxdb2/client/ping_api.rb
 - lib/influxdb2/client/point.rb
 - lib/influxdb2/client/query_api.rb
 - lib/influxdb2/client/version.rb