feat: Add combined norm (average between M and F norms)

Author: edersoncorbari

README.md

@@ -140,12 +140,17 @@ answers300 = json.loads(data)
 
 The **compute** method is used to evaluate the answers, see the table below with the parameters:
 
-| Parameters    | Type      | Description                                               |
-| ------------- | --------- | --------------------------------------------------------- |
-| sex           | string    | Sex assigned at birth (M or F).                           |
-| age           | int       | Age (in years between 10 and 110 years old).              |
-| answers       | dict      | Standardized dictionary with answers.                     |
-| compare       | boolean   | If true, it shows the user's answers and reverse score.   |
+| Parameters    | Type      | Description                                                                          |
+| ------------- | --------- | ------------------------------------------------------------------------------------ |
+| sex           | string    | Sex assigned at birth or self-identified gender (M, F, or N for neutral/non-binary). |
+| age           | int       | Age (in years between 10 and 110 years old).                                         |
+| answers       | dict      | Standardized dictionary with answers.                                                |
+| compare       | boolean   | If true, it shows the user's answers and reverse score.                              |
+
+✅ Explanation:  
+- `sex="N"` represents a **neutral or non-binary** individual.  
+- In this case, the **algorithm averages the male and female norms** to generate standardized scores.
+- This approach ensures compatibility with the original calculation logic while providing inclusive results.  
 
 Calculate the Big Five for a **40-year-old man**:
 
@@ -165,6 +170,12 @@ Calculating the Big Five for a **25-year-old woman**:
 IpipNeo(question=120).compute(sex="F", age=25, answers=answers120)
 ```
 
+Calculating the Big Five for a **25-year-old neutral**:
+
+```python
+IpipNeo(question=120).compute(sex="N", age=25, answers=answers120)
+```
+
 An example of the output of the results:
 
 ```json

ipipneo/quiz.py

@@ -381,11 +381,11 @@ def main() -> None:
     replies = map(
         input,
         chain(
-            ["\n> What is your sex Male or Female? M / F: "],
-            repeat("Please, only M or F are valid! Try again: "),
+            ["\n> What is your sex? Male, Female, or Neutral? M / F / N: "],
+            repeat("Please, only M, F, or N are valid! Try again: "),
         ),
     )
-    sex = str(next(filter({"F", "f", "M", "m"}.__contains__, replies)))
+    sex = str(next(filter({"F", "f", "M", "m", "N", "n"}.__contains__, replies)))
 
     replies = map(
         input,

setup.py

@@ -10,7 +10,7 @@
 with codecs.open(os.path.join(here, "README.md"), encoding="utf-8") as fh:
     long_description = "\n" + fh.read()
 
-VERSION = "1.12.1"
+VERSION = "1.13.1"
 DESCRIPTION = "Big 5 IPIP-NEO Personality Traits"
 LONG_DESCRIPTION = "Library with a self-administered questionnaire that assesses a person's personality according to the Big Five Model, using the IPIP-NEO."
 

test/test_utility.py

@@ -43,6 +43,7 @@ def test_raise_if_sex_is_invalid(self) -> None:
 
         self.assertEqual(raise_if_sex_is_invalid(sex="M"), True)
         self.assertEqual(raise_if_sex_is_invalid(sex="F"), True)
+        self.assertEqual(raise_if_sex_is_invalid(sex="N"), True)
 
     def test_raise_if_age_is_invalid(self) -> None:
         with self.assertRaises(BaseException):