sievemgr 0.7.4.7

Fully-featured ManageSieve command-line client and library

SieveManager

Sieve is a programming language for filtering email. Sieve scripts are typically run by the mail server when mail is delivered to an inbox, so they need to be managed remotely.

SieveManager is a command-line client for uploading, downloading, and managing remote Sieve scripts using the ManageSieve protocol. It can also be used as a Python module.

WARNING: The command-line interface, the configuration semantics, and the Python API may still change.

Example

Upload and activate a Sieve script:

$ sievemgr [e-mail]
[e-mail]'s password: <password>
sieve://[e-mail]> put script.sieve
sieve://[e-mail]> activate script.sieve

In Python:

from sievemgr import SieveManager
with SieveManager('imap.foo.example') as mgr:
    mgr.authenticate('user', 'password')
    with open('sieve.script', 'br') as script:
        mgr.putscript(script, 'sieve.script')
    mgr.setactive('sieve.script')

Features

• Complies fully with RFC 5804 (ManageSieve protocol)

• Login can be automated with:

  • Password managers

  • GnuPG-encrypted password files

  • sieve.cf

  • .netrc

• Password-based authentication with:

  • CRAM-MD5

  • LOGIN

  • PLAIN

  • SCRAM-* and SCRAM-*-PLUS [1] with

    • SHA-1

    • SHA-2-234

    • SHA-2-256

    • SHA-2-384

    • SHA-2-512

    • SHA-3-512

• TLS client authentication

• Proxy authentication

• Tab-completion

• Scriptable

• Emacs-like backup of scripts

• Checks whether TLS certificates have been revoked (using lightweight OCSP)

• Supports TLS Server Name Indication

• Supports giving IPv6 addresses on the command-line

[1]

SCRAM-*-PLUS authentication is untested.

Documentation

Use sievemgr -h, type “help” in the SieveManager shell, or see the home page.

Contact

Home page:

https://odkr.codeberg.page/sievemgr

Issue tracker:

https://github.com/odkr/sievemgr/issues

Source code (primary):

https://codeberg.org/odkr/sievemgr

Source code (secondary):

https://notabug.org/odkr/sievemgr

License

Copyright 2023 and 2024 Odin Kroeger

SieveManager is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the FreeSoftware Foundation, either version 3 of the License, or (at your option) any later version.

SieveManager is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SieveManager. If not, see <https://www.gnu.org/licenses/>.