Add support for choosing enum variants at random (#42)

* Add at_random method to base enum

* Update changelog

CHANGELOG.md

@@ -1,3 +1,15 @@
+# Unreleased (Nov 2023)
+
+## Additions
+
+- Add `at_random` method to `BaseEnum` for picking an enum value at random.
+
+## Changes
+
+- Update examples in `GroupService` that work with `GroupMemberFragment`.
+
+---
+
 # v0.8.1 (Nov 2023)
 
 ## Additions

wom/enums.py

@@ -23,6 +23,7 @@
 
 from __future__ import annotations
 
+import random
 import typing as t
 from enum import Enum
 
@@ -79,6 +80,14 @@ def from_str_maybe(cls: t.Type[T], value: str) -> t.Optional[T]:
         except ValueError:
             return None
 
+    @classmethod
+    def at_random(cls: t.Type[T]) -> T:
+        """Generates a random variant of this enum.
+
+        Returns:
+            The randomly generated enum."""
+        return random.choice(tuple(cls))
+
 
 class Metric(BaseEnum):
     """Represents a metric, this enum has no attributes itself.