curb 1.0.8 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26faca47e47561b5ab762a32f58e2771db9a39c2482152fa1116a7082a27de91
-  data.tar.gz: a138509513b023f12537a1bff7fa11e6ef563cc5c59af860b73f119705ee1023
+  metadata.gz: 25a6615cec70148cb19373a5ad0326a93b2e1b4424bd2d02734038857e261659
+  data.tar.gz: 85f2b05e3fd7e8b400d8cd86d65aa2778e4c60e55337442e34d6cda673278c55
 SHA512:
-  metadata.gz: 4686d9ad528ba0f1931c95fa95d25266c8ffcc2214c3a5f527e437f30977f94bde4a48b38d27ad6342cc868c620e2fd4bd214baeae435725a1746d0c93a22aef
-  data.tar.gz: 2e4ba49a5906448e0ad381dad6017cf01140166ee78f1b025b9245cc79c6ff20b37ffd18abc61a56289e8bdeee0750a68f3d84369da36d360f7a61775da10566
+  metadata.gz: de609adca7bcd45c867a8fa91a20caa429e0064c68587d498bf25f455a1d4c49c6d00ec851af7c80aa1cc2694b4d0dd19291ebfb9b3010793dd8fa8c28e22d4c
+  data.tar.gz: af3d577715760e6b6ca977c5a6295d0af5d8b60858d673675d778deff7b06120876b72975ea35062c5299ac45fbab2d45a70b375cf94d07b410eb8c649a443d1

data/{README.markdown → README.md}

