Compare commits
5 commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
8cb8720b56 | ||
|
|
c5039c1cc6 | ||
|
|
2ff415fb2b | ||
|
|
57396065ce | ||
|
|
78fadcb469 |
5 changed files with 51 additions and 21 deletions
2
.gitignore
vendored
2
.gitignore
vendored
|
|
@ -1,5 +1,3 @@
|
|||
**/uuids
|
||||
|
||||
.vscode/.browse.*
|
||||
nimsuggest.log
|
||||
|
||||
|
|
|
|||
17
README.md
17
README.md
|
|
@ -7,19 +7,28 @@ API:
|
|||
type UUID* = object
|
||||
## 128-bit UUID compliant with RFC-4122
|
||||
|
||||
proc initUUID*(mostSigBits, leastSigBits: int64): UUID =
|
||||
## Initializes UUID with the specified most and least significant bits
|
||||
|
||||
proc leastSigBits*(uuid: UUID): int64 {.inline.}
|
||||
## Returns 64 least significant bits of the ``uuid``
|
||||
|
||||
proc mostSigBits*(uuid: UUID): int64 {.inline.}
|
||||
## Returns 64 most significant bits of the ``uuid``
|
||||
|
||||
proc `$`*(uuid: UUID): string
|
||||
## Returns a string representation of the UUID in canonical form.
|
||||
## Returns a string representation of the ``uuid`` in canonical form.
|
||||
|
||||
proc hash*(uuid: UUID): Hash
|
||||
## Computes hash of the specified UUID.
|
||||
## Computes hash of the specified ``uuid``.
|
||||
|
||||
proc `==`*(x, y: UUID): bool
|
||||
## Returns true when the specified UUIDs are equal, false otherwise.
|
||||
|
||||
proc isZero*(uuid: UUID): bool
|
||||
## Returns ``true`` when the UUID is zero (not set), ``false`` otherwise.
|
||||
## Returns ``true`` when the ``uuid`` is zero (not set), ``false`` otherwise.
|
||||
|
||||
proc genUUID*(): UUID =
|
||||
proc genUUID*(): UUID
|
||||
## Returns a random (v4) UUID.
|
||||
## Uses a thread-local cryptographically secure PRNG (ISAAC) seeded with
|
||||
## true random values obtained from OS.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
import strutils, hashes
|
||||
import isaac
|
||||
import urandom
|
||||
import uuids/urandom
|
||||
|
||||
type
|
||||
UUID* = object
|
||||
|
|
@ -10,16 +10,17 @@ type
|
|||
|
||||
template toHex(s: string, start: Natural,
|
||||
x: BiggestInt, len: Positive) =
|
||||
const HexChars = "0123456789abcdef"
|
||||
const HexChars = ['0', '1', '2', '3', '4', '5', '6', '7', '8',
|
||||
'9', 'a', 'b', 'c', 'd', 'e', 'f']
|
||||
var n = x
|
||||
for j in countdown(len - 1, 0):
|
||||
s[start + j] = HexChars[n and 0xF]
|
||||
s[start + j] = HexChars[int(n and 0xF)]
|
||||
n = n shr 4
|
||||
# handle negative overflow
|
||||
if n == 0 and x < 0: n = -1
|
||||
|
||||
proc uuidsParseHexInt(s: string, maxLen: int): int64 =
|
||||
if s.isNil or s.len == 0:
|
||||
if s.len == 0:
|
||||
raise newException(ValueError, "UUID part is empty")
|
||||
if s.len > maxLen or s.len > sizeof(result) * 2:
|
||||
raise newException(ValueError, "UUID part is longer than expected")
|
||||
|
|
@ -33,8 +34,21 @@ proc uuidsParseHexInt(s: string, maxLen: int): int64 =
|
|||
result = result shl 4 or (ord(c) - ord('A') + 10)
|
||||
else: raise newException(ValueError, "Invalid hex string: " & s)
|
||||
|
||||
proc initUUID*(mostSigBits, leastSigBits: int64): UUID =
|
||||
## Initializes UUID with the specified most and least significant bits
|
||||
result.mostSigBits = mostSigBits
|
||||
result.leastSigBits = leastSigBits
|
||||
|
||||
proc leastSigBits*(uuid: UUID): int64 {.inline.} =
|
||||
## Returns 64 least significant bits of the ``uuid``
|
||||
uuid.leastSigBits
|
||||
|
||||
proc mostSigBits*(uuid: UUID): int64 {.inline.} =
|
||||
## Returns 64 most significant bits of the ``uuid``
|
||||
uuid.mostSigBits
|
||||
|
||||
proc `$`*(uuid: UUID): string =
|
||||
## Returns a string representation of the UUID in canonical form.
|
||||
## Returns a string representation of the ``uuid`` in canonical form.
|
||||
result = newString(36)
|
||||
toHex(result, 0, uuid.mostSigBits shr 32, 8)
|
||||
result[8] = '-'
|
||||
|
|
@ -47,7 +61,7 @@ proc `$`*(uuid: UUID): string =
|
|||
toHex(result, 24, uuid.leastSigBits, 12)
|
||||
|
||||
proc hash*(uuid: UUID): Hash =
|
||||
## Computes hash of the specified UUID.
|
||||
## Computes hash of the specified ``uuid``.
|
||||
result = uuid.mostSigBits.hash() !& uuid.leastSigBits.hash()
|
||||
result = !$result
|
||||
|
||||
|
|
@ -56,7 +70,7 @@ proc `==`*(x, y: UUID): bool =
|
|||
x.mostSigBits == y.mostSigBits and x.leastSigBits == y.leastSigBits
|
||||
|
||||
proc isZero*(uuid: UUID): bool =
|
||||
## Returns ``true`` when the UUID is zero (not set), ``false`` otherwise.
|
||||
## Returns ``true`` when the ``uuid`` is zero (not set), ``false`` otherwise.
|
||||
uuid.mostSigBits == 0'i64 and uuid.leastSigBits == 0'i64
|
||||
|
||||
var rand {.threadvar.}: IsaacGenerator
|
||||
|
|
@ -105,5 +119,15 @@ when isMainModule:
|
|||
assert(uuidStr.len == 36)
|
||||
assert(uuidStr[14] == '4') # version
|
||||
assert(uuidStr[19] in {'8', '9', 'a', 'b'}) # variant (2 bits)
|
||||
assert(uuidStr.parseUUID() == uuid)
|
||||
assert(uuidStr.parseUUID().hash() == uuid.hash())
|
||||
|
||||
let parsedUUID = uuidStr.parseUUID()
|
||||
assert(parsedUUID == uuid)
|
||||
assert(parsedUUID.hash() == uuid.hash())
|
||||
assert(mostSigBits(parsedUUID) == mostSigBits(uuid))
|
||||
assert(leastSigBits(parsedUUID) == leastSigBits(uuid))
|
||||
|
||||
let newUUID = initUUID(mostSigBits(uuid), leastSigBits(uuid))
|
||||
assert(newUUID == uuid)
|
||||
assert(newUUID.hash() == uuid.hash())
|
||||
assert(mostSigBits(newUUID) == mostSigBits(uuid))
|
||||
assert(leastSigBits(newUUID) == leastSigBits(uuid))
|
||||
|
|
@ -1,10 +1,9 @@
|
|||
[Package]
|
||||
name: "uuids"
|
||||
version: "0.1.6"
|
||||
version: "0.1.11"
|
||||
author: "Xored Software, Inc."
|
||||
description: "UUID library"
|
||||
license: "MIT"
|
||||
srcDir: "src"
|
||||
|
||||
[Deps]
|
||||
requires: "isaac >= 0.1.2"
|
||||
requires: "isaac >= 0.1.3"
|
||||
|
|
|
|||
|
|
@ -16,16 +16,16 @@ when defined(windows):
|
|||
proc CryptAcquireContext(
|
||||
phProv: ptr HCRYPTPROV, pszContainer: WideCString,
|
||||
pszProvider: WideCString, dwProvType: DWORD, dwFlags: DWORD
|
||||
): WinBool {.importc: "CryptAcquireContextW".}
|
||||
): WINBOOL {.importc: "CryptAcquireContextW".}
|
||||
else:
|
||||
proc CryptAcquireContext(
|
||||
phProv: ptr HCRYPTPROV, pszContainer: cstring, pszProvider: cstring,
|
||||
dwProvType: DWORD, dwFlags: DWORD
|
||||
): WinBool {.importc: "CryptAcquireContextA".}
|
||||
): WINBOOL {.importc: "CryptAcquireContextA".}
|
||||
|
||||
proc CryptGenRandom(
|
||||
hProv: HCRYPTPROV, dwLen: DWORD, pbBuffer: pointer
|
||||
): WinBool {.importc: "CryptGenRandom".}
|
||||
): WINBOOL {.importc: "CryptGenRandom".}
|
||||
|
||||
{.pop.}
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue