[−][src]Crate ftp_cmd_list_parse
ftp-cmd-list-parse
This is a library that can parse strings that FTP servers return
by LIST
command request.
- Unix-style:
drwxr-xr-x 10 root root 4096 Dec 21 2012 usr
brw-rw---- 1 root disk 8, 0 Nov 24 10:13 sda
-rw-rw-rw- 1 owner 1234 7045120 Sep 02 2012 music.mp3
lrwxrwxrwx 1 root root 51 Apr 4 23:57 www.nodeftp.github -> /etc/nginx/sites-available/www.nodeftp.github
- Msdos-style:
08-22-2018 02:05PM <DIR> wwwroot
08-22-18 12:59PM 99710 logo.jpg
08-22-18 03:01AM 99710 music.mp3
Examples:
use ftp_cmd_list_parse::FtpEntry; let ftp_response: &'static str = "drwxr-xr-x 10 root root 4096 Dec 21 2012 usr"; if let Some(ftp_entry) = FtpEntry::new(ftp_response) { println!("{}", ftp_entry.name()); // "usr" println!("{:?}", ftp_entry.kind()); // FtpEntryKind::Directory assert!(ftp_entry.is_unix_type()); // true }
You need convert FtpEntry
to FtpEntryUnix
to see additional
fields that MSDOS FTP server doesn't support:
use std::convert::TryFrom; use ftp_cmd_list_parse::FtpEntry; let ftp_response: &'static str = "drwxr-xr-x 10 root root 4096 Dec 21 2012 usr"; if let Ok(ftp_entry) = FtpEntry::try_from(ftp_response) { match ftp_entry.try_to_unix_type() { Ok(ftp_entry_unix) => { // `FtpEntryUnix` type println!("Owner: {}", ftp_entry_unix.owner); // "root" println!("Group: {}", ftp_entry_unix.group); // "root" println!("Permissions: {}", ftp_entry_unix.permissions.as_str()); // "rwxr-xr-x" }, Err(ftp_entry) => { // `FtpEntry` type // Here we got our `FtpEntry` back. println!("FtpEntry is not an UNIX-format!"); } } // Also you can use pattern-matching to destruct enum: // if let FtpEntry::Msdos(ftp_entry_msdos) = ftp_entry { // println!("name: {}", ftp_entry_msdos.name()); // prints "name: usr" //} }
If you ensure what type of FTP server using, you can create FtpEntryUnix
or FtpEntryMsdos
struct directly:
use ftp_cmd_list_parse::FtpEntryUnix; let ftp_response: &'static str = "drwxr-xr-x 10 root root 4096 Dec 21 2012 usr"; if let Some(ftp_entry_unix) = FtpEntryUnix::new(ftp_response) { println!("Owner: {}", ftp_entry_unix.owner); // "root" println!("Group: {}", ftp_entry_unix.group); // "root" println!("Permissions: {}", ftp_entry_unix.permissions); // "rwxr-xr-x" }
Structs
FtpEntryMsdos | Represents entry from Msdos-like FTP server. |
FtpEntryPermissions | Permissions of the Unix-like entry. |
FtpEntryUnix | Represents entry from Unix-like FTP server. |
Enums
FtpEntry | Represents parsed string as ftp entry. |
FtpEntryKind | Type of the ftp entry. |
Traits
FtpEntryInfo | All fields that supports both servers: Unix & MSDOS |