You have a deck of 52 cards, comprised of 4 suits (hearts, clubs, spades and diamonds) each with 13 values (Ace, two, three, four, five, six, seven, eight, nine, ten, jack, queen and king).
There are four players waiting to play around a table. The deck arrives in perfect sequence (so, ace of hearts is at the bottom, two of hearts is next, etc. all the way up to king of diamonds on the top).
The task is a simple one. Please create a simple command line program that when executed recreates the scenario above and then performs the following two actions:
- Shuffle the cards - We would like to take the deck that is in sequence and shuffle it so that no two cards are still in sequence.
- Deal the cards - We would then like to deal seven cards to each player (one card to the each player, then a second card to each player, and so on)
There is no need to necessarily do this in a visual way (for example, simply proving with a test that your deck is shuffled and that the players do now have seven cards will be sufficient) Please supply your solution as a zip file containing any classes, tests, documentation, etc that you have produced.
git clone https://github.com/SimonBao/php-card-shuffler.git
cd php-card-shuffler
composer install
The project was built using PHP, PHP should be installed on most UNIX/LINUX systems, installation on Windows may be required. For any issues PHP related, click on the link to access the offical manual.
For testing Composer is required, click on the link and follow installation procedure. I have setup Composer to be used globally.
To install dependencies:
$ composer install
To regenerate autoload to include our src:
$ composer dump-autoload
To run tests:
$ ./vendor/bin/phpunit tests
New classes created in the src folder will not be found by PHPUnit tests automatically. You will need to regenerate the autoload file.
For this project I used Composer as my dependency manager.
- PHPUnit - Testing Framework
- Has a deck with 52 cards
- numbered from 1 to 52
- Deals 7 cards from deck
- cards delt are removed from deck
Version 1 is completed. Working environment/dependencies used:
- PHP version 7.2.5
- PHPUnit version 7.1.4
- Deck of 52 cards made from:
- 4 suits (Hearts, Clubs, Spades and Diamonds)
- 13 cards for each suit (A, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, J, Q, K)
- Deals 7 cards to 4 players
Version 2 is completed.
- Deck of cards are now shuffled into a random order
- no cards are in sequence
- Deals cards in a round robin sequence until each player has 7 cards
Version 3 is completed.
- GitHub
- BitBucket
- Visual Studio Code
- Trello
The project has been completed and built following my current knowledge of programming practices and principals. Each class includes their individual test suites and any class dependecies have been mocked along with their method calls.
The project was completed however, I would have liked to create an Card class as I'm not quite happy with how the card system works currently.