omlish 0.0.0.dev368__py3-none-any.whl → 0.0.0.dev369__py3-none-any.whl

omlish/http/coro/client/status.py

@@ -0,0 +1,86 @@
+# @omlish-lite
+# ruff: noqa: UP006 UP007 UP043 UP045
+# PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+# --------------------------------------------
+#
+# 1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and the Individual or Organization
+# ("Licensee") accessing and otherwise using this software ("Python") in source or binary form and its associated
+# documentation.
+#
+# 2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive,
+# royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative
+# works, distribute, and otherwise use Python alone or in any derivative version, provided, however, that PSF's License
+# Agreement and PSF's notice of copyright, i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
+# 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 Python Software Foundation; All Rights Reserved" are retained in Python
+# alone or in any derivative version prepared by Licensee.
+#
+# 3. In the event Licensee prepares a derivative work that is based on or incorporates Python or any part thereof, and
+# wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in
+# any such work a brief summary of the changes made to Python.
+#
+# 4. PSF is making Python available to Licensee on an "AS IS" basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES,
+# EXPRESS OR IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY
+# OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT INFRINGE ANY THIRD PARTY
+# RIGHTS.
+#
+# 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL
+# DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, OR ANY DERIVATIVE THEREOF, EVEN IF
+# ADVISED OF THE POSSIBILITY THEREOF.
+#
+# 6. This License Agreement will automatically terminate upon a material breach of its terms and conditions.
+#
+# 7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint
+# venture between PSF and Licensee.  This License Agreement does not grant permission to use PSF trademarks or trade
+# name in a trademark sense to endorse or promote products or services of Licensee, or any third party.
+#
+# 8. By copying, installing or otherwise using Python, Licensee agrees to be bound by the terms and conditions of this
+# License Agreement.
+import typing as ta
+
+from ....lite.check import check
+from .errors import CoroHttpClientErrors
+from .io import CoroHttpClientIo
+
+
+#
+
+
+class CoroHttpClientStatusLine(ta.NamedTuple):
+    version: str
+    status: int
+    reason: str
+
+    @classmethod
+    def read(cls) -> ta.Generator[CoroHttpClientIo.Io, ta.Optional[bytes], 'CoroHttpClientStatusLine']:
+        line = str(check.isinstance((yield CoroHttpClientIo.ReadLineIo(CoroHttpClientIo.MAX_LINE + 1)), bytes), 'iso-8859-1')  # noqa
+        if len(line) > CoroHttpClientIo.MAX_LINE:
+            raise CoroHttpClientErrors.LineTooLongError(CoroHttpClientErrors.LineTooLongError.LineType.STATUS)
+        if not line:
+            # Presumably, the server closed the connection before sending a valid response.
+            raise CoroHttpClientErrors.RemoteDisconnectedError('Remote end closed connection without response')
+
+        version = ''
+        reason = ''
+        status_str = ''
+        try:
+            version, status_str, reason = line.split(None, 2)
+        except ValueError:
+            try:
+                version, status_str = line.split(None, 1)
+            except ValueError:
+                # empty version will cause next test to fail.
+                pass
+
+        if not version.startswith('HTTP/'):
+            raise CoroHttpClientErrors.BadStatusLineError(line)
+
+        # The status code is a three-digit number
+        try:
+            status = int(status_str)
+        except ValueError:
+            raise CoroHttpClientErrors.BadStatusLineError(line) from None
+
+        if status < 100 or status > 999:
+            raise CoroHttpClientErrors.BadStatusLineError(line)
+
+        return cls(version, status, reason)

omlish/http/coro/client/validation.py

