srs_game 0.Alexis

data/.gitignore

@@ -0,0 +1,8 @@
+doc
+tmp
+*~
+*.save
+.rbx
+.yardoc
+Gemfile.lock
+coverage

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm: ["1.9.3", "1.9.2"]
+branches: { "only" : [ "master", "development" ] }

data/.yardopts

@@ -0,0 +1,2 @@
+lib/srs_game.rb
+*.md

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+gem "rake", "~> 0.9.2.2"
+gem "term-ansicolor", "~> 1.0.7"
+gem "rspec", "~> 2.9.0", :group => :test
+gem "simplecov", "~> 0.6.1", :require => false, :group => :test

data/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2012 Jackson Willis
+
+This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.
+   If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
+
+2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
+
+3. This notice may not be removed or altered from any source distribution.

data/README.md

@@ -0,0 +1,57 @@
+SRS GAME
+========
+
+[![Build Status](https://secure.travis-ci.org/jacksonwillis/srs_game.png?branch=master)](https://secure.travis-ci.org/jacksonwillis/srs_game)
+[![Dependency Status](https://gemnasium.com/jacksonwillis/srs_game.png)](https://gemnasium.com/jacksonwillis/srs_game)
+
+![SRS GAME logo](https://github.com/downloads/jacksonwillis/srs_game/srs_game.png)
+
+Welcome
+-------
+
+SRS GAME is a framework and a collection of text-based games written in the [Ruby](http://www.ruby-lang.org/) 1.9 programming language.
+
+If you find a bug, feel free to [create an issue](https://github.com/jacksonwillis/srs_game/issues/new).
+
+Installation
+------------
+
+*Main article: [Installation](https://github.com/jacksonwillis/srs_game/wiki/Installation)*
+
+Playing the game
+----------------
+
+    $ rake play:tamera   # Play as the goddess Tamera
+    $ rake play:tia      # Play as a follower of the Cult of Tia
+
+Running a server
+----------------
+
+    $ rake server:tamera HOST=127.0.0.1 PORT=5446 MAX_CONNECTIONS=4
+
+Testing
+-------
+
+To test, just run `rake`
+or check out the [automated tests](https://secure.travis-ci.org/jacksonwillis/srs_game).
+
+API
+---
+
+    irb > require "srs_game/tamera"
+     => true
+    irb > game = Game.new(Tamera, color: false)
+     => #<SRSGame::Game:0x000000022f1337>
+    irb > game.send "look"
+     => "You find yourself in the Main Room.\nItems here are an AM/FM Radio.\nExits are east and west."
+    irb > game.send "north"
+     => "NOPE. Can't go that way."
+    irb > game.send "west"
+     => ""
+    irb > game.room
+     => #<SRSGame::Location "the West Room" @items=[] exits=["east", "west"]>
+
+License
+-------
+
+SRS GAME is released under the zlib license. See [LICENSE](https://github.com/jacksonwillis/srs_game/blob/master/LICENSE)

data/Rakefile.rb

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+require "srs_game"
+require "rake"
+
+require "bundler/gem_tasks"
+
+namespace :play do
+  desc "Play as a follower of the Cult of Tia"
+  task :tia do
+    require "srs_game/tia"
+    Game.new(Tia, color: true).play
+  end
+
+  desc "Play as the goddess Tamera"
+  task :tamera do
+    require "srs_game/tamera"
+    Game.new(Tamera, color: true).play
+  end
+end
+
+namespace :server do
+  desc "Telnet server for Tia"
+  task :tia do
+    require "srs_game/tia"
+    SRServer.play(Tia, ENV["PORT"], ENV["HOST"], ENV["MAX_CONNECTIONS"])
+  end
+
+  desc "Telnet server for Tamera"
+  task :tamera do
+    require "srs_game/tamera"
+    SRServer.play(Tamera, ENV["PORT"], ENV["HOST"], ENV["MAX_CONNECTIONS"])
+  end
+end
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new
+
+task :default => :spec

data/examples/pokemon_clone.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+require "srs_game"
+include SRSGame
+
+module PokemonClone
+  class Computer < Item
+    interactable_as :computer
+    name "red's computer"
+  end
+
+  class Bed < Item
+    interactable_as :bed
+    name "YOUR BED"
+  end
+
+  def greeting
+    "      /\"*-.\n" << \
+    "     /     `-.\n" << \
+    "    /         `-.\n" << \
+    "   /             `-.\n" << \
+    "   `\"*-._           `-.\n" << \
+    "         \"*-.      .-'\n" << \
+    "           .-'  .-'\n" << \
+    "         <'   <'\n" << \
+    "          `-.  `-.           .\n" << \
+    "            .'  .-'          $\n" << \
+    "     _    .' .-'     bug    :$;\n" << \
+    "     T$bp.L.-*\"\"*-._        d$b\n" << \
+    "      `TP `-.       `-.    : T$\n" << \
+    "     .' `.   `.        `.  ;  ;\n" << \
+    "    /     `.   \\ _.      \\:  :\n" << \
+    "   /        `..-\"         ;  |\n" << \
+    "  :          /               ;\n" << \
+    "  ;  \\      / _             :\n" << \
+    " /`--'\\   .' $o$            |\n" << \
+    "/  /   `./-, `\"'      _     :\n" << \
+    "'-'     :  ;  _ '    $o$    ;\n" << \
+    "        ;Y\"   |\"-.   `\"'   /\n" << \
+    "        | `.  L.'    .-.  /`*.\n" << \
+    "        :   `-.     ;   :'    \\\n" << \
+    "         ;    :`*-._L.-'`-.    :\n" << \
+    "         :    ;            `-.*\n" << \
+    "          \\  /\n" << \
+    "           \"\" ~* PokemonClone.rb *~\n"
+  end
+
+  def main_room
+    house = L.new(:name => "outside your house")
+    house.in = L.new(:name => "in your living room")
+    house.in.up = L.new(:name => "at the top of your stairs")
+
+    room = house.in.up.north = L.new(:name => "at the threshold your room")
+    room.north = L.new(:name => "standing in the middle of your room", :items => [Bed.new])
+    room.north.west = L.new(:name => "at your computer", :items => [Computer.new])
+
+    house.south = L.new(:name => "at the Pallet Town plaza")
+    house
+  end
+
+  class Commands < SRSGame::Commands
+  end
+end
+
+SRSGame::Game.new(PokemonClone, color: true).play if __FILE__ == $0

data/lib/srs_game/basic.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../../", __FILE__)
+require "srs_game"
+include SRSGame
+
+module SRSGame::Basic
+  def main_room
+    Location.new
+  end
+end

data/lib/srs_game/tamera.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../../", __FILE__)
+require "srs_game"
+include SRSGame
+
+# Play as the goddess Tamera
+module SRSGame::Tamera
+  class BallaAssSpoon < Item
+    name "a Balla Ass Spoon"
+    interactable_as :spoon
+  end
+
+  class CrystalBall < Item
+    name "a Crystal Ball"
+    interactable_as :crystal
+  end
+
+  class Radio < Item
+    name "an AM/FM Radio"
+    interactable_as :radio
+  end
+
+  # Room where you begin in
+  def main_room
+    main = L.new do |l|
+      l.name = "in the Main Room"
+      l.items = [Radio.new]
+    end
+
+    main.east = L.new do |l|
+      l.name = "in the East Room"
+      l.items = [BallaAssSpoon.new, CrystalBall.new]
+    end
+
+    dungeon = main.east.south = L.new do |l|
+      l.name = "a creepy dungeon"
+    end
+
+    dungeon.south = L.new do |l|
+      l.name = "Hell"
+    end
+
+    west_room = main.west = L.new do |l|
+      l.name = "the West Room"
+    end
+
+    far_west = west_room.west = L.new do |l|
+      l.name = "the Far West Room"
+    end
+
+    far_west.north = L.new do |l|
+      l.name = "the North West Room"
+    end
+
+    return main
+  end
+
+  # Emitted before the game starts
+  def greeting
+    "\n #####   #####     ##       #     ####   ######\n #    #  #    #   #  #      #    #       #\n #    #  #    #  #    #     #     ####   #####\n #####   #####   ######     #         #  #\n #       #   #   #    #     #    #    #  #\n #       #    #  #    #     #     ####   ######\n\n\n #####   ######\n #    #  #\n #####   #####\n #    #  #\n #    #  #\n #####   ######\n\n\n  #####   ####\n    #    #    #\n    #    #    #\n    #    #    #\n    #    #    #\n    #     ####\n\n\n  #####    ##    #    #  ######  #####     ##\n    #     #  #   ##  ##  #       #    #   #  #\n    #    #    #  # ## #  #####   #    #  #    #\n    #    ######  #    #  #       #####   ######\n    #    #    #  #    #  #       #   #   #    #\n    #    #    #  #    #  ######  #    #  #    #\n\n"
+  end
+end
+
+SRSGame.play Tamera if __FILE__ == $0

data/lib/srs_game/tia.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+# Not yet implemented
+module SRSGame module Tia end end
+raise "SRSGame::Tia is not yet implemented."

data/lib/srs_game/version.rb

@@ -0,0 +1,3 @@
+module SRSGame
+  VERSION = "0.Alexis"
+end

data/lib/srs_game.rb

@@ -0,0 +1,429 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+require "zlib"
+require "base64"
+require "readline"
+require "gserver"
+require "term/ansicolor"
+
+include Term::ANSIColor
+
+$LOAD_PATH.unshift File.expand_path("./", __FILE__)
+require "srs_game/version"
+require "srs_game/basic"
+
+class Object
+  def blank?
+    if respond_to?(:empty?)
+      empty?
+    else
+      !self
+    end
+  end
+
+  def unblank?
+    !self.blank?
+  end
+
+  # Removes "_" from beginning of line and downcases it
+  def command_pp
+    to_s.gsub(/^_/, "").downcase
+  end
+
+  # From ActiveSupport[http://api.rubyonrails.org/classes/Array.html#method-i-to_sentence].
+  # Converts the array to a comma-separated sentence where the last element is joined by the connector word. Options:
+  # * :words_connector:: - The sign or word used to join the elements in arrays with two or more elements (default: ", ")
+  # * :two_words_connector:: - The sign or word used to join the elements in arrays with two elements (default: " and ")
+  # * :last_word_connector:: - The sign or word used to join the last element in arrays with three or more elements (default: ", and ")
+  # * :bold:: - Bolds the elements being joined. (default: false)
+  # @return [String]
+  def to_sentence(options = {})
+    words_connector     = options[:words_connector]     || ", "
+    two_words_connector = options[:two_words_connector] || " and "
+    last_word_connector = options[:last_word_connector] || ", and "
+
+    if options[:bold]
+      return to_sentence Array[self] unless respond_to? :map!
+
+      map!(&:to_s)
+      map!(&:bold)
+    end
+
+    case length
+    when 0
+      ""
+    when 1
+      self[0].to_s.dup
+    when 2
+      "#{self[0]}#{two_words_connector}#{self[1]}"
+    else
+      "#{self[0...-1].join(words_connector)}#{last_word_connector}#{self[-1]}"
+    end
+  end
+end
+
+class String
+  TRUE_WORDS = %w{t true yes y}
+  FALSE_WORDS = %w{f false no n}
+
+  # Convert to boolean value matching TRUE_WORDS or FALSE_WORDS
+  # @return [Boolean, nil]
+  def to_bool
+    dc = to_s.downcase
+
+    if TRUE_WORDS.include?(dc)
+      true
+    elsif FALSE_WORDS.include?(dc)
+      false
+    end
+  end
+
+  # Can the string be converted to a boolean value?
+  # @return [Boolean]
+  def boolean?
+    !to_bool.nil?
+  end
+
+  # Does the string represent a numeral in Ruby?
+  # @return [Boolean]
+  def numeric?
+    !!Float(self) rescue false
+  end
+
+  # Turn the string in to an array of arguments.
+  # It tries to convert words into booleans and floats. Example:
+  #     "3.14 yes gaga false".args #=> [3.14, true, "gaga", false]
+  # @return [Array]
+  def args
+    strip.words.map do |arg|
+      next if arg.empty?
+
+      if arg.boolean?
+        arg.to_bool
+      elsif arg.numeric?
+        Float(arg)
+      else
+        arg
+      end
+    end
+  end
+
+  # Scans the string for groups of non-whitespace characters.
+  # @return [Array]
+  def words
+    scan(/\S+/)
+  end
+end
+
+class IO
+  def rainbow_say(str, greeting_speed = 50)
+    colors = [:red, :yellow, :green, :cyan, :blue, :magenta].cycle
+
+    str.each_line do |line|
+      print (line =~ /\S/ ? line.__send__(colors.next) : line)
+      sleep 1.0 / greeting_speed
+    end
+  end
+end
+
+module SRSGame
+  class DirectionError < ::TypeError; end
+  class DONE_WITH_SRS_GAME < ::SystemExit; end
+
+  # From Dwemthy's Array by _why the lucky stiff
+  # http://mislav.uniqpath.com/poignant-guide/dwemthy/
+  class Traitable
+    # Get a metaclass for this class
+    def self.metaclass; class << self; self; end; end
+
+    # Advanced metaprogramming code for nice, clean traits
+    def self.traits( *arr )
+      return @traits if arr.empty?
+
+      # 1. Set up accessors for each variable
+      attr_accessor *arr
+
+      # 2. Add a new class method to for each trait.
+      arr.each do |a|
+        metaclass.instance_eval do
+          define_method( a ) do |val|
+            @traits ||= {}
+            @traits[a] = val
+          end # define_method
+        end # instance_eval
+      end # each
+
+      # 3. For each traitable object, the `initialize' method
+      #    should use the default number for each trait.
+      class_eval do
+        define_method( :initialize ) do
+          self.class.traits.each do |k,v|
+            instance_variable_set("@#{k}", v)
+          end
+        end
+      end
+
+    end
+  end
+
+  class Item < Traitable
+    traits :interactable_as, # TODO: rename this trait
+           :name,
+           :description,
+           :takeable
+
+    # Defaults
+    interactable_as :item
+    name "an Item"
+    description ""
+    takeable false
+
+    def to_s
+      name
+    end
+  end
+
+  class Location; end
+  # SRSGame::L is a shortcut for SRSGame::Location
+  L = Location
+
+  class Location
+    def self.direction_relationships
+      [["north", "south"], ["east", "west"], ["up", "down"], ["in", "out"]]
+    end
+
+    def self.mirrored_directions
+      direction_relationships + direction_relationships.map { |a| a.reverse }
+    end
+
+    # All directions available
+    def self.directions
+      direction_relationships.flatten
+    end
+
+    attr_reader(*L.directions)
+    attr_accessor :name, :description, :items
+
+    def initialize(params = {}, &block)
+      @name        = params[:name] || "a room"
+      @description = params[:description].to_s
+      @items       = params[:items].to_a
+
+      block.call(self) if block.respond_to? :call
+    end
+
+    def item_grep(str)
+      @items.select { |item| str == item.interactable_as.to_s.downcase }
+    end
+
+    def items_here
+      "Items here are #{@items.map(&:to_s).to_sentence(:bold => true)}."
+    end
+
+    # We have to create our own setter methods to do the mirrored direction relationships
+    L.mirrored_directions.each do |dir|
+      direction, opposite = *dir
+      define_method(direction + "=") do |loc|
+        # set @direction to loc
+        instance_variable_set "@" + direction, loc
+        # _direction is @direction
+        _direction = instance_variable_get("@" + direction)
+        _direction.__send__(opposite + "=", self) unless _direction.__send__(opposite)
+      end
+    end
+
+    # Available exits
+    # @return [Array]
+    def exits
+      L.directions.select { |dir| __send__(dir) }
+    end
+
+    # Information displayed when a room is entered.
+    def info
+      o = "You find yourself #{@name.bold}."
+      o << " #{@description}" if @description.unblank?
+      o << "\n" << items_here if @items.unblank?
+      o << "\nExits are #{exits.to_sentence(:bold => true)}." if exits.unblank?
+      o
+    end
+
+    def go(direction)
+      if exits.include?(direction.to_s)
+        __send__(direction)
+      else
+        raise DirectionError, "Can't go #{direction} from #{@name}."
+      end
+    end
+
+    def use_item(s, &block)
+      if (found = item_grep(s)).length == 1
+        block.call found[0]
+      else
+        items_here
+      end
+    end
+
+    def to_s
+      "#<SRSGame::Location #{@name.inspect} @items=#{@items.inspect} exits=#{exits.inspect}>"
+    end
+  end
+
+  # Class methods beginning with `+_+' are available as commands during the game
+  class Commands
+    # Called when a non-existing command is entered during the game
+    def method_missing(m, *a)
+      "#{self.class}##{m.downcase}: not found".red
+    end
+
+    # Methods that start with `+_+' and don't end with `+_+'
+    def callable_methods
+      methods.grep(/^_\w+[^_]$/)
+    end
+
+    def matching_methods(match)
+      callable_methods.grep(/^_#{match}/)
+    end
+
+    # Parse input and +__send__+ it
+    def parse(input, game)
+      method = input.words.first.command_pp
+
+      arguments = input.words[1..-1]
+
+      output = __send__("_#{method}", arguments.join(" "), game)
+    end
+
+    #################################
+    # Methods available as commands #
+    #################################
+
+    # Define all directions as commands
+    L.directions.each do |direction|
+      define_method("_#{direction}") do |a, g|
+        begin
+          g.go!(direction)
+        rescue DirectionError => e
+          e
+        end
+      end
+    end
+
+    # Quit the game
+    def _exit(a, g)
+      raise DONE_WITH_SRS_GAME
+    end
+
+    def _look(a, g)
+      if a.args.blank?
+        g.room.info
+      else # We are looking for an item
+        g.room.use_item(a) { |item| "You see #{item.name.bold}." }
+      end
+    end
+
+    # Display help text
+    def _help(a, g)
+      "All available commands:\n#{callable_methods.map(&:command_pp).to_sentence(:bold => true)}"
+    end
+
+    # Alias commands
+    alias :_quit :_exit
+    alias :_? :_help
+  end
+
+  class Game
+    attr_accessor :room, :command
+
+    def initialize(mod = SRSGame::Basic, options = {})
+      raise ArgumentError, "Can't use #{mod} for SRSGame module" unless mod.is_a? Module
+      extend mod
+
+      @options = options
+      @room = main_room
+      #@travel_path = [@room]
+      @command = mod.const_get(:Commands).new
+    end
+
+    def go!(*directions)
+      if directions.size >= 2
+        directions.each { |dir| go! dir }
+      else
+        new_room = @room.go(directions[0])
+        @room = new_room
+      end
+    end
+
+    #def current_room
+    #  @travel_path[-1]
+    #end
+
+    #def last_room
+    #  @travel_path[-2]
+    #end
+
+    #def same_room?
+    #  current_room.eql? last_room
+    #end
+
+    def prompt
+      pr = "$ ".bold.blue
+      @options[:color] ? pr : pr.uncolored
+    end
+
+    def send(input)
+      output = @command.parse(input, self)
+      @options[:color] ? output : output.uncolored
+    end
+
+    def play
+      Readline.completion_append_character = " "
+
+      begin
+        loop do
+          Readline.completion_proc = proc { |match| @command.matching_methods(match).map(&:command_pp) }
+          input = Readline.readline(prompt, true)
+          puts send(input) unless input.blank?
+        end
+      rescue DONE_WITH_SRS_GAME
+        puts "\nHave a nice day!"
+      end
+    end
+  end
+
+  class SRServer < GServer
+    ## ♫ 54-46 was my number ♫ ##
+    DEFAULT_PORT = 54_46
+    MAX_CONNECTIONS = 4
+
+    attr_reader :mod
+
+    def initialize(mod, port=DEFAULT_PORT, host=DEFAULT_HOST, max_connections=MAX_CONNECTIONS)
+      @mod = mod
+      super(port, host, max_connections, $stderr, true, true)
+    end
+
+    def serve(io)
+      game = Game.new(@mod, direct: false)
+
+      begin
+        loop do
+          io.print game.prompt
+          input = io.readline
+          io.puts game.send(input) unless input.blank?
+        end
+      rescue DONE_WITH_SRS_GAME
+        io.puts "\nHave a nice day!"
+      end
+    end
+
+    def self.play(*args)
+      server = new(*args)
+      server.audit = true
+      server.start
+      trap(:INT) { server.stop }
+      server.join
+    end
+  end
+end

data/spec/game_spec.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../", __FILE__)
+require "spec_helper"
+
+describe SRSGame::Game do
+  it "has a room" do
+    Game.new.room.should be_instance_of Location
+  end
+
+  describe "#go!" do
+    it "travels" do
+      game = Game.new
+
+      kitchen  = Location.new
+      basement = Location.new { |l| l.up = kitchen }
+      sidewalk = Location.new { |l| l.in = kitchen }
+      bus_stop = Location.new { |l| l.north = sidewalk }
+
+      game.room = basement
+      ->{game.go! :up, :out, :south}.should change {game.room}.from(basement).to(bus_stop)
+    end
+  end
+
+
+  describe "#_quit" do
+    it "quits" do
+      ->{Game.new.send "quit"}.should raise_error DONE_WITH_SRS_GAME
+    end
+  end
+end

data/spec/helpers_spec.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../", __FILE__)
+require "spec_helper"
+
+describe "helpers" do
+  it "determines blankness" do
+    [].blank?.should be_true
+    "".blank?.should be_true
+    false.blank?.should be_true
+    true.blank?.should be_false
+    3.14.blank?.should be_false
+    nil.unblank?.should be_false
+    "foo".unblank?.should be_true
+  end
+
+  it "formats commands" do
+    "_baz".command_pp.should eq "baz"
+    :_Senate.command_pp.should eq "senate"
+  end
+
+  it "converts arrays to sentences" do
+    [1,2,3].to_sentence.should eq "1, 2, and 3"
+    ["jack", "jill"].to_sentence.should eq "jack and jill"
+    ["Something"].to_sentence.should eq "Something"
+    [].to_sentence.should eq ""
+    ["Kinada", "Dwor", "apple", "green"].to_sentence(bold: true).should eq \
+      "\e[1mKinada\e[0m, \e[1mDwor\e[0m, \e[1mapple\e[0m, and \e[1mgreen\e[0m"
+  end
+
+  it "converts string to booleans" do
+    "yes".to_bool.should be_true
+    "no".to_bool.should be_false
+    "f".to_bool.should be_false
+    "t".to_bool.should be_true
+    "true".to_bool.should be_true
+    "foo".to_bool.should be_nil
+  end
+
+  it "identifies if a string represents a boolean" do
+    "yes".boolean?.should be_true
+    "false".boolean?.should be_true
+    "foo".boolean?.should be_false
+  end
+
+  it "identifies if a string represents a numeric" do
+    "3.14".numeric?.should be_true
+    "42".numeric?.should be_true
+    "4.2e2".numeric?.should be_true
+    "foo".numeric?.should be_false
+  end
+
+  it "parses a string into arguments" do
+    "3.14 yes gaga false".args.should eq [3.14, true, "gaga", false]
+    "tia".args.should eq ["tia"]
+    "".args.should eq []
+    "           ".args.should eq []
+  end
+
+end

data/spec/location_spec.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../", __FILE__)
+require "spec_helper"
+
+describe SRSGame::Location do
+  it "instantiates rooms" do
+    name = "some room"
+
+    location = Location.new do |l|
+      l.name = name
+    end
+
+    location.name.should eq name
+    location.inspect.should be_an_instance_of(String)
+  end
+
+  describe "#do" do
+    it "only lets you occupy reality" do
+      location = Location.new # no exits
+      ->{location.go("west")}.should raise_error SRSGame::DirectionError
+      ->{location.go(:down)}.should raise_error SRSGame::DirectionError
+    end
+  end
+
+  describe "#info" do
+    it "describes a room" do
+      class SomeItem < Item
+        name "some item"
+      end
+
+      location = Location.new do |l|
+        l.name = "in a room"
+        l.description = "A picture hangs on the wall."
+        l.items = [SomeItem.new]
+        l.south = L.new
+        l.out = L.new
+      end
+
+      location.info.uncolored.should eq "You find yourself in a room. A picture hangs on the wall." <<
+                                        "\nItems here are some item.\nExits are south and out."
+    end
+  end
+
+  it "looks for items" do
+    class FooItem < Item
+      interactable_as :foo
+    end
+
+    class BarItem < Item
+      interactable_as :bar
+    end
+
+    foo = FooItem.new
+    bar = BarItem.new
+
+    location = Location.new { |l| l.items = [foo, bar] }
+
+    location.item_grep("foo").should eq [foo]
+    location.item_grep("bar").should eq [bar]
+    location.item_grep("baz").should eq []
+    location.item_grep("").should eq []
+  end
+
+  it "has a prompt" do
+    Game.new.prompt.should eq "$ "
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+require "simplecov"
+SimpleCov.start
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+
+require "srs_game/basic"

data/spec/srserver_spec.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../", __FILE__)
+require "spec_helper"
+
+describe SRSGame::SRServer do
+  describe "::new" do
+    it "makes a default server" do
+      server = SRServer.new Basic
+      server.mod.should eq Basic
+      server.host.should eq SRServer::DEFAULT_HOST
+      server.port.should eq SRServer::DEFAULT_PORT
+      server.maxConnections.should eq SRServer::MAX_CONNECTIONS
+    end
+  end
+end

data/srs_game.gemspec

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+# This file is part of SRS GAME <http://github.com/jacksonwillis/srs_game/>.
+
+$LOAD_PATH.unshift File.expand_path("../lib/", __FILE__)
+require "srs_game/version"
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Jackson Willis"]
+  gem.email         = ["jcwillis.school@gmail.com"]
+  gem.description   = "A framework and collection of text-based games"
+  gem.summary       = "A framework and collection of text-based games"
+  gem.homepage      = "http://github.com/jacksonwillis/srs_game"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "srs_game"
+  gem.require_paths = ["lib"]
+  gem.version       = SRSGame::VERSION
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: srs_game
+version: !ruby/object:Gem::Version
+  version: 0.Alexis
+  prerelease: 2
+platform: ruby
+authors:
+- Jackson Willis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-31 00:00:00.000000000 Z
+dependencies: []
+description: A framework and collection of text-based games
+email:
+- jcwillis.school@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile.rb
+- examples/pokemon_clone.rb
+- lib/srs_game.rb
+- lib/srs_game/basic.rb
+- lib/srs_game/tamera.rb
+- lib/srs_game/tia.rb
+- lib/srs_game/version.rb
+- spec/game_spec.rb
+- spec/helpers_spec.rb
+- spec/location_spec.rb
+- spec/spec_helper.rb
+- spec/srserver_spec.rb
+- srs_game.gemspec
+homepage: http://github.com/jacksonwillis/srs_game
+licenses: []
+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.10
+signing_key: 
+specification_version: 3
+summary: A framework and collection of text-based games
+test_files:
+- spec/game_spec.rb
+- spec/helpers_spec.rb
+- spec/location_spec.rb
+- spec/spec_helper.rb
+- spec/srserver_spec.rb
+has_rdoc: