studio_game_2021 1.0.0

data/spec/studio_game/player_spec.rb

@@ -0,0 +1,165 @@
+require 'studio_game/player'
+
+module StudioGame
+  describe "Player should" do
+
+    before do
+      # suppress test puts output only
+      $stdout = StringIO.new
+
+      # Set friendly test-only variables
+      @default_health = 100
+      @half_default_health = 50
+
+      # Set up example players
+      @larry = Player.new("larry")
+      @curly = Player.new("curly")
+      @moe = Player.new("moe", @half_default_health)
+    end
+
+    it "have a default name of 'Player'." do
+      nameless_player = Player.new
+
+      expect(nameless_player.name).to eq("Player")
+    end
+
+    it "have a capitalized name." do
+      expect(@larry.name).to eq("Larry")
+      expect(@curly.name).to eq("Curly")
+    end
+
+    it "allow name change requests." do
+      @larry.name = "lawrence" #larry's mum is mad
+      expect(@larry.name).to eq("Lawrence")
+    end
+
+    it "start with a default health of 100." do
+      expect(@larry.health).to eq(@default_health)
+      expect(@curly.health).to eq(@default_health)
+    end
+
+    it "allow a custom starting health." do
+      expect(@moe.health).to eq(@half_default_health)
+    end
+
+    it "introduce themselves and their health status." do
+      expect(@larry.print_health_status).to eq("Larry (100 health)")
+      expect(@curly.print_health_status).to eq("Curly (100 health)")
+    end
+
+    it "lose 10 health points when blammed." do
+      @larry.blam
+      expect(@larry.health).to eq(@default_health - 10)
+
+      @larry.blam
+      expect(@larry.health).to eq(@default_health - (10*2))
+    end
+
+    it "gain 15 health points when w00ted." do
+      @larry.w00t
+      expect(@larry.health).to eq(@default_health + 15)
+
+      @larry.w00t
+      expect(@larry.health).to eq(@default_health + (15*2))
+    end
+
+    it "have a score computed from their health and points." do
+      treasure = Treasure.new("pickaxe", 2)
+      TreasureTrove.stub(:random_treasure).and_return(treasure)
+      @larry.find_treasure
+
+      expect(@larry.score).to eq(@default_health + treasure.points)
+    end
+
+    it "provide their name and score information." do
+      TreasureTrove.stub(:random_treasure).and_return(Treasure.new("pickaxe", 2))
+      @larry.find_treasure
+
+      expect(@larry.print_score).to eq("Larry.................... 102")
+    end
+
+    it "provide their name, health and score information." do
+      TreasureTrove.stub(:random_treasure).and_return(Treasure.new("pickaxe", 2))
+      @larry.find_treasure
+      @curly.find_treasure
+      @moe.find_treasure
+
+      expect(@larry.to_s).to eq("Larry's health = 100 and score = 102")
+      expect(@curly.to_s).to eq("Curly's health = 100 and score = 102")
+      expect(@moe.to_s).to eq("Moe's health = 50 and score = 52")
+    end
+
+    it "be strong if their health is 100." do
+      expect(@curly).to be_strong
+    end
+
+    it "be strong if their health is 200." do
+      @double_initial_health = 200
+      @larry = Player.new("larry", @double_initial_health)
+
+      expect(@larry).to be_strong
+    end
+
+    it "be wimpy if their health below 100." do
+      @half_initial_health = 50
+      @one_below_initial_health = 99
+
+      @moe = Player.new("moe", @half_initial_health)
+      @curly = Player.new("curly", @one_below_initial_health)
+
+      expect(@moe).not_to be_strong
+      expect(@curly).not_to be_strong
+    end
+
+    it "find a random treasure" do
+      TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300))
+
+      expect(@larry.find_treasure).to eq("Larry found a ruby worth 300 points")
+    end
+
+    context "accumulate" do
+      it "one treasure." do
+        TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300))
+
+        @larry.find_treasure
+        expect(@larry.found_treasures.size).to eq(1)
+      end
+
+      it "two treasures." do
+        TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300), Treasure.new("pickaxe", 2))
+
+        2.times { @larry.find_treasure }
+        expect(@larry.found_treasures.size).to eq(2)
+      end
+
+      it "three treasures." do
+        TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300), Treasure.new("pickaxe", 2), Treasure.new("kindle", 50))
+
+        3.times { @larry.find_treasure }
+        expect(@larry.found_treasures.size).to eq(3)
+      end
+
+      it "two of the same treasures (counts as one treasure found)." do
+        TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300))
+
+        10.times { @larry.find_treasure }
+        expect(@larry.found_treasures.size).to eq(1)
+      end
+    end
+
+    it "earns points" do
+      TreasureTrove.stub(:random_treasure).and_return(Treasure.new("ruby", 300))
+
+      2.times { @larry.find_treasure }
+      expect(@larry.points).to eq(600)
+    end
+
+    it "can be created from a CSV string" do
+      player = Player.from_csv("larry,150")
+
+      expect(player.name).to eq("Larry")
+      expect(player.health).to eq(150)
+    end
+
+  end
+end

