1. card.py
2. deck.py

class Card:
    """
    A class to represent a standard playing card. The ranks are ints:
    2-10 for numbered cards, 11=Jack, 12=Queen, 13=King, 14=Ace.
    The suits are strings: 'clubs', 'spades', 'hearts', 'diamonds'.
    """
    
    def __init__(self, rank, suit):
        "Constructs a new Card object with the given rank (an int) and suit (a string)."
        self._rank = rank
        self._suit = suit

    def __str__(self):
        "Returns a string describing the card as 'rank of suit'."
        result = ""
        if self._rank == 11:
            result += "Jack"
        elif self._rank == 12:
            result += "Queen"
        elif self._rank == 13:
            result += "King"
        elif self._rank == 14:
            result += "Ace"
        else:
            result += str(self._rank)
        result += " of " + self._suit
        return result
        
    def getRank(self):
        "Returns rank."	
        return self._rank

    def getSuit(self):
        "Returns suit."
        return self._suit
        
    def getRummyValue(self):
        "Returns the value of the card in the game of Rummy."
        if self._isFaceCard(): # handles face cards
            return 10
        elif self.rank == 14: # handles Ace
            return 15
        elif self.rank == 10: # handles 10
            return 10
        else:
            return 5
            
    def __eq__(self, other):
        """Returns true if this object and other are equivalent
        based on their rank and suit"""
        
        # verify that self and other are the same type
        if type(self) != type(other):
            return False
        # do comparison
        return self._rank == other._rank and self._suit == other._suit
        
    def __lt__(self, other):
        """ Compares Card objects by their rank"""
        
        # verify that self and other are the same type
        if type(self) != type(other):
            return False
            
        # do comparison
        return self._rank < other._rank
        
    def _isFaceCard(self):
        "Returns True iff the card is a face card."
        if self.rank > 10 and self.rank < 14:
            return True
        return False

        
def main():
    c1 = Card(14, "spades")
    print(c1)
    c2 = Card(13, "hearts")
    print(c2)
    c3 = Card(2, "diamonds")
    print(c3)
    
    # testing rummyValue() method
    testCases = [c1, c2, c3]
    expected = [15, 10, 5]

    for pos in range(len(testCases)):
        testCase = testCases[pos] # what data type is this?
        actualVal = testCase.getRummyValue()
        if actualVal == expected[pos]:
            print("Success for getRummyValue on", testCase, "-->", actualVal)
    
    # test equals
    result = c1 == "a string"
    print(result, "should be False")
    
    result = c1 == c2
    print(result, "should be False")
    
    result = c1 < c2
    print(result, "should be False")
    # 
    result = c2 < c1
    print(result, "should be True")
    
    print("\nTested cards in sorted order:")
    testCases.sort()
    for card in testCases:
        print(card)
    
# Since I am probably going to import this script into another script,
# I only want to call main() when it's *not* imported 
if __name__ == '__main__':
    main()

# Implementation of a deck of cards.
# by CSCI 111, 03/19/2012

from card import *
from random import shuffle

class Deck:
    """ A class to represent a deck of playing cards."""
    
    def __init__(self):
        """Creates a new Deck object, filled with one of each
        unique card."""
        
        self._listOfCards = []
        for suit in ["clubs","hearts","diamonds","spades"]:
            for rank in range(2,15):
                myCard = Card(rank, suit)
                self._listOfCards.append(myCard)

    def __str__(self):
        """Returns a string representing the cards that are
        in the deck."""
        
        deckRep= ""
        for card in self._listOfCards:
            deckRep += str(card) + "\n"
        return deckRep

    def numRemaining(self):
        """Returns the number of cards left in the deck."""
        return len(self._listOfCards)
        
    def deal(self, numCards):
        """Returns a list of cards dealt from the deck.
        Assumes there are enough cards in the deck."""
        dealtList = []
        for x in range(numCards):
            card = self._listOfCards.pop(0)
            dealtList.append(card)
        return dealtList
        
    def shuffle(self):
        shuffle(self._listOfCards)
        
def main():
    d = Deck()
    print(d)
    print("The number of cards remaining in the deck is", d.numRemaining())
    d.shuffle()
    hand = d.deal(5)
    print("My hand is:")
    for card in hand:
        print(card)
    print("The number of cards remaining in the deck is", d.numRemaining())

    
# Since I am probably going to import this script into another script,
# I only want to call main() when it's *not* imported
if __name__ == "__main__":
    main()