Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Latest commit

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Exercise #9: Deck of Cards

exercise status: released

Exercise details

In this exercise we are going to create a package that can be used to build decks of cards. You can learn a lot simply coding this on your own, but I am going to specifically include the following topics:

  1. Sorting (using the sort package)
  2. Shuffling with permutations (using the math/rand package)
  3. go generate with stringer
  4. Functional options (for practice)

Along the way we will also learn a little bit about constants, iota, and other aspects of using Go.

NOTE: We will be using this package in the next two Gophercises exercises, so if you opt to write it on your own you may want to work on at least the next exercise before watching the videos. That will help you understand how this package will be used and allow you to design a much better API.

To start, create a package named deck, and in it create a type named Card that will be exported, and is used to represent a playing card. Try not to add any game-specific logic to the Card type and instead focus on attributes that are true of a card regardless of the game you are playing. For instance, an "ace of hearts" could be represented as a card with a numeric value of 1, and a suit of hearts, but we want to avoid giving it a specific score value as that can change from game to game.

After creating the Card type and any helper methods you deem useful, add a New function to the deck package that can be used to generate a deck of cards (represented as []Card should be fine - I don't believe we will need a custom Deck type). I will be writing my code to generate the cards in the default order a deck of cards comes in (shown below), but you can do this however you see fit.

NOTE: A brand new deck of cards is typically sorted by suit, so that the 13 cards in the deck are all spades, the next 13 diamonds, the next 13 clubs, and the last 13 hearts. Some decks have Jokers, but I'm going to leave those out for now. Inside each suit the cards are sorted in the order A,1,2,3,...,10,J,Q,K.

Once you have your New function working, add some options to be used when creating a deck of cards. I'll be using functional options for these, but you can experiment with other approaches if you want. I suggest implementing the following options:

  • An option to sort the cards with a user-defined comparison function. The sort package in the standard library can be used here, and expects a less(i, j int) bool function.
  • A default comparison function that can be used with the sorting option.
  • An option to shuffle the cards.
  • An option to add an arbitrary number of jokers to the deck.
  • An option to filter out specific cards. Many card games are played without 2s and 3s, while others might filter out other cards. We can provide a generic way to handle this as an option.
  • An option to construct a single deck composed of multiple decks. This is used often enough in games like blackjack that having an option to build a deck of cards with say 3 standard decks can be useful.

Bonus

Once you have your package created, try to comment the code if you haven't already and look at how to run a local godoc server. You should take some time to learn a little about how you can document your code to make it easier for future developers to use.

About

Ex 9 - Deck of cards

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors