COMP 2034 Software Development

Posted 2021-09-07 把我再叹

Software Development
Python Programming Assignment 2
UniSA STEM
The University of South Australia
May 2021

• 2 -
  Contents
  Introduction
  Graduate Qualities
  Specifications and Requirements
  Submission Requirements
  Extensions and Late Submissions
  Academic Misconduct
  Sample Output
  Marking Criteria
• 3 -
  Introduction
  This document describes the second programming assignment for COMP 2034 Software
  Development course.
  The assignment is intended to provide you with the opportunity to put into practice what
  you have learnt in the course by applying your knowledge and skills in Object-Oriented
  Programming with Python programming language. The task is to develop a program with
  multiple modules which allows users to play the game of Rock-Paper-Scissors or the game of
  Code Break against the computer and maintains information on players. Player information
  will be stored in a text file that will be read in when the program commences. Once the
  application has read the initial player data, it should allow the user to interactively query
  and manipulate the player information as well as play games against the computer.
  This assignment is an individual task that will require an individual submission. Each
  student is required to submit your work via LearnOnline system by the deadline specified
  in the Submission Requirements section of this document.
  This document is a specification of the required end product that will be generated by
  implementing the assignment. Like many specifications, it is written in English and hence
  will contain some imperfectly specified parts. Please make sure you seek clarification if you
  are not clear on any aspect of this assignment.
• 4 -
  Graduate Qualities
  By undertaking this assessment, you will progress in developing the qualities of a University
  of South Australia graduate. The Graduate qualities being assessed by this assignment are:
  • The ability to demonstrate and apply a body of knowledge (GQ1) gained from the
  lectures, practicals, and readings. This is demonstrated in your ability to apply
  programming theory to a practical situation.
  • The ability to effectively problem solve (GQ3) using Python and Object-Oriented
  Programming concepts to complete the programming problem. Effective problem
  solving is demonstrated by the ability to understand what is required, utilise the
  relevant information from lectures, the text book and practical work, write Python
  code, and evaluate the effectiveness of the code by testing it.
  • The use of communication skills (GQ6) by producing source code that has been
  properly formatted; and by writing adequate, concise and clear comments.
  Communicating with others through demonstrating and explaining the program
  code to the instructor.
• 5 -
  Specifications and Requirements
  Your solution MUST adhere to the specifications and requirements described in this
  document.
  It is recommended that you develop this assignment in stages and make back-ups of your
  code regularly not only for development purpose, but also as an evidence of original work.
  Your program must be developed using multiple Python modules, with the number and
  names of all the files strictly adhering to the specifications below.
  Your program must be developed with six Python files, three of them provided, and three of
  them newly written by yourself. These files must be:
  • assignment2.py - This file contains the main part of your program to import the
  other modules and run. It allows the user to interactively query and manipulate the
  player information and play games. (PROVIDED)
  • player.py - This file contains Player class definition to store a single player
  information.
  • leaderboard.py - This file contains LeaderBoard class definition to manage
  players on a leader board.
  • game.py - This file contains Game class definition which is the base class of other
  game classes. (PROVIDED)
  • rpsgame.py - This file contains RockPaperScissors class definition which
  implements the Rock-Paper-Scissors game. (PROVIDED)
  • codebreakgame.py - This file contains CodeBreak class definition which
  implements the Code Break game.
  Three files (assignment2.py, game.py, rpsgame.py) will be provided on the course
  website along with this document and they must be used without any modification. To
  solve this assignment, you must create and write three additional files player.py,
  leaderboard.py, and codebreakgame.py.
  Program Behaviour
  When your run the program assignment2.py, it will create an instance object of the
  LeaderBoard class you define and call the load() method which should load in player
  information from a file called players.txt (provided on the course website). If the
  program has loaded the data successfully, the following message will be displayed:
  Players info successfully loaded.
  Or if the program fails to load the players info, the following message will be displayed:
  ERROR: Cannot load players info.
  Your program will enter the command mode after the player information has been loaded
  from the file. In the command mode, the program reads user input for a command with the
  following prompt shown on the screen:
