Add pick_music function + full test coverageMusic function

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: CI / CD
+on:
+    pull_request:
+        branches:
+            - pipfile-experiment
+jobs:
+    build:
+        runs-on: ubuntu-latest
+        timeout-minutes: 5
+        strategy:
+            matrix:
+                python-version: ["3.9", "3.11"]
+        steps:
+            - uses: actions/checkout@v4
+            - name: Install Python, pipenv and Pipfile packages
+              uses: kojoru/prepare-pipenv@v1
+              with:
+                  python-version: ${{ matrix.python-version }}
+            - name: Turn on 'editable' mode
+              run: |
+                  pipenv install -e .
+            - name: Test with pytest
+              run: |
+                  pipenv install pytest
+                  pipenv --venv
+                  pipenv run python -m pytest tests/tests.py -v
+    deliver:
+        needs: [build]
+        runs-on: ubuntu-latest
+        timeout-minutes: 5
+        steps:
+            - uses: actions/checkout@v4
+            - name: Install Python, pipenv and Pipfile packages
+              uses: kojoru/prepare-pipenv@v1
+            - name: Build package
+              run: |
+                  pipenv install build
+                  pipenv run python -m build .
+            - name: Publish to PyPI test server
+              uses: pypa/gh-action-pypi-publish@release/v1
+              with:
+                  password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+                  repository-url: https://test.pypi.org/legacy/ 

Pipfile

@@ -0,0 +1,15 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+dailydecisionpackage = {file = ".", editable = true}
+
+[dev-packages]
+pytest = "*"
+build = "*"
+twine = "*"
+
+[requires]
+python_version = "3"

README.md

