Dropscan Serv

Environment Variables

• DROPSCAN_API_KEY: Bearer token used for API authentication.
• DROPSCAN_API_BASE_URL: Optional API URL override.
• FORMATTNG: Output style selector (json, rich, txt, markdown) case-insensitive.
• FORMATTING: Fallback alias for output style if FORMATTNG is unset.

Output Rules

Always route user-visible output through the global handler in output.py.

Command Scope

• scanbox: list, select, info
• mailings: list, show, envelope, pdf, plaintext, zip, delete
• action: scan, forward, destroy, cancel
• recipients: list, show
• addresses: register, show

Behavioral Notes

• Wrapper script is ./dropscan-serv and runs the CLI in the local virtual environment.
• scanbox info prints recipients as a dedicated nested table for txt, rich, and markdown output formats.
• API supports forwarding address registration and retrieval by ID; there is no endpoint to list all forwarding addresses.

Implementation Checklist

1. Confirm required endpoint exists in Dropscan API docs.
2. Add command in the appropriate module in commands.
3. Use client.py for API access.
4. Enforce selected scanbox where required.
5. Use output.py for all output.
6. Keep errors user-friendly via click exceptions.