doc.go

/*
Package httpmock provides tools for mocking HTTP responses.

Simple Example:
	func TestFetchArticles(t *testing.T) {
		httpmock.Activate()
		defer httpmock.DeactivateAndReset()

		httpmock.RegisterStubRequest(
			httpmock.NewStubRequest(
				"GET",
				"https://api.mybiz.com/articles.json",
				httpmock.NewStringResponder(200, `[{"id": 1, "name": "My Great Article"}]`),
			),
		)

		// do stuff that makes a request to articles.json

		// verify that all stubs were called
		if err := httpmock.AllStubsCalled(); err != nil {
				t.Errorf("Not all stubs were called: %s", err)
		}
	}

Advanced Example:
	func TestFetchArticles(t *testing.T) {
		httpmock.Activate(
			WithAllowedHosts("localhost"),
		)
		defer httpmock.DeactivateAndReset()

		// our database of articles
		articles := make([]map[string]interface{}, 0)

		// mock to list out the articles
		httpmock.RegisterStubRequest(
			httpmock.NewStubRequest(
				"GET",
				"https://api.mybiz.com/articles.json",
				func(req *http.Request) (*http.Response, error) {
					resp, err := httpmock.NewJsonResponse(200, articles)
					if err != nil {
						return httpmock.NewStringResponse(500, ""), nil
					}
					return resp
				},
			).WithHeader(
				&http.Header{
					"Api-Key": []string{"1234abcd"},
				},
			),
		)

		// mock to add a new article
		httpmock.RegisterStubRequest(
			httpmock.NewStubRequest(
				"POST",
				"https://api.mybiz.com/articles.json",
				func(req *http.Request) (*http.Response, error) {
					article := make(map[string]interface{})
					if err := json.NewDecoder(req.Body).Decode(&article); err != nil {
						return httpmock.NewStringResponse(400, ""), nil
					}

					articles = append(articles, article)

					resp, err := httpmock.NewJsonResponse(200, article)
					if err != nil {
						return httpmock.NewStringResponse(500, ""), nil
					}
					return resp, nil
				},
			).WithHeader(
				&http.Header{
					"Api-Key": []string{"1234abcd"},
				},
			).WithBody(
				bytes.NewBufferString(`{"title":"article"}`),
			),
		)

		// do stuff that adds and checks articles

		// verify that all stubs were called
		if err := httpmock.AllStubsCalled(); err != nil {
				t.Errorf("Not all stubs were called: %s", err)
		}
	}

*/
package httpmock