pwgator

pwgator - Golang package and application for humanized passwords and passphrases generation. Inspired by great pwgen.

TOC

• Features
• Version
• Install
• Usage
• Algorithm
• Examples

Features

• Random passwords and passphrases generation. It can be done in humanized and strong (fully random with all special symbols) modes.

• Default pasword length is 8 symbols (without LENGTH argument). Default passphrase's template is 2 words.

• Default generation mode is humanized.

• Passphrase generation with template or random. Templates available: 2 words, 3 words, 4 words. Random (by given words number) generated passphrase have random length in characters.

• 100 concurrently generated passwords or passphrases by one app call.

• Some leet-codes is used for random replace of some characters:

  Character	Replace
  a	@, *
  e	3
  s	$, 5, 2
  o	0
  t	7
  f	4
  i	!, 1
  b	8, 6
  g	9

Version

v1.0.0

Install

As application

Get current build at release page.

Or run

wget https://github.com/hIMEI29A/pwgator/releases/download/\
v0.1.3/pwgator-0.1.3-amd64.deb && sudo dpkg -i pwgator-0.1.3-amd64.deb

Or, if you have Golang installed,

go get github.com/hIMEI29A/pwgator

go install github.com/hIMEI29A/pwgator

To get source code and run tests, do:

git clone github.com/hIMEI29A/pwgator.git

cd pwgator

go test

As package

go get github.com/hIMEI29A/pwgator

Usage

Call pwgator with -h or --help option to get full usage instruction.

$ pwgator -h

pwgator - humanized passphrases generator.

Usage:
  pwgator [-h | --help] | [--version]
  pwgator [LENGTH] [-s | --strong] [-p | --phrase]

Arguments:
  LENGTH               Secret's length (OPTIONAL). Default is 8 for word, 2 for phrase.

Options:
  -h --help            Show this screen.
  --version            Show version.
  -s --strong          Non-humanized generation.
  -p --phrase          Generate passphrases (with random template).
  -r                   Generate random passphrases.

Generation of default humanized passwords:

pwgator

Generation of default humanized passphrases:

pwgator -p

Passwords with length = 10:

pwgator 10

Length = 10, strong generation:

pwgator 10 -s

Passphrases with 4 words length and in strong mode:

pwgator 4 -p -s

To use pwgator as package in your applications, write something like this:

package main

import (
	"fmt"
	
	"github.com/hIMEI29A/pwgator"
)	
	func main() {
		length := 8
		
		// False
		phrases := 0
		
		strong := true

        random := false
		
		// Generate new pwgator with "phrases" boolean option, 
		//int length and "strong" boolean option
		g := pwgator.NewGenerator(phrases, length, strong, random)
		g.Generate()

		fmt.Println(g.String())
	}

Output examples

Passwords:

humanized

Fo5h!po
mH*nGon

aWAvew39i
DadUMHIyQ
UqUh*D0o*

!*kE!YVZ
o1tZ@*Po
rUieIo@o
	
MHuQUitUNo*XeimH
ieavpFcl@gq!tA@9

strong

Lul]M\<
rW3xW|&

i<qbtHf
HX9hr5eO
;4&wvkj)
	
mp.G*6"ZL\\PFo]|z
j{RzI]q~G>Q6i^s^=:
.(Gt^R*wR?k^8`o}+&

Passphrases:

humanized

WiCHad eQeq1$
M8aVK@ eja*a

*5a e1mHI NUdUm
R16 y3pee Dz0Od

strong

mM47d| q{5Ls
_+Of!% &V1c&