DailyQuotes 0.1.0

DailyQuotes is a simple Python package that generates random quotes including quotes that are well-known, from celebrities, mood-based, and in different languages. This Python package provides an easy way to integrate meaningful quotes into projects, daily routines, or personal motivation.

An exercise to create a Python package, build it, test it, distribute it, and use it. See instructions for details.

quotes

Contributors:

Aaqila Patel

Andy Cabindol

Lina Sanchez

Maya Mabry

Description:

quotes is a simple Python package that generates random quotes including quotes that are well-known, from celebrities, mood based, and in different languages. This python package provides an easy way to integrate meaningful quotes into projects, daily routines, or personal motivation.

Installation

You can install quotes directly from [PyPI]("Insert link")

pip install quotes

Features

quotes offers four different features within the package:

1. generate_quote

This function generates a random quote and is perfect for a user who wants an entertaining quote without any specific criteria.

from quotes import generate_quote
quote = generate_quote()
print(quote)
# Output: "The only way to do great work is to love what you do."

2. generate_celebrity_quote

This function allows users to specify a celebrity (ex. musician, politician, historical figure, etc.) and receive a quote attributed to them.

from quotes import generate_celebrity_quote
quote = generate_celebrity_quote("Albert Einstein")
print(quote)
# Output: "Imagination is the light that illuminates the realms of knowledge and discovery."

3. generate_mood_quote

This function allows users to input their mood (ex. happy, sad, excitement), and the function will return a quote that aligns with their emotional state.

from quotes import generate_mood_quote
quote = generate_mood_quote("sad")
print(quote)
# Output: "Even when sorrow clouds the skies, remember that every raindrop has the potential to nurture a seed into a beautiful flower."

4. generate_language_quote

This function generates a quote in a user-specified language (Spanish, French, Greek) which is useful for language learners.

from quotes import generate_language_quote
quote = generate_language_quote("Greek")
print(quote)
# Output: "Η επιμονή είναι η αδερφή της επιτυχίας"

Command Line Usage

quotes can also be used directly from the command line:

# Install the package 
pip install quotes

# Run the CLI
python -m quotes

Example Program

Here is a complete example program that demonstrates all functions:

example.py

Development Setup

If you would like to contribute to quotes, follow these steps:

Prerequisites

• Python 3.7 or higher
• pipenv

Setup steps

1. Clone the repository:

git clone https://github.com/software-students-spring2025/3-python-package-package_proj.git

cd 3-python-package-package_proj

2. Set up the virtual environment and install dependencies:

pipenv install --dev 
pipenv shell

3. Install the package in development mode:

pipenv install -e .

Running tests

We use pytest for testing. To run the tests:

pytest

Building the package

To build the package:

python -m build

This will generate distribution files in the dist/ directory.

Workflow for contributions

1. Create a new branch for your feature:

git checkout -b feature/your-feature-name

2. Make your changes and write tests if necessary

3. Run tests to ensure everything works:

pytest

4. Commit your changes and push to your branch

git add . 
git commit -m "Add feature: unique feature description"
git push origin feature/your-feature-name

5. Create a Pull Request to the 'main' branch