1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
|
Source: golang-github-azure-go-autorest
Section: devel
Priority: optional
Maintainer: Debian Go Packaging Team <pkg-go-maintainers@lists.alioth.debian.org>
Uploaders: Tianon Gravi <tianon@debian.org>,
MartÃn Ferrari <tincho@debian.org>,
Tim Potter <tpot@hpe.com>,
Build-Depends: debhelper (>= 10),
dh-golang (>= 1.17~),
golang-any (>= 2:1.4~),
golang-github-dgrijalva-jwt-go-v3-dev,
golang-github-stretchr-testify-dev,
golang-golang-x-crypto-dev,
Standards-Version: 4.1.0
Homepage: https://github.com/Azure/go-autorest
Vcs-Browser: https://anonscm.debian.org/cgit/pkg-go/packages/golang-github-azure-go-autorest.git
Vcs-Git: https://anonscm.debian.org/git/pkg-go/packages/golang-github-azure-go-autorest.git
XS-Go-Import-Path: github.com/Azure/go-autorest
Testsuite: autopkgtest-pkg-go
Package: golang-github-azure-go-autorest-dev
Architecture: all
Depends: golang-github-dgrijalva-jwt-go-v3-dev,
golang-golang-x-crypto-dev,
${misc:Depends},
${shlibs:Depends},
Description: HTTP request pipeline suitable for use across multiple go-routines
Package autorest implements an HTTP request pipeline suitable for use across
multiple go-routines and provides the shared routines relied on by AutoRest
(see https://github.com/Azure/autorest/) generated Go code.
.
The package breaks sending and responding to HTTP requests into three phases:
Preparing, Sending, and Responding.
.
Each phase relies on decorators to modify and / or manage processing.
Decorators may first modify and then pass the data along, pass the data first
and then modify the result, or wrap themselves around passing the data (such as
a logger might do). Decorators run in the order provided.
.
Preparers and Responders may be shared and re-used (assuming the underlying
decorators support sharing and re-use). Performant use is obtained by creating
one or more Preparers and Responders shared among multiple go-routines, and a
single Sender shared among multiple sending go-routines, all bound together by
means of input / output channels.
.
Decorators hold their passed state within a closure (such as the path
components in the example above). Be careful to share Preparers and Responders
only in a context where such held state applies. For example, it may not make
sense to share a Preparer that applies a query string from a fixed set of
values. Similarly, sharing a Responder that reads the response body into a
passed struct (e.g., ByUnmarshallingJson) is likely incorrect.
.
Lastly, the Swagger specification (https://swagger.io) that drives AutoRest
(https://github.com/Azure/autorest/) precisely defines two date forms: date and
date-time. The github.com/Azure/go-autorest/autorest/date package provides
time.Time derivations to ensure correct parsing and formatting.
.
Errors raised by autorest objects and methods will conform to the
autorest.Error interface.
|