k3http 0.1.0__tar.gz → 0.1.2__tar.gz

k3http-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 张炎泼
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

k3http-0.1.2/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: k3http
+Version: 0.1.2
+Summary: HTTP/1.1 client with timeout support
+Author-email: Zhang Yanpo <drdr.xp@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/pykit3/k3http
+Project-URL: Documentation, https://k3http.readthedocs.io
+Keywords: http,client,socket,timeout
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: k3stopwatch
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: k3ut; extra == "dev"
+Provides-Extra: publish
+Requires-Dist: build; extra == "publish"
+Requires-Dist: twine; extra == "publish"
+Requires-Dist: pk3; extra == "publish"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+Dynamic: license-file
+
+# k3http
+
+[![Action-CI](https://github.com/pykit3/k3http/actions/workflows/python-package.yml/badge.svg)](https://github.com/pykit3/k3http/actions/workflows/python-package.yml)
+[![Build Status](https://travis-ci.com/pykit3/k3http.svg?branch=master)](https://travis-ci.com/pykit3/k3http)
+[![Documentation Status](https://readthedocs.org/projects/k3http/badge/?version=stable)](https://k3http.readthedocs.io/en/stable/?badge=stable)
+[![Package](https://img.shields.io/pypi/pyversions/k3http)](https://pypi.org/project/k3http)
+
+We find that 'httplib' must work in blocking mode and it can not have a timeout when recving response.
+
+k3http is a component of [pykit3] project: a python3 toolkit set.
+
+
+HTTP/1.1 client
+
+Use this module, we can set timeout, if timeout raise a 'socket.timeout'.
+
+
+
+# Install
+
+```
+pip install k3http
+```
+
+# Synopsis
+
+```python
+
+import k3http
+import urllib
+import socket
+
+headers = {
+    'Host': '127.0.0.1',
+    'Accept-Language': 'en, mi',
+}
+
+try:
+    h = k3http.Client('127.0.0.1', 80)
+
+    # send http reqeust without body
+    # read response status line
+    # read response headers
+    h.request('/test.txt', method='GET', headers=headers)
+
+    status = h.status
+    # response code return from http server, type is int
+    # 200
+    # 302
+    # 404
+    # ...
+
+    res_headers = h.headers
+    # response headers except status line
+    # res_headers = {
+    #   'Content-Type': 'text/html;charset=utf-8',
+    #   'Content-Length': 1024,
+    #   ...
+    # }
+
+    # get response body
+    print(h.read_body(None))
+except (socket.error, k3http.HttpError) as e:
+    print(repr(e))
+
+
+
+content = urllib.urlencode({'f': 'foo', 'b': 'bar'})
+headers = {
+    'Host': 'www.example.com',
+    'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
+    'Content-Length': len(content),
+}
+
+try:
+    h = k3http.Client('127.0.0.1', 80)
+
+    # send http reqeust
+    h.send_request('http://www.example.com', method='POST', headers=headers)
+
+    # send http request body
+    h.send_body(content)
+
+    # read response status line and headers
+    status, headers = h.read_response()
+
+    # read response body
+    print(h.read_body(None))
+except (socket.error, k3http.HttpError) as e:
+    print(repr(e))
+
+```
+
+#   Author
+
+Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>
+
+#   Copyright and License
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>
+
+
+[pykit3]: https://github.com/pykit3

k3http-0.1.2/README.md

@@ -0,0 +1,105 @@
+# k3http
+
+[![Action-CI](https://github.com/pykit3/k3http/actions/workflows/python-package.yml/badge.svg)](https://github.com/pykit3/k3http/actions/workflows/python-package.yml)
+[![Build Status](https://travis-ci.com/pykit3/k3http.svg?branch=master)](https://travis-ci.com/pykit3/k3http)
+[![Documentation Status](https://readthedocs.org/projects/k3http/badge/?version=stable)](https://k3http.readthedocs.io/en/stable/?badge=stable)
+[![Package](https://img.shields.io/pypi/pyversions/k3http)](https://pypi.org/project/k3http)
+
+We find that 'httplib' must work in blocking mode and it can not have a timeout when recving response.
+
+k3http is a component of [pykit3] project: a python3 toolkit set.
+
+
+HTTP/1.1 client
+
+Use this module, we can set timeout, if timeout raise a 'socket.timeout'.
+
+
+
+# Install
+
+```
+pip install k3http
+```
+
+# Synopsis
+
+```python
+
+import k3http
+import urllib
+import socket
+
+headers = {
+    'Host': '127.0.0.1',
+    'Accept-Language': 'en, mi',
+}
+
+try:
+    h = k3http.Client('127.0.0.1', 80)
+
+    # send http reqeust without body
+    # read response status line
+    # read response headers
+    h.request('/test.txt', method='GET', headers=headers)
+
+    status = h.status
+    # response code return from http server, type is int
+    # 200
+    # 302
+    # 404
+    # ...
+
+    res_headers = h.headers
+    # response headers except status line
+    # res_headers = {
+    #   'Content-Type': 'text/html;charset=utf-8',
+    #   'Content-Length': 1024,
+    #   ...
+    # }
+
+    # get response body
+    print(h.read_body(None))
+except (socket.error, k3http.HttpError) as e:
+    print(repr(e))
+
+
+
+content = urllib.urlencode({'f': 'foo', 'b': 'bar'})
+headers = {
+    'Host': 'www.example.com',
+    'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
+    'Content-Length': len(content),
+}
+
+try:
+    h = k3http.Client('127.0.0.1', 80)
+
+    # send http reqeust
+    h.send_request('http://www.example.com', method='POST', headers=headers)
+
+    # send http request body
+    h.send_body(content)
+
+    # read response status line and headers
+    status, headers = h.read_response()
+
+    # read response body
+    print(h.read_body(None))
+except (socket.error, k3http.HttpError) as e:
+    print(repr(e))
+
+```
+
+#   Author
+
+Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>
+
+#   Copyright and License
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>
+
+
+[pykit3]: https://github.com/pykit3

{k3http-0.1.0/k3http → k3http-0.1.2}/__init__.py

@@ -4,9 +4,9 @@ HTTP/1.1 client
 Use this module, we can set timeout, if timeout raise a 'socket.timeout'.
 """
 
+from importlib.metadata import version
 
-__version__ = "0.1.0"
-__name__ = "k3http"
+__version__ = version("k3http")
 
 from .client import (
     HttpError,
@@ -17,25 +17,22 @@ from .client import (
     HeadersError,
     BadStatusLineError,
     Client,
-
 )
 
-from .util import(
+from .util import (
     headers_add_host,
     request_add_host,
 )
 
 __all__ = [
-    'HttpError',
-    'LineTooLongError',
-    'ChunkedSizeError',
-    'NotConnectedError',
-    'ResponseNotReadyError',
-    'HeadersError',
-    'BadStatusLineError',
-    'Client',
-
-    'headers_add_host',
-    'request_add_host',
+    "HttpError",
+    "LineTooLongError",
+    "ChunkedSizeError",
+    "NotConnectedError",
+    "ResponseNotReadyError",
+    "HeadersError",
+    "BadStatusLineError",
+    "Client",
+    "headers_add_host",
+    "request_add_host",
 ]
-