Загрузить файлы в «venv/Lib/site-packages/h11-0.16.0.dist-info»
This commit is contained in:
1
venv/Lib/site-packages/h11-0.16.0.dist-info/INSTALLER
Normal file
1
venv/Lib/site-packages/h11-0.16.0.dist-info/INSTALLER
Normal file
@@ -0,0 +1 @@
|
|||||||
|
pip
|
||||||
202
venv/Lib/site-packages/h11-0.16.0.dist-info/METADATA
Normal file
202
venv/Lib/site-packages/h11-0.16.0.dist-info/METADATA
Normal file
@@ -0,0 +1,202 @@
|
|||||||
|
Metadata-Version: 2.4
|
||||||
|
Name: h11
|
||||||
|
Version: 0.16.0
|
||||||
|
Summary: A pure-Python, bring-your-own-I/O implementation of HTTP/1.1
|
||||||
|
Home-page: https://github.com/python-hyper/h11
|
||||||
|
Author: Nathaniel J. Smith
|
||||||
|
Author-email: njs@pobox.com
|
||||||
|
License: MIT
|
||||||
|
Classifier: Development Status :: 3 - Alpha
|
||||||
|
Classifier: Intended Audience :: Developers
|
||||||
|
Classifier: License :: OSI Approved :: MIT License
|
||||||
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
||||||
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
||||||
|
Classifier: Programming Language :: Python :: 3
|
||||||
|
Classifier: Programming Language :: Python :: 3 :: Only
|
||||||
|
Classifier: Programming Language :: Python :: 3.8
|
||||||
|
Classifier: Programming Language :: Python :: 3.9
|
||||||
|
Classifier: Programming Language :: Python :: 3.10
|
||||||
|
Classifier: Programming Language :: Python :: 3.11
|
||||||
|
Classifier: Programming Language :: Python :: 3.12
|
||||||
|
Classifier: Topic :: Internet :: WWW/HTTP
|
||||||
|
Classifier: Topic :: System :: Networking
|
||||||
|
Requires-Python: >=3.8
|
||||||
|
License-File: LICENSE.txt
|
||||||
|
Dynamic: author
|
||||||
|
Dynamic: author-email
|
||||||
|
Dynamic: classifier
|
||||||
|
Dynamic: description
|
||||||
|
Dynamic: home-page
|
||||||
|
Dynamic: license
|
||||||
|
Dynamic: license-file
|
||||||
|
Dynamic: requires-python
|
||||||
|
Dynamic: summary
|
||||||
|
|
||||||
|
h11
|
||||||
|
===
|
||||||
|
|
||||||
|
.. image:: https://travis-ci.org/python-hyper/h11.svg?branch=master
|
||||||
|
:target: https://travis-ci.org/python-hyper/h11
|
||||||
|
:alt: Automated test status
|
||||||
|
|
||||||
|
.. image:: https://codecov.io/gh/python-hyper/h11/branch/master/graph/badge.svg
|
||||||
|
:target: https://codecov.io/gh/python-hyper/h11
|
||||||
|
:alt: Test coverage
|
||||||
|
|
||||||
|
.. image:: https://readthedocs.org/projects/h11/badge/?version=latest
|
||||||
|
:target: http://h11.readthedocs.io/en/latest/?badge=latest
|
||||||
|
:alt: Documentation Status
|
||||||
|
|
||||||
|
This is a little HTTP/1.1 library written from scratch in Python,
|
||||||
|
heavily inspired by `hyper-h2 <https://hyper-h2.readthedocs.io/>`_.
|
||||||
|
|
||||||
|
It's a "bring-your-own-I/O" library; h11 contains no IO code
|
||||||
|
whatsoever. This means you can hook h11 up to your favorite network
|
||||||
|
API, and that could be anything you want: synchronous, threaded,
|
||||||
|
asynchronous, or your own implementation of `RFC 6214
|
||||||
|
<https://tools.ietf.org/html/rfc6214>`_ -- h11 won't judge you.
|
||||||
|
(Compare this to the current state of the art, where every time a `new
|
||||||
|
network API <https://trio.readthedocs.io/>`_ comes along then someone
|
||||||
|
gets to start over reimplementing the entire HTTP protocol from
|
||||||
|
scratch.) Cory Benfield made an `excellent blog post describing the
|
||||||
|
benefits of this approach
|
||||||
|
<https://lukasa.co.uk/2015/10/The_New_Hyper/>`_, or if you like video
|
||||||
|
then here's his `PyCon 2016 talk on the same theme
|
||||||
|
<https://www.youtube.com/watch?v=7cC3_jGwl_U>`_.
|
||||||
|
|
||||||
|
This also means that h11 is not immediately useful out of the box:
|
||||||
|
it's a toolkit for building programs that speak HTTP, not something
|
||||||
|
that could directly replace ``requests`` or ``twisted.web`` or
|
||||||
|
whatever. But h11 makes it much easier to implement something like
|
||||||
|
``requests`` or ``twisted.web``.
|
||||||
|
|
||||||
|
At a high level, working with h11 goes like this:
|
||||||
|
|
||||||
|
1) First, create an ``h11.Connection`` object to track the state of a
|
||||||
|
single HTTP/1.1 connection.
|
||||||
|
|
||||||
|
2) When you read data off the network, pass it to
|
||||||
|
``conn.receive_data(...)``; you'll get back a list of objects
|
||||||
|
representing high-level HTTP "events".
|
||||||
|
|
||||||
|
3) When you want to send a high-level HTTP event, create the
|
||||||
|
corresponding "event" object and pass it to ``conn.send(...)``;
|
||||||
|
this will give you back some bytes that you can then push out
|
||||||
|
through the network.
|
||||||
|
|
||||||
|
For example, a client might instantiate and then send a
|
||||||
|
``h11.Request`` object, then zero or more ``h11.Data`` objects for the
|
||||||
|
request body (e.g., if this is a POST), and then a
|
||||||
|
``h11.EndOfMessage`` to indicate the end of the message. Then the
|
||||||
|
server would then send back a ``h11.Response``, some ``h11.Data``, and
|
||||||
|
its own ``h11.EndOfMessage``. If either side violates the protocol,
|
||||||
|
you'll get a ``h11.ProtocolError`` exception.
|
||||||
|
|
||||||
|
h11 is suitable for implementing both servers and clients, and has a
|
||||||
|
pleasantly symmetric API: the events you send as a client are exactly
|
||||||
|
the ones that you receive as a server and vice-versa.
|
||||||
|
|
||||||
|
`Here's an example of a tiny HTTP client
|
||||||
|
<https://github.com/python-hyper/h11/blob/master/examples/basic-client.py>`_
|
||||||
|
|
||||||
|
It also has `a fine manual <https://h11.readthedocs.io/>`_.
|
||||||
|
|
||||||
|
FAQ
|
||||||
|
---
|
||||||
|
|
||||||
|
*Whyyyyy?*
|
||||||
|
|
||||||
|
I wanted to play with HTTP in `Curio
|
||||||
|
<https://curio.readthedocs.io/en/latest/tutorial.html>`__ and `Trio
|
||||||
|
<https://trio.readthedocs.io>`__, which at the time didn't have any
|
||||||
|
HTTP libraries. So I thought, no big deal, Python has, like, a dozen
|
||||||
|
different implementations of HTTP, surely I can find one that's
|
||||||
|
reusable. I didn't find one, but I did find Cory's call-to-arms
|
||||||
|
blog-post. So I figured, well, fine, if I have to implement HTTP from
|
||||||
|
scratch, at least I can make sure no-one *else* has to ever again.
|
||||||
|
|
||||||
|
*Should I use it?*
|
||||||
|
|
||||||
|
Maybe. You should be aware that it's a very young project. But, it's
|
||||||
|
feature complete and has an exhaustive test-suite and complete docs,
|
||||||
|
so the next step is for people to try using it and see how it goes
|
||||||
|
:-). If you do then please let us know -- if nothing else we'll want
|
||||||
|
to talk to you before making any incompatible changes!
|
||||||
|
|
||||||
|
*What are the features/limitations?*
|
||||||
|
|
||||||
|
Roughly speaking, it's trying to be a robust, complete, and non-hacky
|
||||||
|
implementation of the first "chapter" of the HTTP/1.1 spec: `RFC 7230:
|
||||||
|
HTTP/1.1 Message Syntax and Routing
|
||||||
|
<https://tools.ietf.org/html/rfc7230>`_. That is, it mostly focuses on
|
||||||
|
implementing HTTP at the level of taking bytes on and off the wire,
|
||||||
|
and the headers related to that, and tries to be anal about spec
|
||||||
|
conformance. It doesn't know about higher-level concerns like URL
|
||||||
|
routing, conditional GETs, cross-origin cookie policies, or content
|
||||||
|
negotiation. But it does know how to take care of framing,
|
||||||
|
cross-version differences in keep-alive handling, and the "obsolete
|
||||||
|
line folding" rule, so you can focus your energies on the hard /
|
||||||
|
interesting parts for your application, and it tries to support the
|
||||||
|
full specification in the sense that any useful HTTP/1.1 conformant
|
||||||
|
application should be able to use h11.
|
||||||
|
|
||||||
|
It's pure Python, and has no dependencies outside of the standard
|
||||||
|
library.
|
||||||
|
|
||||||
|
It has a test suite with 100.0% coverage for both statements and
|
||||||
|
branches.
|
||||||
|
|
||||||
|
Currently it supports Python 3 (testing on 3.8-3.12) and PyPy 3.
|
||||||
|
The last Python 2-compatible version was h11 0.11.x.
|
||||||
|
(Originally it had a Cython wrapper for `http-parser
|
||||||
|
<https://github.com/nodejs/http-parser>`_ and a beautiful nested state
|
||||||
|
machine implemented with ``yield from`` to postprocess the output. But
|
||||||
|
I had to take these out -- the new *parser* needs fewer lines-of-code
|
||||||
|
than the old *parser wrapper*, is written in pure Python, uses no
|
||||||
|
exotic language syntax, and has more features. It's sad, really; that
|
||||||
|
old state machine was really slick. I just need a few sentences here
|
||||||
|
to mourn that.)
|
||||||
|
|
||||||
|
I don't know how fast it is. I haven't benchmarked or profiled it yet,
|
||||||
|
so it's probably got a few pointless hot spots, and I've been trying
|
||||||
|
to err on the side of simplicity and robustness instead of
|
||||||
|
micro-optimization. But at the architectural level I tried hard to
|
||||||
|
avoid fundamentally bad decisions, e.g., I believe that all the
|
||||||
|
parsing algorithms remain linear-time even in the face of pathological
|
||||||
|
input like slowloris, and there are no byte-by-byte loops. (I also
|
||||||
|
believe that it maintains bounded memory usage in the face of
|
||||||
|
arbitrary/pathological input.)
|
||||||
|
|
||||||
|
The whole library is ~800 lines-of-code. You can read and understand
|
||||||
|
the whole thing in less than an hour. Most of the energy invested in
|
||||||
|
this so far has been spent on trying to keep things simple by
|
||||||
|
minimizing special-cases and ad hoc state manipulation; even though it
|
||||||
|
is now quite small and simple, I'm still annoyed that I haven't
|
||||||
|
figured out how to make it even smaller and simpler. (Unfortunately,
|
||||||
|
HTTP does not lend itself to simplicity.)
|
||||||
|
|
||||||
|
The API is ~feature complete and I don't expect the general outlines
|
||||||
|
to change much, but you can't judge an API's ergonomics until you
|
||||||
|
actually document and use it, so I'd expect some changes in the
|
||||||
|
details.
|
||||||
|
|
||||||
|
*How do I try it?*
|
||||||
|
|
||||||
|
.. code-block:: sh
|
||||||
|
|
||||||
|
$ pip install h11
|
||||||
|
$ git clone git@github.com:python-hyper/h11
|
||||||
|
$ cd h11/examples
|
||||||
|
$ python basic-client.py
|
||||||
|
|
||||||
|
and go from there.
|
||||||
|
|
||||||
|
*License?*
|
||||||
|
|
||||||
|
MIT
|
||||||
|
|
||||||
|
*Code of conduct?*
|
||||||
|
|
||||||
|
Contributors are requested to follow our `code of conduct
|
||||||
|
<https://github.com/python-hyper/h11/blob/master/CODE_OF_CONDUCT.md>`_ in
|
||||||
|
all project spaces.
|
||||||
29
venv/Lib/site-packages/h11-0.16.0.dist-info/RECORD
Normal file
29
venv/Lib/site-packages/h11-0.16.0.dist-info/RECORD
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
h11-0.16.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
|
||||||
|
h11-0.16.0.dist-info/METADATA,sha256=KPMmCYrAn8unm48YD5YIfIQf4kViFct7hyqcfVzRnWQ,8348
|
||||||
|
h11-0.16.0.dist-info/RECORD,,
|
||||||
|
h11-0.16.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
|
||||||
|
h11-0.16.0.dist-info/licenses/LICENSE.txt,sha256=N9tbuFkm2yikJ6JYZ_ELEjIAOuob5pzLhRE4rbjm82E,1124
|
||||||
|
h11-0.16.0.dist-info/top_level.txt,sha256=F7dC4jl3zeh8TGHEPaWJrMbeuoWbS379Gwdi-Yvdcis,4
|
||||||
|
h11/__init__.py,sha256=iO1KzkSO42yZ6ffg-VMgbx_ZVTWGUY00nRYEWn-s3kY,1507
|
||||||
|
h11/__pycache__/__init__.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_abnf.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_connection.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_events.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_headers.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_readers.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_receivebuffer.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_state.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_util.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_version.cpython-314.pyc,,
|
||||||
|
h11/__pycache__/_writers.cpython-314.pyc,,
|
||||||
|
h11/_abnf.py,sha256=ybixr0xsupnkA6GFAyMubuXF6Tc1lb_hF890NgCsfNc,4815
|
||||||
|
h11/_connection.py,sha256=k9YRVf6koZqbttBW36xSWaJpWdZwa-xQVU9AHEo9DuI,26863
|
||||||
|
h11/_events.py,sha256=I97aXoal1Wu7dkL548BANBUCkOIbe-x5CioYA9IBY14,11792
|
||||||
|
h11/_headers.py,sha256=P7D-lBNxHwdLZPLimmYwrPG-9ZkjElvvJZJdZAgSP-4,10412
|
||||||
|
h11/_readers.py,sha256=a4RypORUCC3d0q_kxPuBIM7jTD8iLt5X91TH0FsduN4,8590
|
||||||
|
h11/_receivebuffer.py,sha256=xrspsdsNgWFxRfQcTXxR8RrdjRXXTK0Io5cQYWpJ1Ws,5252
|
||||||
|
h11/_state.py,sha256=_5LG_BGR8FCcFQeBPH-TMHgm_-B-EUcWCnQof_9XjFE,13231
|
||||||
|
h11/_util.py,sha256=LWkkjXyJaFlAy6Lt39w73UStklFT5ovcvo0TkY7RYuk,4888
|
||||||
|
h11/_version.py,sha256=GVSsbPSPDcOuF6ptfIiXnVJoaEm3ygXbMnqlr_Giahw,686
|
||||||
|
h11/_writers.py,sha256=oFKm6PtjeHfbj4RLX7VB7KDc1gIY53gXG3_HR9ltmTA,5081
|
||||||
|
h11/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7
|
||||||
5
venv/Lib/site-packages/h11-0.16.0.dist-info/WHEEL
Normal file
5
venv/Lib/site-packages/h11-0.16.0.dist-info/WHEEL
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
Wheel-Version: 1.0
|
||||||
|
Generator: setuptools (78.1.0)
|
||||||
|
Root-Is-Purelib: true
|
||||||
|
Tag: py3-none-any
|
||||||
|
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
h11
|
||||||
Reference in New Issue
Block a user