nftables-async 0.3.0

An async version of the helper to run nftables, providing full compatibility with the rest of the nftables crate
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
## nftables-async

An async version of the helper to run nftables in the `nftables` crate. Simply add both `nftables-async` and `nftables` to your crate, then use the `nftables_async::apply_ruleset` or `nftables_async::get_current_ruleset` to perform manipulations. Everything is compatible with the sync helper, even the error types, the functions, however, return "true" async futures.

To provide the asynchronous I/O, an implementation of the `Process` trait in the crate is needed. Two implementations are provided built-in behind feature gates:

1. `TokioProcess` using the Tokio stack, enabled via `tokio-process` feature
2. `AsyncProcess` using the `async-process` crate (Smol stack), enabled via `async-process` feature.

### Why not the async helpers in nftables >0.6?

`nftables 0.6.0` introduced `tokio` and `async-process` features that are mostly equivalent to this crate, however, these have some disadvantages that make `nftables-async` still relevant:

1. The support in `nftables` is not implemented via a trait (like `nftables_async::Process`), meaning third-party extensions for async platforms other than Tokio or the `async-*` stack are not easily possible.
2. The two features are mutually exclusive, making it impossible to compile an `nftables` that has both enabled. This breaks the use-case of `fcnet`, that needs both when enabling multiple runtime features, and is generally inconvenient.