Release libunftp v0.21.1

- Upgrade major and minor dependencies
- Update the changelog
- Bump libunftp version to 0.21.1
- README improvements

Author: hannesdejager

CHANGELOG.md

@@ -1,15 +1,17 @@
 # Changelog
 
-### libunftp upcoming (unreleased)
+### libunftp 0.22.0
 
+- Compile against Rust 1.92.0 in CI
+- [#547](https://github.com/bolcom/libunftp/pull/547) Put metrics and proxy-protocol functionality behind features (`prometheus` and `proxy_protocol`).
+- [#548](https://github.com/bolcom/libunftp/pull/548) Fix error message typos
 - [#541](https://github.com/bolcom/libunftp/pull/541) Initial MLSD (Machine List Directory) command implementation (RFC 3659)
-- [#541](https://github.com/bolcom/libunftp/pull/541)Fix MLST output formatting
-- [#541](https://github.com/bolcom/libunftp/pull/541)Fix: MLSx facts must have a terminating semicolon according to RFC 3659 section 7.2
-- [#541](https://github.com/bolcom/libunftp/pull/541)Fix wrong use of metadata.uid() instead of metadata.gid()
+- [#541](https://github.com/bolcom/libunftp/pull/541) Fix MLST output formatting
+- [#541](https://github.com/bolcom/libunftp/pull/541) Fix MLSx facts must have a terminating semicolon according to RFC 3659 section 7.2
+- [#541](https://github.com/bolcom/libunftp/pull/541) Fix wrong use of metadata.uid() instead of metadata.gid()
 - [#540](https://github.com/bolcom/libunftp/pull/540) Fix build with "ring" instead of "aws_lc_rs" feature
 - Implement 550 error code for RNFR command
-- Bump dependencies (async-trait pinned to =0.1.88)
-- [#545](https://github.com/bolcom/libunftp/pull/545) Make Clippy happy
+- Bump dependencies
 
 ### unftp-sbe-gcs v0.2.8
 

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "libunftp"
-version = "0.21.0" # remember to update html_root_url
+version = "0.21.1" # remember to update html_root_url
 authors = [
     "Agoston Horvath <ahorvath@bol.com>",
     "Dávid Kosztka <dkosztka@bol.com>",
@@ -42,21 +42,21 @@ aws_lc_rs = ["rustls/aws_lc_rs", "rustls/logging", "rustls/std", "rustls/tls12"]
 prometheus = ["dep:prometheus"]
 proxy_protocol = ["dep:proxy-protocol"]
 experimental = []
-default = ["aws_lc_rs"]
+default = ["aws_lc_rs", "prometheus", "proxy_protocol"]
 all = ["aws_lc_rs", "prometheus", "proxy_protocol"]
 
 [dependencies]
 async-trait = "=0.1.88"
 bitflags = "2.10.0"
 bytes = "1.11.0"
 chrono = { version = "0.4.42", default-features = false, features = ["clock", "std"] }
-derive_more = { version = "2.1.0", features = ["display"] }
+derive_more = { version = "2.1.1", features = ["display"] }
 futures-util = { version = "0.3.31", default-features = false, features = ["alloc", "sink"] }
 getrandom = "0.3.4"
 lazy_static = "1.5.0"
 md-5 = "0.10.6"
-moka = { version = "0.12.11", default-features = false, features = ["sync"] }
-nix = { version = "0.29.0", default-features = false, features = ["fs"] }
+moka = { version = "0.12.12", default-features = false, features = ["sync"] }
+nix = { version = "0.30.1", default-features = false, features = ["fs"] }
 prometheus = { version = "0.14.0", default-features = false, optional = true }
 proxy-protocol = { version = "0.5.0", optional = true }
 rustls = { version = "0.23.35", default-features = false }
@@ -69,12 +69,12 @@ tokio-util = { version = "0.7.17", features = ["codec"] }
 tracing = { version = "0.1.44", default-features = false }
 tracing-attributes = "0.1.31"
 uuid = { version = "1.19.0", features = ["v4"] }
-x509-parser = "0.17.0"
+x509-parser = "0.18.0"
 dashmap = "6.1.0"
 libc = "0.2"
 
 [dev-dependencies]
-libunftp = { path = ".", features = ["all"] }
+libunftp = { path = "." }
 pretty_assertions = "1.4.1"
 tokio = { version = "1.48.0", features = ["macros", "rt-multi-thread"] }
 unftp-sbe-fs = { path = "../libunftp/crates/unftp-sbe-fs" }

README.md

@@ -10,8 +10,7 @@ When you need to FTP, but don't want to.
 
 ![logo](logo.png)
 
-[**Website**](https://unftp.rs) | [**API Docs**](https://docs.rs/libunftp) | [**unFTP
-**](https://github.com/bolcom/unFTP)
+[**Website**](https://unftp.rs) | [**API Docs**](https://docs.rs/libunftp) | [**unFTP**](https://github.com/bolcom/unFTP)
 
 The libunftp library drives [unFTP](https://github.com/bolcom/unFTP). It's an extensible, async, cloud orientated FTP(S)
 server implementation in [Rust](https://rust-lang.org) brought to you by the [bol.com techlab](https://techlab.bol.com).
@@ -25,27 +24,31 @@ possible.
 
 Feature highlights:
 
-* 39 Supported FTP commands (see [commands directory](./src/server/controlchan/commands)) and growing
+* 41 Supported FTP commands (see [commands directory](./src/server/controlchan/commands)) and growing
 * Ability to implement own storage back-ends
 * Ability to implement own authentication back-ends
 * Explicit FTPS (TLS)
 * Mutual TLS (Client certificates)
 * TLS session resumption
-* Prometheus integration
+* Prometheus integration (enabled by default, can be disabled)
 * Structured Logging
-* [Proxy Protocol](https://www.haproxy.com/blog/haproxy/proxy-protocol/) support
+* [Proxy Protocol](https://www.haproxy.com/blog/haproxy/proxy-protocol/) support (enabled by default, can be disabled)
 * Automatic session timeouts
 * Per user IP allow lists
 * Configurable cryptographic providers (ring or aws-lc-rs)
 
 Known storage back-ends:
 
+* [unftp-sbe-fatfs](https://crates.io/crates/unftp-sbe-fatfs) - Provides read-only access to FAT filesystem images
 * [unftp-sbe-fs](https://crates.io/crates/unftp-sbe-fs) - Stores files on the local filesystem
 * [unftp-sbe-gcs](https://crates.io/crates/unftp-sbe-gcs) - Stores files in Google Cloud Storage
+* [unftp-sbe-iso](https://crates.io/crates/unftp-sbe-iso) - Provides FTP access to ISO 9660 files
+* [unftp-sbe-opendal](https://crates.io/crates/unftp-sbe-opendal) - Provides access to various storage services through Apache OpenDAL (supports S3, Azure Blob Storage, and more)
+* [unftp-sbe-restrict](https://crates.io/crates/unftp-sbe-restrict) - Wraps another storage back-end in order to restrict
+  the FTP operations a user can do i.e. provide authorization.
 * [unftp-sbe-rooter](https://crates.io/crates/unftp-sbe-rooter) - Wraps another storage back-end in order to root a user
   to a specific home directory.
-* [unftp-sbe-restrict](https://crates.io/crates/unftp-sbe-rooter) - Wraps another storage back-end in order to restrict
-  the FTP operations a user can do i.e. provide authorization.
+* [unftp-sbe-webdav](https://crates.io/crates/unftp-sbe-webdav) - A WebDAV storage back-end providing translation between FTP & WebDAV
 
 Known authentication back-ends:
 
@@ -65,16 +68,38 @@ To use a specific provider, enable the corresponding feature in your `Cargo.toml
 
 ```toml
 [dependencies]
-libunftp = { version = "0.21.0", features = ["ring"] }  # Use ring
+libunftp = { version = "0.21.1", features = ["ring"] }  # Use ring
 # or
-libunftp = { version = "0.21.0", features = ["aws_lc_rs"] }  # Use aws-lc-rs (default)
+libunftp = { version = "0.21.1", features = ["aws_lc_rs"] }  # Use aws-lc-rs (default)
 ```
 
 The default provider is `aws-lc-rs` for backward compatibility. Choose the provider that best fits your needs:
 
 - [`ring`](https://crates.io/crates/ring): More widely used, good for general-purpose applications
 - [`aws-lc-rs`](https://crates.io/crates/aws-lc-rs): Optimized for AWS environments, good for cloud deployments
 
+## Optional Features
+
+The following feature flags are included in the default features but can be disabled to reduce dependencies:
+
+- `prometheus`: Enables Prometheus metrics integration. When enabled, you can collect metrics about FTP operations, sessions, and transfers using the `.metrics()` method on the server builder. **Enabled by default.**
+
+- `proxy_protocol`: Enables [Proxy Protocol](https://www.haproxy.com/blog/haproxy/proxy-protocol/) support. This allows the server to receive client connection information (IP address and port) when behind a proxy or load balancer. **Enabled by default.**
+
+To disable these features and reduce dependencies, use `default-features = false` and explicitly enable only what you need:
+
+```toml
+[dependencies]
+libunftp = { version = "0.21.1", default-features = false, features = ["aws_lc_rs"] }
+```
+
+Or enable all features explicitly:
+
+```toml
+[dependencies]
+libunftp = { version = "0.21.1", features = ["all"] }
+```
+
 ## Prerequisites
 
 You'll need [Rust](https://rust-lang.org) 1.85.0 or higher to build libunftp.
@@ -93,7 +118,7 @@ add. Here we choose the [file system back-end](https://crates.io/crates/unftp-sb
 
 ```toml
 [dependencies]
-libunftp = "0.21.0"
+libunftp = "0.21.1"
 unftp-sbe-fs = "0.2"
 tokio = { version = "1", features = ["full"] }
 ```

crates/unftp-auth-jsonfile/Cargo.toml

@@ -23,10 +23,10 @@ base64 = "0.22.1"
 bytes = "1.11.0"
 ipnet = "2.11.0"
 iprange = "0.6.7"
-libunftp = { version = "0.21.0", path = "../../", default-features = false }
+libunftp = { version = "0.21.1", path = "../../", default-features = false }
 ring = "0.17.14"
 serde = { version = "1.0.228", features = ["derive"] }
-serde_json = "1.0.145"
+serde_json = "1.0.146"
 tokio = { version = "1.48.0", features = ["rt", "time"] }
 tracing = { version = "0.1.44", default-features = false }
 tracing-attributes = "0.1.31"

crates/unftp-auth-pam/Cargo.toml

@@ -20,7 +20,7 @@ readme = "README.md"
 
 [dependencies]
 async-trait = "=0.1.88"
-libunftp = { version = "0.21.0", path = "../../", default-features = false }
+libunftp = { version = "0.21.1", path = "../../", default-features = false }
 tracing = { version = "0.1.44", default-features = false }
 tracing-attributes = "0.1.31"
 

crates/unftp-auth-rest/Cargo.toml

@@ -23,11 +23,11 @@ http-body-util = "0.1.3"
 hyper = { version = "1.8.1", features = ["client", "http1"] }
 hyper-rustls = "0.27.7"
 hyper-util = "0.1.19"
-libunftp = { version = "0.21.0", path = "../../", default-features = false }
+libunftp = { version = "0.21.1", path = "../../", default-features = false }
 percent-encoding = "2.3.2"
 regex = "1.12.2"
 serde = { version = "1.0.228", features = ["derive"] }
-serde_json = "1.0.145"
+serde_json = "1.0.146"
 tokio = { version = "1.48.0", features = ["rt", "net", "sync", "io-util", "time"] }
 tracing = { version = "0.1.44", default-features = false }
 tracing-attributes = "0.1.31"

crates/unftp-sbe-fs/Cargo.toml

@@ -26,10 +26,10 @@ default = ["aws_lc_rs"]
 [dependencies]
 async-trait = "=0.1.88"
 cfg-if = "1.0"
-cap-std = "3.4"
+cap-std = "4.0"
 futures = { version = "0.3.31", default-features = false, features = ["std"] }
 lazy_static = "1.5.0"
-libunftp = { version = "0.21.0", path = "../../", default-features = false }
+libunftp = { version = "0.21.1", path = "../../", default-features = false }
 path_abs = "0.5.1"
 tokio = { version = "1.48.0", features = ["rt", "net", "sync", "io-util", "time", "fs"] }
 tokio-stream = "0.1.17"
@@ -41,13 +41,13 @@ async_ftp = "6.0.0"
 async-trait = "=0.1.88"
 chrono = "0.4.42"
 more-asserts = "0.3.1"
-nix = { version = "0.29.0", default-features = false, features = ["user"] }
+nix = { version = "0.30.1", default-features = false, features = ["user"] }
 pretty_assertions = "1.4.1"
 pretty_env_logger = "0.5.0"
 regex = "1.12.2"
-rstest = "0.25.0"
+rstest = "0.26.1"
 serde = { version = "1.0.228", features = ["derive"] }
-serde_json = "1.0.145"
+serde_json = "1.0.146"
 slog-async = "2.8.0"
 slog-term = "2.9.2"
 tempfile = "3.23.0"

crates/unftp-sbe-fs/README.md

@@ -21,7 +21,7 @@ Add the libunftp and tokio crates to your project's dependencies in `Cargo.toml`
 
 ```toml
 [dependencies]
-libunftp = "0.21.0"
+libunftp = "0.21.1"
 unftp-sbe-fs = "0.2.6"
 tokio = { version = "1", features = ["full"] }
 ```

crates/unftp-sbe-gcs/Cargo.toml

@@ -27,11 +27,11 @@ http-body-util = "0.1.3"
 hyper = { version = "1.8.1", features = ["client", "http1"] }
 hyper-rustls = "0.27.7"
 hyper-util = "0.1.19"
-libunftp = { version = "0.21.0", path = "../../", default-features = false }
+libunftp = { version = "0.21.1", path = "../../", default-features = false }
 mime = "0.3.17"
 percent-encoding = "2.3.2"
 serde = { version = "1.0.228", features = ["derive"] }
-serde_json = "1.0.145"
+serde_json = "1.0.146"
 time = "0.3.44"
 tokio = { version = "1.48.0", features = ["rt", "net", "sync", "io-util", "time", "fs"] }
 tokio-stream = "0.1.17"

crates/unftp-sbe-gcs/README.md

@@ -15,7 +15,7 @@ Add the needed dependencies to Cargo.toml:
 
  ```toml
  [dependencies]
-libunftp = "0.21.0"
+libunftp = "0.21.1"
 unftp-sbe-gcs = "0.2.7"
 tokio = { version = "1", features = ["full"] }
  ```