adulau/HHHash
1
0
Fork 0
mirror of https://github.com/adulau/HHHash.git synced 2024-12-22 00:36:01 +00:00
Code Issues Projects Releases Packages Wiki Activity

chg: [doc] updated docstring to Markdown format

Browse source
This commit is contained in:
Alexandre Dulaunoy 2023-07-15 10:27:12 +02:00
parent a8e025f087
commit 9ccb144c18
Signed by: adulau
GPG key ID: 09E2CD4944E6CBCD
1 changed files with 16 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
hhhash/create.py
View file

@ -6,11 +6,13 @@ def buildhash(url=None, debug=False, method='GET', timeout=5):
"""Build a HHHash from an HTTP request to specific url.
Keyword arguments:
url -- the url to build the HHHash from the response headers (default None)
debug -- output the headers returned before hashing (default False)
method -- HTTP method to use (GET or HEAD) (default GET)
timeout -- default timeout for the connect/read timeout of request (default 2)
"""
- `url` -- the url to build the HHHash from the response headers (default None)
- `debug` -- output the headers returned before hashing (default False)
- `method` -- HTTP method to use (GET or HEAD) (default GET)
- `timeout` -- default timeout for the connect/read timeout of request (default 2)
For more details about the [HHHash algorithm](https://www.foo.be/2023/07/HTTP-Headers-Hashing_HHHash).
"""
if url is None:
return False
if method == 'GET':
@ -30,13 +32,15 @@ def buildhash(url=None, debug=False, method='GET', timeout=5):
return f"hhh:1:{digest}"
def hash_from_banner(banner, debug=False):
"""Create a HHHash from an already fetched banner. Lines without colons will be skipped.
"""Create a HHHash from an already fetched banner. Lines without colons will be skipped.
Keyword arguments:
banner -- HTTP banner string
debug -- output the headers returned before hashing
Example:
- `banner` -- HTTP banner as a string
- `debug` -- output the headers returned before hashing
Example usage:
```
>>> hash_from_banner('''HTTP/1.1 200 OK
... Content-Type: text/html; charset=ISO-8859-1
... Content-Security-Policy-Report-Only: object-src 'none';base-uri 'self';script-src 'nonce-iV-j91UJEG2jNx4j6EeTug' 'strict-dynamic' 'report-sample' 'unsafe-eval' 'unsafe-inline' https: http:;report-uri https://csp.withgoogle.com/csp/gws/other-hp
@ -53,6 +57,8 @@ def hash_from_banner(banner, debug=False):
... Set-Cookie: <removed>
... Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000''')
hhh:1:d9576f3e7a381562f7d18a514ab095fa8699e96891d346d0042f83e942373215
```
"""
hhhash = ""
for line in banner.splitlines():