30 releases

0.7.14 Mar 21, 2024
0.7.9 Jan 5, 2024
0.7.8 Dec 16, 2023
0.7.2 Aug 10, 2023
0.2.7 Oct 27, 2022

#292 in Authentication

Download history 92/week @ 2023-12-22 270/week @ 2023-12-29 320/week @ 2024-01-05 470/week @ 2024-01-12 449/week @ 2024-01-19 285/week @ 2024-01-26 329/week @ 2024-02-02 498/week @ 2024-02-09 636/week @ 2024-02-16 980/week @ 2024-02-23 571/week @ 2024-03-01 350/week @ 2024-03-08 218/week @ 2024-03-15 134/week @ 2024-03-22 600/week @ 2024-03-29 183/week @ 2024-04-05

1,191 downloads per month
Used in qcs

Apache-2.0

360KB
7K SLoC

qcs-api-client-grpc

crates.io version crates.io license - Apache-2.0 crates.io recent downloads docs.rs badge

This crate provides an autogenerated gRPC client for the QCS API, along with helper utilities for automatically loading credentials from a user's QCS config and keeping authentication tokens refreshed.

  • get_channel: create a Channel to the given gRPC endpoint with QCS authentication automatically set up, that routes requests through client-side HTTP, HTTPS, or SOCKS5 proxies based on the presence of HTTPS_PROXY or HTTP_PROXY environment variables.
  • wrap_channel: wrap an existing Channel with QCS authentication.

Quick Start

See docs.rs for a quick start guide.

Proxies

The get_channel function configures the returned Channel to route requests through a client proxy based on the presence of environment variables HTTPS_PROXY and/or HTTP_PROXY. The variable names can be all-uppercase or all-lowercase, but the all-uppercase variants will take precedence. Currently, the supported proxy schemes are http, https, and socks5.

There are some caveats to the proxy configuration:

  • If both variables are defined, neither can be a socks5 proxy, unless they are both the same value.
  • If only one variable is defined, and it is a socks5 proxy, all traffic will routed through it.

Dependencies

~21–38MB
~706K SLoC