Metadata-Version: 2.5
Name: fastsmtp-cli
Version: 0.6.0
Summary: Remote CLI client for FastSMTP server
Project-URL: Homepage, https://jsenecal.github.io/fastsmtp/cli/fsmtp/
Project-URL: Documentation, https://jsenecal.github.io/fastsmtp/cli/fsmtp/
Project-URL: Source, https://github.com/jsenecal/fastsmtp
Project-URL: Issues, https://github.com/jsenecal/fastsmtp/issues
Project-URL: Changelog, https://github.com/jsenecal/fastsmtp/releases
Author: Jonathan Senecal
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Keywords: cli,email,fastsmtp,smtp,webhook
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Email
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28
Requires-Dist: pydantic-settings>=2.6
Requires-Dist: pydantic>=2.9
Requires-Dist: rich>=13.9
Requires-Dist: tomli-w>=1.0
Requires-Dist: typer>=0.14
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# fastsmtp-cli

The remote CLI client for [FastSMTP](https://github.com/jsenecal/fastsmtp), an async SMTP
server that forwards received email to webhooks.

This package talks to a running FastSMTP server over its HTTP API. It does not import or
depend on the server package, so it installs cleanly on a workstation with none of the
server's dependencies.

## Install

```bash
pip install fastsmtp-cli
```

The command is `fsmtp`.

## Use

```bash
fsmtp config set default --url https://smtp.example.com --api-key <key>

fsmtp domain list
fsmtp domain create example.com
fsmtp recipient create <domain-id> https://hooks.example.com/support --local support
fsmtp ops log list <domain-id> --status failed
```

Profiles are stored in a config file, so several servers can be addressed from one machine
with `--profile`. `fsmtp config init` sets the first one up interactively.

## Documentation

Command reference and examples: <https://jsenecal.github.io/fastsmtp/cli/fsmtp/>.

Source and issue tracker: <https://github.com/jsenecal/fastsmtp>.

## License

AGPL-3.0-or-later - this program is free software: you can redistribute it and/or
modify it under the terms of the GNU Affero General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your option) any later
version. See [LICENSE](LICENSE).
