crypto-lite 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6408a018c374d22c0aabb5c532ec5ad7a32c6498d9d387d5e5042849c9d82dc5
+  data.tar.gz: 30c6920e588bcbc908f92ae72d506c74c668079570222d60e7b7d8a306e3846e
+SHA512:
+  metadata.gz: 8c81352f2acfa641de7b6eaebbf6b0c520f0439db3be966245dd713ede27bcc2da97746e6966e9412fc2a05bc552948189fe3fa5bb02c71b0a822347c6211cda
+  data.tar.gz: 2b6779c4a6234d21256ad260f9949e4951c5b940f91e25a749bcffd0fed9640e9c43bfd06e578f03ba254ee290d5cf08db9d3e58ace927312ae53aafca2629b3

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2021-01-14
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,11 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+lib/crypto-lite.rb
+lib/crypto-lite/version.rb
+lib/crypto.rb
+lib/crypto/lite.rb
+test/helper.rb
+test/test_hash.rb
+test/test_version.rb

data/README.md

@@ -0,0 +1,10 @@
+# crypto-lite - Cryptographic Secure Hash Functions and Public Key Signature Algorithms Made Easy
+
+
+
+
+
+
+
+
+

data/Rakefile

@@ -0,0 +1,29 @@
+require 'hoe'
+require './lib/crypto-lite/version.rb'
+
+Hoe.spec 'crypto-lite' do
+
+  self.version = CryptoLite::VERSION
+
+  self.summary = "crypto-lite  - Cryptographic Secure Hash Functions and Public Key Signature Algorithms Made Easy"
+  self.description = summary
+
+  self.urls    = { home: 'https://github.com/rubycoco/blockchain' }
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.3'
+  }
+
+end

data/lib/crypto-lite.rb

@@ -0,0 +1,82 @@
+require 'pp'
+require 'digest'
+require 'openssl'
+
+
+## our own code
+require 'crypto-lite/version'    # note: let version always go first
+
+
+
+module Crypto
+
+  def self.sha256bin( input, engine=nil )   ## todo/check: add alias sha256b or such to - why? why not?
+    input_type = if input.is_a?( String )
+                  "#{input.class.name}/#{input.encoding}"
+                 else
+                  input.class.name
+                 end
+    puts "  input: #{input} (#{input_type})"
+
+    message = if input.is_a?( Integer )  ## assume byte if single (unsigned) integer
+                raise ArgumentError, "expected unsigned byte (0-255) - got #{input} (0x#{input.to_s(16)}) - can't pack negative number; sorry"   if input < 0
+                ## note: pack -  H (String) => hex string (high nibble first)
+                ## todo/check: is there a better way to convert integer number to (binary) string!!!
+                [input.to_s(16)].pack('H*')
+              else  ## assume (binary) string
+                input
+              end
+
+
+       bytes = message.bytes
+       bin   = bytes.map {|byte| byte.to_s(2).rjust(8, "0")}.join( ' ' )
+       hex   = bytes.map {|byte| byte.to_s(16).rjust(2, "0")}.join( ' ' )
+       puts "  #{pluralize( bytes.size, 'byte')}:  #{bytes.inspect}"
+       puts "  binary: #{bin}"
+       puts "  hex:    #{hex}"
+
+       if engine && ['openssl'].include?( engine.to_s.downcase )
+         puts "  engine: #{engine}"
+         digest = OpenSSL::Digest::SHA256.new
+         digest.update( message )
+         digest.digest
+       else  ## use "built-in" hash function from digest module
+         Digest::SHA256.digest( message )
+       end
+  end
+
+  def self.sha256( input, engine=nil )
+    sha256bin( input, engine ).unpack( 'H*' )[0]
+  end
+
+
+  def self.sha256hex( input, engine=nil )
+    ## convenience helper - lets you pass in hex string
+
+    ##  check if input starts with 0x or 0X if yes - (auto-)cut off!!!!!
+    if input.start_with?( '0x') || input.start_with?( '0X' )
+      input = input[2..-1]
+    end
+
+    raise ArgumentError, "expected hex string (0-9a-f) - got >#{input}< - can't pack string; sorry"   if input.downcase =~ /[^0-9a-f]/
+    sha256( [input].pack( 'H*' ), engine )
+  end
+
+
+
+  def self.pluralize( count, noun )
+     count == 1 ? "#{count} #{noun}" : "#{count} #{noun}s"
+  end
+
+end # module Crypto
+
+
+
+## add convenience "top-level" helpers
+def sha256( input, engine=nil )    Crypto.sha256( input, engine ); end
+def sha256hex( input, engine=nil ) Crypto.sha256hex( input, engine ); end
+
+
+
+
+puts CryptoLite.banner    ## say hello

data/lib/crypto-lite/version.rb

@@ -0,0 +1,23 @@
+
+module CryptoLite
+
+  MAJOR = 0
+  MINOR = 0
+  PATCH = 1
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "crypto-lite/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module CryptoLite
+
+

data/lib/crypto.rb

@@ -0,0 +1,2 @@
+require_relative 'crypto-lite'    ## lets you use require 'crypto' too
+

data/lib/crypto/lite.rb

@@ -0,0 +1,2 @@
+require_relative '../crypto-lite'  ## lets you use require 'crypto/lite' too
+

data/test/helper.rb

@@ -0,0 +1,11 @@
+## $:.unshift(File.dirname(__FILE__))
+
+## minitest setup
+
+require 'minitest/autorun'
+
+
+## our own code
+
+require 'crypto-lite'
+

data/test/test_hash.rb

@@ -0,0 +1,78 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_hash.rb
+
+
+require 'helper'
+
+
+class TestHash < MiniTest::Test
+
+  SHA256_EMPTY         = 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'
+  SHA256_ABC           = 'ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad'
+  SHA256_A             = 'ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb'
+  SHA256_B             = '3e23e8160039594a33894f6564e1b1348bbd7a0088d42c4acb73eeaed59c009d'
+  SHA256_C             = '2e7d2c03a9507ae265ecf5b5356885a53393a2029d241394997265a1a25aefc6'
+  SHA256_HELLO_CRYPTOS = '33eedea60b0662c66c289ceba71863a864cf84b00e10002ca1069bf58f9362d5'
+
+
+def test_empty
+   assert_equal SHA256_EMPTY, sha256( '' )
+   assert_equal SHA256_EMPTY, sha256( '', :openssl )
+end
+
+def test_abc
+  ['abc',
+   'abc'.b,
+   "\x61\x62\x63",
+   0x616263
+  ].each do |input|
+    assert_equal SHA256_ABC, sha256( input )
+    assert_equal SHA256_ABC, sha256( input, :openssl )
+  end
+
+  ['616263',
+   '0x616263',
+   '0X616263'
+  ].each do |input|
+    assert_equal SHA256_ABC, sha256hex( input )
+  end
+## pp sha256hex( 'hello' )  -- fails - uses non-hex chars
+
+   # a =  dec (97), hex (61), bin (01100001)
+
+  [ 'a',
+    "\x61",
+    0b01100001,
+    0x61
+  ].each do |input|
+    assert_equal SHA256_A, sha256( input )
+    assert_equal SHA256_A, sha256( input, :openssl )
+  end
+
+  ['61',
+   '0x61',
+   '0X61'
+  ].each do |input|
+    assert_equal SHA256_A, sha256hex( input )
+  end
+
+  [ 'b',
+    0b01100010
+  ].each do |input|
+    assert_equal SHA256_B, sha256( input )
+  end
+
+  [ 'c',
+    0b01100011
+  ].each do |input|
+    assert_equal SHA256_C, sha256( input )
+  end
+end
+
+
+def test_misc
+   assert_equal SHA256_HELLO_CRYPTOS, sha256( 'Hello, Cryptos!' )
+end
+
+end # class TestHash

data/test/test_version.rb

@@ -0,0 +1,19 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_version.rb
+
+
+require 'helper'
+
+
+class TestVersion < MiniTest::Test
+
+def test_version
+   pp CryptoLite.version
+   pp CryptoLite.banner
+   pp CryptoLite.root
+
+   assert true  ## (for now) everything ok if we get here
+end
+
+end # class TestVersion

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: crypto-lite
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-01-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+description: crypto-lite  - Cryptographic Secure Hash Functions and Public Key Signature
+  Algorithms Made Easy
+email: wwwmake@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/crypto-lite.rb
+- lib/crypto-lite/version.rb
+- lib/crypto.rb
+- lib/crypto/lite.rb
+- test/helper.rb
+- test/test_hash.rb
+- test/test_version.rb
+homepage: https://github.com/rubycoco/blockchain
+licenses:
+- Public Domain
+metadata: {}
+post_install_message:
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: crypto-lite  - Cryptographic Secure Hash Functions and Public Key Signature
+  Algorithms Made Easy
+test_files: []