feat: add uuid (#3)

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "fastid"
-version = "0.0.2"
+version = "0.0.3"
 edition = "2021"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
@@ -15,3 +15,11 @@ ulid="1.1.0"
 pyo3="0.20.0"
 rs-snowflake = "0.6.0"
 once_cell = "1.19.0"
+
+[dependencies.uuid]
+version = "1.6.1"
+features = [
+    "v7",
+    "fast-rng",          # Use a faster (but still sufficiently random) RNG
+    "macro-diagnostics", # Enable better diagnostics for compile-time UUIDs
+]

README.md

@@ -3,4 +3,5 @@ Created for the easy and fast generation of various IDs
 
 # Supported IDs
 - ulid
-- snowflake
+- snowflake
+- uuid v7 (If you intend to use uuid in your database, this can be a great choice)

fastid.pyi

@@ -1,8 +1,14 @@
 def ulid() -> str:
     ...
 
+
 def snowflake_str(machine_id: int = 1, node_id: int = 1) -> str:
     ...
 
+
 def snowflake_int(machine_id: int = 1, node_id: int = 1) -> int:
     ...
+
+
+def uuid_v7() -> str:
+    ...

pyproject.toml

@@ -7,7 +7,7 @@ name = "fastid"
 description = "This is a library for quickly generating unique IDs in Python."
 authors = [{ name = "Seungwoo Hong", email = "[email protected]" }]
 requires-python = ">=3.7"
-keywords = ["unique-id", "id-generator", "ulid", "snowflake"]
+keywords = ["unique-id", "id-generator", "ulid", "snowflake", "uuid"]
 classifiers = [
     "Programming Language :: Rust",
     "Programming Language :: Python",

python/test/test_fastid.py

@@ -1,4 +1,5 @@
 import timeit
+import uuid
 
 import fastid
 from ulid import microsecond
@@ -14,3 +15,9 @@ def test_snowflake():
     print()
     print("fastid.snowflake_int", timeit.timeit(lambda: fastid.snowflake_int(), number=10000))
     print("fastid.snowflake_str", timeit.timeit(lambda: fastid.snowflake_str(), number=10000))
+
+
+def test_uuid():
+    print()
+    print("uuid.uuid4    ", timeit.timeit(lambda: uuid.uuid4(), number=10000))
+    print("fastid.uuid_v7", timeit.timeit(lambda: fastid.uuid_v7(), number=10000))

src/lib.rs

@@ -3,10 +3,12 @@ use once_cell::sync::Lazy;
 use pyo3::prelude::*;
 use snowflake::SnowflakeIdGenerator;
 use ulid::Ulid;
+use uuid::Uuid;
 
 static SNOWFLAKE_GENERATOR: Lazy<Mutex<SnowflakeIdGenerator>> = Lazy::new(|| {
     Mutex::new(SnowflakeIdGenerator::new(1, 1))
 });
+
 #[pyfunction]
 #[pyo3(name = "ulid")]
 fn get_ulid() -> PyResult<String> {
@@ -20,6 +22,7 @@ fn get_snowflake(machine_id: Option<i32>, node_id: Option<i32>) -> i64 {
     sg.machine_id = machine_id.unwrap_or(1);
     sg.real_time_generate()
 }
+
 #[pyfunction]
 #[pyo3(name = "snowflake_str")]
 fn get_snowflake_str(machine_id: Option<i32>, node_id: Option<i32>) -> PyResult<String> {
@@ -32,6 +35,11 @@ fn get_snowflake_int(machine_id: Option<i32>, node_id: Option<i32>) -> PyResult<
     Ok(get_snowflake(machine_id, node_id))
 }
 
+#[pyfunction]
+fn uuid_v7() -> PyResult<String> {
+    Ok(Uuid::now_v7().to_string())
+}
+
 
 #[pymodule]
 fn fastid(_py: Python, m: &PyModule) -> PyResult<()> {
@@ -40,5 +48,7 @@ fn fastid(_py: Python, m: &PyModule) -> PyResult<()> {
     m.add_function(wrap_pyfunction!(get_snowflake_int, m)?)?;
     m.add_function(wrap_pyfunction!(get_snowflake_str, m)?)?;
 
+    m.add_function(wrap_pyfunction!(uuid_v7, m)?)?;
+
     Ok(())
 }