summaryrefslogtreecommitdiff
path: root/PKG-INFO
blob: 56ca998b83b71981b1e1d04cf5c774b31c3ef4e6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
Metadata-Version: 1.1
Name: sievelib
Version: 0.5
Summary: Client-side SIEVE library
Home-page: http://bitbucket.org/tonioo/sievelib
Author: Antoine Nguyen
Author-email: tonio@ngyn.org
License: MIT
Description: sievelib
        ========
        
        Client-side Sieve and Managesieve library written in Python.
        
        * Sieve : An Email Filtering Language
          (`RFC 5228 <http://tools.ietf.org/html/rfc5228>`_)
        * ManageSieve : A Protocol for Remotely Managing Sieve Scripts
          (`Draft <http://tools.ietf.org/html/draft-martin-managesieve-12>`_)
        
        Sieve tools
        -----------
        
        What is supported
        ^^^^^^^^^^^^^^^^^
        
        Currently, the provided parser supports most of the functionalities
        described in the RFC. The only exception concerns section
        *2.4.2.4. Encoding Characters Using "encoded-character"* which is not
        supported.
        
        The following extensions are also supported:
        
        * Vacation (`RFC 5230 <http://tools.ietf.org/html/rfc5230>`_)
        
        Basic usage
        ^^^^^^^^^^^
        
        The parser can either be used from the command-line::
        
          $ cd sievelib
          $ python parser.py test.sieve
          Syntax OK
          $
        
        Or can be used from a python environment (or script/module)::
        
          >>> from sievelib.parser import Parser
          >>> p = Parser()
          >>> p.parse('require ["fileinto"];')
          True
          >>> p.dump()
          require (type: control)
              ["fileinto"]
          >>> 
          >>> p.parse('require ["fileinto"]')
          False
          >>> p.error
          'line 1: parsing error: end of script reached while semicolon expected'
          >>>
        
        Simple filters creation
        ^^^^^^^^^^^^^^^^^^^^^^^
        
        Some high-level classes are provided with the ``factory`` module, they
        make the generation of Sieve rules easier::
        
          >>> from sievelib.factory import FilterSet
          >>> fs.addfilter("rule1",
          ...              [("Sender", ":is", "toto@toto.com"),],
          ...              [("fileinto", "Toto"),])
          >>> fs.tosieve()
          require ["fileinto"];
          
          # Filter: rule1
          if anyof (header :is "Sender" "toto@toto.com") {
              fileinto "Toto";
          }
          >>> 
        
        Additionnal documentation is available with source code.
        
        ManageSieve tools
        -----------------
        
        What is supported
        ^^^^^^^^^^^^^^^^^
        
        All mandatory commands are supported. The ``RENAME`` extension is
        supported, with a simulated behaviour for server that do not support
        it.
        
        For the ``AUTHENTICATE`` command, supported mechanisms are ``DIGEST-MD5``,
        ``PLAIN`` and ``LOGIN``.
            
        Basic usage
        ^^^^^^^^^^^
        
        The ManageSieve client is intended to be used from another python
        application (there isn't any shell provided)::
        
          >>> from sievelib.managesieve import Client
          >>> c = Client("server.example.com")
          >>> c.connect("user", "password", starttls=False, authmech="DIGEST-MD5")
          True
          >>> c.listscripts()
          ("active_script", ["script1", "script2"])
          >>> c.setactive("script1")
          True
          >>> c.havespace("script3", 45)
          True
          >>>
        
        Additionnal documentation is available with source code.
        
Keywords: sieve,managesieve,parser,client
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Email :: Filters