sonic_pass 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +56 -20
  3. data/lib/sonic_pass/version.rb +1 -1
  4. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 03e54fe57c1ce55e0e03cdbbb986680c0fc268a7c31196c84dbc57e38f31f1da
4
- data.tar.gz: c3675027fbb267f6427b3161803b677d93402b53b5f56e1c2eb4e1a75f6dc222
3
+ metadata.gz: 03e4a2e45c294c05b0f9a731d4b1ea486a682b48ccf88bee3704bd173852980c
4
+ data.tar.gz: a584318ca8872d323452cdb483951aa6476fb29b9ddfd15290855fe69ea2763d
5
5
  SHA512:
6
- metadata.gz: de2fc1041e31b1a6ad9f4fb543cf4c3278b2630ff2afaacc75bf60dbe924b91c73d270c2adefda26846d68349531b7796eed43d4c717fb8b255fc34400e7d951
7
- data.tar.gz: a0c0b8e32b09d15a821decf3bdf488febaaf5db2a78f3cd0a757e59274956b966640b9a7e11a072f14b691b98c88904d6e88a855d1838bdd64b0001cb57eac1b
6
+ metadata.gz: 4dacbdd5965f0ff8c1058910094392eb38a021c8d52b8da3aed02f24fba1c149628c70314650f31d762e20587df71373a80ce65f3b12751499b8b3d74c8fd2ee
7
+ data.tar.gz: 399abfa3c530b420ad42823c6a7ac5a3460c371fe147a441062465333b9816e9013ef294671efa899b52a65fb5f537f46d5a7c9fb05ec9fccc1929a5f68c4927
data/README.md CHANGED
@@ -1,39 +1,75 @@
1
- # SonicPass
1
+ Table of Contents
2
+ -----------------
2
3
 
3
- TODO: Delete this and the text below, and describe your gem
4
+ * [Overview](#overview)
5
+ * [Installation](#installation)
6
+ * [Usage](#usage)
7
+ * [Configuration](#configuration)
8
+ * [Methods](#methods)
9
+ * [Contributing](#contributing)
10
+ * [License](#license)
4
11
 
5
- Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/sonic_pass`. To experiment with that code, run `bin/console` for an interactive prompt.
12
+ ### Overview
6
13
 
7
- ## Installation
14
+ 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.
8
15
 
9
- TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
16
+ ### Installation
10
17
 
11
- Install the gem and add to the application's Gemfile by executing:
18
+ To install the Sonic Pass gem, run the following command in your terminal:
12
19
 
13
- $ bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
20
+ ```bash
21
+ gem install sonic_pass
22
+ ```
14
23
 
15
- If bundler is not being used to manage dependencies, install the gem by executing:
24
+ Alternatively, you can add the following line to your Gemfile:
16
25
 
17
- $ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
26
+ ```ruby
27
+ gem 'sonic_pass'
28
+ ```
18
29
 
19
- ## Usage
30
+ Then, run `bundle install` to install the gem.
20
31
 
21
- TODO: Write usage instructions here
32
+ ### Usage
22
33
 
23
- ## Development
34
+ To use the Sonic Pass gem, simply require it in your Ruby file:
24
35
 
25
- After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
36
+ ```ruby
37
+ require 'sonic_pass'
38
+ ```
26
39
 
27
- To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
40
+ You can then generate a password using the `SonicPass.generate` method:
28
41
 
29
- ## Contributing
42
+ ```ruby
43
+ password = SonicPass.generate(length: 12)
44
+ puts password
45
+ ```
30
46
 
31
- Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/sonic_pass. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/sonic_pass/blob/master/CODE_OF_CONDUCT.md).
47
+ This will output a strong password of the specified length.
32
48
 
33
- ## License
49
+ ### Configuration
34
50
 
35
- The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
51
+ The Sonic Pass gem can be configured to use different character sets for password generation. The available character sets are:
36
52
 
37
- ## Code of Conduct
53
+ * `ALPHANUMERIC_CHARSETS`: A combination of uppercase letters, lowercase letters, and digits.
54
+ * `SPECIAL_CHARSETS`: A set of special characters.
38
55
 
39
- Everyone interacting in the SonicPass project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/sonic_pass/blob/master/CODE_OF_CONDUCT.md).
56
+ You can specify the character set to use when generating a password:
57
+
58
+ ```ruby
59
+ password = SonicPass.generate(length: 12, charset: SonicPass::ALPHANUMERIC_CHARSETS)
60
+ puts password
61
+ ```
62
+
63
+ ### Methods
64
+
65
+ The Sonic Pass gem provides the following methods:
66
+
67
+ * `SonicPass.generate(length: 12, charset: SonicPass::ALPHANUMERIC_CHARSETS)`: Generates a strong password of the specified length using the specified character set.
68
+
69
+ ### Contributing
70
+
71
+ Contributions to the Sonic Pass gem are welcome. To contribute, please fork the repository and submit a pull request with your changes.
72
+
73
+ ### License
74
+
75
+ The Sonic Pass gem is released under the MIT License. See the LICENSE file for details.
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module SonicPass
4
- VERSION = '0.2.0'
4
+ VERSION = '0.2.1'
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: sonic_pass
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - papakvy