rollr 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8bbb146f1eda263836dc19aed6e53a76129cb5a0
-  data.tar.gz: eecf8f87f9f7bfb30de9fa9ef71d60ef1d1af93b
+  metadata.gz: abb626fa239a16084db24fe697c926e487125b85
+  data.tar.gz: f073bf80d411236ce05498f09ce15f16217b5715
 SHA512:
-  metadata.gz: e9f86b226855254ffdc52f2d4f7ece33a19c1ca8df49ca7478d9f24c242dc482c193025d46429287a89dae40f365a84203dfc24a510f0cee62769f45ead8d8d6
-  data.tar.gz: 232417404aa539c83c8585099f581bc42e2b9acb412777e23677b067c394321a34d99e741cb97c4aa7130362f6e47439797f82e48d11d1ca1a016e5b5750ce48
+  metadata.gz: 9c0f428e1589a7d00a8d0d2ce82b433101f024a2ef322990a4492b74004e37b6c62fcf14743f5396804af5abb0228b6de92b836e06c765624c308d7604333225
+  data.tar.gz: 774957eb15c28d9fd4257b888b32f01efa012390e907078aa27783065575fbf162dc9df0636034be5aa471c3439498081c371d484e6fe410fc13dd25128472e2

data/README.md

@@ -35,7 +35,7 @@ $ irb
 > d6 = Rollr::Die.new(6)
 ```
 
-When you roll a `Die`, you get a `RollResult`. 
+When you roll a `Die`, you get a `RollResult`.
 
 ```
 > d6.roll
@@ -44,7 +44,7 @@ When you roll a `Die`, you get a `RollResult`.
 #=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 6>
 ```
 
-You can roll multiple dice of the same kind by passing a number to the `roll` argument with the `number` keyword argument. 
+You can roll multiple dice of the same kind by passing a number to the `roll` argument with the `number` keyword argument.
 
 ```
 > d6.roll(number: 3)
@@ -57,27 +57,27 @@ You can roll multiple dice of the same kind by passing a number to the `roll` ar
 #=> <Rollr::RollResult #hash total: 14, rolls: [2, 6, 6], number_of_dice: 3, die_sides: 6>
 ```
 
-The `RollResult` has few helpful things to report about your roll. 
+The `RollResult` has few helpful things to report about your roll.
 
-The `#total` method represents the sum total of the dice that were rolled: 
+The `#total` method represents the sum total of the dice that were rolled:
 
 ```
 > result.total
 #=> 14
 ```
 
-The `#rolls` array, which reports the individual results of any dice rolled: 
+The `#rolls` array, which reports the individual results of any dice rolled:
 
 ```
 > result.rolls
 #=> [2, 6, 6]
 ```
 
-`#number_of_dice` tells you how many dice were rolled this time: 
+`#number_of_dice` tells you how many dice were rolled this time:
 
 ```
 result.number_of_dice
-#=> 3 
+#=> 3
 ```
 
 `#die_sides` reports the number of sides on the dice rolled in this result:
@@ -87,6 +87,57 @@ result.die_sides
 #=> 6
 ```
 
+#### Manipulating `RollResult`s
+
+Roll results can be further manipulated after their original creation. To facilitate popular use-cases for Dice rolling, `RollResult`s also include public `#drop_lowest` and `#drop_highest` methods.
+
+`#drop_lowest` returns a new `RollResult` without the lowest numerical die roll.
+
+```
+> result = d6.roll(number: 4)
+#=> <Rollr::RollResult #hash total: 14, rolls: [3, 1, 4, 6], number_of_dice: 4, die_sides: 6>
+
+> result.rolls
+#=> [3, 1, 4, 6]
+
+> result.total
+#=> 14
+
+> new_result = result.drop_lowest
+#=> <Rollr::RollResult #hash total: 13, rolls: [3, 4, 6], number_of_dice: 3, die_sides: 6>
+
+> new_result.rolls
+#=> [3, 4, 6]
+
+> new_result.total
+#=> 13
+```
+
+Similarly, `#drop_highest` will remove the highest number in the `rolls` array.
+
+```
+> new_result = result.drop_highest
+#=> <Rollr::RollResult #hash total: 8, rolls: [3, 1, 4], number_of_dice: 3, die_sides: 6>
+
+> new_result.rolls
+#=> [3, 1, 4]
+
+> new_result.total
+#=> 8
+```
+
+Both `#drop_lowest` and `#drop_highest` can also take an optional integer argument.
+
+```
+> new_result = result.drop_highest(2)
+
+> new_result.rolls
+#=> [3, 1]
+
+> new_result.total
+#=> 4
+```
+
 ### Dice Constants
 
 Rollr comes pre-packaged with several shortcuts for popular Die sizes:
@@ -100,29 +151,7 @@ Rollr comes pre-packaged with several shortcuts for popular Die sizes:
 > result = Rollr::D12.roll
 #=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
 
-#D10
-> result = Rollr::D10.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
-
-#D8
-> result = Rollr::D8.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
-
-#D6
-> result = Rollr::D6.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
-
-#D4
-> result = Rollr::D4.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
-
-#D3
-> result = Rollr::D3.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
-
-#D2
-> result = Rollr::D2.roll
-#=> <Rollr::RollResult #hash total: 6, rolls: [6], number_of_dice: 1, die_sides: 12>
+#D2-6, D8, and D10!
 ```
 
 ## Development

data/lib/rollr/die.rb

@@ -6,23 +6,23 @@ module Rollr
 
     def initialize(sides)
       @sides = sides
-    end 
+    end
 
     def roll(number: 1)
       Rollr::RollResult.new(
-        rolls: array_of_rolls(number),
+        rolls: rolls(number),
         sides: sides
       )
-    end 
+    end
 
     private
 
     def single_roll
-      SecureRandom.random_number(sides) + 1
+      SecureRandom.random_number(sides).to_i + 1
     end
 
-    def array_of_rolls(number)
+    def rolls(number)
       (1..number).map { single_roll }
     end
-  end 
+  end
 end

data/lib/rollr/roll_result.rb

@@ -1,11 +1,11 @@
 module Rollr
   class RollResult
-    attr_accessor :rolls
+    attr_accessor :rolls, :sides
 
     def initialize(sides:, rolls:)
       @sides = sides
       @rolls = rolls
-    end 
+    end
 
     def die_sides
       @sides
@@ -18,5 +18,25 @@ module Rollr
     def number_of_dice
       @_number_of_dice ||= rolls.count
     end
-  end 
+
+    def drop_lowest(num = 1)
+      return RollResult.new(
+        sides: sides,
+        rolls: sorted_rolls.last(rolls.length - num)
+      )
+    end
+
+    def drop_highest(num = 1)
+      return RollResult.new(
+        sides: sides,
+        rolls: sorted_rolls.first(rolls.length - num)
+      )
+    end
+
+    private
+
+    def sorted_rolls
+      rolls.sort
+    end
+  end
 end

data/lib/rollr/version.rb

@@ -1,3 +1,3 @@
 module Rollr
-  VERSION = "1.0.2"
+  VERSION = "1.0.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rollr
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Alex Jarvis
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-04-08 00:00:00.000000000 Z
+date: 2016-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler