influxdb 0.3.14 → 0.3.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ae726ac300f9a2011eba6e9ac4e6085637cf914d
-  data.tar.gz: ed8ecb52b432e865b83fd4d52d7b16c8200f38f9
+  metadata.gz: 60063db18e559aa688b4c54f7b7b4a9b10112249
+  data.tar.gz: e2babb896952b556975099b7fc181401687211c9
 SHA512:
-  metadata.gz: abcaa0deb749051a1dfd578f4f10686b6fab9f607a59105747f4cf9f35e556de8831c36e1e72b7d01358816cf45859dda54d52f1830601f080c13b12a1badb52
-  data.tar.gz: 4bba860e2fc1bea053025979288d255d40e2cb775a11a1e59f4231284b439b560c5b4d7ef8bbfffc6f703ecd934dc77f8f2674bd049e71ad8b6aa83566128a04
+  metadata.gz: 922a93ef68a4b71a1dc33ad5d2b811af017db80b28899f0ac355bafe9551a3ce69d3ff9e064ff949f7a5fe39442d031ad58404ccddfb877318626d5370d2268f
+  data.tar.gz: add867058a65debfe4a31d0f8f11e2f94c46aa17d16bfa8b20da2d4608ab655ed80712bb1330a2897356d030181a86d7e7eac720d147bc14894182bdaedf39f5

data/.rubocop.yml

@@ -1,12 +1,12 @@
 AllCops:
   Include:
-    - 'Rakefile'
-    - '*.gemspec'
-    - 'lib/**/*.rb'
-    - 'spec/**/*.rb'
+  - 'Rakefile'
+  - '*.gemspec'
+  - 'lib/**/*.rb'
+  - 'spec/**/*.rb'
   Exclude:
-    - 'bin/**/*'
-    - 'smoke/**/*'
+  - 'bin/**/*'
+  - 'smoke/**/*'
   DisplayCopNames: true
   StyleGuideCopsOnly: false
   TargetRubyVersion: 1.9
@@ -29,8 +29,16 @@ Style/RescueModifier:
 Metrics/LineLength:
   Max: 100
   Exclude:
-    - 'spec/**/*.rb'
+  - 'spec/**/*.rb'
 
 Metrics/ModuleLength:
   CountComments: false  # count full line comments?
   Max: 120
+
+Style/TrailingCommaInLiteral:
+  EnforcedStyleForMultiline: comma
+  Exclude:
+  - "spec/**/*.rb"
+
+Metrics/AbcSize:
+  Max: 20

data/.travis.yml

@@ -35,7 +35,7 @@ matrix:
     - rvm: 2.4.0
       env: TEST_TASK=smoke influx_version=1.1.0 pkghash=682904c350ecfc2a60ec9c6c08453ef2
     - rvm: 2.4.0
-      env: TEST_TASK=smoke influx_version=1.2.0 pkghash=f79959802930c7e9d6e81ffd366c0629
+      env: TEST_TASK=smoke influx_version=1.2.4 pkghash=0545d67217393282188e5d5cdedfdc85
     - rvm: 2.4.0
       env: TEST_TASK=smoke influx_version=nightly channel=nightlies
   fail_fast: true

data/CHANGELOG.md

