https://github.com/alx3dev/randpass
Ruby random password generator
https://github.com/alx3dev/randpass
password-generator ruby ruby-gem
Last synced: 11 months ago
JSON representation
Ruby random password generator
- Host: GitHub
- URL: https://github.com/alx3dev/randpass
- Owner: alx3dev
- License: mit
- Created: 2022-02-20T17:53:10.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-15T17:17:01.000Z (over 3 years ago)
- Last Synced: 2025-06-19T20:53:03.809Z (about 1 year ago)
- Topics: password-generator, ruby, ruby-gem
- Language: Ruby
- Homepage:
- Size: 69.3 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Randpass v0.3.3
Ruby random password generator (not a password manager!).
Generate password and copy in clipboard, or generate list and/or save as `.txt` file.
File is saved as plain text, it is up to end-user to decide how to secure it.
Password is generated with `SecureRandom#base64` and a few (random) special characters `! # * $ % _ @`
## Dependencies
Randpass use _clipboard-gem_, that require `xsel` or `xclip` on Linux systems.
Setup script will check and install `xsel` if nothing is found.
## How to use:
Use from terminal:
When generating a single password, you don't need any argument, or you can add number of password characters (default is 25). By default, password is printed in STDOUT and copied to clipboard, but not saved as file.
- generate password with 25 characters
`randpass`
- generate password with 30 characters
`randpass 30`
`randpass --char 30`
- clear clipboard
`randpass -k`
`randpass --clear`
- add `-c` or `--noc` to disable clipboard copy
`randpass 35 -c`
- add `-p` or `--nop` to disable STDOUT
`randpass 20 -p`
When generating a list of passwords, you need to supply `-n` or `--char` to set number of password characters (default is 25). Passwords will be saved in a current working directory (unless otherwise specified) in format `randpass_#{Time.now.to_i}.txt`. This way we avoid overwrite, and it's possible to get time of file generation with `Time.at TIME_INTEGER`
- generate password list from comments (20 characters long password)
`randpass -n 20 -l GitHub RubyGems AnotherWebSite`
- generate password list with 10 passwords - without comments
`randpass -r 10`
`randpass -n 20 -r 10`
- add `-s` or `--nos` to disable saving list as a file
`randpass -n 20 -r 5 -s`
`randpass -r 10 --nos --noc`
- add `-d` or `--dir` as location to store password list
`randpass -r 10 -d 'my_path/directory'`
## How to install
- install from rubygems
> Randpass require gem `Optimist`, install it with `gem install optimist`
> You need it only when installing from rubygems.
> Future release will remove it
```
gem install randpass && randpass -i
```
- download from github with ssh
```
git clone git@github.com:alx3dev/randpass \
cd randpass && randpass -i
```
- download from github with https
```
git clone https://www.github.com/alx3dev/randpass \
cd randpass && randpass -i
```
Tested on:
- ruby `2.7.5`
- ruby `3.0.3`
- ruby `3.1.0`
- ruby `3.1.3`
- jruby `9.3.2.0`