wafflesbot 0.1.3

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 either:

1. Run as a service and reply to emails received via JMAP server events (the default)
2. Run as a script to examine recent emails (such as interactively or via a cronjob)

Environment variables:

• JMAP_HOST: JMAP server hostname
• JMAP_API_TOKEN: JMAP account API token

Required arguments:

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

Optional arguments:

• -d/--debug: Enable debug logging
• -l/--limit: Maximum number of emails replies to send (only valid with -s/--script)
• -n/--days: Only process email received this many days ago or newer (only valid with -s/--script)
• -p/--pretend: Print messages to standard output instead of sending email
• -s/--script: Set to run as a script instead of an event-driven service

Invocation examples

Listen for new emails, and reply to unreplied messages that appear in the "Recruiters" folder with the message in my-reply.html:

JMAP_HOST=jmap.example.com \
JMAP_API_TOKEN=ness__pk_fire \
waffles \
    --mailbox "Recruiters" \
    --reply-content my-reply.html

Run as a script and reply to unreplied messages in the "Recruiters" folder with the message in my-reply.html:

JMAP_HOST=jmap.example.com \
JMAP_API_TOKEN=ness__pk_fire \
waffles \
    --script \
    --mailbox "Recruiters" \
    --reply-content my-reply.html

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