Adding upstream version 1.64.0+dfsg1.upstream/1.64.0+dfsg1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 20 insertions, 0 deletions

diff --git a/vendor/always-assert/README.md b/vendor/always-assert/README.md
new file mode 100644
index 000000000..7494139a1
--- /dev/null
+++ b/vendor/always-assert/README.md
@@ -0,0 +1,20 @@
+# always-assert
+
+Recoverable assertions, inspired by [the use of `assert()` in SQLite](https://www.sqlite.org/assert.html).
+
+```rust
+use always_assert::never;
+
+fn apply_transaction(&mut self, tx: Transaction) -> Result<(), TransactionAborted> {
+    let delta = self.compute_delta(&tx);
+
+    if never!(!self.check_internal_invariant(&delta)) {
+        // Ok, something in this transaction messed up our internal state.
+        // This really shouldn't be happening, and this signifies a bug.
+        // Luckily, we can recover by just rejecting the transaction.
+        return abort_transaction(tx);
+    }
+    self.commit(delta);
+    Ok(())
+}
+```