junklet 0.9.1 → 0.9.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDQyODhhM2I3NTQyNzM3MzY1ZGM2NDk4YjZhN2VkMzVjMWZiZDdiYQ==
+    MDdlODdiZDE4MzI3Njk2YjBiZmQ0NTQ1ZDEwMzc3NmY0YTdkNGE3Mw==
   data.tar.gz: !binary |-
-    ZjUxZWYzYjI3NDJjZDQwZjE4YzlhN2U2ZTI5OWE1NzRlNzhkMjljOA==
+    OWRhN2UxYTQxNzk0MGI1NGNiYjRlZGQ0YTVlMzE2ODAzZGYzZjhjNg==
 SHA512:
   metadata.gz: !binary |-
-    NmJjYTk5ZmY1ZWEzOGIxMjY0YzU0NzZiODJmODlkMzNhNGJjNTQ2NTFiOTU2
-    MmYxMDc0YTdlOTI5M2UwNjRjMWRjYzVhYjNhYzU3ZDdlNjk4YWQ0YjA5Zjlk
-    MDBiZWM5NDIxMzJjZWFlYTM2Yzg5OTVjOTI2NTMwNTIwYzQ5NjY=
+    MTJjYzEzNDIxNmQwMzkwNzg0N2U4MTQyMTUxMTgzYjNiNjFhYzJlNmIyMTg3
+    ZmZjOTQxOTIzOTFlZjFhZDcwMDViYTM5NDU0YmUyODA5YjUwOTljYTQ3MWRl
+    M2I4ODk5YWRmMjk4NTRlMTNjYjQxZGUyZWQyZDBlODYwZTYzZTM=
   data.tar.gz: !binary |-
-    NjZjMDc0ZjNkYjU1YWI1NzA0OWM4MzgxZjA0ZGIwNDc1MjhhNDYwZGU5OTUw
-    NzUyYzQxOGI5ZDNkZDJkNTA5ZDA0MzlhYjI3MTUxMjhiZmI3Mzc5NGI0NzRl
-    YmY5NmUyM2EyOTg2Yzk0YmRhMzYyZmUyYmE1OWUzZjQ2NTY3ZDI=
+    ZWJmMWNlNGQ4MGU1YzY3ZTIwZGE1M2YxY2YzODgyZTgwZjU0YjdkY2EzNGNm
+    MGUwODZhYWNjMDNiMjRmMzM1NDI4MDk5MjQ3NDFiYjlkYzhjNWNlZWUzNjUw
+    NDQyZjEwYzU1N2I1ZmQxMTY2ZTY2N2QxZWIxMTllMmM2MjczYTg=

data/.rspec

@@ -0,0 +1 @@
+--color

data/README.md

@@ -1,6 +1,8 @@
 # Junklet
 
-Create tiny chunks of unique junk data in RSpec with `junklet :name`.
+Cache tiny chunks of unique junk data in RSpec with `junklet :name`;
+get handy clumps of junk data at any time with `junk`. Size your junk
+with e.g. `junk 100` or `junk 4`.
 
 Junklet data is fixture data that:
 
@@ -16,6 +18,21 @@ So,
 * If equality fails we want to be led to the offending field by the
   error message and not just the line number in the stack trace.
 