data/spec/studio_game/treasure_spec.rb

@@ -0,0 +1,28 @@
+require 'studio_game/treasure'
+
+module StudioGame
+  describe "Treasure should" do
+    before do
+      # suppress test puts output only
+      $stdout = StringIO.new
+
+      @fools_gold = Treasure.new("fools gold", 5)
+      @bells = Treasure.new("bells", 99)
+    end
+
+    it "have a name." do
+      expect(@fools_gold.name).to eq("fools gold")
+      expect(@bells.name).to eq("bells")
+    end
+
+    it "have a point value." do
+      expect(@fools_gold.points).to eq(5)
+      expect(@bells.points).to eq(99)
+    end
+
+    it "share their name and point information." do
+      expect(@fools_gold.to_s).to eq("#{@fools_gold.name} worth #{@fools_gold.points} points")
+      expect(@bells.to_s).to eq("#{@bells.name} worth #{@bells.points} points")
+    end
+  end
+end

data/spec/studio_game/treasure_trove_spec.rb

@@ -0,0 +1,44 @@
+require 'studio_game/treasure_trove'
+
+module StudioGame
+  describe "TreasureTrove should" do
+    before do
+      # suppress test puts output only
+      $stdout = StringIO.new
+
+      @treasures = TreasureTrove::TREASURES
+    end
+
+    it "have six treasures, including:" do
+      expect(@treasures.size).to eq(6)
+    end
+
+    context "have treasures already" do
+      # Bad practice to test for content, but wanted to try out removing duplication by looping through and this was a good candidate (this is a toy app).
+
+      expected_treasures = {
+        "gold":100,
+        "stamp":30,
+        "pickaxe":2,
+        "kindle":50,
+        "ruby":300,
+        "gem":100
+      }
+
+      expected_treasures.each do |expected_name, expected_points|
+        it "* A #{expected_name} treasure worth #{expected_points}." do
+          expect(@treasures.any? { |actual_treasure|
+            actual_treasure.name == expected_name &&
+              actual_treasure.points == expected_points
+          })
+        end
+      end
+
+      it "can select a random treasure" do
+        treasure = TreasureTrove.random_treasure
+
+        expect(TreasureTrove::TREASURES).to include(treasure)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,231 @@
+--- !ruby/object:Gem::Specification
+name: studio_game_2021
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Becca Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-05-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+description: |2
+
+  <!-- TABLE OF CONTENTS -->
+  <details open="open">
+  <summary>Table of Contents</summary>
+  <ol>
+  <li>
+  <a href="#about-the-project">About The Project</a>
+  <ul>
+  <li><a href="#built-with">Built With</a></li>
+  </ul>
+  </li>
+  <li>
+  <a href="#getting-started">Getting Started</a>
+  <ul>
+  <li><a href="#prerequisites">Prerequisites</a></li>
+  <li><a href="#installation">Installation</a></li>
+  </ul>
+  </li>
+  <li><a href="#usage">Usage</a></li>
+  <li><a href="#roadmap">Roadmap</a></li>
+  <li><a href="#contributing">Contributing</a></li>
+  <li><a href="#license">License</a></li>
+  <li><a href="#contact">Contact</a></li>
+  <li><a href="#acknowledgements">Acknowledgements</a></li>
+  </ol>
+  </details>
+
+  <!-- ABOUT THE PROJECT -->
+  ## About The Project
+
+  [![Product Name Screen Shot][Screenshot of gameplay and test list]](https://www.dropbox.com/s/mu1rrbx2mqowjkn/studio-game.png?dl=0)
+
+  This game is a project built following the [Pragmatic Studio Ruby Course](https://online.pragmaticstudio.com/courses/ruby/). I absolutely adored going through this course, because it was unlike other courses in that the main focus wasn't syntax, but how to build a principle-driven, object-oriented program that contains many of the skills we'd need to build real-world projects. The instructors purposefully created exercises to let us build a program using the skills they demonstrated by building a different program. This wasn't a copy and paste kind of course. This game was actually my second run-through, where I test-drove everything from the start based on the objectives only.
+
+  Skills I valued developing further with this project:
+  - Test-driven development (50+ tests).
+  - Using inheritance to model "is-a" relationships. For example, a clumsy player *is a* kind of player.
+  - Using mixins (modules) to reuse behaviours that are common between classes, but should not be modeled with an inheritance relationship. A good tip was to look for 'able' behaviors in a class to extract, like 'playable', 'printable', 'taxable' etc.
+  - Using a file block which lets you add in class usage examples that are only run when you run the class file specifically.
+  - Overriding default methods (like sort, and renaming things so that they keep a specific format)
+
+  Things I struggled with:
+  - Testing behaviour that uses blocks. I had a lightbulb moment when I realised I should test the behaviour performed inside the block on a single item. Testing the output of an entire block is like testing Ruby syntax works. Alternatively, test the before and after state of something that changes as a result of using a block. Cooool.
+  - Puts. It felt wrong to use puts to show the output in the console. I'd like to learn how to seperate the view logic for a command-line project later.
+
+  Things I did to make it my own:
+  - Wrote a lot more tests for my second run-through.
+  - Noticed and extracted further 'able' behaviours into modules (like printing stats, formatting output and handling csv files).
+
+
+  ### Built With
+
+  * [Ruby (language)](https://www.ruby-lang.org/en/)
+  * [RSpec (framework)](https://rspec.info/)
+  * [Vim (text-editor)](https://www.vim.org/)
+
+
+
+  <!-- GETTING STARTED -->
+  ## Getting Started
+
+  To get a local copy up and running follow these steps:
+
+  ### Prerequisites
+
+  This is an example of how to list things you need to use the software and how to install them.
+  * gem
+  ```sh
+  npm install npm@latest -g
+  ```
+
+  ### Installation
+
+  1. Install the gem
+  ```sh
+  gem install studio_game_2021
+  ```
+
+  <!-- USAGE EXAMPLES -->
+  ## Usage
+  To play a game from the command-line, open a new command project and run the command-line script like so:
+  ```sh
+  studio_game
+  ```
+
+  Or, if you'd like to use the game as a library, here's an example of how to use it in `irb`. You can also check the bottom of each class or module file for further usage instructions
+
+  ```
+  >> require 'studio_game/game'
+  => true
+
+  >> game = StudioGame::Game.new("Knuckleheads")
+  => #<StudioGame::Game:0x007fdea10252d8 @title="Knuckleheads", @players=[]>
+
+  >> player = StudioGame::Player.new("Moe", 90)
+  => I'm Moe with health = 90, points = 0, and score = 90.
+
+  >> game.add_player(player)
+  => [I'm Moe with health = 90, points = 0, and score = 90.]
+
+  >> game.play(1)
+  ```
+
+
+  <!-- ROADMAP -->
+  ## Roadmap
+
+  I plan to customize this game further now that I have a solid foundation to explore from. It'll be fun to let the players interact with each other more, like swapping treasures, and maybe add some kind of board game with it's own features. That's my next focus.
+
+
+  ## Contributing
+
+  Feel free to fork this project and play around with it. Open to feedback-related pr requests.
+
+
+    <!-- LICENSE -->
+  ## License
+
+    Distributed under the MIT License. See `LICENSE` for more information.
+
+
+
+    <!-- CONTACT -->
+  ## Contact
+
+    Becca - [@becca9941](https://twitter.com/Becca9941) - becca@essentialistdev.com
+
+    Project Link: [https://gitlab.com/EssentialistDev/studio-game](https://gitlab.com/EssentialistDev/studio-game)
+
+
+
+    <!-- ACKNOWLEDGEMENTS -->
+  ## Acknowledgements
+
+  - [Pragmatic Studio](https://online.pragmaticstudio.com/courses/ruby/) for empowering me with awesome new development skills.
+  - [Best-README-Template](https://github.com/Becca9941/Best-README-Template) for helping me write a README for this project.
+email: becca@essentialistdev.com
+executables:
+- studio_game
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README
+- bin/avatar_players.csv
+- bin/players.csv
+- bin/studio_game
+- lib/studio_game/auditable.rb
+- lib/studio_game/berserk_player.rb
+- lib/studio_game/clumsy_player.rb
+- lib/studio_game/die.rb
+- lib/studio_game/formatting.rb
+- lib/studio_game/game.rb
+- lib/studio_game/game_stats.rb
+- lib/studio_game/game_turn.rb
+- lib/studio_game/handle_csv.rb
+- lib/studio_game/loaded_die.rb
+- lib/studio_game/playable.rb
+- lib/studio_game/player.rb
+- lib/studio_game/printable.rb
+- lib/studio_game/treasure.rb
+- lib/studio_game/treasure_trove.rb
+- spec/studio_game/berserk_player_spec.rb
+- spec/studio_game/clumsy_player_spec.rb
+- spec/studio_game/game_spec.rb
+- spec/studio_game/player_spec.rb
+- spec/studio_game/treasure_spec.rb
+- spec/studio_game/treasure_trove_spec.rb
+homepage: https://gitlab.com/EssentialistDev/studio-game
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: A text-based game
+test_files:
+- spec/studio_game/clumsy_player_spec.rb
+- spec/studio_game/treasure_trove_spec.rb
+- spec/studio_game/berserk_player_spec.rb
+- spec/studio_game/player_spec.rb
+- spec/studio_game/treasure_spec.rb
+- spec/studio_game/game_spec.rb