curb 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48135be870a425c76338a773b41dc9438883b30cab622cc8c2d81394b860047d
-  data.tar.gz: e7a439c010c1bdbd3ab26b92f2126a4d518a2c7808d7acc6af2e57a03ec07376
+  metadata.gz: 886abdbc88d51f4d214de43f3a4d12029bfa010bd419ac89e60d0d18a8be3e21
+  data.tar.gz: 0a574a8d8f70daf2e28f4d0900075a67158ce12187ddb10d4da7700e6eea7ecb
 SHA512:
-  metadata.gz: b5c61d835a10a80211b625dd3ef8cf949fdcf30be9584d2a6793d69e309e3cb283097c2502a8912801ab9ee13679f1e71344034a197c54c88872157e66df74a0
-  data.tar.gz: 20fbde1832dc7338dba7f78c08556eceab4532247f41f0bb1c0c15ba11fc0cd2f07aabeaef62525eba24afc95b5e9854dbb3d71f6d6f493097d614ae913818f8
+  metadata.gz: 10438303d75fb75a75cfc2b42d9ff0bfcb92fa87cf4f1eea893f51556dfeab29639b9d30c635721224898ddc712fd62c2f46ca3d70c6622889da3821de9e2b19
+  data.tar.gz: af1a29be7253c4b0c73e593e238f7e49b1c456994559eedd9ae170678b6ac1ecb9fb80982dce1cd9eb3bba422b282fc5c83336e1bc1a1a48c88b3845cc95c424

data/README.md

@@ -105,6 +105,39 @@ puts list.body
 
 If you need a full `LIST` output instead of just names, omit `dirlistonly` and parse the server response accordingly. The key is to let libcurl initiate the data connection (PASV/EPSV) instead of trying to drive it via `ftp_commands`.
 
+#### Full LIST directory listing
+To retrieve the full `LIST` output (permissions, owner, size, timestamp, name), simply do not set `dirlistonly`:
+
+```ruby
+list = Curl::Easy.new('ftp://ftp.example.com/remote/directory/')
+list.username = 'user'
+list.password = 'password'
+
+# Explicitly ensure names+metadata (LIST) rather than NLST
+# list.set(:dirlistonly, 0) # optional; default is LIST for directory URLs
+
+list.perform
+puts list.body # multi-line LIST output
+```
+
+Through an HTTP proxy tunnel, the same considerations apply as the NLST example above — just omit `dirlistonly` and keep the optional EPSV/EPRT/PASV tweaks if needed:
+
+```ruby
+list = Curl::Easy.new('ftp://ftp.example.com/remote/directory/')
+list.username = 'user'
+list.password = 'password'
+list.proxy_url = 'http://proxy.example.com:80'
+list.proxy_tunnel = true
+
+# Optional tweaks if the proxy/server combination struggles
+# list.set(:ftp_use_epsv, 0)
+# list.set(:ftp_use_eprt, 0)
+# list.set(:ftp_skip_pasv_ip, 1)
+
+list.perform
+puts list.body
+```
+
 ### Advanced FTP Usage with Various Options
 ```
 puts "\n=== Advanced FTP Example ==="

data/Rakefile

@@ -3,6 +3,7 @@
 require 'rake/clean'
 require 'rake/testtask'
 require "ruby_memcheck"
+require 'shellwords'
 begin
 require 'mixlib/shellout'
 rescue LoadError
@@ -88,6 +89,16 @@ task :rmpid do
   FileUtils.rm_rf Dir.glob("tests/server_lock-*")
 end
 
+at_exit do
+  next unless defined?(Rake.application)
+
+  top_level_tasks = Rake.application.top_level_tasks
+  test_tasks = %w[default test ta tu alltests unittests bugtests test:valgrind]
+  should_cleanup = top_level_tasks.empty? || top_level_tasks.any? { |task| test_tasks.include?(task) }
+
+  FileUtils.rm_rf Dir.glob("tests/server_lock-*") if should_cleanup
+end
+
 if ENV['RELTEST']
   announce "Release task testing - not running regression tests on alltests"
   task :alltests => [:unittests]
@@ -101,6 +112,17 @@ namespace :test do
     t.test_files = FileList['tests/tc_*.rb']
     t.verbose = false
   end
+
+  desc 'Run the standalone leak trace helper'
+  task :leak_trace => :compile do
+    ruby_opts = Shellwords.split(ENV['LEAK_TRACE_OPTS'].to_s)
+    sh RbConfig.ruby, '-Ilib', '-Iext', 'tests/leak_trace.rb', *ruby_opts
+  end
+end
+
+Rake::Task['test:valgrind'].enhance([:rmpid]) do
+  Rake::Task[:rmpid].reenable
+  Rake::Task[:rmpid].invoke
 end
 
 Rake::TestTask.new(:unittests) do |t|