uuid-kit 2.0.0__tar.gz → 2.0.2__tar.gz

{uuid_kit-2.0.0/uuid_kit.egg-info → uuid_kit-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uuid-kit
-Version: 2.0.0
+Version: 2.0.2
 Summary: Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options.
 Author: Troy Tessalone
 License: MIT
@@ -8,6 +8,12 @@ Project-URL: Homepage, https://github.com/troytessalone/uuid-kit
 Project-URL: Issues, https://github.com/troytessalone/uuid-kit/issues
 Keywords: uuid,uuidv4,uuidv7,generator,utility,formatting,transform,output
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
@@ -18,7 +24,7 @@ Dynamic: license-file
 
 # uuid-kit
 
-Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options.
+Generate UUID values (`v4`, `v7`) with flexible formatting, prefixes, suffixes, and output shape options.
 
 ---
 
@@ -168,7 +174,7 @@ Example output:
       "raw": "123e4567-e89b-12d3-a456-426614174001",
       "index": 1,
       "timestamp": {
-        "iso": "2026-04-09T18:00:00Z",
+        "iso": "2026-04-09T18:00:00.001000Z",
         "unix": 1775757600001
       }
     }
@@ -190,7 +196,7 @@ Example output:
   "format": "standard",
   "output_as": "string",
   "count": 3,
-  "items": "uuid-1,uuid-2,uuid-3"
+  "items": "uuid-1\nuuid-2\nuuid-3"
 }
 ```
 
@@ -211,18 +217,18 @@ Each object includes:
 - `uuid` = final formatted value
 - `raw` = original UUID before formatting
 - `index` = zero-based position in the result set
-- `timestamp` = only for v7, derived from the UUID
+- `timestamp` = only included for `v7` when `outputAs="object"`
 
 ### `outputAs="string"`
 
-Returns `items` as a single comma-delimited string.
+Returns `items` as a single newline-delimited string.
 
 ---
 
 ## Supported Versions
 
 - `v4` = random
-- `v7` = modern time-based
+- `v7` = time-based, sortable, recommended
 
 ---
 
@@ -235,6 +241,29 @@ from uuid_kit import ALLOWED_FORMATS, ALLOWED_VERSIONS, ALLOWED_OUTPUT_AS
 
 ---
 
+## Behavior
+
+- Invalid or missing `count` defaults to `1`
+- `count` is capped at `100`
+- `count` is converted to an integer
+- Invalid or missing `version` defaults to `v7`
+- Invalid or missing `format` defaults to `standard`
+- Invalid or missing `outputAs` defaults to `array`
+
+---
+
+## Performance Notes
+
+`uuid-kit` avoids unnecessary work during generation:
+
+- Object records are only built when `outputAs="object"`
+- Timestamps are only extracted for `v7` object output
+- List storage is preallocated for efficient generation
+
+This keeps array and string output paths lighter and faster.
+
+---
+
 ## Environment Notes
 
 Some hosted Python runtimes require you to explicitly add packages before use. In those environments, add:
@@ -246,16 +275,6 @@ uuid6
 
 ---
 
-## Behavior
-
-- Invalid or missing `count` defaults to `1`
-- `count` is capped at `100`
-- Invalid or missing `version` defaults to `v7`
-- Invalid or missing `format` defaults to `standard`
-- Invalid or missing `outputAs` defaults to `array`
-
----
-
 ## Notes
 
 - Python standard library does not yet include native UUID v7 support

{uuid_kit-2.0.0 → uuid_kit-2.0.2}/README.md

@@ -1,6 +1,6 @@
 # uuid-kit
 
-Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options.
+Generate UUID values (`v4`, `v7`) with flexible formatting, prefixes, suffixes, and output shape options.
 
 ---
 
@@ -150,7 +150,7 @@ Example output:
       "raw": "123e4567-e89b-12d3-a456-426614174001",
       "index": 1,
       "timestamp": {
-        "iso": "2026-04-09T18:00:00Z",
+        "iso": "2026-04-09T18:00:00.001000Z",
         "unix": 1775757600001
       }
     }
@@ -172,7 +172,7 @@ Example output:
   "format": "standard",
   "output_as": "string",
   "count": 3,
-  "items": "uuid-1,uuid-2,uuid-3"
+  "items": "uuid-1\nuuid-2\nuuid-3"
 }
 ```
 
