Adding source.

Author: nashysolutions

.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>PlayingCards.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>1</integer>
+		</dict>
+		<key>playing-cards.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

.swiftpm/xcode/package.xcworkspace/xcuserdata/robertnash.xcuserdatad/UserInterfaceState.xcuserstate

@@ -0,0 +1,23 @@
+// swift-tools-version:5.5
+
+import PackageDescription
+
+let package = Package(
+    name: "playing-cards",
+    platforms: [.iOS(.v13), .macOS(.v10_15), .tvOS(.v13), .watchOS(.v6)],
+    products: [
+        .library(
+            name: "PlayingCards",
+            targets: ["PlayingCards"]),
+    ],
+    dependencies: [
+    ],
+    targets: [
+        .target(
+            name: "PlayingCards",
+            dependencies: []),
+        .testTarget(
+            name: "PlayingCardsTests",
+            dependencies: ["PlayingCards"]),
+    ]
+)

.swiftpm/xcode/xcuserdata/robertnash.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,27 @@
+# PlayingCards
+
+![iOS](https://img.shields.io/badge/iOS-13%2B-blue)
+![macOS](https://img.shields.io/badge/macOS-10.15%2B-blue)
+![tvOS](https://img.shields.io/badge/tvOS-13%2B-blue)
+![watchOS](https://img.shields.io/badge/watchOS-6%2B-blue)
+
+A standard 52 deck of [French-suited playing cards](https://en.wikipedia.org/wiki/French-suited_playing_cards).
+
+## Usage
+
+The `Deck` instance has an array of cards. Upon instantiation, 52 cards are populated, in random order. 
+
+```swift
+struct Dealer {
+    
+    private var deck = Deck()
+    
+    mutating func pullCard() -> PlayingCard? {
+        if let card = deck.pullCard() {
+            return card
+        }
+        self.deck = Deck()
+        return pullCard()
+    }
+}
+```

Package.swift

@@ -0,0 +1,30 @@
+import Foundation
+
+public struct Deck {
+    
+    public
+    var cards: [PlayingCard] = []
+    
+    public
+    init() {
+        var collection: [PlayingCard] = []
+        for rank in Rank.allCases {
+            collection.append(PlayingCard(rank: rank, suit: .diamonds))
+            collection.append(PlayingCard(rank: rank, suit: .hearts))
+            collection.append(PlayingCard(rank: rank, suit: .clubs))
+            collection.append(PlayingCard(rank: rank, suit: .spades))
+        }
+        collection.shuffle()
+        cards = collection
+    }
+    
+    /// Extracts a single card from the deck.
+    /// - Returns: The extracted card or nil if the deck is empty.
+    public
+    mutating func pullCard() -> PlayingCard? {
+        guard cards.isEmpty == false else {
+            return nil
+        }
+        return cards.removeLast()
+    }
+}

README.md

@@ -0,0 +1,14 @@
+import Foundation
+
+public struct PlayingCard: Hashable, Identifiable {
+    
+    public var id: Self { self }
+    
+    public let rank: Rank
+    public let suit: Suit
+    
+    public init(rank: Rank, suit: Suit) {
+        self.rank = rank
+        self.suit = suit
+    }
+}

Sources/PlayingCards/Deck.swift

@@ -0,0 +1,7 @@
+import Foundation
+
+public enum Rank: String, CaseIterable {
+    case ace
+    case two, three, four, five, six, seven, eight, nine, ten
+    case jack, queen, king
+}

Sources/PlayingCards/PlayingCard.swift

@@ -0,0 +1,5 @@
+import Foundation
+
+public enum Suit: String, CaseIterable {
+    case spades, hearts, diamonds, clubs
+}

Sources/PlayingCards/Rank.swift

@@ -0,0 +1,17 @@
+import XCTest
+@testable import PlayingCards
+
+final class DeckTests: XCTestCase {
+    
+    private var deck = Deck()
+    
+    func testCount() {
+        XCTAssertTrue(deck.cards.count == 52)
+    }
+        
+    func testPullCard() {
+        XCTAssertNotNil(deck.pullCard())
+        deck.cards.removeAll()
+        XCTAssertNil(deck.pullCard())
+    }
+}