• 6 -
  Please enter a command [list, add, remove, play, winner,
  quit]:
  The program will allow the user to enter commands and process these commands until the
  ‘quit’ command is entered.
  The following commands must be supported:
  Command Description
  list Displays the leader board (a list of all players and their
  details) by calling the display() method of the
  LeaderBoard object.
  add Prompts to input a name for a new player to add, and calls
  the addPlayer() method of the LeaderBoard object
  to add the player with the provided name. Depending on
  the return value from the addPlayer() method, the
  following messages are displayed on the screen with the
  player’s NAME :
• returned True: "Successfully added player NAME. "
• returned False: "Player NAME already exists. "
  remove Prompts to input the player’s name to remove then calls
  the removePlayer() method of the LeaderBoard
  object to remove the player with the given name.
  Depending on the return value, the following messages
  are displayed on the screen with the player’s NAME :
• returned True: "Successfully removed player NAME. "
• returned False: "No such player found."
  play Asks to input the player’s name who will play the game,
  and checks the player’s points by calling the
  getPlayerPoints() method of the LeaderBoard
  object. If the player is not found (i.e. the return value is
  negative), an error message “No such player found.” is
  displayed to the screen, otherwise asks for the amount of
  points to bid, then asks to choose which game to play. The
  chosen game will be played by creating an instance of
  either RockPaperScissors or CodeBreak class,
  then calling its play() method which will return the
  result of the game (1: win, 0: tie, -1: lose). After playing
  the game, the returned results and the points bid will be
  passed on to calling the recordGamePlay() method of
  the LeaderBoard object to update the player
  information.
  winner Prints the details of the winning player who has the
  highest number of points by calling the getWinner()
  method of the LeaderBoard object.
• 7 -
  quit Causes the program to quit, displaying a message “Thank
  you for playing!”. Upon quitting, the program will call the
  save() method of the LeaderBoard object which will
  save the player information to a file named output.txt
  which is in the same format as the input players.txt
  file. Upon successfully saving the information the program
  will show a message, “Players info successfully saved.” If it
  fails saving the information, the program will show a
  message, “ERROR: Cannot save players info.”
  debug This is a hidden command (not shown in the prompt) that
  will turn the debug mode on or off. If the debug mode is
  on, the debugMode property of the game object will be
  set to True which will let the answer be printed.
  After performing each command, the program returns to command mode, prompting the
  user to input next command.
  Class Specifications
  Below are detailed specifications of the three classes you must define in three files:
  player.py, leaderboard.py, and codebreakgame.py.
  • Player class
  The Player class stores the information for each player. This class must be defined in the
  player.py file, and must have the following public data attributes:
  Data Attributes
  A string, name of the player which may include white spaces.
  An integer, number of games played
  An integer, number of games won
  An integer, number of games lost
  An integer, number of games tied
  An integer, current points
  The Player class must have an initialiser method that takes the name of the player as a
  parameter, and initialises the name data attribute, as well as sets the rest of the attributes
  to 0, except the current points which must be initialised to 100.
  The Player class must also have a string conversion method that returns a string
  describing the player object including the name, the number of games played, winning rate,
  and the current points remaining. For example, for a player named "John Doe" who has
  won 4 games out of 7 games and has 75 remaining points, it must return a string in the
  following format:
  "John Doe has 75 points and a winning rate of 57.1%."
  Note the winning rate should show 1 digit under the decimal point.
• 8 -
  If the player did not play any games, the string must be in the following format:
  "John Doe has 100 points, and never played a game."
  • LeaderBoard class
  The LeaderBoard class manages a list of players (i.e., instance objects of the Player
  class). The LeaderBoard class must be defined in the leaderboard.py file, and must
  have only one private (i.e. hidden) data attribute which is the list of players.
  The LeaderBoard class must define eight public methods, load(), save(),
  display(), addPlayer(), removePlayer(), getPlayerPoints(),
  getWinner(), and recordGamePlay(), as well as two private methods,
  __findPlayer() and __sortPlayers(). Below are detailed specifications of each
  method:
• load()
  This method loads in the player information from a file named players.txt (provided on
  the course website together with this document). It reads in the file and creates a list of
  instances of the Player class you defined, and updates the list of players data attribute
  with the loaded information. In the players.txt file, each player is described in two
  lines of text. The name of the player (which may include white spaces) is stored in the first
  line. The very next line contains the number of games played, games won, games lost,
  games tied, and the current remaining points, all stored in one line and separated by the
  space character. Below is a sample content of the players.txt file with three players:
  John Doe
• 4 0 1 70
  Lisa Smith
• 13 2 1 105
  Andrew Whittaker
• 0 7 0 55
  You must use the input file players.txt provided on the course website. You are not
  supposed to create it yourself or edit the provided input file. You may assume that all data
  in this file is in the correct format. Note there could be empty lines at the end of the file
  which should be ignored.
  After loading the data, the load() method must call the __sortPlayers() method to
  keep the player list in the order of their points. It should not print any message onto the
  screen, but must return True if the data has been successfully loaded, or False if there is
  any error.
• save()
  This method saves the player information to the output.txt file which should have the
  same format as the input players.txt file. It should not print any message onto the
  screen, but must return True if the data has been successfully saved, or False if there is
  any error.
• 9 -

• display()
  This method shows the leader board onto the screen in the format as described below:
  • The player name field is displayed under the “Player Name” heading, and should be 30
  characters wide, left justified.
  • The number of games played is displayed under the “P” heading, and should be 2
  characters wide, right justified.
  • The number of games won is displayed under the “W” heading, and should be 2
  characters wide, right justified.
  • The number of games lost is displayed under the “L” heading, and should be 2
  characters wide, right justified.
  • The number of games tied is displayed under the “T” heading, and should be 2
  characters wide, right justified.
  • The winning rate is displayed under the “W-Rate” heading, and should be 6 characters
  wide, right justified, showing 1 digit under the decimal point with a percent sign (%) at
  the end (Hint: 100.0% has 6 characters). Note that the winning rate is not part of the
  information stored in the Player structure, but should be calculated based on number
  of games played and number of games won. If the number of games played is zero,
  the winning rate is treated as zero percent.
  • The points is displayed under the “Points” heading, and should be 6 characters wide,
  right justified.
  • Each of the field should be separated by a single empty space character.

  Below is an example of how the output should look like:
  Player Name P W L T W-Rate Points
  John Doe 5 4 0 1 80.0% 70
  Lisa Smith 16 13 2 1 81.3% 105
  Andrew Whittaker 7 0 7 0 0.0% 55

  When there is no player (i.e. all players removed), it should show a “No player to display.”

  message as below:
  Player Name P W L T W-Rate Points
  No player to display.

• 10 -
• addPlayer()
  This method takes the name of a new player to add as a parameter, creates an instance
  object of the Player class with the provided name, and adds that object to the player list
  data attribute. Before creating a new player, the method should call the
  __findPlayer() method to check if there is already a player with the same name, in
  which case the method should not add a new player but simply return False. After adding
  a new player, it should also call the __sortPlayers() method to sort the list of players.
  The method must return True after successfully adding a player.
• removePlayer()
  This method takes the name of a player as a parameter, and removes the player with the
  provided name. It should use the __findPlayer() to first identify the Player object to
  remove from the player list data attribute. If there is no player with the provided name, the
  method must return False, or otherwise return True after the player was successfully
  removed.
• getPlayerPoints()
  This method takes the name of a player as a parameter, and returns the current points of
  the player with the provided name. If there is no such player with the provided name, it
  must return -1.
• getWinner()
  This method returns a Player object that has the highest number of points. If there is no
  players in the player list, it must return None.
• recordGamePlay()
  This method updates the player information based on the provided game play results. It
  takes three parameters: the name of a player, number of points bid, and the result of a
  game play. The result of a game play will be 1 in case the player won the game, -1 if the
  player lost, and 0 if it was a tie. The number of games played, won, lost, tied, and the
  current point data attributes of the player must be updated accordingly. For winning, the
  points will be increased by the amount of bid, while the points will be reduced by the
  amount of bid if lost. If it was a tie game, no changes to the points are made. It must call the
  __sortPlayers() method to keep the player list in the order of their points.
