Game Modules

shell

Takes input from user/s.

Control the game through parse the input and call the equivalent method to operate the work.

class app.shell.Shell

Bases: cmd.Cmd

Shell class.

default(line)

Print out message when invalid input.

do_cheat(_)

Return the upcoming value of the dice.

do_end(_)

End currnet game.

do_exit(_)

Exit CMD-terminal the game.

do_help(_)

Print orders’ format.

do_level(level)

Change the game’s level.

do_name(new_name)

Change player name.

do_pass(_)

Hold turn.

do_q(arg)

Exit CMD-terminal the game.

do_roll(_)

Roll the dice.

do_score(_)

Read from highscore file.

do_start(player_num)

Game starting.

intro = 'Enter help or ? to get the words that can be used.\n'

prompt = '(game): '

game

Process operations according to input taken in shell.py.

The instance of game class is created within shell.py. After analyzing the input, game object reach the equivalent method for processing

class app.game.Game

Bases: object

Game Class.

change_name(name)

Change player name.

cheat()

Return the rolled dice to reach cheating feture.

check_levels(level)

Check if the entered level is valid.

computer_turn()

Take orders from Intelligence class to control the decison.

console(player)

Synchronize between players’s scores and rolled dice.

create_player(player_amount)

Create Players according to passed parameter.

Get info from shell.py, fit equivalent players with names. Turn computer_controller on/off.

end_game(player)

Call other methods to process game ending.

get_computer_controler()

Getter for a boolen variable.

Help to switching turns.

get_face()

Return dice face before automatic rolling.

Method used for testing purpose.

get_game_status()

Check the game status.

get_playing_now()

Return currently player.

highscore()

Call method sprint out from highscore file.

static print_out_dice(player, number)

Print out rolled dice.

static print_score(player)

Print out player score and name.

roll()

Reached by human players.

Call other methods to make operations depends on die rollments.

set_computer_controler(controller)

Setter for a boolen variable.

Help in switching turns.

set_face(num)

Set value in variable to hold dice face before automatic rolling.

This method used for testing purpose.

set_game_status(bool)

Set game status.

set_playing_now(player)

Change object’s holder to help exchanging players.

still_going = False

switcher()

Switch between players.

Considering if the game has computer controller or not, based on that it calls a method to switch between players

win_pig = 50

dice

Present dice object used in the game.

class app.dice.Dice

Bases: object

Dice Class.

get_dice()

Return the rolled dice face.

roll_dice()

Roll the dice and initialize random value.

highscore

The class accepts instances of players.

To be able to save scores at the end of the game. Player has ability to read score file when script runs

class app.highscore.Highscore(player1, player2)

Bases: object

Highscore Class.

get_path()

Return file’s path (testing purpose).

static read_file()

Read highscore file.

write_file()

Initialize players’ name and score to write them in txt file.

histogram

Recive players lists and organize printable style.

Considering players list score, each printed row equable the face that player got when he rolled dice.

class app.histogram.Histogram

Bases: object

Histogram Class.

static print_asterisk(player_list)

Print the equavelent asterisks in player list.

print_histogram(player1, player2)

Process histogram feature.

Print Histogram and sending players lists to another method to organize asterisks style.

intelligence

Controls the intelligence computer player.

According to chosen level the class make decision for next movement.

class app.intelligence.Intelligence(level)

Bases: object

Intelligence Class.

act_easy()

Return decision as an easy level.

act_hard(value)

Notice that the computer has ability to cheat.

act_normal(player)

Control decision when level is Normal.

cheat_decison()

Create computer decision about cheating.

Use same boolean tuple to init decision.

get_inti_decision(player, dice_value)

Return a method using currying approach to set level.

orders = (True, False, True)

player

Player Class to control player objects create in game.

class app.player.Player(name, decision)

Bases: object

Player Class.

change_score(score)

Change player score according to dice dance.

get_name()

Return player name.

get_score()

Return player score.

get_score_list()

Return score list.

reaction = <app.intelligence.Intelligence object>

set_level(level)

Set computer’s level.

set_name(name)

Change plyer name.

set_score_list(num)

