Project

sonic_pass

0.0
The project is in a healthy, maintained state
Generate strong passwords quickly and easily.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Ruby version RubyGem version RubyGem download Rubocop Test

Table of Contents

  • Overview
  • Installation
  • Usage
  • Contributing
  • License

Overview

Sonic Pass is a Ruby gem designed to generate strong, unique passwords. It provides a simple and efficient way to create passwords of varying lengths, making it an ideal tool for developers and users alike.

Installation

To install the Sonic Pass gem, run the following command in your terminal:

gem install sonic_pass

Alternatively, you can add the following line to your Gemfile:

gem 'sonic_pass'

Then, run bundle install to install the gem.

Usage

To use the Sonic Pass gem, simply require it in your Ruby file:

require 'sonic_pass'

You can then generate a password using the SonicPass.generate method:

# Default `length = 12`
password = SonicPass.generate # equals `SonicPass.generate(12)`
puts password

# cpzmh3OV\",C7

Or you can generate multiple passwords, using count > 1 params

passwords = SonicPass.generate(12, 5)
puts passwords

# ,Y36.9H-XqS;
# vRzCyIq.=$W5
# 1}-'D*'ya$Vg
# %66db&y$rjhU
# x';2I7y$<&5f

How to use CLI command sonic_pass

  • Put executable path into PATH directly
gem_bin_path=$(gem env | grep "EXECUTABLE DIRECTORY" | awk -F ': ' '{print $2}')
export PATH="$PATH:$gem_bin_path"
  • Put executable path into PATH in the appropriate configuration file

Assume executable path is: /home/user/.asdf/installs/ruby/3.0.0/bin

For bash (usually ~/.bashrc or ~/.bash_profile):

echo 'export PATH="$PATH:/home/user/.asdf/installs/ruby/3.0.0/bin"' >> ~/.bashrc
source ~/.bashrc

For zsh (usually ~/.zshrc):

echo 'export PATH="$PATH:/home/user/.asdf/installs/ruby/3.0.0/bin"' >> ~/.zshrc
source ~/.zshrc

Verify the change: After updating your configuration file, you can check if the new path has been added by running:

echo $PATH

Finally, run CLI command:

$ sonic_pass

# Password: mM>]3ERLlD5L copied to clipboard

Contributing

Contributions to the Sonic Pass gem are welcome. To contribute, please fork the repository and submit a pull request with your changes.

License

The Sonic Pass gem is released under the MIT License. See the LICENSE file for details.