Mark hex_bytes2hex_str_unchecked as unsafe (#15)

Author: aurexav

CHANGELOG

@@ -1,3 +1,6 @@
+## v4.1.0
+- Mark `hex_bytes2hex_str_unchecked` as unsafe.
+
 ## v4.0.0
 - Use `is_hex_ascii` to optimize performance.
 - Add benchmark results.

Cargo.lock

@@ -18,7 +18,7 @@ license = "GPL-3.0"
 name = "array-bytes"
 readme = "README.md"
 repository = "https://github.com/hack-ink/array-bytes"
-version = "4.0.0"
+version = "4.1.0"
 
 [badges]
 maintenance = { status = "actively-developed" }

Cargo.toml

@@ -8,9 +8,7 @@ use rustc_hex::{FromHex, ToHex};
 const DATA: &[u8] = include_bytes!("../src/lib.rs");
 
 fn bench_encode(c: &mut Criterion) {
-	c.bench_function("array_bytes::bytes2hex", |b| {
-		b.iter(|| array_bytes::bytes2hex("", DATA))
-	});
+	c.bench_function("array_bytes::bytes2hex", |b| b.iter(|| array_bytes::bytes2hex("", DATA)));
 
 	c.bench_function("hex::encode", |b| b.iter(|| hex::encode(DATA)));
 

benches/bench.rs

@@ -4,11 +4,11 @@ edition  = "2021"
 metadata = { cargo-fuzz = true }
 name     = "array-bytes-fuzz"
 publish  = false
-version  = "4.0.0"
+version  = "4.1.0"
 
 [dependencies]
-array-bytes   = { path = ".." }
-libfuzzer-sys = "0.4"
+array-bytes   = { version = "4.1", path = ".." }
+libfuzzer-sys = { version = "0.4" }
 
 [workspace]
 members = ["."]

fuzz/Cargo.toml

@@ -235,16 +235,16 @@ pub fn hex_bytes2hex_str(bytes: &[u8]) -> ArrayBytesResult<&str> {
 ///
 /// # Examples
 /// ```
-/// assert_eq!(
-/// 	array_bytes::hex_bytes2hex_str_unchecked(b"0x4c6f7665204a616e6520466f7265766572"),
-/// 	"0x4c6f7665204a616e6520466f7265766572",
-/// );
+/// unsafe {
+/// 	assert_eq!(
+/// 		array_bytes::hex_bytes2hex_str_unchecked(b"0x4c6f7665204a616e6520466f7265766572"),
+/// 		"0x4c6f7665204a616e6520466f7265766572",
+/// 	);
+/// }
 /// ```
-pub fn hex_bytes2hex_str_unchecked(bytes: &[u8]) -> &str {
-	unsafe {
-		#[allow(clippy::transmute_bytes_to_str)]
-		mem::transmute(bytes)
-	}
+pub unsafe fn hex_bytes2hex_str_unchecked(bytes: &[u8]) -> &str {
+	#[allow(clippy::transmute_bytes_to_str)]
+	mem::transmute(bytes)
 }
 
 /// [`Bytes`] to [`Hex`].
@@ -599,5 +599,6 @@ where
 fn is_hex_ascii(byte: &u8) -> bool {
 	// Convert to lowercase.
 	let byte = byte | 0b10_0000;
+
 	matches!(byte, b'0'..=b'9' | b'a'..=b'f')
 }

src/lib.rs

@@ -105,14 +105,16 @@ fn hex_bytes2hex_str_should_work() {
 
 #[test]
 fn hex_bytes2hex_str_unchecked_should_work() {
-	assert_eq!(
-		hex_bytes2hex_str_unchecked(b"0x4c6f7665204a616e6520466f7265766572"),
-		"0x4c6f7665204a616e6520466f7265766572",
-	);
-	assert_eq!(
-		hex_bytes2hex_str_unchecked(b"4c6f7665204a616e6520466f7265766572"),
-		"4c6f7665204a616e6520466f7265766572",
-	);
+	unsafe {
+		assert_eq!(
+			hex_bytes2hex_str_unchecked(b"0x4c6f7665204a616e6520466f7265766572"),
+			"0x4c6f7665204a616e6520466f7265766572",
+		);
+		assert_eq!(
+			hex_bytes2hex_str_unchecked(b"4c6f7665204a616e6520466f7265766572"),
+			"4c6f7665204a616e6520466f7265766572",
+		);
+	}
 }
 
 #[test]