Set score list.

Test Modules

test_game

Test game module.

class test.test_game.TestGameClass(methodName='runTest')

Bases: unittest.case.TestCase

Test Game Class.

setUp()

Run at the beginning of the test.

test_change_name()

Test changing name feature.

test_cheat()

Tests cheat feature.

Cheating is made by showing the upcoming die-rollment.

test_check_levels()

Test check_levels.

test_computer_turn_calls_switcher(mock_calls_switcher)

Tests switcher callable by comuter-turn method.

test_console(mock_calls_dice_printer)

Tests console method calls print_out_dice.

test_console1(mock_calls_change_score)

Tests console method calls change-score.

test_console2(mock_calls_end_game)

Tests player wins and game ends.

test_console_returns_false()

Tests that console returns false when dice is 1 or 6.

test_create_player(mock)

Test create_player.

test_create_player1(mock)

Test create_player.

test_create_player2(mock)

Test create_player.

test_end_game()

Test end_game.

test_get_computer_controler()

Test get_computer_controler.

test_get_game_status()

Test get_game_status.

test_get_playing_now()

Test set And get_playing_now.

test_print_out_dice()

Test print_out_dice.

test_print_score()

Test print_score.

test_roll(mock_calls_switcher)

Tests that roll-method calls switcher when dice-face is 1.

test_set_cmputer_controler()

Test set_computer_controler.

test_set_face()

Test set_face.

test_switch_between_humans()

Tests switching turns between player1 and player2.

test_switch_human_calling(mock_calls_swit_humans)

Test-switching between humans’ players.

test_switch_with_computer(mock_set_computer)

Tests switching turns between player1 and computer_player.

When switching between player1 and computer-player, _switch_with_computer method returns computer-turn method which in turns set_game_player to be the computer.

test_switch_with_computer_calling(mock_calls_swit_com)

Test switching between player-1 and computer player.

test_dice

Test dice file.

class test.test_dice.TestDiceClass(methodName='runTest')

Bases: unittest.case.TestCase

Dice class Test.

setUp()

Run at the beginning of the test.

test_get_dice()

Tests the returned value after rolling a die.

test_init()

Test the created instance.

test_roll_dice()

Test that the rolled value is in the list above.

test_highscore

Test highscore module.

class test.test_highscore.TestHigscore(methodName='runTest')

Bases: unittest.case.TestCase

Test Higscore Class.

setUp()

Run at the beginning of the test.

test_get_path()

Test get_path.

test_write_file()

Test write_file.

test_histogram

Test Histogram module.

class test.test_histogram.TestHistogram(methodName='runTest')

Bases: unittest.case.TestCase

Test Histogram Class.

test_print_asterisk()

Test print_asterisk method.

test_print_histogram()

Test print_histogram by catching output and comparing it.

test_intelligence

Test intelligence module.

class test.test_intelligence.TestIntelligenceClass(methodName='runTest')

Bases: unittest.case.TestCase

Test Histogram Class.

setUp()

Run at the beginning of the test.

test_act_easy()

Test act_easy.

test_act_hard()

act-hard method where it returns true when computer dicide to cheat.

The method returns True when dice-face between 2-5.

test_act_hard_calls_easy(mock_calls_act_easy)

Tests act-hard calls easy when cheat_decison = False.

test_act_normal(mock_calls_act_easy)

Tests act-normal returns True/False.

When computer-player score is less than 10, another test to assert it calls act-easy if the score higher that 10.

test_cheat_decision()

Test cheat-decision.

test_get_inti_decision_hard(mock_calls_act_hard)

Tests get_inti_decision method calls act-hard.

test_get_inti_decision_normal(mock_calls_act_normal)

Tests get_inti_decision method calls act-normal.

test_player

Test player module.

class test.test_player.TestPlayer(methodName='runTest')

Bases: unittest.case.TestCase

Test Histogram Class.

setUp()

Create instances at the beginning of tests cases.

test_chane_score()

Test change_score method.

test_get_score_list()

Test Player Class.

test_set_name()

Test set/change player name.

test_set_score_list()

Test set_score_list.