encry 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 68c4b6dd313beaac728223a384002fd1a51f48a13aab0ebc88c2bec8091ac560
+  data.tar.gz: 7ae4c056a844e939a23f21d291ace1878cbae81ca43dab2bb060c6faa600fce0
+SHA512:
+  metadata.gz: 91af72c2891c7186600e35075f8b70f9ff96c7ca6aa36bdf3d30e3f363de2258280d5d036c26cdff0224b0f48e983e29152f0705207ba9fc44d5175e363ba63a
+  data.tar.gz: e94174bf2c1a1b68f4fded3d7c99b963dfccc080452ecb98d19679391a95cc70e53bd00ca34d160da425a3ea2d446c8033e68725ec08bfd0085322e1e2e17270

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'encry'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/encry

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'encry'
+Encry.run(ARGV)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/encry/inputs.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'io/console'
+
+module Encry
+  class Inputs
+    def self.get_main_word(options)
+      return options[:main_word] if options[:main_word]
+
+      print 'Enter main word: '
+      main_word = $stdin.noecho(&:gets).tap { puts }.chomp
+
+      abort('Main word is empty') if main_word.strip.empty?
+
+      main_word
+    end
+
+    def self.get_site_word(argv)
+      return argv[0] if argv[0]
+
+      print 'Enter site word: '
+      site_word = gets.chomp
+
+      abort('Site word is empty') if site_word.strip.empty?
+
+      site_word
+    end
+  end
+end

data/lib/encry/options.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Encry
+  class Options
+    DEFAULT = {
+      length: 16,
+      iterations: 100_000,
+      digest: 'sha256',
+      key_length: 32,
+      show: false,
+      copy: true,
+      quiet: false
+    }.freeze
+  end
+end

data/lib/encry/outputs.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'clipboard'
+
+module Encry
+  class Outputs
+    def initialize(site_word, password, options)
+      @site_word = site_word
+      @password = password
+      @options = options
+    end
+
+    def password
+      show_debug_info if @options[:debug]
+
+      if @options[:show]
+        puts @password
+      elsif @options[:copy]
+        Clipboard.copy(@password)
+        puts 'Copied!' unless @options[:quiet]
+      end
+    end
+
+    private
+
+    def show_debug_info
+      return unless @options[:debug]
+
+      puts "[DEBUG] Site: #{@site_word}"
+      puts "[DEBUG] Digest: #{@options[:digest]}"
+      puts "[DEBUG] Iterations: #{@options[:iterations]}"
+      puts "[DEBUG] Key length: #{@options[:key_length]}"
+      puts "[DEBUG] Output length: #{@options[:length]}"
+      puts "[DEBUG] Final password: #{@password}"
+    end
+  end
+end

data/lib/encry/parser.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative 'validator'
+
+module Encry
+  class Parser
+    def initialize(options)
+      @options = options
+    end
+
+    def run(argv)
+      begin
+        build.parse!(argv)
+      rescue OptionParser::InvalidOption, OptionParser::InvalidArgument, OptionParser::MissingArgument => e
+        warn "Error: #{e.message}"
+        warn 'Use `--help` to see available @options'
+        exit 1
+      end
+
+      Validator.run(@options)
+    end
+
+    private
+
+    def build
+      OptionParser.new do |opts|
+        opts.banner = 'Usage: encry [site] [options]'
+
+        add_password_options(opts)
+        add_input_options(opts)
+        add_output_options(opts)
+        add_misc_options(opts)
+      end
+    end
+
+    def add_password_options(opts)
+      opts.on('-l', '--length N', Integer, 'Output password length (default: 16)') { |v| @options[:length] = v }
+      opts.on('-i', '--iterations N', Integer, 'KDF iterations (default: 100000)') { |v| @options[:iterations] = v }
+      opts.on('-d', '--digest NAME', String, 'Digest algorithm (sha256, sha512...)') { |v| @options[:digest] = v }
+      opts.on('--key-length N', Integer, 'Derived key length in bytes (default: 32)') { |v| @options[:key_length] = v }
+    end
+
+    def add_input_options(opts)
+      opts.on('--main WORD', String, 'Main word (insecure)') { |v| @options[:main_word] = v }
+      opts.on('--env VAR', String, 'Read main word from ENV') { |v| @options[:main_word] = ENV.fetch(v, nil) }
+      opts.on('--stdin', 'Read main word from STDIN') do
+        print 'Enter main word: '
+        @options[:main_word] = gets.chomp
+      end
+    end
+
+    def add_output_options(opts)
+      opts.on('--show', 'Show password instead of copying') do
+        @options[:show] = true
+        @options[:copy] = false
+      end
+      opts.on('--no-copy', "Don't copy to clipboard") { @options[:copy] = false }
+      opts.on('--quiet', 'No output') { @options[:quiet] = true }
+      opts.on('--debug', 'Show debug information') { @options[:debug] = true }
+    end
+
+    def add_misc_options(opts)
+      opts.on('--version', 'Show version') do
+        puts Encry::VERSION
+        exit
+      end
+      opts.on('-h', '--help', 'Show help') do
+        puts opts
+        exit
+      end
+      opts.on('--list-digests', 'List supported digest algorithms') do
+        puts Validator::AVAILABLE_DIGESTS.sort.join("\n")
+        exit
+      end
+    end
+  end
+end