• __findPlayer()
  This method takes the name of a player as a parameter, finds the player with the provided
  name from the list of players, and returns the Player object. If there is not such a player
  with the provided name, it must return None.
• __sortPlayers()
  This method updates the list of players by sorting it in the order of the remaining points.
• 11 -
  • CodeBreak class
  The CodeBreak class implements the game of Code Break. It must be defined in
  codebreakgame.py module, extending (i.e. inheriting) the base class Game defined in
  the game.py module provided on the course website together with this document. The
  CodeBreak class must override the play() method of the base class.
• play()
  This method lets the user play a game of Code Break.
  First of all, it must print the following message on the screen:
  Let\'s play Code Break!
  Find the secret code in less than 5 guesses to win.
  Next, a secret code that consists of three non-identical random numbers between 0 to 9
  (inclusive) is generated. For example, 153 is a valid code but 707 is invalid as it has two 7s.
  Only if the debugMode property inherited from the superclass is set to True, it should
  print the generated code.
  DEBUG: 281
  The user is then asked to guess the secret code within 5 trials to win. User input will be
  asked with a prompt indicating the number of trials, for example, the first trial would show:
  Trial #1:
  If the user input is an invalid code (i.e. either includes non-number character: 3a7, the
  length is not three digits: 3247, or includes the same number: 299), the program must
  print the following message and ask again.
  For example (user input in italic):
  Trial #1: 12a
  Code must be 3 digits with all different numbers.
  Trial #1:
  After each trial of user guessing the code, a feedback is provided indicating if the code is
  correct or not. Also, if the user’s guess is wrong, should also print how many digits were
  correct, how many numbers in the guessed code were in the secret code but in different
  place, and the number of trials left, and continue to let the user have another trial up to 5.
  For example, if the secret code was 123 (user input in italic):
  Trial #1: 456
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 0
  Number of trials left: 4
  Trial #2: 712
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 2
  Number of trials left: 3
  Trial #3: 172
  Wrong code!
  Correct digit(s): 1 / Misplaced number(s): 1
• 12 -
  Number of trials left: 2
  Trial #4: 128
  Wrong code!
  Correct digit(s): 2 / Misplaced number(s): 0
  Number of trials left: 1
  Trial #5: 123
  Correct code!
  If the user fails to guess the code after 5 trials the secret code is revealed (user input in
  italic):
  Trial #5: 129
  The secret code is: 123
  The program must show the result of the game as one of the followings.
  If the user correctly guesses the secret code in less than 5 trials (i.e. within 4 trials), the user
  wins:
  You win!
  If the user correctly guesses the code at 5th trial, the game is a tie:
  Tie!
  If the user fails to guess the code after 5 trials, the payer loses the game.
  You lose!
  Finally, the method must return 1 if the user won the game, -1 if the user lost, and 0 if tied.
  Hint: Please refer to the RockPaperScissors class defined in rpsgame.py module
  provided on the course website together with this document to learn what is expected as a
  subclass of the Game class.
  Screen Format
  Please refer to the ‘Sample Output’ section at the end of this document to ensure that your
  program is behaving correctly and that you have the correct output messages.
  General and Structural Requirements
  Your solution must adhere to the following requirements:
  • Your solution must be based on the Python modules and other files provided on the
  course website together with this document.
  • Supplied files assignment2.py, game.py, rpsgame.py, and players.txt
  must not be modified.
  • Each class you define must be organised into appropriate modules as described in
  the specification, including player.py, leaderboard.py, and
  codebreakgame.py.
  • Use appropriate and well-constructed while, for and if statements as necessary.
  (You may lose marks if you unnecessarily embed if statements in another if
• 13 -
  statement. Rather use logical operators (i.e., and, or, not) or elif statements for
  combing multiple conditions.)
  • User inputs should be validated and asked again if invalid (out of range or not among
  the provided options) with messages displayed as shown in sample outputs.
  • Define and use classes and objects appropriately. All of the classes outlined in the
  specification must be implemented and used as specified. If more classes, functions,
  or methods are added, they should be fully implemented and used in your solution.
  • Output must strictly adhere to the assignment specifications. If you are not sure
  about these details, you should check with the \'Sample Output\' section at the end of
  this document or post a message to the discussion forum.
  • Make appropriate comments. You are to provide comments to describe: your
  personal details at the beginning of each .py file you wrote, all variable and data
  attribute definitions, all functions and methods definitions and every significant
  section of code.
  • Use meaningful variable, data attribute, function, method, and class names (no
  single letter identifier names, except for index variable accessing array elements).
  • Your code must run on Python 3.9 IDLE environment.

