Install HTTPX using pip:
```shell
-$ pip install httpx
+pip install httpx
```
Now, let's get started:
Or, using the command-line client.
```shell
-$ pip install 'httpx[cli]' # The command line client is an optional dependency.
+pip install 'httpx[cli]' # The command line client is an optional dependency.
```
Which now allows us to use HTTPX directly from the command-line...
Install with pip:
```shell
-$ pip install httpx
+pip install httpx
```
Or, to include the optional HTTP/2 support, use:
```shell
-$ pip install httpx[http2]
+pip install httpx[http2]
```
HTTPX requires Python 3.8+.
You can install SOCKS support using `pip`:
```shell
-$ pip install httpx[socks]
+pip install httpx[socks]
```
You can now configure a client to make requests via a proxy using the SOCKS protocol:
your GitHub username:
```shell
-$ git clone https://github.com/YOUR-USERNAME/httpx
+git clone https://github.com/YOUR-USERNAME/httpx
```
You can now install the project and its dependencies using:
```shell
-$ cd httpx
-$ scripts/install
+cd httpx
+scripts/install
```
## Testing and Linting
To run the tests, use:
```shell
-$ scripts/test
+scripts/test
```
!!! warning
For example, to run a single test script:
```shell
-$ scripts/test tests/test_multipart.py
+scripts/test tests/test_multipart.py
```
To run the code auto-formatting:
```shell
-$ scripts/lint
+scripts/lint
```
Lastly, to run code checks separately (they are also run as part of `scripts/test`), run:
```shell
-$ scripts/check
+scripts/check
```
## Documenting
To run the documentation site locally (useful for previewing changes), use:
```shell
-$ scripts/docs
+scripts/docs
```
## Resolving Build / CI Failures
You can look at the job output to figure out why it's failed or within a shell run:
```shell
-$ scripts/check
+scripts/check
```
It may be worth it to run `$ scripts/lint` to attempt auto-formatting the code
the optional HTTP/2 dependencies...
```shell
-$ pip install httpx[http2]
+pip install httpx[http2]
```
And then instantiating a client with HTTP/2 support enabled:
Install HTTPX using pip:
```shell
-$ pip install httpx
+pip install httpx
```
Now, let's get started:
```shell
# The command line client is an optional dependency.
-$ pip install 'httpx[cli]'
+pip install 'httpx[cli]'
```
Which now allows us to use HTTPX directly from the command-line...
Install with pip:
```shell
-$ pip install httpx
+pip install httpx
```
Or, to include the optional HTTP/2 support, use:
```shell
-$ pip install httpx[http2]
+pip install httpx[http2]
```
To include the optional brotli and zstandard decoders support, use:
```shell
-$ pip install httpx[brotli,zstd]
+pip install httpx[brotli,zstd]
```
HTTPX requires Python 3.8+