@@ -10,6 +10,8 @@ cURL and libcurl live at [https://curl.se/libcurl/](https://curl.se/libcurl/) .
 
 Curb is a work-in-progress, and currently only supports libcurl's `easy` and `multi` modes.
 
+A big advantage to Curb over all other known ruby http libraries is it's ability to handle timeouts without the use of threads.
+
 ## License
 
 Curb is copyright (c) 2006 Ross Bamford, and released under the terms of the
@@ -37,6 +39,103 @@ POST request
   puts res.body
 ```
 
+## FTP Support
+
+require 'curb'
+
+### Basic FTP Download
+```ruby
+puts "=== FTP Download Example ==="
+ftp = Curl::Easy.new('ftp://ftp.example.com/remote/file.txt')
+ftp.username = 'user'
+ftp.password = 'password'
+ftp.perform
+puts ftp.body
+```
+
+### FTP Upload
+```ruby
+puts "\n=== FTP Upload Example ==="
+upload = Curl::Easy.new('ftp://ftp.example.com/remote/upload.txt')
+upload.username = 'user'
+upload.password = 'password'
+upload.upload = true
+upload.put_data = File.read('local_file.txt')
+upload.perform
+```
+
+### List Directory Contents
+```ruby
+puts "\n=== FTP Directory Listing Example ==="
+list = Curl::Easy.new('ftp://ftp.example.com/remote/directory/')
+list.username = 'user'
+list.password = 'password'
+list.dirlistonly = true
+list.perform
+puts list.body
+```
+
+### Advanced FTP Usage with Various Options
+```
+puts "\n=== Advanced FTP Example ==="
+advanced = Curl::Easy.new do |curl|
+  curl.url = 'ftp://ftp.example.com/remote/file.txt'
+  curl.username = 'user'
+  curl.password = 'password'
+
+  # FTP Options
+  curl.ftp_response_timeout = 30
+  curl.ftp_create_missing_dirs = true   # Create directories if they don't exist
+  curl.ftp_filemethod = Curl::CURL_MULTICWD  # Use multicwd method for traversing paths
+
+  # SSL/TLS Options for FTPS
+  curl.use_ssl = Curl::CURLUSESSL_ALL  # Use SSL/TLS for control and data
+  curl.ssl_verify_peer = true
+  curl.ssl_verify_host = true
+  curl.cacert = "/path/to/cacert.pem"
+
+  # Progress callback
+  curl.on_progress do |dl_total, dl_now, ul_total, ul_now|
+    puts "Download: #{dl_now}/#{dl_total} Upload: #{ul_now}/#{ul_total}"
+    true # must return true to continue
+  end
+
+  # Debug output
+  curl.verbose = true
+  curl.on_debug do |type, data|
+    puts "#{type}: #{data}"
+    true
+  end
+end
+
+advanced.perform
+```
+
+### Parallel FTP Downloads
+```
+puts "\n=== Parallel FTP Downloads Example ==="
+urls = [
+  'ftp://ftp.example.com/file1.txt',
+  'ftp://ftp.example.com/file2.txt',
+  'ftp://ftp.example.com/file3.txt'
+]
+```
+
+### Common options for all connections
+```
+options = {
+  :username => 'user',
+  :password => 'password',
+  :timeout => 30,
+  :on_success => proc { |easy| puts "Successfully downloaded: #{easy.url}" },
+  :on_failure => proc { |easy, code| puts "Failed to download: #{easy.url} (#{code})" }
+}
+
+Curl::Multi.download(urls, options) do |curl, file_path|
+  puts "Completed downloading to: #{file_path}"
+end
+```
+
 ## You will need
 
 * A working Ruby installation (`2.0.0+` will work but `2.1+` preferred) (it's possible it still works with 1.8.7 but you'd have to tell me if not...)
@@ -50,20 +149,23 @@ A **non-exhaustive** set of compatibility versions of the libcurl library
 with this gem are as follows. (Note that these are only the ones that have been
 tested and reported to work across a variety of platforms / rubies)
 
-| Gem Version | Release Date | libcurl versions |
-| ----------- | -----------  | ---------------- |
-| 1.0.5       | Jan 2023     | 7.58 - 7.87      |
-| 1.0.4       | Jan 2023     | 7.58 - 7.87      |
-| 1.0.3*      | Dec 2022     | 7.58 - 7.87      |
-| 1.0.2*      | Dec 2022     | 7.58 - 7.87      |
-| 1.0.1       | Apr 2022     | 7.58 - 7.87      |
-| 1.0.0       | Jan 2022     | 7.58 - 7.87      |
-| 0.9.8       | Jan 2019     | 7.58 - 7.81      |
-| 0.9.7       | Nov 2018     | 7.56 - 7.60      |
-| 0.9.6       | May 2018     | 7.51 - 7.59      |
-| 0.9.5       | May 2018     | 7.51 - 7.59      |
-| 0.9.4       | Aug 2017     | 7.41 - 7.58      |
-| 0.9.3       | Apr 2016     | 7.26 - 7.58      |
+| Gem Version | Release Date   | libcurl versions  |
+| ----------- | -------------- | ----------------- |
+| 1.0.8       | Feb 10, 2025   | 7.58 – 8.12.1     |
+| 1.0.7       | Feb 09, 2025   | 7.58 – 8.12.1     |
+| 1.0.6       | Aug 23, 2024   | 7.58 – 8.12.1     |
+| 1.0.5       | Jan 2023       | 7.58 – 8.12.1     |
+| 1.0.4       | Jan 2023       | 7.58 – 8.12.1     |
+| 1.0.3*      | Dec 2022       | 7.58 – 8.12.1     |
+| 1.0.2*      | Dec 2022       | 7.58 – 8.12.1     |
+| 1.0.1       | Apr 2022       | 7.58 – 8.12.1     |
+| 1.0.0       | Jan 2022       | 7.58 – 8.12.1     |
+| 0.9.8       | Jan 2019       | 7.58 – 7.81       |
+| 0.9.7       | Nov 2018       | 7.56 – 7.60       |
+| 0.9.6       | May 2018       | 7.51 – 7.59       |
+| 0.9.5       | May 2018       | 7.51 – 7.59       |
+| 0.9.4       | Aug 2017       | 7.41 – 7.58       |
+| 0.9.3       | Apr 2016       | 7.26 – 7.58       |
 
   ```*avoid using these version are known to have issues with segmentation faults```
 
@@ -215,7 +317,7 @@ c = Curl::Easy.new
 ["http://www.google.co.uk", "http://www.ruby-lang.org/"].map do |url|
   c.url = url
   c.perform
-  c.body_str
+  c.body
 end
 ```
 
@@ -242,7 +344,7 @@ c = Curl::Easy.new("https://http2.akamai.com")
 c.set(:HTTP_VERSION, Curl::HTTP_2_0)
 
 c.perform
-puts (c.body_str.include? "You are using HTTP/2 right now!") ? "HTTP/2" : "HTTP/1.x"
+puts (c.body.include? "You are using HTTP/2 right now!") ? "HTTP/2" : "HTTP/1.x"
 ```
 
 ### Multi Interface (Basic HTTP GET):

data/Rakefile

@@ -3,6 +3,10 @@
 require 'rake/clean'
 require 'rake/testtask'
 require "ruby_memcheck"
+begin
+require 'mixlib/shellout'
+rescue LoadError
+end
 
 CLEAN.include '**/*.o'
 CLEAN.include "**/*.#{(defined?(RbConfig) ? RbConfig : Config)::MAKEFILE_CONFIG['DLEXT']}"

data/ext/curb.h

@@ -28,11 +28,11 @@
 #include "curb_macros.h"
 
 // These should be managed from the Rake 'release' task.
-#define CURB_VERSION   "1.0.8"
-#define CURB_VER_NUM   1008
+#define CURB_VERSION   "1.1.0"
+#define CURB_VER_NUM   1010
 #define CURB_VER_MAJ   1
-#define CURB_VER_MIN   0
-#define CURB_VER_MIC   8
+#define CURB_VER_MIN   1
+#define CURB_VER_MIC   0
 #define CURB_VER_PATCH 0
 
 

data/ext/curb_easy.c

@@ -2535,7 +2535,7 @@ VALUE ruby_curl_easy_setup(ruby_curl_easy *rbce) {
       rb_iterate(rb_each, rb_easy_get("proxy_headers"), cb_each_http_proxy_header, wrap);
     } else {
       VALUE proxy_headers_str = rb_obj_as_string(rb_easy_get("proxy_headers"));
-      *phdrs = curl_slist_append(*hdrs, StringValuePtr(proxy_headers_str));
+      *phdrs = curl_slist_append(*phdrs, StringValuePtr(proxy_headers_str));
     }
 
     if (*phdrs) {
@@ -3821,6 +3821,27 @@ static VALUE ruby_curl_easy_set_opt(VALUE self, VALUE opt, VALUE val) {
   case CURLOPT_PROXY_SSL_VERIFYHOST:
     curl_easy_setopt(rbce->curl, CURLOPT_PROXY_SSL_VERIFYHOST, NUM2LONG(val));
     break;
+#endif
+#if HAVE_CURLOPT_RESOLVE
+  case CURLOPT_RESOLVE: {
+    struct curl_slist *list = NULL;
+    if (NIL_P(val)) {
+      /* When nil is passed, we clear any previous resolve list */
+      list = NULL;
+    } else if (TYPE(val) == T_ARRAY) {
+      long i, len = RARRAY_LEN(val);
+      for (i = 0; i < len; i++) {
+        VALUE item = rb_ary_entry(val, i);
+        list = curl_slist_append(list, StringValueCStr(item));
+      }
+    } else {
+      /* If a single string is passed, use it directly */
+      list = curl_slist_append(NULL, StringValueCStr(val));
+    }
+    /* Save the list pointer in the ruby_curl_easy structure for cleanup later */
+    rbce->curl_resolve = list;
+    curl_easy_setopt(rbce->curl, CURLOPT_RESOLVE, list);
+  } break;
 #endif
   default:
     rb_raise(rb_eTypeError, "Curb unsupported option");

data/ext/curb_multi.c

@@ -187,6 +187,25 @@ static VALUE ruby_curl_multi_max_connects(VALUE self, VALUE count) {
   return count;
 }
 
+/*
+ * call-seq:
+ * multi = Curl::Multi.new
+ * multi.max_host_connections = 1
+ *
+ * Set the max number of connections per host
+ */
+static VALUE ruby_curl_multi_max_host_connections(VALUE self, VALUE count) {
+#ifdef HAVE_CURLMOPT_MAX_HOST_CONNECTIONS
+  ruby_curl_multi *rbcm;
+
+  Data_Get_Struct(self, ruby_curl_multi, rbcm);
+
+  curl_multi_setopt(rbcm->handle, CURLMOPT_MAX_HOST_CONNECTIONS, NUM2LONG(count));
+#endif
+
+  return count;
+}
+
 /*
  * call-seq:
  * multi = Curl::Multi.new
@@ -704,6 +723,7 @@ void init_curb_multi() {
   rb_define_singleton_method(cCurlMulti, "autoclose", ruby_curl_multi_get_autoclose, 0);
   /* Instance methods */
   rb_define_method(cCurlMulti, "max_connects=", ruby_curl_multi_max_connects, 1);
+  rb_define_method(cCurlMulti, "max_host_connections=", ruby_curl_multi_max_host_connections, 1);
   rb_define_method(cCurlMulti, "pipeline=", ruby_curl_multi_pipeline, 1);
   rb_define_method(cCurlMulti, "_add", ruby_curl_multi_add, 1);
   rb_define_method(cCurlMulti, "_remove", ruby_curl_multi_remove, 1);

data/ext/extconf.rb

@@ -338,6 +338,9 @@ have_constant :CURL_SSLVERSION_TLSv1
 have_constant :CURL_SSLVERSION_SSLv2
 have_constant :CURL_SSLVERSION_SSLv3
 
+# Added in 7.30.0
+have_constant "curlmopt_max_host_connections"
+
 # Added in 7.34.0
 have_constant :CURL_SSLVERSION_TLSv1_0
 have_constant :CURL_SSLVERSION_TLSv1_1

data/lib/curl.rb

@@ -3,7 +3,6 @@ require 'curb_core'
 require 'curl/easy'
 require 'curl/multi'
 require 'uri'
-require 'cgi'
 
 # expose shortcut methods
 module Curl

data/tests/bug_resolve.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
+
+class BugResolve < Test::Unit::TestCase
+  include BugTestServerSetupTeardown
+
+  def test_abuse_resolve
+    c = Curl::Easy.new("http://localhost:#{@port}/test")
+    while true
+      c.get
+      assert_equal 200, c.response_code
+      assert_match(/hi/, c.body)
+    end
+  end
+
+end

data/tests/helper.rb

@@ -3,6 +3,7 @@
 $CURB_TESTING = true
 require 'uri'
 require 'stringio'
+require 'digest/md5'
 
 $TOPDIR = File.expand_path(File.join(File.dirname(__FILE__), '..'))
 $EXTDIR = File.join($TOPDIR, 'ext')

data/tests/tc_curl_easy.rb

@@ -18,6 +18,20 @@ class TestCurbCurlEasy < Test::Unit::TestCase
     assert_equal 200, easy.code
   end
 
+  def test_curlopt_resolve
+    require 'resolv'
+    uri = URI.parse(TestServlet.url)
+    resolved_ip = Resolv.getaddress(uri.host)   # perform DNS lookup once
+    mapping = "#{uri.host}:#{uri.port}:#{resolved_ip}"
+
+    http = Curl::Easy.new(TestServlet.url)
+    http.setopt(Curl::CURLOPT_RESOLVE, [mapping])
+
+    http.get
+
+    assert_match(/GET/, http.body)
+  end
+
   def test_curlopt_stderr_with_file
     # does not work with Tempfile directly
     path = Tempfile.new('curb_test_curlopt_stderr').path
@@ -805,8 +819,8 @@ class TestCurbCurlEasy < Test::Unit::TestCase
     curl = Curl::Easy.new(TestServlet.url)
     curl.multipart_form_post = true
     fields = [
-      Curl::PostField.file('foo', File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown'))),
-      Curl::PostField.file('bar', File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown')))
+      Curl::PostField.file('foo', File.expand_path(File.join(File.dirname(__FILE__),'..','README.md'))),
+      Curl::PostField.file('bar', File.expand_path(File.join(File.dirname(__FILE__),'..','README.md')))
     ]
     curl.http_post(fields)
     assert_match(/HTTP POST file upload/, curl.body_str)
@@ -815,8 +829,8 @@ class TestCurbCurlEasy < Test::Unit::TestCase
     curl = Curl::Easy.new(TestServlet.url)
     curl.multipart_form_post = true
     fields = [
-      Curl::PostField.file('foo', File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown'))),
-      Curl::PostField.file('bar', File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown')))
+      Curl::PostField.file('foo', File.expand_path(File.join(File.dirname(__FILE__),'..','README.md'))),
+      Curl::PostField.file('bar', File.expand_path(File.join(File.dirname(__FILE__),'..','README.md')))
     ]
     curl.http_put(fields)
     assert_match(/HTTP POST file upload/, curl.body_str)
@@ -866,7 +880,7 @@ class TestCurbCurlEasy < Test::Unit::TestCase
     [:put, :post, :patch].each {|method|
       curl = Curl::Easy.new(TestServlet.url)
       curl.multipart_form_post = true
-      pf = Curl::PostField.file('readme', File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown')))
+      pf = Curl::PostField.file('readme', File.expand_path(File.join(File.dirname(__FILE__),'..','README.md')))
       curl.send("http_#{method}", pf)
       assert_match(/HTTP POST file upload/, curl.body_str)
       assert_match(/Content-Disposition: form-data/, curl.body_str)
@@ -1048,7 +1062,7 @@ class TestCurbCurlEasy < Test::Unit::TestCase
   end
 
   def test_post_streaming
-    readme = File.expand_path(File.join(File.dirname(__FILE__),'..','README.markdown'))
+    readme = File.expand_path(File.join(File.dirname(__FILE__),'..','README.md'))
     
     pf = Curl::PostField.file("filename", readme)
 
@@ -1058,11 +1072,10 @@ class TestCurbCurlEasy < Test::Unit::TestCase
     easy.multipart_form_post = true
     easy.http_post(pf)
 
-    assert_not_equal(0,easy.body_str.size)
-    assert_equal(easy.body_str.tr("\r", ''), File.read(readme))
+    assert_not_equal(0,easy.body.size)
+    assert_equal(Digest::MD5.hexdigest(easy.body), Digest::MD5.hexdigest(File.read(readme)))
   end
 
-
   def test_easy_close
     easy = Curl::Easy.new
     easy.close

data/tests/tc_curl_multi.rb

@@ -552,6 +552,25 @@ class TestCurbCurlMulti < Test::Unit::TestCase
     end
   end
 
+  def test_multi_easy_http_with_max_host_connections
+    urls = [
+      { :url => TestServlet.url + '?q=1', :method => :get },
+      { :url => TestServlet.url + '?q=2', :method => :get },
+      { :url => TestServlet.url + '?q=3', :method => :get }
+    ]
+    Curl::Multi.http(urls, {:pipeline => true, :max_host_connections => 1}) do|easy, code, method|
+      assert_equal 200, code
+      case method
+      when :post
+        assert_match(/POST/, easy.body)
+      when :get
+        assert_match(/GET/, easy.body)
+      when :put
+        assert_match(/PUT/, easy.body)
+      end
+    end
+  end
+
   def test_multi_recieves_500
     m = Curl::Multi.new
     e = Curl::Easy.new("http://127.0.0.1:9129/methods")

data/tests/tc_curl_postfield.rb

@@ -58,12 +58,13 @@ class TestCurbCurlPostfield < Test::Unit::TestCase
 
   def test_new_file_01
     pf = Curl::PostField.file('foo', 'localname')
+    pf.content_type = 'text/super'
 
     assert_equal 'foo', pf.name
     assert_equal 'localname', pf.local_file
     assert_equal 'localname', pf.remote_file
     assert_nothing_raised { pf.to_s }
-    assert_nil pf.content_type
+    assert_equal 'text/super', pf.content_type
     assert_nil pf.content
     assert_nil pf.set_content_proc
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: curb
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 1.1.0
 platform: ruby
 authors:
 - Ross Bamford
 - Todd A. Fisher
 bindir: bin
 cert_chain: []
-date: 2025-02-09 00:00:00.000000000 Z
+date: 2025-07-24 00:00:00.000000000 Z
 dependencies: []
 description: Curb (probably CUrl-RuBy or something) provides Ruby-language bindings
   for the libcurl(3), a fully-featured client-side URL transfer library. cURL and
@@ -19,10 +19,10 @@ extensions:
 - ext/extconf.rb
 extra_rdoc_files:
 - LICENSE
-- README.markdown
+- README.md
 files:
 - LICENSE
-- README.markdown
+- README.md
 - Rakefile
 - doc.rb
 - ext/banned.h
@@ -58,6 +58,7 @@ files:
 - tests/bug_postfields_crash2.rb
 - tests/bug_raise_on_callback.rb
 - tests/bug_require_last_or_segfault.rb
+- tests/bug_resolve.rb
 - tests/bugtests.rb
 - tests/helper.rb
 - tests/mem_check.rb
@@ -79,10 +80,11 @@ files:
 homepage: https://github.com/taf2/curb
 licenses:
 - Ruby
-metadata: {}
+metadata:
+  changelog_uri: https://github.com/taf2/curb/blob/master/ChangeLog.md
 rdoc_options:
 - "--main"
-- README.markdown
+- README.md
 require_paths:
 - lib
 - ext
@@ -97,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby libcurl bindings
 test_files:
@@ -115,6 +117,7 @@ test_files:
 - tests/bug_postfields_crash2.rb
 - tests/bug_raise_on_callback.rb
 - tests/bug_require_last_or_segfault.rb
+- tests/bug_resolve.rb
 - tests/bugtests.rb
 - tests/helper.rb
 - tests/mem_check.rb