FluentFTP

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
• 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 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

• New: IsEncrypted property to check if FTPS encryption is currently active for this connection
• Fix: ValidateCertificateRevocation property was not being honored in async version (thanks kolorotur)

• Fix: Ensure file streams read and write correctly even when no FtpClient is provided (thanks manuelxmarquez)
• Fix: Clear custom parser when removing parser or clearing all parsers (thanks rubenhuisman)

• New: DownloadDirectoryDeleteExcluded property to control if excluded files are deleted during Download (thanks philippjenni)
• Fix: Dispose AsyncWaitHandles to stop handle leak in .NET Framework 4.5 (thanks sdiaman1)
• Fix: Implement proper cancellation support in UploadDirectory (once file transfer begins it cannot be cancelled)
• Fix: Implement proper cancellation support in DownloadDirectory (once file transfer begins it cannot be cancelled)
• Fix: Implement proper cancellation support in FXP TransferDirectory
• Fix: Implement proper cancellation support in recursive GetListing
• Fix: Correctly resume when unexpectedEOF error received during uploading a file (thanks mrcopperbeard)
• Fix: Hide internal properties in FtpClient that are not meant to be exposed
• Fix: Update IFtpClient with the latest set of public properties that are meant to be exposed

• Fix: Expose LoadProfile API so it can be called by the generated code from AutoDetect

• New: DownloadZeroByteFiles property to control if zero-byte files should be downloaded or skipped
• Fix: Downloading 0-byte files crashes since no data downloaded

• New: Ability to handle custom non-standard FTP servers by extending FtpBaseServer
• Fix: Only overwrite local file after the first bytes downloaded of a remote file

• New: Track low-level progress with new TransferredBytes in FtpProgress class (thanks Adhara3)
• New: FXPProgressInterval property to control how often FXP progress reports are sent
• Fix: Hide TransferFileFXPInternal because its an internal transfer method and not to be used directly

• New: GetChecksum has special support for switching the server-side algorithm for HASH command support
• New: FXP file transfer now validates the file using the first mutually supported algorithm