Sample code for 30+ languages & platforms
Ruby Requires Chilkat v11.0.0+

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";