• 14 -
  Submission Requirements
  You are required to do the following in order to submit your work and have it marked.
  This assignment is an individual task that will require an individual submission. You are
  required to submit an electronic copy of your program source code (.py files) via
  LearnOnline system before Monday 14 June 2021, 11:59pm.
  All students must follow the submission instructions below:
  You must submit three python files of your work with exactly following the names as
  required:
  player.py
  leaderboard.py
  codebreakgame.py
  The files you submit must include the following comments including your own student
  details at the very beginning of each file:

  File: filename.py

  Author: Steve Jobs

  Student ID: 12345678

  Email ID: jobst007

  This is my own work as defined by

  the University\'s Academic Misconduct Policy.

  Assignments that do not contain these details may not be marked, unless the student can
  prove the file is his/her own work through presenting the progress of development with a
  group of backup files. It is expected that students will make copies and back-ups of all
  assignments in various stages and be able to provide these if required.

• 15 -
  Extensions and Late Submissions
  There will be no extensions for this course without one of the following exceptions:
• A medical certificate is provided that has the timing and duration of the illness and
  an opinion on how much the student’s ability to perform has been compromised by
  the illness. Please note if this information is not provided the medical certificate
  WILL NOT BE ACCEPTED. Late assessment items will not be accepted unless a
  medical certificate is presented to the Course Coordinator. The certificate must be
  produced as soon as possible and must cover the dates during which the assessment
  was to be attempted. In the case where you have a valid medical certificate, the due
  date will be extended by the number of days stated on the certificate up to five
  working days.
• A Learning and Teaching Unit councillor contacts the Course Coordinator on your
  behalf requesting an extension. Normally you would use this if you have events
  outside your control adversely affecting your course work.
• Unexpected work commitments. In this case, you will need to attach a letter from
  your work supervisor with your application stating the impact on your ability to
  complete your assessment.
• Military obligations with proof.
  Note: Equipment failure, loss of data, ‘Heavy work commitments’ or late starting of the
  course are not sufficient grounds for an extension.
  Applications for extensions must be lodged with the Course Coordinator before the due
  date of the assignment.
  Late submissions without an approved extension will incur a penalty of -30% of your
  mark. No more late submission will be accepted after the end of swot-vac week.
  Academic Misconduct
  Students are reminded that they should be aware of the academic misconduct guidelines
  available from the University of South Australia website.
  Deliberate academic misconduct such as plagiarism is subject to penalties. Information
  about Academic integrity can be found in Section 9 of the Assessment policies and
  procedures manual at:
  https://i.unisa.edu.au/polici...

• 16 -
  Sample Output
  Sample Output 1:
  Players info successfully loaded.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Lisa Smith 16 13 2 1 81.2% 105
  John Doe 5 4 0 1 80.0% 70
  Andrew Whittaker 7 0 7 0 0.0% 55

  Please enter a command [list, add, remove, play, winner,
  quit]: add
  Name: Steve Jobs
  Successfully added player Steve Jobs.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Lisa Smith 16 13 2 1 81.2% 105
  Steve Jobs 0 0 0 0 0.0% 100
  John Doe 5 4 0 1 80.0% 70
  Andrew Whittaker 7 0 7 0 0.0% 55

  Please enter a command [list, add, remove, play, winner,
  quit]: add
  Name: John Doe
  Player John Doe already exists.
  Please enter a command [list, add, remove, play, winner,
  quit]: remove
  Name: Bill Gates
  No such player found.
  Please enter a command [list, add, remove, play, winner,
  quit]: remove
  Name: John Doe
  Successfully removed player John Doe.
  Please enter a command [list, add, remove, play, winner,
  quit]: list

