influxdb 0.3.17 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6340af963bab464fd867383a9cc807e05595df17
-  data.tar.gz: 4e6de52c3d235ea4ecef32ec208cd37bf713452f
+  metadata.gz: 2b441a52f7c991073a898e33debc4844e21c4fab
+  data.tar.gz: d5b4e6eb7b16e760fa2ead3e3ae104e743aad45d
 SHA512:
-  metadata.gz: 75666cbccc4d308b0eb75608047041095f78158201c6e9e994bfd41e8e3450826b94f759f56f65f526d042befa73ceb9c0db443aa4d2925f72828fbee8c928b5
-  data.tar.gz: e0665e344e62644e9e53534eefb9ff26530e7d7aaaf121edd321c5f070bba0aa9894c02b38a8ce28d24b444e475a7860c13c25a90653600f126b050011c64364
+  metadata.gz: d8933fc82bca429acb600186ba3c42e946b071d138a231e86f0344d6a28f0f6cbf55ba14419c49c32a531a3112dff47ff96cf2e9be03a2a99e8265c3b1a1bd59
+  data.tar.gz: 2b5a07855185ccefd02948b4889838944901dc13cb4e3142ab1a5eeda639f465021659aa42f4764b11339df65b1ce18c6c0f3d27005da804b3e45ded73acdd85

data/.rubocop.yml

@@ -7,9 +7,10 @@ AllCops:
   Exclude:
   - 'bin/**/*'
   - 'smoke/**/*'
+  - 'Gemfile'
   DisplayCopNames: true
   StyleGuideCopsOnly: false
-  TargetRubyVersion: 1.9
+  TargetRubyVersion: 2.2
 
 Rails:
   Enabled: false
@@ -31,6 +32,10 @@ Metrics/LineLength:
   Exclude:
   - 'spec/**/*.rb'
 
+Metrics/BlockLength:
+  Exclude:
+  - 'spec/**/*.rb'
+
 Metrics/ModuleLength:
   CountComments: false  # count full line comments?
   Max: 120
@@ -42,3 +47,6 @@ Style/TrailingCommaInLiteral:
 
 Metrics/AbcSize:
   Max: 20
+
+Style/FormatStringToken:
+  Enabled: false

data/.travis.yml

@@ -7,12 +7,9 @@ before_install:
   - gem update bundler --no-doc
   - smoke/provision.sh
 rvm:
-  - 1.9.3
-  - 2.0.0
-  - 2.1.10
   - 2.2.7
-  - 2.3.5
-  - 2.4.2
+  - 2.3.4
+  - 2.4.1
   - ruby-head
 env:
   - TEST_TASK=spec
@@ -22,23 +19,23 @@ matrix:
     - rvm: jruby-head
     - rvm: ruby-head
     - rvm: jruby-9.1.5.0
-    - rvm: 2.4.2
+    - rvm: 2.4.1
       env: TEST_TASK=smoke influx_version=nightly channel=nightlies
   include:
-    - rvm: 2.4.2
+    - rvm: 2.4.1
       env: TEST_TASK=rubocop
     - rvm: jruby-9.1.5.0
     - rvm: jruby-head
       env: JRUBY_OPTS='--client -J-XX:+TieredCompilation -J-XX:TieredStopAtLevel=1 -J-Xss2m -J-Xmx256M'
-    - rvm: 2.4.2
+    - rvm: 2.4.1
       env: TEST_TASK=smoke influx_version=1.0.2 pkghash=3e4c349cb57507913d9abda1459bdbed
-    - rvm: 2.4.2
+    - rvm: 2.4.1
       env: TEST_TASK=smoke influx_version=1.1.0 pkghash=682904c350ecfc2a60ec9c6c08453ef2
-    - rvm: 2.4.2
+    - rvm: 2.4.1
       env: TEST_TASK=smoke influx_version=1.2.4 pkghash=0545d67217393282188e5d5cdedfdc85
-    - rvm: 2.4.2
-      env: TEST_TASK=smoke influx_version=1.3.5 pkghash=479c63bbb66561c302aff2d9bf639bf3
-    - rvm: 2.4.2
+    - rvm: 2.4.1
+      env: TEST_TASK=smoke influx_version=1.3.2 pkghash=27b200344bed9de9df193b62a59d378f
+    - rvm: 2.4.1
       env: TEST_TASK=smoke influx_version=nightly channel=nightlies
   fail_fast: true
 addons:

