Method Name:
dir
Method Signature:
dir(directory_name[, …])
Parameters:
- The dir() method accepts variable number for parameters.
- When invoked without parameters the function sends the LIST command to the server.
- When invoked with one or more parameters, if the last parameter is a callback, then all other parameters except the callback function are concatenated to the LIST command separated by a space and the command is sent to the server.
- If the last parameter passed is a callback function the function is called for each line of output from the server.
Return Type:
None
Overview:
- The method dir() prints the directory listing as returned by the FTP command LIST.
- Among the number of arguments passed to the function if the last argument is a callback function, this function is called for each line of the output from the server.
Example:
|
from ftplib import FTP
def dirCallback(line): line = "%s **"%line; print(line);
ftpObject = FTP(); ftpObject.connect(host="anexampleftpserver"); ftpObject.login(); print("Current directory listing:"); ftpObject.dir();
fileName = "50MB.zip"; print("Information on the file:%s"%fileName); ftpObject.dir(fileName);
directoryName = "/upload" print("Information on a specific directory:%s"%directoryName); ftpObject.dir(directoryName);
print("Invoke a non-default callback on everyline for current directory:"); ftpObject.dir(".", dirCallback); |
Output:
|
Current directory listing: -rw-r--r-- 1 0 0 52428800 Feb 19 2016 EF.txt -rw-r--r-- 1 0 0 524288 Feb 19 2016 CD.txt -rw-r--r-- 1 0 0 5242880 Feb 19 2016 AB.txt drwxr-xr-x 2 105 108 561152 Oct 09 09:09 uploadfolder Information on the file:AB.txt -rw-r--r-- 1 0 0 52428800 Feb 19 2016 AB.txt Information on a specific directory:/upload -rw------- 1 105 108 1000000 Oct 09 09:00 tbd.txt -rw------- 1 105 108 494276 Oct 09 09:09 tbr.txt Invoke a non-default callback on everyline for current directory: -rw-r--r-- 1 0 0 52428800 Feb 19 2016 EF.txt ** -rw-r--r-- 1 0 0 524288 Feb 19 2016 CD.txt ** -rw-r--r-- 1 0 0 5242880 Feb 19 2016 AB.txt ** drwxr-xr-x 2 105 108 561152 Oct 09 09:09 uploadfolder ** |