pyfundog 0.1.1

A dog-themed Python package

Python Package Exercise

A Python package exercise pyfundog lets you generate ASCII dogs that can speak, bark, wag, and pose.

See instructions for details.

---

Team members:

• Tsengelmurun Enkh-Onon
• Milan Engineer
• Sara Dou
• Jack Escowitz

Features

speak(message, mood)

Returns a dog ASCII with a message and mood (happy, sleepy, angry)

Example:

from pydog import speak

print(speak("hello!", "happy"))

bark(num_barks)

Returns a dog ASCII with a speech bubble containing "bark" repeated num_barks times

Example:

from pydog import bark

print(bark(3))

wag(message)

Returns a wagging dog ASCII that echoes the message

Example:

from pydog import wag

print(wag("Good dog!"))

fetch(item)

Returns a dog ASCII carrying the specified item.

Raises:

• ValueError if item is empty or whitespace
• TypeError if item is not a string

Example:

from pydog import fetch

print(fetch("ball"))

pose(trick, mood)

Returns a dog ASCII performing a specific trick with a given mood.

Valid tricks: sit, stand, stare

Valid moods: happy, sleepy, angry

Raises:

• ValueError if trick or mood is invalid

Example:

from pydog import pose

print(pose("sit", "happy"))
print(pose("stand", "sleepy"))
print(pose("stare", "angry"))

install from PyPI:

https://pypi.org/project/pyfundog/

pip install pyfundog

Usage (CLI)

python -m pydog --bark 3
python -m pydog --wag "hello"
python -m pydog --speak-message "hi" --speak-mood happy
python -m pydog --pose sit happy

Example Program

Run the demo:

pipenv run python examples/demo.py

Developer Setup:

#Python 3.9, 3.10, 3.11

# Clone repo:
git clone https://github.com/swe-students-spring2026/3-package-river_dolphin.git
cd 3-package-river_dolphin

# Install pipenv: 
pip install pipenv

# Install dependencies:
pipenv install --dev
pipenv install -e .

# Run tests:
pipenv run pytest

# Build package:
pipenv run python -m build

Contributing:

# Python 3.9, 3.10, 3.11

# Create a feature branch:
git checkout -b feature/your-feature

# Make changes and test: 
pipenv run pytest

# Commit and push:
git add .
git commit -m "Add feature"
git push origin feature/your-feature

# Open a PR on GitHub

License:

Licensed under the MIT License. See License.

Course Exercise:

This repository is part of the package engineering exercise documented in instructions.