+# If You Work At CMM
+
+1. junklet means never having to type SecureRandom again.
+1. junklet prepends the field name to make errors easier to read.
+1. junk() returns a 32-byte random hex number, junk(n) returns the
+   same thing, only n bytes long (can be longer than 32)
+
+Instead of writing this -> write this:
+
+* `let(:pants) { SecureRandom.uuid }` -> `junklet :pants`
+* `let(:host_name) { "host-name-#{SecureRandom.uuid}" }` -> `junklet :host_name, separator: '-'` (Remember that underscores aren't legal in host names)
+* `let(:bad_number) { SecureRandom.hex[0..7] }` -> `let(:bad_number) { junk 8 }`
+* `let(:website) { "www.#{SecureRandom.hex}.com" }` -> `let(:website) { "www.#{junk}.com }`
+
+
 # Usage
 
     junklet :var [, :var_2 [...]] [, options_hash]
@@ -23,14 +40,15 @@ So,
     junklet :first_name
 
 Creates a `let :first_name` with the value of
-`first_name-774030d0-f58d-4f58-8c5e-dddbdc7f9580` (the uuid will
-change with each test case)
+`first_name-774030d0f58d4f588c5edddbdc7f9580` (the hex number is a
+uuid without hyphens and will change with each test case, not just
+each test run)
 
     junklet :host_name, separator: '-'
 
 Creates a `let :host_name`, but changes underscores to hyphens in the
 string value,
-e.g. `host-name-774030d0-f58d-4f58-8c5e-dddbdc7f9580`. Useful
+e.g. `host-name-774030d0f58d4f588c5edddbdc7f9580`. Useful
 specifically for host names, which cannot have underscores in them.
 
     junklet :a_a, :b_b, :c_c, separator: '.'
@@ -38,6 +56,12 @@ specifically for host names, which cannot have underscores in them.
 Does what it says on the tin: creates 3 items with string values of
 `a.a`, `b.b`, and `c.c` respectively.
 
+
+    junk [length=32]
+
+Can be called from inside a spec or let block, and returns a random
+hex string 32 bytes long (or whatever length you specify)
+
 # Background
 
 At CoverMyMeds we have a legacy impingement that prevents us sometimes
@@ -92,10 +116,8 @@ junklet :first_name, :last_name, :address, :city, :state, :phone
 ```
 
 This will have the same effect as calling `let` on the named fields
-and setting the fieldname and a UUID to be the memoized value.
-
-No, `junklet!` is NOT also included here because it doesn't really
-make sense until and unless we write custom generators.
+and setting the fieldname and a 32-byte hex string (a uuid with
+hyphens removed) to be the memoized value.
 
 # TODO
 
@@ -147,14 +169,11 @@ Or install it yourself as:
 
     $ gem install junklet
 
-## Usage
-
-TODO: Write usage instructions here
-
 ## Contributing
 
 1. Fork it ( https://github.com/[my-github-username]/junklet/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+4. Write specs to document how your change is to be used
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

data/lib/junklet/version.rb

@@ -1,3 +1,3 @@
 module Junklet
-  VERSION = "0.9.1"
+  VERSION = "0.9.2"
 end

data/lib/junklet.rb

@@ -14,10 +14,22 @@ module RSpec
           end
           
           args.zip(names).each do |arg, name|
-            let(arg) { "#{name}-#{SecureRandom.uuid}" }
+            let(arg) { "#{name}-#{junk}" }
           end
         end
       end
+
+      def junk(size=32)
+        trash = ""
+        trash += SecureRandom.hex while trash.size < size
+        trash = trash[0...size]
+      end
     end
+
+    # class ExampleGroup
+    #   def self.junk
+    #     SecureRandom.hex
+    #   end
+    # end
   end
 end

data/spec/lib/junklet_spec.rb

@@ -3,42 +3,71 @@ require 'spec_helper'
 describe Junklet do
   specify { expect(Junklet).to be }
 
-  let(:uuid_regex) { /-[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/ }
+  let(:hex_regex) { /[\da-f]{32}/ }
 
   describe '.junklet' do
     context "with a single arg" do
-      junklet :junk
+      junklet :trash
       
-      specify { expect(junk).to be }
-      specify { expect(junk).to match /^junk-/ }
-      specify { expect(junk).to match uuid_regex }
+      specify { expect(trash).to be }
+      specify { expect(trash).to match /^trash-/ }
+      specify { expect(trash).to match hex_regex }
       
       describe "memoization" do
-        specify { expect(junk).to eq(junk) }
+        specify { expect(trash).to eq(trash) }
       end
     end
 
     context "with multiple args" do
-      junklet :junk, :toss, :crud, :crap
+      junklet :trash, :toss, :crud, :crap
 
-      specify { expect(junk).to match /^junk-/ }
-      specify { expect(junk).to match uuid_regex }
+      specify { expect(trash).to match /^trash-/ }
+      specify { expect(trash).to match hex_regex }
       specify { expect(toss).to match /^toss-/ }
-      specify { expect(toss).to match uuid_regex }
+      specify { expect(toss).to match hex_regex }
       specify { expect(crud).to match /^crud-/ }
-      specify { expect(crud).to match uuid_regex }
+      specify { expect(crud).to match hex_regex }
       specify { expect(crap).to match /^crap-/ }
-      specify { expect(crap).to match uuid_regex }
+      specify { expect(crap).to match hex_regex }
     end
 
     context 'with separator option' do
       junklet :host_name, :last_name, :first_name, separator: '-'
       specify { expect(host_name).to match /^host-name-/ }
-      specify { expect(host_name).to match uuid_regex }
+      specify { expect(host_name).to match hex_regex }
       specify { expect(last_name).to match /^last-name-/ }
-      specify { expect(last_name).to match uuid_regex }
+      specify { expect(last_name).to match hex_regex }
       specify { expect(first_name).to match /^first-name-/ }
-      specify { expect(first_name).to match uuid_regex }
+      specify { expect(first_name).to match hex_regex }
+    end
+  end
+
+  describe '.junk' do
+    let(:trash) { junk }
+      
+    specify { expect(trash).to match hex_regex }
+
+    it "is not cached" do
+      expect(junk).to_not eq(junk)
+    end
+
+    it "but lets on junk ARE cached" do
+      expect(trash).to eq(trash)
+    end
+
+    context "with argument" do
+      let(:little_trash) { junk 5 }
+      let(:big_trash) { junk 100 }
+      
+      it "returns junk of that length" do
+        expect(little_trash.size).to eq(5)
+        expect(big_trash.size).to eq(100)
+      end
+
+      it "returns hex chars of that length" do
+        expect(little_trash).to match /^[\da-f]{5}$/
+        expect(big_trash).to match /^[\da-f]{100}$/
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: junklet
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - Dave Brady
@@ -74,6 +74,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rspec
 - Gemfile
 - Gemfile.lock
 - LICENSE