A small Python package with developer‑themed pickup lines and compliments. Nothing serious—just something light to play with while practicing packaging, testing, and CI.
This package has a collection of cheesy (but configurable) pickup lines and compliments for developers, designers, managers, and data scientists. You can get random lines, filter by category, adjust the cheesiness level, and customize compliments.
pip install pyflirtfrom pyflirt import line, lines, compliment, categories
# Get one random pickup line
print(line())
# Get a line in a specific category
print(line(category="nerdy"))
# Get multiple lines
print(lines(n=5, category="cs"))
# Get a compliment
print(compliment(role="developer", mood="sweet"))Run the example that showcases all functions (categories, line, lines, compliment, search, stats, stylize, say, rate_line, rainbow, ascii_heart):
# from the repo root
PYTHONPATH=src python examples/demo.py
# or with pipenv
pipenv run python -c "import sys; sys.path.insert(0, 'src'); import examples.demo as d; d.main()"Returns one random pickup line.
category: Pick a category like "nerdy", "cs", "math", "poetic", or "classic". Default is "nerdy".name: If the line supports it, this name will be inserted.cheese: How cheesy should it be? 1 (least cheesy) to 5 (very cheesy). Default is 2.seed: Optional number for reproducible results.
Example:
line(category="cs", name="Alex", cheese=2)Returns a list of pickup lines.
n: How many lines you want.- Other parameters work the same as
line().
Example:
lines(n=3, category="math", cheese=3)Returns a compliment for a specific role.
role: Choose from "developer", "designer", "manager", or "data".mood: "sweet", "cheeky", or "nerdy".name: Optional name to include in the compliment.emojis: Number of heart emojis to add (0-5).seed: Optional number for reproducible results.
Example:
compliment(role="designer", mood="cheeky", name="Sam", emojis=2)Returns a list of all available pickup line categories.
Example:
print(categories())
# ['classic', 'cs', 'math', 'nerdy', 'poetic']Find up to limit lines containing query (case-insensitive), optionally filtered.
query: substring to match (required)category: filter by category or search allname: optional replacement for{name}placeholderscheese: 1–5 max cheese allowed in resultslimit: max results to returnseed: for deterministic ordering
Example:
search("code", category="cs", limit=3, seed=7)Return counts for available lines.
Returns a dict with keys: total, by_category, and cheese_hist.
Example:
s = stats()
print(s["total"], s["by_category"], s["cheese_hist"])Format a string with optional wrapping, uppercasing, and ANSI color.
width: wrap to this many columns (None = no wrap)uppercase: True to uppercase the textcolor: one of"auto","none","magenta","cyan","green"
Example:
stylize("hello world", width=8, uppercase=True, color="none")say(category="nerdy", name=None, cheese=2, seed=None, width=None, uppercase=False, color="auto", emojis=0)
Generate a line, decorate it (wrap/case/color/emojis), print it, and return it.
Example:
say(category="nerdy", seed=1, width=16, color="none", emojis=2)Score a line by the chosen metric.
length: higher for shorter lines (simple heuristic)cheese_level: counts cheesy keywordsrandom: seeded 0–10 score
Example:
rate_line("You are so sweet", metric="cheese_level")Colorize text with rainbow ANSI codes 🌈 Useful for terminals that support color formatting.
Example:
print(rainbow("You light up my console! 💻"))Return a multi-line ASCII heart ❤️. A great decoration after a compliment.
Example:
print(ascii_heart())If you want to work on this package:
- Clone the repo:
git clone https://github.com/swe-students-fall2025/3-python-package-team_quartz.git
cd 3-python-package-team_quartz- Install pipenv (if you don't have it):
pip install pipenv- Install dependencies:
pipenv install --dev- Activate the virtual environment:
pipenv shell- Run tests:
pytest- Build the package:
python -m buildTeam
- Siqi Zhu — @HelenZhutt
- Daniel Lee - @danielleesignup
- Sam Murshed - [@Sammurshed] (https://github.com/SamMurshed)
- Matthew Viola
- Jordan Lee - [@jjl9930] (https://github.com/jjl9930)
More links