@@ -0,0 +1,109 @@
+# @omlish-lite
+# ruff: noqa: UP006 UP007 UP043 UP045
+# PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+# --------------------------------------------
+#
+# 1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and the Individual or Organization
+# ("Licensee") accessing and otherwise using this software ("Python") in source or binary form and its associated
+# documentation.
+#
+# 2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive,
+# royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative
+# works, distribute, and otherwise use Python alone or in any derivative version, provided, however, that PSF's License
+# Agreement and PSF's notice of copyright, i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
+# 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 Python Software Foundation; All Rights Reserved" are retained in Python
+# alone or in any derivative version prepared by Licensee.
+#
+# 3. In the event Licensee prepares a derivative work that is based on or incorporates Python or any part thereof, and
+# wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in
+# any such work a brief summary of the changes made to Python.
+#
+# 4. PSF is making Python available to Licensee on an "AS IS" basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES,
+# EXPRESS OR IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY
+# OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT INFRINGE ANY THIRD PARTY
+# RIGHTS.
+#
+# 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL
+# DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, OR ANY DERIVATIVE THEREOF, EVEN IF
+# ADVISED OF THE POSSIBILITY THEREOF.
+#
+# 6. This License Agreement will automatically terminate upon a material breach of its terms and conditions.
+#
+# 7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint
+# venture between PSF and Licensee.  This License Agreement does not grant permission to use PSF trademarks or trade
+# name in a trademark sense to endorse or promote products or services of Licensee, or any third party.
+#
+# 8. By copying, installing or otherwise using Python, Licensee agrees to be bound by the terms and conditions of this
+# License Agreement.
+import http.client
+import re
+
+
+##
+
+
+class CoroHttpClientValidation:
+    def __new__(cls, *args, **kwargs):  # noqa
+        raise TypeError
+
+    #
+
+    # These characters are not allowed within HTTP method names to prevent http header injection.
+    _CONTAINS_DISALLOWED_METHOD_PCHAR_PAT = re.compile('[\x00-\x1f]')
+
+    @classmethod
+    def validate_method(cls, method: str) -> None:
+        """Validate a method name for putrequest."""
+
+        # prevent http header injection
+        match = cls._CONTAINS_DISALLOWED_METHOD_PCHAR_PAT.search(method)
+        if match:
+            raise ValueError(
+                f"method can't contain control characters. {method!r} (found at least {match.group()!r})",
+            )
+
+    #
+
+    # These characters are not allowed within HTTP URL paths. See https://tools.ietf.org/html/rfc3986#section-3.3 and
+    # the # https://tools.ietf.org/html/rfc3986#appendix-A pchar definition.
+    #  - Prevents CVE-2019-9740.  Includes control characters such as \r\n.
+    #  - We don't restrict chars above \x7f as putrequest() limits us to ASCII.
+    _CONTAINS_DISALLOWED_URL_PCHAR_PAT = re.compile('[\x00-\x20\x7f]')
+
+    @classmethod
+    def validate_path(cls, url: str) -> None:
+        """Validate a url for putrequest."""
+
+        # Prevent CVE-2019-9740.
+        match = cls._CONTAINS_DISALLOWED_URL_PCHAR_PAT.search(url)
+        if match:
+            raise http.client.InvalidURL(
+                f"URL can't contain control characters. {url!r} (found at least {match.group()!r})",
+            )
+
+    @classmethod
+    def validate_host(cls, host: str) -> None:
+        """Validate a host so it doesn't contain control characters."""
+
+        # Prevent CVE-2019-18348.
+        match = cls._CONTAINS_DISALLOWED_URL_PCHAR_PAT.search(host)
+        if match:
+            raise http.client.InvalidURL(
+                f"URL can't contain control characters. {host!r} (found at least {match.group()!r})",
+            )
+
+    #
+
+    # The patterns for both name and value are more lenient than RFC definitions to allow for backwards compatibility.
+    _LEGAL_HEADER_NAME_PAT = re.compile(rb'[^:\s][^:\r\n]*')
+    _ILLEGAL_HEADER_VALUE_PAT = re.compile(rb'\n(?![ \t])|\r(?![ \t\n])')
+
+    @classmethod
+    def validate_header_name(cls, header: bytes) -> None:
+        if not cls._LEGAL_HEADER_NAME_PAT.fullmatch(header):
+            raise ValueError(f'Invalid header name {header!r}')
+
+    @classmethod
+    def validate_header_value(cls, value: bytes) -> None:
+        if cls._ILLEGAL_HEADER_VALUE_PAT.search(value):
+            raise ValueError(f'Invalid header value {value!r}')

omlish/http/coro/{fdio.py → server/fdio.py}

@@ -3,12 +3,12 @@
 import socket
 import typing as ta
 
-from ...io.buffers import IncrementalWriteBuffer
-from ...io.buffers import ReadableListBuffer
-from ...io.fdio.handlers import SocketFdioHandler
-from ...lite.check import check
-from ...sockets.addresses import SocketAddress
-from ..handlers import HttpHandler
+from ....io.buffers import IncrementalWriteBuffer
+from ....io.buffers import ReadableListBuffer
+from ....io.fdio.handlers import SocketFdioHandler
+from ....lite.check import check
+from ....sockets.addresses import SocketAddress
+from ...handlers import HttpHandler
 from .server import CoroHttpServer
 
 

omlish/http/coro/{server.py → server/server.py}

@@ -62,19 +62,19 @@ import textwrap
 import time
 import typing as ta
 