@@ -193,18 +193,18 @@ Each object includes:
 - `uuid` = final formatted value
 - `raw` = original UUID before formatting
 - `index` = zero-based position in the result set
-- `timestamp` = only for v7, derived from the UUID
+- `timestamp` = only included for `v7` when `outputAs="object"`
 
 ### `outputAs="string"`
 
-Returns `items` as a single comma-delimited string.
+Returns `items` as a single newline-delimited string.
 
 ---
 
 ## Supported Versions
 
 - `v4` = random
-- `v7` = modern time-based
+- `v7` = time-based, sortable, recommended
 
 ---
 
@@ -217,6 +217,29 @@ from uuid_kit import ALLOWED_FORMATS, ALLOWED_VERSIONS, ALLOWED_OUTPUT_AS
 
 ---
 
+## Behavior
+
+- Invalid or missing `count` defaults to `1`
+- `count` is capped at `100`
+- `count` is converted to an integer
+- Invalid or missing `version` defaults to `v7`
+- Invalid or missing `format` defaults to `standard`
+- Invalid or missing `outputAs` defaults to `array`
+
+---
+
+## Performance Notes
+
+`uuid-kit` avoids unnecessary work during generation:
+
+- Object records are only built when `outputAs="object"`
+- Timestamps are only extracted for `v7` object output
+- List storage is preallocated for efficient generation
+
+This keeps array and string output paths lighter and faster.
+
+---
+
 ## Environment Notes
 
 Some hosted Python runtimes require you to explicitly add packages before use. In those environments, add:
@@ -228,16 +251,6 @@ uuid6
 
 ---
 
-## Behavior
-
-- Invalid or missing `count` defaults to `1`
-- `count` is capped at `100`
-- Invalid or missing `version` defaults to `v7`
-- Invalid or missing `format` defaults to `standard`
-- Invalid or missing `outputAs` defaults to `array`
-
----
-
 ## Notes
 
 - Python standard library does not yet include native UUID v7 support

