0.0
No commit activity in last 3 years
No release in over 3 years
Create your own quiz to reveal clues in an escape room.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

>= 0
>= 0

Runtime

>= 0
 Project Readme

escape

The escape room CLI

DESCRIPTION

Escape is a command line interface for asking questions to get out of an escape room. Complete with tests.

The CLI loops through a list of questions (that you can define) and for each correct answer, you will receive a piece of the code. The actors can use this code for a combination lock or whatever clue you want to provide them.

If the actor gets an answer wrong, the CLI will give them an answer but it is not part of the code. They can go through all of the questions and one or more may be wrong but they will not know the wrong answer.

Usage

You can modify the configuration.yml file with your own questions, answers, and the code.

To start, the actors are greated with a welcome message and they hit return to start:

> WELCOME TO THE ESCAPE ROOM!
>
> You were chosen to take part in this clue. Be careful, any answer will give you a part
> of the clue but if the answer is wrong, the clue is wrong. Any wrong part and you will
> have to start all over.
>
> Hit RETURN to start!
>

It then loops through the questions:

> WHAT IS THE VALUE OF PI? (Answer the question and hit RETURN)
>

The CLI will then provide them with an answer, right or wrong:

> YOUR NEXT CLUE IS: '4'
>

Once the CLI loops through all of the questions, you will get a message with a chance to start over:

> YOU HAVE COMPLETED THE CHALLENGE.
>
> Hit RETURN to restart.

Installation

  1. Install the gem
gem install escape-room
  1. Configure your welcome message, questions, answers, and code at ./configuration.yml
cd $GEM_HOME/gems/escape-room-0.0.3
nano configuration.yml
  1. Run the application at the command line
escape

RELEASING A NEW GEM

  1. Bump the VERSION in lib/escape/version.rb
  2. Bundle install bundle install
  3. Commit changes and push to GitHub
  4. run bundle exec rake release

CONTRIBUTING

  1. Clone the repository git clone git@github.com:jwright/escape
  2. Create a feature branch git checkout -b my-awesome-feature
  3. Codez!
  4. Commit your changes (small commits please)
  5. Push your new branch git push origin my-awesome-feature
  6. Create a pull request hub pull-request -b jwright:master -h jwright:my-awesome-feature

LICENSE

Copyright (c) 2019, Jamie Wright.

This project is licensed under the MIT License.