Crystal implementation of original NanoID
Add this to your application's shard.yml:
dependencies:
nanoid:
github: mamantoha/nanoid.crrequire "nanoid"Nanoid.generate uses URL-friendly symbols (A-Za-z0-9_-) and returns an ID with 21 characters.
Nanoid.generate
# => 3gFI8yZxcfXsXGhB0036lIf you want to reduce ID length (and increase collisions probability), you can pass the length as an argument.
Nanoid.generate(size: 8, alphabet: "1234567890abcdef")
# => 86984b57Non-secure API is also available.
Nanoid.generate(secure: false)
# => no0MmiInNcBm9jR2_3sGt
Nanoid.generate(size: 10, alphabet: "1234567890abcdef", secure: false)
# => 2793b2351ccrystal run --release bench/benchmark.cr
Crystal 1.10.0 (2023-10-09)
LLVM: 15.0.7
Default target: aarch64-apple-darwin23.0.0
Nanoid.simple_generate(21) 3.93 (254.56ms) (± 0.67%) 76.4MB/op 3.38× slower
Nanoid.complex_generate(21) 3.35 (298.92ms) (± 0.93%) 91.7MB/op 3.97× slower
Nanoid.non_secure_generate(21) 13.27 ( 75.37ms) (± 7.77%) 45.9MB/op fastest
UUID v4 3.74 (267.40ms) (± 1.04%) 168MB/op 3.55× slower
Nanoid.simple_generate(36) 3.48 (286.96ms) (± 0.70%) 107MB/op 2.32× slower
Nanoid.complex_generate(36) 2.95 (339.27ms) (± 0.61%) 122MB/op 2.75× slower
Nanoid.non_secure_generate(36) 8.10 (123.45ms) (± 1.24%) 61.1MB/op fastest
UUID v4 3.75 (266.92ms) (± 1.30%) 168MB/op 2.16× slowerClone this repository and install dependencies:
shards installRun tests:
crystal spec- Fork it (https://github.com/mamantoha/nanoid.cr/fork)
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
- mamantoha Anton Maminov - creator, maintainer
Copyright: 2018-2023 Anton Maminov (anton.maminov@gmail.com)
This library is distributed under the MIT license. Please see the LICENSE file.