@@ -4,7 +4,16 @@ For the full commit log, [see here](https://github.com/influxdata/influxdb-ruby/
 
 ## Unreleased changes
 
-- None.
+- nothing yet
+
+## v0.3.15, released 2017-07-17
+
+- Bugfix for `InfluxDB::Client#list_series` when no series available
+  (#195, @skladd).
+- Clarified/expanded docs (also #190, @paneq).
+- Added preliminary `show_field_keys` method to `InfluxDB::Client` (note:
+  the API for this is not stable yet).
+- Degraded dependency on "cause" from runtime to development.
 
 ## v0.3.14, released 2017-02-06
 
@@ -19,7 +28,6 @@ For the full commit log, [see here](https://github.com/influxdata/influxdb-ruby/
   `#write` now accept an additional parameter to override the database on
   invokation time (#173, #176, @jfragoulis).
 
-
 ## v0.3.12, released 2016-11-15
 
 - Bugfix for broken Unicode support (regression introduced in #169).

data/README.md

@@ -1,5 +1,6 @@
 # influxdb-ruby
 
+[![Gem Version](https://badge.fury.io/rb/influxdb.svg)](https://badge.fury.io/rb/influxdb)
 [![Build Status](https://travis-ci.org/influxdata/influxdb-ruby.svg?branch=master)](https://travis-ci.org/influxdata/influxdb-ruby)
 
 The official Ruby client library for [InfluxDB](https://influxdata.com/time-series-platform/influxdb/).
@@ -12,17 +13,19 @@ Maintained by [@toddboom](https://github.com/toddboom) and [@dmke](https://githu
 - [Installation](#installation)
 - [Usage](#usage)
   - [Creating a client](#creating-a-client)
+  - [Writing data](#writing-data)
+    - [A Note About Time Precision](#a-note-about-time-precision)
+  - [Querying](#querying)
+- [Advanced Topics](#advanced-topics)
   - [Administrative tasks](#administrative-tasks)
   - [Continuous queries](#continuous-queries)
   - [Retention policies](#retention-policies)
-  - [Writing data](#writing-data)
   - [Reading data](#reading-data)
-    - [Querying](#querying)
     - [De-normalization](#de--normalization)
     - [Streaming response](#streaming-response)
     - [Retry](#retry)
-  - [Testing](#testing)
-  - [Contributing](#contributing)
+- [Testing](#testing)
+- [Contributing](#contributing)
 
 ## Platform support
 
@@ -72,187 +75,6 @@ require 'influxdb'
 influxdb = InfluxDB::Client.new hosts: ["influxdb1.domain.com", "influxdb2.domain.com"]
 ```
 
-### Administrative tasks
-
-Create a database:
-
-``` ruby
-database = 'site_development'
-
-influxdb.create_database(database)
-```
-
-Delete a database:
-
-``` ruby
-database = 'site_development'
-
-influxdb.delete_database(database)
-```
-
-List databases:
-
-``` ruby
-influxdb.list_databases
-```
-
-Create a user for a database:
-
-``` ruby
-database = 'site_development'
-new_username = 'foo'
-new_password = 'bar'
-permission = :write
-
-# with all permissions
-influxdb.create_database_user(database, new_username, new_password)
-
-# with specified permission - options are: :read, :write, :all
-influxdb.create_database_user(database, new_username, new_password, permissions: permission)
-```
-
-Update a user password:
-
-``` ruby
-username = 'foo'
-new_password = 'bar'
-
-influxdb.update_user_password(username, new_password)
-```
-
-Grant user privileges on database:
-
-``` ruby
-username = 'foobar'
-database = 'foo'
-permission = :read # options are :read, :write, :all
-
-influxdb.grant_user_privileges(username, database, permission)
-```
-
-Revoke user privileges from database:
-
-``` ruby
-username = 'foobar'
-database = 'foo'
-permission = :write # options are :read, :write, :all
-
-influxdb.revoke_user_privileges(username, database, permission)
-```
-Delete a user:
-
-``` ruby
-username = 'foobar'
-
-influxdb.delete_user(username)
-```
-
-List users:
-
-``` ruby
-influxdb.list_users
-```
-
-Create cluster admin:
-
-``` ruby
-username = 'foobar'
-password = 'pwd'
-
-influxdb.create_cluster_admin(username, password)
-```
-
-List cluster admins:
-
-``` ruby
-influxdb.list_cluster_admins
-```
-
-Revoke cluster admin privileges from user:
-
-``` ruby
-username = 'foobar'
-
-influxdb.revoke_cluster_admin_privileges(username)
-```
-
-### Continuous Queries
-
-List continuous queries of a database:
-
-``` ruby
-database = 'foo'
-
-influxdb.list_continuous_queries(database)
-```
-
-Create a continuous query for a database:
-
-``` ruby
-database = 'foo'
-name = 'clicks_count'
-query = 'SELECT COUNT(name) INTO clicksCount_1h FROM clicks GROUP BY time(1h)'
-
-influxdb.create_continuous_query(name, database, query)
-```
-
-Additionally, you can specify the resample interval and the time range over
-which the CQ runs:
-
-``` ruby
-influxdb.create_continuous_query(name, database, query, resample_every: "10m", resample_for: "65m")
-```
-
-Delete a continuous query from a database:
-
-``` ruby
-database = 'foo'
-name = 'clicks_count'
-
-influxdb.delete_continuous_query(name, database)
-```
-
-### Retention Policies
-
-List retention policies of a database:
-
-``` ruby
-database = 'foo'
-
-influxdb.list_retention_policies(database)
-```
-
-Create a retention policy for a database:
-
-``` ruby
-database    = 'foo'
-name        = '1h.cpu'
-duration    = '10m'
-replication = 2
-
-influxdb.create_retention_policy(name, database, duration, replication)
-```
-
-Delete a retention policy from a database:
-
-``` ruby
-database = 'foo'
-name     = '1h.cpu'
-
-influxdb.delete_retention_policy(name, database)
-```
-
-Alter a retention policy for a database:
-
-``` ruby
-database    = 'foo'
-name        = '1h.cpu'
-duration    = '10m'
-replication = 2
-
-influxdb.alter_retention_policy(name, database, duration, replication)
-```
-
 ### Writing data
 
 Write some data:
@@ -306,24 +128,44 @@ influxdb.write_point(name, data)
 
 # or in a method call:
 influxdb.write_point(name, data, time_precision)
-
 ```
 
+> ### A Note About Time Precision
+>
+> The default precision (in this Rubygem) is `"s"` (second), as Ruby's
+> `Time#to_i` operates on this resolution.
+>
+> If you write data points with sub-second resolution (for example
+> via `Time#to_r`), you need to configure your client instance with an
+> appropiate `time_precision` option **and** you'll need to provide a
+> timestamp value which reflects this precision:
+>
+> ```ruby
+> influxdb = InfluxDB::Client.new time_precision: "ms"
+> time = (Time.now.to_r * 10**6).to_i
+> influxdb.write_point("foobar", { values: { n: 42 }, timestamp: time })
+> ```
+
+Allowed values for `time_precision` are:
+
+- `"ns"` or `nil` for nanosecond
+- `"u"` for microsecond
+- `"ms"` for millisecond
+- `"s"` for second
+- `"m"` for minute
+- `"h"` for hour
+
 Write data with a specific retention policy:
 
 ``` ruby
-require 'influxdb'
-
-username  = 'foo'
-password  = 'bar'
 database  = 'site_development'
 name      = 'foobar'
 precision = 's'
 retention = '1h.cpu'
 
 influxdb = InfluxDB::Client.new database,
-  username: username,
-  password: password
+  username: "foo",
+  password: "bar"
 
 data = {
   values:    { value: 0 },
@@ -337,18 +179,14 @@ influxdb.write_point(name, data, precision, retention)
 Write data while choosing the database:
 
 ``` ruby
-require 'influxdb'
-
-username  = 'foo'
-password  = 'bar'
 database  = 'site_development'
 name      = 'foobar'
 precision = 's'
 retention = '1h.cpu'
 
 influxdb = InfluxDB::Client.new {
-  username: username,
-  password: password
+  username: "foo",
+  password: "bar"
 }
 
 data = {
@@ -363,7 +201,6 @@ influxdb.write_point(name, data, precision, retention, database)
 Write multiple points in a batch (performance boost):
 
 ``` ruby
-
 data = [
   {
     series: 'cpu',
@@ -402,22 +239,17 @@ data = [
 precision = 'm'
 retention = '1h.cpu'
 influxdb.write_points(data, precision, retention)
-
 ```
 
 Write asynchronously (note that a retention policy cannot be specified for asynchronous writes):
 
 ``` ruby
-require 'influxdb'
-
-username = 'foo'
-password = 'bar'
 database = 'site_development'
 name     = 'foobar'
 
 influxdb = InfluxDB::Client.new database,
-  username: username,
-  password: password,
+  username: "foo",
+  password: "bar",
   async:    true
 
 data = {
@@ -444,21 +276,13 @@ async_options = {
   sleep_interval:     5
 }
 
-influxdb = InfluxDB::Client.new database,
-  username: username,
-  password: password,
-  async:    async_options
+influxdb = InfluxDB::Client.new database, async: async_options
 ```
 
-
 Write data via UDP (note that a retention policy cannot be specified for UDP writes):
 
 ``` ruby
-require 'influxdb'
-host = '127.0.0.1'
-port = 4444
-
-influxdb = InfluxDB::Client.new udp: { host: host, port: port }
+influxdb = InfluxDB::Client.new udp: { host: "127.0.0.1", port: 4444 }
 
 name = 'hitchhiker'
 
@@ -473,30 +297,22 @@ influxdb.write_point(name, data)
 Discard write errors:
 
 ``` ruby
-require 'influxdb'
-host = '127.0.0.1'
-port = 4444
-
 influxdb = InfluxDB::Client.new(
-  udp: { host: host, port: port },
+  udp: { host: "127.0.0.1", port: 4444 },
   discard_write_errors: true
 )
 
 influxdb.write_point('hitchhiker', { values: { value: 666 } })
 ```
 
-### Reading data
 
-#### Querying
+### Querying
 
 ``` ruby
-username = 'foo'
-password = 'bar'
 database = 'site_development'
-
 influxdb = InfluxDB::Client.new database,
-  username: username,
-  password: password
+  username: "foo",
+  password: "bar"
 
 # without a block:
 influxdb.query 'select * from time_series_1 group by region'
@@ -523,9 +339,9 @@ influxdb.query 'select * from time_series_1 group by region'
 
 # with a block:
 influxdb.query 'select * from time_series_1 group by region' do |name, tags, points|
-  puts "#{name} [ #{tags.inspect} ]"
+  printf "%s [ %p ]\n", name, tags
   points.each do |pt|
-    puts "  -> #{pt.inspect}"
+    printf "  -> %p\n", pt
   end
 end
 
@@ -584,6 +400,190 @@ influxdb.query positional_params_query, params: ["foobar", 42]
 #   select * from time_series_0 where f = 'foobar' and i < 42
 ```
 
+## Advanced Topics
+
+### Administrative tasks
+
+Create a database:
+
+``` ruby
+database = 'site_development'
+
+influxdb.create_database(database)
+```
+
+Delete a database:
+
+``` ruby
+database = 'site_development'
+
+influxdb.delete_database(database)
+```
+
+List databases:
+
+``` ruby
+influxdb.list_databases
+```
+
+Create a user for a database:
+
+``` ruby
+database = 'site_development'
+new_username = 'foo'
+new_password = 'bar'
+permission = :write
+
+# with all permissions
+influxdb.create_database_user(database, new_username, new_password)
+
+# with specified permission - options are: :read, :write, :all
+influxdb.create_database_user(database, new_username, new_password, permissions: permission)
+```
+
+Update a user password:
+
+``` ruby
+username = 'foo'
+new_password = 'bar'
+
+influxdb.update_user_password(username, new_password)
+```
+
+Grant user privileges on database:
+
+``` ruby
+username = 'foobar'
+database = 'foo'
+permission = :read # options are :read, :write, :all
+
+influxdb.grant_user_privileges(username, database, permission)
+```
+
+Revoke user privileges from database:
+
+``` ruby
+username = 'foobar'
+database = 'foo'
+permission = :write # options are :read, :write, :all
+
+influxdb.revoke_user_privileges(username, database, permission)
+```
+Delete a user:
+
+``` ruby
+username = 'foobar'
+
+influxdb.delete_user(username)
+```
+
+List users:
+
+``` ruby
+influxdb.list_users
+```
+
+Create cluster admin:
+
+``` ruby
+username = 'foobar'
+password = 'pwd'
+
+influxdb.create_cluster_admin(username, password)
+```
+
+List cluster admins:
+
+``` ruby
+influxdb.list_cluster_admins
+```
+
+Revoke cluster admin privileges from user:
+
+``` ruby
+username = 'foobar'
+
+influxdb.revoke_cluster_admin_privileges(username)
+```
+
+### Continuous Queries
+
+List continuous queries of a database:
+
+``` ruby
+database = 'foo'
+
+influxdb.list_continuous_queries(database)
+```
+
+Create a continuous query for a database:
+
+``` ruby
+database = 'foo'
+name = 'clicks_count'
+query = 'SELECT COUNT(name) INTO clicksCount_1h FROM clicks GROUP BY time(1h)'
+
+influxdb.create_continuous_query(name, database, query)
+```
+
+Additionally, you can specify the resample interval and the time range over
+which the CQ runs:
+
+``` ruby
+influxdb.create_continuous_query(name, database, query, resample_every: "10m", resample_for: "65m")
+```
+
+Delete a continuous query from a database:
+
+``` ruby
+database = 'foo'
+name = 'clicks_count'
+
+influxdb.delete_continuous_query(name, database)
+```
+
+### Retention Policies
+
+List retention policies of a database:
+
+``` ruby
+database = 'foo'
+
+influxdb.list_retention_policies(database)
+```
+
+Create a retention policy for a database:
+
+``` ruby
+database    = 'foo'
+name        = '1h.cpu'
+duration    = '10m'
+replication = 2
+
+influxdb.create_retention_policy(name, database, duration, replication)
+```
+
+Delete a retention policy from a database:
+
+``` ruby
+database = 'foo'
+name     = '1h.cpu'
+
+influxdb.delete_retention_policy(name, database)
+```
+
+Alter a retention policy for a database:
+
+``` ruby
+database    = 'foo'
+name        = '1h.cpu'
+duration    = '10m'
+replication = 2
+
+influxdb.alter_retention_policy(name, database, duration, replication)
+```
+
+### Reading data
 
 #### (De-) Normalization
 
@@ -616,13 +616,12 @@ influxdb.query 'select * from time_series_1 group by region', denormalize: false
 
 
 influxdb.query 'select * from time_series_1 group by region', denormalize: false do |name, tags, points|
-  puts "#{name} [ #{tags.inspect} ]"
+  printf "%s [ %p ]\n", name, tags
   points.each do |key, values|
-    puts "  #{key.inspect} -> #{values.inspect}"
+    printf "  %p -> %p\n", key, values
   end
 end
 
-
 # time_series_1 [ {"region"=>"uk"} ]
 #   columns -> ["time", "count", "value"]
 #   values -> [["2015-07-09T09:03:31Z", 32, 0.9673], ["2015-07-09T09:03:49Z", 122, 0.4444]]}
@@ -681,6 +680,7 @@ E, [2016-08-31T23:55:19.562428 #23476] ERROR -- InfluxDB: Failed to contact host
 InfluxDB::ConnectionError: Tried 8 times to reconnect but failed.
 ```
 
+
 ## Testing
 
 ```

data/influxdb.gemspec

@@ -20,11 +20,11 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_runtime_dependency "json"
-  spec.add_runtime_dependency "cause"
 
   spec.add_development_dependency "rake"
   spec.add_development_dependency "bundler",  "~> 1.3"
   spec.add_development_dependency "rspec",    "~> 3.5.0"
   spec.add_development_dependency "webmock",  "~> 2.1.0"
   spec.add_development_dependency "rubocop",  "~> 0.41.2"
+  spec.add_development_dependency "cause"
 end

data/lib/influxdb/client.rb

@@ -1,5 +1,4 @@
 require 'json'
-require 'cause' unless Exception.instance_methods.include?(:cause)
 require 'thread'
 
 module InfluxDB
@@ -49,6 +48,7 @@ module InfluxDB
     # +:verify_ssl+:: verify ssl server certificate?
     # +:ssl_ca_cert+:: ssl CA certificate, chainfile or CA path.
     #                  The system CA path is automatically included
+    # +:retry:: number of times a failed request should be retried. Defaults to infinite.
     def initialize(*args)
       opts = args.last.is_a?(Hash) ? args.last : {}
       opts[:database] = args.first if args.first.is_a? String

data/lib/influxdb/config.rb

@@ -62,7 +62,6 @@ module InfluxDB
 
     private
 
-    # rubocop:disable Metrics/AbcSize
     def extract_http_options!(opts)
       @port           = opts.fetch :port, 8086
       @prefix         = opts.fetch :prefix, "".freeze

data/lib/influxdb/errors.rb

@@ -36,7 +36,7 @@ module InfluxDB # :nodoc:
     Net::HTTPHeaderSyntaxError,
     Net::ProtocolError,
     SocketError,
-    (OpenSSL::SSL::SSLError if defined?(OpenSSL))
+    (OpenSSL::SSL::SSLError if defined?(OpenSSL)),
   ].compact.freeze
 
   # Exception classes which hint to a larger problem on the server side,
@@ -44,7 +44,7 @@ module InfluxDB # :nodoc:
   # _don't_ retry a query but escalate it upwards.
   NON_RECOVERABLE_EXCEPTIONS = [
     EOFError,
-    Zlib::Error
+    Zlib::Error,
   ].freeze
 
   NON_RECOVERABLE_MESSAGE = "The server has sent incomplete data" \

data/lib/influxdb/point_value.rb

@@ -7,7 +7,6 @@ module InfluxDB
       @series    = escape data[:series], :measurement
       @values    = escape_values data[:values]
       @tags      = escape_tags data[:tags]
-
       @timestamp = data[:timestamp]
     end
 
@@ -26,7 +25,7 @@ module InfluxDB
       tag_key:      ['='.freeze, ' '.freeze, ','.freeze],
       tag_value:    ['='.freeze, ' '.freeze, ','.freeze],
       field_key:    ['='.freeze, ' '.freeze, ','.freeze, '"'.freeze],
-      field_value:  ['"'.freeze]
+      field_value:  ['"'.freeze],
     }.freeze
 
     def escape(s, type)

data/lib/influxdb/query/core.rb

@@ -69,8 +69,8 @@ module InfluxDB
 
       def write(data, precision, retention_policy = nil, database = nil)
         params = {
-          db: database || config.database,
-          precision: precision || config.time_precision
+          db:         database || config.database,
+          precision:  precision || config.time_precision,
         }
 
         params[:rp] = retention_policy if retention_policy
@@ -87,11 +87,12 @@ module InfluxDB
         chunk_size  = opts.fetch(:chunk_size, config.chunk_size)
         database    = opts.fetch(:database, config.database)
 
-        params = { q: query, db: database, precision: precision }
-        params[:epoch] = epoch if epoch
+        params = { q: query, db: database }
+        params[:precision] = precision if precision
+        params[:epoch]     = epoch     if epoch
 
         if chunk_size
-          params[:chunked] = 'true'
+          params[:chunked] = 'true'.freeze
           params[:chunk_size] = chunk_size
         end
 
@@ -102,9 +103,9 @@ module InfluxDB
       def denormalized_series_list(series)
         series.map do |s|
           {
-            "name"   => s["name".freeze],
-            "tags"   => s["tags".freeze],
-            "values" => denormalize_series(s)
+            "name".freeze   => s["name".freeze],
+            "tags".freeze   => s["tags".freeze],
+            "values".freeze => denormalize_series(s),
           }
         end
       end

data/lib/influxdb/query/database.rb

@@ -13,9 +13,20 @@ module InfluxDB
         resp = execute("SHOW DATABASES".freeze, parse: true)
         fetch_series(resp)
           .fetch(0, {})
-          .fetch('values', [])
+          .fetch("values".freeze, [])
           .flatten
-          .map { |v| { 'name' => v } }
+          .map { |v| { "name".freeze => v } }
+      end
+
+      def show_field_keys
+        query("SHOW FIELD KEYS".freeze, precision: nil).each_with_object({}) do |collection, keys|
+          name    = collection.fetch("name")
+          values  = collection.fetch("values", [])
+
+          keys[name] = values.each_with_object({}) do |row, types|
+            types[row.fetch("fieldKey")] = [row.fetch("fieldType")]
+          end
+        end
       end
     end
   end

data/lib/influxdb/query/series.rb

@@ -8,6 +8,7 @@ module InfluxDB
       def list_series
         resp = execute("SHOW SERIES".freeze, parse: true, db: config.database)
         resp = fetch_series(resp)
+        return [] if resp.empty?
         raw_values(resp[0])
           .fetch('values'.freeze, [])
           .map { |val| val[0].split(',')[0] }

data/lib/influxdb/version.rb

@@ -1,3 +1,3 @@
 module InfluxDB # :nodoc:
-  VERSION = "0.3.14".freeze
+  VERSION = "0.3.15".freeze
 end

data/spec/influxdb/cases/query_series_spec.rb

@@ -35,6 +35,23 @@ describe InfluxDB::Client do
     end
   end
 
+  describe "GET empty #list_series" do
+    let(:response) { { "results" => [{ "series" => [] }] } }
+    let(:query) { "SHOW SERIES" }
+
+    before do
+      stub_request(:get, "http://influxdb.test:9999/query").with(
+        query: { u: "username", p: "password", q: query, db: "database" }
+      ).to_return(
+        body: JSON.generate(response)
+      )
+    end
+
+    it "returns a empty list" do
+      expect(subject.list_series).to eq []
+    end
+  end
+
   describe "#delete_series" do
     let(:name) { "events" }
     let(:query) { "DROP SERIES FROM #{name}" }

data/spec/influxdb/cases/show_field_keys_spec.rb

@@ -0,0 +1,60 @@
+require "spec_helper"
+require "json"
+
+describe InfluxDB::Client do
+  let(:subject) do
+    described_class.new "database",
+                        host:     "influxdb.test",
+                        port:     9999,
+                        username: "username",
+                        password: "password"
+  end
+
+  let(:query) { nil }
+  let(:response) { { "results" => [{ "statement_id" => 0 }] } }
+
+  before do
+    stub_request(:get, "http://influxdb.test:9999/query").with(
+      query: { u: "username", p: "password", q: query, db: "database" }
+    ).to_return(body: JSON.generate(response))
+  end
+
+  describe "#show_field_keys" do
+    let(:query) { "SHOW FIELD KEYS" }
+    let(:response) do
+      {
+        "results" => [{
+          "series" => [{
+            "name"    => "measurement_a",
+            "columns" => %w(fieldKey fieldType),
+            "values"  => [%w(a_string_field string),
+                          %w(a_boolean_field boolean),
+                          %w(a_float_field float),
+                          %w(an_integer_field integer)]
+          }, {
+            "name"    => "measurement_b",
+            "columns" => %w(fieldKey fieldType),
+            "values"  => [%w(another_string string)]
+          }]
+        }]
+      }
+    end
+    let(:expected_result) do
+      {
+        "measurement_a" => {
+          "a_string_field"    => ["string"],
+          "a_boolean_field"   => ["boolean"],
+          "a_float_field"     => ["float"],
+          "an_integer_field"  => ["integer"],
+        },
+        "measurement_b" => {
+          "another_string"    => ["string"],
+        }
+      }
+    end
+
+    it "should GET a list of field/type pairs per measurement" do
+      expect(subject.show_field_keys).to eq(expected_result)
+    end
+  end
+end

data/spec/influxdb/point_value_spec.rb

@@ -39,35 +39,38 @@ describe InfluxDB::PointValue do
         'responses,region=eu,status=200 value=5i,threshold=0.54 1436349652'
       end
       it 'should have proper form' do
-        point = InfluxDB::PointValue.new(series: "responses",
-                                         values: { value: 5, threshold: 0.54 },
-                                         tags: { region: 'eu', status: 200 },
-                                         timestamp: 1_436_349_652)
+        point = InfluxDB::PointValue.new \
+          series:     "responses",
+          values:     { value: 5, threshold: 0.54 },
+          tags:       { region: 'eu', status: 200 },
+          timestamp:  1_436_349_652
 
         expect(point.dump).to eq(expected_value)
       end
     end
 
-    context "with no tags" do
+    context "without tags" do
       let(:expected_value) do
         "responses value=5i,threshold=0.54 1436349652"
       end
       it 'should have proper form' do
-        point = InfluxDB::PointValue.new(series: "responses",
-                                         values: { value: 5, threshold: 0.54 },
-                                         timestamp: 1_436_349_652)
+        point = InfluxDB::PointValue.new \
+          series:     "responses",
+          values:     { value: 5, threshold: 0.54 },
+          timestamp:  1_436_349_652
 
         expect(point.dump).to eq(expected_value)
       end
     end
 
-    context "with values only" do
+    context "without tags and timestamp" do
       let(:expected_value) do
         "responses value=5i,threshold=0.54"
       end
       it 'should have proper form' do
-        point = InfluxDB::PointValue.new(series: "responses",
-                                         values: { value: 5, threshold: 0.54 })
+        point = InfluxDB::PointValue.new \
+          series: "responses",
+          values: { value: 5, threshold: 0.54 }
 
         expect(point.dump).to eq(expected_value)
       end
@@ -79,9 +82,10 @@ describe InfluxDB::PointValue do
       end
 
       it "should be omitted" do
-        point = InfluxDB::PointValue.new(series: "responses",
-                                         values: { value: 5 },
-                                         tags: { region: "eu", status: nil, other: "", nil => "ignored", "" => "ignored" })
+        point = InfluxDB::PointValue.new \
+          series: "responses",
+          values: { value: 5 },
+          tags:   { region: "eu", status: nil, other: "", nil => "ignored", "" => "ignored" }
         expect(point.dump).to eq(expected_value)
       end
     end

data/spec/spec_helper.rb

@@ -1,5 +1,6 @@
 require "influxdb"
 require "webmock/rspec"
+require "cause" unless Exception.instance_methods.include?(:cause)
 
 begin
   # rubocop:disable Lint/HandleExceptions

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: influxdb
 version: !ruby/object:Gem::Version
-  version: 0.3.14
+  version: 0.3.15
 platform: ruby
 authors:
 - Todd Persen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-06 00:00:00.000000000 Z
+date: 2017-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: cause
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.41.2
+- !ruby/object:Gem::Dependency
+  name: cause
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This is the official Ruby library for InfluxDB.
 email:
 - influxdb@googlegroups.com
@@ -160,6 +160,7 @@ files:
 - spec/influxdb/cases/querying_issue_7000_spec.rb
 - spec/influxdb/cases/querying_spec.rb
 - spec/influxdb/cases/retry_requests_spec.rb
+- spec/influxdb/cases/show_field_keys_spec.rb
 - spec/influxdb/cases/udp_client_spec.rb
 - spec/influxdb/cases/write_points_spec.rb
 - spec/influxdb/client_spec.rb
@@ -212,6 +213,7 @@ test_files:
 - spec/influxdb/cases/querying_issue_7000_spec.rb
 - spec/influxdb/cases/querying_spec.rb
 - spec/influxdb/cases/retry_requests_spec.rb
+- spec/influxdb/cases/show_field_keys_spec.rb
 - spec/influxdb/cases/udp_client_spec.rb
 - spec/influxdb/cases/write_points_spec.rb
 - spec/influxdb/client_spec.rb