public/subjects/card_deck/README.md

## card_deck

### Instructions

A standard deck of cards has 52 cards: 4 suits and 13 cards per suit.
Represent the cards from a deck:

- Start by creating the `Suit` enum
- implement the associated **function** `random` which returns a random `Suit` (`Heart`, `Diamond`, `Spade` or `Club`)
- Then create the `Rank` enum that can have the value
  `Ace`, `King`, `Queen`, `Jack`, and `Number` associated to an `u8`
  value to represent the ranks 2 through 10
- After create an associated **function** to `Rank` called `Random` that
  returns a random `Rank`
- Finally create a structure name `Card` which has the fields `suit`
  and `rank`

Define:

- The associated **function** `translate` for `Rank` and `Suit`:
  - For `Suit`, `translate` makes the translation between an integer value (u8) and the suit of a card (1 -> Heart, 2 -> Diamonds, 3 -> Spade, 4 -> Club)
  - For `Rank`, `translate` makes the translation between an integer value (u8) and the rank ( 1 -> Ace, 2 -> 2, .., 10 -> 10, 11 -> Jack, 12 -> Queen, 13 -> King)
- The associated **function** `random` for `Rank` and `Suit` which returns a random `Rank` and `Suit` respectively
- Finally define the **function** `winner_card` which returns `true` if the card passed as an argument is an Ace of spades

### Notions

[Crate rand](https://docs.rs/rand/0.5.0/rand/)
[Enums](https://doc.rust-lang.org/book/ch06-00-enums.html)

### Expected Functions and Structures

```rust
pub enum Suit {
}

pub enum Rank {
}

impl Suit {
	pub fn random() -> Suit {
	}

	pub fn translate(value: u8) -> Suit {
	}
}

impl Rank {
	pub fn random() -> Rank {
	}

	pub fn translate(value: u8) -> Rank {
	}
}

pub struct Card {
	pub suit: Suit,
	pub rank: Rank,
}
```

### Usage

Here is a program to test your function

```rust
fn main() {
	let your_card = Card {
		rank: Rank::random(),
		suit: Suit::random(),
	};

	println!("Your card is {:?}", your_card);

	// Now if the card is an Ace of Spades print "You are the winner"
	if card_deck::winner_card(your_card) {
		println!("You are the winner!");
	}
}
```

And its output

```console
$ cargo run
Your card is Card { suit: Club, rank: Ace }
$
```