Method Name
nlst
Method Signature
nlst(argument[,…])
Parameters
The optional argument is the name (i.e., path) of the directory. If, no value is passed for the optional argument, current working directory for the logged in user is assumed as the value.
Return Value
List of file names in the directory specified by the argument.
Overview
- The nlst() method returns the names of the elements present in a directory.
- The nlst() method internally sends and NLST command to the FTP server and returns the response as a list of names present in the specified directory.
- Unlike mlsd() and dir() methods, apart from the names of the elements the NLST command does not return any other information on the elements.
- The nlst() transfers the text lines containing the directory elements based on the active/passive mode of file transfer in ASCII mode.
Example
# Example Python program that uses NLST command
from ftplib import FTP
# Instantiate an FTP object and connect to the FTP server
ftp = FTP(host="somegoodftpserver.com");
# Login to the FTP server
ftp.login(user="poweruser@ somegoodftpserver.com", passwd="xcvTYGhNft54FG");
# Issue NLST
for name in ftp.nlst():
print(name);Output
.
..
One.txt
Two.txt
ThreeDir