FluentFTP 35.0.2

Automatic connection

• Major: AutoConnect takes far fewer connection attempts due to improvements in connection handling
• Major: AutoConnect and AutoDetect are much faster and smarter and only try each setting once if possible
• Major: AutoDetect only tries Explicit and Implicit FTPS once and then falls back to plaintext FTP
• Major: AutoDetect only tries UTF-8 and never ASCII because most UTF-8 servers don't advertise it
• Major: AutoDetect does not cycle through data connection types during connection as it is irrelevant
• Major: AutoDetect calculates a data connection type after connection succeeds (EPSV or PASV)
• New: AutoDetect verifies if the server supports UTF-8 and updates the FtpProfile accordingly
• New: FtpProfile code generation adds a warning message if the encoding mode is unverified
• New: AutoConnectAsync now uses true asynchronous connection backed by new AutoDetectAsync
• New: AutoConnect now auto computes an FTP port unless a non-standard port is already set
• New: AutoConnect uses the main FtpClient connection rather than creating one clone per attempt
• Fix: AutoConnect remains connected to the first working profile rather than connecting twice on success
• Fix: AutoConnect reuses the same connection for FTPS and FTP rather than connecting again
• Fix: Ensure FTP server capabilities are loaded during AutoDetect if original connection is blank
• Fix: AutoConnect and AutoDetect will now throw exceptions for permanent failures (bad host/credentials)
• Fix: ConnectAsync now correctly creates a FTP server-specific handler to match Connect behaviour
• Fix: ConnectAsync now correctly resets the state flags to match Connect behaviour
• Fix: Port now correctly calculates the default port 21 when using FtpEncryptionMode.Auto

Appending and resuming uploads

• Major: The setting FtpLocalExists.Append is now renamed to FtpLocalExists.Resume
• Major: The setting FtpRemoteExists.Append is now renamed to FtpRemoteExists.Resume
• Major: Split FtpRemoteExists.Append into two properties with distinct behaviour (Resume and AddToEnd)
• Major: Improvements to UploadFile and UploadFileAsync to support appending and resuming of uploads
• Major: UploadFile always sets the length of the remote file stream before uploading, appending or resuming
• Major: UploadFile skips uploading in Resume mode if local and remote file are equal length
• Fix: Implementation for resuming uploads using UploadFile based on fixes in UploadFileAsync

Machine listings

• Major: GetListing prefers using Machine Listings over LIST command, unless a custom list parser is set
• Fix: ListingParser property is updated according to auto-detected parser during Connect and ConnectAsync
• Fix: DeleteDirectory and DereferenceLink methods no longer use ForceList and so prefer using Machine Listings

File hashing

• Major: All low-level hash methods are now inaccessible and GetChecksum is the only recommended approach
• Fix: GetChecksum now prints function call logs and sanitizes the input path
• New: GetChecksum switches to the first preferred hash algorithm for HASH command if no algorithm is specified
• New: GetChecksum validates if the required algorithm is unsupported and throws FtpHashUnsupportedException
• New: GetChecksum validates if hashing is unsupported by the server and throws FtpHashUnsupportedException
• Fix: GetChecksumAsync now takes the cancellation token last to follow conventions (argument reorder)
• Fix: Improved extraction of hash checksum when using the HASH command
• Fix: Improved extraction of hash checksum when using the MD5, SHA1, SHA256, SHA512 or X-series commands
• New: SetHashAlgorithm now only modifies the hash algorithm if it has changed

Path sanitization

• Fix: All high level API methods sanitize input paths to improve robustness
• Fix: GetWorkingDirectory always sanitizes the returned working path directory
• Fix: Correctly handle server-specific absolute FTP paths for async operations
• Fix: All function call logs now print the sanitized path rather than raw input path

Path improvements

• Major: GetWorkingDirectory is now extremely fast and caches the working dir path for subsequent calls
• Fix: FileExists supports checking name listings for Windows NT servers which use invalid slashes
• Fix: Root directory FTP paths no longer return ./ and instead return /

Other improvements

• Major: All legacy asynchronous methods using IAsyncResult pattern have been removed (outdated since 2012)
• Fix: FXP file transfers for glFTPd server always try PASV and CPSV commands to get passive port
• Fix: Add logging for skipped files in UploadFile
• Fix: Add file path details in skipped files logged by UploadFile and DownloadFile
• New: GetNameListing to print results of name listing as verbose logs, similar to GetListing
• New: GetFileSize and GetFileSizeAsync to support a configurable return value if the file does not exist
• New: FtpFolderNameRule now supports startSegment to skip checking root directory folder names
• New: FtpFolderNameRegexRule now supports startSegment to skip checking root directory folder names