-from ...lite.check import check
-from ...sockets.addresses import SocketAddress
-from ..handlers import HttpHandler
-from ..handlers import HttpHandlerRequest
-from ..handlers import HttpHandlerResponseData
-from ..handlers import HttpHandlerResponseStreamedData
-from ..handlers import UnsupportedMethodHttpHandlerError
-from ..parsing import EmptyParsedHttpResult
-from ..parsing import HttpRequestParser
-from ..parsing import ParsedHttpRequest
-from ..parsing import ParseHttpRequestError
-from ..versions import HttpProtocolVersion
-from ..versions import HttpProtocolVersions
+from ....lite.check import check
+from ....sockets.addresses import SocketAddress
+from ...handlers import HttpHandler
+from ...handlers import HttpHandlerRequest
+from ...handlers import HttpHandlerResponseData
+from ...handlers import HttpHandlerResponseStreamedData
+from ...handlers import UnsupportedMethodHttpHandlerError
+from ...parsing import EmptyParsedHttpResult
+from ...parsing import HttpRequestParser
+from ...parsing import ParsedHttpRequest
+from ...parsing import ParseHttpRequestError
+from ...versions import HttpProtocolVersion
+from ...versions import HttpProtocolVersions
 
 
 CoroHttpServerFactory = ta.Callable[[SocketAddress], 'CoroHttpServer']

omlish/http/coro/{simple.py → server/simple.py}

@@ -9,22 +9,22 @@ import contextlib
 import functools
 import typing as ta
 
-from ...lite.check import check
-from ...sockets.addresses import SocketAndAddress
-from ...sockets.bind import CanSocketBinder
-from ...sockets.bind import SocketBinder
-from ...sockets.server.handlers import ExecutorSocketServerHandler
-from ...sockets.server.handlers import SocketHandlerSocketServerHandler
-from ...sockets.server.handlers import SocketServerHandler
-from ...sockets.server.handlers import SocketWrappingSocketServerHandler
-from ...sockets.server.handlers import StandardSocketServerHandler
-from ...sockets.server.server import SocketServer
-from ...sockets.server.ssl import SslErrorHandlingSocketServerHandler
-from ...sockets.server.threading import ThreadingSocketServerHandler
-from ..handlers import HttpHandler
-from ..parsing import HttpRequestParser
-from ..versions import HttpProtocolVersion
-from ..versions import HttpProtocolVersions
+from ....lite.check import check
+from ....sockets.addresses import SocketAndAddress
+from ....sockets.bind import CanSocketBinder
+from ....sockets.bind import SocketBinder
+from ....sockets.server.handlers import ExecutorSocketServerHandler
+from ....sockets.server.handlers import SocketHandlerSocketServerHandler
+from ....sockets.server.handlers import SocketServerHandler
+from ....sockets.server.handlers import SocketWrappingSocketServerHandler
+from ....sockets.server.handlers import StandardSocketServerHandler
+from ....sockets.server.server import SocketServer
+from ....sockets.server.ssl import SslErrorHandlingSocketServerHandler
+from ....sockets.server.threading import ThreadingSocketServerHandler
+from ...handlers import HttpHandler
+from ...parsing import HttpRequestParser
+from ...versions import HttpProtocolVersion
+from ...versions import HttpProtocolVersions
 from .server import CoroHttpServer
 from .sockets import CoroHttpServerSocketHandler
 

omlish/http/coro/{sockets.py → server/sockets.py}

@@ -3,10 +3,10 @@
 import itertools
 import typing as ta
 
-from ...lite.check import check
-from ...sockets.addresses import SocketAddress
-from ...sockets.handlers import SocketHandler_
-from ...sockets.io import SocketIoPair
+from ....lite.check import check
+from ....sockets.addresses import SocketAddress
+from ....sockets.handlers import SocketHandler_
+from ....sockets.io import SocketIoPair
 from .server import CoroHttpServer
 from .server import CoroHttpServerFactory
 

