.. -*- mode: rst ; ispell-local-dictionary: "american" -*- =============== `managesieve` =============== ------------------------------------------------------------------------------------------------------------------------------------- A ManageSieve client library for remotely managing Sieve scripts, including an user application (the interactive 'sieveshell'). ------------------------------------------------------------------------------------------------------------------------------------- .. Contents: .. toctree:: :maxdepth: 2 :Author: Hartmut Goebel :License: `Python Software Foundation License`__ for the module, `GPL v3`__ for `sieveshell` and test suite. :Homepage: http://packages.python.org/managesieve :Download: http://pypi.python.org/pypi/managesieve :Development: https://gitlab.com/htgoebel/managesieve __ http://www.opensource.org/licenses/PythonSoftFoundation.html __ http://opensource.org/licenses/GPL-3.0 python-managesieve is a pure `Python `_ module implementing the ManageSieve client protocol. It also includes an user application (the interactive `sieveshell`). .. Find more info here: * [[path:download|Downloads]] * If you want to report an issue - please refer to the [[path:issues|issue tracker]]. What is this ManageSieve thing? ==================================== The ManageSieve protocol allows managing Sieve scripts on a remote mail server. Sieve scripts allow users to filter incoming email on the mail server. These servers are commonly sealed so users cannot log into them, yet users must be able to update their scripts on them. This is what for the "ManageSieve" protocol is. For more information about the ManageSieve protocol see `the ManageSieve Internet draft `_. This module allows accessing a Sieve-Server for managing Sieve scripts there. It is accompanied by a simple yet functional user application `sieveshell`. What is this `sieveshell`? ================================ `sieveshell` is a command line tool for talking to the Sieve server. One can * list scripts on the server * upload scripts to the server * display scripts stored on the server and download or edit them * delete scripts stored on the server * activate and deactivate scripts `sieveshell` is useful for user who wish to manage sieve scripts without installing a fat GUI-based mail client. Development ==================== Source Code Repository ---------------------------- The source of `managesieve` is maintained at `GitLab `_. Patches and pull-requests are hearty welcome. * You may browse the current repository at the `Repository Browser `_ * Or you may check out the current version by running:: git clone https://gitlab.com/htgoebel/managesieve.git Issue Tracker ---------------- Please submit bugs and enhancements to the Issue Tracker at . Historical Note ==================== `managesieve` was hosted at origo.ethz.ch, but this site closed at May 2012. Then `managesieve` was hosted gitorious.org, which was closed May 2015. .. Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`