droll 1.0rc5.2.3

data/COPYING

@@ -0,0 +1,15 @@
+The droll project is copyright 2010, 2011, and 2012 Chad Perrin, and may be
+distributed under the terms of the Open Works License.  See the owl.txt file
+for license text.
+
+The Rubinius implementation of Ruby allows distribution under the terms of the
+MIT/X11 license.  See the [Rubinius project](http://rubini.us) for more details
+about it.
+
+The MRI/YARV implementation of Ruby is distributed under the terms of the Ruby
+license, which also allows distribution under the terms of the Simplified
+(2-Clause) BSD License.
+
+Drollbot, in addition to the standard library, requires the Isaac library.
+Isaac may be distributed under the terms of the MIT/X11 license.  See the
+[Isaac project](https://github.com/ichverstehe/isaac) for more details.

data/README.markdown

@@ -0,0 +1,178 @@
+# droll
+
+Droll, for "d roll" (as in "die roll"), is a dice rolling library and a command
+line utility.  Drollbot is an IRC bot that uses the droll and Isaac libraries
+to provide dicebot functionality over IRC.
+
+At present, droll provides both normal die rolling capability and simplistic
+exploding die rolling capability (exploding automatically on die rolls that
+return the highest value available on the die).  Alternate thresholds for
+exploding can be used.  Use NdN as the pattern for normal die rolls (where N
+stands in for a number), and NxN for exploding die rolls.  Modifiers can be
+included as well: NdN+N or NdN-N.  Die codes, at this time, do not work if they
+have spaces in them.  Certain die codes are rejected (i.e.  0x0).  Exploding is
+limited to an unreasonably high number (1000), to prevent crashing.  Changing
+the exploding threshold uses a .N syntax (NxN.N).  Die values are chosen
+(pseudo)randomly from numbers between 1 and N (the number following the x or
+d), or between 0 and N if the N is preceded by a 0 character.  An example of
+the full sophistication of die code parsing is:
+
+    4x05.4+7
+
+This would roll four virtual dice numbered 0-5, and each die would explode on
+any 4 or 5 result.  All die results are added together, and 7 added to the
+total to yield a final number.
+
+The first number following each 4 or 5 in this example is the result of a die
+immediately rolled to handle exploding die values.
+
+
+## installation
+
+If you already have Ruby installed, installing droll should be easy.  Just
+download the gem package from the [Bitbucket repository][bitbucket] and use the
+gem command to install it:
+
+    $ gem install droll-<version>.gem
+
+In this example, replace `<version>` with the version number in the name of the
+gemfile you downloaded.  For version 1.0.0, for instance, the command might
+look like this:
+
+    $ gem install droll-1.0.0.gem
+
+Note that the `$` character indicates your shell prompt, and is not part of the
+command.  Depending on your setup, you may need to use `sudo`, log in as root,
+or engage in some other additional activities to ensure the gem is installed
+correctly.  If you know of different requirements for installation on other
+systems, please feel free to submit patches to this README file via one of the
+approaches detailed in the **contributions** section at the bottom of this
+file.
+
+Eventually, droll will be distributed through Ruby's standard centralized
+package management system, and the entire installation process will be reduced
+to the following for most cases:
+
+    $ gem install droll
+
+That day has not yet arrived.  Special circumstances apply to the use of the
+`drollbot` command; see below.
+
+## usage
+
+The following sections explain how to use the executable tools that come with
+the droll library: a `droll` command line interface and a `drollbot` IRC
+dicebot.
+
+
+### `droll` command line
+
+Using the basic droll program from the command line is pretty simple:
+
+    > droll d20
+    d20: [15] + 0 = 15
+    > droll 2d4+3
+    2d4+3: [1, 2] + 3 = 6
+    > droll 1d10 2d03
+    1d10: [1] + 0 = 1
+    2d03: [3, 2] + 0 = 5
+    > droll 4x05.4+7
+    4x05.4+7: [5, 2, 0, 4, 0, 1] + 7 = 19
+
+In each example, the numbers between `[brackets]`, separated by commas, are the
+numberic results for each of the individual dice rolled.  As shown by the third
+example of using the command line droll program above, multiple die codes can
+be listed on a single line, with the results of each roll being shown on a
+separate line of output.  In the last example, the first number following each
+4 or 5 in this example is the result of a die immediately rolled to handle
+exploding die values.
+
+
+### `drollbot` IRC dicebot
+
+The drollbot interface to the functionality of the droll library does some
+things a little differently.  For instance, any input to a channel monitored by
+drollbot will be checked to see if it starts with a die code that drollbot
+understands.  If so, it will parse that line as a command to produce die roll
+output.  Starting a line with `droll` or `drollbot` will not have the same
+effect.  As such, this may occur:
+
+    12:38 < apotheon> 1d20+3
+    12:38 < drollbot> <apotheon> rolls 1d20+3: [10] + 3 = 13
+
+The output from drollbot is a touch more verbose; this is an example of how it
+works within a standard IRC channel.  Private messages may be sent to drollbot,
+with slightly differently formatted output:
+
+    12:40 <apotheon> /msg drollbot 1d20+3
+    12:40 <drollbot> result of 1d20+3: [13] + 3 = 16
+
+Note that this example is not perfectly representative.  The `/msg` command is
+sent from an IRC channel where the drollbot instance is logged in, and the
+`result` message appears in a PM that is not visible to anyone else in the IRC
+channel where the dicebot was invoked.
+
+In either case, a comment may be appended to the end of the line.  Within an
+IRC channel:
+
+    12:42 < apotheon> 1d20+3 crappy save
+    12:42 < drollbot> <apotheon> rolls 1d20+3: [17] + 3 = 20 (crappy save)
+
+Drollbot will echo any text following your die code back to you as a
+parenthetical note.  This applies to die codes as well as other text so that,
+unlike with the command line `droll` utility, multiple rolls cannot be
+specified in a single command:
+
+    12:43 < apotheon> 2x05 d20+3 2d4 many
+    12:43 < drollbot> <apotheon> rolls 2x05: [4, 2] + 0 = 6 (d20+3 2d4 many)
+
+To start drollbot, all you need to do is ensure that it is configured with an
+IRC network to which it should connect, and some channel names it should join,
+then run the program.  An example configuration file is included with the
+installed gem.  After installing the droll gem, you can find the example
+configuration file in the directory hierarchy where the gem was installed,
+under the `etc` subdirectory.  The example configuration file is called
+`drollbot.conf.sample`.  Use the `drollbot -c` or `drollbot --config` command
+to see more information about configuring drollbot.
+
+
+## license
+
+Droll project files may be redistributed under the terms of the Open Works
+License.  See owl.txt for license text.
+
+Also see the [OWL site][owl] for more details.
+
+The OWL was chosen with a conscious adherence to copyfree policies.  See the
+[Copyfree Initiative][copyfree] site for more details about the copyfree
+philosophy of licensing.
+
+See the COPYING file for more information about copyright and licensing for
+droll and the code associated with it.
+
+
+## contributions
+
+If you wish to contribute to the project, please feel free to do so.
+
+Mercurial (in the form of the hg tool) offers a simple way to produce a patch,
+using the `export` command.  To produce a patch based on the most recent
+commits in your local clone of the project, this command should suffice to
+produce a usable patch for an update from the immediately previous commit:
+
+    > hg export tip
+
+* Patches may be submitted via the issue tracker, as a comment with attachment
+  in response to whatever issue it fixes.
+* Patches can also be submitted to Chad Perrin via email, using the code at
+  apotheon dot net address.
+* Another way to submit contributions is to clone the project on
+  [Bitbucket][bitbucket] and send a "pull request" from the clone when changes
+  have been made.  The process of submitting contributions via fork and pull
+  request is described in a TechRepublic article: [*Contribute to Bitbucket
+  Projects Using Forks and Pull Requests*][forkpull].
+
+[owl]: http://owl.apotheon.org
+[copyfree]: http://copyfree.org
+[bitbucket]: https://bitbucket.org/apotheon/droll/overview
+[forkpull]: http://blogs.techrepublic.com.com/programming-and-development/?p=4028

data/bin/droll

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'droll'
+
+help_text = {
+  :quiet  =>    'Suppress verbose output.',
+  :help     =>  'Display this help text.',
+  :syntax   =>  'Display comprehensive syntax help.',
+  :version  =>  'Display version and license information.'
+}
+
+@usage = <<EOF
+
+USAGE: #{File.basename $0} [options] [die_code]
+
+EOF
+
+syntax_help = <<EOF
+
+SYNTAX
+
+    Die codes are constructed from up to five parts:
+
+    1. Die Number (Optional; Default: 1)
+
+        An optional number that determines how many of a die should be
+        rolled.  For instance, if you wish to get the results of rolling
+        two six-sided dice, the number would be 2.
+
+    2. Roll Type (Mandatory; No Default)
+
+        A single-letter code used to specify how rolls should be treated.
+
+            d   Roll normally.
+
+            x   On a result equal to or higher than a threshold value, roll
+                another die of that type and add it to the total.
+
+            e   On a result where all dice yield values equal to or higher
+                than a threshold value, roll another die of that type and
+                add it to the total.
+
+    3. Die Value (Mandatory; No Default)
+
+        Indicates the set of values the die can produce.  Two types of die
+        value are supported: a normal positive integer value (a whole
+        number higher than zero), and such a value preceded by a zero.  If
+        preceded by a zero, it is treated as a die marked with a range of
+        numbers from zero to the value following the zero.  Otherwise, it
+        is treated as being marked with a range of numbers from one to the
+        indicated value.
+
+    4. Threshold (Optional; Default: Maximum Value)
+
+        A threshold may be specified for exploding roll types by attaching
+        a number, separated from the die value by a period.  Any die result
+        equal to or greater than the threshold value causes another die to
+        be rolled and added to the total.  The threshold is counted for
+        every die when using the x Roll Type, or for the sum of all dice
+        when using the e Roll Type.  It is ignored when using the d Roll
+        Type, and a warning is issued.
+
+    5. Modifier (Optional; No Default)
+
+        A plus or minus sign can be used to indicate that a value should be
+        added to, or subtracted from, the die roll total.  Following the
+        plus or minus sign, a numerical value is specified to indicate what
+        should be added or subtracted.  The modifier is applied to the roll
+        total, and not to each individual die roll.
+
+EXAMPLES
+
+    d10     Roll a single ten-sided die for values between 1 and 10.
+
+    2d3     Roll two three-sided dice for values between 1 and 3.  Add the
+            results together, for a total between 2 and 6.
+
+    3x02    Roll three three-sided dice for values between 0 and 2.  For
+            each 2 result, roll another die of the same type.  Repeat as
+            necessary, and add all values together.
+
+    3x02.1  Same as 3x02, but explodes on 1 or higher instead of only on 2.
+
+    3x02+3  Same as 3x02, but add 3 to the total.
+
+    3e02    Roll three three-sided dice for values between 0 and 2 as
+            though rolling 3d02.  If all three dice yield 2 results -- and
+            only if all three dice yield 2 results, providing a 6 total --
+            roll another three- sided die for values between 0 and 2.
+            Threat this die as 1x02, and add the exploding total to the
+            original 6 result.
+
+    3e02.4  Same as 3e02, but roll an additional 1x02 if the total of the
+            original 3d02 roll is equal to 4 or greater.
+
+EOF
+
+version_help = <<EOF
+
+Droll #{Droll.version}, Copyright 2010, 2011, 2012 Chad Perrin
+This software may be distributed under the terms of the Open Works License.
+See http://owl.apotheon.org for license details.
+
+EOF
+
+verbose = true
+
+OptionParser.new do |opts|
+  opts.banner = @usage
+
+  opts.on('--quiet', '-q', help_text[:quiet]) do
+    verbose = false
+  end
+
+  opts.on('--help', '-h', help_text[:help]) do
+    puts opts
+    puts
+    exit!(0)
+  end
+
+  opts.on('--syntax', '-s', help_text[:syntax]) do
+    puts syntax_help
+    exit!(0)
+  end
+
+  opts.on_tail('--version', help_text[:version]) do
+    puts version_help
+    exit!(0)
+  end
+end.parse!
+
+if 0 < ARGV.size
+  ARGV.each do |a|
+    droll = Droll.new a
+    puts droll.roll(verbose)
+  end
+else
+  puts @usage
+  puts %Q{    Try "#{File.basename $0} --help" for usage information.}
+  puts
+end

data/bin/drollbot

@@ -0,0 +1,166 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'droll'
+
+help_text = {
+  :file     =>  'Select non-default configuration file.',
+  :config   =>  'Display configuration help text.',
+  :help     =>  'Display this help text.',
+  :version  =>  'Display version and license information.'
+}
+
+@usage = <<EOF
+
+USAGE: #{File.basename $0} [options] [command]
+
+At present, there is only one command: start.  Issuing the start command
+starts the drollbot dicebot with settings according to the config file.
+
+EOF
+
+config_help = <<EOF
+
+The drollbot IRC dicebot requires a configuration file to work, because it
+needs to have certain information that cannot reasonably be defined by default.
+The default configuration file is called "drollbot.conf", and is located in the
+.config/droll directory within your user home directory.  You can see this in
+the source of the drollbot executable itself, in a line that reads:
+
+    filename = '~/.config/droll/drollbot.conf'
+
+This can be overridden by use of the -f or --file option when entering a
+drollbot command.  For instance, to use a freenode-specific config file, you
+might create a file in your home directory called "drollbot_freenode.conf" and
+explicitly use that when starting the drollbot process:
+
+    drollbot -f '~/drollbot_freenode.conf' start
+
+The configuration file, wherever you put it and whatever you call it has a
+dirty little secret.  It is actually just a Ruby file that is loaded by
+drollbot to set certain values.  Such values include:
+
+    $nickname       IRC nick
+    $passwd         IRC password
+    $ircnet         IRC network
+    $portno         port number
+    $ssl            SSL switch
+    $verbose        verbosity switch
+    $channels       list of channels
+
+For each of these, configure by using the label that starts with a dollar sign
+an equal sign, and a value.  The values must take the form of literal data
+types in Ruby -- strings, integers, true/false boolean values, and (in the case
+of the $channels lable) an array literal.  For instance:
+
+    $nickname   = 'dicebot'
+    $ircnet     = 'irc.freenode.net'
+    $portno     = 7000
+    $ssl        = true
+    $channels   = ['#botwar', '#drollbot_testing']
+
+The port number value must be an integer, a simple number with no punctuation.
+The switch values should be a bare, unpunctuated true or false word.  The
+channel list should be a comma separated list of channel names surrounded in
+quotes, enclosed in brackets -- not (parentheses) or {braces}.  Other values
+shown here are individual terms surrounded in quotes.  Whether you use single
+quotes or double quotes is generally irrelevant, but do not use "curly" quotes
+or backticks, use the same quote character on beginning and end of a value
+(including list item values), and use exactly one quote character at each end
+of a value.  To learn more about this syntax, you can learn about Ruby
+programming language data types.
+
+Of these configuration values, only three are always important: the IRC nick,
+the IRC network, and the channel list.  The necessity of using the rest of them
+depends on the specifics of what IRC network you are using, in what channels
+you want to have a dicebot, and other matters particular to your circumstances.
+
+You can find an example configuration file in the directory hierarchy where the
+gem is installed, under the "etc" subdirectory. The example configuration file
+is called "drollbot.conf.sample".  It should not be used exactly as written, as
+the nick and password values are not designed to avoid conflicting with
+settings and other users on the default network configuration in that file.
+The two default channels are used for IRC bot testing on the freenode IRC
+network, so they should be safe for purposes of playing around with your
+drollbot instance and learning its quirks.
+
+EOF
+
+version_help = <<EOF
+
+Droll and drollbot #{Droll.version}, Copyright 2010, 2011, 2012 Chad Perrin
+This software may be distributed under the terms of the Open Works License.
+See http://owl.apotheon.org for license details.
+
+EOF
+
+filename = '~/.config/droll/drollbot.conf'
+
+OptionParser.new do |opts|
+  opts.banner = @usage
+
+  opts.on('--file=FILE', '-f=FILE', help_text[:file]) do |val|
+    config_file = val.chomp
+  end
+
+  opts.on('--config', '-c', help_text[:config]) do
+    puts config_help
+    exit(0)
+  end
+
+  opts.on('--help', '-h', help_text[:help]) do
+    puts opts
+    puts
+    exit(0)
+  end
+
+  opts.on_tail('--version', '-v', help_text[:version]) do
+    puts version_help
+    exit(0)
+  end
+end.parse!
+
+if ARGV[0] == 'start'
+  require 'isaac'
+  load filename
+
+  configure do |c|
+    c.nick        = $nickname
+    c.password    = $passwd
+    c.server      = $ircnet
+    c.port        = $portno
+    c.ssl         = $ssl
+    c.verbose     = $verbose
+  end
+
+  on :connect do
+    $channels.each do |chan|
+      join chan
+    end
+  end
+
+  on :channel, /^([0-9]*[dex][0-9]+(\.\d+)?[+-]?[0-9]*)\s*(.*)/ do
+    droll = Droll.new match[0]
+    result = droll.roll
+    output = "<#{nick}> rolls " + result
+
+    if match.length > 1
+      if match[-1].length > 0
+        output += " (#{match[-1]})"
+      end
+    end
+    msg channel, output
+  end
+
+  on :private, /^([0-9]*[dex][0-9]+(\.\d+)?[+-]?[0-9]*)\s*(.*)/ do
+    droll = Droll.new match[0]
+    result = droll.roll
+    output = 'result of ' + result
+
+    if match.length > 1
+      if match[-1].length > 0
+        output += " (#{match[-1]})"
+      end
+    end
+    msg nick, output
+  end
+end

data/etc/drollbot.conf.sample

@@ -0,0 +1,8 @@
+$nickname = 'foo'
+$passwd   = 'bar'
+$ircnet   = 'irc.freenode.net'
+$portno   = 7000
+$ssl      = true
+$verbose  = true
+
+$channels = ['#botwar', '##botwar']

data/lib/droll.rb

@@ -0,0 +1,256 @@
+=begin rdoc
+
+Droll provides a Ruby class that parses die codes as normally presented in
+roleplaying game texts, i.e.:
+
+        3d4+7
+
+This die code indicates that four-sided dice numbered 1-4 should be rolled --
+three of them.  Their totals should be added together, and the number 7 should
+be added to the total.  If only one die should be rolled, it can be represented
+as either 1d4 or, in abbreviated form, as d4.  Numbers may be either added or
+subtracted (e.g. 3d4-7), or no modifiers may be applied at all (e.g. 3d4).  A
+"normal" six-sided die, a cube with numbers or "pips" to indicate the value of
+each face, is represented by 1d6 or d6.  Droll's handling of die codes is case
+sensitive, such that 3D4 will not work as described above.
+
+=== Additional Syntax Options
+
+The syntax accepted by Droll is more sophisticated than the above might
+indicate, to accommodate special die roll semantics.
+
+==== Exploding
+
+Dice in some game systems may "explode".  This means that, under certain
+conditions, the result on a die may indicate that another die should be rolled
+and added to the total as well.  The most common case is where any die that
+produces the maximum possible value for that die indicates that another die
+should be rolled and added to the total.  Normal exploding die syntax uses x
+instead of d in the die code:
+
+        3x4+7
+
+In this case, when each d4 is rolled, an additional die is rolled if that die's
+value is 4 (the maximum value for the die).  The modifier is applied to the
+total after all dice (including exploding dice) are rolled and added together.
+
+An alternate exploding method only explodes if *all* dice rolled produce a
+result of the maximum value each die can produce.  This uses e instead of d or
+x in the die code:
+
+        3e4+7
+
+In this case, if the total of the 3d4 roll is 12, an additional d4 is rolled
+and added to the running total, and if that (or any subsequent d4 rolls that
+are part of the same 3e4+7 dice roll resolution) is another 4 result, it
+explodes again.  If two 4 results and a 3 result come from that roll of 3d4, no
+exploding occurs, leaving an 11 result from the virtual dice.  As normal, when
+all die rolling is resolved and summed, the modifier (+7 in this case) is
+applied to the total.
+
+==== Explosion Threshold
+
+An exploding threshold may be specified by a period/fullstop character followed
+by a number, with any modifiers coming after it:
+
+        3x4.3+7
+
+In this case, the die code is treated the same way as in the previous example,
+except that it explodes on 3 or 4, and not just on 4.
+
+==== Alternate Minimum Value
+
+Dice whose value ranges start at 0 instead of 1 are also possible.  To indicate
+a 0-N range, precede the die value with a 0 in the die code:
+
+        3d03
+
+This die code rolls three virtual dice whose values may be anywhere in the
+range of 0-3 and returns the total for all three dice.  For other minimum
+values, apply a modifier.  For instance, for a value ranging from -3 to 0, a
+die code like the following may be used:
+
+        d03-3
+
+=== Usage:
+
+==== API:
+
+        require 'droll'
+        
+        droll = Droll.new '3x4.3+7'
+        puts droll.roll
+
+The above example produces output like the following:
+
+        3x4.3+7: [4, 1, 4, 4, 2, 2] + 7 = 24
+
+==== Command Line:
+
+        droll 3x4.3+7
+
+The above example produces output like the API usage example.
+
+=end
+
+
+class Droll
+
+=begin rdoc
+
+This method returns the version number for the Droll gem.
+
+=end
+
+  def self.version; '1.0rc5.2.3'; end
+
+=begin rdoc
+
+The +dcode+ argument is any valid die code recognized by Droll.
+
+        Droll.new '4x7+3'
+
+=end
+
+  def initialize(dcode)
+    @dcode = dcode
+    @pcode = process_die
+  end
+
+  private
+
+  def valid?
+    if @dcode.match(
+      /^[1-9]*[0-9]*[A-Za-z][0-9]?[1-9]+[0-9]?(\.\d+)?[+-]?[0-9]*\s*(.*)$/
+    )
+      validation = true
+    else
+      validation = false
+    end
+
+    if 1 > @pcode['val'].to_i
+      return false
+    end
+    
+    if 1 > @pcode['thresh'].to_i
+      return false
+    end
+
+    if 1 > @pcode['num'].to_i
+      return false
+    end
+
+    if 0 == @pcode['val'][0].to_i
+      if 1 > @pcode['val'].to_i
+        return false
+      end
+    end
+
+    if 0 != @pcode['val'][0].to_i
+      if 2 > @pcode['val'].to_i
+        return false
+      elsif 2 > @pcode['thresh'].to_i
+        return false
+      end
+    end
+
+    return validation
+  end
+
+  def process_die
+    d = Hash.new
+    die_roll, d['sign'], d['mod'] = @dcode.split(/([+-])/)
+    d['num'], d['type'], die_vals = die_roll.split(/([A-Za-z])/)
+    d['val'], d['thresh'] = die_vals.split(/\./)
+    d['val'] = d['val'].to_s
+    d['thresh'] ||= d['val'].sub(/^0/, '')
+
+    d['num'] = 1 if d['num'] == ''
+    d['sign'] ||= '+'
+    d['mod'] ||= 0
+
+    return d
+  end
+
+  def get_discrete(dval)
+    dval.match(/^0/) ? rand(dval.to_i + 1) : 1 + (rand dval.to_i)
+  end
+
+  def roll_die(die_value, die_type, die_threshhold)
+    discrete_rolls = [get_discrete(die_value)]
+
+    case die_type
+    when 'x'
+      c = 0
+      while c < 1000
+        if discrete_rolls[-1] >= die_threshhold.to_i
+          discrete_rolls.push get_discrete(die_value)
+          c += 1
+        else
+          break
+        end
+      end
+    end
+
+    discrete_rolls.compact
+  end
+
+  public
+
+=begin
+
+By default, this method returns a string showing the die code rolled, the
+individual die rolls that make up the complete roll of dice, the modifier
+applied to the roll (showing "\+ 0" if no modifier was given), and the result,
+in the following format:
+
+        3d6+2: [3, 4, 1] + 2 = 10
+
+If the +formatted+ argument is given a +false+ value, this method returns only
+an integer equal to the total result.
+
+=end
+
+  def roll(formatted=true)
+    running_totals = Array.new
+
+    return "bad die code: #{@dcode}" unless valid?
+
+    @pcode['num'].to_i.times do
+      running_totals.push(
+        roll_die @pcode['val'], @pcode['type'], @pcode['thresh']
+      )
+      running_totals.flatten!
+    end
+
+    if @pcode['type'] == 'e'
+      dice_total = running_totals.map {|s| s.to_i}.inject(:+)
+      if dice_total >= @pcode['thresh'].to_i
+        running_totals.push(
+          roll_die @pcode['val'], 'x', @pcode['thresh']
+        )
+      end
+      running_totals.flatten!
+    end
+
+    total_result = running_totals.map {|s| s.to_i }.inject do |sum,n|
+      sum ? sum+n : n
+    end
+
+    case @pcode['sign']
+    when '+'
+      total_result += @pcode['mod'].to_i
+    when '-'
+      total_result -= @pcode['mod'].to_i
+    end
+
+    if formatted
+      result = "#{@dcode}: #{running_totals.inspect} "
+      result += "#{@pcode['sign']} #{@pcode['mod']} = "
+
+      result + total_result.to_s
+    else
+      total_result
+    end
+  end
+end

data/owl.txt

@@ -0,0 +1,23 @@
+# Open Works License
+
+This is version 0.9.2 of the Open Works License.
+
+## Terms
+
+Permission is hereby granted by the copyright holder(s), author(s), and
+contributor(s) of this work, to any person who obtains a copy of this work in
+any form, to reproduce, modify, distribute, publish, sell, use, or otherwise
+deal in the licensed material without restriction, provided the following
+conditions are met:
+
+Redistributions, modified or unmodified, in whole or in part, must retain
+applicable copyright notices, the above license notice, these conditions, and
+the following disclaimer.
+
+NO WARRANTY OF ANY KIND IS IMPLIED BY, OR SHOULD BE INFERRED FROM, THIS LICENSE
+OR THE ACT OF DISTRIBUTION UNDER THE TERMS OF THIS LICENSE, 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
+WORK, OR THE USE OF OR OTHER DEALINGS IN THE WORK.

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: droll
+version: !ruby/object:Gem::Version
+  version: 1.0rc5.2.3
+  prerelease: 3
+platform: ruby
+authors:
+- Chad Perrin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: isaac
+  requirement: &12637340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: *12637340
+description: ! "    Droll is a Ruby library providing dice roller functionality, with
+  a\n    command line utility and an IRC bot as included user interfaces.\n"
+email: code@apotheon.net
+executables:
+- droll
+- drollbot
+extensions: []
+extra_rdoc_files: []
+files:
+- COPYING
+- README.markdown
+- owl.txt
+- lib/droll.rb
+- bin/droll
+- bin/drollbot
+- etc/drollbot.conf.sample
+homepage: https://bitbucket.org/apotheon/droll
+licenses:
+- OWL
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Droll - Dice Roller Library
+test_files: []