procrastination-helper 0.1.0

A fun package to help procrastinators with excuses, quotes, and more

procrastination_helper

---

Project Description

procrastination_helper is a user-friendly application designed to assist individuals in managing their tasks and overcoming procrastination. By generating creative and humorous custom excuses, the app provides users with a lighthearted way to navigate their responsibilities. Whether you need a reason to delay a chore, skip a meeting, or take a break from studying, Procrastination Helper offers a variety of tailored excuses to suit any situation. With its intuitive interface and engaging content, this app aims to make task management more enjoyable and less stressful.

---

PyPI Package

procrastination_helper on PyPI

---

Importing and Using procrastination_helper in Your Code

Developers can import and use procrastination_helper functions in their own projects.

Available Functions & Examples

1. get_custom_excuse(task)

Returns a personalized excuse based on the task using random templates.

from procrastination_helper import get_custom_excuse
print(get_custom_excuse("homework"))

2. delay_timer(minutes)

Allows the user to set a procrastination timer.

from procrastination_helper import delay_timer
delay_timer(15)

3. get_excuse_list(n)

Returns a specified number n of random excuses from the sample excuses list.

from procrastination_helper import get_excuse_list
print(get_excuse_list(3))

4. get_excuse()

Returns a single random excuse from a predefined list of sample excuses.

from procrastination_helper import get_excuse
print(get_excuse())

5. get_procrastination_quotes(num_quotes)

Returns a specified number num_quotes of random motivational quotes about procrastination.

from procrastination_helper import get_procrastination_quotes
print(get_procrastination_quotes(2))

Example Program

---

Developer Setup Guide

Follow these steps to set up and contribute to the procrastination_helper project:

1. Clone the Repository

git clone https://github.com/software-students-spring2025/3-python-package-market-correction.git
cd 3-python-package-market-correction

2. Set Up a Virtual Environment

You can use either venv or pipenv:

• Using venv:

python -m venv venv
source venv/bin/activate  # For Windows: venv\Scripts\activate

• Using pipenv:

pipenv shell

3. Install Dependencies

• Using venv:

pip install -e .[dev]

• Using pipenv:

pipenv install -e .[dev]

4. Run Tests

Ensure everything is working by running:

pytest

5. Build the Package

To package the application, use:

python -m build

6. Run the Application

Navigate to the source directory and execute:

cd src
python3 -m procrastination_helper

---

Team Members

Name	NYU Email	GitHub Profile
Chris Leu	[e-mail]	cl3880
Ava August	[e-mail]	aaugust22
Keith Dusling	[e-mail]	kdusling56
Joel Kim	[e-mail]	joel-d-kim

---

Environment Variables & Starter Data

This project does not require any environment variables or a database.

Secret Configuration Files

This project does not require any secret configuration files.