healthchecks/templates/docs/python.md

# Python

If you are already using the requests library, it is convenient to also use it here:

```python
import requests

try:
    requests.get("PING_URL", timeout=10)
except requests.RequestException as e:
    # Log ping failure here...
    print("Ping failed: %s" % e)
```

Otherwise, you can use the urllib module from Python 3 standard libary:

```python
import socket
import urllib.request

try:
    urllib.request.urlopen("PING_URL", timeout=10)
except socket.error as e:
    # Log ping failure here...
    print("Ping failed: %s" % e)
```

You can include additional diagnostic information in the in the request body (for POST requests):

```python
# Passing diagnostic information in the POST body:
import requests
requests.post("PING_URL", data="temperature=-7")
```