twisted.protocols.ftp.FTPFileListProtocol(basic.LineReceiver) class documentation

Parser for standard FTP file listings

This is the evil required to match:

   -rw-r--r--   1 root     other        531 Jan 29 03:26 README

If you need different evil for a wacky FTP server, you can override either fileLinePattern or parseDirectoryLine().

It populates the instance attribute self.files, which is a list containing dicts with the following keys (examples from the above line):

• filetype: e.g. 'd' for directories, or '-' for an ordinary file
• perms: e.g. 'rw-r--r--'
• nlinks: e.g. 1
• owner: e.g. 'root'
• group: e.g. 'other'
• size: e.g. 531
• date: e.g. 'Jan 29 03:26'
• filename: e.g. 'README'
• linktarget: e.g. 'some/file'

Note that the 'date' value will be formatted differently depending on the date. Check http://cr.yp.to/ftp.html if you really want to try to parse it.

It also matches the following:

   -rw-r--r--   1 root     other        531 Jan 29 03:26 I HAVE\ SPACE
      - filename:   e.g. 'I HAVE SPACE'

   -rw-r--r--   1 root     other        531 Jan 29 03:26 LINK -> TARGET
      - filename:   e.g. 'LINK'
      - linktarget: e.g. 'TARGET'

   -rw-r--r--   1 root     other        531 Jan 29 03:26 N S -> L S
      - filename:   e.g. 'N S'
      - linktarget: e.g. 'L S'