data/CHANGELOG.md

@@ -2,21 +2,19 @@
 
 For the full commit log, [see here](https://github.com/influxdata/influxdb-ruby/commits/master).
 
-## Unreleased changes
+## v0.4.0 (unreleased)
 
-- nothing yet
-
-## v0.3.17, released 2017-09-27
-
-- (Backport from v0.4.1) Bugfix in async client: Flush queue before exit
-  (#198, #199 @onlynone)
-- (Backport from v0.4.2) Bugfix in `InfluxDB::PointValue`: Properly
-  encode backslashes (#200)
+- **Dropped support for Ruby < 2.2.**
+- Updated dependencies.
+- Refactor some method declarations, to take kwargs instead of an
+  options hash (this shouldn't break call sites).
+- Allow configuration by an URL (idea by @carlhoerberg in #188).
+- Improved logging (#180).
 
 ## v0.3.16, released 2017-08-17
 
-- **This is propably the last release in the 0.3.x series**
-- Typo fix in README (#196, @MichaelSp)
+- **This is propably the last release in the 0.3.x series.**
+- Typo fix in README (#196, @MichaelSp).
 
 ## v0.3.15, released 2017-07-17
 

data/Gemfile

@@ -1,10 +1,5 @@
 source "https://rubygems.org"
 
-if RUBY_ENGINE != "jruby" && RUBY_VERSION < "2.0"
-  gem "json", "~> 1.8.3"
-  gem "public_suffix", "< 1.5"
-end
-
 gemspec
 
 local_gemfile = 'Gemfile.local'

data/README.md

@@ -24,6 +24,7 @@ Maintained by [@toddboom](https://github.com/toddboom) and [@dmke](https://githu
     - [De-normalization](#de--normalization)
     - [Streaming response](#streaming-response)
     - [Retry](#retry)
+- [List of configuration options](#list-of-configuration-options)
 - [Testing](#testing)
 - [Contributing](#contributing)
 
@@ -38,14 +39,9 @@ Maintained by [@toddboom](https://github.com/toddboom) and [@dmke](https://githu
 
 ## Ruby support
 
-Up to and including version 0.3.x, this gem will work with Ruby 1.9+. Starting
-with 0.4.0, only Ruby 2.2+ will be supported.
-
-To read the documentation for 0.3.x, see the [stable-03 branch](https://github.com/influxdata/influxdb-ruby/tree/stable-03).
-
-Please note that for Ruby 1.9, you'll need to install the JSON gem in version
-1.8.x yourself, for example by pinning the version in your `Gemfile` (i.e.
-`gem "json", "~> 1.8.3"`).
+Since v0.4.0, this gem requires Ruby >= 2.2.0. Support for MRI < 2.2 is
+still available in the v0.3.x series, see [stable-03 branch](https://github.com/influxdata/influxdb-ruby/tree/stable-03)
+for documentation.
 
 ## Installation
 
@@ -57,26 +53,45 @@ Or add it to your `Gemfile`, and run `bundle install`.
 
 ## Usage
 
+*All examples assume you have a `require "influxdb"` in your code.*
+
 ### Creating a client
 
 Connecting to a single host:
 
 ``` ruby
-require 'influxdb'
+influxdb = InfluxDB::Client.new  # default connects to localhost:8086
 
-influxdb = InfluxDB::Client.new host: "influxdb.domain.com"
 # or
-influxdb = InfluxDB::Client.new  # no host given defaults connecting to localhost
+influxdb = InfluxDB::Client.new host: "influxdb.domain.com"
 ```
 
 Connecting to multiple hosts (with built-in load balancing and failover):
 
 ``` ruby
-require 'influxdb'
-
 influxdb = InfluxDB::Client.new hosts: ["influxdb1.domain.com", "influxdb2.domain.com"]
 ```
 
+#### Using a configuration URL
+
+You can also provide a URL to connect to your server. This is particulary
+useful for 12-factor apps, i.e. you can put the configuration in an environment
+variable:
+
+``` ruby
+url = ENV["INFLUXDB_URL"] || "https://influxdb.example.com:8086/database_name?retry=3"
+influxdb = InfluxDB::Client.new url: url
+```
+
+Please note, that the config options found in the URL have a lower precedence
+than those explicitly given in the options hash. This means, that the following
+sample will use an open-timeout of 10 seconds:
+
+``` ruby
+url = "https://influxdb.example.com:8086/database_name?open_timeout=3"
+influxdb = InfluxDB::Client.new url: url, open_timeout: 10
+```
+
 ### Writing data
 
 Write some data:
@@ -107,8 +122,6 @@ end
 Write data with time precision (precision can be set in 2 ways):
 
 ``` ruby
-require 'influxdb'
-
 username       = 'foo'
 password       = 'bar'
 database       = 'site_development'
@@ -263,6 +276,7 @@ data = {
 influxdb.write_point(name, data)
 ```
 
+<a name="async-options"></a>
 Using `async: true` is a shortcut for the following:
 
 ``` ruby
@@ -281,6 +295,7 @@ async_options = {
 influxdb = InfluxDB::Client.new database, async: async_options
 ```
 
+<a name="udp-options"></a>
 Write data via UDP (note that a retention policy cannot be specified for UDP writes):
 
 ``` ruby
@@ -671,17 +686,46 @@ $ irb -r influxdb
 => #<InfluxDB::Client:0x00000002bb5ce0 ...>
 
 > influxdb.query 'select * from serie limit 1'
-E, [2016-08-31T23:55:18.287947 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.01s.
-E, [2016-08-31T23:55:18.298455 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.02s.
-E, [2016-08-31T23:55:18.319122 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.04s.
-E, [2016-08-31T23:55:18.359785 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.08s.
-E, [2016-08-31T23:55:18.440422 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.16s.
-E, [2016-08-31T23:55:18.600936 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.32s.
-E, [2016-08-31T23:55:18.921740 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.64s.
-E, [2016-08-31T23:55:19.562428 #23476] ERROR -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 1.28s.
+E, [2016-08-31T23:55:18.287947 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.01s.
+E, [2016-08-31T23:55:18.298455 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.02s.
+E, [2016-08-31T23:55:18.319122 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.04s.
+E, [2016-08-31T23:55:18.359785 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.08s.
+E, [2016-08-31T23:55:18.440422 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.16s.
+E, [2016-08-31T23:55:18.600936 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.32s.
+E, [2016-08-31T23:55:18.921740 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 0.64s.
+E, [2016-08-31T23:55:19.562428 #23476] WARN  -- InfluxDB: Failed to contact host localhost: #<Errno::ECONNREFUSED: Failed to open TCP connection to localhost:8086 (Connection refused - connect(2) for "localhost" port 8086)> - retrying in 1.28s.
 InfluxDB::ConnectionError: Tried 8 times to reconnect but failed.
 ```
 
+## List of configuration options
+
+This index might be out of date. Please refer to `InfluxDB::DEFAULT_CONFIG_OPTIONS`,
+found in `lib/influxdb/config.rb` for the source of truth.
+
+| Category        | Option                  | Default value | Notes
+|:----------------|:------------------------|:--------------|:-----
+| HTTP connection | `:host` or `:hosts`     | "localhost"   | can be an array and can include port
+|                 | `:port`                 | 8086          | fallback port, unless provided by `:host` option
+|                 | `:prefix`               | ""            | URL path prefix (e.g. server is behind reverse proxy)
+|                 | `:username`             | "root"        | user credentials
+|                 | `:password`             | "root"        | user credentials
+|                 | `:open_timeout`         | 5             | socket timeout
+|                 | `:read_timeout`         | 300           | socket timeout
+|                 | `:auth_method`          | "params"      | "params", "basic_auth" or "none"
+| Retry           | `:retry`                | -1            | max. number of retry attempts (reading and writing)
+|                 | `:initial_delay`        | 0.01          | initial wait time (doubles every retry attempt)
+|                 | `:max_delay`            | 30            | max. wait time when retrying
+| SSL/HTTPS       | `:use_ssl`              | false         | whether or not to use SSL (HTTPS)
+|                 | `:verify_ssl`           | true          | verify vertificate when using SSL
+|                 | `:ssl_ca_cert`          | false         | path to or name of CA cert
+| Database        | `:database`             | *empty*       | name of database
+|                 | `:time_precision`       | "s"           | time resolution for data send to server
+|                 | `:epoch`                | false         | time resolution for server responses (false = server default)
+| Writer          | `:async`                | false         | Async options hash, [details here](#async-options)
+|                 | `:udp`                  | false         | UDP connection info, [details here](#udp-options)
+|                 | `:discard_write_errors` | false         | suppress UDP socket errors
+| Query           | `:chunk_size`           | *empty*       | [details here](#streaming-response)
+|                 | `:denormalize`          | true          | format of result
 
 ## Testing
 

data/Rakefile

@@ -18,7 +18,7 @@ Rake::TestTask.new(:smoke) do |t|
   t.test_files = FileList["smoke/*.rb"]
 end
 
-task default: [:spec, :rubocop]
+task default: %i[spec rubocop]
 
 task :console do
   lib = File.expand_path("../lib", __FILE__)
@@ -29,16 +29,17 @@ task :console do
     require "pry-byebug"
     Pry.start
   rescue LoadError
-    puts <<-TEXT.gsub(/^\s{6}([^ ])/, "\1"), ""
-      Could not load pry-byebug. Create a file Gemfile.local with
-      the following line, if you want to get rid of this message:
-
-      \tgem "pry-byebug"
-
-      (don't forget to run bundle afterwards). Falling back to IRB.
-    TEXT
+    puts \
+      "Could not load pry-byebug. Create a file Gemfile.local with",
+      "the following line, if you want to get rid of this message:",
+      "",
+      "\tgem \"pry-byebug\"",
+      "",
+      "(don't forget to run bundle afterwards). Falling back to IRB.",
+      ""
 
     require "irb"
+    require "irb/completion"
     ARGV.clear
     IRB.start
   end

data/influxdb.gemspec

@@ -1,4 +1,5 @@
 # coding: utf-8
+
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'influxdb/version'
@@ -19,13 +20,11 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features|smoke)/})
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "json"
-  spec.post_install_message = "Heads up: version 0.4 will drop support for MRI <= 2.1"
+  spec.required_ruby_version = ">= 2.2.0"
 
   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"
+  spec.add_development_dependency "rspec",    "~> 3.6"
+  spec.add_development_dependency "webmock",  "~> 3.0"
+  spec.add_development_dependency "rubocop",  "~> 0.49"
 end

data/lib/influxdb/client.rb

@@ -49,23 +49,17 @@ module InfluxDB
     # +: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
+    def initialize(database = nil, **opts)
+      opts[:database] = database if database.is_a? String
       @config = InfluxDB::Config.new(opts)
       @stopped = false
       @writer = find_writer
 
-      at_exit { stop! }
+      at_exit { stop! } if config.retry > 0
     end
 
     def stop!
-      if config.async?
-        # If retry was infinite (-1), set it to zero to give the main thread one
-        # last chance to flush the queue
-        config.retry = 0 if config.retry < 0
-        writer.worker.stop!
-      end
+      writer.worker.stop! if config.async?
       @stopped = true
     end
 
@@ -78,8 +72,10 @@ module InfluxDB
     def find_writer
       if config.async?
         InfluxDB::Writer::Async.new(self, config.async)
+      elsif config.udp.is_a?(Hash)
+        InfluxDB::Writer::UDP.new(self, **config.udp)
       elsif config.udp?
-        InfluxDB::Writer::UDP.new(self, config.udp)
+        InfluxDB::Writer::UDP.new(self)
       else
         self
       end

data/lib/influxdb/client/http.rb

@@ -51,7 +51,6 @@ module InfluxDB
 
         http = setup_ssl(http)
         yield http
-
       rescue *InfluxDB::NON_RECOVERABLE_EXCEPTIONS => e
         raise InfluxDB::ConnectionError, InfluxDB::NON_RECOVERABLE_MESSAGE
       rescue Timeout::Error, *InfluxDB::RECOVERABLE_EXCEPTIONS => e
@@ -59,7 +58,7 @@ module InfluxDB
         unless (config.retry == -1 || retry_count <= config.retry) && !stopped?
           raise InfluxDB::ConnectionError, "Tried #{retry_count - 1} times to reconnect but failed."
         end
-        log :error, "Failed to contact host #{host}: #{e.inspect} - retrying in #{delay}s."
+        log(:warn) { "Failed to contact host #{host}: #{e.inspect} - retrying in #{delay}s." }
         sleep delay
         delay = [config.max_delay, delay * 2].min
         retry

data/lib/influxdb/config.rb

@@ -1,40 +1,83 @@
-require 'thread'
+require "thread"
+require "uri"
 
 module InfluxDB
+  # DEFAULT_CONFIG_OPTIONS maps (most) of the configuration options to
+  # their default value. Each option (except for "async" and "udp") can
+  # be changed at runtime throug the InfluxDB::Client instance.
+  #
+  # If you need to change the writer to be asynchronuous or use UDP, you
+  # need to get a new InfluxDB::Client instance.
+  DEFAULT_CONFIG_OPTIONS = {
+    # HTTP connection options
+    port:                 8086,
+    prefix:               "".freeze,
+    username:             "root".freeze,
+    password:             "root".freeze,
+    open_timeout:         5,
+    read_timeout:         300,
+    auth_method:          nil,
+
+    # SSL options
+    use_ssl:              false,
+    verify_ssl:           true,
+    ssl_ca_cert:          false,
+
+    # Database options
+    database:             nil,
+    time_precision:       "s".freeze,
+    epoch:                false,
+
+    # Writer options
+    async:                false,
+    udp:                  false,
+    discard_write_errors: false,
+
+    # Retry options
+    retry:                -1,
+    max_delay:            30,
+    initial_delay:        0.01,
+
+    # Query options
+    chunk_size:           nil,
+    denormalize:          true,
+  }.freeze
+
   # InfluxDB client configuration
   class Config
-    AUTH_METHODS = ["params".freeze, "basic_auth".freeze, "none".freeze].freeze
-
-    attr_accessor :port,
-                  :username,
-                  :password,
-                  :database,
-                  :time_precision,
-                  :use_ssl,
-                  :verify_ssl,
-                  :ssl_ca_cert,
-                  :auth_method,
-                  :initial_delay,
-                  :max_delay,
-                  :open_timeout,
-                  :read_timeout,
-                  :retry,
-                  :prefix,
-                  :chunk_size,
-                  :denormalize,
-                  :epoch,
-                  :discard_write_errors
-
-    attr_reader :async, :udp
-
-    def initialize(opts = {})
-      extract_http_options!(opts)
-      extract_ssl_options!(opts)
-      extract_database_options!(opts)
-      extract_writer_options!(opts)
-      extract_query_options!(opts)
-
-      configure_retry! opts.fetch(:retry, nil)
+    # Valid values for the "auth_method" option.
+    AUTH_METHODS = [
+      "params".freeze,
+      "basic_auth".freeze,
+      "none".freeze,
+    ].freeze
+
+    ATTR_READER = %i[async udp].freeze
+    private_constant :ATTR_READER
+
+    ATTR_ACCESSOR = (DEFAULT_CONFIG_OPTIONS.keys - ATTR_READER).freeze
+    private_constant :ATTR_ACCESSOR
+
+    attr_reader(*ATTR_READER)
+    attr_accessor(*ATTR_ACCESSOR)
+
+    # Creates a new instance. See `DEFAULT_CONFIG_OPTIONS` for available
+    # config options and their default values.
+    #
+    # If you provide a "url" option, either as String (hint: ENV) or as
+    # URI instance, you can override the defaults. The precedence for a
+    # config value is as follows (first found wins):
+    #
+    # - values given in the options hash
+    # - values found in URL (if given)
+    # - default values
+    def initialize(url: nil, **opts)
+      opts = opts_from_url(url).merge(opts) if url
+
+      DEFAULT_CONFIG_OPTIONS.each do |name, value|
+        set_ivar! name, opts.fetch(name, value)
+      end
+
       configure_hosts! opts[:hosts] || opts[:host] || "localhost".freeze
     end
 
@@ -62,34 +105,22 @@ module InfluxDB
 
     private
 
-    def extract_http_options!(opts)
-      @port           = opts.fetch :port, 8086
-      @prefix         = opts.fetch :prefix, "".freeze
-      @username       = opts.fetch :username, "root".freeze
-      @password       = opts.fetch :password, "root".freeze
-      @open_timeout   = opts.fetch :write_timeout, 5
-      @read_timeout   = opts.fetch :read_timeout, 300
-      @max_delay      = opts.fetch :max_delay, 30
-      @initial_delay  = opts.fetch :initial_delay, 0.01
-      auth            = opts[:auth_method]
-      @auth_method    = AUTH_METHODS.include?(auth) ? auth : "params".freeze
-    end
+    def set_ivar!(name, value)
+      case name
+      when :auth_method
+        value = "params".freeze unless AUTH_METHODS.include?(value)
+      when :retry
+        value = normalize_retry_option(value)
+      end
 
-    def extract_ssl_options!(opts)
-      @use_ssl      = opts.fetch :use_ssl, false
-      @verify_ssl   = opts.fetch :verify_ssl, true
-      @ssl_ca_cert  = opts.fetch :ssl_ca_cert, false
+      instance_variable_set "@#{name}", value
     end
 
-    # normalize retry option
-    def configure_retry!(value)
+    def normalize_retry_option(value)
       case value
-      when Integer
-        @retry = value
-      when true, nil
-        @retry = -1
-      when false
-        @retry = 0
+      when Integer   then value
+      when true, nil then -1
+      when false     then 0
       end
     end
 
@@ -101,21 +132,58 @@ module InfluxDB
       end
     end
 
-    def extract_database_options!(opts)
-      @database       = opts[:database]
-      @time_precision = opts.fetch :time_precision, "s".freeze
-      @denormalize    = opts.fetch :denormalize, true
-      @epoch          = opts.fetch :epoch, false
+    # merges URI options into opts
+    def opts_from_url(url)
+      url = URI.parse(url) unless url.is_a?(URI)
+      opts_from_non_params(url).merge opts_from_params(url.query)
+    rescue URI::InvalidURIError
+      {}
     end
 
-    def extract_writer_options!(opts)
-      @async                = opts.fetch :async, false
-      @udp                  = opts.fetch :udp, false
-      @discard_write_errors = opts.fetch :discard_write_errors, false
+    # rubocop:disable Metrics/AbcSize
+    # rubocop:disable Metrics/CyclomaticComplexity
+
+    def opts_from_non_params(url)
+      {}.tap do |o|
+        o[:host]     = url.host        if url.host
+        o[:port]     = url.port        if url.port
+        o[:username] = url.user        if url.user
+        o[:password] = url.password    if url.password
+        o[:database] = url.path[1..-1] if url.path.length > 1
+        o[:use_ssl]  = url.scheme == "https".freeze
+
+        o[:udp] = { host: o[:host], port: o[:port] } if url.scheme == "udp"
+      end
     end
 
-    def extract_query_options!(opts)
-      @chunk_size = opts.fetch :chunk_size, nil
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/CyclomaticComplexity
+
+    OPTIONS_FROM_PARAMS = (DEFAULT_CONFIG_OPTIONS.keys - %i[
+      host port username password database use_ssl udp
+    ]).freeze
+    private_constant :OPTIONS_FROM_PARAMS
+
+    def opts_from_params(query)
+      params = CGI.parse(query || "").tap { |h| h.default = [] }
+
+      OPTIONS_FROM_PARAMS.each_with_object({}) do |k, opts|
+        next unless params[k.to_s].size == 1
+        opts[k] = coerce(k, params[k.to_s].first)
+      end
+    end
+
+    def coerce(name, value)
+      case name
+      when :open_timeout, :read_timeout, :max_delay, :retry, :chunk_size
+        value.to_i
+      when :initial_delay
+        value.to_f
+      when :verify_ssl, :denormalize, :async, :discard_write_errors
+        %w[true 1 yes on].include?(value.downcase)
+      else
+        value
+      end
     end
   end
 end