Skip to content

Latest commit

 

History

History
96 lines (74 loc) · 7.91 KB

README.md

File metadata and controls

96 lines (74 loc) · 7.91 KB
Raw

FluentFTP

Version Downloads GitHub contributors Codacy grade License

FluentFTP is a fully managed FTP and FTPS library for .NET & .NET Standard, optimized for speed. It provides extensive FTP commands, File uploads/downloads, SSL/TLS connections, Automatic directory listing parsing, File hashing/checksums, File permissions/CHMOD, FTP proxies, UTF-8 support, Async/await support, Powershell support and more.

It is written entirely in C#, with no external dependencies. FluentFTP is released under the permissive MIT License, so it can be used in both proprietary and free/open source applications.

If you need priority support for a specific issue, consider funding it using IssueHunt.

Features

  • Full support for FTP, FTPS (FTP over SSL), FTPS with client certificates and FTPS with CCC (for FTP firewalls)
  • File management:
    • File and directory listing for all major server types (Unix, Windows/IIS, Azure, Pure-FTPd, ProFTPD, Vax, VMS, OpenVMS, Tandem, HP NonStop Guardian, IBM OS/400, AS400, Windows CE, Serv-U, etc)
    • Fully recursive directory listing and directory deletion (manual recursion and server-side recursion)
    • Easily upload and download a file from the server with progress tracking
    • Easily upload and download a directory from the server with easy synchronization modes
    • Automatically verify the hash of a file & retry transfer if hash mismatches
    • Configurable error handling (ignore/abort/throw) for multi-file transfers
    • Easily read and write file data from the server using standard streams
    • Create, append, read, write, rename, move and delete files and folders
    • Recursively deletes folders and all its contents
    • Get file/folder info (exists, size, security flags, modified date/time)
    • Get and set file permissions (owner, group, other)
    • Absolute or relative paths (relative to the "working directory")
    • Get the hash/checksum of a file (SHA-1, SHA-256, SHA-512, and MD5)
    • Dereference of symbolic links to calculate the linked file/folder
    • Throttling of uploads and downloads with configurable speed limit
  • FTP protocol:
  • Asynchronous support:
    • Synchronous and asynchronous methods using async/await for all operations
    • Asynchronous methods for .NET 4.0 and below using IAsyncResult pattern (Begin*/End*)
    • All asynchronous methods can be cancelled midway by passing a CancellationToken
    • All asynchronous methods honor the ReadTimeout and automatically cancel themselves if timed out
    • Improves thread safety by cloning the FTP control connection for file transfers (optional)
    • Implements its own internal locking in an effort to keep transactions synchronized
  • Extensible:
    • Easily add support for more proxy types (simply extend FTPClientProxy)
    • Easily add unsupported directory listing parsers (see the CustomParser example)
    • Easily add custom logging/tracing functionality using FtpTrace.AddListener
    • Easily add your own Powershell commands by extending the scripts in FluentFTP.ps1

Releases

Stable binaries are released on NuGet, and contain everything you need to use FTP/FTPS in your .Net/CLR application. For usage see the Quick Start Example and the Documentation wiki.

FluentFTP works on .NET and .NET Standard/.NET Core.

Platform Binaries Folder
.NET 2.0 net20
.NET 3.5 net35
.NET 4.0 net40
.NET 4.5 net45
.NET Standard 1.4 netstandard1.4
.NET Standard 1.6 netstandard1.6
.NET Standard 2.0 netstandard2.0

FluentFTP is also supported on these platforms: (via .NET Standard)

  • Mono 4.6
  • Xamarin.iOS 10.0
  • Xamarin.Android 10.0
  • Universal Windows Platform 10.0

Binaries for all platforms are built from a single VS 2017 Project. You will need VS 2017 to build or contribute to FluentFTP.

Example Usage

Check the wiki for a Quick start example.

Documentation and FAQs

Check the Wiki.