PlayRockPaperScissorsGame 2.4.3 → 2.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73fd45bc0d5ac753551c7a450a0430a5a1c48b0b
-  data.tar.gz: a766b7a3a93320729bb7abab7ac9c9249f5cb92d
+  metadata.gz: 3ed27c6319b475fc6208597675960f3c8d2e4d43
+  data.tar.gz: 2013bc0146fed6a2fc9ba070b2d229e22b616b77
 SHA512:
-  metadata.gz: 1a9f4564eed49b6b1e54855ef152fabd41f4af6a5605118ecc622bbfacbb5a62c68a6736937e72eaf4a0527e0f76e107f9a13df73bd6ba870828ffaabe7f773e
-  data.tar.gz: 1dcbd00613af9ea5f23091b332a342ef6378020659d2613463847e873e0c49b0b7cebe05d2aad35d2e29deb3ced4feda5f9d3722913c5245086d06734c518774
+  metadata.gz: 07a36525c4378a69d4fa4bf682fa018660fda33588b7659baaf110debab57a9a6f4cea59918bcd4356294159091917cbb0eb8d993df0fde2df02c377613904e4
+  data.tar.gz: e41b3d3e3bda1e5bb46dfea08df420903eeb458461e1cc12de89139b3dddab9ff77597075e201cfd326b42d1b285f0e7c52aa3d6627b3b805d8258d337c821af

data/.gitignore

@@ -5,6 +5,7 @@
 *.sublime-workspace
 *.jekyll-metadata
 *master
+*beginner.rb
 # _site
 # .sass-cache
 

data/docs/CODE_OF_CONDUCT.md

