1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! # ftp-cmd-list-parse
//!
//! This is a library that can parse strings that FTP servers return
//! by `LIST` command request.
//!
//! * Unix-style:
//! ```text
//! 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:
//! ```text
//! 08-22-2018  02:05PM       <DIR>          wwwroot
//! 08-22-18  12:59PM                99710 logo.jpg
//! 08-22-18  03:01AM                99710 music.mp3
//! ```
//!
//! ## Examples:
//!
//! ```rust
//! 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:
//!
//! ```rust
//! 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:
//!
//! ```rust
//! 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"
//! }
//! ```

#[macro_use]
extern crate lazy_static;

mod entry;
pub use entry::*;