patron 0.6.3 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c363a7f520fb90344efb2251b25a0dbbc6e0d5db
-  data.tar.gz: f95d681849dd57101b33408327fc3aa38d0dc2e3
+  metadata.gz: 6490486dce02935cfdeac506f347834248752534
+  data.tar.gz: 2054357e312513173440405a32c69ed1270d6f10
 SHA512:
-  metadata.gz: 1945f68df49b6f96ee53166382807ac5e5a19bd00d2746e325d3af02ffe54b14db6f5ad92a55fe6322f5183b25b047cd2879503b6dfbb5bc9c1afc69c5c617ee
-  data.tar.gz: a487793a4bb938d77804e4f0ea083c61afad062014cacbadcb40343f31ddb3fb55889f844f7b0610101f06f1a765f3c53fe1257bf9b48cabe4fda2ae71398334
+  metadata.gz: 96c2adbfe66641accbb6647faab050405950338938caac845ba3948d981e8f3371f24fd6e3c308cf44cc19248dc56ddb857058546c11ba798eb34ab65b5769f2
+  data.tar.gz: 66e5369b422608d214b0b1654a9fd9cdf075c42f01194b70497b6d3976f7e442d5c0b8926109c418d7e489fedea10d2c72fcad3519d4f0a38b1f584d5d31b525

data/CHANGELOG.md

