Metadata-Version: 2.1
Name: scru160
Version: 0.2.3
Summary: SCRU160: Sortable, Clock and Random number-based Unique identifier
Home-page: https://github.com/scru160/python
License: Apache-2.0
Keywords: identifier,uuid,guid,ulid,ksuid
Author: LiosK
Author-email: contact@mail.liosk.net
Requires-Python: >=3.7.12,<4.0.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown

# SCRU160: Sortable, Clock and Random number-based Unique identifier

SCRU160 ID is yet another attempt to supersede [UUID] in the use cases that need
decentralized, globally unique time-ordered identifiers. SCRU160 is inspired by
[ULID] and [KSUID] and has the following features:

- 160-bit feature-rich worry-free design suitable for general purposes
- Sortable by generation time (in binary and in text)
- Case-insensitive, highly portable encodings: 32-char base32hex and 40-char hex
- More than 32,000 unique, time-ordered but unpredictable IDs per millisecond
- Nearly 111-bit randomness for collision resistance

```python
from scru160 import scru160, scru160f

print(scru160())  # e.g. "05TVFQQ8UGDNKHDJ79AEGPHU7QP7996H"
print(scru160())  # e.g. "05TVFQQ8UGDNNVCCNUH0Q8JDD3IPHB8R"

print(scru160f())  # e.g. "017bf7eb48f41b7d6bd295bc5adc43436bc969df"
print(scru160f())  # e.g. "017bf7eb48f41b7e1bc98aec348dfa1539b41288"
```

See [the specification] for further details.

[uuid]: https://en.wikipedia.org/wiki/Universally_unique_identifier
[ulid]: https://github.com/ulid/spec
[ksuid]: https://github.com/segmentio/ksuid
[the specification]: https://github.com/scru160/spec

## Command-line interface

`scru160` generates SCRU160 IDs.

```bash
$ scru160
05U0G9S45SUOL4C8FNQFKQ5M6VEROV9J
$ scru160 -f
017c08279e9f4e32b6f58d023b9fc41a22302750
$ scru160 -n 4
05U0G9TQQ8FONQQCC655GMBTBBHUIKK7
05U0G9TQQ8FOOJ7IR79Q6QFJ3OSNRF92
05U0G9TQQ8FORTQU0K5OOSANILGP72HO
05U0G9TQQ8FOTV6SEJVMV6OJQDP15MHC
```

`scru160-inspect` prints the components of given SCRU160 IDs as human- and
machine-readable JSON objects.

```bash
$ scru160 -fn 2 | scru160-inspect
{
  "input":        "017c083c130732153679e83c4fc65664e6a964a1",
  "canonical":    "05U0GF0J0SP1ADJPT0U4VHIMCJJAIP51",
  "timestamputc": "2021-09-21 12:02:07.239+00:00",
  "timestamp":    "1632225727239",
  "counter":      "12821",
  "random16":     "13945",
  "random80":     "1096701577047146014270625",
  "hexfields":    ["017c083c1307", "3215", "3679", "e83c4fc65664e6a964a1"]
}
{
  "input":        "017c083c13073216a2ab5d302cebfca0916625a0",
  "canonical":    "05U0GF0J0SP1D8LBBKO2PQVSK28MC9D0",
  "timestamputc": "2021-09-21 12:02:07.239+00:00",
  "timestamp":    "1632225727239",
  "counter":      "12822",
  "random16":     "41643",
  "random80":     "440068763580938823542176",
  "hexfields":    ["017c083c1307", "3216", "a2ab", "5d302cebfca0916625a0"]
}
```

## 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.