data/lib/encry/password.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'openssl'
+require 'base64'
+
+module Encry
+  class Password
+    def self.generate(main_word, site_word, options)
+      key = derive_key(main_word, site_word, options)
+
+      base64 = Base64.urlsafe_encode64(key)
+
+      base64[0, options[:length]]
+    end
+
+    def self.derive_key(main_word, site_word, options)
+      salt = Digest::SHA256.digest(site_word)
+
+      begin
+        OpenSSL::KDF.pbkdf2_hmac(
+          main_word,
+          salt: salt,
+          iterations: options[:iterations],
+          length: options[:key_length],
+          hash: options[:digest].downcase
+        )
+      rescue ArgumentError => e
+        warn "Error: #{e.message}"
+        exit 1
+      end
+    end
+  end
+end

data/lib/encry/validator.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Encry
+  class Validator
+    AVAILABLE_DIGESTS = %w[
+      blake2b512
+      blake2s256
+      md5
+      rmd160
+      sha1
+      sha224
+      sha256
+      sha3-224
+      sha3-256
+      sha3-384
+      sha3-512
+      sha384
+      sha512
+      sha512-224
+      sha512-256
+      sm3
+    ].freeze
+
+    def self.run(options)
+      unless AVAILABLE_DIGESTS.include?(options[:digest].downcase)
+        warn "Invalid digest algorithm: #{options[:digest]}"
+        warn "Available algorithms: #{AVAILABLE_DIGESTS.sort.join(', ')}"
+        exit 1
+      end
+
+      abort('Error: --key-length option must be greater than 0') if options[:key_length] <= 0
+      abort('Error: --iterations option must be greater than 0') if options[:iterations] <= 0
+      abort('Error: --length option must be greater than 0') if options[:length] <= 0
+    end
+  end
+end

data/lib/encry/version.rb

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

data/lib/encry.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative 'encry/version'
+
+module Encry
+  autoload :Parser, File.expand_path('encry/parser.rb', __dir__)
+  autoload :Password, File.expand_path('encry/password.rb', __dir__)
+  autoload :Options, File.expand_path('encry/options.rb', __dir__)
+  autoload :Inputs, File.expand_path('encry/inputs.rb', __dir__)
+  autoload :Outputs, File.expand_path('encry/outputs.rb', __dir__)
+
+  class Error < StandardError; end
+
+  def self.run(argv)
+    options = Options::DEFAULT.dup
+
+    parser = Parser.new(options)
+    parser.run(argv)
+
+    site_word = Inputs.get_site_word(argv)
+    main_word = Inputs.get_main_word(options)
+
+    password = Password.generate(main_word, site_word, options)
+
+    output = Outputs.new(site_word, password, options)
+    output.password
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: encry
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- statevdev
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-06-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: clipboard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: CLI tool to derive deterministic passwords using a master key and site
+  keyword
+email:
+- statev.dev@gmail.com
+executables:
+- encry
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/console
+- bin/encry
+- bin/setup
+- lib/encry.rb
+- lib/encry/inputs.rb
+- lib/encry/options.rb
+- lib/encry/outputs.rb
+- lib/encry/parser.rb
+- lib/encry/password.rb
+- lib/encry/validator.rb
+- lib/encry/version.rb
+homepage: https://github.com/statevdev/encry
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/statevdev/encry
+  source_code_uri: https://github.com/statevdev/encry
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Deterministic password generator
+test_files: []