From 768b3c553b47eff03978ea33c0364f30b29d0d5b Mon Sep 17 00:00:00 2001
From: colinleach <colin.leach@comcast.net>
Date: Sun, 31 Mar 2024 11:18:35 -0700
Subject: [PATCH] [D&D Character] draft approaches

---
 .../dnd-character/.approaches/config.json     |   7 +
 .../dnd-character/.approaches/introduction.md | 136 ++++++++++++++++++
 2 files changed, 143 insertions(+)
 create mode 100644 exercises/practice/dnd-character/.approaches/config.json
 create mode 100644 exercises/practice/dnd-character/.approaches/introduction.md

diff --git a/exercises/practice/dnd-character/.approaches/config.json b/exercises/practice/dnd-character/.approaches/config.json
new file mode 100644
index 0000000000..21b3a12720
--- /dev/null
+++ b/exercises/practice/dnd-character/.approaches/config.json
@@ -0,0 +1,7 @@
+{
+  "introduction": {
+    "authors": ["colinleach",
+                "BethanyG"],
+    "contributors": []
+  }
+}
diff --git a/exercises/practice/dnd-character/.approaches/introduction.md b/exercises/practice/dnd-character/.approaches/introduction.md
new file mode 100644
index 0000000000..f1a0d7cf48
--- /dev/null
+++ b/exercises/practice/dnd-character/.approaches/introduction.md
@@ -0,0 +1,136 @@
+# Introduction
+
+This exercise has two main purposes:
+
+- To practice class-based programming, especially initialization of instance variables.
+- To practice random numbers.
+
+There are no complicated decisions to make about which algorithm to use, as the tests constrain the implementation.
+
+This document will mostly explore some variations in Python syntax.
+
+## General considerations
+
+Several items are specifically required by the tests:
+
+- A standalone function called `modifier()`.
+- A `Character` class.
+- Instance variables for 6 named abilities, plus one for hitpoints.
+- An instance method called `ability()` to handle dice throws.
+
+Further methods are optional, but may be helpful with random dice rolls.
+
+## The `modifier()` function
+
+This function needs integer division:
+
+```python
+def modifier(constitution):
+    return (constitution - 10) // 2
+```
+
+In Python 3.x, the division operators are `/` for floating point and `//` for integer division (ignore any old Python 2.x documentation you may find).
+
+Integer division will always round *down*: not to the nearest integer and not towards zero:
+
+```python
+>>> 11 // 3
+3
+>>> -11 // 3
+-4
+```
+
+Using `math.floor()` here will work, but slightly misses the point of what is being practised, as well as forcing an unnecessary import.
+
+## Dice rolls
+
+The instructions are to roll four 6-sided dice and record the sum of the largest three dice.
+
+To roll a die we need the [`random`][random] module.
+
+There are various suitable options available, including `random.randint()` and `random.choice()` for a single throw or `random.sample()` for multiple rolls.
+Note that `randint(lower, upper)` *includes* the upper bound, in contrast to `range(lower, uppper + 1)`.
+
+To roll four dice may need a list comprehension:
+
+```python
+    def dice_rolls_1(self):
+        return [random.randint(1, 6) for _ in range(4)]
+
+    def dice_rolls_2(self):
+        return [random.choice(range(1,7)) for _ in range(4)]
+
+    def four_dice_rolls(self):
+        return random.sample(range(1, 7), 4)
+```
+
+Some community solutions begin with a call to `random.seed()` but (at least in recent versions of Python) calling this without a parameter has exactly the same effect as omitting it.
+The value of this method is in debugging situations when it helps to have a reproducible sequence of results.
+Then we would call it with a known seed such as `random.seed(42)`.
+
+After rolling four dice, next we need to sum the largest three scores, discarding the lowest.
+
+Most Python programmers use a list sort and slicing for this:
+
+```python
+# the dice variable was generated as a 4-element list, as above
+sum(sorted(dice)[1:4])
+```
+
+In some ways simpler, we could use the built-in `sum()` and `min()` functions to subtract the smallest score from the total:
+
+```python
+# the dice variable was generated as a 4-element enumerable, as above
+sum(dice) - min(dice)
+```
+
+In this second case, `dice` can be any enumerable, not just a list.
+
+## Class initialization
+
+The various abilities need to be set just once for each character, which is most conveniently done in the class initializer.
+
+The examples below assume that `modifier()` and `self.ability()` are implemented as dicussed above
+
+The explicit approach is simple but rather verbose and repetitive:
+
+```python
+class Character:
+    def __init__(self):
+        self.strength = self.ability()
+        self.dexterity = self.ability()
+        self.constitution = self.ability()
+        self.intelligence = self.ability()
+        self.wisdom = self.ability()
+        self.charisma = self.ability()
+        self.hitpoints = 10 + modifier(self.constitution)
+```
+
+Alternatively, we could start from a tuple of ability names then loop over these using [`setattr()`][setattr]:
+
+```python
+ABILITIES = (
+    'strength',
+    'dexterity',
+    'constitution',
+    'intelligence',
+    'wisdom',
+    'charisma'
+)
+
+class Character:
+    def __init__(self):
+        for ability_name in ABILITIES:
+            setattr(self, ability_name, self.ability())
+        self.hitpoints = modifier(self.constitution) + 10
+```
+
+The key to this is that these two expressions have identical results:
+
+```python
+    setattr(self, 'strength`, self.ability())
+    self.strength = self.ability()
+```
+
+[random]: https://exercism.org/tracks/python/concepts/random
+[setattr]: https://docs.python.org/3/library/functions.html#setattr