randpass 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9a815400cfb4c02a5d4fa1f8b1ff46f1b09d37233e03aa4972d040b11dbaf29c
+  data.tar.gz: 755cb66daeb5b6e9fe899daa0e79fe4dd2cd532fbdb919d24b5d66451387b673
+SHA512:
+  metadata.gz: cd1fb7172ac42c415ab542655b0171a8d610d20e215034f78777e9237a3d3d88161aa8b42f4a9f4c52515853e0c65cf839663d44b10ef9ff8b78b1ff7fe68810
+  data.tar.gz: 9dfdd7b36a6dde71d99bc044c74d23628c1adbf88a6fe5171001c0842486d817da53490a5ffd3162cdf105e03a449f4432b96ce0ed46103e7e77df1d2e344499

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 alx3dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,46 @@
+# Randpass
+
+Create random password with ruby. Use `SecureRandom#base64` + few random special characters.
+
+## How to install
+
+ - install from rubygems
+```
+gem install randpass
+```
+ - download from github with ssh
+```
+git clone git@github.com:alx3dev/randpass \
+cd randpass && bundle install
+```
+ - download from github with https
+```
+git clone https://www.github.com/alx3dev/randpass \
+cd randpass && bundle install
+```
+
+## How to use:
+
+ - use from terminal
+```
+# default 18 characters
+randpass
+ => 3!J_GApnCy4Mor1hMPbI?LhT
+
+# or add number of characters as argument
+randpass 30
+ => zBv2BXVB/X2WJMqzSE%VRe#Sg!/0_wYpvJC1gyHU
+ 
+ # if you not install from rubygems, you need to run
+ bin/randpass
+```
+ - use as library
+```ruby
+require 'randpass'
+
+Randpass[20]
+# or
+Randpass.randpass 20
+ => "0!ZNiAUZCbjo!#hHeX+XX$eAC=!p"
+```
+Randpass is a module, so you can include/extend it in your class, to call `randpass` method.

data/bin/randpass

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/randpass'
+
+pass = if ARGV.empty?
+         Randpass[18]
+       else
+         Randpass.randpass ARGV[0].to_i
+       end
+
+# @todo Add clipboard gem
+# Clipboard.copy pass
+puts pass

data/lib/randpass/random.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+# Generate random password with base64 and few random special characters
+#
+module Randpass
+  class << self
+    #
+    # Add special characters to base64 random string, and shuffle it
+    # @note Always shuffle #base64 if it has less than 16 chars, because they end with '=='
+    #
+    def [](number_of_chars = 18)
+      param = SecureRandom.base64(number_of_chars)
+      rand(5..10).times { param = add_special_chars(param) }
+      param.split('').shuffle.join
+    end
+    alias randpass []
+
+    private
+
+    # rubocop:disable Metrics/MethodLength
+    def add_special_chars(param)
+      # bigger number than options - we don't want
+      # same number of special chars each time
+      count = SecureRandom.random_number 15_000
+      char = case count
+             when 1...1000    then '_'
+             when 1000...2000 then '!'
+             when 2000...3000 then '#'
+             when 3000...4000 then '$'
+             when 4000...5000 then '%'
+             when 6000...7000 then '?'
+             else return param
+             end
+      param[rand(param.size)] = char
+      param
+    end
+    # rubocop:enable Metrics/MethodLength
+  end
+end

data/lib/randpass/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Randpass
+  VERSION = '0.1.1'
+end

data/lib/randpass.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'randpass/version'
+require_relative 'randpass/random'
+
+module Randpass
+  class Error < StandardError; end
+end

data/randpass.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative './lib/randpass/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'randpass'
+  s.version     = Randpass::VERSION
+  s.summary     = 'Ruby random password generator'
+  s.description = <<~DESCRIPTION
+    Generate random password with SecureRandom#base64. Add random number
+    of random special characters, and shuffle it.
+  DESCRIPTION
+
+  s.license = 'MIT'
+  s.authors = 'alx3dev'
+  s.homepage = 'https://github.com/alx3dev/randpass'
+
+  s.bindir = 'bin'
+  s.require_paths = 'lib'
+  s.executables = 'randpass'
+
+  s.metadata['homepage_uri'] = 'https://github.com/alx3dev/randpass'
+  s.metadata['source_code_uri'] = 'https://github.com/alx3dev/randpass'
+  s.metadata['bug_tracker_uri'] = "#{s.homepage}/issues"
+  s.metadata['changelog_uri'] = "#{s.homepage}/changelog.md"
+  s.metadata['documentation_uri'] = "https://rubydoc.info/gems/#{s.name}/#{s.version}"
+  s.metadata['rubygems_mfa_required'] = 'true'
+
+  s.files = %w[ lib/randpass.rb
+                lib/randpass/version.rb
+                lib/randpass/random.rb
+                LICENSE
+                README.md
+                randpass.gemspec]
+
+  s.required_ruby_version = '>= 2.7', '< 3.2'
+
+  s.add_development_dependency 'bundler', '~> 2.3'
+  s.add_development_dependency 'rake', '~> 13.0'
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: randpass
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- alx3dev
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: |
+  Generate random password with SecureRandom#base64. Add random number
+  of random special characters, and shuffle it.
+email:
+executables:
+- randpass
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/randpass
+- lib/randpass.rb
+- lib/randpass/random.rb
+- lib/randpass/version.rb
+- randpass.gemspec
+homepage: https://github.com/alx3dev/randpass
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/alx3dev/randpass
+  source_code_uri: https://github.com/alx3dev/randpass
+  bug_tracker_uri: https://github.com/alx3dev/randpass/issues
+  changelog_uri: https://github.com/alx3dev/randpass/changelog.md
+  documentation_uri: https://rubydoc.info/gems/randpass/0.1.1
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.6
+signing_key:
+specification_version: 4
+summary: Ruby random password generator
+test_files: []