@@ -0,0 +1,168 @@
+### 0.6.4
+
+* Set the default User-Agent string, since some sites require it (like the Github API).
+* Add Response#ok? and Response#error? for cleaner branching on the returned Response objects
+* Explain a segfault with SSL in forked processes on OSX, document the way to avoid the issue
+* Fix segfault when attempting multiple post requests with multipart (#119)
+
+### 0.6.3
+
+* Fix timeout when uploading a body using all verbs except POST
+* Add PATCH HTTP verb support
+* Populate the curl state object from the reader methods of `Request`
+
+### 0.6.1
+
+* Fix compilation on older versions of libCURL
+* Fix cookie jar files not being saved after request
+* Reformat the gem documentation to YARD, document a few behaviors
+
+### 0.6.0
+
+* Add `Patron::Session#automatic_content_encoding` for automatic deflate handling via `Accept`/`Content-Encoding`
+
+### 0.5.1
+
+* Allow customizing the class used for the response (now uses `Session#response_class` to determine the class at runtime)
+* Do not fail body decoding if the charset name set in the header is invalid
+
+### 0.5.0
+
+* Optimise response header parsing
+* Fix a bug with `Session#base_url` being empty
+* Fix memory corruption when Ruby would free a Patron buffer uninteltionally
+* Modernize the wrapper for request execution, unlock the GVL if possible using the C function native to the version of Ruby we build on
+* Add an option to force CURL to only use IPv4 (`Session#force_ipv4`)
+* Fix a few bugs with base_url concatenation
+* Support options- and block-constructor for `Session.new`
+* Allow the `Request` object to be customized
+
+### 0.4.20
+
+* Revert the HTTP verb to be a Symbol, but allow uppercase versions
+
+### 0.4.19
+
+* Add an option to set `Session#ssl_version` (uses a String as value)
+* Fix `Session#insecure`
+* Add request body support for DELETE requests
+* Add support for default headers via `Session#headers`
+* Allow customizing the CA root file for SSL requests via `Session#cacert`
+* Add gzip encoding support by setting explicit headers
+* Allow `Session#base_url` to be overridden on a per-request basis
+* Use binary mode flags in `fopen()` for `get_file` to improve Windows compatibility
+
+### 0.4.18
+
+* Handle GET request body via buffers, not via post fields
+
+### 0.4.17
+
+* Use libCURL for doing URL encoding
+* Add `Session#interrupt`, which can be used to stop the request/response from another thread
+* Add `Session#reset` to explicitly clear out the libCURL state
+* Use sglib to register all running CURL sessions, to allow them to terminate rapidly when the host Ruby process exits abruptly, via interrupt or otherwise
+* Use a test server in an external process when running rspec
+* Ensure responses that are not text do not force response body decoding
+* Improve thread blocking region handling during requests
+
+### 0.4.17
+
+* Tweak response decoding
+
+### 0.4.15
+
+* Remove rvm/rbenv service files from the repo
+* Encode the response attributes based on the response charset
+* Fix urlencode for Ruby 1.9 compatibility
+* Enable Hash as argument for `Session#post`, which will be form-encoded
+* Allow "timeout" and other options to be overridden at request instantiation
+
+### 0.4.14
+
+* Fix ignore_content_length/ignore_content_size inconsistency
+* Fix a few OSX compilation snags, do not force ARCHFLAGS
+
+### 0.4.13
+
+* Add `Session#ignore_content_length`
+
+### 0.4.12
+
+* Add `:query` option to `Session#request`, encode query parameters from a Hash of options when doing `Session#get`
+
+### 0.4.11
+
+* Add URL encoding when an action is a POST
+* Upgrade build system and rspec
+
+### 0.4.10
+
+* Make the curl buffer size advisory customizable.
+* Add SOCKS proxy support
+* Add `Session#enable_debug` that will write debug info to a file or to STDERR
+
+### 0.4.9
+
+* Use rb_hash_foreach for better jRuby/Rubinius compat
+
+### 0.4.8
+
+* Remove Rubyforge build tasks
+* Run the test server under 1.8 if the main test runs under 1.8
+* Fix incorrect usage of `rb_define_const`
+
+### 0.4.7
+
+* Fix incorrect usage of `rb_define_const`
+* Preserve multiple headers with the same name (like `Set-Cookie`)
+* Set `Expect` in the request to an empty string, to prevent upload hangs
+* Fix a call to `rb_raise` when raising exceptions
+
+### 0.4.5
+
+* Fix use with threads on 1.9.1
+* Specify connection timeout in seconds, not in millis
+* Default max redirects to 5
+
+### 0.4.4
+
+* Fix a string comparison bug in `enable_cookie_session()`
+* Raise an ArgumentError if no data or filename is provided to PUT or
+POST
+
+### 0.4.3
+
+* Add `Session#insecure` to bypass cert validation (defaults to off)
+* Add a blocking region for 1.9 GIL
+* Allow setting `Session#timeout` to `nil` to disable timeouts outright
+
+### 0.4.2
+
+* Fix rubyforge release tasks
+* Add simple cookie handling
+* More 1.9 compatibility
+* Set a default `Session#auth_type` to be HTTP Basic (`:basic`)
+
+### 0.4.1
+
+* Add HTTP Digest authentication support
+* Allow `Request` to use a Hash for body, using options
+
+### 0.4.0
+
+* Documentation tweaks
+* Add support for the COPY HTTP verb
+* Make sure C helper functions are static
+* Make `Session#request` public
+* Add `get_file` to write the response body to a file outside of the Ruby heap
+* Add initial HTTP prox suport
+* Add license, copyright
+
+### 0.3.0
+
+* Add connection timeout support
+
+### 0.2.0
+
+* Initial tagged release

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    patron (0.6.3)
+    patron (0.6.4)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -50,6 +50,33 @@ You can ship custom headers with a single request:
 
     sess.post("/foo/stuff", "some data", {"Content-Type" => "text/plain"})
 
+## Known issues
+
+Currently, [an issue is at play](https://github.com/curl/curl/issues/788) with OSX builds of `curl` which use Apple's SecureTransport. Such builds (which Patron is linking to), are causing segfaults when performing HTTPS requests in forked subprocesses. If you need to check whether your
+system is affected, run the Patron test suite by performing
+
+    $ bundle install && bundle exec rspec
+
+in the Patron install directory. Most default curl configurations on OSX (both
+the Apple-shipped version and the version available via Homebrew) are linked to
+SecureTransport and are likely to be affected. This issue may also manifest in
+forking webserver implementations (such as Unicorn or Passenger) and in forking
+job execution engines (such as resque), so even though you may not be using
+`fork()` directly your server engine might be doing it for you.
+
+To circumvent the issue, you need to build `curl` with OpenSSL via homebrew.
+When doing so, `curl` will use openssl as it's SSL driver. You also need to
+change the Patron compile flag:
+
+
+    $ brew install curl --with-openssl && \
+        gem install patron --with-curl-config=/usr/local/opt/curl/bin/curl-config
+
+You can also save this parameter for all future Bundler-driven gem installs by
+setting this flag in Bundler proper:
+
+    $ bundle config build.patron --with-curl-config=/usr/local/opt/curl/bin/curl-config
+
 ## Threading
 
 By itself, the `Patron::Session` objects are not thread safe (each `Session` holds a single `curl_state` pointer

data/ext/patron/extconf.rb

@@ -27,15 +27,15 @@ require 'mkmf'
 require 'rbconfig'
 
 dir_config('curl')
-
-if find_executable('curl-config')
-  $CFLAGS << " #{`curl-config --cflags`.strip}"
-  $LIBS << " #{`curl-config --libs`.strip}"
+curl_config_path = with_config('curl-config') || find_executable('curl-config')
+if curl_config_path
+  $CFLAGS << " " << `#{curl_config_path} --cflags`.strip
+  $LIBS << " " << `#{curl_config_path} --libs`.strip
 elsif !have_library('curl') or !have_header('curl/curl.h')
   fail <<-EOM
   Can't find libcurl or curl/curl.h
 
-  Try passing --with-curl-dir or --with-curl-lib and --with-curl-include
+  Try passing --with-curl-config, --with-curl-dir, or --with-curl-lib and --with-curl-include
   options to extconf.
   EOM
 end

data/ext/patron/session_ext.c

@@ -354,7 +354,7 @@ static void set_options_from_request(VALUE self, VALUE request) {
   VALUE a_c_encoding          = rb_funcall(request, rb_intern("automatic_content_encoding"), 0);
 
   headers = rb_funcall(request, rb_intern("headers"), 0);
-  if (!NIL_P(headers)) {
+  if (RTEST(headers)) {
     if (rb_type(headers) != T_HASH) {
       rb_raise(rb_eArgError, "Headers must be passed in a hash.");
     }
@@ -371,14 +371,14 @@ static void set_options_from_request(VALUE self, VALUE request) {
     VALUE download_file = rb_funcall(request, rb_intern("file_name"), 0);
 
     curl_easy_setopt(curl, CURLOPT_HTTPGET, 1);
-    if (!NIL_P(data)) {
+    if (RTEST(data)) {
       data = rb_funcall(data, rb_intern("to_s"), 0);
       long len = RSTRING_LEN(data);
       state->upload_buf = StringValuePtr(data);
       set_curl_request_body(curl, state->upload_buf, len);
       curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
     }
-    if (!NIL_P(download_file)) {
+    if (RTEST(download_file)) {
       state->download_file = open_file(download_file, "wb");
       curl_easy_setopt(curl, CURLOPT_WRITEDATA, state->download_file);
     } else {
@@ -397,7 +397,7 @@ static void set_options_from_request(VALUE self, VALUE request) {
       curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PATCH");
     }
     
-    if (!NIL_P(data) && NIL_P(multipart)) {
+    if (RTEST(data) && !RTEST(multipart)) {
       data = rb_funcall(data, rb_intern("to_s"), 0);
       if (action == rb_intern("post")) {
         curl_easy_setopt(curl, CURLOPT_POST, 1);
@@ -405,16 +405,16 @@ static void set_options_from_request(VALUE self, VALUE request) {
       long len = RSTRING_LEN(data);
       state->upload_buf = StringValuePtr(data);
       set_curl_request_body(curl, state->upload_buf, len);
-    } else if (!NIL_P(filename) && NIL_P(multipart)) {
+    } else if (RTEST(filename) && !RTEST(multipart)) {
       set_chunked_encoding(state);
 
       curl_easy_setopt(curl, CURLOPT_UPLOAD, 1);
 
       state->upload_file = open_file(filename, "rb");
       curl_easy_setopt(curl, CURLOPT_READDATA, state->upload_file);
-    } else if (!NIL_P(multipart)) {
+    } else if (RTEST(multipart)) {
       if (action == rb_intern("post")) {
-        if(!NIL_P(data) && !NIL_P(filename)) {
+        if(RTEST(data) && RTEST(filename)) {
           if (rb_type(data) == T_HASH && rb_type(filename) == T_HASH) {
             rb_hash_foreach(data, formadd_values, self);
             rb_hash_foreach(filename, formadd_files, self);
@@ -433,7 +433,7 @@ static void set_options_from_request(VALUE self, VALUE request) {
   // support for data passed with a DELETE request (e.g.: used by elasticsearch)
   } else if (action == rb_intern("delete")) {
       VALUE data = rb_funcall(request, rb_intern("upload_data"), 0);
-      if (!NIL_P(data)) {
+      if (RTEST(data)) {
         long len = RSTRING_LEN(data);
         state->upload_buf = StringValuePtr(data);
         curl_easy_setopt(curl, CURLOPT_POST, 1);
@@ -466,58 +466,58 @@ static void set_options_from_request(VALUE self, VALUE request) {
   }
   
   url = rb_funcall(request, rb_intern("url"), 0);
-  if (NIL_P(url)) {
+  if (!RTEST(url)) {
     rb_raise(rb_eArgError, "Must provide a URL");
   }
   curl_easy_setopt(curl, CURLOPT_URL, StringValuePtr(url));
 
   timeout = rb_funcall(request, rb_intern("timeout"), 0);
-  if (!NIL_P(timeout)) {
+  if (RTEST(timeout)) {
     curl_easy_setopt(curl, CURLOPT_TIMEOUT, FIX2INT(timeout));
   }
 
   timeout = rb_funcall(request, rb_intern("connect_timeout"), 0);
-  if (!NIL_P(timeout)) {
+  if (RTEST(timeout)) {
     curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, FIX2INT(timeout));
   }
 
   redirects = rb_funcall(request, rb_intern("max_redirects"), 0);
-  if (!NIL_P(redirects)) {
+  if (RTEST(redirects)) {
     int r = FIX2INT(redirects);
     curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, r == 0 ? 0 : 1);
     curl_easy_setopt(curl, CURLOPT_MAXREDIRS, r);
   }
 
   proxy = rb_funcall(request, rb_intern("proxy"), 0);
-  if (!NIL_P(proxy)) {
+  if (RTEST(proxy)) {
     curl_easy_setopt(curl, CURLOPT_PROXY, StringValuePtr(proxy));
   }
 
   proxy_type = rb_funcall(request, rb_intern("proxy_type"), 0);
-  if (!NIL_P(proxy_type)) {
+  if (RTEST(proxy_type)) {
     curl_easy_setopt(curl, CURLOPT_PROXYTYPE, NUM2LONG(proxy_type));
   }
 
   credentials = rb_funcall(request, rb_intern("credentials"), 0);
-  if (!NIL_P(credentials)) {
+  if (RTEST(credentials)) {
     VALUE auth_type = rb_funcall(request, rb_intern("auth_type"), 0);
     curl_easy_setopt(curl, CURLOPT_HTTPAUTH, NUM2LONG(auth_type));
     curl_easy_setopt(curl, CURLOPT_USERPWD, StringValuePtr(credentials));
   }
 
   ignore_content_length = rb_funcall(request, rb_intern("ignore_content_length"), 0);
-  if (!NIL_P(ignore_content_length)) {
+  if (RTEST(ignore_content_length)) {
     curl_easy_setopt(curl, CURLOPT_IGNORE_CONTENT_LENGTH, 1);
   }
 
   insecure = rb_funcall(request, rb_intern("insecure"), 0);
-  if(!NIL_P(insecure)) {
+  if(RTEST(insecure)) {
     curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0);
     curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0);
   }
 
   ssl_version = rb_funcall(request, rb_intern("ssl_version"), 0);
-  if(!NIL_P(ssl_version)) {
+  if(RTEST(ssl_version)) {
     VALUE ssl_version_str = rb_funcall(ssl_version, rb_intern("to_s"), 0);
     char* version = StringValuePtr(ssl_version_str);
     if(strcmp(version, "SSLv2") == 0) {
@@ -532,12 +532,12 @@ static void set_options_from_request(VALUE self, VALUE request) {
   }
 
   cacert = rb_funcall(request, rb_intern("cacert"), 0);
-  if(!NIL_P(cacert)) {
+  if(RTEST(cacert)) {
     curl_easy_setopt(curl, CURLOPT_CAINFO, StringValuePtr(cacert));
   }
 
   buffer_size = rb_funcall(request, rb_intern("buffer_size"), 0);
-  if (!NIL_P(buffer_size)) {
+  if (RTEST(buffer_size)) {
      curl_easy_setopt(curl, CURLOPT_BUFFERSIZE, NUM2LONG(buffer_size));
   }
 
@@ -669,6 +669,8 @@ static VALUE cleanup(VALUE self) {
 
   if (state->post) {
     curl_formfree(state->post);
+    state->post = NULL;
+    state->last = NULL;
   }
 
   state->upload_buf = NULL;

data/lib/patron.rb

@@ -38,4 +38,10 @@ module Patron
   def self.version
     VERSION
   end
+  
+  # Returns the default User-Agent string
+  # @return [String]
+  def self.user_agent_string
+    @ua ||= "Patron/Ruby-%s-%s" % [version, libcurl_version]
+  end
 end

data/lib/patron/response.rb

@@ -76,6 +76,20 @@ module Patron
       end
     end
 
+    # Tells whether the HTTP response code is less than 400
+    #
+    # @return [Boolean]
+    def ok?
+      !error?
+    end
+    
+    # Tells whether the HTTP response code is larger than 399
+    #
+    # @return [Boolean]
+    def error?
+      status >= 400
+    end
+    
     private
 
     def determine_charset(header_data, body)

data/lib/patron/session.rb

@@ -107,7 +107,7 @@ module Patron
     
     private :handle_request, :add_cookie_file, :set_debug_file
 
-    # Create a new Session object.
+    # Create a new Session object for performing requests.
     #
     # @param args[Hash] options for the Session (same names as the writable attributes of the Session)
     # @yield self
@@ -124,6 +124,7 @@ module Patron
       end
 
       @headers ||= {}
+      @headers['User-Agent'] ||= Patron.user_agent_string
       @timeout ||= 5
       @connect_timeout ||= 1
       @max_redirects ||= 5

data/lib/patron/version.rb

@@ -1,3 +1,3 @@
 module Patron
-  VERSION = "0.6.3"
+  VERSION = "0.6.4"
 end

data/patron.gemspec

@@ -24,5 +24,10 @@ Gem::Specification.new do |s|
   s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
   s.require_paths = ["lib", "ext"]
   s.extensions   = ["ext/patron/extconf.rb"]
-end
+  s.post_install_message = %q{
+Thank you for installing Patron. On OSX, make sure you are using libCURL with OpenSSL.
+SecureTransport-based builds might cause crashes in forking environments.
 
+For more info see https://github.com/curl/curl/issues/788
+}
+end

data/spec/patron_spec.rb

@@ -27,6 +27,12 @@ require File.expand_path("./spec") + '/spec_helper.rb'
 
 describe Patron do
 
+  it 'should return the user agent string' do
+    ua_str = Patron.user_agent_string
+    expect(ua_str).to include('curl')
+    expect(ua_str).to include('Patron')
+  end
+  
   it "should return the version number of the Patron library" do
     version = Patron.version
     expect(version).to match(%r|^\d+.\d+.\d+$|)

data/spec/response_spec.rb

@@ -37,6 +37,34 @@ describe Patron::Response do
     @session.base_url = "http://localhost:9001"
   end
 
+  it 'recovers the status code' do
+    response = @session.get("/repetitiveheader")
+    expect(response.status).to be_kind_of(Fixnum)
+    expect(response.status).to eq(200)
+  end
+  
+  it 'saves the definitive URL in the url attribute' do
+    headers = "HTTP/1.1 200 OK \r\nContent-Type: text/plain\r\n"
+    response = Patron::Response.new("http://example.com/url", 200, 0, headers, '', "UTF-8")
+    expect(response.url).to eq("http://example.com/url")
+  end
+  
+  it 'parses the status code and supports ok? and error?' do
+    headers = "HTTP/1.1 200 OK \r\nContent-Type: text/plain\r\n"
+    body = "abc"
+    response = Patron::Response.new("url", 200, 0, headers, body, "UTF-8")
+    expect(response.status).to eq(200)
+    expect(response).to be_ok
+    expect(response).not_to be_error
+    
+    headers = "HTTP/1.1 400 Bad Request \r\nContent-Type: text/plain\r\n"
+    body = "abc"
+    response = Patron::Response.new("url", 400, 0, headers, body, "UTF-8")
+    expect(response.status).to eq(400)
+    expect(response).not_to be_ok
+    expect(response).to be_error
+  end
+  
   it "should strip extra spaces from header values" do
     response = @session.get("/test")
     # All digits, no spaces

data/spec/session_spec.rb

@@ -107,6 +107,19 @@ describe Patron::Session do
     FileUtils.rm tmpfile
   end
 
+  it "should not send the user-agent if it has been deleted from headers" do
+    @session.headers.delete 'User-Agent'
+    response = @session.get("/test")
+    body = YAML::load(response.body)
+    expect(body.header["user-agent"]).to be_nil
+  end
+  
+  it "should set the default User-agent" do
+    response = @session.get("/test")
+    body = YAML::load(response.body)
+    expect(body.header["user-agent"]).to be == [Patron.user_agent_string]
+  end
+
   it "should include custom headers in a request" do
     response = @session.get("/test", {"User-Agent" => "PatronTest"})
     body = YAML::load(response.body)

data/spec/session_ssl_spec.rb

@@ -52,6 +52,28 @@ describe Patron::Session do
     FileUtils.rm tmpfile
   end
 
+  # See https://github.com/curl/curl/issues/788
+  # Basically any HTTPS operation crashes on OSX with securetransport-enabled libCURL
+  it "should download content in a forked subprocess" do
+    # To trigger the bug, we need to perform a request in the master process first
+    tmpfile = "/tmp/patron_test.yaml"
+    @session.get_file "/test2", tmpfile
+    File.unlink(tmpfile)
+    
+    # and this one segfaults
+    pid = fork do
+      tmpfile = "/tmp/patron_test.yaml"
+      response = @session.get_file "/test", tmpfile
+      expect(response.body).to be_nil
+      body = YAML::load_file(tmpfile)
+      expect(body.request_method).to be == "GET"
+      FileUtils.rm tmpfile
+    end
+    
+    exit_pid, status = Process.wait2(pid)
+    expect(status.exitstatus).to be_zero
+  end
+  
   it "should download correctly(md5 ok) with get_file" do
     tmpfile = "/tmp/picture"
     response = @session.get_file "/picture", tmpfile

data/spec/spec_helper.rb

@@ -39,6 +39,8 @@ $:.unshift(File.dirname(__FILE__) + '/../lib')
 $:.unshift(File.dirname(__FILE__) + '/../ext')
 require 'patron'
 
+$stderr.puts "Build against #{Patron.libcurl_version}"
+
 Dir['./spec/support/**/*.rb'].each { |fn| require fn }
 
 PatronTestServer.start(nil, false, 9001) if RUBY_VERSION >= '1.9'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: patron
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.6.4
 platform: ruby
 authors:
 - Phillip Toland
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-28 00:00:00.000000000 Z
+date: 2016-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -92,6 +92,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -128,7 +129,12 @@ files:
 homepage: https://github.com/toland/patron
 licenses: []
 metadata: {}
-post_install_message: 
+post_install_message: |2
+
+  Thank you for installing Patron. On OSX, make sure you are using libCURL with OpenSSL.
+  SecureTransport-based builds might cause crashes in forking environments.
+
+  For more info see https://github.com/curl/curl/issues/788
 rdoc_options: []
 require_paths:
 - lib