rword is a golang random word generator.
Can generate words using a saved dict containing over 370_000 words.
Or you can use a custom dictionary.
For more information, see the section "How to use it" below.
You must use golang version 1.21 or higher. 0 dependencies, except for goland stdlib
package main
import (
"fmt"
"github.com/kpechenenko/rword"
)
func main() {
var g rword.GenerateRandom
var err error
// Create a random word generator using saved dict with 370_000+ words.
g, err = rword.New()
if err != nil {
panic(err)
}
// Get a random word.
word := g.Word()
fmt.Println(word)
// Get a list of 10 random words.
words := g.WordList(10)
for _, w := range words {
fmt.Println(w)
}
// Get random string with a length of 10.
s := g.Str(10)
fmt.Println(s)
// Create a random word generator using your dictionary. Dictionary is a text file, 1 line - 1 word.
// Returns an error, if dictionary is empty.
g2, err := rword.NewWithDict("path/to/your/dict")
if err != nil {
panic(err)
}
// Get a random word.
word = g2.Word()
fmt.Println(word)
}Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License.