card_deck.py

#!/usr/bin/python3
# -*- coding: utf-8 -*-

# =============================================================================
#
#        FILE:  card_deck.py
#      AUTHOR:  Tan Duc Mai <henryfromvietnam@gmail.com>
#     CREATED:  2021-12-10
# DESCRIPTION:  A module to draw and fill card.
#   I hereby declare that I completed this work without any improper help
#   from a third party and without using any aids other than those cited.
#
# =============================================================================


# ------------------------------- Module Import -------------------------------
from random import shuffle


# ------------------------------ Global Constant ------------------------------
# Contains cards in the format [value, suit]
# DO NOT ACCESS THIS VARIABLE!
# Call draw_card() instead.
deck = []


# ---------------------------- Function Definitions ---------------------------
def draw_card():
    """
    Removes and returns the last item from the global deck.
    The deck will be reset after the last card is drawn.
    """
    global deck
    if len(deck) == 0:
        fill(deck)
    return deck.pop()


def fill(deck):
    """
    DO NOT call this function.
    This function is called automatically by draw_card().
    Creates and returns a new deck of 52 cards.
    Each card is a list in the format [value, suit] e.g., ['Ace', 'Spades'].
    """
    deck.clear()
    for value in [
            'Ace', '2', '3', '4', '5', '6', '7', '8', '9', '10',
            'Jack', 'Queen', 'King'
    ]:
        for suit in [
                'Hearts', 'Spades', 'Diamonds', 'Clubs'
        ]:
            deck.append([value, suit])
    shuffle(deck)