| 1 | 1 | class BowlingGame: |
| 2 | 2 | def __init__(self): |
| 3 | | pass |
| 4 | | |
| 3 | """ |
| 4 | Initialize a new bowling game. |
| 5 | """ |
| 6 | self.rolls = [] |
| 7 | self.current_frame = 1 |
| 8 | self.frame_rolls = [] |
| 9 | self.frames = [] |
| 10 | |
| 5 | 11 | def roll(self, pins): |
| 6 | | pass |
| 7 | | |
| 12 | """ |
| 13 | Record a roll in the game. |
| 14 | |
| 15 | Args: |
| 16 | pins (int): Number of pins knocked down in this roll |
| 17 | |
| 18 | Raises: |
| 19 | ValueError: If pins is negative or greater than 10 |
| 20 | IndexError: If trying to roll after the game is complete |
| 21 | """ |
| 22 | # Edge Case: Invalid pin count (negative or more than 10) |
| 23 | if pins < 0 or pins > 10: |
| 24 | raise ValueError("Pins must be between 0 and 10") |
| 25 | |
| 26 | # Edge Case: Cannot knock down more pins than are standing in current frame |
| 27 | if len(self.frames) < 9 and len(self.frame_rolls) > 0 and self.frame_rolls[0] != 10: |
| 28 | # Not a strike and not in 10th frame - check if total exceeds 10 |
| 29 | if self.frame_rolls[0] + pins > 10: |
| 30 | raise ValueError("Cannot knock down more than 10 pins in a frame") |
| 31 | |
| 32 | # Edge Case: 10th frame special validation |
| 33 | if len(self.frames) == 9 and len(self.frame_rolls) > 0: |
| 34 | # In 10th frame, special rules apply |
| 35 | if self.frame_rolls[0] == 10: |
| 36 | # First roll was a strike, second roll can be 0-10 |
| 37 | if len(self.frame_rolls) == 1: |
| 38 | # No validation needed for second roll after strike |
| 39 | pass |
| 40 | elif len(self.frame_rolls) == 2: |
| 41 | # Third roll: if second was strike, can be 0-10, else limited by remaining |
| 42 | if self.frame_rolls[1] == 10: |
| 43 | # Second was strike, third can be 0-10 |
| 44 | pass |
| 45 | else: |
| 46 | # Second was not strike, third limited by remaining pins |
| 47 | if self.frame_rolls[1] + pins > 10: |
| 48 | raise ValueError("Cannot knock down more than 10 pins in a frame") |
| 49 | elif len(self.frame_rolls) == 1 and self.frame_rolls[0] + pins > 10: |
| 50 | # Second roll in 10th frame (not after strike) |
| 51 | raise ValueError("Cannot knock down more than 10 pins in a frame") |
| 52 | elif len(self.frame_rolls) == 2 and self.frame_rolls[0] + self.frame_rolls[1] == 10: |
| 53 | # This is a spare in 10th frame, bonus roll can be 0-10 |
| 54 | pass |
| 55 | |
| 56 | # Edge Case: Game already completed |
| 57 | if len(self.frames) == 10 and not self._needs_fill_balls(): |
| 58 | raise IndexError("Game has already ended") |
| 59 | |
| 60 | # Edge Case: Tenth frame validation |
| 61 | if len(self.frames) == 10 and self._needs_fill_balls(): |
| 62 | # Check if this is a valid fill ball |
| 63 | if not self._is_valid_fill_ball(pins): |
| 64 | raise ValueError("invalid fill balls") |
| 65 | |
| 66 | self.frame_rolls.append(pins) |
| 67 | self.rolls.append(pins) |
| 68 | |
| 69 | # Check if frame is complete |
| 70 | if len(self.frames) < 9: # Frames 1-9 |
| 71 | if pins == 10 or len(self.frame_rolls) == 2: |
| 72 | self.frames.append(self.frame_rolls[:]) |
| 73 | self.frame_rolls = [] |
| 74 | self.current_frame += 1 |
| 75 | elif len(self.frames) == 9: # Tenth frame |
| 76 | # Tenth frame is complete if: |
| 77 | # 1. Strike and 2 more rolls (total 3 rolls) |
| 78 | # 2. Spare and 1 more roll (total 3 rolls) |
| 79 | # 3. Open frame and 2 rolls (total 2 rolls) |
| 80 | if (self.frame_rolls[0] == 10 and len(self.frame_rolls) == 3) or \ |
| 81 | (len(self.frame_rolls) == 3 and self.frame_rolls[0] + self.frame_rolls[1] == 10) or \ |
| 82 | (len(self.frame_rolls) == 2 and self.frame_rolls[0] + self.frame_rolls[1] < 10): |
| 83 | self.frames.append(self.frame_rolls[:]) |
| 84 | self.frame_rolls = [] |
| 85 | self.current_frame += 1 |
| 86 | |
| 8 | 87 | def score(self): |
| 9 | | pass |
| 88 | """ |
| 89 | Calculate the total score for the game. |
| 90 | |
| 91 | Returns: |
| 92 | int: The total score for the game |
| 93 | |
| 94 | Raises: |
| 95 | IndexError: If the game is not yet complete |
| 96 | """ |
| 97 | # Edge Case: Game not complete |
| 98 | if len(self.frames) < 10 or self._needs_fill_balls(): |
| 99 | raise IndexError("Game is not yet complete") |
| 100 | |
| 101 | total_score = 0 |
| 102 | |
| 103 | for frame_num in range(10): |
| 104 | frame = self.frames[frame_num] |
| 105 | |
| 106 | if frame_num < 9: # Frames 1-9 |
| 107 | if frame[0] == 10: # Strike |
| 108 | # Add 10 plus next two rolls |
| 109 | total_score += 10 + self._get_next_two_rolls_for_frame(frame_num) |
| 110 | elif frame[0] + frame[1] == 10: # Spare |
| 111 | # Add 10 plus next roll |
| 112 | total_score += 10 + self._get_next_roll_for_frame(frame_num) |
| 113 | else: # Open frame |
| 114 | total_score += frame[0] + frame[1] |
| 115 | else: # Tenth frame |
| 116 | total_score += sum(frame) |
| 117 | |
| 118 | return total_score |
| 119 | |
| 120 | def _next_roll(self, roll_index): |
| 121 | """ |
| 122 | Get the value of the next roll. |
| 123 | |
| 124 | Args: |
| 125 | roll_index (int): Current roll index |
| 126 | |
| 127 | Returns: |
| 128 | int: Value of the next roll |
| 129 | """ |
| 130 | if roll_index + 1 < len(self.rolls): |
| 131 | return self.rolls[roll_index + 1] |
| 132 | return 0 |
| 133 | |
| 134 | def _next_two_rolls(self, roll_index): |
| 135 | """ |
| 136 | Get the sum of the next two rolls. |
| 137 | |
| 138 | Args: |
| 139 | roll_index (int): Current roll index |
| 140 | |
| 141 | Returns: |
| 142 | int: Sum of the next two rolls |
| 143 | """ |
| 144 | total = 0 |
| 145 | if roll_index + 1 < len(self.rolls): |
| 146 | total += self.rolls[roll_index + 1] |
| 147 | if roll_index + 2 < len(self.rolls): |
| 148 | total += self.rolls[roll_index + 2] |
| 149 | return total |
| 150 | |
| 151 | def _get_next_roll_for_frame(self, frame_index): |
| 152 | """ |
| 153 | Get the first roll of the next frame after the given frame index. |
| 154 | |
| 155 | Args: |
| 156 | frame_index (int): Current frame index (0-8) |
| 157 | |
| 158 | Returns: |
| 159 | int: Value of the first roll in the next frame |
| 160 | """ |
| 161 | if frame_index + 1 < len(self.frames): |
| 162 | return self.frames[frame_index + 1][0] |
| 163 | return 0 |
| 164 | |
| 165 | def _get_next_two_rolls_for_frame(self, frame_index): |
| 166 | """ |
| 167 | Get the sum of the next two rolls after a strike. |
| 168 | |
| 169 | Args: |
| 170 | frame_index (int): Current frame index (0-8) |
| 171 | |
| 172 | Returns: |
| 173 | int: Sum of the next two rolls |
| 174 | """ |
| 175 | # Get rolls from the next frame(s) |
| 176 | if frame_index + 1 >= len(self.frames): |
| 177 | return 0 |
| 178 | |
| 179 | next_frame = self.frames[frame_index + 1] |
| 180 | |
| 181 | # Get the next two rolls from the next frame(s) |
| 182 | # In a perfect game, frame 9 will be [10, 10, 10], so we need rolls 0 and 1 |
| 183 | if len(next_frame) >= 2: |
| 184 | return next_frame[0] + next_frame[1] |
| 185 | elif len(next_frame) == 1: |
| 186 | # Only one roll in next frame, need to get second roll from frame after |
| 187 | total = next_frame[0] |
| 188 | if frame_index + 2 < len(self.frames): |
| 189 | total += self.frames[frame_index + 2][0] |
| 190 | return total |
| 191 | else: |
| 192 | return 0 |
| 193 | |
| 194 | def _needs_fill_balls(self): |
| 195 | """ |
| 196 | Check if the tenth frame needs fill balls. |
| 197 | |
| 198 | Returns: |
| 199 | bool: True if fill balls are needed, False otherwise |
| 200 | """ |
| 201 | if len(self.frames) < 10: |
| 202 | return False |
| 203 | |
| 204 | # If we have 10 frames, check if the 10th frame is complete |
| 205 | tenth_frame = self.frames[9] |
| 206 | |
| 207 | # 10th frame is complete if: |
| 208 | # 1. Open frame (2 rolls, sum < 10) |
| 209 | # 2. Spare (3 rolls: 2 for spare + 1 fill ball) |
| 210 | # 3. Strike (3 rolls: 1 for strike + 2 fill balls) |
| 211 | if len(tenth_frame) == 2 and tenth_frame[0] + tenth_frame[1] < 10: |
| 212 | # Open frame - complete |
| 213 | return False |
| 214 | elif len(tenth_frame) == 3: |
| 215 | # Strike or spare with fill balls - complete |
| 216 | return False |
| 217 | else: |
| 218 | # Incomplete - needs fill balls |
| 219 | return True |
| 220 | |
| 221 | def _is_valid_fill_ball(self, pins): |
| 222 | """ |
| 223 | Check if a fill ball is valid according to bowling rules. |
| 224 | |
| 225 | Args: |
| 226 | pins (int): Number of pins for the fill ball |
| 227 | |
| 228 | Returns: |
| 229 | bool: True if valid, False otherwise |
| 230 | """ |
| 231 | if len(self.frames) < 10: |
| 232 | return True |
| 233 | |
| 234 | tenth_frame = self.frames[9] |
| 235 | |
| 236 | # If tenth frame was a strike |
| 237 | if tenth_frame[0] == 10: |
| 238 | # Second roll of fill balls |
| 239 | if len(self.frame_rolls) == 2: |
| 240 | # If first fill ball was a strike, second can be 0-10 |
| 241 | # If first fill ball was not a strike, second can knock down remaining pins |
| 242 | first_fill = self.frame_rolls[1] |
| 243 | if first_fill == 10: # First fill ball was a strike |
| 244 | return 0 <= pins <= 10 |
| 245 | else: # First fill ball was not a strike |
| 246 | return 0 <= pins <= (10 - first_fill) |
| 247 | # First roll of fill balls |
| 248 | elif len(self.frame_rolls) == 1: |
| 249 | return 0 <= pins <= 10 |
| 250 | # If tenth frame was a spare |
| 251 | elif len(self.frame_rolls) == 2 and tenth_frame[0] + tenth_frame[1] == 10: |
| 252 | return 0 <= pins <= 10 |
| 253 | |
| 254 | return False |
| 255 | |
| 256 | # Handled Edge Cases: Invalid pin count, game already completed, invalid fill balls, game not complete |