Add Band Name Generator project with CLI, tests, and documentation

src/band_name_generator/__init__.py

@@ -0,0 +1 @@
+"""Band Name Generator: combine a hometown and a pet's name into a band name."""

src/band_name_generator/__main__.py

@@ -0,0 +1,3 @@
+from band_name_generator.cli import main
+
+main()

src/band_name_generator/cli.py

@@ -0,0 +1,19 @@
+"""Command-line interface for the Band Name Generator."""
+
+from band_name_generator.generator import generate_band_name
+
+
+def main() -> None:
+    print("Welcome to the Band Name Generator.")
+    city = input("What's the name of the city you grew up in?\n")
+    pet = input("What's the name of a pet?\n")
+    try:
+        band_name = generate_band_name(city, pet)
+    except ValueError as error:
+        print(error)
+        raise SystemExit(1)
+    print(f"Your band name could be: {band_name}")
+
+
+if __name__ == "__main__":
+    main()

src/band_name_generator/generator.py

@@ -0,0 +1,13 @@
+"""Core logic for building a band name."""
+
+
+def generate_band_name(city: str, pet: str) -> str:
+    """Combine a city and a pet's name into a band name.
+
+    Raises ValueError if either value is empty or only whitespace.
+    """
+    city = city.strip()
+    pet = pet.strip()
+    if not city or not pet:
+        raise ValueError("Both the city and the pet's name are required.")
+    return f"{city} {pet}"