mediary

KO | EN

gitlite — search

#javascript #llm #android #rust #deep-learning #linux #docker #java #awesome-list #pytorch #mcp #ios #openai #open-source

(★ 88)

Add interceptors to GO http.Client

파일 탐색기

최종 버전 다운로드 (.zip)

- dump_test.go
.gitignore
.travis.yml
config.go
go.mod
go.sum
LICENSE
mediary.go
mediary_test.go
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mediary

[![Go Report Card](https://goreportcard.com/badge/github.com/HereMobilityDevelopers/mediary)](https://goreportcard.com/report/github.com/HereMobilityDevelopers/mediary)
[![Coverage Status](https://coveralls.io/repos/github/HereMobilityDevelopers/mediary/badge.svg?branch=master)](https://coveralls.io/github/HereMobilityDevelopers/mediary?branch=master)
[![Build Status](https://travis-ci.com/HereMobilityDevelopers/mediary.svg?branch=master)](https://travis-ci.com/HereMobilityDevelopers/mediary)
[![Go package dev](https://godoc.org/github.com/HereMobilityDevelopers/mediary?status.svg)](https://godoc.org/github.com/HereMobilityDevelopers/mediary)

Add interceptors to http.Client and you will be able to
* Dump request and/or response to a `Log`
* Alter your requests before they are sent or responses before they are returned
* Add Tracing information using `Opentracing`/`Jaeger`
* Send metrics to `statsd`

All this and more while using a "regular" `http.Client`

## Usage
```go
var client *http.Client
client = mediary.Init().AddInterceptors(your interceptor).Build()
client.Get("https://golang.org")
```

## Dump Example
```go
client := mediary.Init().AddInterceptors(dumpInterceptor).Build()
client.Get("https://golang.org")

func dumpInterceptor(req *http.Request, handler mediary.Handler) (*http.Response, error) {
	if bytes, err := httputil.DumpRequestOut(req, true); err == nil {
		fmt.Printf("%s", bytes)

//GET / HTTP/1.1
		//Host: golang.org
		//User-Agent: Go-http-client/1.1
		//Accept-Encoding: gzip
	}
	return handler(req)
}
```

## Interceptor
**Interceptor** is a function

<code>type Interceptor func(*http.Request, Handler) (*http.Response, error)</code>

**Handler** is just an alias to <code>http.Roundtripper</code> function called `RoundTrip`

<code>type Handler func(*http.Request) (*http.Response, error) </code>

## Multiple interceptors

It's possible to chain interceptors

```go
client := mediary.Init().
    AddInterceptors(First Interceptor, Second Interceptor).
    AddInterceptors(Third Interceptor).
    Build()

```
This is how it actually works
- First Intereptor: *Request*
    - Second Interceptor: *Request*
        - Third Interceptor: *Request*
            - **Handler** <-- Actual http call
        - Third Interceptor: *Response*
    - Second Interceptor: *Response*
- First Interceptor: *Response*

## Using custom client/transport

If you already have a pre-configured `http.Client` you can use it as well
```go
yourClient := &http.Client{}
yourClientWithInterceptor := mediary.Init().
    WithPreconfiguredClient(yourClient).
    AddInterceptors(your interceptor).
    Build()
```

Read [this](https://github.com/HereMobilityDevelopers/mediary/wiki/Reasoning) for more information

mediary

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mediary

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README