Feature/empty value (#2)

* replaced 'empty string' in uuid3/5 namespace menu with ''

* edit readme

* poetry update

README-public.md

@@ -2,11 +2,7 @@
 
 Create universally unique identifiers (UUIDs) versions 1, 3, 4, 5, 6, 7 and 8 in transformations.
 
-## Installation
-
-```
-cmemc admin workspace python install cmem-plugin-uuid
-```
+[![eccenca Corporate Memory](https://img.shields.io/badge/eccenca-Corporate%20Memory-orange)](https://documentation.eccenca.com) [![workflow](https://github.com/eccenca/cmem-plugin-uuid/actions/workflows/check.yml/badge.svg)](https://github.com/eccenca/cmem-plugin-uuid/actions) [![pypi version](https://img.shields.io/pypi/v/cmem-plugin-uuid)](https://pypi.org/project/uuid) [![license](https://img.shields.io/pypi/l/cmem-plugin-uuid)](https://pypi.org/project/cmem-plugin-uuid)
 
 ## UUID1
 
@@ -42,24 +38,29 @@ UUID version 3 is a reproducible UUID based on the MD5 hash of a namespace ident
 
 #### Namespace
 
-The namespace UUID can be selected from the namespace UUIDs defined in
+The namespace can be entered manually or selected from the namespace UUIDs defined in
 [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122):
 
 - Namespace DNS: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 (*namespace_dns*)
 - Namespace URL: 6ba7b811-9dad-11d1-80b4-00c04fd430c8 (*namespace_url*)
 - Namespace OID: 6ba7b812-9dad-11d1-80b4-00c04fd430c8 (*namespace_oid*)
 - Namespace X500: 6ba7b814-9dad-11d1-80b4-00c04fd430c8 (*namespace_x500*)
-- Empty value: only the name value is used (*empty_value*)
 
 If none of the predefined namespace UUIDs is selected, the input namespace is either directly
-interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_). When selecting _Empty Value_ for
-the namespace, the output is the same as that of the standard CMEM UUID operator with input value.
+interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_). If no namespace is given,
+the output is the same as that of the standard CMEM UUID operator with input value.
 
 
 
-Default value: _Empty value_  
+Default value: _none_  
 ID: `namespace`
 
+#### Use input as namespace
+
+If enabled, the input value is used for the namespace.
+
+Default value: _False_  
+ID: `input_as_namespace`
 
 #### Namespace as UUID
 
@@ -89,21 +90,18 @@ name (which is a string).
 
 #### Namespace
 
-The namespace UUID can be selected from the namespace UUIDs defined in
+The namespace can be entered manually or selected from the namespace UUIDs defined in
 [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122):
 
 - Namespace DNS: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 (*namespace_dns*)
 - Namespace URL: 6ba7b811-9dad-11d1-80b4-00c04fd430c8 (*namespace_url*)
 - Namespace OID: 6ba7b812-9dad-11d1-80b4-00c04fd430c8 (*namespace_oid*)
 - Namespace X500: 6ba7b814-9dad-11d1-80b4-00c04fd430c8 (*namespace_x500*)
-- Empty value: only the name value is used (*empty_value*)
 
 If none of the predefined namespace UUIDs is selected, the input namespace is either directly
 interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_).
 
-If the parameter is empty, the input is used.
-
-Default value: _Empty value_  
+Default value: _none_  
 ID: `namespace`
 
 
@@ -178,7 +176,7 @@ Outputs the UUID version from a UUID input string.
 ## UUID Convert
 
 Convert a UUID from one format to another. The plugin accepts strings in the correct format, however, the log will show
-a warning if it does not comply with the standard specified in [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122) and the 
+a warning if the input does not comply with the standard specified in [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122) and the 
 [proposed updates](https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-01.html).
 
 ### Parameters
@@ -202,8 +200,6 @@ Options:
 Default value: _UUID/32-character lowercase hexadecimal string_   
 ID: `from_format`
 
-  The UUID as a 16-byte string (containing the six integer fields in big-endian byte order).
-- **16-byte string (little-endian)** (_bytes_le_)
 
 #### To
 

README.md

@@ -38,22 +38,21 @@ UUID version 3 is a reproducible UUID based on the MD5 hash of a namespace ident
 
 #### Namespace
 
