passcard 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 564d68423c508f8bd705ec08e1dc0ffdd7ded2a4
+  data.tar.gz: 3d577da3416b5562f193d460e5fdedd1c9135633
+SHA512:
+  metadata.gz: a9457809b27f11eb923e16b38463b235d7b20980b6056147e529513c2735b63d6f772a05eb265e4b27fbae30886551f631d17fa865ebbc54a3c8b8a41a6d0045
+  data.tar.gz: 32559a8cb8cfa2ca948ed6b435574cdf4fd9399857d6cc9873f92fc6200628b1f61ae01c5693eccee36e07f6b42e6353fc1091cdf033e3cb2721c1dcf0a5a138

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+coverage/

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.simplecov

@@ -0,0 +1,5 @@
+SimpleCov.start do
+  add_filter "/spec/"
+  add_group "Extensions", "lib/extensions"
+  add_group "Outputters", "lib/passcard/outputter"
+end

data/.travis.yml

@@ -0,0 +1,15 @@
+sudo: false
+language: ruby
+rvm:
+- 2.4.0
+
+before_install: gem install bundler -v 1.15.4
+
+deploy:
+  provider: rubygems
+  api_key:
+    secure: KTUGDjcaqzvT8MV3T2TVMekZTI7jm0dRW3RCgDyFJ3kgO9MBiceBbbCInc+RXJKeQHvnrnCnTZ0iEEB/+8lOhM47d3CEqTeOPq+OfL2mXQ5GsLFO8udxG353b4HonqicLhf94i//8Q9EzFniGWBGWr2qQcZUrcRPvQ5MgH25UtwAtdqXpjF/l/rtEoNt8f5YMagzUlQOs9419Zl/u+H29ghNLyIpGdvMqe7k177wlHRAKzGZ1qzL1FR2KTAg7kFDwQSUK8Gt5fYJheyaA/I13dgMpkJUCbaOm7WKvTTLtwKXBIL6aS3P8HHXo5zpVn+Sma5UAcQ7wfw5Z9C+Nqg9sAJUZ77yHKZAYkMcvaJRAhdGEDZ5Q8Y0ZFcvd3UmEu/17WQPy+w4BVqLmvWKlV9j4yCZnRJdlMol5wPsOGcJTgd0aI1dhJMbo4rN0jberg4FV8WKImSphxJ54sTyQkGbr7q+7eigebS+PEm+fBCS4MiTeDrA0gLgvsRGso447R3RlpBCnEdJAXyRL1ij6Gwfra1uhdlIgO4zJNjcofCg3/QQpazfUGrO6XjUYahHE/y7bCY84+1T6DX8oqNWvDJgYVlwBfTNO2E0GVD7EDrGHlM4At4H5Drxs+7mjvompWHYtJKCMBXZWAODySguW9rI1C+bsc+vnmloacF6cPegbdI=
+  gem: passcard
+  on:
+    tags: true
+    repo: nikhgupta/passcard

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at me@nikhgupta.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec
+
+gem "nokogiri", :group => :test
+gem 'simplecov', :require => false, :group => :test
+gem "aruba", github: "cucumber/aruba", :group => [:test, :development]

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Nikhil Gupta
+
+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,51 @@
+# Passcard
+
+## TODO:
+
+- [x] Run tests on Travis
+- [ ] Update README
+- [ ] Push to Rubygems
+
+## Welcome
+
+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/passcard`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'passcard'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install passcard
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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 tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/nikhgupta/passcard. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Passcard project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/nikhgupta/passcard/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "passcard"
+
+# 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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require "pry"
+Pry.start

data/bin/rspec

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+load(bundle_binstub) if File.file?(bundle_binstub)
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

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/exe/passcard

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+require "thor"
+require "passcard"
+require "passcard/cli"
+require 'passcard/outputter/ascii_outputter'
+
+pattern = Passcard.root.join("lib", "passcard", "outputter", "*.rb")
+Dir.glob(pattern){|f| require "passcard/outputter/#{File.basename(f, '.rb')}"}
+
+# version = "Passcard v#{Passcard::VERSION} - Generate password grids with ease."
+begin
+  Passcard::CLI.start(ARGV)
+rescue Passcard::Error => e
+  STDERR.puts "\x1b[31m[Passcard] Error: #{e.message}\x1b[0m"
+  exit 1
+rescue StandardError => e
+  STDERR.puts "\x1b[31m[#{e.class}] FATAL: #{e.message}\x1b[0m"
+  STDERR.puts e.backtrace.join("\n  ")
+  exit 2
+end

data/lib/extensions/string.rb

@@ -0,0 +1,6 @@
+require 'digest/sha2'
+class String
+  def sha512
+    Digest::SHA512.hexdigest(self)
+  end
+end

data/lib/passcard.rb

@@ -0,0 +1,69 @@
+require "json"
+require "base64"
+require "openssl"
+require "ostruct"
+
+module Passcard
+  GRID_SIZE    = [80, 80]
+  ALPHA_GRID   = [40, 40]
+  NUMERIC_GRID = [20, 20]
+  CHARSET = '0123456789abcdefghjkmnpqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ@#$%&*<>?-+{}[]()\/'
+
+  class Error < StandardError; end
+
+  def self.root
+    Pathname.new(File.dirname(File.dirname(__FILE__)))
+  end
+
+  def self.outputters
+    @@outputters ||= {}
+  end
+
+  def self.register_outputter(name, klass, method_name)
+    @@outputters ||= {}
+    @@outputters[name.to_sym] = [klass, method_name.to_sym]
+  end
+
+  def self.unregister_outputter(name)
+    @@outputters.delete(name.to_sym)
+  end
+
+  def self.outputter_class_for(name)
+    klass = outputters[name.to_sym].first
+    return klass if klass.is_a?(Class)
+    Kernel.const_get(klass.to_s)
+  end
+
+  def self.encrypt!(key, object)
+    object = object.to_json
+    cipher = OpenSSL::Cipher.new('DES-EDE3-CBC').encrypt
+    cipher.key = Random.new(key.to_i(36)).bytes(24)
+    output = cipher.update(object) + cipher.final
+    Base64.encode64(output)
+  end
+
+  def self.decrypt!(key, enc_str)
+    cipher     = OpenSSL::Cipher.new('DES-EDE3-CBC').decrypt
+    cipher.key = Random.new(key.to_i(36)).bytes(24)
+    decrypted  = cipher.update(Base64.decode64(enc_str))
+    output     = decrypted << cipher.final
+    JSON.parse(output)
+  end
+
+  def self.create!(*args)
+    Passcard::Generator.create_key_file(*args)
+  end
+
+  def self.read!(*args)
+    Passcard::Reader.read_key_file(*args)
+  end
+end
+
+Dir.glob(Passcard.root.join("lib", "extensions", "*.rb")){|f| require f}
+require "passcard/version"
+require "passcard/grid"
+require "passcard/generator"
+require "passcard/reader"
+require "passcard/palette"
+require "passcard/outputter"
+require "passcard/outputter/ascii_outputter"

data/lib/passcard/cli.rb

@@ -0,0 +1,50 @@
+module Passcard
+  class CLI < Thor
+    def self.exit_on_failure?; true; end
+
+    desc "generate", "Generate a Passcard Key file."
+    method_option :identity_file, type: :string, aliases: "-i", default: "./passcard.key"
+    method_option :secret_key, type: :string, aliases: "-s"
+    method_option :charset, type: :string, aliases: "-c"
+    method_option :force, type: :boolean, aliases: "-f"
+    def generate
+      file = options[:identity_file]
+      if File.exist?(file) && !options[:force]
+        raise Passcard::Error, "Identity file exists!"
+      elsif File.exist?(file)
+        say_status "WARNING", "Overwriting file at: #{file}", :yellow
+      end
+
+      unless secret = options[:secret_key]
+        message = "Please, provide a secret key [Enter for none]:"
+        secret  = ask(message).strip
+        puts
+      end
+
+      opts = options.except(:secret_key, :identity_file) || {}
+      Passcard.create!(secret, file, opts)
+      say_status "SUCCESS", "Created Passcard key in: #{file}"
+    end
+
+    desc "view IDENTITY_FILE", "View different grids stored in your Passcard Key file."
+    method_option :header,     type: :boolean, default: true
+    method_option :color,      type: :string,  default: :passcard
+    method_option :type,       type: :string,  default: :card, aliases: "-t"
+    method_option :secret_key, type: :string,  aliases: "-s"
+    method_option :format,     type: :string,  aliases: "-f", default: "ascii"
+    def view(identity_file)
+      unless secret = options[:secret_key]
+        message = "Please, provide your secret key [Enter for none]:"
+        secret  = ask(message).strip
+        puts
+      end
+
+      data = Passcard.read!(secret, identity_file)
+      puts data.send("to_#{options[:format]}", options)
+    rescue OpenSSL::Cipher::CipherError
+      message  = "Seems like you entered the wrong secret key,\n"
+      message += "or this does not seem to be a valid Passcard."
+      raise Passcard::Error, message
+    end
+  end
+end

data/lib/passcard/generator.rb

@@ -0,0 +1,66 @@
+module Passcard
+  class Generator
+    attr_accessor :options
+
+    def self.create_key_file(key, path, options = {})
+      passcard = self.new(key, options)
+      FileUtils.mkdir_p(File.dirname(path))
+      File.open(path, "w") do |f|
+        f.print "-" * 20 + " BEGIN PASSCARD KEY " + "-" * 23 + "\n"
+        f.print passcard.run
+        f.print "-" * 20 + " END PASSCARD KEY " + "-" * 25
+      end
+    end
+
+    def initialize(secret = nil, options = {})
+      @secret = secret.to_s.strip.sha512
+
+      @options = { "charset" => Passcard::CHARSET }.merge(options)
+      @options.merge!("size" => Passcard::GRID_SIZE,
+        "numeric" => Passcard::NUMERIC_GRID, "alpha" => Passcard::ALPHA_GRID)
+    end
+
+    def run
+      return encrypt_options! if options['grid']
+
+      charspace  = options['charset'].chars.shuffle
+      numspace   = options['charset'].gsub(/[^0-9]+/, '').chars.shuffle
+      alphaspace = options['charset'].gsub(/[^a-z0-9]+/i, '').chars.shuffle
+
+      numspace   = (0..9).to_a.shuffle if numspace.empty?
+      alphaspace = (('a'..'z').to_a+('A'..'Z').to_a).shuffle if alphaspace.empty?
+
+      @options['grid'] = @options['size'][0].times.map do |r|
+        @options['size'][1].times.map do |c|
+          get_character(r, c, alphaspace, numspace, charspace)
+        end
+      end.join
+
+      encrypt_options!
+    end
+
+    def get_character(r, c, alphaspace, numspace, charspace)
+      space = alphanumeric?(r,c) ? alphaspace : charspace
+      space = numeric?(r,c) ? numspace : space
+      space.shuffle[(r + c) % space.length]
+    end
+
+    def numeric?(r, c)
+      return false if r >= @options["numeric"][0]
+      return false if c >= @options["numeric"][1]
+      return true
+    end
+
+    def alphanumeric?(r, c)
+      return false if r < @options["size"][0] - @options["alpha"][0]
+      return false if c < @options["size"][1] - @options["alpha"][1]
+      return true
+    end
+
+    protected
+
+    def encrypt_options!
+      Passcard.encrypt!(@secret, @options.to_h)
+    end
+  end
+end

data/lib/passcard/grid.rb

@@ -0,0 +1,121 @@
+require 'forwardable'
+
+module Passcard
+  class Grid
+    extend Forwardable
+    def_delegators :to_str, :chars, :gsub
+    def_delegators :@arr, :take, :empty?, :first, :last
+
+    def initialize(arr)
+      @arr = arr
+      raise_if_invalid_array!
+    end
+
+    def ==(g2)
+      self.to_a == g2.to_a && g2.is_a?(self.class)
+    end
+
+    def [](*args)
+      self.rows_at(*args)
+    end
+
+    def row_size
+      @arr.size
+    end
+
+    def col_size
+      @arr.any? ? @arr[0].size : 0
+    end
+
+    def size
+      [row_size, col_size]
+    end
+
+    def length
+      row_size * col_size
+    end
+
+    def rows_at(*rows)
+      rows = rows.map{|a| a.respond_to?(:to_a) ? a.to_a : a}
+      self.class.new rows.flatten.map{|a| @arr[a % @arr.size]}
+    end
+
+    def cols_at(*cols)
+      cols = cols.map{|a| a.respond_to?(:to_a) ? a.to_a : a}
+      self.class.new @arr.map{|a| cols.flatten.map{|c| a[c % a.length]}}
+    end
+
+    def at(rows: [], cols: [])
+      return self if rows.empty? && cols.empty?
+      return self.rows_at(*rows) if cols.empty?
+      return self.cols_at(*cols) if rows.empty?
+      self.rows_at(*rows).cols_at(*cols)
+    end
+
+    def slice(coord1, coord2)
+      self.rows_at(coord1[0]...coord2[0]).cols_at(coord1[1]...coord2[1])
+    end
+
+    def transpose
+      self.class.new @arr.transpose
+    end
+
+    def numeric?
+      to_str =~ /\A[0-9]+\z/
+    end
+
+    def alphanumeric?
+      to_str =~ /\A[a-z0-9]+\z/i
+    end
+
+    def has_symbols?
+      return false if empty?
+      return false if alphanumeric?
+      (to_str.chars - ('!'..'~').to_a).empty?
+    end
+
+    # Returns new grid by rotating self so that the element at cnt in self is
+    # the first element of the new grid. If cnt is negative then it rotates in
+    # the opposite direction.
+    #
+    def rotate(r: 0, c: 0)
+      self.class.new @arr.rotate(r).map{|row| row.rotate(c)}
+    end
+
+    def to_a
+      @arr
+    end
+
+    def to_str
+      @arr.join
+    end
+
+    def to_vstr
+      transpose.to_str
+    end
+
+    def to_s
+      @arr.map{|x| x.join(" ")}.join("\n")
+    end
+
+    def print(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      puts(col_size > 40 || options[:concise] ? to_s.gsub(" ", '') : to_s)
+      return self
+    end
+
+    def inspect
+      chars = to_str[0..36] + (length > 36 ? "...." : "")
+      chars = "" if length == 0
+      "#{self.class}[rows=#{row_size},cols=#{col_size},length=#{length}]{\"#{chars}\"}"
+    end
+
+
+    def raise_if_invalid_array!
+      valid   = @arr.is_a?(Array)
+      valid &&= @arr.reject{|r| r.is_a?(Array)}.empty?
+      valid &&= @arr.join.length == @arr.size * (@arr[0].size rescue 0)
+      raise Passcard::Error, "A Grid requires 2D array" unless valid
+    end
+  end
+end

data/lib/passcard/outputter.rb

@@ -0,0 +1,88 @@
+module Passcard
+  class Outputter
+    HEADERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 αβγδθλμπϕ $£¥€¢' + # 50
+      '! # % & * < = > ? @ ✓ ∞ ♬ ♡ ♢ ♤ ♧ ☯ ☾ ✈ ☎ ☀ ☁ ☂ ☃ ★ ⌘ ♞  ✂ ✎ '   # 30
+
+    attr_accessor :reader, :grid, :palette
+
+    def initialize(reader)
+      self.reader = reader
+      self.palette = Passcard::Palette.new
+    end
+
+    # Register one or more handler methods with this outputter.
+    # Passcard will then be able to use these methods to get the output
+    # from the outputter. For example, if you have an HtmlOutputter,
+    # you could do:
+    #
+    #   register :to_html, :to_xml
+    #
+    # You could then do a Passcard.to_png and get the result of that method.
+    # The class which registers the method will receive the generator instance
+    # as the only argument, and the default implementation of initialize puts
+    # that into the +passcard+ accessor.
+    #
+    # You can also have different method names in the outputter by providing
+    # a hash:
+    #
+    #   register to_html: :create_html, to_xml: :create_xml
+    #
+    def self.register(*args)
+      hash = args.last.is_a?(Hash) ? args.pop : {}
+      raise Passcard::Error, "You must register a method name!" if args.empty? && hash.empty?
+      args.each{|name| hash[name] = name}
+      hash.each do |name, method_name|
+        ::Passcard.register_outputter(name, self, method_name)
+      end
+    end
+
+    def use_palette(type, options = {})
+      options.merge!("n" => @grid.row_size) if @grid
+      self.palette.type = type
+      self.palette.options = options
+    end
+
+    def row_headers
+      headers   = self.class.const_get("ROW_HEADERS") rescue nil
+      headers ||= self.class.const_get("HEADERS")
+      headers.gsub(/ /, '').chars.take(grid.row_size)
+    end
+
+    def col_headers
+      headers   = self.class.const_get("COLUMN_HEADERS") rescue nil
+      headers ||= self.class.const_get("HEADERS")
+      headers.gsub(/ /, '').chars.take(grid.col_size)
+    end
+
+    def get_grid(options = {})
+      random = options[:type].to_s.to_sym == :random
+      coordinates = get_grid_coordinates(options)
+      @grid = reader.random_grid(20, 30) if  random
+      @grid = reader.slice(*coordinates) if !random
+      use_palette :passcard
+      @grid
+    end
+
+    def data_in(file)
+      content = File.read(file)
+      regex   = /^\s*__END__\s*$/
+      return "" if content.match(regex).nil?
+      content.split(regex).last.strip
+    end
+
+    private
+
+    def get_grid_coordinates(options = {})
+      case options[:type].to_s.to_sym
+      when :pincard      then [[ 0, 0], [10,20]]  # 10x20 numbers only
+      when :pincard_alt  then [[10, 0], [20,20]]  # 10x20 numbers only (alt)
+      when :alphanum     then [[40,40], [66,66]]  # 26x26 alphanumeric only
+      when :alphanum_alt then [[54,54], [80,80]]  # 26x26 alphanumeric only (alt)
+      when :square       then [[20,20], [40,40]]  # 20x20 alphanum & symbols
+      when :card_large   then [[ 0,20], [15,50]]  # 15x30 alphanum & symbols
+      when :card         then [[30,20], [40,40]]  # 10x20 alphanum & symbols - card
+      else [[0,0], [80,80]]
+      end
+    end
+  end
+end

data/lib/passcard/outputter/ascii_outputter.rb

@@ -0,0 +1,37 @@
+module Passcard
+  class AsciiOutputter < Outputter
+    register :to_ascii, to_s: :to_ascii
+
+    def to_ascii(options = {})
+      str = ""
+      get_grid(options)
+      use_palette options[:color]
+
+      str += get_col_headers if options[:header]
+
+      grid.row_size.times.map do |i|
+        str += row_headers[i].to_s + " | " if options[:header]
+        str += get_row(i, options[:color])
+        str += "\n"
+      end
+
+      str
+    end
+
+    private
+
+    def get_col_headers
+      "    #{col_headers.join(" ")}\n    #{"- "*col_headers.length}\n"
+    end
+
+    def get_row(idx, colors=true)
+      row  = grid[idx].to_s
+      return row unless colors
+
+      str  = "\x1b[48;2;#{@palette.colors[idx][:color].join(";")}m"
+      str += "\x1b[38;2;#{@palette.colors[idx][:text_color].join(";")}m"
+
+      "#{str}#{row}\x1b[0m"
+    end
+  end
+end

data/lib/passcard/outputter/html_outputter.rb

@@ -0,0 +1,127 @@
+module Passcard
+  class HtmlOutputter < Outputter
+    register :to_html
+
+    def to_html(options = {})
+      html = ""
+      get_grid(options)
+      use_palette options[:color]
+
+      html += get_col_headers if options[:header]
+
+      grid.row_size.times.map do |i|
+        html += "<div class='row'>"
+        html += get_row_header(i) if options[:header]
+        html += get_row(i, options[:color])
+        html += "</div>"
+      end
+
+      data = data_in(__FILE__).gsub('{{GRID}}', html)
+      data = data.gsub('{{BACKGROUND}}', get_background) if options[:color]
+      data
+    end
+
+    private
+
+    def get_background
+      bg1= "rgb(#{@palette.colors[0][:color].join(",")})"
+      bg2= "rgb(#{@palette.colors[-1][:color].join(",")})"
+      "background:linear-gradient(#{bg2},#{bg1})"
+    end
+
+    def get_style(idx, colors = true)
+      return unless colors
+      color = "rgb(#{@palette.colors[idx][:color].join(",")})"
+      textc = "rgb(#{@palette.colors[idx][:text_color].join(",")})"
+      return "style='color: #{textc}; background: #{color}'"
+    end
+
+    def get_row(idx, colors=true)
+      <<-HTML
+        <div class='row-content' #{get_style(idx, colors)}>
+          <span>#{grid[idx].to_a.join("</span><span>")}</span>
+        </div>
+      HTML
+    end
+
+    def get_row_header(i)
+      <<-HTML
+      <div class='row-header'>
+        <span>#{row_headers[i]}</span>
+      </div>
+      HTML
+    end
+
+    def get_col_headers
+      <<-HTML
+      <div class='col-header'>
+        <span>#{col_headers.join("</span><span>")}</span>
+      </div>
+      HTML
+    end
+  end
+end
+
+__END__
+
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <title> Passcard Grid </title>
+
+    <style type="text/css">
+      * {
+        margin: 0;
+        padding: 0;
+        font-family: monospace;
+      }
+      html, body {
+        height: 100%;
+        width: 100%;
+        color: white;
+        background-color: #666;
+      }
+      .passcard-grid {
+        width: 800px;
+        text-align: right;
+      }
+      span {
+        font-size: 17px;
+        padding: 4px;
+        height: 21px;
+        width: 21px;
+        text-align: center;
+        vertical-align: middle;
+        display: inline-block;
+      }
+      .row {
+        clear: both;
+        width: 800px;
+        text-align: right;
+      }
+      .row-header {
+        color: white;
+        background-color: #666;
+      }
+      .row-header span {
+        float: left;
+      }
+      .col-header {
+        padding-left: 28px
+      }
+      .col-header span, .row-header span {
+        font-weight: bold;
+        color: black;
+      }
+      .row-content {
+        margin-left: 40px;
+      }
+    </style>
+  </head>
+  <body style='{{BACKGROUND}}'>
+    <div class="passcard-grid">
+      {{GRID}}
+    </div>
+  </body>
+</html>

data/lib/passcard/palette.rb

@@ -0,0 +1,134 @@
+module Passcard
+  class Palette
+    extend Forwardable
+    GOLDEN_RATIO = (1 + Math.sqrt(5))/2
+
+    attr_reader :type, :colors, :options
+    def_delegators :@colors, :count, :size, :take, :first, :last, :[]
+
+    def initialize(type = :passcard, options = {})
+      self.type    = type
+      self.options = options
+    end
+
+    def type=(type)
+      @type = type.to_s.strip.empty? ? :passcard : type.to_sym
+
+      if !respond_to?("generate_colors_#{@type}", true)
+        raise Passcard::Error, "No such color generator: #{@type}"
+      end
+
+      update_colors
+    end
+
+    def options=(options = {})
+      @options = options
+      @options["n"] ||= (@options["size"][0] rescue 0)
+      update_colors
+    end
+
+    def update_colors
+      return unless type && options
+      @colors = send("generate_colors_#{type}", options).map do |rgb|
+        { color: rgb, text_color: readable_text_color_for(rgb) }
+      end
+    end
+
+    def list_types
+      self.methods.map do |method|
+        method.to_s.gsub!(/^generate_colors_/, '')
+      end.compact.map(&:to_sym)
+    end
+
+    protected
+
+    def generate_colors_martin_ankerl(options = {})
+      h = rand
+      s = options.fetch('s', 0.33)
+      v = options.fetch('v', 0.93)
+
+      options['n'].times.map do
+        h = (h + 1/GOLDEN_RATIO) % 1
+        hsv_to_rgb(h * 360, s, v)
+      end
+    end
+
+    def generate_colors_krazydad(options = {})
+      width  = options.fetch('width',  55)
+      center = options.fetch('center', 200)
+      phase  = options.fetch('phase',  rand * Math::PI * 2.0)
+      freq   = Math::PI / options['n'] * 2.0
+
+      options['n'].times.map do |i|
+        red   = Math.sin(freq * i + 0 + phase) * width + center
+        green = Math.sin(freq * i + 2 + phase) * width + center
+        blue  = Math.sin(freq * i + 4 + phase) * width + center
+        [red.round(0), green.round(0), blue.round(0)]
+      end
+    end
+
+    def generate_colors_gradient(options = {})
+      s = rand
+      v = options.fetch("v", 0.93)
+      from, to = generate_colors_martin_ankerl("s" => s, "v" => v, "n" => 2)
+
+      options['n'].times.map do |i|
+        m = i/options['n'].to_f
+        3.times.map{ |j| (from[j]*m + to[j] * (1-m)).round(0) }
+      end
+    end
+
+    def generate_colors_passcard(options = {})
+      h = (360 * rand).round(2)
+      n = options['n']
+      smax = options.fetch('smax', 0.4)
+      n = n.times.map{|i| (1+i)/n.to_f * smax * 1.0}
+      n.flatten.map{|s| hsl_to_rgb(h, s, 1 - s)}
+    end
+
+    private
+
+    # For more info on conversions, read:
+    # https://en.wikipedia.org/wiki/HSL_and_HSV
+    #
+    # Hue is specified in range: 0 <= hue < 360
+    #
+    def hue_to_rgb(h, c, x, m)
+      y = [c, 0, x] if h < 360
+      y = [x, 0, c] if h < 300
+      y = [0, x, c] if h < 240
+      y = [0, c, x] if h < 180
+      y = [x, c, 0] if h < 120
+      y = [c, x, 0] if h < 60
+      y.map{ |a| ((a + m) * 255).round(0) }
+    end
+    def hsv_to_rgb(h, s, v)
+      c = v * s
+      x = c * (1 - ((h / 60.0) % 2 - 1).abs)
+      m = v - c
+      hue_to_rgb(h, c, x, m)
+    end
+    def hsl_to_rgb(h, s, l)
+      c = (1 - (2 * l - 1).abs) * s
+      x = c * (1 - ((h / 60.0) % 2 - 1).abs)
+      m = l - c / 2.0
+      hue_to_rgb(h, c, x, m)
+    end
+
+    # Read: https://www.w3.org/TR/WCAG20/#relativeluminancedef
+    def luminosity_for(rgb)
+      conv = rgb.map do |c|
+        c/255.0 <= 0.03928 ? c/255.0/12.92 : ((c/255.0+0.055)/1.055)**2.4
+      end
+      conv[0] * 0.2126 + conv[1] * 0.7152 + conv[2] * 0.0722
+    end
+
+    # Read: https://www.w3.org/TR/WCAG20/#contrast-ratiodef
+    def readable_text_color_for(rgb, dark = nil, light = nil)
+      dark  ||= [  0,  0,  0]
+      light ||= [255,255,255]
+      lc, ld, ll = [rgb, dark, light].map{|color| luminosity_for(color)}
+      (lc + 0.05) / (ld + 0.05) > (ll + 0.05) / (lc + 0.05) ? dark : light
+    end
+  end
+end

data/lib/passcard/reader.rb

@@ -0,0 +1,73 @@
+require 'forwardable'
+
+module Passcard
+  class Reader
+    extend Forwardable
+    def_delegators :to_hash, :[], :has_key?
+
+    def self.read_key_file(key, path)
+      data = File.readlines(path)
+      self.new(key, data[1...-1].join.strip)
+    end
+
+    attr_reader :opts, :grid
+
+    def initialize(key, enc_text)
+      secret, enc_text = key.sha512, enc_text
+      @opts = Passcard.decrypt!(secret, enc_text)
+      get_grid
+    end
+
+    def get_grid
+      return @grid if @grid
+      @grid = @opts.delete("grid")
+      @grid = @grid.chars.each_slice(@opts["size"][1]).to_a
+      @grid = Passcard::Grid.new(@grid)
+    end
+
+    def numeric_grid
+      @grid.slice([0, 0], @opts["numeric"])
+    end
+
+    def alpha_grid
+      ir = @opts["size"][0] - @opts["alpha"][0]
+      ic = @opts["size"][1] - @opts["alpha"][1]
+      @grid.slice([ir, ic], @opts["size"])
+    end
+
+    # Should be taken from all corners rather than the first:
+    def random_grid(rows = 10, cols = 10)
+      return Passcard::Grid.new([]) if rows * cols == 0
+      return @grid if rows * cols >= @grid.length
+
+      ir = rand(@opts["size"][0] - rows - 1).to_i
+      ic = rand(@opts["size"][1] - cols - 1).to_i
+      @grid.slice([ir, ic], [ir + rows, ic + cols])
+    end
+
+    def to_hash
+      @opts.merge("grid" => @grid.to_str)
+    end
+
+    def to_s(*a, &b)
+      return @grid.to_s unless Passcard.outputters.has_key?(:to_s)
+      klass, method = Passcard.outputters[:to_s]
+      klass.new(self).send(method, *a, &b) || @grid.to_s
+    end
+
+    def method_missing(m, *a, &b)
+      if Passcard.outputters.include?(m)
+        klass, method_name = Passcard.outputters[m]
+        klass.new(self).send(method_name, *a, &b)
+      elsif @grid.respond_to?(m)
+        @grid.send(m, *a, &b)
+      else
+        super
+      end
+    end
+
+    def respond_to?(*args)
+      @grid.respond_to?(*args) || super
+    end
+  end
+end

data/lib/passcard/version.rb

@@ -0,0 +1,3 @@
+module Passcard
+  VERSION = "0.1.0"
+end

data/passcard.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "passcard/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "passcard"
+  spec.version       = Passcard::VERSION
+  spec.authors       = ["Nikhil Gupta"]
+  spec.email         = ["me@nikhgupta.com"]
+
+  spec.summary       = %q{Password Card Generator}
+  spec.description   = %q{Password Card Generator}
+  spec.homepage      = "https://github.com/nikhgupta/passcard"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor", "~> 0.20"
+  spec.add_development_dependency "pry", "~> 0.10"
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: passcard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nikhil Gupta
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-09-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Password Card Generator
+email:
+- me@nikhgupta.com
+executables:
+- passcard
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".simplecov"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/rspec
+- bin/setup
+- exe/passcard
+- lib/extensions/string.rb
+- lib/passcard.rb
+- lib/passcard/cli.rb
+- lib/passcard/generator.rb
+- lib/passcard/grid.rb
+- lib/passcard/outputter.rb
+- lib/passcard/outputter/ascii_outputter.rb
+- lib/passcard/outputter/html_outputter.rb
+- lib/passcard/palette.rb
+- lib/passcard/reader.rb
+- lib/passcard/version.rb
+- passcard.gemspec
+homepage: https://github.com/nikhgupta/passcard
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: Password Card Generator
+test_files: []