ghosty-teammate 0.0.7

A ghost teammate bot that pretends to work but does absolutely nothing.

Python Package Exercise

Ghosty: Your Ghost Teammate Bot

PyPI Project Page: https://pypi.org/project/ghosty-teammate/

Ghosty is a Python package that simulates a ghost teammate — the kind who gets assigned tasks, never does anything, and always has an excuse. Install it, assign Ghosty some work, and watch absolutely nothing happen.

---

Installation

pip install ghosty-teammate

---

Usage

greet()

Ghosty greets the team with a fixed message of encouragement.

from ghosty import ghosty

ghosty.greet()

assign(task_name, hours, category="medium")

Assign Ghosty a task. It will be logged to the task board and promptly ignored.

• task_name (str): Name of the task
• hours (int/float): Estimated hours
• category (str): Priority level — "low", "medium", "high", or "critical". Default: "medium"

ghosty.assign("Fix login bug", 3, category="high")
ghosty.assign("Write documentation", 2, category="low")

check_in(task_name=None)

View the task board. Pass a task name to see details on a specific task, or leave it empty to see everything.

ghosty.check_in()                  # view all tasks
ghosty.check_in("Fix login bug")   # view one task

nudge(task_name)

Nudge Ghosty on a specific task. Each nudge increases progress by 20%. Without a nudge, nothing will ever happen.

• task_name (str): Name of the task to nudge

ghosty.nudge("Fix login bug")

excuse(reason, seriousness="medium")

Ask Ghosty to justify why no progress has been made.

• reason (str): The excuse text
• seriousness (str): How serious the excuse is — "low", "medium", or "high". Default: "medium"

ghosty.excuse("my cat sat on my keyboard", seriousness="medium")
ghosty.excuse("the wifi stopped believing in me", seriousness="high")

---

Example Program

See src/ghosty/__main__.py for a complete example using all functions.

Run it with:

python -m ghosty

---

Contributing

Setup

git clone https://github.com/swe-students-spring2026/3-package-blue_whale.git
cd 3-package-blue_whale
pipenv install --dev
pipenv shell

Running Tests

pipenv run pytest

Building the Package

pipenv run python -m build

---

Configuration

This project does not use any secret configuration files such as .env or similar files. No additional configuration is required to run or contribute to this project.

---

Team

• Celia Liang
• Mumu Li
• Xiongfeng Li
• Meili Liang
• Hanxi Li