Sample code for 30+ languages & platforms
Ruby

SFTP Read Directory Listing

See more SFTP Examples

Demonstrates how to download a directory listing and iterate over the files.

Chilkat Ruby Downloads

Ruby
require 'chilkat'

success = false

# This requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# Important: It is helpful to send the contents of the
# sftp.LastErrorText property when requesting support.

sftp = Chilkat::CkSFtp.new()

# Set some timeouts, in milliseconds:
sftp.put_ConnectTimeoutMs(5000)
sftp.put_IdleTimeoutMs(10000)

# Connect to the SSH server.  
# The standard SSH port = 22
# The hostname may be a hostname or IP address.
hostname = "www.my-sftp-server.com"
port = 22
success = sftp.Connect(hostname,port)
if (success == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# Authenticate with the SSH server.  Chilkat SFTP supports
# both password-based authenication as well as public-key
# authentication.  This example uses password authenication.
success = sftp.AuthenticatePw("myLogin","myPassword")
if (success == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# After authenticating, the SFTP subsystem must be initialized:
success = sftp.InitializeSftp()
if (success == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# Open a directory on the server...
# Paths starting with a slash are "absolute", and are relative 
# to the root of the file system. Names starting with any other 
# character are relative to the user's default directory (home directory).
# A path component of ".." refers to the parent directory, 
# and "." refers to the current directory. 
handle = sftp.openDir(".")
if (sftp.get_LastMethodSuccess() == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# Download the directory listing:

dirListing = Chilkat::CkSFtpDir.new()
success = sftp.ReadDirListing(handle,dirListing)
if (success == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# Close the handle for the directory listing.
success = sftp.CloseHandle(handle)
if (success == false)
    print sftp.lastErrorText() + "\n";
    exit
end

# Iterate over the files.
fileObj = Chilkat::CkSFtpFile.new()
i = 0
n = dirListing.get_NumFilesAndDirs()
while i < n

    success = dirListing.FileAt(i,fileObj)
    if (success == false)
        print dirListing.lastErrorText() + "\n";
        exit
    end

    print fileObj.filename() + "\n";
    print fileObj.fileType() + "\n";
    print "Size in bytes: " + fileObj.get_Size32().to_s() + "\n";
    print "----" + "\n";

    i = i + 1
end

print "Success." + "\n";