{uuid_kit-2.0.0 → uuid_kit-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uuid-kit"
-version = "2.0.0"
+version = "2.0.2"
 description = "Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options."
 readme = "README.md"
 authors = [
@@ -27,10 +27,19 @@ keywords = [
 
 classifiers = [
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent"
 ]
 
 [project.urls]
 Homepage = "https://github.com/troytessalone/uuid-kit"
-Issues = "https://github.com/troytessalone/uuid-kit/issues"
+Issues = "https://github.com/troytessalone/uuid-kit/issues"
+
+[tool.setuptools.package-data]
+uuid_kit = ["py.typed"]

{uuid_kit-2.0.0 → uuid_kit-2.0.2}/uuid_kit/core.py

@@ -2,6 +2,7 @@
 
 import importlib
 import uuid
+from datetime import datetime, timezone
 
 _uuid7_fn = None
 
@@ -32,22 +33,19 @@ ALLOWED_OUTPUT_AS = (
 )
 
 
-def get_formatter(format_value):
-    if format_value == "compact":
-        return lambda v: v.replace("-", "")
-    if format_value == "uppercase":
-        return lambda v: v.upper()
-    if format_value == "uppercase-compact":
-        return lambda v: v.replace("-", "").upper()
-    return lambda v: v
+def _generate_v4():
+    return str(uuid.uuid4())
+
+
+def _generate_v7():
+    if HAS_UUID7 and _uuid7_fn:
+        return str(_uuid7_fn())
+    return str(uuid.uuid4())
 
 
 def extract_timestamp_v7(uuid_value):
     hex_value = uuid_value.replace("-", "")[:12]
     ms = int(hex_value, 16)
-
-    from datetime import datetime, timezone
-
     dt = datetime.fromtimestamp(ms / 1000, tz=timezone.utc)
 
     return {
@@ -56,6 +54,20 @@ def extract_timestamp_v7(uuid_value):
     }
 
 
+VERSION_CONFIG = {
+    "v4": {
+        "generator": _generate_v4,
+        "hasTimestamp": False,
+        "extractTimestamp": None
+    },
+    "v7": {
+        "generator": _generate_v7,
+        "hasTimestamp": True,
+        "extractTimestamp": extract_timestamp_v7
+    }
+}
+
+
 def generate_uuid(
     count=1,
     version="v7",
@@ -109,71 +121,51 @@ def generate_uuid(
     normalized_output_as = str(outputAs or "array").lower()
     final_output_as = normalized_output_as if normalized_output_as in ALLOWED_OUTPUT_AS else "array"
 
-    formatter = get_formatter(final_format)
+    generator = VERSION_CONFIG[final_version]["generator"]
+    has_timestamp = VERSION_CONFIG[final_version]["hasTimestamp"]
+    extract_timestamp = VERSION_CONFIG[final_version]["extractTimestamp"]
 
-    # ===============================
-    # VERSION CONFIG
-    # ===============================
-    def generate_v4():
-        return str(uuid.uuid4())
-
-    def generate_v7():
-        if HAS_UUID7 and _uuid7_fn:
-            return str(_uuid7_fn())
-        return str(uuid.uuid4())
-
-    version_config = {
-        "v4": {
-            "generator": generate_v4,
-            "hasTimestamp": False,
-            "extractTimestamp": None
-        },
-        "v7": {
-            "generator": generate_v7,
-            "hasTimestamp": True,
-            "extractTimestamp": extract_timestamp_v7
-        }
-    }
-
-    generator = version_config[final_version]["generator"]
-    has_timestamp = version_config[final_version]["hasTimestamp"]
-    extract_timestamp = version_config[final_version]["extractTimestamp"]
+    # Precompute format and affix behavior for the hot loop.
+    use_compact = final_format in ("compact", "uppercase-compact")
+    use_upper = final_format in ("uppercase", "uppercase-compact")
+    prefix_str = str(prefix) if prefix else ""
+    suffix_str = str(suffix) if suffix else ""
 
     # ===============================
-    # GENERATE
+    # GENERATE (optimized)
     # ===============================
-    values = []
-    objects = []
+    needs_object = final_output_as == "object"
+
+    values = None if needs_object else [None] * safe_count
+    objects = [None] * safe_count if needs_object else None
 
     for i in range(safe_count):
         raw = generator()
-
-        timestamp = None
-        if has_timestamp and extract_timestamp:
-            try:
-                timestamp = extract_timestamp(raw)
-            except Exception:
-                timestamp = None
-
-        value = formatter(raw)
-
-        if prefix:
-            value = str(prefix) + value
-        if suffix:
-            value = value + str(suffix)
-
-        values.append(value)
-
-        obj = {
-            "uuid": value,
-            "raw": raw,
-            "index": i
-        }
-
-        if timestamp:
-            obj["timestamp"] = timestamp
-
-        objects.append(obj)
+        value = raw
+
+        if use_compact:
+            value = value.replace("-", "")
+        if use_upper:
+            value = value.upper()
+        if prefix_str or suffix_str:
+            value = prefix_str + value + suffix_str
+
+        if needs_object:
+            obj = {
+                "uuid": value,
+                "raw": raw,
+                "index": i
+            }
+
+            if has_timestamp and extract_timestamp:
+                try:
+                    obj["timestamp"] = extract_timestamp(raw)
+                except Exception:
+                    pass
+
+            objects[i] = obj
+        else:
+            values[i] = value
 
     # ===============================
     # SHAPE OUTPUT
@@ -181,7 +173,7 @@ def generate_uuid(
     if final_output_as == "object":
         items = objects
     elif final_output_as == "string":
-        items = ",".join(values)
+        items = "\n".join(values)
     else:
         items = values
 

uuid_kit-2.0.2/uuid_kit/py.typed

@@ -0,0 +1 @@
+

{uuid_kit-2.0.0 → uuid_kit-2.0.2/uuid_kit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uuid-kit
-Version: 2.0.0
+Version: 2.0.2
 Summary: Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options.
 Author: Troy Tessalone
 License: MIT
@@ -8,6 +8,12 @@ Project-URL: Homepage, https://github.com/troytessalone/uuid-kit
 Project-URL: Issues, https://github.com/troytessalone/uuid-kit/issues
 Keywords: uuid,uuidv4,uuidv7,generator,utility,formatting,transform,output
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
@@ -18,7 +24,7 @@ Dynamic: license-file
 
 # uuid-kit
 
-Generate UUID values (v4, v7) with flexible formatting, prefixes, suffixes, and output shape options.
+Generate UUID values (`v4`, `v7`) with flexible formatting, prefixes, suffixes, and output shape options.
 
 ---
 
@@ -168,7 +174,7 @@ Example output:
       "raw": "123e4567-e89b-12d3-a456-426614174001",
       "index": 1,
       "timestamp": {
-        "iso": "2026-04-09T18:00:00Z",
+        "iso": "2026-04-09T18:00:00.001000Z",
         "unix": 1775757600001
       }
     }
@@ -190,7 +196,7 @@ Example output:
   "format": "standard",
   "output_as": "string",
   "count": 3,
-  "items": "uuid-1,uuid-2,uuid-3"
+  "items": "uuid-1\nuuid-2\nuuid-3"
 }
 ```
 
@@ -211,18 +217,18 @@ Each object includes:
 - `uuid` = final formatted value
 - `raw` = original UUID before formatting
 - `index` = zero-based position in the result set
-- `timestamp` = only for v7, derived from the UUID
+- `timestamp` = only included for `v7` when `outputAs="object"`
 
 ### `outputAs="string"`
 
-Returns `items` as a single comma-delimited string.
+Returns `items` as a single newline-delimited string.
 
 ---
 
 ## Supported Versions
 
 - `v4` = random
-- `v7` = modern time-based
+- `v7` = time-based, sortable, recommended
 
 ---
 
@@ -235,6 +241,29 @@ from uuid_kit import ALLOWED_FORMATS, ALLOWED_VERSIONS, ALLOWED_OUTPUT_AS
 
 ---
 
+## Behavior
+
+- Invalid or missing `count` defaults to `1`
+- `count` is capped at `100`
+- `count` is converted to an integer
+- Invalid or missing `version` defaults to `v7`
+- Invalid or missing `format` defaults to `standard`
+- Invalid or missing `outputAs` defaults to `array`
+
+---
+
+## Performance Notes
+
+`uuid-kit` avoids unnecessary work during generation:
+
+- Object records are only built when `outputAs="object"`
+- Timestamps are only extracted for `v7` object output
+- List storage is preallocated for efficient generation
+
+This keeps array and string output paths lighter and faster.
+
+---
+
 ## Environment Notes
 
 Some hosted Python runtimes require you to explicitly add packages before use. In those environments, add:
@@ -246,16 +275,6 @@ uuid6
 
 ---
 
-## Behavior
-
-- Invalid or missing `count` defaults to `1`
-- `count` is capped at `100`
-- Invalid or missing `version` defaults to `v7`
-- Invalid or missing `format` defaults to `standard`
-- Invalid or missing `outputAs` defaults to `array`
-
----
-
 ## Notes
 
 - Python standard library does not yet include native UUID v7 support

{uuid_kit-2.0.0 → uuid_kit-2.0.2}/uuid_kit.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 uuid_kit/__init__.py
 uuid_kit/core.py
+uuid_kit/py.typed
 uuid_kit.egg-info/PKG-INFO
 uuid_kit.egg-info/SOURCES.txt
 uuid_kit.egg-info/dependency_links.txt