@@ -1,3 +1,116 @@
-# Python Package Exercise
+[![CI / CD](https://github.com/swe-students-fall2025/3-python-package-team_aurora/actions/workflows/test.yml/badge.svg)](https://github.com/swe-students-fall2025/3-python-package-team_aurora/actions/workflows/test.yml)
 
-An exercise to create a Python package, build it, test it, distribute it, and use it. See [instructions](./instructions.md) for details.
+# Python Package Exercise - Daily Decision Helper
+
+## Overview
+
+Do you ever struggle to make everyday decisions? Whether it's choosing what to eat for lunch, picking an outfit color, or deciding what music to listen to, sometimes the smallest choices can feel overwhelming. DailyDecisions is here to help! This Python package takes the stress out of life's minor decisions by providing randomized suggestions when you need them most.
+
+## Installation
+
+1. Install the package using `pipenv`: `pipenv install -i https://pypi.org/simple/dailyDecisionPackage`
+2. Activate the virtual environment: `pipenv shell`
+3. Create a Python program file that imports the package and uses it, e.g.:
+    ```
+    from dailyDecisionPackage import dailyDecision
+
+    # This would print out the randomly suggested color
+    dailyDecision.pick_color()
+    ```
+4. Run the program: `python filename.py`
+5. Exit the virutal environment: `exit`
+
+## Features
+
+This package provides a few functions to help with your daily decision making:
+
+-   `dailyDecision.pick_clothes(weather, occasion)` - a function to help you pick clothes based on the weather and/or occasion.
+-   `dailyDecision.pick_food(dietary_restriction)` - a function to help you pick a food based on your dietary restriction.
+-   `dailyDecision.pick_color(mood, season)` - a function to help you pick a color (of clothing) based on your mood and/or the season.
+-   `dailyDecision.pick_activity(weather, energy_level)` - a function to help you pick an activity to do based on your energy level and/or the weather.
+
+## Usage
+### Import the Package
+`from dailyDecisionPackage import dailyDecision`
+
+### Function Documentation
+1. `dailyDecision.pick_clothes(weather, occasion)`  
+Suggests clothing items based on weather conditions and/or the occasion.  
+
+    **Parameters**:  
+    - `weather` (optional): The weather condition - "sunny", "rainy", "snowy", or "windy"  
+    - `occasion` (optional): The occasion or dress code - "casual", "formal", "athletic", "party", or "beach"  
+
+    **Behavior**:
+    - No arguments: Returns a random clothing item from all available options
+    - Only weather: Returns clothing appropriate for that weather
+    - Only occasion: Returns clothing appropriate for that occasion
+    - Both valid arguments: Returns clothing that fits both criteria (or suggests separate items if no match exists)
+    - Invalid input: Displays valid options and suggests a random item from all available options
+
+
+2. `dailyDecision.pick_food(dietary_restriction)`  
+Suggests food options based on dietary restrictions.  
+
+    **Parameters**:  
+    - `dietary_restriction` (optional): Your dietary need - "halal", "high_protein", "jain", "keto", "kosher", "low_carb", "no_dairy", "no_eggs", "no_gluten", "no_nuts", "no_soy", "paleo", "pescatarian", "vegan", or "vegetarian"
+
+    **Behavior**:
+    - No argument: Returns a random food from all available options
+    - Valid restriction: Returns food that meets the specified dietary restriction
+    - Invalid restriction: Displays valid options and suggests a random food from all available options
+
+3. `dailyDecision.pick_color(mood, season)`  
+Suggests colors based on your mood and/or the current season.
+
+    **Parameters**:
+    - `mood` (optional): Your emotional state - "happy", "sad", "calm", "energetic", or "angry"
+    - `season` (optional): The current season - "winter", "fall", "summer", or "spring"
+
+    **Behavior**:
+    - No arguments: Returns a random color from all available options
+    - Only mood: Returns a color matching that mood
+    - Only season: Returns a color matching that season
+    - Both valid arguments: Returns a color that fits both (or suggests separate colors if no perfect match)
+    - Both arguments, but only mood is valid: Displays valid options for seasons and suggests a random color matching the mood
+    - Both arguments, but only season is valid: Displays valid options for moods and suggests a random color matching the season
+    - Invalid input: Displays valid options and suggests a random color from all available options
+
+4. `dailyDecision.pick_activity(weather, energy_level)`  
+Suggests activities based on weather conditions and/or your energy level.
+
+    **Parameters**:
+    - `weather` (optional): The weather condition - "sunny", "cloudy", "rainy", or "snowy"
+    - `energy_level` (optional): Your current energy - "low", "medium", or "high"
+
+    **Behavior**:
+    - No arguments: Returns a random activity from all available options
+    - Only weather: Returns activities suitable for that weather
+    - Only energy level: Returns activities matching your energy level
+    - Both arguments: Returns activities that fit both criteria
+    - Invalid input: Displays valid options and suggests a random activity from all available options
+
+### Example
+For a complete example program that demonstrates all four functions with various parameter combinations, see [exampleUsage.py](./examples/exampleUsage.py).  
+To run the example from root: `python examples/exampleUsage.py`
+
+## Contributing
+Want to contribute to this project? Here's how to get started:
+1. **Clone the repository:**
+    `https://github.com/swe-students-fall2025/3-python-package-team_aurora.git`
+2. **Install pipenv** (if not already installed): `pip install pipenv`
+3. **Install dependencies:** `pipenv install --dev`
+4. **Activate the virtual environment:** `pipenv shell`
+
+### Unit tests
+Run the unit tests using pytest: `pipenv run pytest tests/tests.py`
+
+### Building the Package
+To build the package locally: `pipenv run python -m build`
+
+## Team members:
+
+[Maria Lee](https://github.com/MariaLuo826)  
+[Reece Huey](https://github.com/Coffee859)  
+[Jubilee Tang](https://github.com/MajesticSeagull26)  
+[Anshu Aramandla](https://github.com/aa10150)

examples/exampleUsage.py

@@ -0,0 +1,157 @@
+from dailyDecisionPackage import dailyDecision
+
+print("=" * 70)
+print("DAILY DECISION PACKAGE - EXAMPLE USAGE")
+print("=" * 70)
+print()
+
+# PICK COLOR FUNCTION
+print("\n" + "=" * 70)
+print("1. pick_color(mood, season) - Get color suggestions based on mood and/or season")
+print("=" * 70)
+print()
+
+print("Example 1.1: No arguments - random color")
+print("-" * 70)
+dailyDecision.pick_color()
+print()
+
+print("Example 1.2: Only mood provided")
+print("-" * 70)
+dailyDecision.pick_color(mood="happy")
+print()
+
+print("Example 1.3: Only season provided")
+print("-" * 70)
+dailyDecision.pick_color(season="summer")
+print()
+
+print("Example 1.4: Both mood and season provided")
+print("-" * 70)
+dailyDecision.pick_color(mood="happy", season="summer")
+print()
+
+print("Example 1.5: Invalid mood")
+print("-" * 70)
+dailyDecision.pick_color(mood="upset")
+print()
+
+print("Example 1.6: Invalid season")
+print("-" * 70)
+dailyDecision.pick_color(season="test")
+print()
+
+print("Example 1.7: Valid season but invalid mood")
+print("-" * 70)
+dailyDecision.pick_color(season="summer", mood="upset")
+print()
+
+print("Example 1.8: Valid mood but invalid season")
+print("-" * 70)
+dailyDecision.pick_color(season="test", mood="energetic")
+print()
+
+print("Example 1.9: Both invalid")
+print("-" * 70)
+dailyDecision.pick_color(season="test", mood="upset")
+print()
+
+# PICK CLOTHES FUNCTION
+print("\n" + "=" * 70)
+print(
+    "2. pick_clothes(weather, occasion) - Get clothing suggestions based on weather and/or occasion"
+)
+print("=" * 70)
+print()
+
+print("Example 2.1: No arguments - random clothing")
+print("-" * 70)
+dailyDecision.pick_clothes()
+print()
+
+print("Example 2.2: Only weather provided")
+print("-" * 70)
+dailyDecision.pick_clothes(weather="sunny")
+print()
+
+print("Example 2.3: Only occasion provided")
+print("-" * 70)
+dailyDecision.pick_clothes(occasion="casual")
+print()
+
+print("Example 2.4: Both weather and occasion provided")
+print("-" * 70)
+dailyDecision.pick_clothes(weather="rainy", occasion="formal")
+print()
+
+print("Example 2.5: Invalid weather")
+print("-" * 70)
+dailyDecision.pick_clothes(weather="invalid")
+print()
+
+print("Example 2.6: Invalid occasion")
+print("-" * 70)
+dailyDecision.pick_clothes(occasion="invalid")
+
+
+# PICK FOOD FUNCTION
+print("\n" + "=" * 70)
+print(
+    "3. pick_food(dietary_restriction) - Get food suggestions based on dietary restrictions"
+)
+print("=" * 70)
+print()
+
+print("Example 3.1: No restriction - random food")
+print("-" * 70)
+dailyDecision.pick_food()
+print()
+
+print("Example 3.2: dietary_restriction provided")
+print("-" * 70)
+dailyDecision.pick_food("vegetarian")
+print()
+
+print("Example 3.3: Unsupported restriction")
+print("-" * 70)
+dailyDecision.pick_food("invalid")
+print()
+
+# PICK ACTIVITY FUNCTION
+print("\n" + "=" * 70)
+print(
+    "4. pick_activity(weather, energy_level) - Get activity suggestions based on weather and/or energy level"
+)
+print("=" * 70)
+print()
+
+print("Example 4.1: No arguments - random activity")
+print("-" * 70)
+dailyDecision.pick_activity()
+print()
+
+print("Example 4.2: Only weather provided")
+print("-" * 70)
+dailyDecision.pick_activity(weather="sunny")
+print()
+
+print("Example 4.3: Only energy level provided")
+print("-" * 70)
+dailyDecision.pick_activity(energy_level="high")
+print()
+
+print("Example 4.4: Both weather and energy level provided")
+print("-" * 70)
+dailyDecision.pick_activity(weather="snowy", energy_level="low")
+print()
+
+print("Example 4.5: Invalid weather")
+print("-" * 70)
+dailyDecision.pick_activity(weather="invalid")
+print()
+
+print("Example 4.6: Invalid energy level")
+print("-" * 70)
+dailyDecision.pick_activity(energy_level="invalid")
+print()
+

pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dailyDecisionPackage"
+description = "A lighthearted Python package that helps you make everyday decisions."
+version = "0.1.2"
+authors = [
+    { name = "Jubilee Tang" },
+    { name = "Maria Lee" },
+    { name = "Reece Huey" },
+    { name = "Anshu Aramandla"}
+]
+license = "GPL-3.0-or-later"
+license-files = ["LICENSE"]
+readme = "README.md"
+keywords = ["python", "package", "daily", "decision", "helper", "color", "food"]
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Intended Audience :: Education",
+    "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "build", "twine"]
+
+[project.urls]
+"Homepage" = "https://github.com/swe-students-fall2025/3-python-package-team_aurora"
+"Repository" = "https://github.com/swe-students-fall2025/3-python-package-team_aurora.git"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+dailyDecisionPackage = ["*.txt", "*.md"]