🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more
Socket
DemoInstallSign in
Socket

Nanoid

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

Nanoid

A tiny, secure, URL-friendly, unique string ID generator for .NET Core.

3.1.0
Source
NuGet
Version published
Maintainers
1
Created
Source

nanoid-net

Build Status Build status NuGet Badge License

This package is .NET implementation of ai's nanoid!

Safe. It uses thread safe cryptographically strong random generator by default.

Compact. It uses more symbols than UUID (A-Za-z0-9_-) and has the same number of unique options in just 22 symbols instead of 36.

Fast. Nanoid is as fast as UUID but can be used in URLs.

Install

Install with nuget:

PM> Install-Package Nanoid

Usage

Normal

The default method uses URL-friendly symbols (A-Za-z0-9_-) and returns an ID with 21 characters (to have a collision probability similar to UUID v4).

var id = Nanoid.Generate(); //=> "Uakgb_J5m9g-0JDMbcJqLJ"

Symbols -,.() are not encoded in the URL. If used at the end of a link they could be identified as a punctuation symbol.

If you want to reduce ID length (and increase collisions probability), you can pass the size as an argument:

var id = Nanoid.Generate(size: 10); //=> "IRFa-VaY2b"

Custom Alphabet or Length

If you want to change the ID's alphabet or length you can pass alphabet and size.

var id1 = Nanoid.Generate(Nanoid.Alphabets.LowercaseLettersAndDigits, 10); //=> "4f90d13a42"
var id2 = Nanoid.Generate("1234567890abcdef", 5); //=> "2x501"

You can find a variety of useful alphabets typically used for Nanoid generation in Nanoid.Alphabets.

To reason about the collision probabilities of a particular alphabet and id length combination, use the nanoid collision calculator.

Random Bytes Generator and Thread Safety

By default, we use an internal global ThreadStatic wrapper over System.Security.Cryptography.RandomNumberGenerator to generate Nanoids in a cryptographically secure manner.

The ThreadStatic attribute ensures that you can safely generate ids across threads without having to pass in your own Random object, by creating a separate instance of our random number generator per thread. This method also avoids the need for any locks which ensures the id generation is fast as advertised.

You can replace the default safe random generator using the System.Random class. For instance, to use a seed-based generator you can do this:

var random = Random(10);
var id = Nanoid.Generate(random, Nanoid.Alphabets.Letters, 10) //=> "fbAeFaaDeb"

If you want to use your own global random number generator, make sure you are aware of the thread safety implications.

Also note that the global random number generator is lazily initialized on first usage. If you need to preload it you can call the Nanoid.GlobalRandom getter to force the initialization to happen at that moment on the current thread.

Credits

  • ai - nanoid

License

The MIT License (MIT). Please see License File for more information.

Keywords

Nanoid

FAQs

Package last updated on 22 Jun 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts