⚗️ Try compatible fork Niquests to supercharge HTTPie

Author: Ahmed TAHRI

.github/workflows/tests.yml

@@ -25,8 +25,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: [3.7, 3.8, 3.9, "3.10"]
-        pyopenssl: [0, 1]
+        python-version: [3.7, 3.8, 3.9, "3.10", "3.11", "3.12"]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v3
@@ -39,12 +38,8 @@ jobs:
           python -m pip install --upgrade pip wheel
           python -m pip install --upgrade '.[dev]'
           python -m pytest --verbose ./httpie ./tests
-        env:
-          HTTPIE_TEST_WITH_PYOPENSSL: ${{ matrix.pyopenssl }}
       - name: Linux & Mac setup
         if: matrix.os != 'windows-latest'
         run: |
           make install
           make test
-        env:
-          HTTPIE_TEST_WITH_PYOPENSSL: ${{ matrix.pyopenssl }}

docs/README.md

@@ -1562,9 +1562,9 @@ be printed via several options:
 |---------------------------:|----------------------------------------------------------------------------------------------------|
 |            `--headers, -h` | Only the response headers are printed                                                              |
 |               `--body, -b` | Only the response body is printed                                                                  |
-|               `--meta, -m` | Only the [response metadata](#response-meta) is printed                                            |
+|               `--meta, -m` | Only the [request, response metadata](#response-meta) are printed                                  |
 |            `--verbose, -v` | Print the whole HTTP exchange (request and response). This option also enables `--all` (see below) |
-| `--verbose --verbose, -vv` | Just like `-v`, but also include the response metadata.                                            |
+| `--verbose --verbose, -vv` | Just like `-v`, but also include the request, and response metadata.                               |
 |              `--print, -p` | Selects parts of the HTTP exchange                                                                 |
 |              `--quiet, -q` | Don’t print anything to `stdout` and `stderr`                                                      |
 
@@ -1573,13 +1573,13 @@ be printed via several options:
 All the other [output options](#output-options) are under the hood just shortcuts for the more powerful `--print, -p`.
 It accepts a string of characters each of which represents a specific part of the HTTP exchange:
 
-| Character | Stands for                      |
-|----------:|---------------------------------|
-|       `H` | request headers                 |
-|       `B` | request body                    |
-|       `h` | response headers                |
-|       `b` | response body                   |
-|       `m` | [response meta](#response-meta) |
+| Character | Stands for                               |
+|----------:|------------------------------------------|
+|       `H` | request headers                          |
+|       `B` | request body                             |
+|       `h` | response headers                         |
+|       `b` | response body                            |
+|       `m` | [request, response meta](#response-meta) |
 
 Print request and response headers:
 
@@ -1592,24 +1592,38 @@ $ http --print=Hh PUT pie.dev/put hello=world
 The response metadata section currently includes the total time elapsed. It’s the number of seconds between opening the network connection and downloading the last byte of response the body.
 
 
-To _only_ show the response metadata, use `--meta, -m` (analogically to `--headers, -h` and `--body, -b`):
+To _only_ show the request, and response metadata, use `--meta, -m` (analogically to `--headers, -h` and `--body, -b`):
 
 ```bash
 $ http --meta pie.dev/delay/1
 ```
 
 ```console
+Connected to: 2a06:98c1:3120::2 port 443
+Connection secured using: TLSv1.3 with AES-256-GCM-SHA384
+Server certificate: commonName="pie.dev"; DNS="*.pie.dev"; DNS="pie.dev"
+Certificate validity: "Nov 11 01:14:24 2023 UTC" to "Feb 09 01:14:23 2024 UTC"
+Issuer: countryName="US"; organizationName="Let's Encrypt"; commonName="E1"
+Revocation status: Good
+
 Elapsed time: 1.099171542s
 ```
 
 The [extra verbose `-vv` output](#extra-verbose-output) includes the meta section by default. You can also show it in combination with other parts of the exchange via [`--print=m`](#what-parts-of-the-http-exchange-should-be-printed). For example, here we print it together with the response headers:
 
 ```bash
-$ http --print=hm pie.dev/get
+$ https --print=hm pie.dev/get
 ```
 
 ```http
-HTTP/1.1 200 OK
+Connected to: 2a06:98c1:3120::2 port 443
+Connection secured using: TLSv1.3 with AES-256-GCM-SHA384
+Server certificate: commonName="pie.dev"; DNS="*.pie.dev"; DNS="pie.dev"
+Certificate validity: "Nov 11 01:14:24 2023 UTC" to "Feb 09 01:14:23 2024 UTC"
+Issuer: countryName="US"; organizationName="Let's Encrypt"; commonName="E1"
+Revocation status: Good
+
+HTTP/2 200 OK
 Content-Type: application/json
 
 Elapsed time: 0.077538375s
@@ -1626,19 +1640,19 @@ If you [use `--style` with one of the Pie themes](#colors-and-formatting), you
 `--verbose` can often be useful for debugging the request and generating documentation examples:
 
 ```bash
-$ http --verbose PUT pie.dev/put hello=world
-PUT /put HTTP/1.1
+$ https --verbose PUT pie.dev/put hello=world
+PUT /put HTTP/2
 Accept: application/json, */*;q=0.5
 Accept-Encoding: gzip, deflate
 Content-Type: application/json
 Host: pie.dev
-User-Agent: HTTPie/0.2.7dev
+User-Agent: HTTPie/4.0.0
 
 {
     "hello": "world"
 }
 
-HTTP/1.1 200 OK
+HTTP/2 200 OK
 Connection: keep-alive
 Content-Length: 477
 Content-Type: application/json
@@ -1652,10 +1666,10 @@ Server: gunicorn/0.13.4
 
 #### Extra verbose output
 
-If you run HTTPie with `-vv` or `--verbose --verbose`, then it would also display the [response metadata](#response-meta).
+If you run HTTPie with `-vv` or `--verbose --verbose`, then it would also display the [response and request metadata](#response-meta).
 
 ```bash
-# Just like the above, but with additional columns like the total elapsed time
+# Just like the above, but with additional columns like the total elapsed time, remote peer connection informations
 $ http -vv pie.dev/get
 ```
 
@@ -1833,6 +1847,31 @@ $ http --chunked pie.dev/post @files/data.xml
 $ cat files/data.xml | http --chunked pie.dev/post
 ```
 
+## Disable HTTP/2, or HTTP/3
+
+You can at your own discretion toggle on and off HTTP/2, or/and HTTP/3.
+
+```bash
+$ https --disable-http2 PUT pie.dev/put hello=world
+```
+
+```bash
+$ https --disable-http3 PUT pie.dev/put hello=world
+```
+
+## Force HTTP/3
+
+By opposition to the previous section, you can force the HTTP/3 negotiation.
+
+```bash
+$ https --http3 pie.dev/get
+```
+
+By default, HTTPie cannot negotiate HTTP/3 without a first HTTP/1.1, or HTTP/2 successful response.
+The remote server yield its support for HTTP/3 in the Alt-Svc header, if present HTTPie will issue
+the successive requests via HTTP/3. You may use that argument in case the remote peer does not support
+either HTTP/1.1 or HTTP/2.
+
 ## Compressed request body
 
 You can use the `--compress, -x` flag to instruct HTTPie to use `Content-Encoding: deflate` and compress the request data:
@@ -2556,7 +2595,7 @@ HTTPie has the following community channels:
 
 Under the hood, HTTPie uses these two amazing libraries:
 
-- [Requests](https://requests.readthedocs.io/en/latest/) — Python HTTP library for humans
+- [Niquests](https://niquests.readthedocs.io/en/latest/) — Python HTTP library for humans
 - [Pygments](https://pygments.org/) — Python syntax highlighter
 
 #### HTTPie friends

docs/contributors/fetch.py

@@ -1,7 +1,7 @@
 """
 Generate the contributors database.
 
-FIXME: replace `requests` calls with the HTTPie API, when available.
+FIXME: replace `niquests` calls with the HTTPie API, when available.
 """
 import json
 import os
@@ -14,7 +14,7 @@
 from time import sleep
 from typing import Any, Dict, Optional, Set
 
-import requests
+import niquests
 
 FullNames = Set[str]
 GitHubLogins = Set[str]
@@ -197,10 +197,10 @@ def fetch(url: str, params: Optional[Dict[str, str]] = None) -> UserInfo:
     }
     for retry in range(1, 6):
         debug(f'[{retry}/5]', f'{url = }', f'{params = }')
-        with requests.get(url, params=params, headers=headers) as req:
+        with niquests.get(url, params=params, headers=headers) as req:
             try:
                 req.raise_for_status()
-            except requests.exceptions.HTTPError as exc:
+            except niquests.exceptions.HTTPError as exc:
                 if exc.response.status_code == 403:
                     # 403 Client Error: rate limit exceeded for url: ...
                     now = int(datetime.utcnow().timestamp())

httpie/__init__.py

@@ -3,7 +3,7 @@
 
 """
 
-__version__ = '3.2.2'
-__date__ = '2022-05-06'
+__version__ = '4.0.0'
+__date__ = '2023-10-11'
 __author__ = 'Jakub Roztocil'
 __licence__ = 'BSD'

httpie/adapters.py

@@ -1,5 +1,5 @@
 from httpie.cli.dicts import HTTPHeadersDict
-from requests.adapters import HTTPAdapter
+from niquests.adapters import HTTPAdapter
 
 
 class HTTPieHTTPAdapter(HTTPAdapter):

httpie/cli/argparser.py

@@ -7,7 +7,7 @@
 from textwrap import dedent
 from urllib.parse import urlsplit
 
-from requests.utils import get_netrc_auth
+from niquests.utils import get_netrc_auth
 
 from .argtypes import (
     AuthCredentials, SSLCredentials, KeyValueArgType,

httpie/cli/definition.py

@@ -802,6 +802,32 @@ def format_auth_help(auth_plugins_mapping, *, isolation_mode: bool = False):
         'The Transfer-Encoding header is set to chunked.'
     )
 )
+network.add_argument(
+    "--disable-http2",
+    default=False,
+    action="store_true",
+    short_help="Disable the HTTP/2 protocol."
+)
+network.add_argument(
+    "--disable-http3",
+    default=False,
+    action="store_true",
+    short_help="Disable the HTTP/3 over QUIC protocol."
+)
+network.add_argument(
+    "--http3",
+    default=False,
+    dest="force_http3",
+    action="store_true",
+    short_help="Use the HTTP/3 protocol for the request.",
+    help="""
+    By default, HTTPie cannot negotiate HTTP/3 without a first HTTP/1.1, or HTTP/2 successful response.
+    The remote server yield its support for HTTP/3 in the Alt-Svc header, if present HTTPie will issue
+    the successive requests via HTTP/3. You may use that argument in case the remote peer does not support
+    either HTTP/1.1 or HTTP/2.
+
+    """
+)
 
 #######################################################################
 # SSL