wafflesbot 0.1.0

Tech recruiter auto reply bot using JMAP

wafflesbot: Email auto reply bot for JMAP mailboxes

wafflesbot sends form replies to unreplied emails in a JMAP mailbox (such as Fastmail).

wafflesbot excels at automatically asking tech recruiters for compensation information.

Built on:

• JMAP client: jmapc
• Quoted email reply assembly: replyowl

Installation

wafflesbot is available on PyPI:

pip install wafflesbot

Usage

wafflesbot provides the waffles command which can be run interactively or as a cronjob.

Environment variables:

• JMAP_HOST: JMAP server hostname
• JMAP_USER: Email account username
• JMAP_PASSWORD: Email account password (likely an app password if 2-factor authentication is enabled with your provider)

Required arguments:

• -m/--mailbox: Name of the folder to process
• -r/--reply-content: Path to file with an HTML reply message

Invocation examples

Reply to messages in the "Recruiters" folder with the message in my-reply.html:

JMAP_HOST=jmap.example.com \
JMAP_USER=ness \
JMAP_PASSWORD=pk_fire \
waffles \
    --mailbox "Recruiters" \
    --reply-content my-reply.html

Additional argument examples:

• Only reply to messages received within the last day:
  • waffles -m "Recruiters" -r my-reply.html --days 1 (or -n)
• Send at most 2 emails before exiting:
  • waffles -m "Recruiters" -r my-reply.html --limit 2 (or -l)
• Instead of sending mail, print constructed email replies to standard output:
  • waffles -m "Recruiters" -r my-reply.html --dry-run (or -p)
• Log JMAP requests and responses to the debug logger:
  • waffles -m "Recruiters" -r my-reply.html --debug (or -d)

Development

Prerequisites: Poetry

• Setup: poetry install
• Run all tests: poetry run poe test
• Fix linting errors: poetry run poe lint

---

Created from smkent/cookie-python using cookiecutter