kanru/uuidgen-el

UUID generation implemented in elisp.

uuidgen-el

This is a naive implementation of RFC4122 Universally Unique IDentifier generation in elisp. Currently implemented are UUID v1 v3, v4 and v5 generation. The resolution of the time based UUID is microseconds, which is 10 times of the suggested 100-nanosecond resolution, but should be enough for general usage.

APIs

• Function uuidgen-1

  Generate time based UUID string, aka UUIDv1.

• Function uuidgen-4

  Generate UUID string form random numbers, aka UUIDv4.

• Function uuidgen-3 (ns name)

  Generate name based UUID string using MD5 hash algorithm, aka UUIDv3. NS should be a generated UUID or predefined namespaces, uuidgen-ns-dns, uuidgen-ns-url, uuidgen-ns-oid, uuidgen-ns-x500. NAME is the node name string.

• Function uuidgen-5 (ns name)

  Generate name based UUID string using SHA-1 hash algorithm, aka UUIDv5. NS should be a generated UUID or predefined namespaces, uuidgen-ns-dns, uuidgen-ns-url, uuidgen-ns-oid, uuidgen-ns-x500. NAME is the node name string.

• Function uuidgen-urn (uuid)

  Return the string representation of a UUID as a URN.

• Function uuidgen-cid (&optional uuid)

  Return UUID string in CID format that is suitable for COM definition. If UUID is nil will generate UUID-4 automatically. You customize uuidgen-cid-format-string to change the default format.

• Command insert-uuid-cid (uuid)

  Insert UUID string in CID format that is suitable for COM definition. If UUID is nil will generate UUIDv4 automatically. You customize uuidgen-cid-format-string to change the default format.

• Command uuidgen (time-based)

  Insert UUIDv4 at point. If TIME-BASED is non-nil, insert UUIDv1 instead.

uuidgen-el's Issues

Implement RFC 9562

New version of UUID just dropped.

https://www.rfc-editor.org/rfc/rfc9562.html

• UUIDv6
• UUIDv7
• UUIDv8

Take advantage of the new time-convert function introduced in Emacs 27.1

The (current-time) and the (time-convert) functions might be able to return sub nanoseconds time now.
It looks like it's now possible to implement standard compliant UUIDv1 support.

string-as-unibyte is obsolete since 26.1

In uuidgen-3:
uuidgen.el:307:50:Warning: ‘string-as-unibyte’ is an obsolete function (as of
    26.1); use ‘encode-coding-string’.

In uuidgen-5:
uuidgen.el:315:51:Warning: ‘string-as-unibyte’ is an obsolete function (as of
    26.1); use ‘encode-coding-string’.

encode-coding-string is probably introduced at or before Emacs version 20.3, so we should be able to just replace string-as-unibyte.

Native bignum support, math-fixnum was removed from Emacs 27

Calling uuidgen with the current Emacs snapshot produces:

condition-case: Symbol’s function definition is void: math-fixnum

GNU Emacs 27.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.8) of 2019-12-23

See emacs-mirror/emacs@1bc1672#diff-81e14a18908dd0a9d22d43ed8109ee8e . I'm not really familiar with Elisp, so I can't say whether any other changes could have impacted this package.