Initial JMAP read-only CLI

Author: turian

.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

.python-version

@@ -0,0 +1 @@
+3.13

AGENTS.md

@@ -0,0 +1,3 @@
+# Tooling Convention
+
+- Use `uv` directly for Python environment and package tasks; do **not** use `uv pip` or `uv venv`.

README.md

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""
+fastmail-cli: thin wrapper around jmapc-cli with Fastmail defaults.
+"""
+import os
+import sys
+
+DEFAULT_HOST = "api.fastmail.com"
+DEFAULT_TOKEN_ENV = "FASTMAIL_READONLY_API_TOKEN"
+
+
+def main(argv=None) -> int:
+    # Set default host if not provided
+    os.environ.setdefault("JMAP_HOST", DEFAULT_HOST)
+    # Promote FASTMAIL_READONLY_API_TOKEN to JMAP_API_TOKEN if not already set
+    if "JMAP_API_TOKEN" not in os.environ and DEFAULT_TOKEN_ENV in os.environ:
+        os.environ["JMAP_API_TOKEN"] = os.environ[DEFAULT_TOKEN_ENV]
+    from jmapc_cli import main as jmap_main
+    return jmap_main(argv)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

fastmail_cli.py

@@ -0,0 +1,13 @@
+[project]
+name = "fm"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "jmapc>=0.2.23",
+]
+
+[project.scripts]
+jmapc-cli = "jmapc_cli:main"
+fastmail-cli = "fastmail_cli:main"