• 17 -
  Player Name P W L T W-Rate Points
  Lisa Smith 16 13 2 1 81.2% 105
  Steve Jobs 0 0 0 0 0.0% 100
  Andrew Whittaker 7 0 7 0 0.0% 55

  Please enter a command [list, add, remove, play, winner,
  quit]: play
  Name: John Doe
  No such player found.
  Please enter a command [list, add, remove, play, winner,
  quit]: play
  Name: Steve Jobs
  How many points to bid (1-100)? 0
  How many points to bid (1-100)? 30
  Which game ([r]Rock-Paper-Scissors, [c]Code Break)? c
  Let\'s play Code Break!
  Find the secret code in less than 5 guesses to win.
  Trial #1: abc
  Code must be 3 digits with all different numbers.
  Trial #1: 111
  Code must be 3 digits with all different numbers.
  Trial #1: 1234
  Code must be 3 digits with all different numbers.
  Trial #1: 123
  Wrong code!
  Correct digit(s): 1 / Misplaced number(s): 0
  Number of trials left: 4
  Trial #2: 453
  Correct code!
  You win!
  You now have 130 points.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Steve Jobs 1 1 0 0 100.0% 130
  Lisa Smith 16 13 2 1 81.2% 105
  Andrew Whittaker 7 0 7 0 0.0% 55

  Please enter a command [list, add, remove, play, winner,
  quit]: winner
  Steve Jobs has 130 points and a winning rate of 100.0%.

• 18 -
  Please enter a command [list, add, remove, play, winner,
  quit]: debug
  Debug mode is ON.
  Please enter a command [list, add, remove, play, winner,
  quit]: play
  Name: Lisa Smith
  How many points to bid (1-105)? 120
  How many points to bid (1-105)? 50
  Which game ([r]Rock-Paper-Scissors, [c]Code Break)? c
  Let\'s play Code Break!
  Find the secret code in less than 5 guesses to win.
  DEBUG: 123
  Trial #1: 456
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 0
  Number of trials left: 4
  Trial #2: 712
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 2
  Number of trials left: 3
  Trial #3: 172
  Wrong code!
  Correct digit(s): 1 / Misplaced number(s): 1
  Number of trials left: 2
  Trial #4: 128
  Wrong code!
  Correct digit(s): 2 / Misplaced number(s): 0
  Number of trials left: 1
  Trial #5: 123
  Correct code!
  Tie!
  No changes to your points.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Steve Jobs 1 1 0 0 100.0% 130
  Lisa Smith 17 13 2 2 76.5% 105
  Andrew Whittaker 7 0 7 0 0.0% 55

  Please enter a command [list, add, remove, play, winner,
  quit]: debug
  Debug mode is OFF.
  Please enter a command [list, add, remove, play, winner,
  quit]: play
  Name: Steve Jobs

• 19 -
  How many points to bid (1-130)? 130
  Which game ([r]Rock-Paper-Scissors, [c]Code Break)? c
  Let\'s play Code Break!
  Find the secret code in less than 5 guesses to win.
  Trial #1: 123
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 0
  Number of trials left: 4
  Trial #2: 456
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 0
  Number of trials left: 3
  Trial #3: 789
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 2
  Number of trials left: 2
  Trial #4: 780
  Wrong code!
  Correct digit(s): 0 / Misplaced number(s): 3
  Last chance to make it a tie game.
  Trial #5: 078
  Wrong code!
  The secret code is: 807
  You lose!
  Oh no! You ran out of points!
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Lisa Smith 17 13 2 2 76.5% 105
  Andrew Whittaker 7 0 7 0 0.0% 55
  Steve Jobs 2 1 1 0 50.0% 0

  Please enter a command [list, add, remove, play, winner,
  quit]: play
  Name: Steve Jobs
  Not enough points to play.
  Please enter a command [list, add, remove, play, winner,
  quit]: winner
  Lisa Smith has 105 points and a winning rate of 76.5%.
  Please enter a command [list, add, remove, play, winner,
  quit]: quit
  Thank you for playing!
  Players info successfully saved.

