SCRU128: Sortable, Clock and Random number-based Unique identifier
Project description
SCRU128: Sortable, Clock and Random number-based Unique identifier
SCRU128 ID is yet another attempt to supersede UUID in the use cases that need decentralized, globally unique time-ordered identifiers. SCRU128 is inspired by ULID and KSUID and has the following features:
- 128-bit unsigned integer type
- Sortable by generation time (as integer and as text)
- 26-digit case-insensitive portable textual representation
- 44-bit biased millisecond timestamp that ensures remaining life of 550 years
- Up to 268 million time-ordered but unpredictable unique IDs per millisecond
- 84-bit layered randomness for collision resistance
from scru128 import scru128
print(scru128()) # e.g. "00PGHAJ3Q9VAJ7IU6PQBHBUAK4"
print(scru128()) # e.g. "00PGHAJ3Q9VAJ7KU6PQ92NVBTV"
See SCRU128 Specification for details.
Command-line interface
scru128
generates SCRU128 IDs.
$ scru128
00PP7O1FIQFM7C7R8VBK61T94N
$ scru128 -n 4
00PP7OKSN7T37CR12PEIJILTA1
00PP7OKSN7T37CT12PEJKN2BNO
00PP7OKSN7T37CV12PEH41TP72
00PP7OKSN7T37D112PEI1L0HMS
scru128-inspect
prints the components of given SCRU128 IDs as human- and
machine-readable JSON objects.
$ scru128 -n 2 | scru128-inspect
{
"input": "00PP7OUAC22A7TO4VESB1R83L5",
"canonical": "00PP7OUAC22A7TO4VESB1R83L5",
"timestampIso": "2021-10-02T23:38:47.832+00:00",
"timestamp": "55381127832",
"counter": "34770908",
"perSecRandom": "1306338",
"perGenRandom": "3283357349",
"fieldsHex": ["00ce4f8f298", "2128fdc", "13eee2", "c3b40ea5"]
}
{
"input": "00PP7OUAC22A7TQ4VES9SKQH9U",
"canonical": "00PP7OUAC22A7TQ4VES9SKQH9U",
"timestampIso": "2021-10-02T23:38:47.832+00:00",
"timestamp": "55381127832",
"counter": "34770909",
"perSecRandom": "1306338",
"perGenRandom": "2035107134",
"fieldsHex": ["00ce4f8f298", "2128fdd", "13eee2", "794d453e"]
}
License
Copyright 2021 LiosK
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
See also
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.