Adding upstream version 1.5.0.upstream/1.5.0upstream

Signed-off-by: Daniel Baumann <daniel@debian.org>

1 files changed, 57 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e338789
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# sha256 crypto digest
+
+[docsrs]: https://docs.rs/sha256
+
+[![GitHub Actions](https://github.com/baoyachi/sha256-rs/workflows/check/badge.svg)](https://github.com/baoyachi/sha256-rs/actions?query=workflow%3Abuild)
+[![Crates.io](https://img.shields.io/crates/v/sha256.svg)](https://crates.io/crates/sha256)
+[![Docs.rs](https://docs.rs/sha256/badge.svg)](https://docs.rs/sha256)
+[![Download](https://img.shields.io/crates/d/sha256)](https://crates.io/crates/sha256)
+
+
+## Examples
+
+#### sha256 digest function
+
+```rust
+use sha256::digest;
+
+fn main() {
+    let input = String::from("hello");
+    let val = digest(input);
+    assert_eq!(val,"2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824");
+    
+    //sha256 digest &str
+    let input = "hello";
+    let val = digest(input);
+    assert_eq!(val,"2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824");
+    
+    //sha256 digest &mut &str
+    let mut input = "hello";
+    let val = digest(&mut input);
+    assert_eq!(val,"2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824");
+    
+    //sha256 digest char
+    let mut input = "π";
+    let val = digest(input);
+    assert_eq!(val,"2617fcb92baa83a96341de050f07a3186657090881eae6b833f66a035600f35a");
+
+
+    let input = b"hello";
+    let val = digest(input);
+    assert_eq!(val, "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824");
+}
+```
+
+#### sha256 try_digest function
+
+```rust
+use sha256::try_digest;
+use std::path::Path;
+
+fn main() {
+    let input = Path::new("./foo.file");
+    let val = try_digest(input).unwrap();
+    assert_eq!(val,"433855b7d2b96c23a6f60e70c655eb4305e8806b682a9596a200642f947259b1");
+}
+```
+