From 8534058371e700ce408f4caba7f5259a720b57d0 Mon Sep 17 00:00:00 2001
From: Markus Mayer <widemeadows@gmail.com>
Date: Sat, 19 Aug 2023 20:33:28 +0200
Subject: [PATCH] Add ShortGuid::from_bytes_le

---
 CHANGELOG.md |  6 ++++++
 src/lib.rs   | 29 +++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index afd2046..96d806d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+### Added
+
+- Added `ShortGuid::from_bytes_le` as a counterpart to `to_bytes_le`.
+
 ## 0.5.0 - 2023-06-24
 
 ### Added
diff --git a/src/lib.rs b/src/lib.rs
index e8d0a55..03feb9f 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -100,6 +100,35 @@ impl ShortGuid {
         Self(Uuid::from_bytes_ref(bytes.borrow()).clone())
     }
 
+    /// Constructs a [`ShortGuid`] instance based on a byte slice of bytes ordered in little endian.
+    ///
+    /// ## Notes
+    /// This will clone the underlying data. If you wish to return a
+    /// transparent reference around the provided slice, use [`ShortGuid::from_bytes_ref`]
+    /// instead.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// # use shortguid::ShortGuid;
+    /// let bytes1 = [
+    ///     0xa1, 0xa2, 0xa3, 0xa4,
+    ///     0xb1, 0xb2,
+    ///     0xc1, 0xc2,
+    ///     0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8,
+    /// ];
+    /// let uuid1 = ShortGuid::from_bytes_ref(&bytes1);
+    ///
+    /// let bytes2 = uuid1.to_bytes_le();
+    /// let uuid2 = ShortGuid::from_bytes_le(bytes2);
+    ///
+    /// assert_eq!(uuid1, &uuid2);
+    /// ```
+    #[inline]
+    pub fn from_bytes_le<B: Borrow<[u8; 16]>>(bytes: B) -> Self {
+        Self(Uuid::from_bytes_le(bytes.borrow().clone()))
+    }
+
     /// Returns a slice of 16 octets containing the value.
     ///
     /// This method borrows the underlying byte value of the UUID.