101 lines
3.1 KiB
Python
101 lines
3.1 KiB
Python
# This software is provided 'as-is', without any express or implied
|
|
# warranty. In no event will the author be held liable for any damages
|
|
# arising from the use of this software.
|
|
#
|
|
# Permission is granted to anyone to use this software for any purpose,
|
|
# including commercial applications, and to alter it and redistribute it
|
|
# freely, subject to the following restrictions:
|
|
#
|
|
# 1. The origin of this software must not be misrepresented; you must not
|
|
# claim that you wrote the original software. If you use this software
|
|
# in a product, an acknowledgment in the product documentation would be
|
|
# appreciated but is not required.
|
|
# 2. Altered source versions must be plainly marked as such, and must not be
|
|
# misrepresented as being the original software.
|
|
# 3. This notice may not be removed or altered from any source distribution.
|
|
#
|
|
# Copyright (c) 2008 Greg Hewgill http://hewgill.com
|
|
#
|
|
# This has been modified from the original software.
|
|
# Copyright (c) 2011 William Grant <me@williamgrant.id.au>
|
|
|
|
import re
|
|
|
|
__all__ = [
|
|
'algorithms',
|
|
'CanonicalizationPolicy',
|
|
]
|
|
|
|
|
|
def strip_trailing_whitespace(content):
|
|
return re.sub(b"[\t ]+\r\n", b"\r\n", content)
|
|
|
|
|
|
def compress_whitespace(content):
|
|
return re.sub(b"[\t ]+", b" ", content)
|
|
|
|
|
|
def strip_trailing_lines(content):
|
|
return re.sub(b"(\r\n)*$", b"\r\n", content)
|
|
|
|
|
|
def unfold_header_value(content):
|
|
return re.sub(b"\r\n", b"", content)
|
|
|
|
|
|
class Simple:
|
|
"""Class that represents the "simple" canonicalization algorithm."""
|
|
|
|
name = b"simple"
|
|
|
|
@staticmethod
|
|
def canonicalize_headers(headers):
|
|
# No changes to headers.
|
|
return headers
|
|
|
|
@staticmethod
|
|
def canonicalize_body(body):
|
|
# Ignore all empty lines at the end of the message body.
|
|
return strip_trailing_lines(body)
|
|
|
|
|
|
class Relaxed:
|
|
"""Class that represents the "relaxed" canonicalization algorithm."""
|
|
|
|
name = b"relaxed"
|
|
|
|
@staticmethod
|
|
def canonicalize_headers(headers):
|
|
# Convert all header field names to lowercase.
|
|
# Unfold all header lines.
|
|
# Compress WSP to single space.
|
|
# Remove all WSP at the start or end of the field value (strip).
|
|
return [
|
|
(x[0].lower().rstrip(),
|
|
compress_whitespace(unfold_header_value(x[1])).strip() + b"\r\n")
|
|
for x in headers]
|
|
|
|
@staticmethod
|
|
def canonicalize_body(body):
|
|
# Remove all trailing WSP at end of lines.
|
|
# Compress non-line-ending WSP to single space.
|
|
# Ignore all empty lines at the end of the message body.
|
|
return strip_trailing_lines(
|
|
compress_whitespace(strip_trailing_whitespace(body)))
|
|
|
|
|
|
class CanonicalizationPolicy:
|
|
|
|
def __init__(self, header_algorithm, body_algorithm):
|
|
self.header_algorithm = header_algorithm
|
|
self.body_algorithm = body_algorithm
|
|
|
|
def canonicalize_headers(self, headers):
|
|
return self.header_algorithm.canonicalize_headers(headers)
|
|
|
|
def canonicalize_body(self, body):
|
|
return self.body_algorithm.canonicalize_body(body)
|
|
|
|
|
|
algorithms = dict((c.name, c) for c in (Simple, Relaxed))
|