Use requests to talk HTTP via a UNIX domain socket
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
Use requests to talk HTTP via a UNIX domain socket
Usage
Explicit
You can use it by instantiating a special Session object:
import json
import requests_unixsocket
session = requests_unixsocket.Session()
r = session.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/info')
registry_config = r.json()['RegistryConfig']
print(json.dumps(registry_config, indent=4))Implicit (monkeypatching)
Monkeypatching allows you to use the functionality in this module, while making minimal changes to your code. Note that in the above example we had to instantiate a special requests_unixsocket.Session object and call the get method on that object. Calling requests.get(url) (the easiest way to use requests and probably very common), would not work. But we can make it work by doing monkeypatching.
You can monkeypatch globally:
import requests_unixsocket
requests_unixsocket.monkeypatch()
r = requests.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/info')
assert r.status_code == 200or you can do it temporarily using a context manager:
import requests_unixsocket
with requests_unixsocket.monkeypatch():
r = requests.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/info')
assert r.status_code == 200Abstract namespace sockets
To connect to an abstract namespace socket (Linux only), prefix the name with a NULL byte (i.e.: 0) - e.g.:
import requests_unixsocket
session = requests_unixsocket.Session()
res = session.get('http+unix://\0test_socket/get')
print(res.text)For an example program that illustrates this, see examples/abstract_namespace.py in the git repo. Since abstract namespace sockets are specific to Linux, the program will only work on Linux.
See also
https://github.com/httpie/httpie-unixsocket - a plugin for HTTPie that allows you to interact with UNIX domain sockets
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file requests_unixsocket-0.4.1.tar.gz.
File metadata
- Download URL: requests_unixsocket-0.4.1.tar.gz
- Upload date:
- Size: 23.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b2596158c356ecee68d27ba469a52211230ac6fb0cde8b66afb19f0ed47a1995 |
|
| MD5 | a45dc2284ad8f8cb57579c8af4257aec |
|
| BLAKE2b-256 | 228044636b363e75af7f5e6ac0571137466fec66e47016179139d0019a453ab7 |
Provenance
The following attestation bundles were made for requests_unixsocket-0.4.1.tar.gz:
Publisher:
ci-cd.yml on msabramo/requests-unixsocket
-
Statement:
- Statement type:
https://in-toto.io/Statement/v1 - Predicate type:
https://docs.pypi.org/attestations/publish/v1 - Subject name:
requests_unixsocket-0.4.1.tar.gz - Subject digest:
b2596158c356ecee68d27ba469a52211230ac6fb0cde8b66afb19f0ed47a1995 - Sigstore transparency entry: 178713486
- Sigstore integration time:
- Permalink:
msabramo/requests-unixsocket@c810a233ca79258037cebe8a9684482f712095d3 - Branch / Tag:
refs/heads/master - Owner: https://github.com/msabramo
- Access:
public
- Token Issuer:
https://token.actions.githubusercontent.com - Runner Environment:
github-hosted - Publication workflow:
ci-cd.yml@c810a233ca79258037cebe8a9684482f712095d3 - Trigger Event:
workflow_dispatch
- Statement type:
File details
Details for the file requests_unixsocket-0.4.1-py3-none-any.whl.
File metadata
- Download URL: requests_unixsocket-0.4.1-py3-none-any.whl
- Upload date:
- Size: 11.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 60c4942e9dbecc2f64d611039fb1dfc25da382083c6434ac0316dca3ff908f4d |
|
| MD5 | e504a042c01c9dc9d4eed32c18c9e9fc |
|
| BLAKE2b-256 | 6386df4771915e64a564c577ea2573956861c9c9f6c79450b172c5f9277cc48a |
Provenance
The following attestation bundles were made for requests_unixsocket-0.4.1-py3-none-any.whl:
Publisher:
ci-cd.yml on msabramo/requests-unixsocket
-
Statement:
- Statement type:
https://in-toto.io/Statement/v1 - Predicate type:
https://docs.pypi.org/attestations/publish/v1 - Subject name:
requests_unixsocket-0.4.1-py3-none-any.whl - Subject digest:
60c4942e9dbecc2f64d611039fb1dfc25da382083c6434ac0316dca3ff908f4d - Sigstore transparency entry: 178713489
- Sigstore integration time:
- Permalink:
msabramo/requests-unixsocket@c810a233ca79258037cebe8a9684482f712095d3 - Branch / Tag:
refs/heads/master - Owner: https://github.com/msabramo
- Access:
public
- Token Issuer:
https://token.actions.githubusercontent.com - Runner Environment:
github-hosted - Publication workflow:
ci-cd.yml@c810a233ca79258037cebe8a9684482f712095d3 - Trigger Event:
workflow_dispatch
- Statement type:
