nist_randomness_beacon 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d2238e7bc6236232cc206d71f6244d20dc391286
-  data.tar.gz: a5045f49d245828c1b8e00d3f811ffbc1a674219
+  metadata.gz: 6336f1cb50b891524b88a874af6c508b3f0c2498
+  data.tar.gz: 0271cce375a9ac9d60d16ddda2acc087d947c80e
 SHA512:
-  metadata.gz: d856cefac19391e70726c59e5aa166bd12e2a04f79202d308964d087cf5bc2fb9e732762476bd347a8286373fb93d37e13ff544536a15cc2379c803cc8b5a365
-  data.tar.gz: 0850df25671845a6daf8674e950e07ac5e8470acc532d31eca5f2d335c542b54e861c4c47b7d7af5cab0e92a63a807cc89ffc564aeeab3df5302533dc4a8ba19
+  metadata.gz: c1df5e16ed9e97415f3020c1a805ba064fc14d954b93fba04ef209da3332df91a20ee3b6e49e5d4ef44e964b60c9aba7c4aa5b82737070ea8710dc883b2f99df
+  data.tar.gz: 665862cc39ddf2fa8d1ed24cc41b97bb5eee64ab5c7b08517f97087c5878944a2d23c1a25a0fa25566a997125d2cced13dd70ca8f9ded5651f3985e7021952ed

data/CONTRIBUTING.md

@@ -1,8 +1,6 @@
 # Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/nist_randomness_beacon/fork )
-1. Create your feature branch (`git checkout -b my-new-feature`)
-1. Please follow the [style guide](http://learning-things.cirrusmio.com/style-guides/ruby.html) as you do.
-1. Commit your changes (`git commit -am 'Add some feature'`)
-1. Push to the branch (`git push origin my-new-feature`)
-1. Create a new Pull Request
+1. [Fork it](https://github.com/chaserx/nist_randomness_beacon/fork).
+1. Please follow the [style guide](http://learning-things.cirrusmio.com/style-guides/ruby.html).
+1. Commit and push your changes to Github.
+1. [Create a new Pull Request](https://github.com/chaserx/nist_randomness_beacon/compare).

data/README.md

@@ -1,7 +1,7 @@
 # NIST Randomness Beacon
 
 A wrapper for the NIST Randomness Beacon 'cause sometimes you need to get
-a 512-bit full-entropy bit-string programmaticlly. You never know.
+a 512-bit full-entropy bit-string programmatically. You never know.
 
 Inspiration: http://hackaday.com/2014/12/19/nist-randomness-beacon/
 
@@ -29,13 +29,22 @@ Or install it yourself as:
 
 ```ruby
 require 'nist_randomness_beacon'
-record = NISTRandomnessBeacon::Client.new.last
+client = NISTRandomnessBeacon::Client.new
+record = client.last
 # => NISTRandomnessBeacon::Record
 record.output_value
 # => "4838827EDEE67CD5F58139933709764D1C51B4FC362DCAAB06B1572AC533F15F648F5EA98C5276187EBB87148852AEE291DB735F821CDC04E53DD7331AB1D3B6"
+
+# Pass an optional time to initialize:
+three_days = 3 * 24 * 60 * 60
+client = NISTRandomnessBeacon::Client.new(Time.now - three_days)
+record = client.current
+record.output_value
+# => "1B080E1C3B8A8A0FFA51831B1F830D23CE66C2FF47BF35361CF05D8095CA0AFC69A78D6711774C2653108CA355C3EA4A63926655452048A4B211BC871FC812F8"
 ```
 
-WARNING: DO NOT USE BEACON GENERATED VALUES AS SECRET CRYPTOGRAPHIC KEYS.
+WARNING: DO NOT USE BEACON-GENERATED VALUES AS SECRET CRYPTOGRAPHIC KEYS. See
+[this StackExchange thread](http://crypto.stackexchange.com/questions/15225/how-useful-is-nists-randomness-beacon-for-cryptographic-use).
 
 ## Contributing
 

data/lib/nist_randomness_beacon.rb

@@ -1,5 +1,5 @@
-require 'nist_randomness_beacon/version'
-require 'nist_randomness_beacon/client'
-require 'nist_randomness_beacon/record'
-require 'nist_randomness_beacon/service_error'
-require 'nist_randomness_beacon/underscore'
+require_relative 'nist_randomness_beacon/version'
+require_relative 'nist_randomness_beacon/client'
+require_relative 'nist_randomness_beacon/record'
+require_relative 'nist_randomness_beacon/service_error'
+require_relative 'nist_randomness_beacon/underscore'

data/lib/nist_randomness_beacon/client.rb

@@ -4,21 +4,21 @@ require 'json'
 module NISTRandomnessBeacon
   # Client to the Randomness Beacon API
   class Client
-    include HTTParty
-
-    attr_accessor :timestamp
+    DEFAULT_URI = 'https://beacon.nist.gov/rest/record'.freeze
 
-    URI = 'https://beacon.nist.gov/rest/record'.freeze
+    include HTTParty
+    attr_reader :timestamp, :uri
 
-    def initialize timestamp=Time.now.to_i
-      @timestamp = timestamp
+    def initialize time=nil, uri=DEFAULT_URI
+      @timestamp = (time || Time.now).to_i
+      @uri = uri
     end
 
     # Returns the Current Record (or next closest)
     # https://beacon.nist.gov/rest/record/<timestamp>
     #
     def current
-      response = self.class.get("#{URI}/#{@timestamp}")
+      response = self.class.get("#@uri/#@timestamp")
       raise ServiceError, response.body unless response.code.eql? 200
       NISTRandomnessBeacon::Record.new(response.parsed_response['record'])
     end
@@ -27,7 +27,7 @@ module NISTRandomnessBeacon
     # https://beacon.nist.gov/rest/record/previous/<timestamp>
     #
     def previous
-      response = self.class.get("#{URI}/previous/#{@timestamp}")
+      response = self.class.get("#@uri/previous/#@timestamp")
       raise ServiceError, response.body unless response.code.eql? 200
       NISTRandomnessBeacon::Record.new(response.parsed_response['record'])
     end
@@ -36,7 +36,7 @@ module NISTRandomnessBeacon
     # https://beacon.nist.gov/rest/record/next/<timestamp>
     #
     def next
-      response = self.class.get("#{URI}/next/#{@timestamp}")
+      response = self.class.get("#@uri/next/#@timestamp")
       raise ServiceError, response.body unless response.code.eql? 200
       NISTRandomnessBeacon::Record.new(response.parsed_response['record'])
     end
@@ -45,7 +45,7 @@ module NISTRandomnessBeacon
     # https://beacon.nist.gov/rest/record/last
     #
     def last
-      response = self.class.get("#{URI}/last")
+      response = self.class.get("#@uri/last")
       raise ServiceError, response.body unless response.code.eql? 200
       NISTRandomnessBeacon::Record.new(response.parsed_response['record'])
     end
@@ -54,7 +54,7 @@ module NISTRandomnessBeacon
     # https://beacon.nist.gov/rest/record/start-chain/<timestamp>
     #
     def start_chain
-      response = self.class.get("#{URI}/start-chain/#{@timestamp}")
+      response = self.class.get("#@uri/start-chain/#@timestamp")
       raise ServiceError, response.body unless response.code.eql? 200
       NISTRandomnessBeacon::Record.new(response.parsed_response['record'])
     end

data/lib/nist_randomness_beacon/version.rb

@@ -1,3 +1,3 @@
 module NISTRandomnessBeacon
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/nist_randomness_beacon.gemspec

@@ -6,13 +6,10 @@ require 'nist_randomness_beacon/version'
 Gem::Specification.new do |spec|
   spec.name          = "nist_randomness_beacon"
   spec.version       = NISTRandomnessBeacon::VERSION
-  spec.authors       = ["Chase Southard"]
+  spec.authors       = ["Chase Southard", "Sarah Vessels"]
   spec.email         = ["chase.southard@gmail.com"]
-  spec.summary       = %q{A wrapper for NIST Randomness Beacon}
-  spec.description   = %q{A wrapper for the NIST Randomness Beacon
-                          'cause sometimes you need to get
-                          a 512-bit full-entropy bit-string programmaticlly.
-                          You never know.}
+  spec.summary       = %q{A wrapper for the National Institute of Standards and Technology (NIST) Randomness Beacon.}
+  spec.description   = %q{A wrapper for the National Institute of Standards and Technology (NIST) Randomness Beacon 'cause sometimes you need to get a 512-bit full-entropy bit-string programmatically. You never know.}
   spec.homepage      = "https://github.com/chaserx/nist_randomness_beacon"
   spec.license       = "MIT"
 
@@ -22,8 +19,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.required_ruby_version = '> 2.0'
 
-  spec.add_development_dependency "bundler", "~> 1.7"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'awesome_print', '~> 1.2.0'
   spec.add_development_dependency 'yard', '~> 0.8.7.6'
   spec.add_development_dependency 'rspec', '~> 3.1.0'

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: nist_randomness_beacon
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Chase Southard
+- Sarah Vessels
 autorequire: 
 bindir: bin
 cert_chain: []
@@ -164,11 +165,9 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 1.8.1
-description: |-
-  A wrapper for the NIST Randomness Beacon
-                            'cause sometimes you need to get
-                            a 512-bit full-entropy bit-string programmaticlly.
-                            You never know.
+description: A wrapper for the National Institute of Standards and Technology (NIST)
+  Randomness Beacon 'cause sometimes you need to get a 512-bit full-entropy bit-string
+  programmatically. You never know.
 email:
 - chase.southard@gmail.com
 executables: []
@@ -219,7 +218,8 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: A wrapper for NIST Randomness Beacon
+summary: A wrapper for the National Institute of Standards and Technology (NIST) Randomness
+  Beacon.
 test_files:
 - spec/cassettes/current.yml
 - spec/cassettes/last.yml