-The namespace UUID can be selected from the namespace UUIDs defined in
+The namespace can be entered manually or selected from the namespace UUIDs defined in
 [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122):
 
 - Namespace DNS: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 (*namespace_dns*)
 - Namespace URL: 6ba7b811-9dad-11d1-80b4-00c04fd430c8 (*namespace_url*)
 - Namespace OID: 6ba7b812-9dad-11d1-80b4-00c04fd430c8 (*namespace_oid*)
 - Namespace X500: 6ba7b814-9dad-11d1-80b4-00c04fd430c8 (*namespace_x500*)
-- Empty value: only the name value is used (*empty_value*)
 
 If none of the predefined namespace UUIDs is selected, the input namespace is either directly
-interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_). When selecting _Empty Value_ for
-the namespace, the output is the same as that of the standard CMEM UUID operator with input value.
+interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_). If no namespace is given,
+the output is the same as that of the standard CMEM UUID operator with input value.
 
 
 
-Default value: _Empty value_  
+Default value: _none_  
 ID: `namespace`
 
 #### Use input as namespace
@@ -91,21 +90,18 @@ name (which is a string).
 
 #### Namespace
 
-The namespace UUID can be selected from the namespace UUIDs defined in
+The namespace can be entered manually or selected from the namespace UUIDs defined in
 [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122):
 
 - Namespace DNS: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 (*namespace_dns*)
 - Namespace URL: 6ba7b811-9dad-11d1-80b4-00c04fd430c8 (*namespace_url*)
 - Namespace OID: 6ba7b812-9dad-11d1-80b4-00c04fd430c8 (*namespace_oid*)
 - Namespace X500: 6ba7b814-9dad-11d1-80b4-00c04fd430c8 (*namespace_x500*)
-- Empty value: only the name value is used (*empty_value*)
 
 If none of the predefined namespace UUIDs is selected, the input namespace is either directly
 interpreted as a UUID, or used to derive a UUID (see parameter _Namespace as UUID_).
 
-If the parameter is empty, the input is used.
-
-Default value: _Empty value_  
+Default value: _none_  
 ID: `namespace`
 
 

cmem_plugin_uuid/transform/__init__.py

@@ -86,7 +86,7 @@ def transform(self, inputs: Sequence[Sequence[str]]) -> Sequence[str]:
             name="namespace",
             label="Namespace",
             description="The namespace.",
-            default_value="empty_value",
+            default_value="",
         ),
         PluginParameter(
             param_type=BoolParameterType(),
@@ -125,7 +125,7 @@ def transform(self, inputs: Sequence[Sequence[str]]) -> Sequence[str]:
         if len(inputs) != 0:
             for collection in inputs:
                 for _ in collection:
-                    if self.namespace == "empty_value":
+                    if not self.namespace.strip():
                         result += [str(uuid.UUID(hex=namespace_hex(_, 3), version=3))]
                     else:
                         result += [str(uuid.uuid3(namespace_uuid, _))]  # type: ignore[arg-type]
@@ -166,7 +166,7 @@ def transform(self, inputs: Sequence[Sequence[str]]) -> Sequence[str]:
             name="namespace",
             label="Namespace",
             description="If 'namespace' is not given, the input string is used.",
-            default_value="empty_value",
+            default_value="",
         ),
         PluginParameter(
             param_type=BoolParameterType(),
@@ -205,7 +205,7 @@ def transform(self, inputs: Sequence[Sequence[str]]) -> Sequence[str]:
         if len(inputs) != 0:
             for collection in inputs:
                 for _ in collection:
-                    if self.namespace == "empty_value":
+                    if not self.namespace.strip():
                         result += [str(uuid.UUID(hex=namespace_hex(_, 5), version=5))]
                     else:
                         result += [str(uuid.uuid5(namespace_uuid, _))]  # type: ignore[arg-type]

cmem_plugin_uuid/utils.py

@@ -14,7 +14,7 @@
             "namespace_dns": "Namespace DNS",
             "namespace_oid": "Namespace OID",
             "namespace_x500": "Namespace X500",
-            "empty_value": "Empty value",
+            "": "",
         }
     ),
 )
@@ -93,7 +93,7 @@ def get_namespace_uuid(
         namespace_uuid = uuid.NAMESPACE_OID
     elif namespace == "namespace_x500":
         namespace_uuid = uuid.NAMESPACE_X500
-    elif namespace != "empty_value":
+    elif namespace.strip():
         if namespace_as_uuid:
             namespace_uuid = uuid.UUID(namespace)
         else: