Merge lp:~valimail/authentication-results-python/gene into lp:authentication-results-python/0.6

[Scott Kitterman]

Initial merge of ARC authres capability

[Scott Kitterman (kitterman)]

review: Approve

=== modified file 'authres/__init__.py'
--- authres/__init__.py	2016-12-11 06:08:52 +0000
+++ authres/__init__.py	2017-07-13 04:56:53 +0000
@@ -185,13 +185,15 @@
         import authres.dmarc
         import authres.smime
         import authres.rrvs
+        import authres.arc        
         _all_features = FeatureContext(
             authres.dkim_b,
             authres.dkim_adsp,
             authres.vbr,
             authres.dmarc,
             authres.smime,
-            authres.rrvs
+            authres.rrvs,
+            authres.arc
         )
     return _all_features
 

=== added file 'authres/arc.py'
--- authres/arc.py	1970-01-01 00:00:00 +0000
+++ authres/arc.py	2017-07-13 04:56:53 +0000
@@ -0,0 +1,60 @@
+# coding: utf-8
+
+# Copyright © 2017 Gene Shuman <[e-mail]>,
+# Copyright © 2012-2013 Scott Kitterman <[e-mail]>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+authres extension module for the Authenticated Recieved Chain (ARC)
+authentication method.
+"""
+
+#MODULE = 'authres'
+
+__author__  = 'Scott Kitterman, Gene Shuman'
+__email__   = '[e-mail], [e-mail]'
+__version__ = '0.900'
+
+import authres.core
+from authres.core import make_result_class_properties
+
+class ARCAuthenticationResult(authres.core.AuthenticationResult):
+    "ARC result clause of an ``Authentication-Results`` header"
+
+    METHOD = 'arc'
+
+    def __init__(self, version = None,
+        result               = None,  result_comment               = None,
+        reason               = None,  reason_comment               = None,
+        properties = None,
+        header_d             = None,  header_d_comment             = None,
+    ):
+        authres.core.AuthenticationResult.__init__(self, self.METHOD, version,
+            result, result_comment, reason, reason_comment, properties)
+        if header_d:                     self.header_d                     = header_d
+        if header_d_comment:             self.header_d_comment             = header_d_comment
+
+    header_d,             header_d_comment             = make_result_class_properties('header', 'd')
+
+    def match_signature(self, signature_d):
+        """Match authentication result against a ARC signature by ``header.d``."""
+
+        return self.header_d == signature_d
+
+RESULT_CLASSES = [
+    ARCAuthenticationResult
+]
+
+# vim:sw=4 sts=4
+    

=== modified file 'authres/tests'
--- authres/tests	2016-12-11 05:52:42 +0000
+++ authres/tests	2017-07-13 04:56:53 +0000
@@ -525,6 +525,15 @@
 ... results = [mfrom_pass, helo_none]))
 'Authentication-Results: example.com; spf=pass smtp.mailfrom=[e-mail]; spf=none reason="No SPF record for HELO" smtp.helo=mailserver.example.net'
 
+# Create header field with ARC results
+>>> import authres
+>>> import authres.arc
+>>> arc_pass = authres.arc.ARCAuthenticationResult(result = 'pass',
+... header_d = 'example.net')
+>>> str(authres.AuthenticationResultsHeader(authserv_id = 'example.com',
+... results = [arc_pass]))
+'Authentication-Results: example.com; arc=pass header.d=example.net'
+
 # Parsing IP6 address.
 >>> arobj = authres_context.parse('Authentication-Results: mail.bmsi.com; iprev=pass policy.iprev="2001:748:100:40::2:2" (mout0.freenet.de); spf=none smtp.mailfrom=[e-mail]')
 >>> str(arobj.results[0])