• 20 -
  Sample Output 2 (in case players.txt is not available):
  ERROR: Cannot load players info.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  No player to display.

  Please enter a command [list, add, remove, play, winner,
  quit]: winner
  There is no winner.
  Please enter a command [list, add, remove, play, winner,
  quit]: add
  Name: Bill Gates
  Successfully added player Bill Gates.
  Please enter a command [list, add, remove, play, winner,

  quit]: list
  Player Name P W L T W-Rate Points
  Bill Gates 0 0 0 0 0.0% 100

  Please enter a command [list, add, remove, play, winner,
  quit]: winner
  Bill Gates has 100 points, and never played a game.
  Please enter a command [list, add, remove, play, winner,
  quit]: quit
  Thank you for playing!
  Players info successfully saved.

• 21 -
  Marking Criteria
  This assignment is worth 20% of your grade. Marking will follow a demo similar to the
  scenarios shown in the Sample Output section.
  Category Mark
  Produces correct results
  Proper error message shown when cannot load data from player.txt. / 0.5
  Proper success message shown after loading data from player.txt. / 0.5
  list command prints a leader board. / 0.5
  The leader board is printed in a correct format as specified. / 0.5
  add command successfully adds a new player initialised with 100 points. / 0.5
  add command properly fails if the player already exists. / 0.5
  remove command successfully removes an existing player. / 0.5
  remove command properly fails if the player does not exist. / 0.5
  play command properly fails if the player does not exist. / 0.5
  play command properly fails if the player has no points to play. / 0.5
  play command asks for bidding with correct range of points available. / 0.5
  Code Break Game generates a random secret code in a valid form. / 0.5
  Code Break Game shows the secret code only when debug mode is on. / 0.5
  Code Break Game asks users to guess up to 5 trials or until correct guess. / 0.5
  Code Break Game asks again if the user’s input is an invalid code. / 0.5
  Code Break Game provides correct feedback for a wrong guess. / 0.5
  Code Break Game returns a number according to the final results. / 0.5
  Code Break Game prints output in a correct format as specified. / 0.5
  The leader board is properly updated and sorted based on the results. / 0.5
  winner command prints correct output in proper format. / 0.5
  winner command prints no winner message when no players available. / 0.5
  The leader board displays correct message when there is no player. / 0.5
  quit command shows output of confirming the player info being saved. / 0.5
  The player information is saved into output.txt in correct format. / 0.5
  Sub-Total / 12
  Adheres to specifications
  Uses the provided files without any modification. / 1
  Class definitions organised into python modules as specified: player.py,
  leaderboard.py, and codebreakgame.py.
  / 1
  Player class defines all of the specified methods. / 0.5
  LeaderBoard class defines all of the specified methods. / 1
  CodeBreak class defines all of the specified methods. / 0.5
  Proper use of classes and objects practising data encapsulation,
  inheritance and polymorphism, as specified.
  / 1
  Appropriate and well-constructed while, for, and if statements. / 1
  Sub-Total / 6
• 22 -
  Coding style
  Comment at the beginning of each file with student details. / 0.5
  Comment on code with sufficient details. (e.g., when defining a variable,
  function, or method, and for each significant section of code)
  / 0.5
  Naming identifiers must use camelCase or under_score style. / 0.5
  Meaningful names. (e.g., no single letter variable names, except for index) / 0.5
  Sub-Total / 2
  Crash
  If your program crashes in certain cases, it will incur -1 mark per such case.
  Total / 20
  Late Submissions without a granted extension will get a penalty of -30%.
• The end -
  WX：codehelp