go-httpbin

KO | EN

gitlite — search

#javascript #python #react #ai #llm #golang #linux #nodejs #awesome #cli #vue #awesome-list #pytorch #security

(★ 126)

http://httpbin.org endpoints for your Go tests

파일 탐색기

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

- - main.go
.gitignore
.travis.yml
data.go
example_test.go
glide.lock
glide.yaml
handlers.go
handlers_test.go
LICENSE
README.md
types.go
util.go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# go-httpbin

[![Read GoDoc](https://godoc.org/github.com/ahmetb/go-httpbin?status.svg)](https://godoc.org/github.com/ahmetb/go-httpbin)
[![Build Status](https://travis-ci.org/ahmetb/go-httpbin.svg?branch=master)](https://travis-ci.org/ahmetb/go-httpbin)

A Go handler that lets you test your HTTP client, retry logic, streaming behavior, timeouts etc.
with the endpoints of [httpbin.org][ht] locally in a [`net/http/httptest.Server`][hts].

This way, you can write tests without relying on an external dependency like [httpbin.org][ht].

## Endpoints

- `/ip` Returns Origin IP.
- `/user-agent` Returns user-agent.
- `/headers` Returns headers.
- `/get` Returns GET data.
- `/status/:code` Returns given HTTP Status code.
- `/redirect/:n` 302 Redirects _n_ times.
- `/absolute-redirect/:n` 302 Absolute redirects _n_ times.
- `/redirect-to?url=foo` 302 Redirects to the _foo_ URL.
- `/stream/:n` Streams _n_ lines of JSON objects.
- `/delay/:n` Delays responding for _min(n, 10)_ seconds.
- `/bytes/:n` Generates _n_ random bytes of binary data, accepts optional _seed_ integer parameter.
- `/cookies` Returns the cookies.
- `/cookies/set?name=value` Sets one or more simple cookies.
- `/cookies/delete?name` Deletes one or more simple cookies.
- `/drip?numbytes=n&duration=s&delay=s&code=code` Drips data over a duration after
  an optional initial _delay_, then optionally returns with the given status _code_.
- `/cache` Returns 200 unless an If-Modified-Since or If-None-Match header is provided, when it returns a 304.
- `/cache/:n` Sets a Cache-Control header for _n_ seconds.
- `/gzip` Returns gzip-encoded data.
- `/deflate` Returns deflate-encoded data.
- `/brotli` Returns brotli-encoded data.
- `/robots.txt` Returns some robots.txt rules.
- `/deny` Denied by robots.txt file.
- `/basic-auth/:user/:passwd` Challenges HTTP Basic Auth.
- `/hidden-basic-auth/:user/:passwd` Challenges HTTP Basic Auth and returns 404 on failure.
- `/html` Returns some HTML.
- `/xml` Returns some XML.
- `/image/gif` Returns page containing an animated GIF image.
- `/image/png` Returns page containing a PNG image.
- `/image/jpeg` Returns page containing a JPEG image.

## How to use

Standing up a Go server running httpbin endpoints is just 1 line:

```go
package main

import (
    "log"
    "net/http"
    "github.com/ahmetb/go-httpbin"
)

func main() {
	log.Fatal(http.ListenAndServe(":8080", httpbin.GetMux()))
}
```

Let's say you do not want a server running all the time because you just want to
test your HTTP logic after all. Integrating `httpbin` to your tests is very simple:

```go
package test

import (
    "testing"
    "net/http"
    "net/http/httptest"

"github.com/ahmetb/go-httpbin"
)

func TestDownload(t *testing.T) {
    srv := httptest.NewServer(httpbin.GetMux())
    defer srv.Close()

resp, err := http.Get(srv.URL + "/bytes/65536")
    if err != nil {
        t.Fatal(err)
    }
    // read from an actual HTTP server hosted locally
    // test whatever you are going to test...
}
```

go-httpbin works from the command line as well:

```
$ go install github.com/ahmetb/go-httpbin/cmd/httpbin@latest
$ $GOPATH/bin/httpbin -host :8080
```

# Development

You must have the following tools installed on your system:

- [Glide](https://github.com/Masterminds/glide) 0.12.0 or above
- [Go](https://golang.org/) 1.7 or above

To get started, simply run `glide install` to install all the dependencies of this package.
Then, run `go test $(glide nv)` to test it.

# License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

# Authors

- Ahmet Alp Balkan ([@ahmetb][tw])

[ht]: https://httpbin.org/
[hts]: https://godoc.org/net/http/httptest#Server
[tw]: https://twitter.com/ahmetalpbalkan

go-httpbin

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

go-httpbin

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README