https://github.com/damdo/randid

:1234::abcd: crypto-secure random ids generation lib for Go
https://github.com/damdo/randid

go golang ids random uid

Last synced: about 9 hours ago
JSON representation

:1234::abcd: crypto-secure random ids generation lib for Go

• Host: GitHub
• URL: https://github.com/damdo/randid
• Owner: damdo
• License: mit
• Created: 2018-04-13T13:36:03.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-02-05T21:09:29.000Z (almost 3 years ago)
• Last Synced: 2024-11-12T14:32:13.012Z (2 months ago)
• Topics: go, golang, ids, random, uid
• Language: Go
• Homepage:
• Size: 11.7 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## randid

[![GoDoc](http://godoc.org/github.com/damdo/randid?status.svg)](http://godoc.org/github.com/damdo/randid) 

[![Build Status](https://travis-ci.org/damdo/randid.svg?branch=master)](https://travis-ci.org/damdo/randid)

[![Coverage Status](https://coveralls.io/repos/github/damdo/randid/badge.svg?branch=master)](https://coveralls.io/github/damdo/randid?branch=master)

**generate** (crypto-secure) **random** (alphanumeric string) **ids** - in Go

### FEATURES:

- **secure** :lock: crypto random ids thanks to `crypto/rand`

- **fast** :zap:

- both fixed and arbitrary long generation methods

- **tested** :white_check_mark:

- **dependency-less**

### USAGE:

download the package

```sh

go get github.com/damdo/randid

```

import and use the package

```go

import (

  "fmt"

  "github.com/damdo/randid"

)

func foo(){

    // generate a default len (32 char) id

    your32CharLongID, err := randid.ID()

    // -> 26e99c11f0a31ec57924c8e2a0712cd3

    if err != nil {

      fmt.Println(err)

    }

    // or

    desiredLen := 64

    your64CharLongID, err := randid.SizedID(desiredLen)

    // -> 6cc77090ff64c232613574bb562510f78d88a84e8351f3a68ac1caa902750bb7

    if err != nil {

      fmt.Println(err)

    }

    // change randid default len

    // every id generated from now on with .ID() will be 33 char long

    randid.DefaultLen = 33

    your33CharLongID, err := randid.ID()

    // -> 091015d5146b6d2e3f77ff50d805cee50

    if err != nil {

      fmt.Println(err)

    }

}

```

### CREDITS:

Credits goes to https://github.com/moby/moby/blob/master/pkg/stringid 


upon which this mini package is heavily based.

### LICENSE:

The MIT License (MIT) - see [`LICENSE.md`](https://github.com/damdo/randid/blob/master/LICENSE) for more details