{omlish-0.0.0.dev368.dist-info → omlish-0.0.0.dev369.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omlish
-Version: 0.0.0.dev368
+Version: 0.0.0.dev369
 Summary: omlish
 Author: wrmsr
 License: BSD-3-Clause

{omlish-0.0.0.dev368.dist-info → omlish-0.0.0.dev369.dist-info}/RECORD

@@ -1,5 +1,5 @@
 omlish/.manifests.json,sha256=aT8yZ-Zh-9wfHl5Ym5ouiWC1i0cy7Q7RlhzavB6VLPI,8587
-omlish/__about__.py,sha256=biDAj0KZwKzNN8Ba6UcrJ9VQV3_cdOZt2lA7-prjepc,3478
+omlish/__about__.py,sha256=z2SR3MJ-rRBdt9JGCcv-dKC9J_Pxa9JxjIfu-Cp9uWM,3478
 omlish/__init__.py,sha256=SsyiITTuK0v74XpKV8dqNaCmjOlan1JZKrHQv5rWKPA,253
 omlish/c3.py,sha256=rer-TPOFDU6fYq_AWio_AmA-ckZ8JDY5shIzQ_yXfzA,8414
 omlish/cached.py,sha256=MLap_p0rdGoDIMVhXVHm1tsbcWobJF0OanoodV03Ju8,542
@@ -342,10 +342,19 @@ omlish/http/clients/default.py,sha256=fO8So3pI2z8ateLqt9Sv50UoOJFkUZbgMdoDyWsjBN
 omlish/http/clients/httpx.py,sha256=Grl9_sG7QNIZj8HqaU7XduAsBDyfXl36RjbYQzQqal0,1787
 omlish/http/clients/urllib.py,sha256=DVKFPLQzANiZmwnlbFw5pWs5ZPLLvvgCb3UInvCSqPE,2701
 omlish/http/coro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-omlish/http/coro/fdio.py,sha256=Dc7xKlo5bPZMxpiNwZUxYhdd0kDGoxAtQ11KtbAWb0o,4151
-omlish/http/coro/server.py,sha256=94KsfrORaPHlbM0JXxwd6C63LP22L_Xp1QGvVm84Rlo,18647
-omlish/http/coro/simple.py,sha256=a6ZOPfVndsRz_I3ihJK43yN88mhKTgxVZEtUlSs4NF4,3280
-omlish/http/coro/sockets.py,sha256=ziTzdDCsw3mrwskoGBa4stqkm21ReNq6BtrM-ZkxB3k,2257
+omlish/http/coro/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+omlish/http/coro/client/client.py,sha256=qzWo10R5LJJ2z32HDVoCHxW5fIeytpluK7DGMIaZ0Og,30890
+omlish/http/coro/client/errors.py,sha256=_jwsO9wfwA22ybvkdKnKS6Kbac_qoGbDmuIJbJdjusc,1254
+omlish/http/coro/client/headers.py,sha256=Mgm5rXFTlpLwUW9Dy-7AhnSbTY-DAhrXs_2XCHPRq-o,4666
+omlish/http/coro/client/io.py,sha256=5FGcTyHT-B99RFKc920aERC14vgRXs094v9aXXbaIxc,809
+omlish/http/coro/client/response.py,sha256=joihD-ft5cDw_dvSDaqmIEFkSS8GQ13bwiJ1VE7xYm4,17716
+omlish/http/coro/client/status.py,sha256=EdiScV6lcbVHWNUTyXp7qOBJKh5QYO2TNUCNADitOI0,4266
+omlish/http/coro/client/validation.py,sha256=Hhy_CLN3Z7ZTVGEtPaHzqzDR50ReHKopHKukl8spLYU,5185
+omlish/http/coro/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+omlish/http/coro/server/fdio.py,sha256=qZE4g5y4XESsTObSKyVggI-yzig57gSGJb4Z0rcHvgo,4157
+omlish/http/coro/server/server.py,sha256=5gvueSCUzqBqQRf0GJ6wGroD9DiWxQNi6N17MlEtBLU,18660
+omlish/http/coro/server/simple.py,sha256=j1RZ3niKrgGM2qFnjdYWn_eniZzay5j49Ca4L3u8vO4,3296
+omlish/http/coro/server/sockets.py,sha256=24gU6wpIZuzYWKQD8UsHyYfTZlbcUFvkqXq5KVgWpQo,2261
 omlish/inject/__init__.py,sha256=pY-A8Q4v08-Xa4a-XdZ3lSFC3OwCO2T9HhesB67Q4tQ,1895
 omlish/inject/binder.py,sha256=3-6KMOcSgFE5bvthy3YUrRzCX5w7YSGmdJ3Tv2yXZGw,4022
 omlish/inject/bindings.py,sha256=PlvOnUREjvc6F8nOJdzl1k9SAf80icRB4qWFqDop87M,536
@@ -873,9 +882,9 @@ omlish/typedvalues/marshal.py,sha256=AtBz7Jq-BfW8vwM7HSxSpR85JAXmxK2T0xDblmm1HI0
 omlish/typedvalues/of_.py,sha256=UXkxSj504WI2UrFlqdZJbu2hyDwBhL7XVrc2qdR02GQ,1309
 omlish/typedvalues/reflect.py,sha256=PAvKW6T4cW7u--iX80w3HWwZUS3SmIZ2_lQjT65uAyk,1026
 omlish/typedvalues/values.py,sha256=ym46I-q2QJ_6l4UlERqv3yj87R-kp8nCKMRph0xQ3UA,1307
-omlish-0.0.0.dev368.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev368.dist-info/METADATA,sha256=Ph1mKrNEK3shLSCZ1tB8AQp7iAlOXVNhKqBCD9XbRIU,4416
-omlish-0.0.0.dev368.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-omlish-0.0.0.dev368.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev368.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev368.dist-info/RECORD,,
+omlish-0.0.0.dev369.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev369.dist-info/METADATA,sha256=bUWJ-6YrZYvPAMHccs62WvjREQptgR2l-rx_ApYK824,4416
+omlish-0.0.0.dev369.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+omlish-0.0.0.dev369.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev369.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev369.dist-info/RECORD,,