+ @classmethod
+ def choose_card(cls, cards, board_locations, position=None):
+ # Find which cards are at their maximum and exclude them from
+ # the choice list
+ counts = {}
+ choices = {card['card_name']: card for card in cards}
+ for pos, card in board_locations:
+ if pos == position:
+ # skip the card we're replacing if appropriate
+ continue
+ if isinstance(card, LocationCard):
+ key = card.card_name
+ max_num = card.max_number
+ else:
+ key = card['card_name']
+ max_num = card.get('max_number', 25)
+ counts.setdefault(key, 0)
+ counts[key] += 1
+ if counts[key] >= max_num:
+ if key in choices:
+ del choices[key]
+ return choice(choices.values())
+