@@ -82,4 +82,4 @@ available at [http://contributor-covenant.org/version/1/4][version]
 
 ## Site Nav
 
-[Home](./) | [How to Build](How_to_Build) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [How to Test](Testing)
+[Home](./) | [Comparing Code](Comparing_Code) | [How to Build](How_to_Build) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [How to Test](Testing)

data/docs/CONTRIBUTING.md

@@ -41,4 +41,4 @@ Here are a few things you can do that will increase the likelihood of your pull
 
 ## Site Nav
 
-[Home](./) | [How to Build](How_to_Build) | [Master Code](Code) | [Code of Conduct](CODE_OF_CONDUCT) | [How to Test](Testing.md)
+[Home](./) | [Comparing Code](Comparing_Code) | [How to Build](How_to_Build) | [Master Code](Code) | [Code of Conduct](CODE_OF_CONDUCT) | [How to Test](Testing.md)

data/docs/Code.md

@@ -25,11 +25,10 @@ __`% rps`__
 |====================================|
 =end
 
-
 class PlayRockPaperScissorsGame # define master class
 
   module RockPaperScissors
-    VERSION = "2.4.3" # define version constant
+    VERSION = "2.4.4" # define version constant
   end
   
   # intiate the colorize gem
@@ -70,7 +69,7 @@ class PlayRockPaperScissorsGame # define master class
     end 
   end 
 
-  continue(Constants::INIT_STRINGS[0], Constants::INIT_STRINGS[1], Constants::INIT_STRINGS[2]) # call continue class
+  continue(Constants::INIT_STRINGS[0], Constants::INIT_STRINGS[1], Constants::INIT_STRINGS[2]) # call continue method
 
   def initialize # initialize variables
     @player_score = @computer_score = @ties = 0 
@@ -98,7 +97,7 @@ class PlayRockPaperScissorsGame # define master class
     end
     puts ColorizedString["\nFinal score: player: #{@player_score}, "].colorize(:blue) +
          ColorizedString["computer: #{@computer_score} (ties: #{@ties})"].colorize(:blue)
-	# define a case for the final outcomes  
+    # define a case for the final outcomes  
     case PrivateMethods.final_outcome(@player_score, @computer_score)
     when :WIN 
       puts ColorizedString["Player wins!"].colorize(:red) 
@@ -134,7 +133,7 @@ class PlayRockPaperScissorsGame # define master class
       def player_outcome(plays) # define method for the player's outcome while passing in a parameter of type array
         return :WIN  if Constants::WINNERS.include?(plays) # return a win if the one of the sub-arrays in the winners array is called
         return :LOSE if Constants::LOSERS.include?(plays) # return a loss if any of the mapped sub-arrays in the losers constant is present
-        return :TIE  if !:WIN | !:LOSE # return a tie if not (!x) win or if not loose
+        return :TIE  if !:WIN | !:LOSE # return a tie if not (!) win or if not loose
       end 
       def final_outcome(pl,co) # define final outcome method
         return :WIN  if pl > co 
@@ -155,6 +154,6 @@ PlayRockPaperScissorsGame.new.play(2) # call the play method and pass in 3 (0, 1
 
 ## Site Nav
 
-[Home](./) | [How to Test](Testing) | [How to Build](How_to_Build) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)
+[Home](./) | [Comparing Code](Comparing_Code) | [How to Test](Testing) | [How to Build](How_to_Build) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)
 
 [//]: # (end markdown)

data/docs/Comparing_Code.md

@@ -0,0 +1,228 @@
+---
+layout: default
+title: Comparing Code - Play Rock Paper Scissors Game
+---
+
+[//]: # (start markdown)
+
+# Comparing Beginner's RPS Code to Advanced RPS Code
+
+**Table of Contents**
+
+- [Comparing Beginner's RPS Code to Advanced RPS Code](#comparing-beginners-rps-code-to-advanced-rps-code)
+  - [Beginner's Code](#beginners-code)
+    - [Beginner's Code Pros](#beginners-code-pros)
+    - [Beginner's Code Cons](#beginners-code-cons)
+    - [What Beginner's Code Looks :ike](#what-beginners-code-looks-ike)
+  - [Advanced Code](#advanced-code)
+    - [Advanced Code Pros](#advanced-code-pros)
+    - [Advanced Code Cons](#advanced-code-cons)
+    - [What Advanced Code Looks Like](#what-advanced-code-looks-like)
+  - [Site Nav](#site-nav)
+
+## Beginner's Code
+
+### Beginner's Code Pros
++ Simple
+- Easy to understand
+* Short
+
+### Beginner's Code Cons
++ Unorganized
+- Lacks modularization
+* Many `if`s and `else`s
+
+### What Beginner's Code Looks :ike
+
+__`% ruby beginner.rb`__
+
+[//]: # (end markdown)
+
+[//]: # (start ruby)
+
+```ruby
+options = ["rock", "paper", "scissors"]
+computer_choice = options[rand(options.length)] 
+ # the above line chooses a random pick in the options array, and the `options.length` means to choose from however many options there are in the `options` array
+puts "What's your choice?"
+puts "rock, paper, or scissors"
+user_input = gets.chomp.downcase # `gets.chomp` reads user input, .downcase is like `.toLowerCase()` in javascript
+loop do 
+  if (user_input == "rock" || user_input == "paper" || user_input == "scissors")
+    if (user_input == computer_choice)
+      puts "We got the same, let's keep playing!"
+    elsif (user_input == "rock" && computer_choice == "scissors")
+      puts "computer choice is: " + computer_choice + " , you win! :)"
+    elsif (user_input == "rock" && computer_choice == "paper")
+      puts "computer choice is: " + computer_choice + " ,computer wins :("
+    elsif (user_input == "paper" && computer_choice == "scissors")
+      puts "computer choice is: " + computer_choice + " ,computer wins :("
+    elsif (user_input == "paper" && computer_choice == "rock")
+      puts "computer choice is: " + computer_choice + " , you win! :)"
+    elsif (user_input == "scissors" && computer_choice == "rock")
+      puts "computer choice is: " + computer_choice + " ,computer wins :("
+    elsif (user_input == "scissors" && computer_choice == "paper")
+      puts "computer choice is: " + computer_choice + " , you win! :)"
+    end
+    else 
+    puts "Invalid choice, enter Rock, Paper, or Scissors"
+    puts "What's your choice?"
+    user_input = gets.chomp.downcase # have the user choose again
+  end
+  break # break the loop after all the above has been completed
+end
+```
+[//]: # (end ruby)
+[//]: # (start markdown)
+## Advanced Code
+
+### Advanced Code Pros
+
++ Organized
+- Modularized
+* Structured
+
+### Advanced Code Cons
+
++ Long
+- Hard to understand
+
+### What Advanced Code Looks Like
+
+__`% ruby advanced.rb`__
+
+[//]: # (end markdown)
+
+[//]: # (start ruby)
+```ruby
+class PlayRockPaperScissorsGame # define master class
+  
+  # intiate the colorize gem
+  require "colorized_string"
+  ColorizedString.colors # import colors; ex: red, green, blue
+  ColorizedString.modes  # import modes; ex: bold, italic, underline
+
+  module Constants 
+    NTRY_TO_SYM = { # define constants from an entry to a symbol class
+      'p' => :PAPER, 
+      'r' => :ROCK, 
+      's' => :SCISSORS 
+    } 
+    VALID_ENTRIES = NTRY_TO_SYM.keys # create valid entries
+    COMPUTER_CHOICES = NTRY_TO_SYM.values # define computer choices
+    WINNERS = [ # define winners
+      # format: player choice, computer choice
+      [:SCISSORS, :PAPER], 
+      [:PAPER   , :ROCK], 
+      [:ROCK    , :SCISSORS]
+    ] 
+    LOSERS = WINNERS.map { |pc,cc| [cc,pc] } # this will take the original WINNERS array and flip the symbols, thus returning a loss for the user/player
+    INIT_STRINGS = [
+      ColorizedString["You are about to enter a rock-paper-scissors best of 3 match."].colorize(:green), 
+      ColorizedString["Press the return/enter key to continue..."].colorize(:green), 
+      ""
+    ]
+  end
+
+  protected_methods :Constants # make the constants module protected
+
+  class << self # define a self calling method within the parent class
+    def continue(str1,str2,str3) # pass in 3 parameters
+      puts  ColorizedString[str1].colorize(:color => :green) 
+      print ColorizedString[str2].colorize(:color => :green)
+      gets # press enter or return to continue
+      puts  str3
+    end 
+  end 
+
+  continue(Constants::INIT_STRINGS[0], Constants::INIT_STRINGS[1], Constants::INIT_STRINGS[2]) # call continue method
+
+  def initialize # initialize variables
+    @player_score = @computer_score = @ties = 0 
+  end 
+  def play(winning_score) 
+    while @player_score < winning_score && @computer_score < winning_score # both the computer's score and the player's score have to be less than the value passed in for the winning score at the end
+      puts ColorizedString["Player score: #{@player_score}, "].colorize(:blue) + 
+           ColorizedString["Computer score: #{@computer_score}, Ties: #{@ties}"].colorize(:blue) 
+      player = PrivateMethods.player_choice 
+      computer = Constants::COMPUTER_CHOICES.sample # chooses a "random" option
+      puts ColorizedString["\nPlayer chooses #{player.to_s.downcase}"].colorize(:blue) 
+      puts ColorizedString["Computer chooses #{computer.to_s.downcase}"].colorize(:blue)
+      case PrivateMethods.player_outcome [player, computer] # define a reference call for player and computer for the arrays called in the player_outcome method
+      when :WIN
+        puts ColorizedString["#{player.to_s.capitalize} beats #{computer.to_s.downcase}, player wins the round"].colorize(:red) 
+        @player_score += 1 # @player_score = @player_score + 1
+      when :LOSE
+        puts ColorizedString["#{computer.to_s.capitalize} beats #{player.to_s.downcase}, computer wins the round"].colorize(:red)
+        @computer_score += 1 
+      else # since there is only 1 option left, there is no need to define when :TIE
+        puts ColorizedString["Tie, choose again"].colorize(:red) 
+        @ties += 1
+        # since tie is not in the original pass-in argument for the while loop, it will not be affected by the winning score
+      end
+    end
+    puts ColorizedString["\nFinal score: player: #{@player_score}, "].colorize(:blue) +
+         ColorizedString["computer: #{@computer_score} (ties: #{@ties})"].colorize(:blue)
+    # define a case for the final outcomes  
+    case PrivateMethods.final_outcome(@player_score, @computer_score)
+    when :WIN 
+      puts ColorizedString["Player wins!"].colorize(:red) 
+    when :LOSE
+      puts ColorizedString["Computer wins!"].colorize(:red)
+    else 
+      puts ColorizedString["It's a tie!"].colorize(:red) 
+    end 
+    gets
+  end 
+
+  module PrivateMethods 
+    class << self # make all methods below self calling methods of this class (PlayRockPaperScissorsGame) so that the other methods will not to call their parents of these methods
+      def player_choice
+        loop do # for loop with no arguments passed in
+          print ColorizedString["Choose rock (r), paper (p) or scissors (s): "].colorize(:green)
+          choice = gets.chomp.downcase # read user input and convert all to lower case
+          # define valid and invalid entries by using an if else-if statement(s)
+          if Constants::NTRY_TO_SYM.key?(choice) # if the NTRY_TO_SYM array's key is one of the keys defined in the original array
+            return Constants::NTRY_TO_SYM[choice] # return the users choice
+          elsif choice != Constants::VALID_ENTRIES # else if it is not one of the valid entries...
+            puts ColorizedString["That entry is invalid. Please re-enter."].colorize(:red) # return an error message
+          end
+          # # one may also do this (albeit more useless):
+          # case
+          # when Constants::NTRY_TO_SYM.key?(choice)
+          #   return Constants::NTRY_TO_SYM[choice]
+          # when choice != Constants::VALID_ENTRIES
+          #   puts ColorizedString["That entry is invalid. Please re-enter."].colorize(:green) 
+          # end
+        end 
+      end 
+      def player_outcome(plays) # define method for the player's outcome while passing in a parameter of type array
+        return :WIN  if Constants::WINNERS.include?(plays) # return a win if the one of the sub-arrays in the winners array is called
+        return :LOSE if Constants::LOSERS.include?(plays) # return a loss if any of the mapped sub-arrays in the losers constant is present
+        return :TIE  if !:WIN | !:LOSE # return a tie if not (!) win or if not loose
+      end 
+      def final_outcome(pl,co) # define final outcome method
+        return :WIN  if pl > co 
+        return :LOSE if pl < co
+        return :TIE  if pl = co # this can never happen due to the code in the play method, but it is worth noting
+      end 
+    end
+  end
+  
+  private_methods :PrivateMethods # make the PrivateMethods module private
+
+end 
+
+PlayRockPaperScissorsGame.new.play(2) # call the play method and pass in 3 (0, 1, 2) for the winning score
+```
+[//]: # (end ruby)
+
+[//]: # (start markdown)
+
+------------
+
+## Site Nav
+
+[Home](./) | [Master Code](Code) | [How to Test](Testing) | [How to Build](How_to_Build) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)
+
+[//]: # (end markdown)

data/docs/How_to_Build.md

@@ -25,4 +25,4 @@ title: How to Build - Play Rock Paper Scissors Game
 
 ## Site Nav 
 
-[Home](./) | [How to Test](Testing) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)
+[Home](./) | [Comparing Code](Comparing_Code) | [How to Test](Testing) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)

data/docs/Testing.md

@@ -22,4 +22,4 @@ What you will need
 
 ## Site Nav
 
-[Home](./) | [How to Build](How_to_Build) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)
+[Home](./) | [Comparing Code](Comparing_Code) | [How to Build](How_to_Build) | [Master Code](Code) | [Contributing](CONTRIBUTING) | [Code of Conduct](CODE_OF_CONDUCT)

data/docs/_layouts/default.html

@@ -8,6 +8,8 @@
     <meta name="theme-color" content="#157878">
     <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
     <link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
+    <link rel="stylesheet" href="assets/css/pace.css" />
+    <script src="assets/js/pace.min.js"></script>
   </head>
   <body>
     <section class="page-header">

data/docs/_site/CODE_OF_CONDUCT.html

@@ -7,7 +7,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="theme-color" content="#157878">
     <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
-    <link rel="stylesheet" href="/assets/css/style.css?v=b9b8e81243f85ef7e306bbe53b23572f793119fb">
+    <link rel="stylesheet" href="/assets/css/style.css?v=ddb92b73967ef3a920af7c36e2a3cb938bfc1f06">
+    <link rel="stylesheet" href="assets/css/pace.css" />
+    <script src="assets/js/pace.min.js"></script>
   </head>
   <body>
     <section class="page-header">
@@ -115,6 +117,7 @@ available at <a href="http://contributor-covenant.org/version/1/4/">http://contr
   <tbody>
     <tr>
       <td><a href="./">Home</a></td>
+      <td><a href="Comparing_Code">Comparing Code</a></td>
       <td><a href="How_to_Build">How to Build</a></td>
       <td><a href="Code">Master Code</a></td>
       <td><a href="CONTRIBUTING">Contributing</a></td>

data/docs/_site/CONTRIBUTING.html

@@ -7,7 +7,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="theme-color" content="#157878">
     <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
-    <link rel="stylesheet" href="/assets/css/style.css?v=b9b8e81243f85ef7e306bbe53b23572f793119fb">
+    <link rel="stylesheet" href="/assets/css/style.css?v=ddb92b73967ef3a920af7c36e2a3cb938bfc1f06">
+    <link rel="stylesheet" href="assets/css/pace.css" />
+    <script src="assets/js/pace.min.js"></script>
   </head>
   <body>
     <section class="page-header">
@@ -74,6 +76,7 @@
   <tbody>
     <tr>
       <td><a href="./">Home</a></td>
+      <td><a href="Comparing_Code">Comparing Code</a></td>
       <td><a href="How_to_Build">How to Build</a></td>
       <td><a href="Code">Master Code</a></td>
       <td><a href="CODE_OF_CONDUCT">Code of Conduct</a></td>

data/docs/_site/Code.html

@@ -7,7 +7,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="theme-color" content="#157878">
     <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
-    <link rel="stylesheet" href="/assets/css/style.css?v=b9b8e81243f85ef7e306bbe53b23572f793119fb">
+    <link rel="stylesheet" href="/assets/css/style.css?v=ddb92b73967ef3a920af7c36e2a3cb938bfc1f06">
+    <link rel="stylesheet" href="assets/css/pace.css" />
+    <script src="assets/js/pace.min.js"></script>
   </head>
   <body>
     <section class="page-header">
@@ -48,11 +50,10 @@
 |====================================|
 =end</span>
 
-
 <span class="k">class</span> <span class="nc">PlayRockPaperScissorsGame</span> <span class="c1"># define master class</span>
 
   <span class="k">module</span> <span class="nn">RockPaperScissors</span>
-    <span class="no">VERSION</span> <span class="o">=</span> <span class="s2">"2.4.3"</span> <span class="c1"># define version constant</span>
+    <span class="no">VERSION</span> <span class="o">=</span> <span class="s2">"2.4.4"</span> <span class="c1"># define version constant</span>
   <span class="k">end</span>
   
   <span class="c1"># intiate the colorize gem</span>
@@ -93,7 +94,7 @@
     <span class="k">end</span> 
   <span class="k">end</span> 
 
-  <span class="n">continue</span><span class="p">(</span><span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span> <span class="c1"># call continue class</span>
+  <span class="n">continue</span><span class="p">(</span><span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span> <span class="c1"># call continue method</span>
 
   <span class="k">def</span> <span class="nf">initialize</span> <span class="c1"># initialize variables</span>
     <span class="vi">@player_score</span> <span class="o">=</span> <span class="vi">@computer_score</span> <span class="o">=</span> <span class="vi">@ties</span> <span class="o">=</span> <span class="mi">0</span> 
@@ -121,7 +122,7 @@
     <span class="k">end</span>
     <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"</span><span class="se">\n</span><span class="s2">Final score: player: </span><span class="si">#{</span><span class="vi">@player_score</span><span class="si">}</span><span class="s2">, "</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span> <span class="o">+</span>
          <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"computer: </span><span class="si">#{</span><span class="vi">@computer_score</span><span class="si">}</span><span class="s2"> (ties: </span><span class="si">#{</span><span class="vi">@ties</span><span class="si">}</span><span class="s2">)"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span>
-	<span class="c1"># define a case for the final outcomes  </span>
+    <span class="c1"># define a case for the final outcomes  </span>
     <span class="k">case</span> <span class="no">PrivateMethods</span><span class="p">.</span><span class="nf">final_outcome</span><span class="p">(</span><span class="vi">@player_score</span><span class="p">,</span> <span class="vi">@computer_score</span><span class="p">)</span>
     <span class="k">when</span> <span class="ss">:WIN</span> 
       <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Player wins!"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> 
@@ -157,7 +158,7 @@
       <span class="k">def</span> <span class="nf">player_outcome</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># define method for the player's outcome while passing in a parameter of type array</span>
         <span class="k">return</span> <span class="ss">:WIN</span>  <span class="k">if</span> <span class="no">Constants</span><span class="o">::</span><span class="no">WINNERS</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># return a win if the one of the sub-arrays in the winners array is called</span>
         <span class="k">return</span> <span class="ss">:LOSE</span> <span class="k">if</span> <span class="no">Constants</span><span class="o">::</span><span class="no">LOSERS</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># return a loss if any of the mapped sub-arrays in the losers constant is present</span>
-        <span class="k">return</span> <span class="ss">:TIE</span>  <span class="k">if</span> <span class="o">!</span><span class="ss">:WIN</span> <span class="o">|</span> <span class="o">!</span><span class="ss">:LOSE</span> <span class="c1"># return a tie if not (!x) win or if not loose</span>
+        <span class="k">return</span> <span class="ss">:TIE</span>  <span class="k">if</span> <span class="o">!</span><span class="ss">:WIN</span> <span class="o">|</span> <span class="o">!</span><span class="ss">:LOSE</span> <span class="c1"># return a tie if not (!) win or if not loose</span>
       <span class="k">end</span> 
       <span class="k">def</span> <span class="nf">final_outcome</span><span class="p">(</span><span class="n">pl</span><span class="p">,</span><span class="n">co</span><span class="p">)</span> <span class="c1"># define final outcome method</span>
         <span class="k">return</span> <span class="ss">:WIN</span>  <span class="k">if</span> <span class="n">pl</span> <span class="o">&gt;</span> <span class="n">co</span> 
@@ -183,6 +184,7 @@
   <tbody>
     <tr>
       <td><a href="./">Home</a></td>
+      <td><a href="Comparing_Code">Comparing Code</a></td>
       <td><a href="Testing">How to Test</a></td>
       <td><a href="How_to_Build">How to Build</a></td>
       <td><a href="CONTRIBUTING">Contributing</a></td>

data/docs/_site/Comparing_Code.html

@@ -0,0 +1,296 @@
+<!DOCTYPE html>
+<html lang="en-us">
+  <head>
+    <meta charset="UTF-8">
+    <title>Comparing Code - Play Rock Paper Scissors Game</title>
+    <meta name="description" content="A Ruby Programmed Rock Paper Scissors Game"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="theme-color" content="#157878">
+    <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
+    <link rel="stylesheet" href="/assets/css/style.css?v=ddb92b73967ef3a920af7c36e2a3cb938bfc1f06">
+    <link rel="stylesheet" href="assets/css/pace.css" />
+    <script src="assets/js/pace.min.js"></script>
+  </head>
+  <body>
+    <section class="page-header">
+      <h1 class="project-name">Play Rock Paper Scissors Game</h1>
+      <h2 class="project-tagline">A Ruby Programmed Rock Paper Scissors Game</h2>
+      
+        <a href="http://github.com/bag3318/RockPaperScissors" class="btn">View on GitHub</a>
+        <a href="http://github.com/bag3318/RockPaperScissors/issues" class="btn">Report a Bug</a>
+      
+      
+        <a href="http://github.com/bag3318/RockPaperScissors/zipball/gh-pages" class="btn">Download .zip</a>
+        <a href="http://github.com/bag3318/RockPaperScissors/tarball/gh-pages" class="btn">Download .tar.gz</a>
+      
+      <br/>
+      
+        <a href="#site-nav" class="btn">Site Nav</a>
+      
+      
+        <a href="./" class="btn">Home</a>
+      
+    </section>
+
+    <section class="main-content">
+      
+<h1 id="comparing-beginners-rps-code-to-advanced-rps-code">Comparing Beginner’s RPS Code to Advanced RPS Code</h1>
+
+<p><strong>Table of Contents</strong></p>
+
+<ul>
+  <li><a href="#comparing-beginners-rps-code-to-advanced-rps-code">Comparing Beginner’s RPS Code to Advanced RPS Code</a>
+    <ul>
+      <li><a href="#beginners-code">Beginner’s Code</a>
+        <ul>
+          <li><a href="#beginners-code-pros">Beginner’s Code Pros</a></li>
+          <li><a href="#beginners-code-cons">Beginner’s Code Cons</a></li>
+          <li><a href="#what-beginners-code-looks-ike">What Beginner’s Code Looks :ike</a></li>
+        </ul>
+      </li>
+      <li><a href="#advanced-code">Advanced Code</a>
+        <ul>
+          <li><a href="#advanced-code-pros">Advanced Code Pros</a></li>
+          <li><a href="#advanced-code-cons">Advanced Code Cons</a></li>
+          <li><a href="#what-advanced-code-looks-like">What Advanced Code Looks Like</a></li>
+        </ul>
+      </li>
+      <li><a href="#site-nav">Site Nav</a></li>
+    </ul>
+  </li>
+</ul>
+
+<h2 id="beginners-code">Beginner’s Code</h2>
+
+<h3 id="beginners-code-pros">Beginner’s Code Pros</h3>
+<ul>
+  <li>Simple</li>
+  <li>Easy to understand</li>
+  <li>Short</li>
+</ul>
+
+<h3 id="beginners-code-cons">Beginner’s Code Cons</h3>
+<ul>
+  <li>Unorganized</li>
+  <li>Lacks modularization</li>
+  <li>Many <code class="highlighter-rouge">if</code>s and <code class="highlighter-rouge">else</code>s</li>
+</ul>
+
+<h3 id="what-beginners-code-looks-ike">What Beginner’s Code Looks :ike</h3>
+
+<p><strong><code class="highlighter-rouge">% ruby beginner.rb</code></strong></p>
+
+<div class="language-ruby highlighter-rouge"><pre class="highlight"><code><span class="n">options</span> <span class="o">=</span> <span class="p">[</span><span class="s2">"rock"</span><span class="p">,</span> <span class="s2">"paper"</span><span class="p">,</span> <span class="s2">"scissors"</span><span class="p">]</span>
+<span class="n">computer_choice</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="nb">rand</span><span class="p">(</span><span class="n">options</span><span class="p">.</span><span class="nf">length</span><span class="p">)]</span> 
+ <span class="c1"># the above line chooses a random pick in the options array, and the `options.length` means to choose from however many options there are in the `options` array</span>
+<span class="nb">puts</span> <span class="s2">"What's your choice?"</span>
+<span class="nb">puts</span> <span class="s2">"rock, paper, or scissors"</span>
+<span class="n">user_input</span> <span class="o">=</span> <span class="nb">gets</span><span class="p">.</span><span class="nf">chomp</span><span class="p">.</span><span class="nf">downcase</span> <span class="c1"># `gets.chomp` reads user input, .downcase is like `.toLowerCase()` in javascript</span>
+<span class="kp">loop</span> <span class="k">do</span> 
+  <span class="k">if</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"rock"</span> <span class="o">||</span> <span class="n">user_input</span> <span class="o">==</span> <span class="s2">"paper"</span> <span class="o">||</span> <span class="n">user_input</span> <span class="o">==</span> <span class="s2">"scissors"</span><span class="p">)</span>
+    <span class="k">if</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="n">computer_choice</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"We got the same, let's keep playing!"</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"rock"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"scissors"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" , you win! :)"</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"rock"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"paper"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" ,computer wins :("</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"paper"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"scissors"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" ,computer wins :("</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"paper"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"rock"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" , you win! :)"</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"scissors"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"rock"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" ,computer wins :("</span>
+    <span class="k">elsif</span> <span class="p">(</span><span class="n">user_input</span> <span class="o">==</span> <span class="s2">"scissors"</span> <span class="o">&amp;&amp;</span> <span class="n">computer_choice</span> <span class="o">==</span> <span class="s2">"paper"</span><span class="p">)</span>
+      <span class="nb">puts</span> <span class="s2">"computer choice is: "</span> <span class="o">+</span> <span class="n">computer_choice</span> <span class="o">+</span> <span class="s2">" , you win! :)"</span>
+    <span class="k">end</span>
+    <span class="k">else</span> 
+    <span class="nb">puts</span> <span class="s2">"Invalid choice, enter Rock, Paper, or Scissors"</span>
+    <span class="nb">puts</span> <span class="s2">"What's your choice?"</span>
+    <span class="n">user_input</span> <span class="o">=</span> <span class="nb">gets</span><span class="p">.</span><span class="nf">chomp</span><span class="p">.</span><span class="nf">downcase</span> <span class="c1"># have the user choose again</span>
+  <span class="k">end</span>
+  <span class="k">break</span> <span class="c1"># break the loop after all the above has been completed</span>
+<span class="k">end</span>
+</code></pre>
+</div>
+<h2 id="advanced-code">Advanced Code</h2>
+
+<h3 id="advanced-code-pros">Advanced Code Pros</h3>
+
+<ul>
+  <li>Organized</li>
+  <li>Modularized</li>
+  <li>Structured</li>
+</ul>
+
+<h3 id="advanced-code-cons">Advanced Code Cons</h3>
+
+<ul>
+  <li>Long</li>
+  <li>Hard to understand</li>
+</ul>
+
+<h3 id="what-advanced-code-looks-like">What Advanced Code Looks Like</h3>
+
+<p><strong><code class="highlighter-rouge">% ruby advanced.rb</code></strong></p>
+
+<div class="language-ruby highlighter-rouge"><pre class="highlight"><code><span class="k">class</span> <span class="nc">PlayRockPaperScissorsGame</span> <span class="c1"># define master class</span>
+  
+  <span class="c1"># intiate the colorize gem</span>
+  <span class="nb">require</span> <span class="s2">"colorized_string"</span>
+  <span class="no">ColorizedString</span><span class="p">.</span><span class="nf">colors</span> <span class="c1"># import colors; ex: red, green, blue</span>
+  <span class="no">ColorizedString</span><span class="p">.</span><span class="nf">modes</span>  <span class="c1"># import modes; ex: bold, italic, underline</span>
+
+  <span class="k">module</span> <span class="nn">Constants</span> 
+    <span class="no">NTRY_TO_SYM</span> <span class="o">=</span> <span class="p">{</span> <span class="c1"># define constants from an entry to a symbol class</span>
+      <span class="s1">'p'</span> <span class="o">=&gt;</span> <span class="ss">:PAPER</span><span class="p">,</span> 
+      <span class="s1">'r'</span> <span class="o">=&gt;</span> <span class="ss">:ROCK</span><span class="p">,</span> 
+      <span class="s1">'s'</span> <span class="o">=&gt;</span> <span class="ss">:SCISSORS</span> 
+    <span class="p">}</span> 
+    <span class="no">VALID_ENTRIES</span> <span class="o">=</span> <span class="no">NTRY_TO_SYM</span><span class="p">.</span><span class="nf">keys</span> <span class="c1"># create valid entries</span>
+    <span class="no">COMPUTER_CHOICES</span> <span class="o">=</span> <span class="no">NTRY_TO_SYM</span><span class="p">.</span><span class="nf">values</span> <span class="c1"># define computer choices</span>
+    <span class="no">WINNERS</span> <span class="o">=</span> <span class="p">[</span> <span class="c1"># define winners</span>
+      <span class="c1"># format: player choice, computer choice</span>
+      <span class="p">[</span><span class="ss">:SCISSORS</span><span class="p">,</span> <span class="ss">:PAPER</span><span class="p">],</span> 
+      <span class="p">[</span><span class="ss">:PAPER</span>   <span class="p">,</span> <span class="ss">:ROCK</span><span class="p">],</span> 
+      <span class="p">[</span><span class="ss">:ROCK</span>    <span class="p">,</span> <span class="ss">:SCISSORS</span><span class="p">]</span>
+    <span class="p">]</span> 
+    <span class="no">LOSERS</span> <span class="o">=</span> <span class="no">WINNERS</span><span class="p">.</span><span class="nf">map</span> <span class="p">{</span> <span class="o">|</span><span class="n">pc</span><span class="p">,</span><span class="n">cc</span><span class="o">|</span> <span class="p">[</span><span class="n">cc</span><span class="p">,</span><span class="n">pc</span><span class="p">]</span> <span class="p">}</span> <span class="c1"># this will take the original WINNERS array and flip the symbols, thus returning a loss for the user/player</span>
+    <span class="no">INIT_STRINGS</span> <span class="o">=</span> <span class="p">[</span>
+      <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"You are about to enter a rock-paper-scissors best of 3 match."</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:green</span><span class="p">),</span> 
+      <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Press the return/enter key to continue..."</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:green</span><span class="p">),</span> 
+      <span class="s2">""</span>
+    <span class="p">]</span>
+  <span class="k">end</span>
+
+  <span class="nb">protected_methods</span> <span class="ss">:Constants</span> <span class="c1"># make the constants module protected</span>
+
+  <span class="k">class</span> <span class="o">&lt;&lt;</span> <span class="nb">self</span> <span class="c1"># define a self calling method within the parent class</span>
+    <span class="k">def</span> <span class="nf">continue</span><span class="p">(</span><span class="n">str1</span><span class="p">,</span><span class="n">str2</span><span class="p">,</span><span class="n">str3</span><span class="p">)</span> <span class="c1"># pass in 3 parameters</span>
+      <span class="nb">puts</span>  <span class="no">ColorizedString</span><span class="p">[</span><span class="n">str1</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:color</span> <span class="o">=&gt;</span> <span class="ss">:green</span><span class="p">)</span> 
+      <span class="nb">print</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="n">str2</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:color</span> <span class="o">=&gt;</span> <span class="ss">:green</span><span class="p">)</span>
+      <span class="nb">gets</span> <span class="c1"># press enter or return to continue</span>
+      <span class="nb">puts</span>  <span class="n">str3</span>
+    <span class="k">end</span> 
+  <span class="k">end</span> 
+
+  <span class="n">continue</span><span class="p">(</span><span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="no">Constants</span><span class="o">::</span><span class="no">INIT_STRINGS</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span> <span class="c1"># call continue method</span>
+
+  <span class="k">def</span> <span class="nf">initialize</span> <span class="c1"># initialize variables</span>
+    <span class="vi">@player_score</span> <span class="o">=</span> <span class="vi">@computer_score</span> <span class="o">=</span> <span class="vi">@ties</span> <span class="o">=</span> <span class="mi">0</span> 
+  <span class="k">end</span> 
+  <span class="k">def</span> <span class="nf">play</span><span class="p">(</span><span class="n">winning_score</span><span class="p">)</span> 
+    <span class="k">while</span> <span class="vi">@player_score</span> <span class="o">&lt;</span> <span class="n">winning_score</span> <span class="o">&amp;&amp;</span> <span class="vi">@computer_score</span> <span class="o">&lt;</span> <span class="n">winning_score</span> <span class="c1"># both the computer's score and the player's score have to be less than the value passed in for the winning score at the end</span>
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Player score: </span><span class="si">#{</span><span class="vi">@player_score</span><span class="si">}</span><span class="s2">, "</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span> <span class="o">+</span> 
+           <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Computer score: </span><span class="si">#{</span><span class="vi">@computer_score</span><span class="si">}</span><span class="s2">, Ties: </span><span class="si">#{</span><span class="vi">@ties</span><span class="si">}</span><span class="s2">"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span> 
+      <span class="n">player</span> <span class="o">=</span> <span class="no">PrivateMethods</span><span class="p">.</span><span class="nf">player_choice</span> 
+      <span class="n">computer</span> <span class="o">=</span> <span class="no">Constants</span><span class="o">::</span><span class="no">COMPUTER_CHOICES</span><span class="p">.</span><span class="nf">sample</span> <span class="c1"># chooses a "random" option</span>
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"</span><span class="se">\n</span><span class="s2">Player chooses </span><span class="si">#{</span><span class="n">player</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">downcase</span><span class="si">}</span><span class="s2">"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span> 
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Computer chooses </span><span class="si">#{</span><span class="n">computer</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">downcase</span><span class="si">}</span><span class="s2">"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span>
+      <span class="k">case</span> <span class="no">PrivateMethods</span><span class="p">.</span><span class="nf">player_outcome</span> <span class="p">[</span><span class="n">player</span><span class="p">,</span> <span class="n">computer</span><span class="p">]</span> <span class="c1"># define a reference call for player and computer for the arrays called in the player_outcome method</span>
+      <span class="k">when</span> <span class="ss">:WIN</span>
+        <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"</span><span class="si">#{</span><span class="n">player</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">capitalize</span><span class="si">}</span><span class="s2"> beats </span><span class="si">#{</span><span class="n">computer</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">downcase</span><span class="si">}</span><span class="s2">, player wins the round"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> 
+        <span class="vi">@player_score</span> <span class="o">+=</span> <span class="mi">1</span> <span class="c1"># @player_score = @player_score + 1</span>
+      <span class="k">when</span> <span class="ss">:LOSE</span>
+        <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"</span><span class="si">#{</span><span class="n">computer</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">capitalize</span><span class="si">}</span><span class="s2"> beats </span><span class="si">#{</span><span class="n">player</span><span class="p">.</span><span class="nf">to_s</span><span class="p">.</span><span class="nf">downcase</span><span class="si">}</span><span class="s2">, computer wins the round"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span>
+        <span class="vi">@computer_score</span> <span class="o">+=</span> <span class="mi">1</span> 
+      <span class="k">else</span> <span class="c1"># since there is only 1 option left, there is no need to define when :TIE</span>
+        <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Tie, choose again"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> 
+        <span class="vi">@ties</span> <span class="o">+=</span> <span class="mi">1</span>
+        <span class="c1"># since tie is not in the original pass-in argument for the while loop, it will not be affected by the winning score</span>
+      <span class="k">end</span>
+    <span class="k">end</span>
+    <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"</span><span class="se">\n</span><span class="s2">Final score: player: </span><span class="si">#{</span><span class="vi">@player_score</span><span class="si">}</span><span class="s2">, "</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span> <span class="o">+</span>
+         <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"computer: </span><span class="si">#{</span><span class="vi">@computer_score</span><span class="si">}</span><span class="s2"> (ties: </span><span class="si">#{</span><span class="vi">@ties</span><span class="si">}</span><span class="s2">)"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:blue</span><span class="p">)</span>
+    <span class="c1"># define a case for the final outcomes  </span>
+    <span class="k">case</span> <span class="no">PrivateMethods</span><span class="p">.</span><span class="nf">final_outcome</span><span class="p">(</span><span class="vi">@player_score</span><span class="p">,</span> <span class="vi">@computer_score</span><span class="p">)</span>
+    <span class="k">when</span> <span class="ss">:WIN</span> 
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Player wins!"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> 
+    <span class="k">when</span> <span class="ss">:LOSE</span>
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Computer wins!"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span>
+    <span class="k">else</span> 
+      <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"It's a tie!"</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> 
+    <span class="k">end</span> 
+    <span class="nb">gets</span>
+  <span class="k">end</span> 
+
+  <span class="k">module</span> <span class="nn">PrivateMethods</span> 
+    <span class="k">class</span> <span class="o">&lt;&lt;</span> <span class="nb">self</span> <span class="c1"># make all methods below self calling methods of this class (PlayRockPaperScissorsGame) so that the other methods will not to call their parents of these methods</span>
+      <span class="k">def</span> <span class="nf">player_choice</span>
+        <span class="kp">loop</span> <span class="k">do</span> <span class="c1"># for loop with no arguments passed in</span>
+          <span class="nb">print</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"Choose rock (r), paper (p) or scissors (s): "</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:green</span><span class="p">)</span>
+          <span class="n">choice</span> <span class="o">=</span> <span class="nb">gets</span><span class="p">.</span><span class="nf">chomp</span><span class="p">.</span><span class="nf">downcase</span> <span class="c1"># read user input and convert all to lower case</span>
+          <span class="c1"># define valid and invalid entries by using an if else-if statement(s)</span>
+          <span class="k">if</span> <span class="no">Constants</span><span class="o">::</span><span class="no">NTRY_TO_SYM</span><span class="p">.</span><span class="nf">key?</span><span class="p">(</span><span class="n">choice</span><span class="p">)</span> <span class="c1"># if the NTRY_TO_SYM array's key is one of the keys defined in the original array</span>
+            <span class="k">return</span> <span class="no">Constants</span><span class="o">::</span><span class="no">NTRY_TO_SYM</span><span class="p">[</span><span class="n">choice</span><span class="p">]</span> <span class="c1"># return the users choice</span>
+          <span class="k">elsif</span> <span class="n">choice</span> <span class="o">!=</span> <span class="no">Constants</span><span class="o">::</span><span class="no">VALID_ENTRIES</span> <span class="c1"># else if it is not one of the valid entries...</span>
+            <span class="nb">puts</span> <span class="no">ColorizedString</span><span class="p">[</span><span class="s2">"That entry is invalid. Please re-enter."</span><span class="p">].</span><span class="nf">colorize</span><span class="p">(</span><span class="ss">:red</span><span class="p">)</span> <span class="c1"># return an error message</span>
+          <span class="k">end</span>
+          <span class="c1"># # one may also do this (albeit more useless):</span>
+          <span class="c1"># case</span>
+          <span class="c1"># when Constants::NTRY_TO_SYM.key?(choice)</span>
+          <span class="c1">#   return Constants::NTRY_TO_SYM[choice]</span>
+          <span class="c1"># when choice != Constants::VALID_ENTRIES</span>
+          <span class="c1">#   puts ColorizedString["That entry is invalid. Please re-enter."].colorize(:green) </span>
+          <span class="c1"># end</span>
+        <span class="k">end</span> 
+      <span class="k">end</span> 
+      <span class="k">def</span> <span class="nf">player_outcome</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># define method for the player's outcome while passing in a parameter of type array</span>
+        <span class="k">return</span> <span class="ss">:WIN</span>  <span class="k">if</span> <span class="no">Constants</span><span class="o">::</span><span class="no">WINNERS</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># return a win if the one of the sub-arrays in the winners array is called</span>
+        <span class="k">return</span> <span class="ss">:LOSE</span> <span class="k">if</span> <span class="no">Constants</span><span class="o">::</span><span class="no">LOSERS</span><span class="p">.</span><span class="nf">include?</span><span class="p">(</span><span class="n">plays</span><span class="p">)</span> <span class="c1"># return a loss if any of the mapped sub-arrays in the losers constant is present</span>
+        <span class="k">return</span> <span class="ss">:TIE</span>  <span class="k">if</span> <span class="o">!</span><span class="ss">:WIN</span> <span class="o">|</span> <span class="o">!</span><span class="ss">:LOSE</span> <span class="c1"># return a tie if not (!) win or if not loose</span>
+      <span class="k">end</span> 
+      <span class="k">def</span> <span class="nf">final_outcome</span><span class="p">(</span><span class="n">pl</span><span class="p">,</span><span class="n">co</span><span class="p">)</span> <span class="c1"># define final outcome method</span>
+        <span class="k">return</span> <span class="ss">:WIN</span>  <span class="k">if</span> <span class="n">pl</span> <span class="o">&gt;</span> <span class="n">co</span> 
+        <span class="k">return</span> <span class="ss">:LOSE</span> <span class="k">if</span> <span class="n">pl</span> <span class="o">&lt;</span> <span class="n">co</span>
+        <span class="k">return</span> <span class="ss">:TIE</span>  <span class="k">if</span> <span class="n">pl</span> <span class="o">=</span> <span class="n">co</span> <span class="c1"># this can never happen due to the code in the play method, but it is worth noting</span>
+      <span class="k">end</span> 
+    <span class="k">end</span>
+  <span class="k">end</span>
+  
+  <span class="nb">private_methods</span> <span class="ss">:PrivateMethods</span> <span class="c1"># make the PrivateMethods module private</span>
+
+<span class="k">end</span> 
+
+<span class="no">PlayRockPaperScissorsGame</span><span class="p">.</span><span class="nf">new</span><span class="p">.</span><span class="nf">play</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span> <span class="c1"># call the play method and pass in 3 (0, 1, 2) for the winning score</span>
+</code></pre>
+</div>
+
+<hr />
+
+<h2 id="site-nav">Site Nav</h2>
+
+<table>
+  <tbody>
+    <tr>
+      <td><a href="./">Home</a></td>
+      <td><a href="Code">Master Code</a></td>
+      <td><a href="Testing">How to Test</a></td>
+      <td><a href="How_to_Build">How to Build</a></td>
+      <td><a href="CONTRIBUTING">Contributing</a></td>
+      <td><a href="CODE_OF_CONDUCT">Code of Conduct</a></td>
+    </tr>
+  </tbody>
+</table>
+
+
+
+      <footer class="site-footer">
+        
+          <span class="site-footer-owner"><a href="http://github.com/bag3318/RockPaperScissors">RockPaperScissors</a> is maintained by <a href="http://github.com/bag3318">bag3318</a>.</span>
+        
+      </footer>
+    </section>
+
+    
+      <script type="text/javascript">
+        (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+        (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+        m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+        })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+        ga('create', 'true', 'auto');
+        ga('send', 'pageview');
+      </script>
+    
+  </body>
+</html>