From 9aefa6ca880d6ae225cb709d9461794a65e8dd6a Mon Sep 17 00:00:00 2001 From: Walter Antolini Date: Mon, 15 Apr 2019 01:41:18 +0200 Subject: [PATCH] Updated Deps --- Gopkg.lock | 78 +- Gopkg.toml | 10 +- .../github.com/cenkalti/backoff/.travis.yml | 3 +- vendor/github.com/cenkalti/backoff/README.md | 2 +- vendor/github.com/cenkalti/backoff/backoff.go | 2 +- vendor/github.com/cenkalti/backoff/context.go | 11 +- .../cenkalti/backoff/context_test.go | 3 +- .../cenkalti/backoff/example_test.go | 3 +- .../cenkalti/backoff/exponential.go | 11 +- vendor/github.com/cenkalti/backoff/retry.go | 12 +- .../github.com/cenkalti/backoff/retry_test.go | 3 +- vendor/github.com/cenkalti/backoff/ticker.go | 13 +- .../cenkalti/backoff/ticker_test.go | 7 +- vendor/github.com/cenkalti/backoff/tries.go | 4 +- .../github.com/cenkalti/backoff/tries_test.go | 4 +- vendor/github.com/golang/mock/.travis.yml | 6 +- vendor/github.com/golang/mock/README.md | 96 ++- vendor/github.com/golang/mock/gomock/call.go | 302 ++++++-- .../golang/mock/gomock/call_test.go | 6 +- .../github.com/golang/mock/gomock/callset.go | 108 ++- .../golang/mock/gomock/callset_test.go | 76 ++ .../golang/mock/gomock/controller.go | 174 +++-- .../golang/mock/gomock/controller_test.go | 272 ++++++- .../mock_matcher/mock_matcher.go | 25 +- .../github.com/golang/mock/gomock/matchers.go | 27 +- .../golang/mock/gomock/matchers_test.go | 59 +- .../aux_imports_embedded_interface/README.md | 36 + .../bugreport.go | 18 + .../bugreport_mock.go | 48 ++ .../bugreport_test.go | 18 + .../faux/faux.go | 10 + .../tests/custom_package_name/README.md | 22 + .../custom_package_name/client/v1/client.go | 13 + .../custom_package_name/greeter/greeter.go | 31 + .../greeter/greeter_mock_test.go | 48 ++ .../greeter/greeter_test.go | 37 + .../custom_package_name/validator/validate.go | 5 + .../internal/tests/dot_imports/input.go | 14 + .../internal/tests/dot_imports/mock.go | 78 ++ .../internal/tests/empty_interface/input.go | 4 + .../internal/tests/empty_interface/mock.go | 32 + .../generated_identifier_conflict/README.md | 26 + .../bugreport.go | 16 + .../bugreport_mock.go | 62 ++ .../bugreport_test.go | 26 + .../internal/tests/import_source/Readme.md | 3 + .../tests/import_source/definition/source.go | 9 + .../import_source/definition/source_mock.go | 45 ++ .../tests/import_source/source_mock.go | 46 ++ .../internal/tests/internal_pkg/generate.go | 3 + .../internal_pkg/subdir/internal/pkg/input.go | 9 + .../internal/pkg/reflect_output/mock.go | 48 ++ .../subdir/internal/pkg/source_output/mock.go | 85 +++ .../tests/unexported_method/README.md | 0 .../tests/unexported_method/bugreport.go | 0 .../tests/unexported_method/bugreport_mock.go | 15 +- .../tests/unexported_method/bugreport_test.go | 0 .../internal/tests/vendor_dep/README.md | 2 + .../mockgen/internal/tests/vendor_dep/doc.go | 4 + .../mockgen/internal/tests/vendor_dep/mock.go | 48 ++ .../vendor_dep/source_mock_package/mock.go | 48 ++ .../internal/tests/vendor_dep/vendor_dep.go | 7 + .../internal/tests/vendor_pkg/README.md | 1 + .../mockgen/internal/tests/vendor_pkg/doc.go | 3 + .../mockgen/internal/tests/vendor_pkg/mock.go | 111 +++ .../github.com/golang/mock/mockgen/mockgen.go | 270 +++++-- .../golang/mock/mockgen/mockgen_test.go | 269 +++++++ .../golang/mock/mockgen/model/model.go | 27 +- .../github.com/golang/mock/mockgen/parse.go | 167 ++-- .../golang/mock/mockgen/parse_test.go | 108 +++ .../github.com/golang/mock/mockgen/reflect.go | 187 +++-- .../github.com/golang/mock/sample/README.md | 4 +- .../mock/sample/concurrent/concurrent.go | 8 + .../mock/sample/concurrent/concurrent_test.go | 46 ++ .../sample/concurrent/mock/concurrent_mock.go | 47 ++ .../golang/mock/sample/mock_user/mock_user.go | 297 +++++--- .../golang/mock/sample/user_test.go | 47 +- .../mmatczuk/go-http-tunnel/.editorconfig | 14 + .../mmatczuk/go-http-tunnel/.gitignore | 24 + .../mmatczuk/go-http-tunnel/.travis.yml | 15 + .../mmatczuk/go-http-tunnel/Gopkg.lock | 51 ++ .../mmatczuk/go-http-tunnel/Gopkg.toml | 50 ++ .../mmatczuk/go-http-tunnel/LICENSE | 661 ++++++++++++++++ .../mmatczuk/go-http-tunnel/Makefile | 92 +++ .../mmatczuk/go-http-tunnel/README.md | 130 ++++ .../mmatczuk/go-http-tunnel/auth.go | 30 + .../mmatczuk/go-http-tunnel/auth_test.go | 28 + .../mmatczuk/go-http-tunnel/backoff.go | 19 + .../go-http-tunnel/benchmark/README.md | 50 ++ .../go-http-tunnel/benchmark/constload.png | Bin 0 -> 140618 bytes .../go-http-tunnel/benchmark/spike.png | Bin 0 -> 143301 bytes .../mmatczuk/go-http-tunnel/client.go | 326 ++++++++ .../mmatczuk/go-http-tunnel/client_test.go | 86 +++ .../go-http-tunnel/cmd/tunnel/config.go | 142 ++++ .../go-http-tunnel/cmd/tunnel/normalize.go | 56 ++ .../cmd/tunnel/normalize_test.go | 115 +++ .../go-http-tunnel/cmd/tunnel/options.go | 106 +++ .../go-http-tunnel/cmd/tunnel/tunnel.go | 198 +++++ .../go-http-tunnel/cmd/tunnel/version.go | 7 + .../go-http-tunnel/cmd/tunneld/banner.go | 14 + .../go-http-tunnel/cmd/tunneld/options.go | 74 ++ .../go-http-tunnel/cmd/tunneld/tunneld.go | 140 ++++ .../go-http-tunnel/cmd/tunneld/version.go | 7 + .../github.com/mmatczuk/go-http-tunnel/doc.go | 8 + .../mmatczuk/go-http-tunnel/errors.go | 15 + .../mmatczuk/go-http-tunnel/httpproxy.go | 188 +++++ .../mmatczuk/go-http-tunnel/id/id.go | 175 +++++ .../mmatczuk/go-http-tunnel/id/ptls.go | 47 ++ .../go-http-tunnel/integration_test.go | 336 +++++++++ .../mmatczuk/go-http-tunnel/keepalive.go | 30 + .../go-http-tunnel/keepalive_windows.go | 23 + .../mmatczuk/go-http-tunnel/log/context.go | 48 ++ .../go-http-tunnel/log/filterlogger.go | 48 ++ .../go-http-tunnel/log/filterlogger_test.go | 31 + .../mmatczuk/go-http-tunnel/log/log.go | 14 + .../mmatczuk/go-http-tunnel/log/log_test.go | 29 + .../mmatczuk/go-http-tunnel/log/noplogger.go | 12 + .../mmatczuk/go-http-tunnel/log/stdlogger.go | 19 + .../mmatczuk/go-http-tunnel/pool.go | 142 ++++ .../go-http-tunnel/proto/controlmsg.go | 80 ++ .../go-http-tunnel/proto/controlmsg_test.go | 70 ++ .../mmatczuk/go-http-tunnel/proto/tunnel.go | 23 + .../mmatczuk/go-http-tunnel/proxy.go | 42 ++ .../mmatczuk/go-http-tunnel/registry.go | 194 +++++ .../mmatczuk/go-http-tunnel/server.go | 710 ++++++++++++++++++ .../mmatczuk/go-http-tunnel/tcpproxy.go | 148 ++++ .../go-http-tunnel/testdata/selfsigned.crt | 21 + .../go-http-tunnel/testdata/selfsigned.key | 28 + .../mmatczuk/go-http-tunnel/tunnel.go | 14 + .../go-http-tunnel/tunnelmock/backoff.go | 52 ++ .../go-http-tunnel/tunnelmock/logger.go | 45 ++ .../mmatczuk/go-http-tunnel/utils.go | 87 +++ vendor/gopkg.in/yaml.v2/.travis.yml | 3 + vendor/gopkg.in/yaml.v2/NOTICE | 13 + vendor/gopkg.in/yaml.v2/README.md | 4 +- vendor/gopkg.in/yaml.v2/apic.go | 55 +- vendor/gopkg.in/yaml.v2/decode.go | 238 ++++-- vendor/gopkg.in/yaml.v2/decode_test.go | 378 +++++++++- vendor/gopkg.in/yaml.v2/emitterc.go | 11 +- vendor/gopkg.in/yaml.v2/encode.go | 164 +++- vendor/gopkg.in/yaml.v2/encode_test.go | 134 +++- .../gopkg.in/yaml.v2/example_embedded_test.go | 18 +- vendor/gopkg.in/yaml.v2/go.mod | 5 + vendor/gopkg.in/yaml.v2/readerc.go | 20 +- vendor/gopkg.in/yaml.v2/resolve.go | 80 +- vendor/gopkg.in/yaml.v2/scannerc.go | 29 +- vendor/gopkg.in/yaml.v2/sorter.go | 9 + vendor/gopkg.in/yaml.v2/writerc.go | 65 +- vendor/gopkg.in/yaml.v2/yaml.go | 123 ++- vendor/gopkg.in/yaml.v2/yamlh.go | 30 +- 150 files changed, 9432 insertions(+), 886 deletions(-) create mode 100644 vendor/github.com/golang/mock/gomock/callset_test.go rename vendor/github.com/golang/mock/gomock/{ => internal}/mock_matcher/mock_matcher.go (56%) create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/README.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_test.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux/faux.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/README.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1/client.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_mock_test.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_test.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator/validate.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/input.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/input.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/README.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_test.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/import_source/Readme.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source_mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/import_source/source_mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/generate.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/input.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/reflect_output/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/source_output/mock.go rename vendor/github.com/golang/mock/mockgen/{ => internal}/tests/unexported_method/README.md (100%) rename vendor/github.com/golang/mock/mockgen/{ => internal}/tests/unexported_method/bugreport.go (100%) rename vendor/github.com/golang/mock/mockgen/{ => internal}/tests/unexported_method/bugreport_mock.go (63%) rename vendor/github.com/golang/mock/mockgen/{ => internal}/tests/unexported_method/bugreport_test.go (100%) create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/README.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/doc.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/source_mock_package/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/vendor_dep.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/README.md create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/doc.go create mode 100644 vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/mock.go create mode 100644 vendor/github.com/golang/mock/mockgen/mockgen_test.go create mode 100644 vendor/github.com/golang/mock/mockgen/parse_test.go create mode 100644 vendor/github.com/golang/mock/sample/concurrent/concurrent.go create mode 100644 vendor/github.com/golang/mock/sample/concurrent/concurrent_test.go create mode 100644 vendor/github.com/golang/mock/sample/concurrent/mock/concurrent_mock.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/.editorconfig create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/.gitignore create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/.travis.yml create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.lock create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.toml create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/LICENSE create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/Makefile create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/README.md create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/auth.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/auth_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/backoff.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/benchmark/README.md create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/benchmark/constload.png create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/benchmark/spike.png create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/client.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/client_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/config.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/options.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/tunnel.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/version.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/banner.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/options.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/tunneld.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/version.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/doc.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/errors.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/httpproxy.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/id/id.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/id/ptls.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/integration_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/keepalive.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/keepalive_windows.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/context.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/log.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/log_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/noplogger.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/log/stdlogger.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/pool.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg_test.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/proto/tunnel.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/proxy.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/registry.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/server.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/tcpproxy.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.crt create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.key create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/tunnel.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/backoff.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/logger.go create mode 100644 vendor/github.com/mmatczuk/go-http-tunnel/utils.go create mode 100644 vendor/gopkg.in/yaml.v2/NOTICE create mode 100644 vendor/gopkg.in/yaml.v2/go.mod diff --git a/Gopkg.lock b/Gopkg.lock index 9fa3f64..28130da 100644 --- a/Gopkg.lock +++ b/Gopkg.lock @@ -2,50 +2,110 @@ [[projects]] + digest = "1:d7c5f0bac5337c5098b18d000ee24a9a58d10a6b98824cd1821af74d7219ebea" name = "github.com/calmh/luhn" packages = ["."] + pruneopts = "" revision = "5b2abb343e70180dbf456397c5fd93f14471b08e" version = "v2.0.0" [[projects]] + digest = "1:59df7ab87ddca233bb586ff32c6feba12bf787260f6694dc45ceecea9d3e1a7e" name = "github.com/cenkalti/backoff" packages = ["."] - revision = "61153c768f31ee5f130071d08fc82b85208528de" - version = "v1.1.0" + pruneopts = "" + revision = "1e4cf3da559842a91afcb6ea6141451e6c30c618" + version = "v2.1.1" [[projects]] branch = "master" + digest = "1:50cf302cc52eb618cec25d4daf167ed5593145d43b447b906a9f0d24e271d48b" name = "github.com/felixge/tcpkeepalive" packages = ["."] + pruneopts = "" revision = "5bb0b2dea91e0de550022159b9571aafc72c08ba" [[projects]] + digest = "1:530233672f656641b365f8efb38ed9fba80e420baff2ce87633813ab3755ed6d" name = "github.com/golang/mock" packages = ["gomock"] - revision = "13f360950a79f5864a972c786a10a50e44b69541" - version = "v1.0.0" + pruneopts = "" + revision = "51421b967af1f557f93a59e0057aaf15ca02e29c" + version = "v1.2.0" + +[[projects]] + digest = "1:3a86b4526cc15ca4caf041c7f6943b59b3eb3711a9bc832de27b0801b826e019" + name = "github.com/mmatczuk/go-http-tunnel" + packages = [ + ".", + "id", + "log", + "proto", + "tunnelmock", + ] + pruneopts = "" + revision = "75a30abccc8db9d1149845e9985e80cca57758a2" + version = "2.1" [[projects]] branch = "master" + digest = "1:1285570ced192ee4703ca44573a4eaf19b5a0895af56f9db2210b171eefd2a41" name = "golang.org/x/net" - packages = ["context","http2","http2/hpack","idna","lex/httplex"] + packages = [ + "http2", + "http2/hpack", + "idna", + "lex/httplex", + ] + pruneopts = "" revision = "c7086645de248775cbf2373cf5ca4d2fa664b8c1" [[projects]] branch = "master" + digest = "1:39a1a71adca4b837a25dc6b5fcdd9d175e4597c6d3440f107dfeda31230218e4" name = "golang.org/x/text" - packages = ["collate","collate/build","internal/colltab","internal/gen","internal/tag","internal/triegen","internal/ucd","language","secure/bidirule","transform","unicode/bidi","unicode/cldr","unicode/norm","unicode/rangetable"] + packages = [ + "collate", + "collate/build", + "internal/colltab", + "internal/gen", + "internal/tag", + "internal/triegen", + "internal/ucd", + "language", + "secure/bidirule", + "transform", + "unicode/bidi", + "unicode/cldr", + "unicode/norm", + "unicode/rangetable", + ] + pruneopts = "" revision = "88f656faf3f37f690df1a32515b479415e1a6769" [[projects]] - branch = "v2" + digest = "1:cedccf16b71e86db87a24f8d4c70b0a855872eb967cb906a66b95de56aefbd0d" name = "gopkg.in/yaml.v2" packages = ["."] - revision = "287cf08546ab5e7e37d55a84f7ed3fd1db036de5" + pruneopts = "" + revision = "51d6538a90f86fe93ac480b35f37b2be17fef232" + version = "v2.2.2" [solve-meta] analyzer-name = "dep" analyzer-version = 1 - inputs-digest = "654fea302b8b5a71ce4f36f4097d0c0caa8150e46109cfbdd462adcd054a6768" + input-imports = [ + "github.com/calmh/luhn", + "github.com/cenkalti/backoff", + "github.com/felixge/tcpkeepalive", + "github.com/golang/mock/gomock", + "github.com/mmatczuk/go-http-tunnel", + "github.com/mmatczuk/go-http-tunnel/id", + "github.com/mmatczuk/go-http-tunnel/log", + "github.com/mmatczuk/go-http-tunnel/proto", + "github.com/mmatczuk/go-http-tunnel/tunnelmock", + "golang.org/x/net/http2", + "gopkg.in/yaml.v2", + ] solver-name = "gps-cdcl" solver-version = 1 diff --git a/Gopkg.toml b/Gopkg.toml index 85ee676..ed87414 100644 --- a/Gopkg.toml +++ b/Gopkg.toml @@ -27,23 +27,19 @@ [[constraint]] name = "github.com/cenkalti/backoff" - version = "1.1.0" + version = "2.1.0" [[constraint]] name = "github.com/golang/mock" - version = "1.0.0" - -[[constraint]] - name = "github.com/google/gops" - version = "0.3.2" + version = "1.2.0" [[constraint]] branch = "master" name = "golang.org/x/net" [[constraint]] - branch = "v2" name = "gopkg.in/yaml.v2" + version = "2.2.2" [[constraint]] branch = "master" diff --git a/vendor/github.com/cenkalti/backoff/.travis.yml b/vendor/github.com/cenkalti/backoff/.travis.yml index 1040404..47a6a46 100644 --- a/vendor/github.com/cenkalti/backoff/.travis.yml +++ b/vendor/github.com/cenkalti/backoff/.travis.yml @@ -1,6 +1,7 @@ language: go go: - - 1.3.3 + - 1.7 + - 1.x - tip before_install: - go get github.com/mattn/goveralls diff --git a/vendor/github.com/cenkalti/backoff/README.md b/vendor/github.com/cenkalti/backoff/README.md index 13b347f..55ebc98 100644 --- a/vendor/github.com/cenkalti/backoff/README.md +++ b/vendor/github.com/cenkalti/backoff/README.md @@ -24,7 +24,7 @@ See https://godoc.org/github.com/cenkalti/backoff#pkg-examples [coveralls]: https://coveralls.io/github/cenkalti/backoff?branch=master [coveralls image]: https://coveralls.io/repos/github/cenkalti/backoff/badge.svg?branch=master -[google-http-java-client]: https://github.com/google/google-http-java-client +[google-http-java-client]: https://github.com/google/google-http-java-client/blob/da1aa993e90285ec18579f1553339b00e19b3ab5/google-http-client/src/main/java/com/google/api/client/util/ExponentialBackOff.java [exponential backoff wiki]: http://en.wikipedia.org/wiki/Exponential_backoff [advanced example]: https://godoc.org/github.com/cenkalti/backoff#example_ diff --git a/vendor/github.com/cenkalti/backoff/backoff.go b/vendor/github.com/cenkalti/backoff/backoff.go index 2102c5f..3676ee4 100644 --- a/vendor/github.com/cenkalti/backoff/backoff.go +++ b/vendor/github.com/cenkalti/backoff/backoff.go @@ -15,7 +15,7 @@ import "time" // BackOff is a backoff policy for retrying an operation. type BackOff interface { // NextBackOff returns the duration to wait before retrying the operation, - // or backoff.Stop to indicate that no more retries should be made. + // or backoff. Stop to indicate that no more retries should be made. // // Example usage: // diff --git a/vendor/github.com/cenkalti/backoff/context.go b/vendor/github.com/cenkalti/backoff/context.go index 5d15709..7706faa 100644 --- a/vendor/github.com/cenkalti/backoff/context.go +++ b/vendor/github.com/cenkalti/backoff/context.go @@ -1,9 +1,8 @@ package backoff import ( + "context" "time" - - "golang.org/x/net/context" ) // BackOffContext is a backoff policy that stops retrying after the context @@ -52,9 +51,13 @@ func (b *backOffContext) Context() context.Context { func (b *backOffContext) NextBackOff() time.Duration { select { - case <-b.Context().Done(): + case <-b.ctx.Done(): return Stop default: - return b.BackOff.NextBackOff() } + next := b.BackOff.NextBackOff() + if deadline, ok := b.ctx.Deadline(); ok && deadline.Sub(time.Now()) < next { + return Stop + } + return next } diff --git a/vendor/github.com/cenkalti/backoff/context_test.go b/vendor/github.com/cenkalti/backoff/context_test.go index 993fa61..806432c 100644 --- a/vendor/github.com/cenkalti/backoff/context_test.go +++ b/vendor/github.com/cenkalti/backoff/context_test.go @@ -1,10 +1,9 @@ package backoff import ( + "context" "testing" "time" - - "golang.org/x/net/context" ) func TestContext(t *testing.T) { diff --git a/vendor/github.com/cenkalti/backoff/example_test.go b/vendor/github.com/cenkalti/backoff/example_test.go index d97a8db..f9f686b 100644 --- a/vendor/github.com/cenkalti/backoff/example_test.go +++ b/vendor/github.com/cenkalti/backoff/example_test.go @@ -1,9 +1,8 @@ package backoff import ( + "context" "log" - - "golang.org/x/net/context" ) func ExampleRetry() { diff --git a/vendor/github.com/cenkalti/backoff/exponential.go b/vendor/github.com/cenkalti/backoff/exponential.go index 9a6addf..a031a65 100644 --- a/vendor/github.com/cenkalti/backoff/exponential.go +++ b/vendor/github.com/cenkalti/backoff/exponential.go @@ -63,7 +63,6 @@ type ExponentialBackOff struct { currentInterval time.Duration startTime time.Time - random *rand.Rand } // Clock is an interface that returns current time for BackOff. @@ -89,7 +88,6 @@ func NewExponentialBackOff() *ExponentialBackOff { MaxInterval: DefaultMaxInterval, MaxElapsedTime: DefaultMaxElapsedTime, Clock: SystemClock, - random: rand.New(rand.NewSource(time.Now().UnixNano())), } b.Reset() return b @@ -118,16 +116,15 @@ func (b *ExponentialBackOff) NextBackOff() time.Duration { return Stop } defer b.incrementCurrentInterval() - if b.random == nil { - b.random = rand.New(rand.NewSource(time.Now().UnixNano())) - } - return getRandomValueFromInterval(b.RandomizationFactor, b.random.Float64(), b.currentInterval) + return getRandomValueFromInterval(b.RandomizationFactor, rand.Float64(), b.currentInterval) } // GetElapsedTime returns the elapsed time since an ExponentialBackOff instance // is created and is reset when Reset() is called. // -// The elapsed time is computed using time.Now().UnixNano(). +// The elapsed time is computed using time.Now().UnixNano(). It is +// safe to call even while the backoff policy is used by a running +// ticker. func (b *ExponentialBackOff) GetElapsedTime() time.Duration { return b.Clock.Now().Sub(b.startTime) } diff --git a/vendor/github.com/cenkalti/backoff/retry.go b/vendor/github.com/cenkalti/backoff/retry.go index 5dbd825..e936a50 100644 --- a/vendor/github.com/cenkalti/backoff/retry.go +++ b/vendor/github.com/cenkalti/backoff/retry.go @@ -15,7 +15,6 @@ type Notify func(error, time.Duration) // Retry the operation o until it does not return error or BackOff stops. // o is guaranteed to be run at least once. -// It is the caller's responsibility to reset b after Retry returns. // // If o returns a *PermanentError, the operation is not retried, and the // wrapped error is returned. @@ -29,6 +28,7 @@ func Retry(o Operation, b BackOff) error { return RetryNotify(o, b, nil) } func RetryNotify(operation Operation, b BackOff, notify Notify) error { var err error var next time.Duration + var t *time.Timer cb := ensureContext(b) @@ -42,7 +42,7 @@ func RetryNotify(operation Operation, b BackOff, notify Notify) error { return permanent.Err } - if next = b.NextBackOff(); next == Stop { + if next = cb.NextBackOff(); next == Stop { return err } @@ -50,11 +50,15 @@ func RetryNotify(operation Operation, b BackOff, notify Notify) error { notify(err, next) } - t := time.NewTimer(next) + if t == nil { + t = time.NewTimer(next) + defer t.Stop() + } else { + t.Reset(next) + } select { case <-cb.Context().Done(): - t.Stop() return err case <-t.C: } diff --git a/vendor/github.com/cenkalti/backoff/retry_test.go b/vendor/github.com/cenkalti/backoff/retry_test.go index 5af2888..a9b8be1 100644 --- a/vendor/github.com/cenkalti/backoff/retry_test.go +++ b/vendor/github.com/cenkalti/backoff/retry_test.go @@ -1,13 +1,12 @@ package backoff import ( + "context" "errors" "fmt" "log" "testing" "time" - - "golang.org/x/net/context" ) func TestRetry(t *testing.T) { diff --git a/vendor/github.com/cenkalti/backoff/ticker.go b/vendor/github.com/cenkalti/backoff/ticker.go index 49a9971..e41084b 100644 --- a/vendor/github.com/cenkalti/backoff/ticker.go +++ b/vendor/github.com/cenkalti/backoff/ticker.go @@ -1,7 +1,6 @@ package backoff import ( - "runtime" "sync" "time" ) @@ -18,9 +17,12 @@ type Ticker struct { stopOnce sync.Once } -// NewTicker returns a new Ticker containing a channel that will send the time at times -// specified by the BackOff argument. Ticker is guaranteed to tick at least once. -// The channel is closed when Stop method is called or BackOff stops. +// NewTicker returns a new Ticker containing a channel that will send +// the time at times specified by the BackOff argument. Ticker is +// guaranteed to tick at least once. The channel is closed when Stop +// method is called or BackOff stops. It is not safe to manipulate the +// provided backoff policy (notably calling NextBackOff or Reset) +// while the ticker is running. func NewTicker(b BackOff) *Ticker { c := make(chan time.Time) t := &Ticker{ @@ -29,8 +31,8 @@ func NewTicker(b BackOff) *Ticker { b: ensureContext(b), stop: make(chan struct{}), } + t.b.Reset() go t.run() - runtime.SetFinalizer(t, (*Ticker).Stop) return t } @@ -42,7 +44,6 @@ func (t *Ticker) Stop() { func (t *Ticker) run() { c := t.c defer close(c) - t.b.Reset() // Ticker is guaranteed to tick at least once. afterC := t.send(time.Now()) diff --git a/vendor/github.com/cenkalti/backoff/ticker_test.go b/vendor/github.com/cenkalti/backoff/ticker_test.go index 085828c..4dc78bd 100644 --- a/vendor/github.com/cenkalti/backoff/ticker_test.go +++ b/vendor/github.com/cenkalti/backoff/ticker_test.go @@ -1,13 +1,12 @@ package backoff import ( + "context" "errors" "fmt" "log" "testing" "time" - - "golang.org/x/net/context" ) func TestTicker(t *testing.T) { @@ -30,6 +29,10 @@ func TestTicker(t *testing.T) { b := NewExponentialBackOff() ticker := NewTicker(b) + elapsed := b.GetElapsedTime() + if elapsed > time.Second { + t.Errorf("elapsed time too large: %v", elapsed) + } var err error for _ = range ticker.C { diff --git a/vendor/github.com/cenkalti/backoff/tries.go b/vendor/github.com/cenkalti/backoff/tries.go index d2da730..cfeefd9 100644 --- a/vendor/github.com/cenkalti/backoff/tries.go +++ b/vendor/github.com/cenkalti/backoff/tries.go @@ -3,13 +3,13 @@ package backoff import "time" /* -WithMaxTries creates a wrapper around another BackOff, which will +WithMaxRetries creates a wrapper around another BackOff, which will return Stop if NextBackOff() has been called too many times since the last time Reset() was called Note: Implementation is not thread-safe. */ -func WithMaxTries(b BackOff, max uint64) BackOff { +func WithMaxRetries(b BackOff, max uint64) BackOff { return &backOffTries{delegate: b, maxTries: max} } diff --git a/vendor/github.com/cenkalti/backoff/tries_test.go b/vendor/github.com/cenkalti/backoff/tries_test.go index bd10211..f83c130 100644 --- a/vendor/github.com/cenkalti/backoff/tries_test.go +++ b/vendor/github.com/cenkalti/backoff/tries_test.go @@ -9,7 +9,7 @@ import ( func TestMaxTriesHappy(t *testing.T) { r := rand.New(rand.NewSource(time.Now().UnixNano())) max := 17 + r.Intn(13) - bo := WithMaxTries(&ZeroBackOff{}, uint64(max)) + bo := WithMaxRetries(&ZeroBackOff{}, uint64(max)) // Load up the tries count, but reset should clear the record for ix := 0; ix < max/2; ix++ { @@ -45,7 +45,7 @@ func TestMaxTriesHappy(t *testing.T) { func TestMaxTriesZero(t *testing.T) { // It might not make sense, but its okay to send a zero - bo := WithMaxTries(&ZeroBackOff{}, uint64(0)) + bo := WithMaxRetries(&ZeroBackOff{}, uint64(0)) for ix := 0; ix < 11; ix++ { d := bo.NextBackOff() if d == Stop { diff --git a/vendor/github.com/golang/mock/.travis.yml b/vendor/github.com/golang/mock/.travis.yml index 543ce12..99b32ec 100644 --- a/vendor/github.com/golang/mock/.travis.yml +++ b/vendor/github.com/golang/mock/.travis.yml @@ -1,9 +1,9 @@ language: go go: - # we intend to support only the latest version and perhaps the previous one - - 1.7 - - 1.8 + - 1.9.x + - 1.10.x + - 1.11.x script: - go build ./... diff --git a/vendor/github.com/golang/mock/README.md b/vendor/github.com/golang/mock/README.md index daf4f97..08b0c57 100644 --- a/vendor/github.com/golang/mock/README.md +++ b/vendor/github.com/golang/mock/README.md @@ -1,4 +1,4 @@ -gomock [![Build Status](https://travis-ci.org/golang/mock.svg?branch=master)](https://travis-ci.org/golang/mock) +gomock [![Build Status][travis-ci-badge]][travis-ci] [![GoDoc][godoc-badge]][godoc] ====== GoMock is a mocking framework for the [Go programming language][golang]. It @@ -13,7 +13,7 @@ Once you have [installed Go][golang-install], run these commands to install the `gomock` package and the `mockgen` tool: go get github.com/golang/mock/gomock - go get github.com/golang/mock/mockgen + go install github.com/golang/mock/mockgen Documentation @@ -74,13 +74,95 @@ It supports the following flags: * `-build_flags`: (reflect mode only) Flags passed verbatim to `go build`. +* `-mock_names`: A list of custom names for generated mocks. This is specified + as a comma-separated list of elements of the form + `Repository=MockSensorRepository,Endpoint=MockSensorEndpoint`, where + `Repository` is the interface name and `MockSensorRepository` is the desired + mock name (mock factory method and mock recorder will be named after the mock). + If one of the interfaces has no custom name specified, then default naming + convention will be used. + For an example of the use of `mockgen`, see the `sample/` directory. In simple cases, you will need only the `-source` flag. -TODO: Brief overview of how to create mock objects and set up expectations, and -an example. +Building Mocks +-------------- + +```go +type Foo interface { + Bar(x int) int +} + +Func SUT(f Foo) { + // ... +} + +``` + +```go +func TestFoo(t *testing.T) { + ctrl := gomock.NewController(t) + + // Assert that Bar() is invoked. + defer ctrl.Finish() + + m := NewMockFoo(ctrl) + + // Asserts that the first and only call to Bar() is passed 99. + // Anything else will fail. + m. + EXPECT(). + Bar(gomock.Eq(99)). + Return(101) + + SUT(m) +} +``` + +Building Stubs +-------------- + +```go +type Foo interface { + Bar(x int) int +} + +Func SUT(f Foo) { + // ... +} + +``` + +```go +func TestFoo(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + m := NewMockFoo(ctrl) + + // Does not make any assertions. Returns 101 when Bar is invoked with 99. + m. + EXPECT(). + Bar(gomock.Eq(99)). + Return(101). + AnyTimes() + + // Does not make any assertions. Returns 103 when Bar is invoked with 101. + m. + EXPECT(). + Bar(gomock.Eq(101)). + Return(103). + AnyTimes() + + SUT(m) +} +``` -[golang]: http://golang.org/ -[golang-install]: http://golang.org/doc/install.html#releases -[gomock-ref]: http://godoc.org/github.com/golang/mock/gomock +[golang]: http://golang.org/ +[golang-install]: http://golang.org/doc/install.html#releases +[gomock-ref]: http://godoc.org/github.com/golang/mock/gomock +[travis-ci-badge]: https://travis-ci.org/golang/mock.svg?branch=master +[travis-ci]: https://travis-ci.org/golang/mock +[godoc-badge]: https://godoc.org/github.com/golang/mock/gomock?status.svg +[godoc]: https://godoc.org/github.com/golang/mock/gomock diff --git a/vendor/github.com/golang/mock/gomock/call.go b/vendor/github.com/golang/mock/gomock/call.go index cc8dfff..3d54d9f 100644 --- a/vendor/github.com/golang/mock/gomock/call.go +++ b/vendor/github.com/golang/mock/gomock/call.go @@ -17,18 +17,19 @@ package gomock import ( "fmt" "reflect" + "strconv" "strings" ) // Call represents an expected call to a mock. type Call struct { - t TestReporter // for triggering test failures on invalid call setup + t TestHelper // for triggering test failures on invalid call setup - receiver interface{} // the receiver of the method call - method string // the name of the method - methodType reflect.Type // the type of the method - args []Matcher // the args - rets []interface{} // the return values (if any) + receiver interface{} // the receiver of the method call + method string // the name of the method + methodType reflect.Type // the type of the method + args []Matcher // the args + origin string // file and line number of call setup preReqs []*Call // prerequisite calls @@ -37,9 +38,42 @@ type Call struct { numCalls int // actual number made - // Actions - doFunc reflect.Value - setArgs map[int]reflect.Value + // actions are called when this Call is called. Each action gets the args and + // can set the return values by returning a non-nil slice. Actions run in the + // order they are created. + actions []func([]interface{}) []interface{} +} + +// newCall creates a *Call. It requires the method type in order to support +// unexported methods. +func newCall(t TestHelper, receiver interface{}, method string, methodType reflect.Type, args ...interface{}) *Call { + t.Helper() + + // TODO: check arity, types. + margs := make([]Matcher, len(args)) + for i, arg := range args { + if m, ok := arg.(Matcher); ok { + margs[i] = m + } else if arg == nil { + // Handle nil specially so that passing a nil interface value + // will match the typed nils of concrete args. + margs[i] = Nil() + } else { + margs[i] = Eq(arg) + } + } + + origin := callerInfo(3) + actions := []func([]interface{}) []interface{}{func([]interface{}) []interface{} { + // Synthesize the zero value for each of the return args' types. + rets := make([]interface{}, methodType.NumOut()) + for i := 0; i < methodType.NumOut(); i++ { + rets[i] = reflect.Zero(methodType.Out(i)).Interface() + } + return rets + }} + return &Call{t: t, receiver: receiver, method: method, methodType: methodType, + args: margs, origin: origin, minCalls: 1, maxCalls: 1, actions: actions} } // AnyTimes allows the expectation to be called 0 or more times @@ -68,19 +102,67 @@ func (c *Call) MaxTimes(n int) *Call { return c } -// Do declares the action to run when the call is matched. +// DoAndReturn declares the action to run when the call is matched. +// The return values from this function are returned by the mocked function. +// It takes an interface{} argument to support n-arity functions. +func (c *Call) DoAndReturn(f interface{}) *Call { + // TODO: Check arity and types here, rather than dying badly elsewhere. + v := reflect.ValueOf(f) + + c.addAction(func(args []interface{}) []interface{} { + vargs := make([]reflect.Value, len(args)) + ft := v.Type() + for i := 0; i < len(args); i++ { + if args[i] != nil { + vargs[i] = reflect.ValueOf(args[i]) + } else { + // Use the zero value for the arg. + vargs[i] = reflect.Zero(ft.In(i)) + } + } + vrets := v.Call(vargs) + rets := make([]interface{}, len(vrets)) + for i, ret := range vrets { + rets[i] = ret.Interface() + } + return rets + }) + return c +} + +// Do declares the action to run when the call is matched. The function's +// return values are ignored to retain backward compatibility. To use the +// return values call DoAndReturn. // It takes an interface{} argument to support n-arity functions. func (c *Call) Do(f interface{}) *Call { // TODO: Check arity and types here, rather than dying badly elsewhere. - c.doFunc = reflect.ValueOf(f) + v := reflect.ValueOf(f) + + c.addAction(func(args []interface{}) []interface{} { + vargs := make([]reflect.Value, len(args)) + ft := v.Type() + for i := 0; i < len(args); i++ { + if args[i] != nil { + vargs[i] = reflect.ValueOf(args[i]) + } else { + // Use the zero value for the arg. + vargs[i] = reflect.Zero(ft.In(i)) + } + } + v.Call(vargs) + return nil + }) return c } +// Return declares the values to be returned by the mocked function call. func (c *Call) Return(rets ...interface{}) *Call { + c.t.Helper() + mt := c.methodType if len(rets) != mt.NumOut() { - c.t.Fatalf("wrong number of arguments to Return for %T.%v: got %d, want %d", - c.receiver, c.method, len(rets), mt.NumOut()) + c.t.Fatalf("wrong number of arguments to Return for %T.%v: got %d, want %d [%s]", + c.receiver, c.method, len(rets), mt.NumOut(), c.origin) } for i, ret := range rets { if got, want := reflect.TypeOf(ret), mt.Out(i); got == want { @@ -91,8 +173,8 @@ func (c *Call) Return(rets ...interface{}) *Call { case reflect.Chan, reflect.Func, reflect.Interface, reflect.Map, reflect.Ptr, reflect.Slice: // ok default: - c.t.Fatalf("argument %d to Return for %T.%v is nil, but %v is not nillable", - i, c.receiver, c.method, want) + c.t.Fatalf("argument %d to Return for %T.%v is nil, but %v is not nillable [%s]", + i, c.receiver, c.method, want, c.origin) } } else if got.AssignableTo(want) { // Assignable type relation. Make the assignment now so that the generated code @@ -101,31 +183,36 @@ func (c *Call) Return(rets ...interface{}) *Call { v.Set(reflect.ValueOf(ret)) rets[i] = v.Interface() } else { - c.t.Fatalf("wrong type of argument %d to Return for %T.%v: %v is not assignable to %v", - i, c.receiver, c.method, got, want) + c.t.Fatalf("wrong type of argument %d to Return for %T.%v: %v is not assignable to %v [%s]", + i, c.receiver, c.method, got, want, c.origin) } } - c.rets = rets + c.addAction(func([]interface{}) []interface{} { + return rets + }) + return c } +// Times declares the exact number of times a function call is expected to be executed. func (c *Call) Times(n int) *Call { c.minCalls, c.maxCalls = n, n return c } // SetArg declares an action that will set the nth argument's value, -// indirected through a pointer. +// indirected through a pointer. Or, in the case of a slice, SetArg +// will copy value's elements into the nth argument. func (c *Call) SetArg(n int, value interface{}) *Call { - if c.setArgs == nil { - c.setArgs = make(map[int]reflect.Value) - } + c.t.Helper() + mt := c.methodType // TODO: This will break on variadic methods. // We will need to check those at invocation time. if n < 0 || n >= mt.NumIn() { - c.t.Fatalf("SetArg(%d, ...) called for a method with %d args", n, mt.NumIn()) + c.t.Fatalf("SetArg(%d, ...) called for a method with %d args [%s]", + n, mt.NumIn(), c.origin) } // Permit setting argument through an interface. // In the interface case, we don't (nay, can't) check the type here. @@ -134,14 +221,28 @@ func (c *Call) SetArg(n int, value interface{}) *Call { case reflect.Ptr: dt := at.Elem() if vt := reflect.TypeOf(value); !vt.AssignableTo(dt) { - c.t.Fatalf("SetArg(%d, ...) argument is a %v, not assignable to %v", n, vt, dt) + c.t.Fatalf("SetArg(%d, ...) argument is a %v, not assignable to %v [%s]", + n, vt, dt, c.origin) } case reflect.Interface: // nothing to do + case reflect.Slice: + // nothing to do default: - c.t.Fatalf("SetArg(%d, ...) referring to argument of non-pointer non-interface type %v", n, at) + c.t.Fatalf("SetArg(%d, ...) referring to argument of non-pointer non-interface non-slice type %v [%s]", + n, at, c.origin) } - c.setArgs[n] = reflect.ValueOf(value) + + c.addAction(func(args []interface{}) []interface{} { + v := reflect.ValueOf(value) + switch reflect.TypeOf(args[n]).Kind() { + case reflect.Slice: + setSlice(args[n], v) + default: + reflect.ValueOf(args[n]).Elem().Set(v) + } + return nil + }) return c } @@ -157,8 +258,10 @@ func (c *Call) isPreReq(other *Call) bool { // After declares that the call may only match after preReq has been exhausted. func (c *Call) After(preReq *Call) *Call { + c.t.Helper() + if c == preReq { - c.t.Fatalf("A call isn't allowed to be it's own prerequisite") + c.t.Fatalf("A call isn't allowed to be its own prerequisite") } if preReq.isPreReq(c) { c.t.Fatalf("Loop in call order: %v is a prerequisite to %v (possibly indirectly).", c, preReq) @@ -168,7 +271,7 @@ func (c *Call) After(preReq *Call) *Call { return c } -// Returns true iff the minimum number of calls have been made. +// Returns true if the minimum number of calls have been made. func (c *Call) satisfied() bool { return c.numCalls >= c.minCalls } @@ -184,31 +287,108 @@ func (c *Call) String() string { args[i] = arg.String() } arguments := strings.Join(args, ", ") - return fmt.Sprintf("%T.%v(%s)", c.receiver, c.method, arguments) + return fmt.Sprintf("%T.%v(%s) %s", c.receiver, c.method, arguments, c.origin) } // Tests if the given call matches the expected call. -func (c *Call) matches(args []interface{}) bool { - if len(args) != len(c.args) { - return false - } - for i, m := range c.args { - if !m.Matches(args[i]) { - return false +// If yes, returns nil. If no, returns error with message explaining why it does not match. +func (c *Call) matches(args []interface{}) error { + if !c.methodType.IsVariadic() { + if len(args) != len(c.args) { + return fmt.Errorf("Expected call at %s has the wrong number of arguments. Got: %d, want: %d", + c.origin, len(args), len(c.args)) + } + + for i, m := range c.args { + if !m.Matches(args[i]) { + return fmt.Errorf("Expected call at %s doesn't match the argument at index %s.\nGot: %v\nWant: %v", + c.origin, strconv.Itoa(i), args[i], m) + } + } + } else { + if len(c.args) < c.methodType.NumIn()-1 { + return fmt.Errorf("Expected call at %s has the wrong number of matchers. Got: %d, want: %d", + c.origin, len(c.args), c.methodType.NumIn()-1) + } + if len(c.args) != c.methodType.NumIn() && len(args) != len(c.args) { + return fmt.Errorf("Expected call at %s has the wrong number of arguments. Got: %d, want: %d", + c.origin, len(args), len(c.args)) + } + if len(args) < len(c.args)-1 { + return fmt.Errorf("Expected call at %s has the wrong number of arguments. Got: %d, want: greater than or equal to %d", + c.origin, len(args), len(c.args)-1) + } + + for i, m := range c.args { + if i < c.methodType.NumIn()-1 { + // Non-variadic args + if !m.Matches(args[i]) { + return fmt.Errorf("Expected call at %s doesn't match the argument at index %s.\nGot: %v\nWant: %v", + c.origin, strconv.Itoa(i), args[i], m) + } + continue + } + // The last arg has a possibility of a variadic argument, so let it branch + + // sample: Foo(a int, b int, c ...int) + if i < len(c.args) && i < len(args) { + if m.Matches(args[i]) { + // Got Foo(a, b, c) want Foo(matcherA, matcherB, gomock.Any()) + // Got Foo(a, b, c) want Foo(matcherA, matcherB, someSliceMatcher) + // Got Foo(a, b, c) want Foo(matcherA, matcherB, matcherC) + // Got Foo(a, b) want Foo(matcherA, matcherB) + // Got Foo(a, b, c, d) want Foo(matcherA, matcherB, matcherC, matcherD) + continue + } + } + + // The number of actual args don't match the number of matchers, + // or the last matcher is a slice and the last arg is not. + // If this function still matches it is because the last matcher + // matches all the remaining arguments or the lack of any. + // Convert the remaining arguments, if any, into a slice of the + // expected type. + vargsType := c.methodType.In(c.methodType.NumIn() - 1) + vargs := reflect.MakeSlice(vargsType, 0, len(args)-i) + for _, arg := range args[i:] { + vargs = reflect.Append(vargs, reflect.ValueOf(arg)) + } + if m.Matches(vargs.Interface()) { + // Got Foo(a, b, c, d, e) want Foo(matcherA, matcherB, gomock.Any()) + // Got Foo(a, b, c, d, e) want Foo(matcherA, matcherB, someSliceMatcher) + // Got Foo(a, b) want Foo(matcherA, matcherB, gomock.Any()) + // Got Foo(a, b) want Foo(matcherA, matcherB, someEmptySliceMatcher) + break + } + // Wrong number of matchers or not match. Fail. + // Got Foo(a, b) want Foo(matcherA, matcherB, matcherC, matcherD) + // Got Foo(a, b, c) want Foo(matcherA, matcherB, matcherC, matcherD) + // Got Foo(a, b, c, d) want Foo(matcherA, matcherB, matcherC, matcherD, matcherE) + // Got Foo(a, b, c, d, e) want Foo(matcherA, matcherB, matcherC, matcherD) + // Got Foo(a, b, c) want Foo(matcherA, matcherB) + return fmt.Errorf("Expected call at %s doesn't match the argument at index %s.\nGot: %v\nWant: %v", + c.origin, strconv.Itoa(i), args[i:], c.args[i]) + } } // Check that all prerequisite calls have been satisfied. for _, preReqCall := range c.preReqs { if !preReqCall.satisfied() { - return false + return fmt.Errorf("Expected call at %s doesn't have a prerequisite call satisfied:\n%v\nshould be called before:\n%v", + c.origin, preReqCall, c) } } - return true + // Check that the call is not exhausted. + if c.exhausted() { + return fmt.Errorf("Expected call at %s has already been called the max number of times.", c.origin) + } + + return nil } -// dropPrereqs tells the expected Call to not re-check prerequite calls any +// dropPrereqs tells the expected Call to not re-check prerequisite calls any // longer, and to return its current set. func (c *Call) dropPrereqs() (preReqs []*Call) { preReqs = c.preReqs @@ -216,38 +396,9 @@ func (c *Call) dropPrereqs() (preReqs []*Call) { return } -func (c *Call) call(args []interface{}) (rets []interface{}, action func()) { +func (c *Call) call(args []interface{}) []func([]interface{}) []interface{} { c.numCalls++ - - // Actions - if c.doFunc.IsValid() { - doArgs := make([]reflect.Value, len(args)) - ft := c.doFunc.Type() - for i := 0; i < len(args); i++ { - if args[i] != nil { - doArgs[i] = reflect.ValueOf(args[i]) - } else { - // Use the zero value for the arg. - doArgs[i] = reflect.Zero(ft.In(i)) - } - } - action = func() { c.doFunc.Call(doArgs) } - } - for n, v := range c.setArgs { - reflect.ValueOf(args[n]).Elem().Set(v) - } - - rets = c.rets - if rets == nil { - // Synthesize the zero value for each of the return args' types. - mt := c.methodType - rets = make([]interface{}, mt.NumOut()) - for i := 0; i < mt.NumOut(); i++ { - rets[i] = reflect.Zero(mt.Out(i)).Interface() - } - } - - return + return c.actions } // InOrder declares that the given calls should occur in order. @@ -256,3 +407,14 @@ func InOrder(calls ...*Call) { calls[i].After(calls[i-1]) } } + +func setSlice(arg interface{}, v reflect.Value) { + va := reflect.ValueOf(arg) + for i := 0; i < v.Len(); i++ { + va.Index(i).Set(v.Index(i)) + } +} + +func (c *Call) addAction(action func([]interface{}) []interface{}) { + c.actions = append(c.actions, action) +} diff --git a/vendor/github.com/golang/mock/gomock/call_test.go b/vendor/github.com/golang/mock/gomock/call_test.go index 3ae7263..3a8315b 100644 --- a/vendor/github.com/golang/mock/gomock/call_test.go +++ b/vendor/github.com/golang/mock/gomock/call_test.go @@ -1,6 +1,8 @@ package gomock -import "testing" +import ( + "testing" +) type mockTestReporter struct { errorCalls int @@ -15,6 +17,8 @@ func (o *mockTestReporter) Fatalf(format string, args ...interface{}) { o.fatalCalls++ } +func (o *mockTestReporter) Helper() {} + func TestCall_After(t *testing.T) { t.Run("SelfPrereqCallsFatalf", func(t *testing.T) { tr1 := &mockTestReporter{} diff --git a/vendor/github.com/golang/mock/gomock/callset.go b/vendor/github.com/golang/mock/gomock/callset.go index 1b7de4c..c44a8a5 100644 --- a/vendor/github.com/golang/mock/gomock/callset.go +++ b/vendor/github.com/golang/mock/gomock/callset.go @@ -14,63 +14,95 @@ package gomock +import ( + "bytes" + "fmt" +) + // callSet represents a set of expected calls, indexed by receiver and method // name. -type callSet map[interface{}]map[string][]*Call +type callSet struct { + // Calls that are still expected. + expected map[callSetKey][]*Call + // Calls that have been exhausted. + exhausted map[callSetKey][]*Call +} + +// callSetKey is the key in the maps in callSet +type callSetKey struct { + receiver interface{} + fname string +} + +func newCallSet() *callSet { + return &callSet{make(map[callSetKey][]*Call), make(map[callSetKey][]*Call)} +} // Add adds a new expected call. func (cs callSet) Add(call *Call) { - methodMap, ok := cs[call.receiver] - if !ok { - methodMap = make(map[string][]*Call) - cs[call.receiver] = methodMap + key := callSetKey{call.receiver, call.method} + m := cs.expected + if call.exhausted() { + m = cs.exhausted } - methodMap[call.method] = append(methodMap[call.method], call) + m[key] = append(m[key], call) } // Remove removes an expected call. func (cs callSet) Remove(call *Call) { - methodMap, ok := cs[call.receiver] - if !ok { - return - } - sl := methodMap[call.method] - for i, c := range sl { + key := callSetKey{call.receiver, call.method} + calls := cs.expected[key] + for i, c := range calls { if c == call { - // quick removal; we don't need to maintain call order - if len(sl) > 1 { - sl[i] = sl[len(sl)-1] - } - methodMap[call.method] = sl[:len(sl)-1] + // maintain order for remaining calls + cs.expected[key] = append(calls[:i], calls[i+1:]...) + cs.exhausted[key] = append(cs.exhausted[key], call) break } } } -// FindMatch searches for a matching call. Returns nil if no call matched. -func (cs callSet) FindMatch(receiver interface{}, method string, args []interface{}) *Call { - methodMap, ok := cs[receiver] - if !ok { - return nil - } - calls, ok := methodMap[method] - if !ok { - return nil - } +// FindMatch searches for a matching call. Returns error with explanation message if no call matched. +func (cs callSet) FindMatch(receiver interface{}, method string, args []interface{}) (*Call, error) { + key := callSetKey{receiver, method} - // Search through the unordered set of calls expected on a method on a - // receiver. - for _, call := range calls { - // A call should not normally still be here if exhausted, - // but it can happen if, for instance, .Times(0) was used. - // Pretend the call doesn't match. - if call.exhausted() { - continue + // Search through the expected calls. + expected := cs.expected[key] + var callsErrors bytes.Buffer + for _, call := range expected { + err := call.matches(args) + if err != nil { + fmt.Fprintf(&callsErrors, "\n%v", err) + } else { + return call, nil } - if call.matches(args) { - return call + } + + // If we haven't found a match then search through the exhausted calls so we + // get useful error messages. + exhausted := cs.exhausted[key] + for _, call := range exhausted { + if err := call.matches(args); err != nil { + fmt.Fprintf(&callsErrors, "\n%v", err) } } - return nil + if len(expected)+len(exhausted) == 0 { + fmt.Fprintf(&callsErrors, "there are no expected calls of the method %q for that receiver", method) + } + + return nil, fmt.Errorf(callsErrors.String()) +} + +// Failures returns the calls that are not satisfied. +func (cs callSet) Failures() []*Call { + failures := make([]*Call, 0, len(cs.expected)) + for _, calls := range cs.expected { + for _, call := range calls { + if !call.satisfied() { + failures = append(failures, call) + } + } + } + return failures } diff --git a/vendor/github.com/golang/mock/gomock/callset_test.go b/vendor/github.com/golang/mock/gomock/callset_test.go new file mode 100644 index 0000000..7fc711a --- /dev/null +++ b/vendor/github.com/golang/mock/gomock/callset_test.go @@ -0,0 +1,76 @@ +// Copyright 2011 Google Inc. +// +// 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. + +package gomock + +import ( + "reflect" + "testing" +) + +type receiverType struct{} + +func (receiverType) Func() {} + +func TestCallSetAdd(t *testing.T) { + method := "TestMethod" + var receiver interface{} = "TestReceiver" + cs := newCallSet() + + numCalls := 10 + for i := 0; i < numCalls; i++ { + cs.Add(newCall(t, receiver, method, reflect.TypeOf(receiverType{}.Func))) + } + + call, err := cs.FindMatch(receiver, method, []interface{}{}) + if err != nil { + t.Fatalf("FindMatch: %v", err) + } + if call == nil { + t.Fatalf("FindMatch: Got nil, want non-nil *Call") + } +} + +func TestCallSetRemove(t *testing.T) { + method := "TestMethod" + var receiver interface{} = "TestReceiver" + + cs := newCallSet() + ourCalls := []*Call{} + + numCalls := 10 + for i := 0; i < numCalls; i++ { + // NOTE: abuse the `numCalls` value to convey initial ordering of mocked calls + generatedCall := &Call{receiver: receiver, method: method, numCalls: i} + cs.Add(generatedCall) + ourCalls = append(ourCalls, generatedCall) + } + + // validateOrder validates that the calls in the array are ordered as they were added + validateOrder := func(calls []*Call) { + // lastNum tracks the last `numCalls` (call order) value seen + lastNum := -1 + for _, c := range calls { + if lastNum >= c.numCalls { + t.Errorf("found call %d after call %d", c.numCalls, lastNum) + } + lastNum = c.numCalls + } + } + + for _, c := range ourCalls { + validateOrder(cs.expected[callSetKey{receiver, method}]) + cs.Remove(c) + } +} diff --git a/vendor/github.com/golang/mock/gomock/controller.go b/vendor/github.com/golang/mock/gomock/controller.go index 6bff78d..6fde25f 100644 --- a/vendor/github.com/golang/mock/gomock/controller.go +++ b/vendor/github.com/golang/mock/gomock/controller.go @@ -56,8 +56,10 @@ package gomock import ( + "context" "fmt" "reflect" + "runtime" "sync" ) @@ -68,97 +70,147 @@ type TestReporter interface { Fatalf(format string, args ...interface{}) } +// TestHelper is a TestReporter that has the Helper method. It is satisfied +// by the standard library's *testing.T. +type TestHelper interface { + TestReporter + Helper() +} + // A Controller represents the top-level control of a mock ecosystem. // It defines the scope and lifetime of mock objects, as well as their expectations. // It is safe to call Controller's methods from multiple goroutines. type Controller struct { + // T should only be called within a generated mock. It is not intended to + // be used in user code and may be changed in future versions. T is the + // TestReporter passed in when creating the Controller via NewController. + // If the TestReporter does not implment a TestHelper it will be wrapped + // with a nopTestHelper. + T TestHelper mu sync.Mutex - t TestReporter - expectedCalls callSet + expectedCalls *callSet + finished bool } func NewController(t TestReporter) *Controller { + h, ok := t.(TestHelper) + if !ok { + h = nopTestHelper{t} + } + return &Controller{ - t: t, - expectedCalls: make(callSet), + T: h, + expectedCalls: newCallSet(), + } +} + +type cancelReporter struct { + TestHelper + cancel func() +} + +func (r *cancelReporter) Errorf(format string, args ...interface{}) { + r.TestHelper.Errorf(format, args...) +} +func (r *cancelReporter) Fatalf(format string, args ...interface{}) { + defer r.cancel() + r.TestHelper.Fatalf(format, args...) +} + +// WithContext returns a new Controller and a Context, which is cancelled on any +// fatal failure. +func WithContext(ctx context.Context, t TestReporter) (*Controller, context.Context) { + h, ok := t.(TestHelper) + if !ok { + h = nopTestHelper{t} } + + ctx, cancel := context.WithCancel(ctx) + return NewController(&cancelReporter{h, cancel}), ctx +} + +type nopTestHelper struct { + TestReporter } +func (h nopTestHelper) Helper() {} + func (ctrl *Controller) RecordCall(receiver interface{}, method string, args ...interface{}) *Call { + ctrl.T.Helper() + recv := reflect.ValueOf(receiver) for i := 0; i < recv.Type().NumMethod(); i++ { if recv.Type().Method(i).Name == method { return ctrl.RecordCallWithMethodType(receiver, method, recv.Method(i).Type(), args...) } } - ctrl.t.Fatalf("gomock: failed finding method %s on %T", method, receiver) - // In case t.Fatalf does not panic. - panic(fmt.Sprintf("gomock: failed finding method %s on %T", method, receiver)) + ctrl.T.Fatalf("gomock: failed finding method %s on %T", method, receiver) + panic("unreachable") } func (ctrl *Controller) RecordCallWithMethodType(receiver interface{}, method string, methodType reflect.Type, args ...interface{}) *Call { - // TODO: check arity, types. - margs := make([]Matcher, len(args)) - for i, arg := range args { - if m, ok := arg.(Matcher); ok { - margs[i] = m - } else if arg == nil { - // Handle nil specially so that passing a nil interface value - // will match the typed nils of concrete args. - margs[i] = Nil() - } else { - margs[i] = Eq(arg) - } - } + ctrl.T.Helper() + + call := newCall(ctrl.T, receiver, method, methodType, args...) ctrl.mu.Lock() defer ctrl.mu.Unlock() - - call := &Call{t: ctrl.t, receiver: receiver, method: method, methodType: methodType, args: margs, minCalls: 1, maxCalls: 1} - ctrl.expectedCalls.Add(call) + return call } func (ctrl *Controller) Call(receiver interface{}, method string, args ...interface{}) []interface{} { - ctrl.mu.Lock() - defer ctrl.mu.Unlock() - - expected := ctrl.expectedCalls.FindMatch(receiver, method, args) - if expected == nil { - ctrl.t.Fatalf("no matching expected call: %T.%v(%v)", receiver, method, args) - } + ctrl.T.Helper() + + // Nest this code so we can use defer to make sure the lock is released. + actions := func() []func([]interface{}) []interface{} { + ctrl.T.Helper() + ctrl.mu.Lock() + defer ctrl.mu.Unlock() + + expected, err := ctrl.expectedCalls.FindMatch(receiver, method, args) + if err != nil { + origin := callerInfo(2) + ctrl.T.Fatalf("Unexpected call to %T.%v(%v) at %s because: %s", receiver, method, args, origin, err) + } - // Two things happen here: - // * the matching call no longer needs to check prerequite calls, - // * and the prerequite calls are no longer expected, so remove them. - preReqCalls := expected.dropPrereqs() - for _, preReqCall := range preReqCalls { - ctrl.expectedCalls.Remove(preReqCall) - } + // Two things happen here: + // * the matching call no longer needs to check prerequite calls, + // * and the prerequite calls are no longer expected, so remove them. + preReqCalls := expected.dropPrereqs() + for _, preReqCall := range preReqCalls { + ctrl.expectedCalls.Remove(preReqCall) + } - rets, action := expected.call(args) - if expected.exhausted() { - ctrl.expectedCalls.Remove(expected) - } + actions := expected.call(args) + if expected.exhausted() { + ctrl.expectedCalls.Remove(expected) + } + return actions + }() - // Don't hold the lock while doing the call's action (if any) - // so that actions may execute concurrently. - // We use the deferred Unlock to capture any panics that happen above; - // here we add a deferred Lock to balance it. - ctrl.mu.Unlock() - defer ctrl.mu.Lock() - if action != nil { - action() + var rets []interface{} + for _, action := range actions { + if r := action(args); r != nil { + rets = r + } } return rets } func (ctrl *Controller) Finish() { + ctrl.T.Helper() + ctrl.mu.Lock() defer ctrl.mu.Unlock() + if ctrl.finished { + ctrl.T.Fatalf("Controller.Finish was called more than once. It has to be called exactly once.") + } + ctrl.finished = true + // If we're currently panicking, probably because this is a deferred call, // pass through the panic. if err := recover(); err != nil { @@ -166,18 +218,18 @@ func (ctrl *Controller) Finish() { } // Check that all remaining expected calls are satisfied. - failures := false - for _, methodMap := range ctrl.expectedCalls { - for _, calls := range methodMap { - for _, call := range calls { - if !call.satisfied() { - ctrl.t.Errorf("missing call(s) to %v", call) - failures = true - } - } - } + failures := ctrl.expectedCalls.Failures() + for _, call := range failures { + ctrl.T.Errorf("missing call(s) to %v", call) + } + if len(failures) != 0 { + ctrl.T.Fatalf("aborting test due to missing call(s)") } - if failures { - ctrl.t.Fatalf("aborting test due to missing call(s)") +} + +func callerInfo(skip int) string { + if _, file, line, ok := runtime.Caller(skip + 1); ok { + return fmt.Sprintf("%s:%d", file, line) } + return "unknown file" } diff --git a/vendor/github.com/golang/mock/gomock/controller_test.go b/vendor/github.com/golang/mock/gomock/controller_test.go index 57f7957..70c9e3a 100644 --- a/vendor/github.com/golang/mock/gomock/controller_test.go +++ b/vendor/github.com/golang/mock/gomock/controller_test.go @@ -19,6 +19,8 @@ import ( "reflect" "testing" + "strings" + "github.com/golang/mock/gomock" ) @@ -53,7 +55,7 @@ func (e *ErrorReporter) assertFail(msg string) { } // Use to check that code triggers a fatal test failure. -func (e *ErrorReporter) assertFatal(fn func()) { +func (e *ErrorReporter) assertFatal(fn func(), expectedErrMsgs ...string) { defer func() { err := recover() if err == nil { @@ -66,6 +68,18 @@ func (e *ErrorReporter) assertFatal(fn func()) { e.t.Error("Expected fatal failure, but got a", actual) } else if token, ok := err.(*struct{}); ok && token == &e.fatalToken { // This is okay - the panic is from Fatalf(). + if expectedErrMsgs != nil { + // assert that the actual error message + // contains expectedErrMsgs + + // check the last actualErrMsg, because the previous messages come from previous errors + actualErrMsg := e.log[len(e.log)-1] + for _, expectedErrMsg := range expectedErrMsgs { + if !strings.Contains(actualErrMsg, expectedErrMsg) { + e.t.Errorf("Error message:\ngot: %q\nwant to contain: %q\n", actualErrMsg, expectedErrMsg) + } + } + } return } else { // Some other panic. @@ -108,6 +122,15 @@ func (e *ErrorReporter) Fatalf(format string, args ...interface{}) { panic(&e.fatalToken) } +type HelperReporter struct { + gomock.TestReporter + helper int +} + +func (h *HelperReporter) Helper() { + h.helper++ +} + // A type purely for use as a receiver in testing the Controller. type Subject struct{} @@ -119,6 +142,20 @@ func (s *Subject) BarMethod(arg string) int { return 0 } +func (s *Subject) VariadicMethod(arg int, vararg ...string) {} + +// A type purely for ActOnTestStructMethod +type TestStruct struct { + Number int + Message string +} + +func (s *Subject) ActOnTestStructMethod(arg TestStruct, arg1 int) int { + return 0 +} + +func (s *Subject) SetArgMethod(sliceArg []byte, ptrArg *int) {} + func assertEqual(t *testing.T, expected interface{}, actual interface{}) { if !reflect.DeepEqual(expected, actual) { t.Errorf("Expected %+v, but got %+v", expected, actual) @@ -140,6 +177,31 @@ func TestNoCalls(t *testing.T) { reporter.assertPass("No calls expected or made.") } +func TestNoRecordedCallsForAReceiver(t *testing.T) { + reporter, ctrl := createFixtures(t) + subject := new(Subject) + + reporter.assertFatal(func() { + ctrl.Call(subject, "NotRecordedMethod", "argument") + }, "Unexpected call to", "there are no expected calls of the method \"NotRecordedMethod\" for that receiver") + ctrl.Finish() +} + +func TestNoRecordedMatchingMethodNameForAReceiver(t *testing.T) { + reporter, ctrl := createFixtures(t) + subject := new(Subject) + + ctrl.RecordCall(subject, "FooMethod", "argument") + reporter.assertFatal(func() { + ctrl.Call(subject, "NotRecordedMethod", "argument") + }, "Unexpected call to", "there are no expected calls of the method \"NotRecordedMethod\" for that receiver") + reporter.assertFatal(func() { + // The expected call wasn't made. + ctrl.Finish() + }) +} + +// This tests that a call with an arguments of some primitive type matches a recorded call. func TestExpectedMethodCall(t *testing.T) { reporter, ctrl := createFixtures(t) subject := new(Subject) @@ -187,11 +249,68 @@ func TestUnexpectedArgCount(t *testing.T) { reporter.assertFatal(func() { // This call is made with the wrong number of arguments... ctrl.Call(subject, "FooMethod", "argument", "extra_argument") - }) + }, "Unexpected call to", "wrong number of arguments", "Got: 2, want: 1") reporter.assertFatal(func() { // ... so is this. ctrl.Call(subject, "FooMethod") + }, "Unexpected call to", "wrong number of arguments", "Got: 0, want: 1") + reporter.assertFatal(func() { + // The expected call wasn't made. + ctrl.Finish() + }) +} + +// This tests that a call with complex arguments (a struct and some primitive type) matches a recorded call. +func TestExpectedMethodCall_CustomStruct(t *testing.T) { + reporter, ctrl := createFixtures(t) + subject := new(Subject) + + expectedArg0 := TestStruct{Number: 123, Message: "hello"} + ctrl.RecordCall(subject, "ActOnTestStructMethod", expectedArg0, 15) + ctrl.Call(subject, "ActOnTestStructMethod", expectedArg0, 15) + + reporter.assertPass("Expected method call made.") +} + +func TestUnexpectedArgValue_FirstArg(t *testing.T) { + reporter, ctrl := createFixtures(t) + defer reporter.recoverUnexpectedFatal() + subject := new(Subject) + + expectedArg0 := TestStruct{Number: 123, Message: "hello"} + ctrl.RecordCall(subject, "ActOnTestStructMethod", expectedArg0, 15) + + reporter.assertFatal(func() { + // the method argument (of TestStruct type) has 1 unexpected value (for the Message field) + ctrl.Call(subject, "ActOnTestStructMethod", TestStruct{Number: 123, Message: "no message"}, 15) + }, "Unexpected call to", "doesn't match the argument at index 0", + "Got: {123 no message}\nWant: is equal to {123 hello}") + + reporter.assertFatal(func() { + // the method argument (of TestStruct type) has 2 unexpected values (for both fields) + ctrl.Call(subject, "ActOnTestStructMethod", TestStruct{Number: 11, Message: "no message"}, 15) + }, "Unexpected call to", "doesn't match the argument at index 0", + "Got: {11 no message}\nWant: is equal to {123 hello}") + + reporter.assertFatal(func() { + // The expected call wasn't made. + ctrl.Finish() }) +} + +func TestUnexpectedArgValue_SecondtArg(t *testing.T) { + reporter, ctrl := createFixtures(t) + defer reporter.recoverUnexpectedFatal() + subject := new(Subject) + + expectedArg0 := TestStruct{Number: 123, Message: "hello"} + ctrl.RecordCall(subject, "ActOnTestStructMethod", expectedArg0, 15) + + reporter.assertFatal(func() { + ctrl.Call(subject, "ActOnTestStructMethod", TestStruct{Number: 123, Message: "hello"}, 3) + }, "Unexpected call to", "doesn't match the argument at index 1", + "Got: 3\nWant: is equal to 15") + reporter.assertFatal(func() { // The expected call wasn't made. ctrl.Finish() @@ -317,6 +436,74 @@ func TestDo(t *testing.T) { ctrl.Finish() } +func TestDoAndReturn(t *testing.T) { + _, ctrl := createFixtures(t) + subject := new(Subject) + + doCalled := false + var argument string + ctrl.RecordCall(subject, "FooMethod", "argument").DoAndReturn( + func(arg string) int { + doCalled = true + argument = arg + return 5 + }) + if doCalled { + t.Error("Do() callback called too early.") + } + + rets := ctrl.Call(subject, "FooMethod", "argument") + + if !doCalled { + t.Error("Do() callback not called.") + } + if "argument" != argument { + t.Error("Do callback received wrong argument.") + } + if len(rets) != 1 { + t.Fatalf("Return values from Call: got %d, want 1", len(rets)) + } + if ret, ok := rets[0].(int); !ok { + t.Fatalf("Return value is not an int") + } else if ret != 5 { + t.Errorf("DoAndReturn return value: got %d, want 5", ret) + } + + ctrl.Finish() +} + +func TestSetArgSlice(t *testing.T) { + _, ctrl := createFixtures(t) + subject := new(Subject) + + var in = []byte{4, 5, 6} + var set = []byte{1, 2, 3} + ctrl.RecordCall(subject, "SetArgMethod", in, nil).SetArg(0, set) + ctrl.Call(subject, "SetArgMethod", in, nil) + + if !reflect.DeepEqual(in, set) { + t.Error("Expected SetArg() to modify input slice argument") + } + + ctrl.Finish() +} + +func TestSetArgPtr(t *testing.T) { + _, ctrl := createFixtures(t) + subject := new(Subject) + + var in int = 43 + const set = 42 + ctrl.RecordCall(subject, "SetArgMethod", nil, &in).SetArg(1, set) + ctrl.Call(subject, "SetArgMethod", nil, &in) + + if in != set { + t.Error("Expected SetArg() to modify value pointed to by argument") + } + + ctrl.Finish() +} + func TestReturn(t *testing.T) { _, ctrl := createFixtures(t) subject := new(Subject) @@ -393,11 +580,12 @@ func TestOrderedCallsInCorrect(t *testing.T) { ctrl.Call(subjectOne, "FooMethod", "1") reporter.assertFatal(func() { + // FooMethod(2) should be called before BarMethod(3) ctrl.Call(subjectTwo, "BarMethod", "3") - }) + }, "Unexpected call to", "Subject.BarMethod([3])", "doesn't have a prerequisite call satisfied") } -// Test that calls that are prerequites to other calls but have maxCalls > +// Test that calls that are prerequisites to other calls but have maxCalls > // minCalls are removed from the expected call set. func TestOrderedCallsWithPreReqMaxUnbounded(t *testing.T) { reporter, ctrl, subjectOne, subjectTwo := commonTestOrderedCalls(t) @@ -473,3 +661,79 @@ func TestTimes0(t *testing.T) { ctrl.Call(s, "FooMethod", "arg") }) } + +func TestVariadicMatching(t *testing.T) { + rep, ctrl := createFixtures(t) + defer rep.recoverUnexpectedFatal() + + s := new(Subject) + ctrl.RecordCall(s, "VariadicMethod", 0, "1", "2") + ctrl.Call(s, "VariadicMethod", 0, "1", "2") + ctrl.Finish() + rep.assertPass("variadic matching works") +} + +func TestVariadicNoMatch(t *testing.T) { + rep, ctrl := createFixtures(t) + defer rep.recoverUnexpectedFatal() + + s := new(Subject) + ctrl.RecordCall(s, "VariadicMethod", 0) + rep.assertFatal(func() { + ctrl.Call(s, "VariadicMethod", 1) + }, "Expected call at", "doesn't match the argument at index 0", + "Got: 1\nWant: is equal to 0") + ctrl.Call(s, "VariadicMethod", 0) + ctrl.Finish() +} + +func TestVariadicMatchingWithSlice(t *testing.T) { + testCases := [][]string{ + {"1"}, + {"1", "2"}, + } + for _, tc := range testCases { + t.Run(fmt.Sprintf("%d arguments", len(tc)), func(t *testing.T) { + rep, ctrl := createFixtures(t) + defer rep.recoverUnexpectedFatal() + + s := new(Subject) + ctrl.RecordCall(s, "VariadicMethod", 1, tc) + args := make([]interface{}, len(tc)+1) + args[0] = 1 + for i, arg := range tc { + args[i+1] = arg + } + ctrl.Call(s, "VariadicMethod", args...) + ctrl.Finish() + rep.assertPass("slices can be used as matchers for variadic arguments") + }) + } +} + +func TestDuplicateFinishCallFails(t *testing.T) { + rep, ctrl := createFixtures(t) + + ctrl.Finish() + rep.assertPass("the first Finish call should succeed") + + rep.assertFatal(ctrl.Finish, "Controller.Finish was called more than once. It has to be called exactly once.") +} + +func TestTestNoHelper(t *testing.T) { + ctrlNoHelper := gomock.NewController(NewErrorReporter(t)) + + // doesn't panic + ctrlNoHelper.T.Helper() +} + +func TestTestWithHelper(t *testing.T) { + withHelper := &HelperReporter{TestReporter: NewErrorReporter(t)} + ctrlWithHelper := gomock.NewController(withHelper) + + ctrlWithHelper.T.Helper() + + if withHelper.helper == 0 { + t.Fatal("expected Helper to be invoked") + } +} diff --git a/vendor/github.com/golang/mock/gomock/mock_matcher/mock_matcher.go b/vendor/github.com/golang/mock/gomock/internal/mock_matcher/mock_matcher.go similarity index 56% rename from vendor/github.com/golang/mock/gomock/mock_matcher/mock_matcher.go rename to vendor/github.com/golang/mock/gomock/internal/mock_matcher/mock_matcher.go index d0bf885..5462f4d 100644 --- a/vendor/github.com/golang/mock/gomock/mock_matcher/mock_matcher.go +++ b/vendor/github.com/golang/mock/gomock/internal/mock_matcher/mock_matcher.go @@ -1,6 +1,7 @@ // Code generated by MockGen. DO NOT EDIT. // Source: github.com/golang/mock/gomock (interfaces: Matcher) +// Package mock_gomock is a generated GoMock package. package mock_gomock import ( @@ -27,30 +28,34 @@ func NewMockMatcher(ctrl *gomock.Controller) *MockMatcher { } // EXPECT returns an object that allows the caller to indicate expected use -func (_m *MockMatcher) EXPECT() *MockMatcherMockRecorder { - return _m.recorder +func (m *MockMatcher) EXPECT() *MockMatcherMockRecorder { + return m.recorder } // Matches mocks base method -func (_m *MockMatcher) Matches(_param0 interface{}) bool { - ret := _m.ctrl.Call(_m, "Matches", _param0) +func (m *MockMatcher) Matches(arg0 interface{}) bool { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Matches", arg0) ret0, _ := ret[0].(bool) return ret0 } // Matches indicates an expected call of Matches -func (_mr *MockMatcherMockRecorder) Matches(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Matches", reflect.TypeOf((*MockMatcher)(nil).Matches), arg0) +func (mr *MockMatcherMockRecorder) Matches(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Matches", reflect.TypeOf((*MockMatcher)(nil).Matches), arg0) } // String mocks base method -func (_m *MockMatcher) String() string { - ret := _m.ctrl.Call(_m, "String") +func (m *MockMatcher) String() string { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "String") ret0, _ := ret[0].(string) return ret0 } // String indicates an expected call of String -func (_mr *MockMatcherMockRecorder) String() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "String", reflect.TypeOf((*MockMatcher)(nil).String)) +func (mr *MockMatcherMockRecorder) String() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "String", reflect.TypeOf((*MockMatcher)(nil).String)) } diff --git a/vendor/github.com/golang/mock/gomock/matchers.go b/vendor/github.com/golang/mock/gomock/matchers.go index e8b1ddc..189796f 100644 --- a/vendor/github.com/golang/mock/gomock/matchers.go +++ b/vendor/github.com/golang/mock/gomock/matchers.go @@ -1,5 +1,3 @@ -//go:generate mockgen -destination mock_matcher/mock_matcher.go github.com/golang/mock/gomock Matcher - // Copyright 2010 Google Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); @@ -87,6 +85,18 @@ func (n notMatcher) String() string { return "not(" + n.m.String() + ")" } +type assignableToTypeOfMatcher struct { + targetType reflect.Type +} + +func (m assignableToTypeOfMatcher) Matches(x interface{}) bool { + return reflect.TypeOf(x).AssignableTo(m.targetType) +} + +func (m assignableToTypeOfMatcher) String() string { + return "is assignable to " + m.targetType.Name() +} + // Constructors func Any() Matcher { return anyMatcher{} } func Eq(x interface{}) Matcher { return eqMatcher{x} } @@ -97,3 +107,16 @@ func Not(x interface{}) Matcher { } return notMatcher{Eq(x)} } + +// AssignableToTypeOf is a Matcher that matches if the parameter to the mock +// function is assignable to the type of the parameter to this function. +// +// Example usage: +// +// dbMock.EXPECT(). +// Insert(gomock.AssignableToTypeOf(&EmployeeRecord{})). +// Return(errors.New("DB error")) +// +func AssignableToTypeOf(x interface{}) Matcher { + return assignableToTypeOfMatcher{reflect.TypeOf(x)} +} diff --git a/vendor/github.com/golang/mock/gomock/matchers_test.go b/vendor/github.com/golang/mock/gomock/matchers_test.go index 29b97fb..db1411e 100644 --- a/vendor/github.com/golang/mock/gomock/matchers_test.go +++ b/vendor/github.com/golang/mock/gomock/matchers_test.go @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +//go:generate mockgen -destination internal/mock_matcher/mock_matcher.go github.com/golang/mock/gomock Matcher + package gomock_test import ( @@ -19,7 +21,7 @@ import ( "testing" "github.com/golang/mock/gomock" - mock_matcher "github.com/golang/mock/gomock/mock_matcher" + mock_matcher "github.com/golang/mock/gomock/internal/mock_matcher" ) func TestMatchers(t *testing.T) { @@ -29,12 +31,12 @@ func TestMatchers(t *testing.T) { yes, no []e } tests := []testCase{ - testCase{gomock.Any(), []e{3, nil, "foo"}, nil}, - testCase{gomock.Eq(4), []e{4}, []e{3, "blah", nil, int64(4)}}, - testCase{gomock.Nil(), + {gomock.Any(), []e{3, nil, "foo"}, nil}, + {gomock.Eq(4), []e{4}, []e{3, "blah", nil, int64(4)}}, + {gomock.Nil(), []e{nil, (error)(nil), (chan bool)(nil), (*int)(nil)}, []e{"", 0, make(chan bool), errors.New("err"), new(int)}}, - testCase{gomock.Not(gomock.Eq(4)), []e{3, "blah", nil, int64(4)}, []e{4}}, + {gomock.Not(gomock.Eq(4)), []e{3, "blah", nil, int64(4)}, []e{4}}, } for i, test := range tests { for _, x := range test.yes { @@ -68,3 +70,50 @@ func TestNotMatcher(t *testing.T) { t.Errorf("notMatcher should match 5") } } + +type Dog struct { + Breed, Name string +} + +// A thorough test of assignableToTypeOfMatcher +func TestAssignableToTypeOfMatcher(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + aStr := "def" + anotherStr := "ghi" + + if match := gomock.AssignableToTypeOf("abc").Matches(4); match { + t.Errorf(`AssignableToTypeOf("abc") should not match 4`) + } + if match := gomock.AssignableToTypeOf("abc").Matches(&aStr); match { + t.Errorf(`AssignableToTypeOf("abc") should not match &aStr (*string)`) + } + if match := gomock.AssignableToTypeOf("abc").Matches("def"); !match { + t.Errorf(`AssignableToTypeOf("abc") should match "def"`) + } + if match := gomock.AssignableToTypeOf(&aStr).Matches("abc"); match { + t.Errorf(`AssignableToTypeOf(&aStr) should not match "abc"`) + } + if match := gomock.AssignableToTypeOf(&aStr).Matches(&anotherStr); !match { + t.Errorf(`AssignableToTypeOf(&aStr) should match &anotherStr`) + } + if match := gomock.AssignableToTypeOf(0).Matches(4); !match { + t.Errorf(`AssignableToTypeOf(0) should match 4`) + } + if match := gomock.AssignableToTypeOf(0).Matches("def"); match { + t.Errorf(`AssignableToTypeOf(0) should not match "def"`) + } + if match := gomock.AssignableToTypeOf(Dog{}).Matches(&Dog{}); match { + t.Errorf(`AssignableToTypeOf(Dog{}) should not match &Dog{}`) + } + if match := gomock.AssignableToTypeOf(Dog{}).Matches(Dog{Breed: "pug", Name: "Fido"}); !match { + t.Errorf(`AssignableToTypeOf(Dog{}) should match Dog{Breed: "pug", Name: "Fido"}`) + } + if match := gomock.AssignableToTypeOf(&Dog{}).Matches(Dog{}); match { + t.Errorf(`AssignableToTypeOf(&Dog{}) should not match Dog{}`) + } + if match := gomock.AssignableToTypeOf(&Dog{}).Matches(&Dog{Breed: "pug", Name: "Fido"}); !match { + t.Errorf(`AssignableToTypeOf(&Dog{}) should match &Dog{Breed: "pug", Name: "Fido"}`) + } +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/README.md new file mode 100644 index 0000000..63955f6 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/README.md @@ -0,0 +1,36 @@ +Embedded interfaces in `aux_files` generate `unknown embedded interface XXX` errors. +See below for example of the problem: +``` +// source +import ( + alias "some.org/package/imported" +) + +type Source interface { + alias.Foreign +} +``` + +``` +// some.org/package/imported +type Foreign interface { + Embedded +} + +type Embedded interface {} +``` + +Attempting to generate a mock will result in an `unknown embedded interface Embedded`. +The issue is that the `fileParser` stores `auxInterfaces` underneath the package name +explicitly specified in the `aux_files` flag. + +In the `parseInterface` method, there is an incorrect assumption about an embedded interface +always being in the source file. +``` +case *ast.Ident: + // Embedded interface in this package. + ei := p.auxInterfaces[""][v.String()] + if ei == nil { + return nil, p.errorf(v.Pos(), "unknown embedded interface %s", v.String()) + } +``` diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport.go b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport.go new file mode 100644 index 0000000..7ae2ac4 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport.go @@ -0,0 +1,18 @@ +//go:generate mockgen -aux_files faux=faux/faux.go -destination bugreport_mock.go -package bugreport -source=bugreport.go Example + +package bugreport + +import ( + "log" + + "github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux" +) + +// Source is an interface w/ an embedded foreign interface +type Source interface { + faux.Foreign +} + +func CallForeignMethod(s Source) { + log.Println(s.Method()) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_mock.go new file mode 100644 index 0000000..548e764 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_mock.go @@ -0,0 +1,48 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: bugreport.go + +// Package bugreport is a generated GoMock package. +package bugreport + +import ( + gomock "github.com/golang/mock/gomock" + faux "github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux" + reflect "reflect" +) + +// MockSource is a mock of Source interface +type MockSource struct { + ctrl *gomock.Controller + recorder *MockSourceMockRecorder +} + +// MockSourceMockRecorder is the mock recorder for MockSource +type MockSourceMockRecorder struct { + mock *MockSource +} + +// NewMockSource creates a new mock instance +func NewMockSource(ctrl *gomock.Controller) *MockSource { + mock := &MockSource{ctrl: ctrl} + mock.recorder = &MockSourceMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockSource) EXPECT() *MockSourceMockRecorder { + return m.recorder +} + +// Method mocks base method +func (m *MockSource) Method() faux.Return { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Method") + ret0, _ := ret[0].(faux.Return) + return ret0 +} + +// Method indicates an expected call of Method +func (mr *MockSourceMockRecorder) Method() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Method", reflect.TypeOf((*MockSource)(nil).Method)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_test.go b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_test.go new file mode 100644 index 0000000..acfca32 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/bugreport_test.go @@ -0,0 +1,18 @@ +package bugreport + +import ( + "testing" + + "github.com/golang/mock/gomock" +) + +// TestValidInterface assesses whether or not the generated mock is valid +func TestValidInterface(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + s := NewMockSource(ctrl) + s.EXPECT().Method().Return("") + + CallForeignMethod(s) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux/faux.go b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux/faux.go new file mode 100644 index 0000000..bafd034 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/aux_imports_embedded_interface/faux/faux.go @@ -0,0 +1,10 @@ +package faux + +type Foreign interface { + Method() Return + Embedded +} + +type Embedded interface{} + +type Return interface{} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/README.md new file mode 100644 index 0000000..418b261 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/README.md @@ -0,0 +1,22 @@ +# Tests for custom package names + +This directory contains test for mockgen generating mocks when imported package +name does not match import path suffix. For example, package with name "client" +is located under import path "github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1". + +Prior to this patch: + + $ go generate greeter/greeter.go + 2018/03/05 22:44:52 Loading input failed: greeter.go:17:11: failed parsing returns: greeter.go:17:14: unknown package "client" + greeter/greeter.go:1: running "mockgen": exit status 1 + +This can be fixed by manually providing `-imports` flag, like `-imports client=github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1`. +But, mockgen should be able to automatically resolve package names in such situations. + +With this patch applied: + + $ go generate greeter/greeter.go + $ echo $? + 0 + +Mockgen runs successfully, produced output is equal to [greeter_mock_test.go](greeter/greeter_mock_test.go) content. diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1/client.go b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1/client.go new file mode 100644 index 0000000..fc799d9 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1/client.go @@ -0,0 +1,13 @@ +package client + +import "fmt" + +type Client struct{} + +func (c *Client) Greet(in GreetInput) string { + return fmt.Sprintf("Hello, %s!", in.Name) +} + +type GreetInput struct { + Name string +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter.go b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter.go new file mode 100644 index 0000000..8f07d51 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter.go @@ -0,0 +1,31 @@ +//go:generate mockgen -source greeter.go -destination greeter_mock_test.go -package greeter + +package greeter + +import ( + // stdlib import + "fmt" + + // non-matching import suffix and package name + "github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1" + + // matching import suffix and package name + "github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator" +) + +type InputMaker interface { + MakeInput() client.GreetInput +} + +type Greeter struct { + InputMaker InputMaker + Client *client.Client +} + +func (g *Greeter) Greet() (string, error) { + in := g.InputMaker.MakeInput() + if err := validator.Validate(in.Name); err != nil { + return "", fmt.Errorf("validation failed: %v", err) + } + return g.Client.Greet(in), nil +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_mock_test.go b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_mock_test.go new file mode 100644 index 0000000..0885f3d --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_mock_test.go @@ -0,0 +1,48 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: greeter.go + +// Package greeter is a generated GoMock package. +package greeter + +import ( + gomock "github.com/golang/mock/gomock" + v1 "github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1" + reflect "reflect" +) + +// MockInputMaker is a mock of InputMaker interface +type MockInputMaker struct { + ctrl *gomock.Controller + recorder *MockInputMakerMockRecorder +} + +// MockInputMakerMockRecorder is the mock recorder for MockInputMaker +type MockInputMakerMockRecorder struct { + mock *MockInputMaker +} + +// NewMockInputMaker creates a new mock instance +func NewMockInputMaker(ctrl *gomock.Controller) *MockInputMaker { + mock := &MockInputMaker{ctrl: ctrl} + mock.recorder = &MockInputMakerMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockInputMaker) EXPECT() *MockInputMakerMockRecorder { + return m.recorder +} + +// MakeInput mocks base method +func (m *MockInputMaker) MakeInput() v1.GreetInput { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "MakeInput") + ret0, _ := ret[0].(v1.GreetInput) + return ret0 +} + +// MakeInput indicates an expected call of MakeInput +func (mr *MockInputMakerMockRecorder) MakeInput() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "MakeInput", reflect.TypeOf((*MockInputMaker)(nil).MakeInput)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_test.go b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_test.go new file mode 100644 index 0000000..a64d677 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter/greeter_test.go @@ -0,0 +1,37 @@ +package greeter + +import ( + "testing" + + "github.com/golang/mock/gomock" + "github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1" +) + +func TestGreeter_Greet(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + input := client.GreetInput{ + Name: "Foo", + } + + inputMaker := NewMockInputMaker(ctrl) + inputMaker.EXPECT(). + MakeInput(). + Return(input) + + g := &Greeter{ + InputMaker: inputMaker, + Client: &client.Client{}, + } + + greeting, err := g.Greet() + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + expected := "Hello, Foo!" + if greeting != expected { + t.Fatalf("Expected greeting to be %v but got %v", expected, greeting) + } +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator/validate.go b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator/validate.go new file mode 100644 index 0000000..0617c4b --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator/validate.go @@ -0,0 +1,5 @@ +package validator + +func Validate(s string) error { + return nil +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/input.go b/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/input.go new file mode 100644 index 0000000..51b6de2 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/input.go @@ -0,0 +1,14 @@ +//go:generate mockgen -package dot_imports -destination mock.go -source input.go +package dot_imports + +import ( + "bytes" + . "context" + . "net/http" +) + +type WithDotImports interface { + Method1() Request + Method2() *bytes.Buffer + Method3() Context +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/mock.go new file mode 100644 index 0000000..7833162 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/dot_imports/mock.go @@ -0,0 +1,78 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: input.go + +// Package dot_imports is a generated GoMock package. +package dot_imports + +import ( + bytes "bytes" + . "context" + gomock "github.com/golang/mock/gomock" + . "net/http" + reflect "reflect" +) + +// MockWithDotImports is a mock of WithDotImports interface +type MockWithDotImports struct { + ctrl *gomock.Controller + recorder *MockWithDotImportsMockRecorder +} + +// MockWithDotImportsMockRecorder is the mock recorder for MockWithDotImports +type MockWithDotImportsMockRecorder struct { + mock *MockWithDotImports +} + +// NewMockWithDotImports creates a new mock instance +func NewMockWithDotImports(ctrl *gomock.Controller) *MockWithDotImports { + mock := &MockWithDotImports{ctrl: ctrl} + mock.recorder = &MockWithDotImportsMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockWithDotImports) EXPECT() *MockWithDotImportsMockRecorder { + return m.recorder +} + +// Method1 mocks base method +func (m *MockWithDotImports) Method1() Request { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Method1") + ret0, _ := ret[0].(Request) + return ret0 +} + +// Method1 indicates an expected call of Method1 +func (mr *MockWithDotImportsMockRecorder) Method1() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Method1", reflect.TypeOf((*MockWithDotImports)(nil).Method1)) +} + +// Method2 mocks base method +func (m *MockWithDotImports) Method2() *bytes.Buffer { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Method2") + ret0, _ := ret[0].(*bytes.Buffer) + return ret0 +} + +// Method2 indicates an expected call of Method2 +func (mr *MockWithDotImportsMockRecorder) Method2() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Method2", reflect.TypeOf((*MockWithDotImports)(nil).Method2)) +} + +// Method3 mocks base method +func (m *MockWithDotImports) Method3() Context { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Method3") + ret0, _ := ret[0].(Context) + return ret0 +} + +// Method3 indicates an expected call of Method3 +func (mr *MockWithDotImportsMockRecorder) Method3() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Method3", reflect.TypeOf((*MockWithDotImports)(nil).Method3)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/input.go b/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/input.go new file mode 100644 index 0000000..bbcb3fc --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/input.go @@ -0,0 +1,4 @@ +//go:generate mockgen -package empty_interface -destination mock.go -source input.go +package empty_interface + +type Empty interface{} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/mock.go new file mode 100644 index 0000000..0fc5b0c --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/empty_interface/mock.go @@ -0,0 +1,32 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: input.go + +// Package empty_interface is a generated GoMock package. +package empty_interface + +import ( + gomock "github.com/golang/mock/gomock" +) + +// MockEmpty is a mock of Empty interface +type MockEmpty struct { + ctrl *gomock.Controller + recorder *MockEmptyMockRecorder +} + +// MockEmptyMockRecorder is the mock recorder for MockEmpty +type MockEmptyMockRecorder struct { + mock *MockEmpty +} + +// NewMockEmpty creates a new mock instance +func NewMockEmpty(ctrl *gomock.Controller) *MockEmpty { + mock := &MockEmpty{ctrl: ctrl} + mock.recorder = &MockEmptyMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockEmpty) EXPECT() *MockEmptyMockRecorder { + return m.recorder +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/README.md new file mode 100644 index 0000000..ffb5f9f --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/README.md @@ -0,0 +1,26 @@ +The generated mock methods use some hardcoded variable/receiver names that can +have conflicts with the argument names that are defined by the code for which +the mock is generated when using the source generation method. + +Example: + +```go +type Example interface { + Method(_m, _mr, m, mr int) +} +``` + +```go +// Method mocks base method +func (_m *MockExample) Method(_m int, _mr int, m int, mr int) { + _m.ctrl.Call(_m, "Method", _m, _mr, m, mr) +} +``` + +In the above example one of the interface method parameters is called `_m` +but unfortunately the generated receiver name is also called `_m` so the +mock code won't compile. + +The generator has to make sure that generated identifiers (e.g.: the receiver +names) are always different from the arg names that might come from external +sources. diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport.go b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport.go new file mode 100644 index 0000000..77af43d --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport.go @@ -0,0 +1,16 @@ +//go:generate mockgen -destination bugreport_mock.go -package bugreport -source=bugreport.go + +package bugreport + +type Example interface { + // _m and _mr were used by the buggy code: the '_' prefix was there hoping + // that no one will use method argument names starting with '_' reducing + // the chance of collision with generated identifiers. + // m and mr are used by the bugfixed new code, the '_' prefix has been + // removed because the new code generator changes the names of the + // generated identifiers in case they would collide with identifiers + // coming from argument names. + Method(_m, _mr, m, mr int) + + VarargMethod(_s, _x, a, ret int, varargs ...int) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_mock.go new file mode 100644 index 0000000..2ed1aeb --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_mock.go @@ -0,0 +1,62 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: bugreport.go + +// Package bugreport is a generated GoMock package. +package bugreport + +import ( + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockExample is a mock of Example interface +type MockExample struct { + ctrl *gomock.Controller + recorder *MockExampleMockRecorder +} + +// MockExampleMockRecorder is the mock recorder for MockExample +type MockExampleMockRecorder struct { + mock *MockExample +} + +// NewMockExample creates a new mock instance +func NewMockExample(ctrl *gomock.Controller) *MockExample { + mock := &MockExample{ctrl: ctrl} + mock.recorder = &MockExampleMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockExample) EXPECT() *MockExampleMockRecorder { + return m.recorder +} + +// Method mocks base method +func (m_2 *MockExample) Method(_m, _mr, m, mr int) { + m_2.ctrl.T.Helper() + m_2.ctrl.Call(m_2, "Method", _m, _mr, m, mr) +} + +// Method indicates an expected call of Method +func (mr_2 *MockExampleMockRecorder) Method(_m, _mr, m, mr interface{}) *gomock.Call { + mr_2.mock.ctrl.T.Helper() + return mr_2.mock.ctrl.RecordCallWithMethodType(mr_2.mock, "Method", reflect.TypeOf((*MockExample)(nil).Method), _m, _mr, m, mr) +} + +// VarargMethod mocks base method +func (m *MockExample) VarargMethod(_s, _x, a, ret int, varargs ...int) { + m.ctrl.T.Helper() + varargs_2 := []interface{}{_s, _x, a, ret} + for _, a_2 := range varargs { + varargs_2 = append(varargs_2, a_2) + } + m.ctrl.Call(m, "VarargMethod", varargs_2...) +} + +// VarargMethod indicates an expected call of VarargMethod +func (mr *MockExampleMockRecorder) VarargMethod(_s, _x, a, ret interface{}, varargs ...interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs_2 := append([]interface{}{_s, _x, a, ret}, varargs...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "VarargMethod", reflect.TypeOf((*MockExample)(nil).VarargMethod), varargs_2...) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_test.go b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_test.go new file mode 100644 index 0000000..3ca9807 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/generated_identifier_conflict/bugreport_test.go @@ -0,0 +1,26 @@ +package bugreport + +import ( + "github.com/golang/mock/gomock" + "testing" +) + +func TestExample_Method(t *testing.T) { + ctrl := gomock.NewController(t) + m := NewMockExample(ctrl) + m.EXPECT().Method(1, 2, 3, 4) + + m.Method(1, 2, 3, 4) + + ctrl.Finish() +} + +func TestExample_VarargMethod(t *testing.T) { + ctrl := gomock.NewController(t) + m := NewMockExample(ctrl) + m.EXPECT().VarargMethod(1, 2, 3, 4, 6, 7) + + m.VarargMethod(1, 2, 3, 4, 6, 7) + + ctrl.Finish() +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/Readme.md b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/Readme.md new file mode 100644 index 0000000..b755968 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/Readme.md @@ -0,0 +1,3 @@ +Test the case where the generated code uses a type defined in the source package (in source mode). There are two test cases: +- the output is in a new package +- the output is in the same package as the input \ No newline at end of file diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source.go b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source.go new file mode 100644 index 0000000..493134d --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source.go @@ -0,0 +1,9 @@ +//go:generate mockgen -destination ../source_mock.go -source=source.go +//go:generate mockgen -package source -destination source_mock.go -source=source.go +package source + +type X struct{} + +type S interface { + F(X) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source_mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source_mock.go new file mode 100644 index 0000000..c808ea6 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/definition/source_mock.go @@ -0,0 +1,45 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: source.go + +// Package source is a generated GoMock package. +package source + +import ( + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockS is a mock of S interface +type MockS struct { + ctrl *gomock.Controller + recorder *MockSMockRecorder +} + +// MockSMockRecorder is the mock recorder for MockS +type MockSMockRecorder struct { + mock *MockS +} + +// NewMockS creates a new mock instance +func NewMockS(ctrl *gomock.Controller) *MockS { + mock := &MockS{ctrl: ctrl} + mock.recorder = &MockSMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockS) EXPECT() *MockSMockRecorder { + return m.recorder +} + +// F mocks base method +func (m *MockS) F(arg0 X) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "F", arg0) +} + +// F indicates an expected call of F +func (mr *MockSMockRecorder) F(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "F", reflect.TypeOf((*MockS)(nil).F), arg0) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/source_mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/source_mock.go new file mode 100644 index 0000000..d7c4769 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/import_source/source_mock.go @@ -0,0 +1,46 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: source.go + +// Package mock_source is a generated GoMock package. +package mock_source + +import ( + gomock "github.com/golang/mock/gomock" + definition "github.com/golang/mock/mockgen/internal/tests/import_source/definition" + reflect "reflect" +) + +// MockS is a mock of S interface +type MockS struct { + ctrl *gomock.Controller + recorder *MockSMockRecorder +} + +// MockSMockRecorder is the mock recorder for MockS +type MockSMockRecorder struct { + mock *MockS +} + +// NewMockS creates a new mock instance +func NewMockS(ctrl *gomock.Controller) *MockS { + mock := &MockS{ctrl: ctrl} + mock.recorder = &MockSMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockS) EXPECT() *MockSMockRecorder { + return m.recorder +} + +// F mocks base method +func (m *MockS) F(arg0 definition.X) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "F", arg0) +} + +// F indicates an expected call of F +func (mr *MockSMockRecorder) F(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "F", reflect.TypeOf((*MockS)(nil).F), arg0) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/generate.go b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/generate.go new file mode 100644 index 0000000..717516c --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/generate.go @@ -0,0 +1,3 @@ +//go:generate mockgen -destination subdir/internal/pkg/reflect_output/mock.go github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg Intf +//go:generate mockgen -source subdir/internal/pkg/input.go -destination subdir/internal/pkg/source_output/mock.go +package test diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/input.go b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/input.go new file mode 100644 index 0000000..d05f6a7 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/input.go @@ -0,0 +1,9 @@ +package pkg + +type Arg interface { + Foo() int +} + +type Intf interface { + F() Arg +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/reflect_output/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/reflect_output/mock.go new file mode 100644 index 0000000..df234bf --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/reflect_output/mock.go @@ -0,0 +1,48 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg (interfaces: Intf) + +// Package mock_pkg is a generated GoMock package. +package mock_pkg + +import ( + gomock "github.com/golang/mock/gomock" + pkg "github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg" + reflect "reflect" +) + +// MockIntf is a mock of Intf interface +type MockIntf struct { + ctrl *gomock.Controller + recorder *MockIntfMockRecorder +} + +// MockIntfMockRecorder is the mock recorder for MockIntf +type MockIntfMockRecorder struct { + mock *MockIntf +} + +// NewMockIntf creates a new mock instance +func NewMockIntf(ctrl *gomock.Controller) *MockIntf { + mock := &MockIntf{ctrl: ctrl} + mock.recorder = &MockIntfMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockIntf) EXPECT() *MockIntfMockRecorder { + return m.recorder +} + +// F mocks base method +func (m *MockIntf) F() pkg.Arg { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "F") + ret0, _ := ret[0].(pkg.Arg) + return ret0 +} + +// F indicates an expected call of F +func (mr *MockIntfMockRecorder) F() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "F", reflect.TypeOf((*MockIntf)(nil).F)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/source_output/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/source_output/mock.go new file mode 100644 index 0000000..4ba902f --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg/source_output/mock.go @@ -0,0 +1,85 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: subdir/internal/pkg/input.go + +// Package mock_pkg is a generated GoMock package. +package mock_pkg + +import ( + gomock "github.com/golang/mock/gomock" + pkg "github.com/golang/mock/mockgen/internal/tests/internal_pkg/subdir/internal/pkg" + reflect "reflect" +) + +// MockArg is a mock of Arg interface +type MockArg struct { + ctrl *gomock.Controller + recorder *MockArgMockRecorder +} + +// MockArgMockRecorder is the mock recorder for MockArg +type MockArgMockRecorder struct { + mock *MockArg +} + +// NewMockArg creates a new mock instance +func NewMockArg(ctrl *gomock.Controller) *MockArg { + mock := &MockArg{ctrl: ctrl} + mock.recorder = &MockArgMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockArg) EXPECT() *MockArgMockRecorder { + return m.recorder +} + +// Foo mocks base method +func (m *MockArg) Foo() int { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Foo") + ret0, _ := ret[0].(int) + return ret0 +} + +// Foo indicates an expected call of Foo +func (mr *MockArgMockRecorder) Foo() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Foo", reflect.TypeOf((*MockArg)(nil).Foo)) +} + +// MockIntf is a mock of Intf interface +type MockIntf struct { + ctrl *gomock.Controller + recorder *MockIntfMockRecorder +} + +// MockIntfMockRecorder is the mock recorder for MockIntf +type MockIntfMockRecorder struct { + mock *MockIntf +} + +// NewMockIntf creates a new mock instance +func NewMockIntf(ctrl *gomock.Controller) *MockIntf { + mock := &MockIntf{ctrl: ctrl} + mock.recorder = &MockIntfMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockIntf) EXPECT() *MockIntfMockRecorder { + return m.recorder +} + +// F mocks base method +func (m *MockIntf) F() pkg.Arg { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "F") + ret0, _ := ret[0].(pkg.Arg) + return ret0 +} + +// F indicates an expected call of F +func (mr *MockIntfMockRecorder) F() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "F", reflect.TypeOf((*MockIntf)(nil).F)) +} diff --git a/vendor/github.com/golang/mock/mockgen/tests/unexported_method/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/README.md similarity index 100% rename from vendor/github.com/golang/mock/mockgen/tests/unexported_method/README.md rename to vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/README.md diff --git a/vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport.go b/vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport.go similarity index 100% rename from vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport.go rename to vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport.go diff --git a/vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport_mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport_mock.go similarity index 63% rename from vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport_mock.go rename to vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport_mock.go index f1a16d8..bd65a16 100644 --- a/vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport_mock.go +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport_mock.go @@ -1,6 +1,7 @@ // Code generated by MockGen. DO NOT EDIT. // Source: bugreport.go +// Package bugreport is a generated GoMock package. package bugreport import ( @@ -27,18 +28,20 @@ func NewMockExample(ctrl *gomock.Controller) *MockExample { } // EXPECT returns an object that allows the caller to indicate expected use -func (_m *MockExample) EXPECT() *MockExampleMockRecorder { - return _m.recorder +func (m *MockExample) EXPECT() *MockExampleMockRecorder { + return m.recorder } // someMethod mocks base method -func (_m *MockExample) someMethod(_param0 string) string { - ret := _m.ctrl.Call(_m, "someMethod", _param0) +func (m *MockExample) someMethod(arg0 string) string { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "someMethod", arg0) ret0, _ := ret[0].(string) return ret0 } // someMethod indicates an expected call of someMethod -func (_mr *MockExampleMockRecorder) someMethod(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "someMethod", reflect.TypeOf((*MockExample)(nil).someMethod), arg0) +func (mr *MockExampleMockRecorder) someMethod(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "someMethod", reflect.TypeOf((*MockExample)(nil).someMethod), arg0) } diff --git a/vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport_test.go b/vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport_test.go similarity index 100% rename from vendor/github.com/golang/mock/mockgen/tests/unexported_method/bugreport_test.go rename to vendor/github.com/golang/mock/mockgen/internal/tests/unexported_method/bugreport_test.go diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/README.md new file mode 100644 index 0000000..9f9217d --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/README.md @@ -0,0 +1,2 @@ +Test for [Issue#4](https://github.com/golang/mock/issues/4). +Also see discussion on [#28](https://github.com/golang/mock/pull/28). diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/doc.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/doc.go new file mode 100644 index 0000000..29e424c --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/doc.go @@ -0,0 +1,4 @@ +package vendor_dep + +//go:generate mockgen -package vendor_dep -destination mock.go github.com/golang/mock/mockgen/internal/tests/vendor_dep VendorsDep +//go:generate mockgen -destination source_mock_package/mock.go -source=vendor_dep.go diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/mock.go new file mode 100644 index 0000000..8ff53d0 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/mock.go @@ -0,0 +1,48 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: github.com/golang/mock/mockgen/internal/tests/vendor_dep (interfaces: VendorsDep) + +// Package vendor_dep is a generated GoMock package. +package vendor_dep + +import ( + a "a" + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockVendorsDep is a mock of VendorsDep interface +type MockVendorsDep struct { + ctrl *gomock.Controller + recorder *MockVendorsDepMockRecorder +} + +// MockVendorsDepMockRecorder is the mock recorder for MockVendorsDep +type MockVendorsDepMockRecorder struct { + mock *MockVendorsDep +} + +// NewMockVendorsDep creates a new mock instance +func NewMockVendorsDep(ctrl *gomock.Controller) *MockVendorsDep { + mock := &MockVendorsDep{ctrl: ctrl} + mock.recorder = &MockVendorsDepMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockVendorsDep) EXPECT() *MockVendorsDepMockRecorder { + return m.recorder +} + +// Foo mocks base method +func (m *MockVendorsDep) Foo() a.Ifc { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Foo") + ret0, _ := ret[0].(a.Ifc) + return ret0 +} + +// Foo indicates an expected call of Foo +func (mr *MockVendorsDepMockRecorder) Foo() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Foo", reflect.TypeOf((*MockVendorsDep)(nil).Foo)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/source_mock_package/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/source_mock_package/mock.go new file mode 100644 index 0000000..892496f --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/source_mock_package/mock.go @@ -0,0 +1,48 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: vendor_dep.go + +// Package mock_vendor_dep is a generated GoMock package. +package mock_vendor_dep + +import ( + a "a" + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockVendorsDep is a mock of VendorsDep interface +type MockVendorsDep struct { + ctrl *gomock.Controller + recorder *MockVendorsDepMockRecorder +} + +// MockVendorsDepMockRecorder is the mock recorder for MockVendorsDep +type MockVendorsDepMockRecorder struct { + mock *MockVendorsDep +} + +// NewMockVendorsDep creates a new mock instance +func NewMockVendorsDep(ctrl *gomock.Controller) *MockVendorsDep { + mock := &MockVendorsDep{ctrl: ctrl} + mock.recorder = &MockVendorsDepMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockVendorsDep) EXPECT() *MockVendorsDepMockRecorder { + return m.recorder +} + +// Foo mocks base method +func (m *MockVendorsDep) Foo() a.Ifc { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Foo") + ret0, _ := ret[0].(a.Ifc) + return ret0 +} + +// Foo indicates an expected call of Foo +func (mr *MockVendorsDepMockRecorder) Foo() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Foo", reflect.TypeOf((*MockVendorsDep)(nil).Foo)) +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/vendor_dep.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/vendor_dep.go new file mode 100644 index 0000000..412636a --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_dep/vendor_dep.go @@ -0,0 +1,7 @@ +package vendor_dep + +import "a" + +type VendorsDep interface { + Foo() a.Ifc +} diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/README.md b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/README.md new file mode 100644 index 0000000..1233f98 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/README.md @@ -0,0 +1 @@ +Test for [Issue#4](https://github.com/golang/mock/issues/4). diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/doc.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/doc.go new file mode 100644 index 0000000..b5bde11 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/doc.go @@ -0,0 +1,3 @@ +package vendor_pkg + +//go:generate mockgen -destination mock.go -package vendor_pkg a Ifc diff --git a/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/mock.go b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/mock.go new file mode 100644 index 0000000..1f4bdb8 --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/internal/tests/vendor_pkg/mock.go @@ -0,0 +1,111 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: a (interfaces: Ifc) + +// Package vendor_pkg is a generated GoMock package. +package vendor_pkg + +import ( + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockIfc is a mock of Ifc interface +type MockIfc struct { + ctrl *gomock.Controller + recorder *MockIfcMockRecorder +} + +// MockIfcMockRecorder is the mock recorder for MockIfc +type MockIfcMockRecorder struct { + mock *MockIfc +} + +// NewMockIfc creates a new mock instance +func NewMockIfc(ctrl *gomock.Controller) *MockIfc { + mock := &MockIfc{ctrl: ctrl} + mock.recorder = &MockIfcMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockIfc) EXPECT() *MockIfcMockRecorder { + return m.recorder +} + +// A mocks base method +func (m *MockIfc) A(arg0 string) string { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "A", arg0) + ret0, _ := ret[0].(string) + return ret0 +} + +// A indicates an expected call of A +func (mr *MockIfcMockRecorder) A(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "A", reflect.TypeOf((*MockIfc)(nil).A), arg0) +} + +// B mocks base method +func (m *MockIfc) B(arg0 int) int { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "B", arg0) + ret0, _ := ret[0].(int) + return ret0 +} + +// B indicates an expected call of B +func (mr *MockIfcMockRecorder) B(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "B", reflect.TypeOf((*MockIfc)(nil).B), arg0) +} + +// C mocks base method +func (m *MockIfc) C(arg0 chan int) chan int { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "C", arg0) + ret0, _ := ret[0].(chan int) + return ret0 +} + +// C indicates an expected call of C +func (mr *MockIfcMockRecorder) C(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "C", reflect.TypeOf((*MockIfc)(nil).C), arg0) +} + +// D mocks base method +func (m *MockIfc) D(arg0 interface{}) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "D", arg0) +} + +// D indicates an expected call of D +func (mr *MockIfcMockRecorder) D(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "D", reflect.TypeOf((*MockIfc)(nil).D), arg0) +} + +// E mocks base method +func (m *MockIfc) E(arg0 map[string]interface{}) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "E", arg0) +} + +// E indicates an expected call of E +func (mr *MockIfcMockRecorder) E(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "E", reflect.TypeOf((*MockIfc)(nil).E), arg0) +} + +// F mocks base method +func (m *MockIfc) F(arg0 []float64) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "F", arg0) +} + +// F indicates an expected call of F +func (mr *MockIfcMockRecorder) F(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "F", reflect.TypeOf((*MockIfc)(nil).F), arg0) +} diff --git a/vendor/github.com/golang/mock/mockgen/mockgen.go b/vendor/github.com/golang/mock/mockgen/mockgen.go index 3b08c14..3a16948 100644 --- a/vendor/github.com/golang/mock/mockgen/mockgen.go +++ b/vendor/github.com/golang/mock/mockgen/mockgen.go @@ -22,12 +22,14 @@ import ( "bytes" "flag" "fmt" + "go/build" "go/format" "go/token" "io" "log" "os" "path" + "path/filepath" "sort" "strconv" "strings" @@ -41,10 +43,12 @@ const ( ) var ( - source = flag.String("source", "", "(source mode) Input Go source file; enables source mode.") - destination = flag.String("destination", "", "Output file; defaults to stdout.") - packageOut = flag.String("package", "", "Package of the generated code; defaults to the package of the input with a 'mock_' prefix.") - selfPackage = flag.String("self_package", "", "If set, the package this mock will be part of.") + source = flag.String("source", "", "(source mode) Input Go source file; enables source mode.") + destination = flag.String("destination", "", "Output file; defaults to stdout.") + mockNames = flag.String("mock_names", "", "Comma-separated interfaceName=mockName pairs of explicit mock names to use. Mock names default to 'Mock'+ interfaceName suffix.") + packageOut = flag.String("package", "", "Package of the generated code; defaults to the package of the input with a 'mock_' prefix.") + selfPackage = flag.String("self_package", "", "The full package import path for the generated code. The purpose of this flag is to prevent import cycles in the generated code by trying to include its own package. This can happen if the mock's package is set to one of its inputs (usually the main one) and the output is stdio so mockgen cannot detect the final output package. Setting this flag will then tell mockgen which import to exclude.") + writePkgComment = flag.Bool("write_package_comment", true, "Writes package documentation comment (godoc) if true.") debugParser = flag.Bool("debug_parser", false, "Print out parser results only.") ) @@ -75,6 +79,9 @@ func main() { dst := os.Stdout if len(*destination) > 0 { + if err := os.MkdirAll(filepath.Dir(*destination), os.ModePerm); err != nil { + log.Fatalf("Unable to create directory: %v", err) + } f, err := os.Create(*destination) if err != nil { log.Fatalf("Failed opening destination file: %v", err) @@ -90,6 +97,25 @@ func main() { packageName = "mock_" + sanitize(pkg.Name) } + // outputPackagePath represents the fully qualified name of the package of + // the generated code. Its purposes are to prevent the module from importing + // itself and to prevent qualifying type names that come from its own + // package (i.e. if there is a type called X then we want to print "X" not + // "package.X" since "package" is this package). This can happen if the mock + // is output into an already existing package. + outputPackagePath := *selfPackage + if len(outputPackagePath) == 0 && len(*destination) > 0 { + dst, _ := filepath.Abs(filepath.Dir(*destination)) + for _, prefix := range build.Default.SrcDirs() { + if strings.HasPrefix(dst, prefix) { + if rel, err := filepath.Rel(prefix, dst); err == nil { + outputPackagePath = rel + break + } + } + } + } + g := new(generator) if *source != "" { g.filename = *source @@ -97,13 +123,28 @@ func main() { g.srcPackage = flag.Arg(0) g.srcInterfaces = flag.Arg(1) } - if err := g.Generate(pkg, packageName); err != nil { + + if *mockNames != "" { + g.mockNames = parseMockNames(*mockNames) + } + if err := g.Generate(pkg, packageName, outputPackagePath); err != nil { log.Fatalf("Failed generating mock: %v", err) } if _, err := dst.Write(g.Output()); err != nil { log.Fatalf("Failed writing to destination: %v", err) } } +func parseMockNames(names string) map[string]string { + mocksMap := make(map[string]string) + for _, kv := range strings.Split(names, ",") { + parts := strings.SplitN(kv, "=", 2) + if len(parts) != 2 || parts[1] == "" { + log.Fatalf("bad mock names spec: %v", kv) + } + mocksMap[parts[0]] = parts[1] + } + return mocksMap +} func usage() { io.WriteString(os.Stderr, usageText) @@ -128,11 +169,11 @@ Example: ` type generator struct { - buf bytes.Buffer - indent string - - filename string // may be empty - srcPackage, srcInterfaces string // may be empty + buf bytes.Buffer + indent string + mockNames map[string]string //may be empty + filename string // may be empty + srcPackage, srcInterfaces string // may be empty packageMap map[string]string // map from import path to package name } @@ -181,7 +222,7 @@ func sanitize(s string) string { return t } -func (g *generator) Generate(pkg *model.Package, pkgName string) error { +func (g *generator) Generate(pkg *model.Package, pkgName string, outputPackagePath string) error { g.p("// Code generated by MockGen. DO NOT EDIT.") if g.filename != "" { g.p("// Source: %v", g.filename) @@ -193,7 +234,15 @@ func (g *generator) Generate(pkg *model.Package, pkgName string) error { // Get all required imports, and generate unique names for them all. im := pkg.Imports() im[gomockImportPath] = true - im["reflect"] = true + + // Only import reflect if it's used. We only use reflect in mocked methods + // so only import if any of the mocked interfaces have methods. + for _, intf := range pkg.Interfaces { + if len(intf.Methods) > 0 { + im["reflect"] = true + break + } + } // Sort keys to make import alias generation predictable sorted_paths := make([]string, len(im), len(im)) @@ -225,12 +274,15 @@ func (g *generator) Generate(pkg *model.Package, pkgName string) error { localNames[pkgName] = true } + if *writePkgComment { + g.p("// Package %v is a generated GoMock package.", pkgName) + } g.p("package %v", pkgName) g.p("") g.p("import (") g.in() for path, pkg := range g.packageMap { - if path == *selfPackage { + if path == outputPackagePath { continue } g.p("%v %q", pkg, path) @@ -242,7 +294,7 @@ func (g *generator) Generate(pkg *model.Package, pkgName string) error { g.p(")") for _, intf := range pkg.Interfaces { - if err := g.GenerateMockInterface(intf); err != nil { + if err := g.GenerateMockInterface(intf, outputPackagePath); err != nil { return err } } @@ -251,12 +303,16 @@ func (g *generator) Generate(pkg *model.Package, pkgName string) error { } // The name of the mock type to use for the given interface identifier. -func mockName(typeName string) string { +func (g *generator) mockName(typeName string) string { + if mockName, ok := g.mockNames[typeName]; ok { + return mockName + } + return "Mock" + typeName } -func (g *generator) GenerateMockInterface(intf *model.Interface) error { - mockType := mockName(intf.Name) +func (g *generator) GenerateMockInterface(intf *model.Interface, outputPackagePath string) error { + mockType := g.mockName(intf.Name) g.p("") g.p("// %v is a mock of %v interface", mockType, intf.Name) @@ -293,13 +349,13 @@ func (g *generator) GenerateMockInterface(intf *model.Interface) error { // XXX: possible name collision here if someone has EXPECT in their interface. g.p("// EXPECT returns an object that allows the caller to indicate expected use") - g.p("func (_m *%v) EXPECT() *%vMockRecorder {", mockType, mockType) + g.p("func (m *%v) EXPECT() *%vMockRecorder {", mockType, mockType) g.in() - g.p("return _m.recorder") + g.p("return m.recorder") g.out() g.p("}") - g.GenerateMockMethods(mockType, intf, *selfPackage) + g.GenerateMockMethods(mockType, intf, outputPackagePath) return nil } @@ -313,30 +369,25 @@ func (g *generator) GenerateMockMethods(mockType string, intf *model.Interface, } } +func makeArgString(argNames, argTypes []string) string { + args := make([]string, len(argNames)) + for i, name := range argNames { + // specify the type only once for consecutive args of the same type + if i+1 < len(argTypes) && argTypes[i] == argTypes[i+1] { + args[i] = name + } else { + args[i] = name + " " + argTypes[i] + } + } + return strings.Join(args, ", ") +} + // GenerateMockMethod generates a mock method implementation. // If non-empty, pkgOverride is the package in which unqualified types reside. func (g *generator) GenerateMockMethod(mockType string, m *model.Method, pkgOverride string) error { - args := make([]string, len(m.In)) - argNames := make([]string, len(m.In)) - for i, p := range m.In { - name := p.Name - if name == "" { - name = fmt.Sprintf("_param%d", i) - } - ts := p.Type.String(g.packageMap, pkgOverride) - args[i] = name + " " + ts - argNames[i] = name - } - if m.Variadic != nil { - name := m.Variadic.Name - if name == "" { - name = fmt.Sprintf("_param%d", len(m.In)) - } - ts := m.Variadic.Type.String(g.packageMap, pkgOverride) - args = append(args, name+" ..."+ts) - argNames = append(argNames, name) - } - argString := strings.Join(args, ", ") + argNames := g.getArgNames(m) + argTypes := g.getArgTypes(m, pkgOverride) + argString := makeArgString(argNames, argTypes) rets := make([]string, len(m.Out)) for i, p := range m.Out { @@ -350,37 +401,45 @@ func (g *generator) GenerateMockMethod(mockType string, m *model.Method, pkgOver retString = " " + retString } + ia := newIdentifierAllocator(argNames) + idRecv := ia.allocateIdentifier("m") + g.p("// %v mocks base method", m.Name) - g.p("func (_m *%v) %v(%v)%v {", mockType, m.Name, argString, retString) + g.p("func (%v *%v) %v(%v)%v {", idRecv, mockType, m.Name, argString, retString) g.in() + g.p("%s.ctrl.T.Helper()", idRecv) - callArgs := strings.Join(argNames, ", ") - if callArgs != "" { - callArgs = ", " + callArgs - } - if m.Variadic != nil { + var callArgs string + if m.Variadic == nil { + if len(argNames) > 0 { + callArgs = ", " + strings.Join(argNames, ", ") + } + } else { // Non-trivial. The generated code must build a []interface{}, // but the variadic argument may be any type. - g.p("_s := []interface{}{%s}", strings.Join(argNames[:len(argNames)-1], ", ")) - g.p("for _, _x := range %s {", argNames[len(argNames)-1]) + idVarArgs := ia.allocateIdentifier("varargs") + idVArg := ia.allocateIdentifier("a") + g.p("%s := []interface{}{%s}", idVarArgs, strings.Join(argNames[:len(argNames)-1], ", ")) + g.p("for _, %s := range %s {", idVArg, argNames[len(argNames)-1]) g.in() - g.p("_s = append(_s, _x)") + g.p("%s = append(%s, %s)", idVarArgs, idVarArgs, idVArg) g.out() g.p("}") - callArgs = ", _s..." + callArgs = ", " + idVarArgs + "..." } if len(m.Out) == 0 { - g.p(`_m.ctrl.Call(_m, "%v"%v)`, m.Name, callArgs) + g.p(`%v.ctrl.Call(%v, %q%v)`, idRecv, idRecv, m.Name, callArgs) } else { - g.p(`ret := _m.ctrl.Call(_m, "%v"%v)`, m.Name, callArgs) + idRet := ia.allocateIdentifier("ret") + g.p(`%v := %v.ctrl.Call(%v, %q%v)`, idRet, idRecv, idRecv, m.Name, callArgs) // Go does not allow "naked" type assertions on nil values, so we use the two-value form here. // The value of that is either (x.(T), true) or (Z, false), where Z is the zero value for T. // Happily, this coincides with the semantics we want here. retNames := make([]string, len(rets)) for i, t := range rets { - retNames[i] = fmt.Sprintf("ret%d", i) - g.p("%s, _ := ret[%d].(%s)", retNames[i], i, t) + retNames[i] = ia.allocateIdentifier(fmt.Sprintf("ret%d", i)) + g.p("%s, _ := %s[%d].(%s)", retNames[i], idRet, i, t) } g.p("return " + strings.Join(retNames, ", ")) } @@ -391,47 +450,110 @@ func (g *generator) GenerateMockMethod(mockType string, m *model.Method, pkgOver } func (g *generator) GenerateMockRecorderMethod(mockType string, m *model.Method) error { - nargs := len(m.In) - args := make([]string, nargs) - for i := 0; i < nargs; i++ { - args[i] = "arg" + strconv.Itoa(i) + argNames := g.getArgNames(m) + + var argString string + if m.Variadic == nil { + argString = strings.Join(argNames, ", ") + } else { + argString = strings.Join(argNames[:len(argNames)-1], ", ") } - argString := strings.Join(args, ", ") - if nargs > 0 { + if argString != "" { argString += " interface{}" } + if m.Variadic != nil { - if nargs > 0 { + if argString != "" { argString += ", " } - argString += fmt.Sprintf("arg%d ...interface{}", nargs) + argString += fmt.Sprintf("%s ...interface{}", argNames[len(argNames)-1]) } + ia := newIdentifierAllocator(argNames) + idRecv := ia.allocateIdentifier("mr") + g.p("// %v indicates an expected call of %v", m.Name, m.Name) - g.p("func (_mr *%vMockRecorder) %v(%v) *gomock.Call {", mockType, m.Name, argString) + g.p("func (%s *%vMockRecorder) %v(%v) *gomock.Call {", idRecv, mockType, m.Name, argString) g.in() + g.p("%s.mock.ctrl.T.Helper()", idRecv) - callArgs := strings.Join(args, ", ") - if nargs > 0 { - callArgs = ", " + callArgs - } - if m.Variadic != nil { - if nargs == 0 { + var callArgs string + if m.Variadic == nil { + if len(argNames) > 0 { + callArgs = ", " + strings.Join(argNames, ", ") + } + } else { + if len(argNames) == 1 { // Easy: just use ... to push the arguments through. - callArgs = ", arg0..." + callArgs = ", " + argNames[0] + "..." } else { // Hard: create a temporary slice. - g.p("_s := append([]interface{}{%s}, arg%d...)", strings.Join(args, ", "), nargs) - callArgs = ", _s..." + idVarArgs := ia.allocateIdentifier("varargs") + g.p("%s := append([]interface{}{%s}, %s...)", + idVarArgs, + strings.Join(argNames[:len(argNames)-1], ", "), + argNames[len(argNames)-1]) + callArgs = ", " + idVarArgs + "..." } } - g.p(`return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "%s", reflect.TypeOf((*%s)(nil).%s)%s)`, m.Name, mockType, m.Name, callArgs) + g.p(`return %s.mock.ctrl.RecordCallWithMethodType(%s.mock, "%s", reflect.TypeOf((*%s)(nil).%s)%s)`, idRecv, idRecv, m.Name, mockType, m.Name, callArgs) g.out() g.p("}") return nil } +func (g *generator) getArgNames(m *model.Method) []string { + argNames := make([]string, len(m.In)) + for i, p := range m.In { + name := p.Name + if name == "" { + name = fmt.Sprintf("arg%d", i) + } + argNames[i] = name + } + if m.Variadic != nil { + name := m.Variadic.Name + if name == "" { + name = fmt.Sprintf("arg%d", len(m.In)) + } + argNames = append(argNames, name) + } + return argNames +} + +func (g *generator) getArgTypes(m *model.Method, pkgOverride string) []string { + argTypes := make([]string, len(m.In)) + for i, p := range m.In { + argTypes[i] = p.Type.String(g.packageMap, pkgOverride) + } + if m.Variadic != nil { + argTypes = append(argTypes, "..."+m.Variadic.Type.String(g.packageMap, pkgOverride)) + } + return argTypes +} + +type identifierAllocator map[string]struct{} + +func newIdentifierAllocator(taken []string) identifierAllocator { + a := make(identifierAllocator, len(taken)) + for _, s := range taken { + a[s] = struct{}{} + } + return a +} + +func (o identifierAllocator) allocateIdentifier(want string) string { + id := want + for i := 2; ; i++ { + if _, ok := o[id]; !ok { + o[id] = struct{}{} + return id + } + id = want + "_" + strconv.Itoa(i) + } +} + // Output returns the generator's output, formatted in the standard Go style. func (g *generator) Output() []byte { src, err := format.Source(g.buf.Bytes()) diff --git a/vendor/github.com/golang/mock/mockgen/mockgen_test.go b/vendor/github.com/golang/mock/mockgen/mockgen_test.go new file mode 100644 index 0000000..573cc2b --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/mockgen_test.go @@ -0,0 +1,269 @@ +package main + +import ( + "fmt" + "regexp" + "strings" + "testing" + + "github.com/golang/mock/mockgen/model" +) + +func TestMakeArgString(t *testing.T) { + testCases := []struct { + argNames []string + argTypes []string + argString string + }{ + { + argNames: nil, + argTypes: nil, + argString: "", + }, + { + argNames: []string{"arg0"}, + argTypes: []string{"int"}, + argString: "arg0 int", + }, + { + argNames: []string{"arg0", "arg1"}, + argTypes: []string{"int", "bool"}, + argString: "arg0 int, arg1 bool", + }, + { + argNames: []string{"arg0", "arg1"}, + argTypes: []string{"int", "int"}, + argString: "arg0, arg1 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2"}, + argTypes: []string{"bool", "int", "int"}, + argString: "arg0 bool, arg1, arg2 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2"}, + argTypes: []string{"int", "bool", "int"}, + argString: "arg0 int, arg1 bool, arg2 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2"}, + argTypes: []string{"int", "int", "bool"}, + argString: "arg0, arg1 int, arg2 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2"}, + argTypes: []string{"int", "int", "int"}, + argString: "arg0, arg1, arg2 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3"}, + argTypes: []string{"bool", "int", "int", "int"}, + argString: "arg0 bool, arg1, arg2, arg3 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3"}, + argTypes: []string{"int", "bool", "int", "int"}, + argString: "arg0 int, arg1 bool, arg2, arg3 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3"}, + argTypes: []string{"int", "int", "bool", "int"}, + argString: "arg0, arg1 int, arg2 bool, arg3 int", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3"}, + argTypes: []string{"int", "int", "int", "bool"}, + argString: "arg0, arg1, arg2 int, arg3 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3", "arg4"}, + argTypes: []string{"bool", "int", "int", "int", "bool"}, + argString: "arg0 bool, arg1, arg2, arg3 int, arg4 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3", "arg4"}, + argTypes: []string{"int", "bool", "int", "int", "bool"}, + argString: "arg0 int, arg1 bool, arg2, arg3 int, arg4 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3", "arg4"}, + argTypes: []string{"int", "int", "bool", "int", "bool"}, + argString: "arg0, arg1 int, arg2 bool, arg3 int, arg4 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3", "arg4"}, + argTypes: []string{"int", "int", "int", "bool", "bool"}, + argString: "arg0, arg1, arg2 int, arg3, arg4 bool", + }, + { + argNames: []string{"arg0", "arg1", "arg2", "arg3", "arg4"}, + argTypes: []string{"int", "int", "bool", "bool", "int"}, + argString: "arg0, arg1 int, arg2, arg3 bool, arg4 int", + }, + } + + for i, tc := range testCases { + t.Run(fmt.Sprintf("#%d", i), func(t *testing.T) { + s := makeArgString(tc.argNames, tc.argTypes) + if s != tc.argString { + t.Errorf("result == %q, want %q", s, tc.argString) + } + }) + } +} + +func TestNewIdentifierAllocator(t *testing.T) { + a := newIdentifierAllocator([]string{"taken1", "taken2"}) + if len(a) != 2 { + t.Fatalf("expected 2 items, got %v", len(a)) + } + + _, ok := a["taken1"] + if !ok { + t.Errorf("allocator doesn't contain 'taken1': %#v", a) + } + + _, ok = a["taken2"] + if !ok { + t.Errorf("allocator doesn't contain 'taken2': %#v", a) + } +} + +func allocatorContainsIdentifiers(a identifierAllocator, ids []string) bool { + if len(a) != len(ids) { + return false + } + + for _, id := range ids { + _, ok := a[id] + if !ok { + return false + } + } + + return true +} + +func TestIdentifierAllocator_allocateIdentifier(t *testing.T) { + a := newIdentifierAllocator([]string{"taken"}) + + t2 := a.allocateIdentifier("taken_2") + if t2 != "taken_2" { + t.Fatalf("expected 'taken_2', got %q", t2) + } + expected := []string{"taken", "taken_2"} + if !allocatorContainsIdentifiers(a, expected) { + t.Fatalf("allocator doesn't contain the expected items - allocator: %#v, expected items: %#v", a, expected) + } + + t3 := a.allocateIdentifier("taken") + if t3 != "taken_3" { + t.Fatalf("expected 'taken_3', got %q", t3) + } + expected = []string{"taken", "taken_2", "taken_3"} + if !allocatorContainsIdentifiers(a, expected) { + t.Fatalf("allocator doesn't contain the expected items - allocator: %#v, expected items: %#v", a, expected) + } + + t4 := a.allocateIdentifier("taken") + if t4 != "taken_4" { + t.Fatalf("expected 'taken_4', got %q", t4) + } + expected = []string{"taken", "taken_2", "taken_3", "taken_4"} + if !allocatorContainsIdentifiers(a, expected) { + t.Fatalf("allocator doesn't contain the expected items - allocator: %#v, expected items: %#v", a, expected) + } + + id := a.allocateIdentifier("id") + if id != "id" { + t.Fatalf("expected 'id', got %q", id) + } + expected = []string{"taken", "taken_2", "taken_3", "taken_4", "id"} + if !allocatorContainsIdentifiers(a, expected) { + t.Fatalf("allocator doesn't contain the expected items - allocator: %#v, expected items: %#v", a, expected) + } +} + +func TestGenerateMockInterface_Helper(t *testing.T) { + for _, test := range []struct { + Name string + Identifier string + HelperLine string + Methods []*model.Method + }{ + {Name: "mock", Identifier: "MockSomename", HelperLine: "m.ctrl.T.Helper()"}, + {Name: "recorder", Identifier: "MockSomenameMockRecorder", HelperLine: "mr.mock.ctrl.T.Helper()"}, + { + Name: "mock identifier conflict", + Identifier: "MockSomename", + HelperLine: "m_2.ctrl.T.Helper()", + Methods: []*model.Method{ + { + Name: "MethodA", + In: []*model.Parameter{ + { + Name: "m", + Type: &model.NamedType{Type: "int"}, + }, + }, + }, + }, + }, + { + Name: "recorder identifier conflict", + Identifier: "MockSomenameMockRecorder", + HelperLine: "mr_2.mock.ctrl.T.Helper()", + Methods: []*model.Method{ + { + Name: "MethodA", + In: []*model.Parameter{ + { + Name: "mr", + Type: &model.NamedType{Type: "int"}, + }, + }, + }, + }, + }, + } { + t.Run(test.Name, func(t *testing.T) { + g := generator{} + + if len(test.Methods) == 0 { + test.Methods = []*model.Method{ + {Name: "MethodA"}, + {Name: "MethodB"}, + } + } + + if err := g.GenerateMockInterface(&model.Interface{ + Name: "Somename", + Methods: test.Methods, + }, "somepackage"); err != nil { + t.Fatal(err) + } + + lines := strings.Split(g.buf.String(), "\n") + + // T.Helper() should be the first line + for _, method := range test.Methods { + if strings.TrimSpace(lines[findMethod(t, test.Identifier, method.Name, lines)+1]) != test.HelperLine { + t.Fatalf("method %s.%s did not declare itself a Helper method", test.Identifier, method.Name) + } + } + }) + } +} + +func findMethod(t *testing.T, identifier, methodName string, lines []string) int { + t.Helper() + r := regexp.MustCompile(fmt.Sprintf(`func\s+\(.+%s\)\s*%s`, identifier, methodName)) + for i, line := range lines { + if r.MatchString(line) { + return i + } + } + + t.Fatalf("unable to find 'func (m %s) %s'", identifier, methodName) + panic("unreachable") +} diff --git a/vendor/github.com/golang/mock/mockgen/model/model.go b/vendor/github.com/golang/mock/mockgen/model/model.go index 0e69d66..1b6683d 100644 --- a/vendor/github.com/golang/mock/mockgen/model/model.go +++ b/vendor/github.com/golang/mock/mockgen/model/model.go @@ -23,6 +23,9 @@ import ( "strings" ) +// pkgPath is the importable path for package model +const pkgPath = "github.com/golang/mock/mockgen/model" + // Package is a Go package. It may be a subset. type Package struct { Name string @@ -131,7 +134,15 @@ func init() { gob.Register(&MapType{}) gob.Register(&NamedType{}) gob.Register(&PointerType{}) - gob.Register(PredeclaredType("")) + + // Call gob.RegisterName to make sure it has the consistent name registered + // for both gob decoder and encoder. + // + // For a non-pointer type, gob.Register will try to get package full path by + // calling rt.PkgPath() for a name to register. If your project has vendor + // directory, it is possible that PkgPath will get a path like this: + // ../../../vendor/github.com/golang/mock/mockgen/model + gob.RegisterName(pkgPath+".PredeclaredType", PredeclaredType("")) } // ArrayType is an array or slice type. @@ -241,7 +252,12 @@ func (nt *NamedType) String(pm map[string]string, pkgOverride string) string { if pkgOverride == nt.Package { return nt.Type } - return pm[nt.Package] + "." + nt.Type + prefix := pm[nt.Package] + if prefix != "" { + return prefix + "." + nt.Type + } else { + return nt.Type + } } func (nt *NamedType) addImports(im map[string]bool) { if nt.Package != "" { @@ -343,6 +359,13 @@ func typeFromType(t reflect.Type) (Type, error) { } if imp := t.PkgPath(); imp != "" { + // PkgPath might return a path that includes "vendor" + // These paths do not compile, so we need to remove everything + // up to and including "/vendor/" + // see https://github.com/golang/go/issues/12019 + if i := strings.LastIndex(imp, "/vendor/"); i != -1 { + imp = imp[i+len("/vendor/"):] + } return &NamedType{ Package: imp, Type: t.Name(), diff --git a/vendor/github.com/golang/mock/mockgen/parse.go b/vendor/github.com/golang/mock/mockgen/parse.go index 5615d4b..7282fff 100644 --- a/vendor/github.com/golang/mock/mockgen/parse.go +++ b/vendor/github.com/golang/mock/mockgen/parse.go @@ -20,10 +20,12 @@ import ( "flag" "fmt" "go/ast" + "go/build" "go/parser" "go/token" "log" "path" + "path/filepath" "strconv" "strings" @@ -38,6 +40,16 @@ var ( // TODO: simplify error reporting func ParseFile(source string) (*model.Package, error) { + srcDir, err := filepath.Abs(filepath.Dir(source)) + if err != nil { + return nil, fmt.Errorf("failed getting source directory: %v", err) + } + + var packageImport string + if p, err := build.ImportDir(srcDir, 0); err == nil { + packageImport = p.ImportPath + } // TODO: should we fail if this returns an error? + fs := token.NewFileSet() file, err := parser.ParseFile(fs, source, nil, 0) if err != nil { @@ -45,9 +57,11 @@ func ParseFile(source string) (*model.Package, error) { } p := &fileParser{ - fileSet: fs, - imports: make(map[string]string), - auxInterfaces: make(map[string]map[string]*ast.InterfaceType), + fileSet: fs, + imports: make(map[string]string), + importedInterfaces: make(map[string]map[string]*ast.InterfaceType), + auxInterfaces: make(map[string]map[string]*ast.InterfaceType), + srcDir: srcDir, } // Handle -imports. @@ -70,13 +84,12 @@ func ParseFile(source string) (*model.Package, error) { if err := p.parseAuxFiles(*auxFiles); err != nil { return nil, err } - p.addAuxInterfacesFromFile("", file) // this file + p.addAuxInterfacesFromFile(packageImport, file) // this file - pkg, err := p.parseFile(file) + pkg, err := p.parseFile(packageImport, file) if err != nil { return nil, err } - pkg.DotImports = make([]string, 0, len(dotImports)) for path := range dotImports { pkg.DotImports = append(pkg.DotImports, path) } @@ -84,11 +97,14 @@ func ParseFile(source string) (*model.Package, error) { } type fileParser struct { - fileSet *token.FileSet - imports map[string]string // package name => import path + fileSet *token.FileSet + imports map[string]string // package name => import path + importedInterfaces map[string]map[string]*ast.InterfaceType // package (or "") => name => interface auxFiles []*ast.File auxInterfaces map[string]map[string]*ast.InterfaceType // package (or "") => name => interface + + srcDir string } func (p *fileParser) errorf(pos token.Pos, format string, args ...interface{}) error { @@ -108,12 +124,14 @@ func (p *fileParser) parseAuxFiles(auxFiles string) error { if len(parts) != 2 { return fmt.Errorf("bad aux file spec: %v", kv) } - file, err := parser.ParseFile(p.fileSet, parts[1], nil, 0) + pkg, fpath := parts[0], parts[1] + + file, err := parser.ParseFile(p.fileSet, fpath, nil, 0) if err != nil { return err } p.auxFiles = append(p.auxFiles, file) - p.addAuxInterfacesFromFile(parts[0], file) + p.addAuxInterfacesFromFile(pkg, file) } return nil } @@ -127,8 +145,10 @@ func (p *fileParser) addAuxInterfacesFromFile(pkg string, file *ast.File) { } } -func (p *fileParser) parseFile(file *ast.File) (*model.Package, error) { - allImports := importsOfFile(file) +// parseFile loads all file imports and auxiliary files import into the +// fileParser, parses all file interfaces and returns package model. +func (p *fileParser) parseFile(importPath string, file *ast.File) (*model.Package, error) { + allImports, dotImports := importsOfFile(file) // Don't stomp imports provided by -imports. Those should take precedence. for pkg, path := range allImports { if _, ok := p.imports[pkg]; !ok { @@ -138,7 +158,8 @@ func (p *fileParser) parseFile(file *ast.File) (*model.Package, error) { // Add imports from auxiliary files, which might be needed for embedded interfaces. // Don't stomp any other imports. for _, f := range p.auxFiles { - for pkg, path := range importsOfFile(f) { + auxImports, _ := importsOfFile(f) + for pkg, path := range auxImports { if _, ok := p.imports[pkg]; !ok { p.imports[pkg] = path } @@ -147,7 +168,7 @@ func (p *fileParser) parseFile(file *ast.File) (*model.Package, error) { var is []*model.Interface for ni := range iterInterfaces(file) { - i, err := p.parseInterface(ni.name.String(), "", ni.it) + i, err := p.parseInterface(ni.name.String(), importPath, ni.it) if err != nil { return nil, err } @@ -156,9 +177,37 @@ func (p *fileParser) parseFile(file *ast.File) (*model.Package, error) { return &model.Package{ Name: file.Name.String(), Interfaces: is, + DotImports: dotImports, }, nil } +// parsePackage loads package specified by path, parses it and populates +// corresponding imports and importedInterfaces into the fileParser. +func (p *fileParser) parsePackage(path string) error { + var pkgs map[string]*ast.Package + if imp, err := build.Import(path, p.srcDir, build.FindOnly); err != nil { + return err + } else if pkgs, err = parser.ParseDir(p.fileSet, imp.Dir, nil, 0); err != nil { + return err + } + for _, pkg := range pkgs { + file := ast.MergePackageFiles(pkg, ast.FilterFuncDuplicates|ast.FilterUnassociatedComments|ast.FilterImportDuplicates) + if _, ok := p.importedInterfaces[path]; !ok { + p.importedInterfaces[path] = make(map[string]*ast.InterfaceType) + } + for ni := range iterInterfaces(file) { + p.importedInterfaces[path][ni.name.Name] = ni.it + } + imports, _ := importsOfFile(file) + for pkgName, pkgPath := range imports { + if _, ok := p.imports[pkgName]; !ok { + p.imports[pkgName] = pkgPath + } + } + } + return nil +} + func (p *fileParser) parseInterface(name, pkg string, it *ast.InterfaceType) (*model.Interface, error) { intf := &model.Interface{Name: name} for _, field := range it.Methods.List { @@ -178,9 +227,11 @@ func (p *fileParser) parseInterface(name, pkg string, it *ast.InterfaceType) (*m intf.Methods = append(intf.Methods, m) case *ast.Ident: // Embedded interface in this package. - ei := p.auxInterfaces[""][v.String()] + ei := p.auxInterfaces[pkg][v.String()] if ei == nil { - return nil, p.errorf(v.Pos(), "unknown embedded interface %s", v.String()) + if ei = p.importedInterfaces[pkg][v.String()]; ei == nil { + return nil, p.errorf(v.Pos(), "unknown embedded interface %s", v.String()) + } } eintf, err := p.parseInterface(v.String(), pkg, ei) if err != nil { @@ -194,15 +245,23 @@ func (p *fileParser) parseInterface(name, pkg string, it *ast.InterfaceType) (*m case *ast.SelectorExpr: // Embedded interface in another package. fpkg, sel := v.X.(*ast.Ident).String(), v.Sel.String() - ei := p.auxInterfaces[fpkg][sel] - if ei == nil { - return nil, p.errorf(v.Pos(), "unknown embedded interface %s.%s", fpkg, sel) - } epkg, ok := p.imports[fpkg] if !ok { return nil, p.errorf(v.X.Pos(), "unknown package %s", fpkg) } - eintf, err := p.parseInterface(sel, epkg, ei) + ei := p.auxInterfaces[fpkg][sel] + if ei == nil { + fpkg = epkg + if _, ok = p.importedInterfaces[epkg]; !ok { + if err := p.parsePackage(epkg); err != nil { + return nil, p.errorf(v.Pos(), "could not parse package %s: %v", fpkg, err) + } + } + if ei = p.importedInterfaces[epkg][sel]; ei == nil { + return nil, p.errorf(v.Pos(), "unknown embedded interface %s.%s", fpkg, sel) + } + } + eintf, err := p.parseInterface(sel, fpkg, ei) if err != nil { return nil, err } @@ -319,6 +378,12 @@ func (p *fileParser) parseType(pkg string, typ ast.Expr) (model.Type, error) { return &model.FuncType{In: in, Out: out, Variadic: variadic}, nil case *ast.Ident: if v.IsExported() { + // `pkg` may be an aliased imported pkg + // if so, patch the import w/ the fully qualified import + maybeImportedPkg, ok := p.imports[pkg] + if ok { + pkg = maybeImportedPkg + } // assume type in this package return &model.NamedType{Package: pkg, Type: v.Name}, nil } else { @@ -365,43 +430,43 @@ func (p *fileParser) parseType(pkg string, typ ast.Expr) (model.Type, error) { // importsOfFile returns a map of package name to import path // of the imports in file. -func importsOfFile(file *ast.File) map[string]string { - /* We have to make guesses about some imports, because imports are not required - * to have names. Named imports are always certain. Unnamed imports are guessed - * to have a name of the last path component; if the last path component has dots, - * the first dot-delimited field is used as the name. - */ - - m := make(map[string]string) - for _, decl := range file.Decls { - gd, ok := decl.(*ast.GenDecl) - if !ok || gd.Tok != token.IMPORT { - continue - } - for _, spec := range gd.Specs { - is, ok := spec.(*ast.ImportSpec) - if !ok { +func importsOfFile(file *ast.File) (normalImports map[string]string, dotImports []string) { + normalImports = make(map[string]string) + dotImports = make([]string, 0) + for _, is := range file.Imports { + var pkgName string + importPath := is.Path.Value[1 : len(is.Path.Value)-1] // remove quotes + + if is.Name != nil { + // Named imports are always certain. + if is.Name.Name == "_" { continue } - pkg, importPath := "", string(is.Path.Value) - importPath = importPath[1 : len(importPath)-1] // remove quotes - - if is.Name != nil { - if is.Name.Name == "_" { - continue - } - pkg = removeDot(is.Name.Name) - } else { + pkgName = is.Name.Name + } else { + pkg, err := build.Import(importPath, "", 0) + if err != nil { + // Fallback to import path suffix. Note that this is uncertain. _, last := path.Split(importPath) - pkg = strings.SplitN(last, ".", 2)[0] + // If the last path component has dots, the first dot-delimited + // field is used as the name. + pkgName = strings.SplitN(last, ".", 2)[0] + } else { + pkgName = pkg.Name } - if _, ok := m[pkg]; ok { - log.Fatalf("imported package collision: %q imported twice", pkg) + } + + if pkgName == "." { + dotImports = append(dotImports, importPath) + } else { + + if _, ok := normalImports[pkgName]; ok { + log.Fatalf("imported package collision: %q imported twice", pkgName) } - m[pkg] = importPath + normalImports[pkgName] = importPath } } - return m + return } type namedInterface struct { diff --git a/vendor/github.com/golang/mock/mockgen/parse_test.go b/vendor/github.com/golang/mock/mockgen/parse_test.go new file mode 100644 index 0000000..f18399c --- /dev/null +++ b/vendor/github.com/golang/mock/mockgen/parse_test.go @@ -0,0 +1,108 @@ +package main + +import ( + "go/ast" + "go/parser" + "go/token" + "testing" +) + +func TestFileParser_ParseFile(t *testing.T) { + fs := token.NewFileSet() + file, err := parser.ParseFile(fs, "internal/tests/custom_package_name/greeter/greeter.go", nil, 0) + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + p := fileParser{ + fileSet: fs, + imports: make(map[string]string), + importedInterfaces: make(map[string]map[string]*ast.InterfaceType), + } + + pkg, err := p.parseFile("", file) + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + checkGreeterImports(t, p.imports) + + expectedName := "greeter" + if pkg.Name != expectedName { + t.Fatalf("Expected name to be %v but got %v", expectedName, pkg.Name) + } + + expectedInterfaceName := "InputMaker" + if pkg.Interfaces[0].Name != expectedInterfaceName { + t.Fatalf("Expected interface name to be %v but got %v", expectedInterfaceName, pkg.Interfaces[0].Name) + } +} + +func TestFileParser_ParsePackage(t *testing.T) { + fs := token.NewFileSet() + _, err := parser.ParseFile(fs, "internal/tests/custom_package_name/greeter/greeter.go", nil, 0) + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + p := fileParser{ + fileSet: fs, + imports: make(map[string]string), + importedInterfaces: make(map[string]map[string]*ast.InterfaceType), + } + + err = p.parsePackage("github.com/golang/mock/mockgen/internal/tests/custom_package_name/greeter") + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + checkGreeterImports(t, p.imports) +} + +func TestImportsOfFile(t *testing.T) { + fs := token.NewFileSet() + file, err := parser.ParseFile(fs, "internal/tests/custom_package_name/greeter/greeter.go", nil, 0) + if err != nil { + t.Fatalf("Unexpected error: %v", err) + } + + imports, _ := importsOfFile(file) + checkGreeterImports(t, imports) +} + +func checkGreeterImports(t *testing.T, imports map[string]string) { + // check that imports have stdlib package "fmt" + if fmtPackage, ok := imports["fmt"]; !ok { + t.Errorf("Expected imports to have key \"fmt\"") + } else { + expectedFmtPackage := "fmt" + if fmtPackage != expectedFmtPackage { + t.Errorf("Expected fmt key to have value %s but got %s", expectedFmtPackage, fmtPackage) + } + } + + // check that imports have package named "validator" + if validatorPackage, ok := imports["validator"]; !ok { + t.Errorf("Expected imports to have key \"fmt\"") + } else { + expectedValidatorPackage := "github.com/golang/mock/mockgen/internal/tests/custom_package_name/validator" + if validatorPackage != expectedValidatorPackage { + t.Errorf("Expected validator key to have value %s but got %s", expectedValidatorPackage, validatorPackage) + } + } + + // check that imports have package named "client" + if clientPackage, ok := imports["client"]; !ok { + t.Errorf("Expected imports to have key \"client\"") + } else { + expectedClientPackage := "github.com/golang/mock/mockgen/internal/tests/custom_package_name/client/v1" + if clientPackage != expectedClientPackage { + t.Errorf("Expected client key to have value %s but got %s", expectedClientPackage, clientPackage) + } + } + + // check that imports don't have package named "v1" + if _, ok := imports["v1"]; ok { + t.Errorf("Expected import not to have key \"v1\"") + } +} diff --git a/vendor/github.com/golang/mock/mockgen/reflect.go b/vendor/github.com/golang/mock/mockgen/reflect.go index 4df9689..b80f97f 100644 --- a/vendor/github.com/golang/mock/mockgen/reflect.go +++ b/vendor/github.com/golang/mock/mockgen/reflect.go @@ -20,7 +20,7 @@ import ( "bytes" "encoding/gob" "flag" - "io" + "go/build" "io/ioutil" "os" "os/exec" @@ -32,81 +32,131 @@ import ( ) var ( - progOnly = flag.Bool("prog_only", false, "(reflect mode) Only generate the reflection program; write it to stdout.") + progOnly = flag.Bool("prog_only", false, "(reflect mode) Only generate the reflection program; write it to stdout and exit.") execOnly = flag.String("exec_only", "", "(reflect mode) If set, execute this reflection program.") buildFlags = flag.String("build_flags", "", "(reflect mode) Additional flags for go build.") ) -func Reflect(importPath string, symbols []string) (*model.Package, error) { - // TODO: sanity check arguments - - progPath := *execOnly - if *execOnly == "" { - // We use TempDir instead of TempFile so we can control the filename. - tmpDir, err := ioutil.TempDir("", "gomock_reflect_") - if err != nil { - return nil, err - } - defer func() { os.RemoveAll(tmpDir) }() - const progSource = "prog.go" - var progBinary = "prog.bin" - if runtime.GOOS == "windows" { - // Windows won't execute a program unless it has a ".exe" suffix. - progBinary += ".exe" - } - - // Generate program. - var program bytes.Buffer - data := reflectData{ - ImportPath: importPath, - Symbols: symbols, - } - if err := reflectProgram.Execute(&program, &data); err != nil { - return nil, err - } - if *progOnly { - io.Copy(os.Stdout, &program) - os.Exit(0) - } - if err := ioutil.WriteFile(filepath.Join(tmpDir, progSource), program.Bytes(), 0600); err != nil { - return nil, err - } +func writeProgram(importPath string, symbols []string) ([]byte, error) { + var program bytes.Buffer + data := reflectData{ + ImportPath: importPath, + Symbols: symbols, + } + if err := reflectProgram.Execute(&program, &data); err != nil { + return nil, err + } + return program.Bytes(), nil +} - cmdArgs := []string{} - cmdArgs = append(cmdArgs, "build") - if *buildFlags != "" { - cmdArgs = append(cmdArgs, *buildFlags) - } - cmdArgs = append(cmdArgs, "-o", progBinary, progSource) - - // Build the program. - cmd := exec.Command("go", cmdArgs...) - cmd.Dir = tmpDir - cmd.Stdout = os.Stdout - cmd.Stderr = os.Stderr - if err := cmd.Run(); err != nil { - return nil, err - } - progPath = filepath.Join(tmpDir, progBinary) +// run the given program and parse the output as a model.Package. +func run(program string) (*model.Package, error) { + f, err := ioutil.TempFile("", "") + filename := f.Name() + defer os.Remove(filename) + if err := f.Close(); err != nil { + return nil, err } - // Run it. - cmd := exec.Command(progPath) - var stdout bytes.Buffer - cmd.Stdout = &stdout + // Run the program. + cmd := exec.Command(program, "-output", filename) + cmd.Stdout = os.Stdout cmd.Stderr = os.Stderr if err := cmd.Run(); err != nil { return nil, err } + f, err = os.Open(filename) + if err != nil { + return nil, err + } + // Process output. var pkg model.Package - if err := gob.NewDecoder(&stdout).Decode(&pkg); err != nil { + if err := gob.NewDecoder(f).Decode(&pkg); err != nil { return nil, err } + + if err := f.Close(); err != nil { + return nil, err + } + return &pkg, nil } +// runInDir writes the given program into the given dir, runs it there, and +// parses the output as a model.Package. +func runInDir(program []byte, dir string) (*model.Package, error) { + // We use TempDir instead of TempFile so we can control the filename. + tmpDir, err := ioutil.TempDir(dir, "gomock_reflect_") + if err != nil { + return nil, err + } + defer func() { os.RemoveAll(tmpDir) }() + const progSource = "prog.go" + var progBinary = "prog.bin" + if runtime.GOOS == "windows" { + // Windows won't execute a program unless it has a ".exe" suffix. + progBinary += ".exe" + } + + if err := ioutil.WriteFile(filepath.Join(tmpDir, progSource), program, 0600); err != nil { + return nil, err + } + + cmdArgs := []string{} + cmdArgs = append(cmdArgs, "build") + if *buildFlags != "" { + cmdArgs = append(cmdArgs, *buildFlags) + } + cmdArgs = append(cmdArgs, "-o", progBinary, progSource) + + // Build the program. + cmd := exec.Command("go", cmdArgs...) + cmd.Dir = tmpDir + cmd.Stdout = os.Stdout + cmd.Stderr = os.Stderr + if err := cmd.Run(); err != nil { + return nil, err + } + return run(filepath.Join(tmpDir, progBinary)) +} + +func Reflect(importPath string, symbols []string) (*model.Package, error) { + // TODO: sanity check arguments + + if *execOnly != "" { + return run(*execOnly) + } + + program, err := writeProgram(importPath, symbols) + if err != nil { + return nil, err + } + + if *progOnly { + os.Stdout.Write(program) + os.Exit(0) + } + + wd, _ := os.Getwd() + + // Try to run the program in the same directory as the input package. + if p, err := build.Import(importPath, wd, build.FindOnly); err == nil { + dir := p.Dir + if p, err := runInDir(program, dir); err == nil { + return p, nil + } + } + + // Since that didn't work, try to run it in the current working directory. + if p, err := runInDir(program, wd); err == nil { + return p, nil + } + // Since that didn't work, try to run it in a standard temp directory. + return runInDir(program, "") +} + type reflectData struct { ImportPath string Symbols []string @@ -120,6 +170,7 @@ package main import ( "encoding/gob" + "flag" "fmt" "os" "path" @@ -130,7 +181,11 @@ import ( pkg_ {{printf "%q" .ImportPath}} ) +var output = flag.String("output", "", "The output file name, or empty to use stdout.") + func main() { + flag.Parse() + its := []struct{ sym string typ reflect.Type @@ -155,7 +210,23 @@ func main() { intf.Name = it.sym pkg.Interfaces = append(pkg.Interfaces, intf) } - if err := gob.NewEncoder(os.Stdout).Encode(pkg); err != nil { + + outfile := os.Stdout + if len(*output) != 0 { + var err error + outfile, err = os.Create(*output) + if err != nil { + fmt.Fprintf(os.Stderr, "failed to open output file %q", *output) + } + defer func() { + if err := outfile.Close(); err != nil { + fmt.Fprintf(os.Stderr, "failed to close output file %q", *output) + os.Exit(1) + } + }() + } + + if err := gob.NewEncoder(outfile).Encode(pkg); err != nil { fmt.Fprintf(os.Stderr, "gob encode: %v\n", err) os.Exit(1) } diff --git a/vendor/github.com/golang/mock/sample/README.md b/vendor/github.com/golang/mock/sample/README.md index 7180204..86c6294 100644 --- a/vendor/github.com/golang/mock/sample/README.md +++ b/vendor/github.com/golang/mock/sample/README.md @@ -8,8 +8,8 @@ interface that can be mocked with GoMock. The interesting files are: interfaces from `user.go` are used. This demonstrates how to create mock objects, set up expectations, and so on. - * `mock_user/mock_user.go`: The generated mock code. See ../update_mocks.sh - for the command used to generate it. + * `mock_user/mock_user.go`: The generated mock code. See ../gomock/matchers.go + for the `go:generate` command used to generate it. To run the test, diff --git a/vendor/github.com/golang/mock/sample/concurrent/concurrent.go b/vendor/github.com/golang/mock/sample/concurrent/concurrent.go new file mode 100644 index 0000000..346cee4 --- /dev/null +++ b/vendor/github.com/golang/mock/sample/concurrent/concurrent.go @@ -0,0 +1,8 @@ +//go:generate mockgen -destination mock/concurrent_mock.go github.com/golang/mock/sample/concurrent Math + +// Package concurrent demonstrates how to use gomock with goroutines. +package concurrent + +type Math interface { + Sum(a, b int) int +} diff --git a/vendor/github.com/golang/mock/sample/concurrent/concurrent_test.go b/vendor/github.com/golang/mock/sample/concurrent/concurrent_test.go new file mode 100644 index 0000000..3beebe6 --- /dev/null +++ b/vendor/github.com/golang/mock/sample/concurrent/concurrent_test.go @@ -0,0 +1,46 @@ +package concurrent + +import ( + "testing" + + "context" + "github.com/golang/mock/gomock" + + mock "github.com/golang/mock/sample/concurrent/mock" +) + +func call(ctx context.Context, m Math) (int, error) { + result := make(chan int) + go func() { + result <- m.Sum(1, 2) + close(result) + }() + select { + case r := <-result: + return r, nil + case <-ctx.Done(): + return 0, ctx.Err() + } +} + +// testConcurrentFails is expected to fail (and is disabled). It +// demonstrates how to use gomock.WithContext to interrupt the test +// from a different goroutine. +func testConcurrentFails(t *testing.T) { + ctrl, ctx := gomock.WithContext(context.Background(), t) + defer ctrl.Finish() + m := mock.NewMockMath(ctrl) + if _, err := call(ctx, m); err != nil { + t.Error("call failed:", err) + } +} + +func TestConcurrentWorks(t *testing.T) { + ctrl, ctx := gomock.WithContext(context.Background(), t) + defer ctrl.Finish() + m := mock.NewMockMath(ctrl) + m.EXPECT().Sum(1, 2).Return(3) + if _, err := call(ctx, m); err != nil { + t.Error("call failed:", err) + } +} diff --git a/vendor/github.com/golang/mock/sample/concurrent/mock/concurrent_mock.go b/vendor/github.com/golang/mock/sample/concurrent/mock/concurrent_mock.go new file mode 100644 index 0000000..57b079d --- /dev/null +++ b/vendor/github.com/golang/mock/sample/concurrent/mock/concurrent_mock.go @@ -0,0 +1,47 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: github.com/golang/mock/sample/concurrent (interfaces: Math) + +// Package mock_concurrent is a generated GoMock package. +package mock_concurrent + +import ( + gomock "github.com/golang/mock/gomock" + reflect "reflect" +) + +// MockMath is a mock of Math interface +type MockMath struct { + ctrl *gomock.Controller + recorder *MockMathMockRecorder +} + +// MockMathMockRecorder is the mock recorder for MockMath +type MockMathMockRecorder struct { + mock *MockMath +} + +// NewMockMath creates a new mock instance +func NewMockMath(ctrl *gomock.Controller) *MockMath { + mock := &MockMath{ctrl: ctrl} + mock.recorder = &MockMathMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use +func (m *MockMath) EXPECT() *MockMathMockRecorder { + return m.recorder +} + +// Sum mocks base method +func (m *MockMath) Sum(arg0, arg1 int) int { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Sum", arg0, arg1) + ret0, _ := ret[0].(int) + return ret0 +} + +// Sum indicates an expected call of Sum +func (mr *MockMathMockRecorder) Sum(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Sum", reflect.TypeOf((*MockMath)(nil).Sum), arg0, arg1) +} diff --git a/vendor/github.com/golang/mock/sample/mock_user/mock_user.go b/vendor/github.com/golang/mock/sample/mock_user/mock_user.go index 59602ef..4cf24bb 100644 --- a/vendor/github.com/golang/mock/sample/mock_user/mock_user.go +++ b/vendor/github.com/golang/mock/sample/mock_user/mock_user.go @@ -1,6 +1,7 @@ // Code generated by MockGen. DO NOT EDIT. // Source: github.com/golang/mock/sample (interfaces: Index,Embed,Embedded) +// Package mock_sample is a generated GoMock package. package mock_sample import ( @@ -38,250 +39,294 @@ func NewMockIndex(ctrl *gomock.Controller) *MockIndex { } // EXPECT returns an object that allows the caller to indicate expected use -func (_m *MockIndex) EXPECT() *MockIndexMockRecorder { - return _m.recorder +func (m *MockIndex) EXPECT() *MockIndexMockRecorder { + return m.recorder } // Anon mocks base method -func (_m *MockIndex) Anon(_param0 string) { - _m.ctrl.Call(_m, "Anon", _param0) +func (m *MockIndex) Anon(arg0 string) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Anon", arg0) } // Anon indicates an expected call of Anon -func (_mr *MockIndexMockRecorder) Anon(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Anon", reflect.TypeOf((*MockIndex)(nil).Anon), arg0) +func (mr *MockIndexMockRecorder) Anon(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Anon", reflect.TypeOf((*MockIndex)(nil).Anon), arg0) } // Chan mocks base method -func (_m *MockIndex) Chan(_param0 chan int, _param1 chan<- hash.Hash) { - _m.ctrl.Call(_m, "Chan", _param0, _param1) +func (m *MockIndex) Chan(arg0 chan int, arg1 chan<- hash.Hash) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Chan", arg0, arg1) } // Chan indicates an expected call of Chan -func (_mr *MockIndexMockRecorder) Chan(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Chan", reflect.TypeOf((*MockIndex)(nil).Chan), arg0, arg1) +func (mr *MockIndexMockRecorder) Chan(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Chan", reflect.TypeOf((*MockIndex)(nil).Chan), arg0, arg1) } // ConcreteRet mocks base method -func (_m *MockIndex) ConcreteRet() chan<- bool { - ret := _m.ctrl.Call(_m, "ConcreteRet") +func (m *MockIndex) ConcreteRet() chan<- bool { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "ConcreteRet") ret0, _ := ret[0].(chan<- bool) return ret0 } // ConcreteRet indicates an expected call of ConcreteRet -func (_mr *MockIndexMockRecorder) ConcreteRet() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ConcreteRet", reflect.TypeOf((*MockIndex)(nil).ConcreteRet)) +func (mr *MockIndexMockRecorder) ConcreteRet() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ConcreteRet", reflect.TypeOf((*MockIndex)(nil).ConcreteRet)) } // Ellip mocks base method -func (_m *MockIndex) Ellip(_param0 string, _param1 ...interface{}) { - _s := []interface{}{_param0} - for _, _x := range _param1 { - _s = append(_s, _x) +func (m *MockIndex) Ellip(arg0 string, arg1 ...interface{}) { + m.ctrl.T.Helper() + varargs := []interface{}{arg0} + for _, a := range arg1 { + varargs = append(varargs, a) } - _m.ctrl.Call(_m, "Ellip", _s...) + m.ctrl.Call(m, "Ellip", varargs...) } // Ellip indicates an expected call of Ellip -func (_mr *MockIndexMockRecorder) Ellip(arg0 interface{}, arg1 ...interface{}) *gomock.Call { - _s := append([]interface{}{arg0}, arg1...) - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Ellip", reflect.TypeOf((*MockIndex)(nil).Ellip), _s...) +func (mr *MockIndexMockRecorder) Ellip(arg0 interface{}, arg1 ...interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]interface{}{arg0}, arg1...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Ellip", reflect.TypeOf((*MockIndex)(nil).Ellip), varargs...) } // EllipOnly mocks base method -func (_m *MockIndex) EllipOnly(_param0 ...string) { - _s := []interface{}{} - for _, _x := range _param0 { - _s = append(_s, _x) +func (m *MockIndex) EllipOnly(arg0 ...string) { + m.ctrl.T.Helper() + varargs := []interface{}{} + for _, a := range arg0 { + varargs = append(varargs, a) } - _m.ctrl.Call(_m, "EllipOnly", _s...) + m.ctrl.Call(m, "EllipOnly", varargs...) } // EllipOnly indicates an expected call of EllipOnly -func (_mr *MockIndexMockRecorder) EllipOnly(arg0 ...interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "EllipOnly", reflect.TypeOf((*MockIndex)(nil).EllipOnly), arg0...) +func (mr *MockIndexMockRecorder) EllipOnly(arg0 ...interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "EllipOnly", reflect.TypeOf((*MockIndex)(nil).EllipOnly), arg0...) } // ForeignFour mocks base method -func (_m *MockIndex) ForeignFour(_param0 imp4.Imp4) { - _m.ctrl.Call(_m, "ForeignFour", _param0) +func (m *MockIndex) ForeignFour(arg0 imp4.Imp4) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "ForeignFour", arg0) } // ForeignFour indicates an expected call of ForeignFour -func (_mr *MockIndexMockRecorder) ForeignFour(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ForeignFour", reflect.TypeOf((*MockIndex)(nil).ForeignFour), arg0) +func (mr *MockIndexMockRecorder) ForeignFour(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ForeignFour", reflect.TypeOf((*MockIndex)(nil).ForeignFour), arg0) } // ForeignOne mocks base method -func (_m *MockIndex) ForeignOne(_param0 imp1.Imp1) { - _m.ctrl.Call(_m, "ForeignOne", _param0) +func (m *MockIndex) ForeignOne(arg0 imp1.Imp1) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "ForeignOne", arg0) } // ForeignOne indicates an expected call of ForeignOne -func (_mr *MockIndexMockRecorder) ForeignOne(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ForeignOne", reflect.TypeOf((*MockIndex)(nil).ForeignOne), arg0) +func (mr *MockIndexMockRecorder) ForeignOne(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ForeignOne", reflect.TypeOf((*MockIndex)(nil).ForeignOne), arg0) } // ForeignThree mocks base method -func (_m *MockIndex) ForeignThree(_param0 imp3.Imp3) { - _m.ctrl.Call(_m, "ForeignThree", _param0) +func (m *MockIndex) ForeignThree(arg0 imp3.Imp3) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "ForeignThree", arg0) } // ForeignThree indicates an expected call of ForeignThree -func (_mr *MockIndexMockRecorder) ForeignThree(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ForeignThree", reflect.TypeOf((*MockIndex)(nil).ForeignThree), arg0) +func (mr *MockIndexMockRecorder) ForeignThree(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ForeignThree", reflect.TypeOf((*MockIndex)(nil).ForeignThree), arg0) } // ForeignTwo mocks base method -func (_m *MockIndex) ForeignTwo(_param0 imp2.Imp2) { - _m.ctrl.Call(_m, "ForeignTwo", _param0) +func (m *MockIndex) ForeignTwo(arg0 imp2.Imp2) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "ForeignTwo", arg0) } // ForeignTwo indicates an expected call of ForeignTwo -func (_mr *MockIndexMockRecorder) ForeignTwo(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ForeignTwo", reflect.TypeOf((*MockIndex)(nil).ForeignTwo), arg0) +func (mr *MockIndexMockRecorder) ForeignTwo(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ForeignTwo", reflect.TypeOf((*MockIndex)(nil).ForeignTwo), arg0) } // Func mocks base method -func (_m *MockIndex) Func(_param0 func(http.Request) (int, bool)) { - _m.ctrl.Call(_m, "Func", _param0) +func (m *MockIndex) Func(arg0 func(http.Request) (int, bool)) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Func", arg0) } // Func indicates an expected call of Func -func (_mr *MockIndexMockRecorder) Func(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Func", reflect.TypeOf((*MockIndex)(nil).Func), arg0) +func (mr *MockIndexMockRecorder) Func(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Func", reflect.TypeOf((*MockIndex)(nil).Func), arg0) } // Get mocks base method -func (_m *MockIndex) Get(_param0 string) interface{} { - ret := _m.ctrl.Call(_m, "Get", _param0) +func (m *MockIndex) Get(arg0 string) interface{} { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Get", arg0) ret0, _ := ret[0].(interface{}) return ret0 } // Get indicates an expected call of Get -func (_mr *MockIndexMockRecorder) Get(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Get", reflect.TypeOf((*MockIndex)(nil).Get), arg0) +func (mr *MockIndexMockRecorder) Get(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Get", reflect.TypeOf((*MockIndex)(nil).Get), arg0) } // GetTwo mocks base method -func (_m *MockIndex) GetTwo(_param0 string, _param1 string) (interface{}, interface{}) { - ret := _m.ctrl.Call(_m, "GetTwo", _param0, _param1) +func (m *MockIndex) GetTwo(arg0, arg1 string) (interface{}, interface{}) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "GetTwo", arg0, arg1) ret0, _ := ret[0].(interface{}) ret1, _ := ret[1].(interface{}) return ret0, ret1 } // GetTwo indicates an expected call of GetTwo -func (_mr *MockIndexMockRecorder) GetTwo(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "GetTwo", reflect.TypeOf((*MockIndex)(nil).GetTwo), arg0, arg1) +func (mr *MockIndexMockRecorder) GetTwo(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "GetTwo", reflect.TypeOf((*MockIndex)(nil).GetTwo), arg0, arg1) } // Map mocks base method -func (_m *MockIndex) Map(_param0 map[int]hash.Hash) { - _m.ctrl.Call(_m, "Map", _param0) +func (m *MockIndex) Map(arg0 map[int]hash.Hash) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Map", arg0) } // Map indicates an expected call of Map -func (_mr *MockIndexMockRecorder) Map(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Map", reflect.TypeOf((*MockIndex)(nil).Map), arg0) +func (mr *MockIndexMockRecorder) Map(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Map", reflect.TypeOf((*MockIndex)(nil).Map), arg0) } // NillableRet mocks base method -func (_m *MockIndex) NillableRet() error { - ret := _m.ctrl.Call(_m, "NillableRet") +func (m *MockIndex) NillableRet() error { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "NillableRet") ret0, _ := ret[0].(error) return ret0 } // NillableRet indicates an expected call of NillableRet -func (_mr *MockIndexMockRecorder) NillableRet() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "NillableRet", reflect.TypeOf((*MockIndex)(nil).NillableRet)) +func (mr *MockIndexMockRecorder) NillableRet() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "NillableRet", reflect.TypeOf((*MockIndex)(nil).NillableRet)) } // Other mocks base method -func (_m *MockIndex) Other() hash.Hash { - ret := _m.ctrl.Call(_m, "Other") +func (m *MockIndex) Other() hash.Hash { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Other") ret0, _ := ret[0].(hash.Hash) return ret0 } // Other indicates an expected call of Other -func (_mr *MockIndexMockRecorder) Other() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Other", reflect.TypeOf((*MockIndex)(nil).Other)) +func (mr *MockIndexMockRecorder) Other() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Other", reflect.TypeOf((*MockIndex)(nil).Other)) } // Ptr mocks base method -func (_m *MockIndex) Ptr(_param0 *int) { - _m.ctrl.Call(_m, "Ptr", _param0) +func (m *MockIndex) Ptr(arg0 *int) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Ptr", arg0) } // Ptr indicates an expected call of Ptr -func (_mr *MockIndexMockRecorder) Ptr(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Ptr", reflect.TypeOf((*MockIndex)(nil).Ptr), arg0) +func (mr *MockIndexMockRecorder) Ptr(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Ptr", reflect.TypeOf((*MockIndex)(nil).Ptr), arg0) } // Put mocks base method -func (_m *MockIndex) Put(_param0 string, _param1 interface{}) { - _m.ctrl.Call(_m, "Put", _param0, _param1) +func (m *MockIndex) Put(arg0 string, arg1 interface{}) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Put", arg0, arg1) } // Put indicates an expected call of Put -func (_mr *MockIndexMockRecorder) Put(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Put", reflect.TypeOf((*MockIndex)(nil).Put), arg0, arg1) +func (mr *MockIndexMockRecorder) Put(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Put", reflect.TypeOf((*MockIndex)(nil).Put), arg0, arg1) } // Slice mocks base method -func (_m *MockIndex) Slice(_param0 []int, _param1 []byte) [3]int { - ret := _m.ctrl.Call(_m, "Slice", _param0, _param1) +func (m *MockIndex) Slice(arg0 []int, arg1 []byte) [3]int { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Slice", arg0, arg1) ret0, _ := ret[0].([3]int) return ret0 } // Slice indicates an expected call of Slice -func (_mr *MockIndexMockRecorder) Slice(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Slice", reflect.TypeOf((*MockIndex)(nil).Slice), arg0, arg1) +func (mr *MockIndexMockRecorder) Slice(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Slice", reflect.TypeOf((*MockIndex)(nil).Slice), arg0, arg1) } // Struct mocks base method -func (_m *MockIndex) Struct(_param0 struct{}) { - _m.ctrl.Call(_m, "Struct", _param0) +func (m *MockIndex) Struct(arg0 struct{}) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Struct", arg0) } // Struct indicates an expected call of Struct -func (_mr *MockIndexMockRecorder) Struct(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Struct", reflect.TypeOf((*MockIndex)(nil).Struct), arg0) +func (mr *MockIndexMockRecorder) Struct(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Struct", reflect.TypeOf((*MockIndex)(nil).Struct), arg0) } // StructChan mocks base method -func (_m *MockIndex) StructChan(_param0 chan struct{}) { - _m.ctrl.Call(_m, "StructChan", _param0) +func (m *MockIndex) StructChan(arg0 chan struct{}) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "StructChan", arg0) } // StructChan indicates an expected call of StructChan -func (_mr *MockIndexMockRecorder) StructChan(arg0 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "StructChan", reflect.TypeOf((*MockIndex)(nil).StructChan), arg0) +func (mr *MockIndexMockRecorder) StructChan(arg0 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "StructChan", reflect.TypeOf((*MockIndex)(nil).StructChan), arg0) } // Summary mocks base method -func (_m *MockIndex) Summary(_param0 *bytes.Buffer, _param1 io.Writer) { - _m.ctrl.Call(_m, "Summary", _param0, _param1) +func (m *MockIndex) Summary(arg0 *bytes.Buffer, arg1 io.Writer) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Summary", arg0, arg1) } // Summary indicates an expected call of Summary -func (_mr *MockIndexMockRecorder) Summary(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Summary", reflect.TypeOf((*MockIndex)(nil).Summary), arg0, arg1) +func (mr *MockIndexMockRecorder) Summary(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Summary", reflect.TypeOf((*MockIndex)(nil).Summary), arg0, arg1) } // Templates mocks base method -func (_m *MockIndex) Templates(_param0 template.CSS, _param1 template0.FuncMap) { - _m.ctrl.Call(_m, "Templates", _param0, _param1) +func (m *MockIndex) Templates(arg0 template.CSS, arg1 template0.FuncMap) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Templates", arg0, arg1) } // Templates indicates an expected call of Templates -func (_mr *MockIndexMockRecorder) Templates(arg0, arg1 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "Templates", reflect.TypeOf((*MockIndex)(nil).Templates), arg0, arg1) +func (mr *MockIndexMockRecorder) Templates(arg0, arg1 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Templates", reflect.TypeOf((*MockIndex)(nil).Templates), arg0, arg1) } // MockEmbed is a mock of Embed interface @@ -303,50 +348,58 @@ func NewMockEmbed(ctrl *gomock.Controller) *MockEmbed { } // EXPECT returns an object that allows the caller to indicate expected use -func (_m *MockEmbed) EXPECT() *MockEmbedMockRecorder { - return _m.recorder +func (m *MockEmbed) EXPECT() *MockEmbedMockRecorder { + return m.recorder } // EmbeddedMethod mocks base method -func (_m *MockEmbed) EmbeddedMethod() { - _m.ctrl.Call(_m, "EmbeddedMethod") +func (m *MockEmbed) EmbeddedMethod() { + m.ctrl.T.Helper() + m.ctrl.Call(m, "EmbeddedMethod") } // EmbeddedMethod indicates an expected call of EmbeddedMethod -func (_mr *MockEmbedMockRecorder) EmbeddedMethod() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "EmbeddedMethod", reflect.TypeOf((*MockEmbed)(nil).EmbeddedMethod)) +func (mr *MockEmbedMockRecorder) EmbeddedMethod() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "EmbeddedMethod", reflect.TypeOf((*MockEmbed)(nil).EmbeddedMethod)) } // ForeignEmbeddedMethod mocks base method -func (_m *MockEmbed) ForeignEmbeddedMethod() *bufio.Reader { - ret := _m.ctrl.Call(_m, "ForeignEmbeddedMethod") +func (m *MockEmbed) ForeignEmbeddedMethod() *bufio.Reader { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "ForeignEmbeddedMethod") ret0, _ := ret[0].(*bufio.Reader) return ret0 } // ForeignEmbeddedMethod indicates an expected call of ForeignEmbeddedMethod -func (_mr *MockEmbedMockRecorder) ForeignEmbeddedMethod() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ForeignEmbeddedMethod", reflect.TypeOf((*MockEmbed)(nil).ForeignEmbeddedMethod)) +func (mr *MockEmbedMockRecorder) ForeignEmbeddedMethod() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ForeignEmbeddedMethod", reflect.TypeOf((*MockEmbed)(nil).ForeignEmbeddedMethod)) } // ImplicitPackage mocks base method -func (_m *MockEmbed) ImplicitPackage(_param0 string, _param1 imp1.ImpT, _param2 []imp1.ImpT, _param3 *imp1.ImpT, _param4 chan imp1.ImpT) { - _m.ctrl.Call(_m, "ImplicitPackage", _param0, _param1, _param2, _param3, _param4) +func (m *MockEmbed) ImplicitPackage(arg0 string, arg1 imp1.ImpT, arg2 []imp1.ImpT, arg3 *imp1.ImpT, arg4 chan imp1.ImpT) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "ImplicitPackage", arg0, arg1, arg2, arg3, arg4) } // ImplicitPackage indicates an expected call of ImplicitPackage -func (_mr *MockEmbedMockRecorder) ImplicitPackage(arg0, arg1, arg2, arg3, arg4 interface{}) *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "ImplicitPackage", reflect.TypeOf((*MockEmbed)(nil).ImplicitPackage), arg0, arg1, arg2, arg3, arg4) +func (mr *MockEmbedMockRecorder) ImplicitPackage(arg0, arg1, arg2, arg3, arg4 interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ImplicitPackage", reflect.TypeOf((*MockEmbed)(nil).ImplicitPackage), arg0, arg1, arg2, arg3, arg4) } // RegularMethod mocks base method -func (_m *MockEmbed) RegularMethod() { - _m.ctrl.Call(_m, "RegularMethod") +func (m *MockEmbed) RegularMethod() { + m.ctrl.T.Helper() + m.ctrl.Call(m, "RegularMethod") } // RegularMethod indicates an expected call of RegularMethod -func (_mr *MockEmbedMockRecorder) RegularMethod() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "RegularMethod", reflect.TypeOf((*MockEmbed)(nil).RegularMethod)) +func (mr *MockEmbedMockRecorder) RegularMethod() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "RegularMethod", reflect.TypeOf((*MockEmbed)(nil).RegularMethod)) } // MockEmbedded is a mock of Embedded interface @@ -368,16 +421,18 @@ func NewMockEmbedded(ctrl *gomock.Controller) *MockEmbedded { } // EXPECT returns an object that allows the caller to indicate expected use -func (_m *MockEmbedded) EXPECT() *MockEmbeddedMockRecorder { - return _m.recorder +func (m *MockEmbedded) EXPECT() *MockEmbeddedMockRecorder { + return m.recorder } // EmbeddedMethod mocks base method -func (_m *MockEmbedded) EmbeddedMethod() { - _m.ctrl.Call(_m, "EmbeddedMethod") +func (m *MockEmbedded) EmbeddedMethod() { + m.ctrl.T.Helper() + m.ctrl.Call(m, "EmbeddedMethod") } // EmbeddedMethod indicates an expected call of EmbeddedMethod -func (_mr *MockEmbeddedMockRecorder) EmbeddedMethod() *gomock.Call { - return _mr.mock.ctrl.RecordCallWithMethodType(_mr.mock, "EmbeddedMethod", reflect.TypeOf((*MockEmbedded)(nil).EmbeddedMethod)) +func (mr *MockEmbeddedMockRecorder) EmbeddedMethod() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "EmbeddedMethod", reflect.TypeOf((*MockEmbedded)(nil).EmbeddedMethod)) } diff --git a/vendor/github.com/golang/mock/sample/user_test.go b/vendor/github.com/golang/mock/sample/user_test.go index c8c3864..d1de99c 100644 --- a/vendor/github.com/golang/mock/sample/user_test.go +++ b/vendor/github.com/golang/mock/sample/user_test.go @@ -68,18 +68,57 @@ func TestVariadicFunction(t *testing.T) { defer ctrl.Finish() mockIndex := mock_user.NewMockIndex(ctrl) - m := mockIndex.EXPECT().Ellip("%d", 0, 1, 1, 2, 3) - m.Do(func(format string, nums ...int) { + mockIndex.EXPECT().Ellip("%d", 5, 6, 7, 8).Do(func(format string, nums ...int) { sum := 0 for _, value := range nums { sum += value } - if sum != 7 { + if sum != 26 { t.Errorf("Expected 7, got %d", sum) } }) + mockIndex.EXPECT().Ellip("%d", gomock.Any()).Do(func(format string, nums ...int) { + sum := 0 + for _, value := range nums { + sum += value + } + if sum != 10 { + t.Errorf("Expected 7, got %d", sum) + } + }) + mockIndex.EXPECT().Ellip("%d", gomock.Any()).Do(func(format string, nums ...int) { + sum := 0 + for _, value := range nums { + sum += value + } + if sum != 0 { + t.Errorf("Expected 0, got %d", sum) + } + }) + mockIndex.EXPECT().Ellip("%d", gomock.Any()).Do(func(format string, nums ...int) { + sum := 0 + for _, value := range nums { + sum += value + } + if sum != 0 { + t.Errorf("Expected 0, got %d", sum) + } + }) + mockIndex.EXPECT().Ellip("%d").Do(func(format string, nums ...int) { + sum := 0 + for _, value := range nums { + sum += value + } + if sum != 0 { + t.Errorf("Expected 0, got %d", sum) + } + }) - mockIndex.Ellip("%d", 0, 1, 1, 2, 3) + mockIndex.Ellip("%d", 1, 2, 3, 4) // Match second matcher. + mockIndex.Ellip("%d", 5, 6, 7, 8) // Match first matcher. + mockIndex.Ellip("%d", 0) + mockIndex.Ellip("%d") + mockIndex.Ellip("%d") } func TestGrabPointer(t *testing.T) { diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/.editorconfig b/vendor/github.com/mmatczuk/go-http-tunnel/.editorconfig new file mode 100644 index 0000000..9f86f62 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/.editorconfig @@ -0,0 +1,14 @@ +; http://editorconfig.org/ + +root = true + +[*] +end_of_line = lf +insert_final_newline = true +charset = utf-8 +trim_trailing_whitespace = true + +[*.go] +indent_style = tab +indent_size = 8 + diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/.gitignore b/vendor/github.com/mmatczuk/go-http-tunnel/.gitignore new file mode 100644 index 0000000..ae5c0cb --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/.gitignore @@ -0,0 +1,24 @@ +### Tunnel +.tunnel/ +build/ + +### Go +*.cov +*.prof +*.mprof + +### IntelliJ +.idea/ +*.iml + +### Vim +# swap +[._]*.s[a-w][a-z] +[._]s[a-w][a-z] +# session +Session.vim +# temporary +.netrwhist +*~ +# auto-generated tag files +tags diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/.travis.yml b/vendor/github.com/mmatczuk/go-http-tunnel/.travis.yml new file mode 100644 index 0000000..fd086e3 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/.travis.yml @@ -0,0 +1,15 @@ +language: go +go: + - 1.x + +addons: + apt: + packages: + - moreutils + +install: + - make get-tools + - make get-deps + +script: + - make diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.lock b/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.lock new file mode 100644 index 0000000..9fa3f64 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.lock @@ -0,0 +1,51 @@ +# This file is autogenerated, do not edit; changes may be undone by the next 'dep ensure'. + + +[[projects]] + name = "github.com/calmh/luhn" + packages = ["."] + revision = "5b2abb343e70180dbf456397c5fd93f14471b08e" + version = "v2.0.0" + +[[projects]] + name = "github.com/cenkalti/backoff" + packages = ["."] + revision = "61153c768f31ee5f130071d08fc82b85208528de" + version = "v1.1.0" + +[[projects]] + branch = "master" + name = "github.com/felixge/tcpkeepalive" + packages = ["."] + revision = "5bb0b2dea91e0de550022159b9571aafc72c08ba" + +[[projects]] + name = "github.com/golang/mock" + packages = ["gomock"] + revision = "13f360950a79f5864a972c786a10a50e44b69541" + version = "v1.0.0" + +[[projects]] + branch = "master" + name = "golang.org/x/net" + packages = ["context","http2","http2/hpack","idna","lex/httplex"] + revision = "c7086645de248775cbf2373cf5ca4d2fa664b8c1" + +[[projects]] + branch = "master" + name = "golang.org/x/text" + packages = ["collate","collate/build","internal/colltab","internal/gen","internal/tag","internal/triegen","internal/ucd","language","secure/bidirule","transform","unicode/bidi","unicode/cldr","unicode/norm","unicode/rangetable"] + revision = "88f656faf3f37f690df1a32515b479415e1a6769" + +[[projects]] + branch = "v2" + name = "gopkg.in/yaml.v2" + packages = ["."] + revision = "287cf08546ab5e7e37d55a84f7ed3fd1db036de5" + +[solve-meta] + analyzer-name = "dep" + analyzer-version = 1 + inputs-digest = "654fea302b8b5a71ce4f36f4097d0c0caa8150e46109cfbdd462adcd054a6768" + solver-name = "gps-cdcl" + solver-version = 1 diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.toml b/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.toml new file mode 100644 index 0000000..85ee676 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/Gopkg.toml @@ -0,0 +1,50 @@ + +# Gopkg.toml example +# +# Refer to https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md +# for detailed Gopkg.toml documentation. +# +# required = ["github.com/user/thing/cmd/thing"] +# ignored = ["github.com/user/project/pkgX", "bitbucket.org/user/project/pkgA/pkgY"] +# +# [[constraint]] +# name = "github.com/user/project" +# version = "1.0.0" +# +# [[constraint]] +# name = "github.com/user/project2" +# branch = "dev" +# source = "github.com/myfork/project2" +# +# [[override]] +# name = "github.com/x/y" +# version = "2.4.0" + + +[[constraint]] + name = "github.com/calmh/luhn" + version = "2.0.0" + +[[constraint]] + name = "github.com/cenkalti/backoff" + version = "1.1.0" + +[[constraint]] + name = "github.com/golang/mock" + version = "1.0.0" + +[[constraint]] + name = "github.com/google/gops" + version = "0.3.2" + +[[constraint]] + branch = "master" + name = "golang.org/x/net" + +[[constraint]] + branch = "v2" + name = "gopkg.in/yaml.v2" + +[[constraint]] + branch = "master" + name = "github.com/felixge/tcpkeepalive" diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/LICENSE b/vendor/github.com/mmatczuk/go-http-tunnel/LICENSE new file mode 100644 index 0000000..dba13ed --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/LICENSE @@ -0,0 +1,661 @@ + GNU AFFERO GENERAL PUBLIC LICENSE + Version 3, 19 November 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU Affero General Public License is a free, copyleft license for +software and other kinds of works, specifically designed to ensure +cooperation with the community in the case of network server software. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +our General Public Licenses are intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + Developers that use our General Public Licenses protect your rights +with two steps: (1) assert copyright on the software, and (2) offer +you this License which gives you legal permission to copy, distribute +and/or modify the software. + + A secondary benefit of defending all users' freedom is that +improvements made in alternate versions of the program, if they +receive widespread use, become available for other developers to +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of +software used on network servers, this result may fail to come about. +The GNU General Public License permits making a modified version and +letting the public access it on a server without ever releasing its +source code to the public. + + The GNU Affero General Public License is designed specifically to +ensure that, in such cases, the modified source code becomes available +to the community. It requires the operator of a network server to +provide the source code of the modified version running there to the +users of that server. Therefore, public use of a modified version, on +a publicly accessible server, gives the public access to the source +code of the modified version. + + An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is +a different license, not a version of the Affero GPL, but Affero has +released a new version of the Affero GPL which permits relicensing under +this license. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU Affero General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Remote Network Interaction; Use with the GNU General Public License. + + Notwithstanding any other provision of this License, if you modify the +Program, your modified version must prominently offer all users +interacting with it remotely through a computer network (if your version +supports such interaction) an opportunity to receive the Corresponding +Source of your version by providing access to the Corresponding Source +from a network server at no charge, through some standard or customary +means of facilitating copying of software. This Corresponding Source +shall include the Corresponding Source for any work covered by version 3 +of the GNU General Public License that is incorporated pursuant to the +following paragraph. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU Affero General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU Affero General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU Affero General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU Affero General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If your software can interact with users remotely through a computer +network, you should also make sure that it provides a way for users to +get its source. For example, if your program is a web application, its +interface could display a "Source" link that leads users to an archive +of the code. There are many ways you could offer source, and different +solutions will be better for different programs; see section 13 for the +specific requirements. + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU AGPL, see +. diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/Makefile b/vendor/github.com/mmatczuk/go-http-tunnel/Makefile new file mode 100644 index 0000000..277e25e --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/Makefile @@ -0,0 +1,92 @@ +all: clean check test + +.PHONY: clean +clean: + @go clean -r + +.PHONY: fmt +fmt: + @go fmt ./... + +.PHONY: check +check: .check-fmt .check-vet .check-lint .check-ineffassign .check-mega .check-misspell .check-vendor + +.PHONY: .check-fmt +.check-fmt: + @go fmt ./... | tee /dev/stderr | ifne false + +.PHONY: .check-vet +.check-vet: + @go vet ./... + +.PHONY: .check-lint +.check-lint: + @golint `go list ./...` \ + | grep -v /id/ \ + | grep -v /tunnelmock/ \ + | tee /dev/stderr | ifne false + +.PHONY: .check-ineffassign +.check-ineffassign: + @ineffassign ./ + +.PHONY: .check-misspell +.check-misspell: + @misspell ./... + +.PHONY: .check-mega +.check-mega: + @megacheck ./... + +.PHONY: .check-vendor +.check-vendor: + @dep ensure -no-vendor -dry-run + +.PHONY: test +test: + @echo "==> Running tests (race)..." + @go test -cover -race ./... + +.PHONY: get-deps +get-deps: + @echo "==> Installing dependencies..." + @dep ensure + +.PHONY: get-tools +get-tools: + @echo "==> Installing tools..." + @go get -u github.com/golang/dep/cmd/dep + @go get -u github.com/golang/lint/golint + @go get -u github.com/golang/mock/gomock + + @go get -u github.com/client9/misspell/cmd/misspell + @go get -u github.com/gordonklaus/ineffassign + @go get -u github.com/mitchellh/gox + @go get -u github.com/tcnksm/ghr + @go get -u honnef.co/go/tools/cmd/megacheck + +#OUTPUT_DIR = build +#OS = "darwin freebsd linux windows" +#ARCH = "386 amd64 arm" +#OSARCH = "!darwin/386 !darwin/arm !windows/arm" +#GIT_COMMIT = $(shell git describe --always) +# +#.PHONY: release +#release: check test clean build package +# +#.PHONY: build +#build: +# mkdir ${OUTPUT_DIR} +# CGO_ENABLED=0 GOARM=5 gox -ldflags "-w -X main.version=$(GIT_COMMIT)" \ +# -os=${OS} -arch=${ARCH} -osarch=${OSARCH} -output "${OUTPUT_DIR}/pkg/{{.OS}}_{{.Arch}}/{{.Dir}}" \ +# ./cmd/tunnel ./cmd/tunneld +# +#.PHONY: package +#package: +# mkdir ${OUTPUT_DIR}/dist +# cd ${OUTPUT_DIR}/pkg/; for osarch in *; do (cd $$osarch; tar zcvf ../../dist/tunnel_$$osarch.tar.gz ./*); done; +# cd ${OUTPUT_DIR}/dist; sha256sum * > ./SHA256SUMS +# +#.PHONY: publish +#publish: +# ghr -recreate -u mmatczuk -t ${GITHUB_TOKEN} -r go-http-tunnel pre-release ${OUTPUT_DIR}/dist diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/README.md b/vendor/github.com/mmatczuk/go-http-tunnel/README.md new file mode 100644 index 0000000..3ce376b --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/README.md @@ -0,0 +1,130 @@ +# Go HTTP tunnel [![GoDoc](http://img.shields.io/badge/go-documentation-blue.svg)](http://godoc.org/github.com/mmatczuk/go-http-tunnel) [![Go Report Card](https://goreportcard.com/badge/github.com/mmatczuk/go-http-tunnel)](https://goreportcard.com/report/github.com/mmatczuk/go-http-tunnel) [![Build Status](http://img.shields.io/travis/mmatczuk/go-http-tunnel.svg?branch=master)](https://travis-ci.org/mmatczuk/go-http-tunnel) [![Github All Releases](https://img.shields.io/github/downloads/mmatczuk/go-http-tunnel/total.svg)](https://github.com/mmatczuk/go-http-tunnel/releases) + +Go HTTP tunnel is a reverse tunnel based on HTTP/2. It enables you to share your localhost when you don't have a public IP. + +Features: + +* HTTP proxy with [basic authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) +* TCP proxy +* Client auto reconnect +* Client management and eviction +* Easy to use CLI + +Common use cases: + +* Hosting a game server from home +* Developing webhook integrations +* Managing IoT devices + +## Installation + +Build the latest version. + +```bash +$ go get -u github.com/mmatczuk/go-http-tunnel/cmd/... +``` + +Alternatively [download the latest release](https://github.com/mmatczuk/go-http-tunnel/releases/latest). + +## Running + +There are two executables: + +* `tunneld` - the tunnel server, to be run on publicly available host like AWS or GCE +* `tunnel` - the tunnel client, to be run on your local machine or in your private network + +To get help on the command parameters run `tunneld -h` or `tunnel -h`. + +Tunnel requires TLS certificates for both client and server. + +```bash +$ openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout client.key -out client.crt +$ openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout server.key -out server.crt +``` + +Run client: + +* Install `tunnel` binary +* Make `.tunnel` directory in your project directory +* Copy `client.key`, `client.crt` to `.tunnel` +* Create configuration file `tunnel.yml` in `.tunnel` +* Start all tunnels + +```bash +$ tunnel -config ./tunnel/tunnel.yml start-all +``` + +Run server: + +* Install `tunneld` binary +* Make `.tunneld` directory +* Copy `server.key`, `server.crt` to `.tunneld` +* Start tunnel server + +```bash +$ tunneld -tlsCrt .tunneld/server.crt -tlsKey .tunneld/server.key +``` + +This will run HTTP server on port `80` and HTTPS (HTTP/2) server on port `443`. If you want to use HTTPS it's recommended to get a properly signed certificate to avoid security warnings. + +## Configuration + +The tunnel client `tunnel` requires configuration file, by default it will try reading `tunnel.yml` in your current working directory. If you want to specify other file use `-config` flag. + +Sample configuration that exposes: + +* `localhost:8080` as `webui.my-tunnel-host.com` +* host in private network for ssh connections + +looks like this + +```yaml + server_addr: SERVER_IP:5223 + tunnels: + webui: + proto: http + addr: localhost:8080 + auth: user:password + host: webui.my-tunnel-host.com + ssh: + proto: tcp + addr: 192.168.0.5:22 + remote_addr: 0.0.0.0:22 +``` + +Configuration options: + +* `server_addr`: server TCP address, i.e. `54.12.12.45:5223` +* `tls_crt`: path to client TLS certificate, *default:* `client.crt` *in the config file directory* +* `tls_key`: path to client TLS certificate key, *default:* `client.key` *in the config file directory* +* `root_ca`: path to trusted root certificate authority pool file, if empty any server certificate is accepted +* `tunnels / [name]` + * `proto`: tunnel protocol, `http` or `tcp` + * `addr`: forward traffic to this local port number or network address, for `proto=http` this can be full URL i.e. `https://machine/sub/path/?plus=params`, supports URL schemes `http` and `https` + * `auth`: (`proto=http`) (optional) basic authentication credentials to enforce on tunneled requests, format `user:password` + * `host`: (`proto=http`) hostname to request (requires reserved name and DNS CNAME) + * `remote_addr`: (`proto=tcp`) bind the remote TCP address +* `backoff` + * `interval`: how long client would wait before redialing the server if connection was lost, exponential backoff initial interval, *default:* `500ms` + * `multiplier`: interval multiplier if reconnect failed, *default:* `1.5` + * `max_interval`: maximal time client would wait before redialing the server, *default:* `1m` + * `max_time`: maximal time client would try to reconnect to the server if connection was lost, set `0` to never stop trying, *default:* `15m` + +## How it works +Client opens a TLS connection to a server. Server accepts connections from known clients only, client is recognised by it's TLS certificate ID. The server is publicly available and proxies incoming connections to the client. Then the connection is further proxied in the client's network. + +Tunnel is based HTTP/2 for speed and security. There is a single TCP connection between client and server and all the proxied connections are multiplexed using HTTP/2. + +## Donation + +If this project help you reduce time to develop, you can give me a cup of coffee. + +[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=RMM46NAEY7YZ6&lc=US&item_name=go%2dhttp%2dtunnel¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted) + +A GitHub star is always appreciated! + +## License + +Copyright (C) 2017 Michał Matczuk + +This project is distributed under the AGPL-3 license. See the [LICENSE](https://github.com/mmatczuk/go-http-tunnel/blob/master/LICENSE) file for details. If you need an enterprice license contact me directly. diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/auth.go b/vendor/github.com/mmatczuk/go-http-tunnel/auth.go new file mode 100644 index 0000000..19faf07 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/auth.go @@ -0,0 +1,30 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import "strings" + +// Auth holds user and password. +type Auth struct { + User string + Password string +} + +// NewAuth creates new auth from string representation "user:password". +func NewAuth(auth string) *Auth { + if auth == "" { + return nil + } + + s := strings.SplitN(auth, ":", 2) + a := &Auth{ + User: s[0], + } + if len(s) > 1 { + a.Password = s[1] + } + + return a +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/auth_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/auth_test.go new file mode 100644 index 0000000..b703c21 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/auth_test.go @@ -0,0 +1,28 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "reflect" + "testing" +) + +func TestNewAuth(t *testing.T) { + tests := []struct { + actual string + expected *Auth + }{ + {"", nil}, + {"user", &Auth{User: "user"}}, + {"user:password", &Auth{User: "user", Password: "password"}}, + {"user:pass:word", &Auth{User: "user", Password: "pass:word"}}, + } + + for _, tt := range tests { + if !reflect.DeepEqual(NewAuth(tt.actual), tt.expected) { + t.Errorf("Invalid auth for %s", tt.actual) + } + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/backoff.go b/vendor/github.com/mmatczuk/go-http-tunnel/backoff.go new file mode 100644 index 0000000..6114330 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/backoff.go @@ -0,0 +1,19 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import "time" + +// Backoff defines behavior of staggering reconnection retries. +type Backoff interface { + // Next returns the duration to sleep before retrying to reconnect. + // If the returned value is negative, the retry is aborted. + NextBackOff() time.Duration + + // Reset is used to signal a reconnection was successful and next + // call to Next should return desired time duration for 1st reconnection + // attempt. + Reset() +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/README.md b/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/README.md new file mode 100644 index 0000000..ba7a72c --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/README.md @@ -0,0 +1,50 @@ +# Benchmark report + +The benchmark compares [tunnel](https://github.com/mmatczuk/go-http-tunnel) to [koding tunnel](https://github.com/koding/tunnel) on serving 184 midsized files that were gathered by saving `amazon.com` for offline view. The data set consists of images and text data (js, css, html). On start client loads the files into memory and act as a file server. + +The diagrams were rendered using [hdrhistogram](http://hdrhistogram.github.io/HdrHistogram/plotFiles.html) and the input files were generated with help of [github.com/codahale/hdrhistogram](https://github.com/codahale/hdrhistogram) library. The vegeta raw results were corrected for stalls using [hdr correction method](https://godoc.org/github.com/codahale/hdrhistogram#Histogram.RecordCorrectedValue). + +## Environment + +Tests were done on four AWS `t2.micro` instances. An instance for client, an instance for server and two instances for load generator. For load generation we used [vegeta](https://github.com/tsenart/vegeta) in distributed mode. On all machines open files limit (`ulimit -n`) was increased to `20000`. + +## Load spike + +This test compares performance on two minute load spikes. tunnel handles 900 req/sec without dropping a message while preserving good latency. At 1000 req/sec tunnel still works but drops 0,20% requests and latency is much worse. Koding tunnel is faster at 800 req/sec, but at higher request rates latency degrades giving maximum values of 1.65s at 900 req/sec and 23.50s at 1000 req/sec (with 5% error rate). + +![](spike.png) + +Detailed results of load spike test. + +| Impl. | Req/sec | Success rate | P99 (corrected)| Max | +|-------:| -------:|-------------:| --------------:| --------------:| +| tunnel | 600 | 100% | 40.079103ms | 147.310766ms | +| tunnel | 800 | 100% | 161.093631ms | 308.993573ms | +| tunnel | 900 | 100% | 172.114943ms | 376.924512ms | +| tunnel | 1000 | 99.90% | 793.423871ms | 1228.133135ms | +| koding | 600 | 100% | 43.161855ms | 173.871604ms | +| koding | 800 | 100% | 53.311743ms | 180.344454ms | +| koding | 900 | 100% | 1003.495423ms | 1648.814589ms | +| koding | 1000 | 94.95% | 16081.551359ms | 23494.866864ms | + +## Constant pressure + +This test compares performance on twenty minutes constant pressure runs. tunnel shows ability to trade latency for throughput. It runs fine at 300 req/sec but at higher request rates we observe poor latency and some message drops. Koding tunnel has acceptable performance at 300 req/sec, however, with increased load it just breaks. + +Both implementations have a connection (or memory) leak when dealing with too high loads. This results in process (or machine) crash as machine runs out of memory. It's 100% reproducible, when process crashes it has few hundred thousands go routines waiting on select in a connection and memory full of connection buffers. + +![](constload.png) + +Detailed results of constant pressure test. + +| Impl. | Req/sec | Success rate | P99 (corrected)| Max | +|-------:| -------:|-------------:| --------------:| --------------:| +| tunnel | 300 | 100% | 16.614527ms | 199.479958ms | +| tunnel | 400 | 99.98% | 1175.904255 | 1568.012326ms | +| tunnel | 500 | 99.96% | 1457.364991ms | 1917.406792ms | +| koding | 300 | 100% | 66.436607ms | 354.531247ms | +| koding | 400 | 82.66% | - | - | +| koding | 500 | 63.16% | - | - | + + + diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/constload.png b/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/constload.png new file mode 100644 index 0000000000000000000000000000000000000000..adb413e8126ffc1202d26f45a37c370eca200ae6 GIT binary patch literal 140618 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 literal 0 HcmV?d00001 diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/spike.png b/vendor/github.com/mmatczuk/go-http-tunnel/benchmark/spike.png new file mode 100644 index 0000000000000000000000000000000000000000..d531b1b9827854311433990e2e2f7df61734be49 GIT binary patch literal 143301 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%0ADtqN|nK-xenjuEFsn_}$0D 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

^$ud& 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 F{{yprQp5lN literal 0 HcmV?d00001 diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/client.go b/vendor/github.com/mmatczuk/go-http-tunnel/client.go new file mode 100644 index 0000000..3647ad7 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/client.go @@ -0,0 +1,326 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "crypto/tls" + "encoding/json" + "errors" + "fmt" + "net" + "net/http" + "sync" + "time" + + "golang.org/x/net/http2" + + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// ClientConfig is configuration of the Client. +type ClientConfig struct { + // ServerAddr specifies TCP address of the tunnel server. + ServerAddr string + // TLSClientConfig specifies the tls configuration to use with + // tls.Client. + TLSClientConfig *tls.Config + // DialTLS specifies an optional dial function that creates a tls + // connection to the server. If DialTLS is nil, tls.Dial is used. + DialTLS func(network, addr string, config *tls.Config) (net.Conn, error) + // Backoff specifies backoff policy on server connection retry. If nil + // when dial fails it will not be retried. + Backoff Backoff + // Tunnels specifies the tunnels client requests to be opened on server. + Tunnels map[string]*proto.Tunnel + // Proxy is ProxyFunc responsible for transferring data between server + // and local services. + Proxy ProxyFunc + // Logger is optional logger. If nil logging is disabled. + Logger log.Logger +} + +// Client is responsible for creating connection to the server, handling control +// messages. It uses ProxyFunc for transferring data between server and local +// services. +type Client struct { + config *ClientConfig + + conn net.Conn + connMu sync.Mutex + httpServer *http2.Server + serverErr error + lastDisconnect time.Time + logger log.Logger +} + +// NewClient creates a new unconnected Client based on configuration. Caller +// must invoke Start() on returned instance in order to connect server. +func NewClient(config *ClientConfig) (*Client, error) { + if config.ServerAddr == "" { + return nil, errors.New("missing ServerAddr") + } + if config.TLSClientConfig == nil { + return nil, errors.New("missing TLSClientConfig") + } + if len(config.Tunnels) == 0 { + return nil, errors.New("missing Tunnels") + } + if config.Proxy == nil { + return nil, errors.New("missing Proxy") + } + + logger := config.Logger + if logger == nil { + logger = log.NewNopLogger() + } + + c := &Client{ + config: config, + httpServer: &http2.Server{}, + logger: logger, + } + + return c, nil +} + +// Start connects client to the server, it returns error if there is a +// connection error, or server cannot open requested tunnels. On connection +// error a backoff policy is used to reestablish the connection. When connected +// HTTP/2 server is started to handle ControlMessages. +func (c *Client) Start() error { + c.logger.Log( + "level", 1, + "action", "start", + ) + + for { + conn, err := c.connect() + if err != nil { + return err + } + + c.httpServer.ServeConn(conn, &http2.ServeConnOpts{ + Handler: http.HandlerFunc(c.serveHTTP), + }) + + c.logger.Log( + "level", 1, + "action", "disconnected", + ) + + c.connMu.Lock() + now := time.Now() + err = c.serverErr + + // detect disconnect hiccup + if err == nil && now.Sub(c.lastDisconnect).Seconds() < 5 { + err = fmt.Errorf("connection is being cut") + } + + c.conn = nil + c.serverErr = nil + c.lastDisconnect = now + c.connMu.Unlock() + + if err != nil { + return err + } + } +} + +func (c *Client) connect() (net.Conn, error) { + c.connMu.Lock() + defer c.connMu.Unlock() + + if c.conn != nil { + return nil, fmt.Errorf("already connected") + } + + conn, err := c.dial() + if err != nil { + return nil, fmt.Errorf("failed to connect to server: %s", err) + } + c.conn = conn + + return conn, nil +} + +func (c *Client) dial() (net.Conn, error) { + var ( + network = "tcp" + addr = c.config.ServerAddr + tlsConfig = c.config.TLSClientConfig + ) + + doDial := func() (conn net.Conn, err error) { + c.logger.Log( + "level", 1, + "action", "dial", + "network", network, + "addr", addr, + ) + + if c.config.DialTLS != nil { + conn, err = c.config.DialTLS(network, addr, tlsConfig) + } else { + d := &net.Dialer{ + Timeout: DefaultTimeout, + } + conn, err = d.Dial(network, addr) + + if err == nil { + err = keepAlive(conn) + } + if err == nil { + conn = tls.Client(conn, tlsConfig) + } + if err == nil { + err = conn.(*tls.Conn).Handshake() + } + } + + if err != nil { + if conn != nil { + conn.Close() + conn = nil + } + + c.logger.Log( + "level", 0, + "msg", "dial failed", + "network", network, + "addr", addr, + "err", err, + ) + } + + return + } + + b := c.config.Backoff + if b == nil { + return doDial() + } + + for { + conn, err := doDial() + + // success + if err == nil { + b.Reset() + return conn, err + } + + // failure + d := b.NextBackOff() + if d < 0 { + return conn, fmt.Errorf("backoff limit exeded: %s", err) + } + + // backoff + c.logger.Log( + "level", 1, + "action", "backoff", + "sleep", d, + ) + time.Sleep(d) + } +} + +func (c *Client) serveHTTP(w http.ResponseWriter, r *http.Request) { + if r.Method == http.MethodConnect { + if r.Header.Get(proto.HeaderError) != "" { + c.handleHandshakeError(w, r) + } else { + c.handleHandshake(w, r) + } + return + } + + msg, err := proto.ReadControlMessage(r) + if err != nil { + c.logger.Log( + "level", 1, + "err", err, + ) + http.Error(w, err.Error(), http.StatusBadRequest) + return + } + + c.logger.Log( + "level", 2, + "action", "handle", + "ctrlMsg", msg, + ) + switch msg.Action { + case proto.ActionProxy: + c.config.Proxy(w, r.Body, msg) + default: + c.logger.Log( + "level", 0, + "msg", "unknown action", + "ctrlMsg", msg, + ) + http.Error(w, err.Error(), http.StatusBadRequest) + } + c.logger.Log( + "level", 2, + "action", "done", + "ctrlMsg", msg, + ) +} + +func (c *Client) handleHandshakeError(w http.ResponseWriter, r *http.Request) { + err := fmt.Errorf(r.Header.Get(proto.HeaderError)) + + c.logger.Log( + "level", 1, + "action", "handshake error", + "addr", r.RemoteAddr, + "err", err, + ) + + c.connMu.Lock() + c.serverErr = fmt.Errorf("server error: %s", err) + c.connMu.Unlock() +} + +func (c *Client) handleHandshake(w http.ResponseWriter, r *http.Request) { + c.logger.Log( + "level", 1, + "action", "handshake", + "addr", r.RemoteAddr, + ) + + w.WriteHeader(http.StatusOK) + + b, err := json.Marshal(c.config.Tunnels) + if err != nil { + c.logger.Log( + "level", 0, + "msg", "handshake failed", + "err", err, + ) + return + } + w.Write(b) +} + +// Stop disconnects client from server. +func (c *Client) Stop() { + c.connMu.Lock() + defer c.connMu.Unlock() + + c.logger.Log( + "level", 1, + "action", "stop", + ) + + if c.conn != nil { + c.conn.Close() + } + c.conn = nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/client_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/client_test.go new file mode 100644 index 0000000..36310b9 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/client_test.go @@ -0,0 +1,86 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "crypto/tls" + "errors" + "net" + "net/http/httptest" + "testing" + "time" + + "github.com/golang/mock/gomock" + "github.com/mmatczuk/go-http-tunnel/proto" + "github.com/mmatczuk/go-http-tunnel/tunnelmock" +) + +func TestClient_Dial(t *testing.T) { + t.Parallel() + + s := httptest.NewTLSServer(nil) + defer s.Close() + + c, err := NewClient(&ClientConfig{ + ServerAddr: s.Listener.Addr().String(), + TLSClientConfig: &tls.Config{ + InsecureSkipVerify: true, + }, + Tunnels: map[string]*proto.Tunnel{"test": {}}, + Proxy: Proxy(ProxyFuncs{}), + }) + if err != nil { + t.Fatal(err) + } + + conn, err := c.dial() + if err != nil { + t.Fatal("Dial error", err) + } + if conn == nil { + t.Fatal("Expected connection", err) + } + conn.Close() +} + +func TestClient_DialBackoff(t *testing.T) { + t.Parallel() + + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + b := tunnelmock.NewMockBackoff(ctrl) + gomock.InOrder( + b.EXPECT().NextBackOff().Return(50*time.Millisecond).Times(2), + b.EXPECT().NextBackOff().Return(-time.Millisecond), + ) + + d := func(network, addr string, config *tls.Config) (net.Conn, error) { + return nil, errors.New("foobar") + } + + c, err := NewClient(&ClientConfig{ + ServerAddr: "8.8.8.8", + TLSClientConfig: &tls.Config{}, + DialTLS: d, + Backoff: b, + Tunnels: map[string]*proto.Tunnel{"test": {}}, + Proxy: Proxy(ProxyFuncs{}), + }) + if err != nil { + t.Fatal(err) + } + + start := time.Now() + _, err = c.dial() + + if time.Since(start) < 100*time.Millisecond { + t.Fatal("Wait mismatch", err) + } + + if err.Error() != "backoff limit exeded: foobar" { + t.Fatal("Error mismatch", err) + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/config.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/config.go new file mode 100644 index 0000000..da20ffd --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/config.go @@ -0,0 +1,142 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "fmt" + "io/ioutil" + "path/filepath" + "time" + + "gopkg.in/yaml.v2" + + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// Default backoff configuration. +const ( + DefaultBackoffInterval = 500 * time.Millisecond + DefaultBackoffMultiplier = 1.5 + DefaultBackoffMaxInterval = 60 * time.Second + DefaultBackoffMaxTime = 15 * time.Minute +) + +// BackoffConfig defines behavior of staggering reconnection retries. +type BackoffConfig struct { + Interval time.Duration `yaml:"interval"` + Multiplier float64 `yaml:"multiplier"` + MaxInterval time.Duration `yaml:"max_interval"` + MaxTime time.Duration `yaml:"max_time"` +} + +// Tunnel defines a tunnel. +type Tunnel struct { + Protocol string `yaml:"proto,omitempty"` + Addr string `yaml:"addr,omitempty"` + Auth string `yaml:"auth,omitempty"` + Host string `yaml:"host,omitempty"` + RemoteAddr string `yaml:"remote_addr,omitempty"` +} + +// ClientConfig is a tunnel client configuration. +type ClientConfig struct { + ServerAddr string `yaml:"server_addr"` + TLSCrt string `yaml:"tls_crt"` + TLSKey string `yaml:"tls_key"` + RootCA string `yaml:"root_ca"` + Backoff BackoffConfig `yaml:"backoff"` + Tunnels map[string]*Tunnel `yaml:"tunnels"` +} + +func loadClientConfigFromFile(file string) (*ClientConfig, error) { + buf, err := ioutil.ReadFile(file) + if err != nil { + return nil, fmt.Errorf("failed to read file %q: %s", file, err) + } + + c := ClientConfig{ + TLSCrt: filepath.Join(filepath.Dir(file), "client.crt"), + TLSKey: filepath.Join(filepath.Dir(file), "client.key"), + Backoff: BackoffConfig{ + Interval: DefaultBackoffInterval, + Multiplier: DefaultBackoffMultiplier, + MaxInterval: DefaultBackoffMaxInterval, + MaxTime: DefaultBackoffMaxTime, + }, + } + + if err = yaml.Unmarshal(buf, &c); err != nil { + return nil, fmt.Errorf("failed to parse file %q: %s", file, err) + } + + if c.ServerAddr == "" { + return nil, fmt.Errorf("server_addr: missing") + } + if c.ServerAddr, err = normalizeAddress(c.ServerAddr); err != nil { + return nil, fmt.Errorf("server_addr: %s", err) + } + + for name, t := range c.Tunnels { + switch t.Protocol { + case proto.HTTP: + if err := validateHTTP(t); err != nil { + return nil, fmt.Errorf("%s %s", name, err) + } + case proto.TCP, proto.TCP4, proto.TCP6: + if err := validateTCP(t); err != nil { + return nil, fmt.Errorf("%s %s", name, err) + } + default: + return nil, fmt.Errorf("%s invalid protocol %q", name, t.Protocol) + } + } + + return &c, nil +} + +func validateHTTP(t *Tunnel) error { + var err error + if t.Host == "" { + return fmt.Errorf("host: missing") + } + if t.Addr == "" { + return fmt.Errorf("addr: missing") + } + if t.Addr, err = normalizeURL(t.Addr); err != nil { + return fmt.Errorf("addr: %s", err) + } + + // unexpected + + if t.RemoteAddr != "" { + return fmt.Errorf("remote_addr: unexpected") + } + + return nil +} + +func validateTCP(t *Tunnel) error { + var err error + if t.RemoteAddr, err = normalizeAddress(t.RemoteAddr); err != nil { + return fmt.Errorf("remote_addr: %s", err) + } + if t.Addr == "" { + return fmt.Errorf("addr: missing") + } + if t.Addr, err = normalizeAddress(t.Addr); err != nil { + return fmt.Errorf("addr: %s", err) + } + + // unexpected + + if t.Host != "" { + return fmt.Errorf("host: unexpected") + } + if t.Auth != "" { + return fmt.Errorf("auth: unexpected") + } + + return nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize.go new file mode 100644 index 0000000..2f9f84d --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize.go @@ -0,0 +1,56 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "fmt" + "net" + "net/url" + "strconv" + "strings" +) + +func normalizeAddress(addr string) (string, error) { + // normalize port to addr + if _, err := strconv.Atoi(addr); err == nil { + addr = ":" + addr + } + + host, port, err := net.SplitHostPort(addr) + if err != nil { + return "", err + } + + if host == "" { + host = "127.0.0.1" + } + + return fmt.Sprintf("%s:%s", host, port), nil +} + +func normalizeURL(rawurl string) (string, error) { + // check scheme + s := strings.SplitN(rawurl, "://", 2) + if len(s) > 1 { + switch s[0] { + case "http", "https": + default: + return "", fmt.Errorf("unsupported url schema, choose 'http' or 'https'") + } + } else { + rawurl = fmt.Sprint("http://", rawurl) + } + + u, err := url.Parse(rawurl) + if err != nil { + return "", err + } + + if u.Path != "" && !strings.HasSuffix(u.Path, "/") { + return "", fmt.Errorf("url must end with '/'") + } + + return rawurl, nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize_test.go new file mode 100644 index 0000000..5db7eb1 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/normalize_test.go @@ -0,0 +1,115 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "strings" + "testing" +) + +func TestNormalizeAddress(t *testing.T) { + t.Parallel() + + tests := []struct { + addr string + expected string + error string + }{ + { + addr: "22", + expected: "127.0.0.1:22", + }, + { + addr: ":22", + expected: "127.0.0.1:22", + }, + { + addr: "0.0.0.0:22", + expected: "0.0.0.0:22", + }, + { + addr: "0.0.0.0", + error: "missing port", + }, + { + addr: "", + error: "missing port", + }, + } + + for i, tt := range tests { + actual, err := normalizeAddress(tt.addr) + if actual != tt.expected { + t.Errorf("[%d] expected %q got %q err: %s", i, tt.expected, actual, err) + } + if tt.error != "" && err == nil { + t.Errorf("[%d] expected error", i) + } + if err != nil && (tt.error == "" || !strings.Contains(err.Error(), tt.error)) { + t.Errorf("[%d] expected error contains %q, got %q", i, tt.error, err) + } + } +} + +func TestNormalizeURL(t *testing.T) { + t.Parallel() + + tests := []struct { + rawurl string + expected string + error string + }{ + { + rawurl: "localhost", + expected: "http://localhost", + }, + { + rawurl: "localhost:80", + expected: "http://localhost:80", + }, + { + rawurl: "localhost:80/path/", + expected: "http://localhost:80/path/", + }, + { + rawurl: "localhost:80/path", + error: "/", + }, + { + rawurl: "https://localhost", + expected: "https://localhost", + }, + { + rawurl: "https://localhost:443", + expected: "https://localhost:443", + }, + { + rawurl: "https://localhost:443/path/", + expected: "https://localhost:443/path/", + }, + { + rawurl: "https://localhost:443/path", + error: "/", + }, + { + rawurl: "ftp://localhost", + error: "unsupported url schema", + }, + } + + for i, tt := range tests { + actual, err := normalizeURL(tt.rawurl) + if actual != tt.expected { + t.Errorf("[%d] expected %q got %q, err: %s", i, tt.expected, actual, err) + } + if tt.error != "" && err == nil { + t.Errorf("[%d] expected error", i) + } + if err != nil && (tt.error == "" || !strings.Contains(err.Error(), tt.error)) { + t.Errorf("[%d] expected error contains %q, got %q", i, tt.error, err) + } + } + +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/options.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/options.go new file mode 100644 index 0000000..ef3176f --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/options.go @@ -0,0 +1,106 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "flag" + "fmt" + "os" +) + +const usage1 string = `Usage: tunnel [OPTIONS] [command args] [...] +options: +` + +const usage2 string = ` +Commands: + tunnel id Show client identifier + tunnel list List tunnel names from config file + tunnel start [tunnel] [...] Start tunnels by name from config file + tunnel start-all Start all tunnels defined in config file + +Examples: + tunnel start www ssh + tunnel -config config.yaml -log-level 2 start ssh + tunnel start-all + +config.yaml: + server_addr: SERVER_IP:5223 + tunnels: + webui: + proto: http + addr: localhost:8080 + auth: user:password + host: webui.my-tunnel-host.com + ssh: + proto: tcp + addr: 192.168.0.5:22 + remote_addr: 0.0.0.0:22 + +Author: + Written by M. Matczuk (mmatczuk@gmail.com) + +Bugs: + Submit bugs to https://github.com/mmatczuk/go-http-tunnel/issues +` + +func init() { + flag.Usage = func() { + fmt.Fprintf(os.Stderr, usage1) + flag.PrintDefaults() + fmt.Fprintf(os.Stderr, usage2) + } +} + +type options struct { + config string + logLevel int + version bool + command string + args []string +} + +func parseArgs() (*options, error) { + config := flag.String("config", "tunnel.yml", "Path to tunnel configuration file") + logLevel := flag.Int("log-level", 1, "Level of messages to log, 0-3") + version := flag.Bool("version", false, "Prints tunnel version") + flag.Parse() + + opts := &options{ + config: *config, + logLevel: *logLevel, + version: *version, + command: flag.Arg(0), + } + + if opts.version { + return opts, nil + } + + switch opts.command { + case "": + flag.Usage() + os.Exit(2) + case "id", "list": + opts.args = flag.Args()[1:] + if len(opts.args) > 0 { + return nil, fmt.Errorf("list takes no arguments") + } + case "start": + opts.args = flag.Args()[1:] + if len(opts.args) == 0 { + return nil, fmt.Errorf("you must specify at least one tunnel to start") + } + case "start-all": + opts.args = flag.Args()[1:] + if len(opts.args) > 0 { + return nil, fmt.Errorf("start-all takes no arguments") + } + default: + return nil, fmt.Errorf("unknown command %q", opts.command) + } + + return opts, nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/tunnel.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/tunnel.go new file mode 100644 index 0000000..9bce9ea --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/tunnel.go @@ -0,0 +1,198 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "crypto/tls" + "crypto/x509" + "fmt" + "io/ioutil" + "net" + "net/url" + "os" + "sort" + + "gopkg.in/yaml.v2" + + "github.com/cenkalti/backoff" + "github.com/mmatczuk/go-http-tunnel" + "github.com/mmatczuk/go-http-tunnel/id" + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +func main() { + opts, err := parseArgs() + if err != nil { + fatal(err.Error()) + } + + if opts.version { + fmt.Println(version) + return + } + + logger := log.NewFilterLogger(log.NewStdLogger(), opts.logLevel) + + // read configuration file + config, err := loadClientConfigFromFile(opts.config) + if err != nil { + fatal("configuration error: %s", err) + } + + switch opts.command { + case "id": + cert, err := tls.LoadX509KeyPair(config.TLSCrt, config.TLSKey) + if err != nil { + fatal("failed to load key pair: %s", err) + } + x509Cert, err := x509.ParseCertificate(cert.Certificate[0]) + if err != nil { + fatal("failed to parse certificate: %s", err) + } + fmt.Println(id.New(x509Cert.Raw)) + + return + case "list": + var names []string + for n := range config.Tunnels { + names = append(names, n) + } + + sort.Strings(names) + + for _, n := range names { + fmt.Println(n) + } + + return + case "start": + tunnels := make(map[string]*Tunnel) + for _, arg := range opts.args { + t, ok := config.Tunnels[arg] + if !ok { + fatal("no such tunnel %q", arg) + } + tunnels[arg] = t + } + config.Tunnels = tunnels + } + + if len(config.Tunnels) == 0 { + fatal("no tunnels") + } + + tlsconf, err := tlsConfig(config) + if err != nil { + fatal("failed to configure tls: %s", err) + } + + b, err := yaml.Marshal(config) + if err != nil { + fatal("failed to dump config: %s", err) + } + logger.Log("config", string(b)) + + client, err := tunnel.NewClient(&tunnel.ClientConfig{ + ServerAddr: config.ServerAddr, + TLSClientConfig: tlsconf, + Backoff: expBackoff(config.Backoff), + Tunnels: tunnels(config.Tunnels), + Proxy: proxy(config.Tunnels, logger), + Logger: logger, + }) + if err != nil { + fatal("failed to create client: %s", err) + } + + if err := client.Start(); err != nil { + fatal("failed to start tunnels: %s", err) + } +} + +func tlsConfig(config *ClientConfig) (*tls.Config, error) { + cert, err := tls.LoadX509KeyPair(config.TLSCrt, config.TLSKey) + if err != nil { + return nil, err + } + + var roots *x509.CertPool + if config.RootCA != "" { + roots = x509.NewCertPool() + rootPEM, err := ioutil.ReadFile(config.RootCA) + if err != nil { + return nil, err + } + if ok := roots.AppendCertsFromPEM(rootPEM); !ok { + return nil, err + } + } + + host, _, err := net.SplitHostPort(config.ServerAddr) + if err != nil { + return nil, err + } + + return &tls.Config{ + ServerName: host, + Certificates: []tls.Certificate{cert}, + InsecureSkipVerify: roots == nil, + RootCAs: roots, + }, nil +} + +func expBackoff(c BackoffConfig) *backoff.ExponentialBackOff { + b := backoff.NewExponentialBackOff() + b.InitialInterval = c.Interval + b.Multiplier = c.Multiplier + b.MaxInterval = c.MaxInterval + b.MaxElapsedTime = c.MaxTime + + return b +} + +func tunnels(m map[string]*Tunnel) map[string]*proto.Tunnel { + p := make(map[string]*proto.Tunnel) + + for name, t := range m { + p[name] = &proto.Tunnel{ + Protocol: t.Protocol, + Host: t.Host, + Auth: t.Auth, + Addr: t.RemoteAddr, + } + } + + return p +} + +func proxy(m map[string]*Tunnel, logger log.Logger) tunnel.ProxyFunc { + httpURL := make(map[string]*url.URL) + tcpAddr := make(map[string]string) + + for _, t := range m { + switch t.Protocol { + case proto.HTTP: + u, err := url.Parse(t.Addr) + if err != nil { + fatal("invalid tunnel address: %s", err) + } + httpURL[t.Host] = u + case proto.TCP, proto.TCP4, proto.TCP6: + tcpAddr[t.RemoteAddr] = t.Addr + } + } + + return tunnel.Proxy(tunnel.ProxyFuncs{ + HTTP: tunnel.NewMultiHTTPProxy(httpURL, log.NewContext(logger).WithPrefix("proxy", "HTTP")).Proxy, + TCP: tunnel.NewMultiTCPProxy(tcpAddr, log.NewContext(logger).WithPrefix("proxy", "TCP")).Proxy, + }) +} + +func fatal(format string, a ...interface{}) { + fmt.Fprintf(os.Stderr, format, a...) + fmt.Fprint(os.Stderr, "\n") + os.Exit(1) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/version.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/version.go new file mode 100644 index 0000000..189c430 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunnel/version.go @@ -0,0 +1,7 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +var version = "snapshot" diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/banner.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/banner.go new file mode 100644 index 0000000..c5cf848 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/banner.go @@ -0,0 +1,14 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +const banner = ` + ______ __ __________________ __ __ + / ____/___ / / / /_ __/_ __/ __ \ / /___ ______ ____ ___ / / + / / __/ __ \ / /_/ / / / / / / /_/ / / __/ / / / __ \/ __ \/ _ \/ / +/ /_/ / /_/ / / __ / / / / / / ____/ / /_/ /_/ / / / / / / / __/ / +\____/\____/ /_/ /_/ /_/ /_/ /_/ \__/\__,_/_/ /_/_/ /_/\___/_/ +github.com/mmatczuk/go-http-tunnel +` diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/options.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/options.go new file mode 100644 index 0000000..06994dc --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/options.go @@ -0,0 +1,74 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "flag" + "fmt" + "os" +) + +const usage1 string = `Usage: tunneld [OPTIONS] +options: +` + +const usage2 string = ` +Example: + tuneld + tuneld -clients YMBKT3V-ESUTZ2Z-7MRILIJ-T35FHGO-D2DHO7D-FXMGSSR-V4LBSZX-BNDONQ4 + tuneld -httpAddr :8080 -httpsAddr "" + +Author: + Written by M. Matczuk (mmatczuk@gmail.com) + +Bugs: + Submit bugs to https://github.com/mmatczuk/go-http-tunnel/issues +` + +func init() { + flag.Usage = func() { + fmt.Fprintf(os.Stderr, usage1) + flag.PrintDefaults() + fmt.Fprintf(os.Stderr, usage2) + } +} + +// options specify arguments read command line arguments. +type options struct { + httpAddr string + httpsAddr string + tunnelAddr string + tlsCrt string + tlsKey string + rootCA string + clients string + logLevel int + version bool +} + +func parseArgs() *options { + httpAddr := flag.String("httpAddr", ":80", "Public address for HTTP connections, empty string to disable") + httpsAddr := flag.String("httpsAddr", ":443", "Public address listening for HTTPS connections, emptry string to disable") + tunnelAddr := flag.String("tunnelAddr", ":5223", "Public address listening for tunnel client") + tlsCrt := flag.String("tlsCrt", "server.crt", "Path to a TLS certificate file") + tlsKey := flag.String("tlsKey", "server.key", "Path to a TLS key file") + rootCA := flag.String("rootCA", "", "Path to the trusted certificate chian used for client certificate authentication, if empty any client certificate is accepted") + clients := flag.String("clients", "", "Comma-separated list of tunnel client ids, if empty accept all clients") + logLevel := flag.Int("log-level", 1, "Level of messages to log, 0-3") + version := flag.Bool("version", false, "Prints tunneld version") + flag.Parse() + + return &options{ + httpAddr: *httpAddr, + httpsAddr: *httpsAddr, + tunnelAddr: *tunnelAddr, + tlsCrt: *tlsCrt, + tlsKey: *tlsKey, + rootCA: *rootCA, + clients: *clients, + logLevel: *logLevel, + version: *version, + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/tunneld.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/tunneld.go new file mode 100644 index 0000000..d7c1eba --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/tunneld.go @@ -0,0 +1,140 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +import ( + "crypto/tls" + "crypto/x509" + "fmt" + "io/ioutil" + "net/http" + "os" + "strings" + + "golang.org/x/net/http2" + + "github.com/mmatczuk/go-http-tunnel" + "github.com/mmatczuk/go-http-tunnel/id" + "github.com/mmatczuk/go-http-tunnel/log" +) + +func main() { + opts := parseArgs() + + if opts.version { + fmt.Println(version) + return + } + + fmt.Println(banner) + + logger := log.NewFilterLogger(log.NewStdLogger(), opts.logLevel) + + tlsconf, err := tlsConfig(opts) + if err != nil { + fatal("failed to configure tls: %s", err) + } + + autoSubscribe := opts.clients == "" + + // setup server + server, err := tunnel.NewServer(&tunnel.ServerConfig{ + Addr: opts.tunnelAddr, + AutoSubscribe: autoSubscribe, + TLSConfig: tlsconf, + Logger: logger, + }) + if err != nil { + fatal("failed to create server: %s", err) + } + + if !autoSubscribe { + for _, c := range strings.Split(opts.clients, ",") { + if c == "" { + fatal("empty client id") + } + identifier := id.ID{} + err := identifier.UnmarshalText([]byte(c)) + if err != nil { + fatal("invalid identifier %q: %s", c, err) + } + server.Subscribe(identifier) + } + } + + // start HTTP + if opts.httpAddr != "" { + go func() { + logger.Log( + "level", 1, + "action", "start http", + "addr", opts.httpAddr, + ) + + fatal("failed to start HTTP: %s", http.ListenAndServe(opts.httpAddr, server)) + }() + } + + // start HTTPS + if opts.httpsAddr != "" { + go func() { + logger.Log( + "level", 1, + "action", "start https", + "addr", opts.httpsAddr, + ) + + s := &http.Server{ + Addr: opts.httpsAddr, + Handler: server, + } + http2.ConfigureServer(s, nil) + + fatal("failed to start HTTPS: %s", s.ListenAndServeTLS(opts.tlsCrt, opts.tlsKey)) + }() + } + + server.Start() +} + +func tlsConfig(opts *options) (*tls.Config, error) { + // load certs + cert, err := tls.LoadX509KeyPair(opts.tlsCrt, opts.tlsKey) + if err != nil { + return nil, err + } + + // load root CA for client authentication + clientAuth := tls.RequireAnyClientCert + var roots *x509.CertPool + if opts.rootCA != "" { + roots = x509.NewCertPool() + rootPEM, err := ioutil.ReadFile(opts.rootCA) + if err != nil { + return nil, err + } + if ok := roots.AppendCertsFromPEM(rootPEM); !ok { + return nil, err + } + clientAuth = tls.RequireAndVerifyClientCert + } + + return &tls.Config{ + Certificates: []tls.Certificate{cert}, + ClientAuth: clientAuth, + ClientCAs: roots, + SessionTicketsDisabled: true, + MinVersion: tls.VersionTLS12, + CipherSuites: []uint16{tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256}, + PreferServerCipherSuites: true, + NextProtos: []string{"h2"}, + }, nil +} + +func fatal(format string, a ...interface{}) { + fmt.Fprintf(os.Stderr, format, a...) + fmt.Fprint(os.Stderr, "\n") + os.Exit(1) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/version.go b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/version.go new file mode 100644 index 0000000..189c430 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/cmd/tunneld/version.go @@ -0,0 +1,7 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package main + +var version = "snapshot" diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/doc.go b/vendor/github.com/mmatczuk/go-http-tunnel/doc.go new file mode 100644 index 0000000..091aae9 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/doc.go @@ -0,0 +1,8 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +// Package tunnel is fast and secure client/server package that enables proxying +// public connections to your local machine over a tunnel connection from the +// local machine to the public server. +package tunnel diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/errors.go b/vendor/github.com/mmatczuk/go-http-tunnel/errors.go new file mode 100644 index 0000000..1a6b53b --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/errors.go @@ -0,0 +1,15 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import "errors" + +var ( + errClientNotSubscribed = errors.New("client not subscribed") + errClientNotConnected = errors.New("client not connected") + errClientAlreadyConnected = errors.New("client already connected") + + errUnauthorised = errors.New("unauthorised") +) diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/httpproxy.go b/vendor/github.com/mmatczuk/go-http-tunnel/httpproxy.go new file mode 100644 index 0000000..eb7f2b2 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/httpproxy.go @@ -0,0 +1,188 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "bufio" + "context" + "io" + "net" + "net/http" + "net/http/httputil" + "net/url" + "path" + + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// HTTPProxy forwards HTTP traffic. +type HTTPProxy struct { + httputil.ReverseProxy + // localURL specifies default base URL of local service. + localURL *url.URL + // localURLMap specifies mapping from ControlMessage.ForwardedHost to + // local service URL, keys may contain host and port, only host or + // only port. The order of precedence is the following + // * host and port + // * port + // * host + localURLMap map[string]*url.URL + // logger is the proxy logger. + logger log.Logger +} + +// NewHTTPProxy creates a new direct HTTPProxy, everything will be proxied to +// localURL. +func NewHTTPProxy(localURL *url.URL, logger log.Logger) *HTTPProxy { + if logger == nil { + logger = log.NewNopLogger() + } + + p := &HTTPProxy{ + localURL: localURL, + logger: logger, + } + p.ReverseProxy.Director = p.Director + + return p +} + +// NewMultiHTTPProxy creates a new dispatching HTTPProxy, requests may go to +// different backends based on localURLMap. +func NewMultiHTTPProxy(localURLMap map[string]*url.URL, logger log.Logger) *HTTPProxy { + if logger == nil { + logger = log.NewNopLogger() + } + + p := &HTTPProxy{ + localURLMap: localURLMap, + logger: logger, + } + p.ReverseProxy.Director = p.Director + + return p +} + +// Proxy is a ProxyFunc. +func (p *HTTPProxy) Proxy(w io.Writer, r io.ReadCloser, msg *proto.ControlMessage) { + switch msg.ForwardedProto { + case proto.HTTP, proto.HTTPS: + // ok + default: + p.logger.Log( + "level", 0, + "msg", "unsupported protocol", + "ctrlMsg", msg, + ) + return + } + + rw, ok := w.(http.ResponseWriter) + if !ok { + p.logger.Log( + "level", 0, + "msg", "expected http.ResponseWriter", + "ctrlMsg", msg, + ) + } + + req, err := http.ReadRequest(bufio.NewReader(r)) + if err != nil { + p.logger.Log( + "level", 0, + "msg", "failed to read request", + "ctrlMsg", msg, + "err", err, + ) + return + } + + setXForwardedFor(req.Header, msg.RemoteAddr) + req.URL.Host = msg.ForwardedHost + + p.ServeHTTP(rw, req) +} + +// Director is ReverseProxy Director it changes request URL so that the request +// is correctly routed based on localURL and localURLMap. If no URL can be found +// the request is canceled. +func (p *HTTPProxy) Director(req *http.Request) { + orig := *req.URL + + target := p.localURLFor(req.URL) + if target == nil { + p.logger.Log( + "level", 1, + "msg", "no target", + "url", req.URL, + ) + + _, cancel := context.WithCancel(req.Context()) + cancel() + + return + } + + req.URL.Host = target.Host + req.URL.Scheme = target.Scheme + req.URL.Path = singleJoiningSlash(target.Path, req.URL.Path) + + targetQuery := target.RawQuery + if targetQuery == "" || req.URL.RawQuery == "" { + req.URL.RawQuery = targetQuery + req.URL.RawQuery + } else { + req.URL.RawQuery = targetQuery + "&" + req.URL.RawQuery + } + if _, ok := req.Header["User-Agent"]; !ok { + // explicitly disable User-Agent so it's not set to default value + req.Header.Set("User-Agent", "") + } + + req.Host = req.URL.Host + + p.logger.Log( + "level", 2, + "action", "url rewrite", + "from", &orig, + "to", req.URL, + ) +} + +func singleJoiningSlash(a, b string) string { + if a == "" || a == "/" { + return b + } + if b == "" || b == "/" { + return a + } + + return path.Join(a, b) +} + +func (p *HTTPProxy) localURLFor(u *url.URL) *url.URL { + if len(p.localURLMap) == 0 { + return p.localURL + } + + // try host and port + hostPort := u.Host + if addr := p.localURLMap[hostPort]; addr != nil { + return addr + } + + // try port + host, port, _ := net.SplitHostPort(hostPort) + if addr := p.localURLMap[port]; addr != nil { + return addr + } + + // try host + if addr := p.localURLMap[host]; addr != nil { + return addr + } + + return p.localURL +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/id/id.go b/vendor/github.com/mmatczuk/go-http-tunnel/id/id.go new file mode 100644 index 0000000..70a4732 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/id/id.go @@ -0,0 +1,175 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package id + +import ( + "bytes" + "crypto/sha256" + "crypto/subtle" + "encoding/base32" + "errors" + "fmt" + "regexp" + "strings" + + "github.com/calmh/luhn" +) + +// ID is the type representing a generated ID. +type ID [32]byte + +// New generates a new ID from the given input bytes. +func New(data []byte) ID { + var id ID + + hasher := sha256.New() + hasher.Write(data) + hasher.Sum(id[:0]) + + return id +} + +// String returns the canonical representation of the ID. +func (i ID) String() string { + ss := base32.StdEncoding.EncodeToString(i[:]) + ss = strings.Trim(ss, "=") + + // Add a Luhn check 'digit' for the ID. + ss, err := luhnify(ss) + if err != nil { + // Should never happen + panic(err) + } + + // Return the given ID as chunks. + ss = chunkify(ss) + + return ss +} + +// Compares the two given IDs. Note that this function is NOT SAFE AGAINST +// TIMING ATTACKS. If you are simply checking for equality, please use the +// Equals function, which is. +func (i ID) Compare(other ID) int { + return bytes.Compare(i[:], other[:]) +} + +// Checks the two given IDs for equality. This function uses a constant-time +// comparison algorithm to prevent timing attacks. +func (i ID) Equals(other ID) bool { + return subtle.ConstantTimeCompare(i[:], other[:]) == 1 +} + +// Implements the `TextMarshaler` interface from the encoding package. +func (i *ID) MarshalText() ([]byte, error) { + return []byte(i.String()), nil +} + +// Implements the `TextUnmarshaler` interface from the encoding package. +func (i *ID) UnmarshalText(bs []byte) (err error) { + // Convert to the canonical encoding - uppercase, no '=', no chunks, and + // with any potential typos fixed. + id := string(bs) + id = strings.Trim(id, "=") + id = strings.ToUpper(id) + id = untypeoify(id) + id = unchunkify(id) + + if len(id) != 56 { + return errors.New("device ID invalid: incorrect length") + } + + // Remove & verify Luhn check digits + id, err = unluhnify(id) + if err != nil { + return err + } + + // Base32 decode + dec, err := base32.StdEncoding.DecodeString(id + "====") + if err != nil { + return err + } + + // Done! + copy(i[:], dec) + return nil +} + +// Add Luhn check digits to a string, returning the new one. +func luhnify(s string) (string, error) { + if len(s) != 52 { + panic("unsupported string length") + } + + // Split the string into chunks of length 13, and add a Luhn check digit to + // each one. + res := make([]string, 0, 4) + for i := 0; i < 4; i++ { + chunk := s[i*13 : (i+1)*13] + + l, err := luhn.Base32.Generate(chunk) + if err != nil { + return "", err + } + + res = append(res, fmt.Sprintf("%s%c", chunk, l)) + } + + return res[0] + res[1] + res[2] + res[3], nil +} + +// Remove Luhn check digits from the given string, validating that they are +// correct. +func unluhnify(s string) (string, error) { + if len(s) != 56 { + return "", fmt.Errorf("unsupported string length %d", len(s)) + } + + res := make([]string, 0, 4) + for i := 0; i < 4; i++ { + // 13 characters, plus the Luhn digit. + chunk := s[i*14 : (i+1)*14] + + // Get the expected check digit. + l, err := luhn.Base32.Generate(chunk[0:13]) + if err != nil { + return "", err + } + + // Validate the digits match. + if fmt.Sprintf("%c", l) != chunk[13:] { + return "", errors.New("check digit incorrect") + } + + res = append(res, chunk[0:13]) + } + + return res[0] + res[1] + res[2] + res[3], nil +} + +// Returns a string split into chunks of size 7. +func chunkify(s string) string { + s = regexp.MustCompile("(.{7})").ReplaceAllString(s, "$1-") + s = strings.Trim(s, "-") + return s +} + +// Un-chunks a string by removing all hyphens and spaces. +func unchunkify(s string) string { + s = strings.Replace(s, "-", "", -1) + s = strings.Replace(s, " ", "", -1) + return s +} + +// We use base32 encoding, which uses 26 characters, and then the numbers +// 234567. This is useful since the alphabet doesn't contain the numbers 0, 1, +// or 8, which means we can replace them with their letter-lookalikes. +func untypeoify(s string) string { + s = strings.Replace(s, "0", "O", -1) + s = strings.Replace(s, "1", "I", -1) + s = strings.Replace(s, "8", "B", -1) + return s +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/id/ptls.go b/vendor/github.com/mmatczuk/go-http-tunnel/id/ptls.go new file mode 100644 index 0000000..fcfd479 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/id/ptls.go @@ -0,0 +1,47 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package id + +import ( + "crypto/tls" + "fmt" +) + +var emptyID [32]byte + +// PeerID is modified https://github.com/andrew-d/ptls/blob/b89c7dcc94630a77f225a48befd3710144c7c10e/ptls.go#L81 +func PeerID(conn *tls.Conn) (ID, error) { + // Try a TLS connection over the given connection. We explicitly perform + // the handshake, since we want to maintain the invariant that, if this + // function returns successfully, then the connection should be valid + // and verified. + if err := conn.Handshake(); err != nil { + return emptyID, err + } + + cs := conn.ConnectionState() + + // We should have exactly one peer certificate. + certs := cs.PeerCertificates + if cl := len(certs); cl != 1 { + return emptyID, ImproperCertsNumberError{cl} + } + + // Get remote cert's ID. + remoteCert := certs[0] + remoteID := New(remoteCert.Raw) + + return remoteID, nil +} + +// ImproperCertsNumberError is returned from Server/Client whenever the remote +// peer presents a number of PeerCertificates that is not 1. +type ImproperCertsNumberError struct { + n int +} + +func (e ImproperCertsNumberError) Error() string { + return fmt.Sprintf("ptls: expecting 1 peer certificate, got %d", e.n) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/integration_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/integration_test.go new file mode 100644 index 0000000..78fc039 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/integration_test.go @@ -0,0 +1,336 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel_test + +import ( + "bytes" + "crypto/tls" + "fmt" + "io" + "io/ioutil" + "math/rand" + "net" + "net/http" + "net/http/httptest" + "net/url" + "strings" + "sync" + "testing" + "time" + + "github.com/mmatczuk/go-http-tunnel" + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +const ( + payloadInitialSize = 512 + payloadLen = 10 +) + +// echoHTTP starts serving HTTP requests on listener l, it accepts connections, +// reads request body and writes is back in response. +func echoHTTP(t testing.TB, l net.Listener) { + http.Serve(l, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + prior := strings.Join(r.Header["X-Forwarded-For"], ", ") + if len(strings.Split(prior, ",")) != 2 { + t.Fatal(r.Header) + } + if !strings.Contains(r.Header.Get("X-Forwarded-Host"), "localhost:") { + t.Fatal(r.Header) + } + if r.Header.Get("X-Forwarded-Proto") != "http" { + t.Fatal(r.Header) + } + + w.WriteHeader(http.StatusOK) + if r.Body != nil { + body, err := ioutil.ReadAll(r.Body) + if err != nil { + t.Fatal(err) + } + w.Write(body) + } + })) +} + +// echoTCP accepts connections and copies back received bytes. +func echoTCP(l net.Listener) { + for { + conn, err := l.Accept() + if err != nil { + return + } + go func() { + io.Copy(conn, conn) + }() + } +} + +func makeEcho(t testing.TB) (http net.Listener, tcp net.Listener) { + var err error + + // TCP echo + tcp, err = net.Listen("tcp", ":0") + if err != nil { + t.Fatal(err) + } + go echoTCP(tcp) + + // HTTP echo + http, err = net.Listen("tcp", ":0") + if err != nil { + t.Fatal(err) + } + go echoHTTP(t, http) + + return +} + +func makeTunnelServer(t testing.TB) *tunnel.Server { + s, err := tunnel.NewServer(&tunnel.ServerConfig{ + Addr: ":0", + AutoSubscribe: true, + TLSConfig: tlsConfig(), + Logger: log.NewStdLogger(), + }) + if err != nil { + t.Fatal(err) + } + go s.Start() + + return s +} + +func makeTunnelClient(t testing.TB, serverAddr string, httpLocalAddr, httpAddr, tcpLocalAddr, tcpAddr net.Addr) *tunnel.Client { + httpProxy := tunnel.NewMultiHTTPProxy(map[string]*url.URL{ + "localhost:" + port(httpLocalAddr): { + Scheme: "http", + Host: "127.0.0.1:" + port(httpAddr), + }, + }, log.NewStdLogger()) + + tcpProxy := tunnel.NewMultiTCPProxy(map[string]string{ + port(tcpLocalAddr): tcpAddr.String(), + }, log.NewStdLogger()) + + tunnels := map[string]*proto.Tunnel{ + proto.HTTP: { + Protocol: proto.HTTP, + Host: "localhost", + Auth: "user:password", + }, + proto.TCP: { + Protocol: proto.TCP, + Addr: tcpLocalAddr.String(), + }, + } + + c, err := tunnel.NewClient(&tunnel.ClientConfig{ + ServerAddr: serverAddr, + TLSClientConfig: tlsConfig(), + Tunnels: tunnels, + Proxy: tunnel.Proxy(tunnel.ProxyFuncs{ + HTTP: httpProxy.Proxy, + TCP: tcpProxy.Proxy, + }), + Logger: log.NewStdLogger(), + }) + if err != nil { + t.Fatal(err) + } + go func() { + if err := c.Start(); err != nil { + t.Log(err) + } + }() + + return c +} + +func TestIntegration(t *testing.T) { + // local services + http, tcp := makeEcho(t) + defer http.Close() + defer tcp.Close() + + // server + s := makeTunnelServer(t) + defer s.Stop() + h := httptest.NewServer(s) + defer h.Close() + + httpLocalAddr := h.Listener.Addr() + tcpLocalAddr := freeAddr() + + // client + c := makeTunnelClient(t, s.Addr(), + httpLocalAddr, http.Addr(), + tcpLocalAddr, tcp.Addr(), + ) + // FIXME: replace sleep with client state change watch when ready + time.Sleep(500 * time.Millisecond) + defer c.Stop() + + payload := randPayload(payloadInitialSize, payloadLen) + table := []struct { + S []uint + }{ + {[]uint{200, 160, 120, 80, 40, 20}}, + {[]uint{40, 80, 120, 160, 200}}, + {[]uint{0, 0, 0, 0, 0, 0, 0, 0, 0, 200}}, + } + + var wg sync.WaitGroup + for _, test := range table { + for i, repeat := range test.S { + p := payload[i] + r := repeat + + wg.Add(1) + go func() { + testHTTP(t, h.Listener.Addr(), p, r) + wg.Done() + }() + wg.Add(1) + go func() { + testTCP(t, tcpLocalAddr, p, r) + wg.Done() + }() + } + } + wg.Wait() +} + +func testHTTP(t testing.TB, addr net.Addr, payload []byte, repeat uint) { + url := fmt.Sprintf("http://localhost:%s/some/path", port(addr)) + + for repeat > 0 { + r, err := http.NewRequest(http.MethodPost, url, bytes.NewReader(payload)) + if err != nil { + t.Fatal("Failed to create request") + } + r.SetBasicAuth("user", "password") + + resp, err := http.DefaultClient.Do(r) + if err != nil { + t.Error(err) + } + if resp.StatusCode != http.StatusOK { + t.Error("Unexpected status code", resp) + } + b, err := ioutil.ReadAll(resp.Body) + if err != nil { + t.Error("Read error") + } + n, m := len(b), len(payload) + if n != m { + t.Error("Write read mismatch", n, m) + } + repeat-- + } +} + +func testTCP(t testing.TB, addr net.Addr, payload []byte, repeat uint) { + conn, err := net.Dial("tcp", addr.String()) + if err != nil { + t.Fatal("Dial failed", err) + } + defer conn.Close() + + var buf = make([]byte, 10*1024*1024) + var read, write int + for repeat > 0 { + m, err := conn.Write(payload) + if err != nil { + t.Error("Write failed", err) + } + if m != len(payload) { + t.Log("Write mismatch", m, len(payload)) + } + write += m + + n, err := conn.Read(buf) + if err != nil { + t.Error("Read failed", err) + } + read += n + repeat-- + } + + for read < write { + t.Log("No yet read everything", "write", write, "read", read) + time.Sleep(50 * time.Millisecond) + n, err := conn.Read(buf) + if err != nil { + t.Error("Read failed", err) + } + read += n + } + + if read != write { + t.Fatal("Write read mismatch", read, write) + } +} + +// +// helpers +// + +// randPayload returns slice of randomly initialised data buffers. +func randPayload(initialSize, n int) [][]byte { + payload := make([][]byte, n) + l := initialSize + for i := 0; i < n; i++ { + payload[i] = randBytes(l) + l *= 2 + } + return payload +} + +func randBytes(n int) []byte { + b := make([]byte, n) + read, err := rand.Read(b) + if err != nil { + panic(err) + } + if read != n { + panic("read did not fill whole slice") + } + return b +} + +func freeAddr() net.Addr { + l, err := net.Listen("tcp", ":0") + if err != nil { + panic(err) + } + defer l.Close() + return l.Addr() +} + +func port(addr net.Addr) string { + return fmt.Sprint(addr.(*net.TCPAddr).Port) +} + +func tlsConfig() *tls.Config { + cert, err := tls.LoadX509KeyPair("./testdata/selfsigned.crt", "./testdata/selfsigned.key") + if err != nil { + panic(err) + } + + c := &tls.Config{ + Certificates: []tls.Certificate{cert}, + ClientAuth: tls.RequireAnyClientCert, + SessionTicketsDisabled: true, + InsecureSkipVerify: true, + MinVersion: tls.VersionTLS12, + CipherSuites: []uint16{tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256}, + PreferServerCipherSuites: true, + NextProtos: []string{"h2"}, + } + c.BuildNameToCertificate() + return c +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/keepalive.go b/vendor/github.com/mmatczuk/go-http-tunnel/keepalive.go new file mode 100644 index 0000000..c279923 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/keepalive.go @@ -0,0 +1,30 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +// +build !windows + +package tunnel + +import ( + "net" + "time" + + "github.com/felixge/tcpkeepalive" +) + +var ( + // DefaultKeepAliveIdleTime specifies how long connection can be idle + // before sending keepalive message. + DefaultKeepAliveIdleTime = 15 * time.Minute + // DefaultKeepAliveCount specifies maximal number of keepalive messages + // sent before marking connection as dead. + DefaultKeepAliveCount = 8 + // DefaultKeepAliveInterval specifies how often retry sending keepalive + // messages when no response is received. + DefaultKeepAliveInterval = 5 * time.Second +) + +func keepAlive(conn net.Conn) error { + return tcpkeepalive.SetKeepAlive(conn, DefaultKeepAliveIdleTime, DefaultKeepAliveCount, DefaultKeepAliveInterval) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/keepalive_windows.go b/vendor/github.com/mmatczuk/go-http-tunnel/keepalive_windows.go new file mode 100644 index 0000000..db128e3 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/keepalive_windows.go @@ -0,0 +1,23 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "fmt" + "net" +) + +func keepAlive(conn net.Conn) error { + c, ok := conn.(*net.TCPConn) + if !ok { + return fmt.Errorf("Bad connection type: %T", c) + } + + if err := c.SetKeepAlive(true); err != nil { + return err + } + + return nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/context.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/context.go new file mode 100644 index 0000000..5df6369 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/context.go @@ -0,0 +1,48 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +// Context is simplified version of go-kit log Context +// https://godoc.org/github.com/go-kit/kit/log#Context. +type Context struct { + prefix []interface{} + suffix []interface{} + logger Logger +} + +// NewContext returns a logger that adds prefix before keyvals. +func NewContext(logger Logger) *Context { + return &Context{ + prefix: make([]interface{}, 0), + suffix: make([]interface{}, 0), + logger: logger, + } +} + +// With returns a new Context with keyvals appended to those of the receiver. +func (c *Context) With(keyvals ...interface{}) *Context { + return &Context{ + prefix: c.prefix, + suffix: append(c.suffix, keyvals...), + logger: c.logger, + } +} + +// WithPrefix returns a new Context with keyvals prepended to those of the +// receiver. +func (c *Context) WithPrefix(keyvals ...interface{}) *Context { + return &Context{ + prefix: append(c.prefix, keyvals...), + suffix: c.suffix, + logger: c.logger, + } +} + +// Log adds prefix and suffix to keyvals and calls internal logger. +func (c *Context) Log(keyvals ...interface{}) error { + s := append(c.prefix, keyvals...) + s = append(s, c.suffix...) + return c.logger.Log(s...) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger.go new file mode 100644 index 0000000..5122e4d --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger.go @@ -0,0 +1,48 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +type filterLogger struct { + level int + logger Logger +} + +// NewFilterLogger returns a Logger that accepts only log messages with +// "level" value <= level. Currently there are four levels 0 - error, 1 - info, +// 2 - debug, 3 - trace. +func NewFilterLogger(logger Logger, level int) Logger { + return filterLogger{ + level: level, + logger: logger, + } +} + +func (p filterLogger) Log(keyvals ...interface{}) error { + for i := 0; i < len(keyvals); i += 2 { + k := keyvals[i] + s, ok := k.(string) + if !ok { + continue + } + if s != "level" { + continue + } + + if i+1 >= len(keyvals) { + break + } + v := keyvals[i+1] + level, ok := v.(int) + if !ok { + break + } + + if level > p.level { + return nil + } + } + + return p.logger.Log(keyvals...) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger_test.go new file mode 100644 index 0000000..59d0520 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/filterlogger_test.go @@ -0,0 +1,31 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +import ( + "testing" + + "github.com/golang/mock/gomock" + "github.com/mmatczuk/go-http-tunnel/tunnelmock" +) + +func TestFilterLogger_Log(t *testing.T) { + t.Parallel() + + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + b := tunnelmock.NewMockLogger(ctrl) + f := NewFilterLogger(b, 2) + b.EXPECT().Log("level", 0) + f.Log("level", 0) + b.EXPECT().Log("level", 1) + f.Log("level", 1) + b.EXPECT().Log("level", 2) + f.Log("level", 2) + + f.Log("level", 3) + f.Log("level", 4) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/log.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/log.go new file mode 100644 index 0000000..7c72da9 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/log.go @@ -0,0 +1,14 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +// Logger is the fundamental interface for all log operations. Log creates a +// log event from keyvals, a variadic sequence of alternating keys and values. +// Implementations must be safe for concurrent use by multiple goroutines. In +// particular, any implementation of Logger that appends to keyvals or +// modifies any of its elements must make a copy first. +type Logger interface { + Log(keyvals ...interface{}) error +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/log_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/log_test.go new file mode 100644 index 0000000..4f1f895 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/log_test.go @@ -0,0 +1,29 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +import ( + "testing" + + "github.com/golang/mock/gomock" + "github.com/mmatczuk/go-http-tunnel/tunnelmock" +) + +func TestContext_Log(t *testing.T) { + t.Parallel() + + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + b := tunnelmock.NewMockLogger(ctrl) + b.EXPECT().Log("key", "val", "sufix", "") + NewContext(b).With("sufix", "").Log("key", "val") + + b.EXPECT().Log("prefix", "", "key", "val") + NewContext(b).WithPrefix("prefix", "").Log("key", "val") + + b.EXPECT().Log("prefix", "", "key", "val", "sufix", "") + NewContext(b).With("sufix", "").WithPrefix("prefix", "").Log("key", "val") +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/noplogger.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/noplogger.go new file mode 100644 index 0000000..3d38d67 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/noplogger.go @@ -0,0 +1,12 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +type nopLogger struct{} + +// NewNopLogger returns a logger that doesn't do anything. +func NewNopLogger() Logger { return nopLogger{} } + +func (nopLogger) Log(...interface{}) error { return nil } diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/log/stdlogger.go b/vendor/github.com/mmatczuk/go-http-tunnel/log/stdlogger.go new file mode 100644 index 0000000..e1df613 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/log/stdlogger.go @@ -0,0 +1,19 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package log + +import ( + "log" +) + +type stdLogger struct{} + +// NewStdLogger returns logger based on standard "log" package. +func NewStdLogger() Logger { return stdLogger{} } + +func (p stdLogger) Log(keyvals ...interface{}) error { + log.Println(keyvals...) + return nil +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/pool.go b/vendor/github.com/mmatczuk/go-http-tunnel/pool.go new file mode 100644 index 0000000..2219b3f --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/pool.go @@ -0,0 +1,142 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "context" + "fmt" + "net" + "net/http" + "sync" + "time" + + "golang.org/x/net/http2" + + "github.com/mmatczuk/go-http-tunnel/id" +) + +type connPair struct { + conn net.Conn + clientConn *http2.ClientConn +} + +type connPool struct { + t *http2.Transport + conns map[string]connPair // key is host:port + free func(identifier id.ID) + mu sync.RWMutex +} + +func newConnPool(t *http2.Transport, f func(identifier id.ID)) *connPool { + return &connPool{ + t: t, + free: f, + conns: make(map[string]connPair), + } +} + +func (p *connPool) URL(identifier id.ID) string { + return fmt.Sprint("https://", identifier) +} + +func (p *connPool) GetClientConn(req *http.Request, addr string) (*http2.ClientConn, error) { + p.mu.RLock() + defer p.mu.RUnlock() + + if cp, ok := p.conns[addr]; ok && cp.clientConn.CanTakeNewRequest() { + return cp.clientConn, nil + } + + return nil, errClientNotConnected +} + +func (p *connPool) MarkDead(c *http2.ClientConn) { + p.mu.Lock() + defer p.mu.Unlock() + + for addr, cp := range p.conns { + if cp.clientConn == c { + p.close(cp, addr) + return + } + } +} + +func (p *connPool) AddConn(conn net.Conn, identifier id.ID) error { + p.mu.Lock() + defer p.mu.Unlock() + + addr := p.addr(identifier) + + if cp, ok := p.conns[addr]; ok { + if err := p.ping(cp); err != nil { + p.close(cp, addr) + } else { + return errClientAlreadyConnected + } + } + + c, err := p.t.NewClientConn(conn) + if err != nil { + return err + } + p.conns[addr] = connPair{ + conn: conn, + clientConn: c, + } + + return nil +} + +func (p *connPool) DeleteConn(identifier id.ID) { + p.mu.Lock() + defer p.mu.Unlock() + + addr := p.addr(identifier) + + if cp, ok := p.conns[addr]; ok { + p.close(cp, addr) + } +} + +func (p *connPool) Ping(identifier id.ID) (time.Duration, error) { + p.mu.Lock() + defer p.mu.Unlock() + + addr := p.addr(identifier) + + if cp, ok := p.conns[addr]; ok { + start := time.Now() + err := p.ping(cp) + return time.Since(start), err + } + + return 0, errClientNotConnected +} + +func (p *connPool) ping(cp connPair) error { + ctx, cancel := context.WithTimeout(context.Background(), DefaultPingTimeout) + defer cancel() + + return cp.clientConn.Ping(ctx) +} + +func (p *connPool) close(cp connPair, addr string) { + cp.conn.Close() + delete(p.conns, addr) + if p.free != nil { + p.free(p.identifier(addr)) + } +} + +func (p *connPool) addr(identifier id.ID) string { + return fmt.Sprint(identifier.String(), ":443") +} + +func (p *connPool) identifier(addr string) id.ID { + var identifier id.ID + identifier.UnmarshalText([]byte(addr[:len(addr)-4])) + return identifier +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg.go b/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg.go new file mode 100644 index 0000000..2dddc93 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg.go @@ -0,0 +1,80 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package proto + +import ( + "fmt" + "net/http" +) + +// Protocol HTTP headers. +const ( + HeaderError = "X-Error" + + HeaderAction = "X-Action" + HeaderForwardedHost = "X-Forwarded-Host" + HeaderForwardedProto = "X-Forwarded-Proto" +) + +// Known actions. +const ( + ActionProxy = "proxy" +) + +// Known protocol types. +const ( + HTTP = "http" + HTTPS = "https" + + TCP = "tcp" + TCP4 = "tcp4" + TCP6 = "tcp6" + UNIX = "unix" +) + +// ControlMessage is sent from server to client before streaming data. It's +// used to inform client about the data and action to take. Based on that client +// routes requests to backend services. +type ControlMessage struct { + Action string + ForwardedHost string + ForwardedProto string + RemoteAddr string +} + +// ReadControlMessage reads ControlMessage from HTTP headers. +func ReadControlMessage(r *http.Request) (*ControlMessage, error) { + msg := ControlMessage{ + Action: r.Header.Get(HeaderAction), + ForwardedHost: r.Header.Get(HeaderForwardedHost), + ForwardedProto: r.Header.Get(HeaderForwardedProto), + RemoteAddr: r.RemoteAddr, + } + + var missing []string + + if msg.Action == "" { + missing = append(missing, HeaderAction) + } + if msg.ForwardedHost == "" { + missing = append(missing, HeaderForwardedHost) + } + if msg.ForwardedProto == "" { + missing = append(missing, HeaderForwardedProto) + } + + if len(missing) != 0 { + return nil, fmt.Errorf("missing headers: %s", missing) + } + + return &msg, nil +} + +// WriteToHeader writes ControlMessage to HTTP header. +func (c *ControlMessage) WriteToHeader(h http.Header) { + h.Set(HeaderAction, string(c.Action)) + h.Set(HeaderForwardedHost, c.ForwardedHost) + h.Set(HeaderForwardedProto, c.ForwardedProto) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg_test.go b/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg_test.go new file mode 100644 index 0000000..51f39e0 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/proto/controlmsg_test.go @@ -0,0 +1,70 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package proto + +import ( + "errors" + "net/http" + "reflect" + "testing" +) + +func TestControlMessageWriteRead(t *testing.T) { + t.Parallel() + + data := []struct { + msg *ControlMessage + err error + }{ + { + &ControlMessage{ + Action: "action", + ForwardedHost: "forwarded_host", + ForwardedProto: "forwarded_proto", + }, + nil, + }, + { + &ControlMessage{ + ForwardedHost: "forwarded_host", + ForwardedProto: "forwarded_proto", + }, + errors.New("missing headers: [X-Action]"), + }, + { + &ControlMessage{ + Action: "action", + ForwardedHost: "forwarded_host", + }, + errors.New("missing headers: [X-Forwarded-Proto]"), + }, + { + &ControlMessage{ + Action: "action", + ForwardedProto: "forwarded_proto", + }, + errors.New("missing headers: [X-Forwarded-Host]"), + }, + } + + for i, tt := range data { + r := http.Request{} + r.Header = http.Header{} + tt.msg.WriteToHeader(r.Header) + + actual, err := ReadControlMessage(&r) + if tt.err != nil { + if err == nil { + t.Error(i, "expected error") + } else if tt.err.Error() != err.Error() { + t.Error(i, tt.err, err) + } + } else { + if !reflect.DeepEqual(tt.msg, actual) { + t.Error(i, tt.msg, actual) + } + } + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/proto/tunnel.go b/vendor/github.com/mmatczuk/go-http-tunnel/proto/tunnel.go new file mode 100644 index 0000000..2b5e71e --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/proto/tunnel.go @@ -0,0 +1,23 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package proto + +// Tunnel describes a single tunnel between client and server. When connecting +// client sends tunnels to server. If client gets connected server proxies +// connections to given Host and Addr to the client. +type Tunnel struct { + // Protocol specifies tunnel protocol, must be one of protocols known + // by the server. + Protocol string + // Host specified HTTP request host, it's required for HTTP and WS + // tunnels. + Host string + // Auth specifies HTTP basic auth credentials in form "user:password", + // if set server would protect HTTP and WS tunnels with basic auth. + Auth string + // Addr specifies TCP address server would listen on, it's required + // for TCP tunnels. + Addr string +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/proxy.go b/vendor/github.com/mmatczuk/go-http-tunnel/proxy.go new file mode 100644 index 0000000..267f2d6 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/proxy.go @@ -0,0 +1,42 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "io" + + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// ProxyFunc is responsible for forwarding a remote connection to local server +// and writing the response. +type ProxyFunc func(w io.Writer, r io.ReadCloser, msg *proto.ControlMessage) + +// ProxyFuncs is a collection of ProxyFunc. +type ProxyFuncs struct { + // HTTP is custom implementation of HTTP proxing. + HTTP ProxyFunc + // TCP is custom implementation of TCP proxing. + TCP ProxyFunc +} + +// Proxy returns a ProxyFunc that uses custom function if provided. +func Proxy(p ProxyFuncs) ProxyFunc { + return func(w io.Writer, r io.ReadCloser, msg *proto.ControlMessage) { + var f ProxyFunc + switch msg.ForwardedProto { + case proto.HTTP, proto.HTTPS: + f = p.HTTP + case proto.TCP, proto.TCP4, proto.TCP6, proto.UNIX: + f = p.TCP + } + + if f == nil { + return + } + + f(w, r, msg) + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/registry.go b/vendor/github.com/mmatczuk/go-http-tunnel/registry.go new file mode 100644 index 0000000..98fead8 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/registry.go @@ -0,0 +1,194 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "fmt" + "net" + "sync" + + "github.com/mmatczuk/go-http-tunnel/id" + "github.com/mmatczuk/go-http-tunnel/log" +) + +// RegistryItem holds information about hosts and listeners associated with a +// client. +type RegistryItem struct { + Hosts []*HostAuth + Listeners []net.Listener +} + +// HostAuth holds host and authentication info. +type HostAuth struct { + Host string + Auth *Auth +} + +type hostInfo struct { + identifier id.ID + auth *Auth +} + +type registry struct { + items map[id.ID]*RegistryItem + hosts map[string]*hostInfo + mu sync.RWMutex + logger log.Logger +} + +func newRegistry(logger log.Logger) *registry { + if logger == nil { + logger = log.NewNopLogger() + } + + return ®istry{ + items: make(map[id.ID]*RegistryItem), + hosts: make(map[string]*hostInfo), + logger: logger, + } +} + +var voidRegistryItem = &RegistryItem{} + +// Subscribe allows to connect client with a given identifier. +func (r *registry) Subscribe(identifier id.ID) { + r.mu.Lock() + defer r.mu.Unlock() + + if _, ok := r.items[identifier]; ok { + return + } + + r.logger.Log( + "level", 1, + "action", "subscribe", + "identifier", identifier, + ) + + r.items[identifier] = voidRegistryItem +} + +// IsSubscribed returns true if client is subscribed. +func (r *registry) IsSubscribed(identifier id.ID) bool { + r.mu.RLock() + defer r.mu.RUnlock() + _, ok := r.items[identifier] + return ok +} + +// Subscriber returns client identifier assigned to given host. +func (r *registry) Subscriber(hostPort string) (id.ID, *Auth, bool) { + r.mu.RLock() + defer r.mu.RUnlock() + + h, ok := r.hosts[trimPort(hostPort)] + if !ok { + return id.ID{}, nil, false + } + + return h.identifier, h.auth, ok +} + +// Unsubscribe removes client from registry and returns it's RegistryItem. +func (r *registry) Unsubscribe(identifier id.ID) *RegistryItem { + r.mu.Lock() + defer r.mu.Unlock() + + i, ok := r.items[identifier] + if !ok { + return nil + } + + r.logger.Log( + "level", 1, + "action", "unsubscribe", + "identifier", identifier, + ) + + if i.Hosts != nil { + for _, h := range i.Hosts { + delete(r.hosts, h.Host) + } + } + + delete(r.items, identifier) + + return i +} + +func (r *registry) set(i *RegistryItem, identifier id.ID) error { + r.logger.Log( + "level", 2, + "action", "set registry item", + "identifier", identifier, + ) + + r.mu.Lock() + defer r.mu.Unlock() + + j, ok := r.items[identifier] + if !ok { + return errClientNotSubscribed + } + if j != voidRegistryItem { + return fmt.Errorf("attempt to overwrite registry item") + } + + if i.Hosts != nil { + for _, h := range i.Hosts { + if h.Auth != nil && h.Auth.User == "" { + return fmt.Errorf("missing auth user") + } + if _, ok := r.hosts[trimPort(h.Host)]; ok { + return fmt.Errorf("host %q is occupied", h.Host) + } + } + + for _, h := range i.Hosts { + r.hosts[trimPort(h.Host)] = &hostInfo{ + identifier: identifier, + auth: h.Auth, + } + } + } + + r.items[identifier] = i + + return nil +} + +func (r *registry) clear(identifier id.ID) *RegistryItem { + r.logger.Log( + "level", 2, + "action", "clear registry item", + "identifier", identifier, + ) + + r.mu.Lock() + defer r.mu.Unlock() + + i, ok := r.items[identifier] + if !ok || i == voidRegistryItem { + return nil + } + + if i.Hosts != nil { + for _, h := range i.Hosts { + delete(r.hosts, trimPort(h.Host)) + } + } + + r.items[identifier] = voidRegistryItem + + return i +} + +func trimPort(hostPort string) (host string) { + host, _, _ = net.SplitHostPort(hostPort) + if host == "" { + host = hostPort + } + return +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/server.go b/vendor/github.com/mmatczuk/go-http-tunnel/server.go new file mode 100644 index 0000000..b3f7bd6 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/server.go @@ -0,0 +1,710 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "context" + "crypto/tls" + "encoding/json" + "errors" + "fmt" + "io" + "net" + "net/http" + "strings" + "time" + + "golang.org/x/net/http2" + + "github.com/mmatczuk/go-http-tunnel/id" + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// ServerConfig defines configuration for the Server. +type ServerConfig struct { + // Addr is TCP address to listen for client connections. If empty ":0" + // is used. + Addr string + // AutoSubscribe if enabled will automatically subscribe new clients on + // first call. + AutoSubscribe bool + // TLSConfig specifies the tls configuration to use with tls.Listener. + TLSConfig *tls.Config + // Listener specifies optional listener for client connections. If nil + // tls.Listen("tcp", Addr, TLSConfig) is used. + Listener net.Listener + // Logger is optional logger. If nil logging is disabled. + Logger log.Logger +} + +// Server is responsible for proxying public connections to the client over a +// tunnel connection. +type Server struct { + *registry + config *ServerConfig + + listener net.Listener + connPool *connPool + httpClient *http.Client + logger log.Logger +} + +// NewServer creates a new Server. +func NewServer(config *ServerConfig) (*Server, error) { + listener, err := listener(config) + if err != nil { + return nil, fmt.Errorf("listener failed: %s", err) + } + + logger := config.Logger + if logger == nil { + logger = log.NewNopLogger() + } + + s := &Server{ + registry: newRegistry(logger), + config: config, + listener: listener, + logger: logger, + } + + t := &http2.Transport{} + pool := newConnPool(t, s.disconnected) + t.ConnPool = pool + s.connPool = pool + s.httpClient = &http.Client{ + Transport: t, + CheckRedirect: func(req *http.Request, via []*http.Request) error { + return http.ErrUseLastResponse + }, + } + + return s, nil +} + +func listener(config *ServerConfig) (net.Listener, error) { + if config.Listener != nil { + return config.Listener, nil + } + + if config.Addr == "" { + return nil, errors.New("missing Addr") + } + if config.TLSConfig == nil { + return nil, errors.New("missing TLSConfig") + } + + return net.Listen("tcp", config.Addr) +} + +// disconnected clears resources used by client, it's invoked by connection pool +// when client goes away. +func (s *Server) disconnected(identifier id.ID) { + s.logger.Log( + "level", 1, + "action", "disconnected", + "identifier", identifier, + ) + + i := s.registry.clear(identifier) + if i == nil { + return + } + for _, l := range i.Listeners { + s.logger.Log( + "level", 2, + "action", "close listener", + "identifier", identifier, + "addr", l.Addr(), + ) + l.Close() + } +} + +// Start starts accepting connections form clients. For accepting http traffic +// from end users server must be run as handler on http server. +func (s *Server) Start() { + addr := s.listener.Addr().String() + + s.logger.Log( + "level", 1, + "action", "start", + "addr", addr, + ) + + for { + conn, err := s.listener.Accept() + if err != nil { + if strings.Contains(err.Error(), "use of closed network connection") { + s.logger.Log( + "level", 1, + "action", "control connection listener closed", + "addr", addr, + ) + return + } + + s.logger.Log( + "level", 0, + "msg", "accept of control connection failed", + "addr", addr, + "err", err, + ) + continue + } + + if err := keepAlive(conn); err != nil { + s.logger.Log( + "level", 0, + "msg", "TCP keepalive for control connection failed", + "addr", addr, + "err", err, + ) + } + + go s.handleClient(tls.Server(conn, s.config.TLSConfig)) + } +} + +func (s *Server) handleClient(conn net.Conn) { + logger := log.NewContext(s.logger).With("addr", conn.RemoteAddr()) + + logger.Log( + "level", 1, + "action", "try connect", + ) + + var ( + identifier id.ID + req *http.Request + resp *http.Response + tunnels map[string]*proto.Tunnel + err error + ok bool + + inConnPool bool + ) + + tlsConn, ok := conn.(*tls.Conn) + if !ok { + logger.Log( + "level", 0, + "msg", "invalid connection type", + "err", fmt.Errorf("expected TLS conn, got %T", conn), + ) + goto reject + } + + identifier, err = id.PeerID(tlsConn) + if err != nil { + logger.Log( + "level", 2, + "msg", "certificate error", + "err", err, + ) + goto reject + } + + logger = logger.With("identifier", identifier) + + if s.config.AutoSubscribe { + s.Subscribe(identifier) + } else if !s.IsSubscribed(identifier) { + logger.Log( + "level", 2, + "msg", "unknown client", + ) + goto reject + } + + if err = conn.SetDeadline(time.Time{}); err != nil { + logger.Log( + "level", 2, + "msg", "setting infinite deadline failed", + "err", err, + ) + goto reject + } + + if err := s.connPool.AddConn(conn, identifier); err != nil { + logger.Log( + "level", 2, + "msg", "adding connection failed", + "err", err, + ) + goto reject + } + inConnPool = true + + req, err = http.NewRequest(http.MethodConnect, s.connPool.URL(identifier), nil) + if err != nil { + logger.Log( + "level", 2, + "msg", "handshake request creation failed", + "err", err, + ) + goto reject + } + + { + ctx, cancel := context.WithTimeout(context.Background(), DefaultTimeout) + defer cancel() + req = req.WithContext(ctx) + } + + resp, err = s.httpClient.Do(req) + if err != nil { + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + if resp.StatusCode != http.StatusOK { + err = fmt.Errorf("Status %s", resp.Status) + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + if resp.ContentLength == 0 { + err = fmt.Errorf("Tunnels Content-Legth: 0") + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + if err = json.NewDecoder(&io.LimitedReader{R: resp.Body, N: 126976}).Decode(&tunnels); err != nil { + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + if len(tunnels) == 0 { + err = fmt.Errorf("No tunnels") + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + if err = s.addTunnels(tunnels, identifier); err != nil { + logger.Log( + "level", 2, + "msg", "handshake failed", + "err", err, + ) + goto reject + } + + logger.Log( + "level", 1, + "action", "connected", + ) + + return + +reject: + logger.Log( + "level", 1, + "action", "rejected", + ) + + if inConnPool { + s.notifyError(err, identifier) + s.connPool.DeleteConn(identifier) + } + + conn.Close() +} + +// notifyError tries to send error to client. +func (s *Server) notifyError(serverError error, identifier id.ID) { + if serverError == nil { + return + } + + req, err := http.NewRequest(http.MethodConnect, s.connPool.URL(identifier), nil) + if err != nil { + s.logger.Log( + "level", 2, + "action", "client error notification failed", + "identifier", identifier, + "err", err, + ) + return + } + + req.Header.Set(proto.HeaderError, serverError.Error()) + + ctx, cancel := context.WithTimeout(context.Background(), DefaultTimeout) + defer cancel() + + s.httpClient.Do(req.WithContext(ctx)) +} + +// addTunnels invokes addHost or addListener based on data from proto.Tunnel. If +// a tunnel cannot be added whole batch is reverted. +func (s *Server) addTunnels(tunnels map[string]*proto.Tunnel, identifier id.ID) error { + i := &RegistryItem{ + Hosts: []*HostAuth{}, + Listeners: []net.Listener{}, + } + + var err error + for name, t := range tunnels { + switch t.Protocol { + case proto.HTTP: + i.Hosts = append(i.Hosts, &HostAuth{t.Host, NewAuth(t.Auth)}) + case proto.TCP, proto.TCP4, proto.TCP6, proto.UNIX: + var l net.Listener + l, err = net.Listen(t.Protocol, t.Addr) + if err != nil { + goto rollback + } + + s.logger.Log( + "level", 2, + "action", "open listener", + "identifier", identifier, + "addr", l.Addr(), + ) + + i.Listeners = append(i.Listeners, l) + default: + err = fmt.Errorf("unsupported protocol for tunnel %s: %s", name, t.Protocol) + goto rollback + } + } + + err = s.set(i, identifier) + if err != nil { + goto rollback + } + + for _, l := range i.Listeners { + go s.listen(l, identifier) + } + + return nil + +rollback: + for _, l := range i.Listeners { + l.Close() + } + + return err +} + +// Unsubscribe removes client from registry, disconnects client if already +// connected and returns it's RegistryItem. +func (s *Server) Unsubscribe(identifier id.ID) *RegistryItem { + s.connPool.DeleteConn(identifier) + return s.registry.Unsubscribe(identifier) +} + +// Ping measures the RTT response time. +func (s *Server) Ping(identifier id.ID) (time.Duration, error) { + return s.connPool.Ping(identifier) +} + +func (s *Server) listen(l net.Listener, identifier id.ID) { + addr := l.Addr().String() + + for { + conn, err := l.Accept() + if err != nil { + if strings.Contains(err.Error(), "use of closed network connection") { + s.logger.Log( + "level", 2, + "action", "listener closed", + "identifier", identifier, + "addr", addr, + ) + return + } + + s.logger.Log( + "level", 0, + "msg", "accept of connection failed", + "identifier", identifier, + "addr", addr, + "err", err, + ) + continue + } + + msg := &proto.ControlMessage{ + Action: proto.ActionProxy, + ForwardedHost: l.Addr().String(), + ForwardedProto: l.Addr().Network(), + } + + if err := keepAlive(conn); err != nil { + s.logger.Log( + "level", 1, + "msg", "TCP keepalive for tunneled connection failed", + "identifier", identifier, + "ctrlMsg", msg, + "err", err, + ) + } + + go func() { + if err := s.proxyConn(identifier, conn, msg); err != nil { + s.logger.Log( + "level", 0, + "msg", "proxy error", + "identifier", identifier, + "ctrlMsg", msg, + "err", err, + ) + } + }() + } +} + +// ServeHTTP proxies http connection to the client. +func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request) { + resp, err := s.RoundTrip(r) + if err == errUnauthorised { + w.Header().Set("WWW-Authenticate", "Basic realm=\"User Visible Realm\"") + http.Error(w, err.Error(), http.StatusUnauthorized) + return + } + if err != nil { + s.logger.Log( + "level", 0, + "action", "round trip failed", + "addr", r.RemoteAddr, + "host", r.Host, + "url", r.URL, + "err", err, + ) + + http.Error(w, err.Error(), http.StatusBadGateway) + return + } + defer resp.Body.Close() + + copyHeader(w.Header(), resp.Header) + w.WriteHeader(resp.StatusCode) + + transfer(w, resp.Body, log.NewContext(s.logger).With( + "dir", "client to user", + "dst", r.RemoteAddr, + "src", r.Host, + )) +} + +// RoundTrip is http.RoundTriper implementation. +func (s *Server) RoundTrip(r *http.Request) (*http.Response, error) { + identifier, auth, ok := s.Subscriber(r.Host) + if !ok { + return nil, errClientNotSubscribed + } + + outr := r.WithContext(r.Context()) + if r.ContentLength == 0 { + outr.Body = nil // Issue 16036: nil Body for http.Transport retries + } + outr.Header = cloneHeader(r.Header) + + if auth != nil { + user, password, _ := r.BasicAuth() + if auth.User != user || auth.Password != password { + return nil, errUnauthorised + } + outr.Header.Del("Authorization") + } + + setXForwardedFor(outr.Header, r.RemoteAddr) + + scheme := r.URL.Scheme + if scheme == "" { + if r.TLS != nil { + scheme = proto.HTTPS + } else { + scheme = proto.HTTP + } + } + if r.Header.Get("X-Forwarded-Host") == "" { + outr.Header.Set("X-Forwarded-Host", r.Host) + outr.Header.Set("X-Forwarded-Proto", scheme) + } + + msg := &proto.ControlMessage{ + Action: proto.ActionProxy, + ForwardedHost: r.Host, + ForwardedProto: scheme, + } + + return s.proxyHTTP(identifier, outr, msg) +} + +func (s *Server) proxyConn(identifier id.ID, conn net.Conn, msg *proto.ControlMessage) error { + s.logger.Log( + "level", 2, + "action", "proxy conn", + "identifier", identifier, + "ctrlMsg", msg, + ) + + defer conn.Close() + + pr, pw := io.Pipe() + defer pr.Close() + defer pw.Close() + + req, err := s.connectRequest(identifier, msg, pr) + if err != nil { + return err + } + + ctx, cancel := context.WithCancel(context.Background()) + req = req.WithContext(ctx) + + done := make(chan struct{}) + go func() { + transfer(pw, conn, log.NewContext(s.logger).With( + "dir", "user to client", + "dst", identifier, + "src", conn.RemoteAddr(), + )) + cancel() + close(done) + }() + + resp, err := s.httpClient.Do(req) + if err != nil { + return fmt.Errorf("io error: %s", err) + } + defer resp.Body.Close() + + transfer(conn, resp.Body, log.NewContext(s.logger).With( + "dir", "client to user", + "dst", conn.RemoteAddr(), + "src", identifier, + )) + + <-done + + s.logger.Log( + "level", 2, + "action", "proxy conn done", + "identifier", identifier, + "ctrlMsg", msg, + ) + + return nil +} + +func (s *Server) proxyHTTP(identifier id.ID, r *http.Request, msg *proto.ControlMessage) (*http.Response, error) { + s.logger.Log( + "level", 2, + "action", "proxy HTTP", + "identifier", identifier, + "ctrlMsg", msg, + ) + + pr, pw := io.Pipe() + defer pr.Close() + defer pw.Close() + + req, err := s.connectRequest(identifier, msg, pr) + if err != nil { + return nil, fmt.Errorf("proxy request error: %s", err) + } + + go func() { + cw := &countWriter{pw, 0} + err := r.Write(cw) + if err != nil { + s.logger.Log( + "level", 0, + "msg", "proxy error", + "identifier", identifier, + "ctrlMsg", msg, + "err", err, + ) + } + + s.logger.Log( + "level", 3, + "action", "transferred", + "identifier", identifier, + "bytes", cw.count, + "dir", "user to client", + "dst", r.Host, + "src", r.RemoteAddr, + ) + + if r.Body != nil { + r.Body.Close() + } + }() + + resp, err := s.httpClient.Do(req) + if err != nil { + return nil, fmt.Errorf("io error: %s", err) + } + + s.logger.Log( + "level", 2, + "action", "proxy HTTP done", + "identifier", identifier, + "ctrlMsg", msg, + "status code", resp.StatusCode, + ) + + return resp, nil +} + +// connectRequest creates HTTP request to client with a given identifier having +// control message and data input stream, output data stream results from +// response the created request. +func (s *Server) connectRequest(identifier id.ID, msg *proto.ControlMessage, r io.Reader) (*http.Request, error) { + req, err := http.NewRequest(http.MethodPut, s.connPool.URL(identifier), r) + if err != nil { + return nil, fmt.Errorf("could not create request: %s", err) + } + msg.WriteToHeader(req.Header) + + return req, nil +} + +// Addr returns network address clients connect to. +func (s *Server) Addr() string { + if s.listener == nil { + return "" + } + return s.listener.Addr().String() +} + +// Stop closes the server. +func (s *Server) Stop() { + s.logger.Log( + "level", 1, + "action", "stop", + ) + + if s.listener != nil { + s.listener.Close() + } +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/tcpproxy.go b/vendor/github.com/mmatczuk/go-http-tunnel/tcpproxy.go new file mode 100644 index 0000000..613de9b --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/tcpproxy.go @@ -0,0 +1,148 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "fmt" + "io" + "net" + + "github.com/mmatczuk/go-http-tunnel/log" + "github.com/mmatczuk/go-http-tunnel/proto" +) + +// TCPProxy forwards TCP streams. +type TCPProxy struct { + // localAddr specifies default TCP address of the local server. + localAddr string + // localAddrMap specifies mapping from ControlMessage.ForwardedHost to + // local server address, keys may contain host and port, only host or + // only port. The order of precedence is the following + // * host and port + // * port + // * host + localAddrMap map[string]string + // logger is the proxy logger. + logger log.Logger +} + +// NewTCPProxy creates new direct TCPProxy, everything will be proxied to +// localAddr. +func NewTCPProxy(localAddr string, logger log.Logger) *TCPProxy { + if logger == nil { + logger = log.NewNopLogger() + } + + return &TCPProxy{ + localAddr: localAddr, + logger: logger, + } +} + +// NewMultiTCPProxy creates a new dispatching TCPProxy, connections may go to +// different backends based on localAddrMap. +func NewMultiTCPProxy(localAddrMap map[string]string, logger log.Logger) *TCPProxy { + if logger == nil { + logger = log.NewNopLogger() + } + + return &TCPProxy{ + localAddrMap: localAddrMap, + logger: logger, + } +} + +// Proxy is a ProxyFunc. +func (p *TCPProxy) Proxy(w io.Writer, r io.ReadCloser, msg *proto.ControlMessage) { + switch msg.ForwardedProto { + case proto.TCP, proto.TCP4, proto.TCP6, proto.UNIX: + // ok + default: + p.logger.Log( + "level", 0, + "msg", "unsupported protocol", + "ctrlMsg", msg, + ) + return + } + + target := p.localAddrFor(msg.ForwardedHost) + if target == "" { + p.logger.Log( + "level", 1, + "msg", "no target", + "ctrlMsg", msg, + ) + return + } + + local, err := net.DialTimeout("tcp", target, DefaultTimeout) + if err != nil { + p.logger.Log( + "level", 0, + "msg", "dial failed", + "target", target, + "ctrlMsg", msg, + "err", err, + ) + return + } + defer local.Close() + + if err := keepAlive(local); err != nil { + p.logger.Log( + "level", 1, + "msg", "TCP keepalive for tunneled connection failed", + "target", target, + "ctrlMsg", msg, + "err", err, + ) + } + + done := make(chan struct{}) + go func() { + transfer(flushWriter{w}, local, log.NewContext(p.logger).With( + "dst", msg.ForwardedHost, + "src", target, + )) + close(done) + }() + + transfer(local, r, log.NewContext(p.logger).With( + "dst", target, + "src", msg.ForwardedHost, + )) + + <-done +} + +func (p *TCPProxy) localAddrFor(hostPort string) string { + if len(p.localAddrMap) == 0 { + return p.localAddr + } + + // try hostPort + if addr := p.localAddrMap[hostPort]; addr != "" { + return addr + } + + // try port + host, port, _ := net.SplitHostPort(hostPort) + if addr := p.localAddrMap[port]; addr != "" { + return addr + } + + // try 0.0.0.0:port + if addr := p.localAddrMap[fmt.Sprintf("0.0.0.0:%s", port)]; addr != "" { + return addr + } + + // try host + if addr := p.localAddrMap[host]; addr != "" { + return addr + } + + return p.localAddr +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.crt b/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.crt new file mode 100644 index 0000000..9824a89 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.crt @@ -0,0 +1,21 @@ +-----BEGIN CERTIFICATE----- +MIIDfTCCAmWgAwIBAgIJAKbvDXgcAiNEMA0GCSqGSIb3DQEBCwUAMFUxCzAJBgNV +BAYTAlBMMRQwEgYDVQQIDAtNYXpvd2llY2tpZTEPMA0GA1UEBwwGV2Fyc2F3MREw +DwYDVQQKDAhDb2RpTGltZTEMMAoGA1UECwwDUm5EMB4XDTE2MDYwNzA2MzkxOVoX +DTE2MDcwNzA2MzkxOVowVTELMAkGA1UEBhMCUEwxFDASBgNVBAgMC01hem93aWVj +a2llMQ8wDQYDVQQHDAZXYXJzYXcxETAPBgNVBAoMCENvZGlMaW1lMQwwCgYDVQQL +DANSbkQwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDOXU4I9ytB8BaX +4kc93aox1hs0lh85cOHLdr+jSN1U+e/FYjtGX5t/cLx2zYBYbkdpLc0tUO4oAVcb +mqTtnlpxA6kDQWsCZlvJ3Cxc7ayo4we4ojGMcn2zDpoD902UUV80wWzIvyYFyVAW +0dvEN3YKQpqLEf3pqaMxRCYsidRDaDkRn/id7ugoIJ3fhb6ea2WAllVTHTzJR8tz +rHSsYrcvS938bpn2ZprR32z6FMTzUZe3LnuhQUVvDILDp3QY9ycgtiA1maH47YkT +E42pCft7VtoqQFAt4vWPCbhWqFapu635az7y+zF6CWM8q3n+d4I+X9JqrhkRBSfQ +u2njQb6DAgMBAAGjUDBOMB0GA1UdDgQWBBTZGAHyp2CyGP+kFwxR+zDQqn+bVDAf +BgNVHSMEGDAWgBTZGAHyp2CyGP+kFwxR+zDQqn+bVDAMBgNVHRMEBTADAQH/MA0G +CSqGSIb3DQEBCwUAA4IBAQAFkhH2f9vMETDvMPq9b4RUdUNq8p+3rvYnw1gA8mja +PzXdy9e+YCI5hI9OY/uMJjfbTPwTYESPu8+YZNKqHfeQwk7dkhrX3FQplr4SAMdO +s+ztddCFvVHcDbaAm89CCXBgWjruG/tV/pZbrfOXt6vfAtJHvD07vnKK3PqSD4v0 +SnahMx1MWlmVeAOT54TVAqxeFspo6F9eAihw3rje8bnRvwzVaTH6QgXf+Ks6uoE0 +OPSiqHYpfwkl8WSlla0XUceMm7c15RgrXHQTNqBL6JA9uTuAODr4ga/7Cua2sJyG +Pe8wp7oz5djAnierAs8eJQ2Sa9CmNEFkoIYNu92nH3kM +-----END CERTIFICATE----- diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.key b/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.key new file mode 100644 index 0000000..ac7f9ca --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/testdata/selfsigned.key @@ -0,0 +1,28 @@ +-----BEGIN PRIVATE KEY----- +MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDOXU4I9ytB8BaX +4kc93aox1hs0lh85cOHLdr+jSN1U+e/FYjtGX5t/cLx2zYBYbkdpLc0tUO4oAVcb +mqTtnlpxA6kDQWsCZlvJ3Cxc7ayo4we4ojGMcn2zDpoD902UUV80wWzIvyYFyVAW +0dvEN3YKQpqLEf3pqaMxRCYsidRDaDkRn/id7ugoIJ3fhb6ea2WAllVTHTzJR8tz +rHSsYrcvS938bpn2ZprR32z6FMTzUZe3LnuhQUVvDILDp3QY9ycgtiA1maH47YkT +E42pCft7VtoqQFAt4vWPCbhWqFapu635az7y+zF6CWM8q3n+d4I+X9JqrhkRBSfQ +u2njQb6DAgMBAAECggEBAMO2Ra3HDCVq12KQXVRVB3ZgQkjrHw3Q+rOGGVV4Y0CW +EUm3UdP6FHUWrAZX+yLi46LipzYVDOiv7LbnQQeCKPAJsp69ygjqnp6gywoO9rLt +LYNzf15drszESlj8j3zcd1iHIO56KktOk0AxIyXCG5a7d+nw1Ehoc7bjlPikdsS9 +PBum9dw67Nl8XB0QpdXjDtSleHPvqT8PbAyDVr0nSBeulNh5PzJMvRtkcguTn6p/ +y+LreatjR+XzgfRf+qtvYcrTXq1D99OOUKqSKGwgHpFbN7VcqbxOA5CalBf3NbzG +PYe4JSP8fwtLcDUj54GDrgX4vvZ8JlCqdAu8HUCaBfECgYEA+Mw92Olmx8OmJVLS +RURXlcMUuRe+5z9CHYfvjavdobcsyQ1xOlZJqm0wlEr3PIVAdvDKb9ErpDDtX/LW +NOL6ojz3d+XM6Um786Bn3B1LbDgcxwpSKGqvColspHIs0QnpvZ4s/dRX0WWq0b0S +NjpMFZgqlkOBIknX5P25bPIN7AUCgYEA1Faaja437+/thNetNbG4yHOBtGD25d4C +kblLGD6QvkD1q06BHm9WpVkivltIWuiP8cB0QVynwFv4Cmy0v63AsUw1kb8N2gYd +xXxpkPLRu+EvDGRocCJU6QJol9Lfldo5ir7pScbgUjM3nWIGdbBFW7jv5SzjUQae +odo7QpJbjucCgYBK9D0tvCNay3aih/ERLSW12K/Fk4HP6R7iBrIE3GJI9gZoC8Sw +7o4C6iJYir0xXnOtYZ2bUkjzjkn1PhOKm1cmyXdEh9bT8YLOQuUHS0wNrln9HP7j +bkCNzBkO8dbOo03n8l9bmT1buGVeCrgR3j5NwyoRWwTsb5K7SjUyvTm0gQKBgHRr +NznO92RaC8P17EWwNzvP+KFJOJU3b/ktunqEcx+cxhUyaaCiMsNdZ6suqTEOqT1G +43aismbJBenRSBh/z1JmEkjik1miWNhaKhcKyutTv1PwCULRz/QhGe+D8opap4nm +ukl0/LCU3D0x7ZDBIIX1k7H3NnrKQldDK5KIZCKpAoGBAOjcaDtzpnv07gkaOcZH +KarZMIrgDgN25K/WmYYSY1UC4Xu/pAK+8dva4mvxEELuYPqkhXIhMRVJ9dbCox2x +Nzlu/KIwyQYaRyZgQfrv1nssXuFfxdY8i8zTteRV0awuiOMS36a16sYQCChZp8p3 +PkBuxPbRBLmPg/VkAJE/KbQ8 +-----END PRIVATE KEY----- diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/tunnel.go b/vendor/github.com/mmatczuk/go-http-tunnel/tunnel.go new file mode 100644 index 0000000..18071ee --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/tunnel.go @@ -0,0 +1,14 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import "time" + +var ( + // DefaultTimeout specifies a general purpose timeout. + DefaultTimeout = 10 * time.Second + // DefaultPingTimeout specifies a ping timeout. + DefaultPingTimeout = 500 * time.Millisecond +) diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/backoff.go b/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/backoff.go new file mode 100644 index 0000000..6e58cf6 --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/backoff.go @@ -0,0 +1,52 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +// Automatically generated by MockGen. DO NOT EDIT! +// Source: github.com/mmatczuk/go-http-tunnel (interfaces: Backoff) + +package tunnelmock + +import ( + gomock "github.com/golang/mock/gomock" + time "time" +) + +// Mock of Backoff interface +type MockBackoff struct { + ctrl *gomock.Controller + recorder *_MockBackoffRecorder +} + +// Recorder for MockBackoff (not exported) +type _MockBackoffRecorder struct { + mock *MockBackoff +} + +func NewMockBackoff(ctrl *gomock.Controller) *MockBackoff { + mock := &MockBackoff{ctrl: ctrl} + mock.recorder = &_MockBackoffRecorder{mock} + return mock +} + +func (_m *MockBackoff) EXPECT() *_MockBackoffRecorder { + return _m.recorder +} + +func (_m *MockBackoff) NextBackOff() time.Duration { + ret := _m.ctrl.Call(_m, "NextBackOff") + ret0, _ := ret[0].(time.Duration) + return ret0 +} + +func (_mr *_MockBackoffRecorder) NextBackOff() *gomock.Call { + return _mr.mock.ctrl.RecordCall(_mr.mock, "NextBackOff") +} + +func (_m *MockBackoff) Reset() { + _m.ctrl.Call(_m, "Reset") +} + +func (_mr *_MockBackoffRecorder) Reset() *gomock.Call { + return _mr.mock.ctrl.RecordCall(_mr.mock, "Reset") +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/logger.go b/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/logger.go new file mode 100644 index 0000000..aad6dec --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/tunnelmock/logger.go @@ -0,0 +1,45 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +// Automatically generated by MockGen. DO NOT EDIT! +// Source: github.com/mmatczuk/go-http-tunnel/log (interfaces: Logger) + +package tunnelmock + +import ( + gomock "github.com/golang/mock/gomock" +) + +// Mock of Logger interface +type MockLogger struct { + ctrl *gomock.Controller + recorder *_MockLoggerRecorder +} + +// Recorder for MockLogger (not exported) +type _MockLoggerRecorder struct { + mock *MockLogger +} + +func NewMockLogger(ctrl *gomock.Controller) *MockLogger { + mock := &MockLogger{ctrl: ctrl} + mock.recorder = &_MockLoggerRecorder{mock} + return mock +} + +func (_m *MockLogger) EXPECT() *_MockLoggerRecorder { + return _m.recorder +} + +func (_m *MockLogger) Log(_param0 ...interface{}) error { + _s := []interface{}{} + _s = append(_s, _param0...) + ret := _m.ctrl.Call(_m, "Log", _s...) + ret0, _ := ret[0].(error) + return ret0 +} + +func (_mr *_MockLoggerRecorder) Log(arg0 ...interface{}) *gomock.Call { + return _mr.mock.ctrl.RecordCall(_mr.mock, "Log", arg0...) +} diff --git a/vendor/github.com/mmatczuk/go-http-tunnel/utils.go b/vendor/github.com/mmatczuk/go-http-tunnel/utils.go new file mode 100644 index 0000000..474ab8a --- /dev/null +++ b/vendor/github.com/mmatczuk/go-http-tunnel/utils.go @@ -0,0 +1,87 @@ +// Copyright (C) 2017 Michał Matczuk +// Use of this source code is governed by an AGPL-style +// license that can be found in the LICENSE file. + +package tunnel + +import ( + "io" + "net" + "net/http" + "strings" + + "github.com/mmatczuk/go-http-tunnel/log" +) + +func transfer(dst io.Writer, src io.Reader, logger log.Logger) { + n, err := io.Copy(dst, src) + if err != nil { + if !strings.Contains(err.Error(), "context canceled") && !strings.Contains(err.Error(), "CANCEL") { + logger.Log( + "level", 2, + "msg", "copy error", + "err", err, + ) + } + } + + logger.Log( + "level", 3, + "action", "transferred", + "bytes", n, + ) +} + +func setXForwardedFor(h http.Header, remoteAddr string) { + clientIP, _, err := net.SplitHostPort(remoteAddr) + if err == nil { + // If we aren't the first proxy retain prior + // X-Forwarded-For information as a comma+space + // separated list and fold multiple headers into one. + if prior, ok := h["X-Forwarded-For"]; ok { + clientIP = strings.Join(prior, ", ") + ", " + clientIP + } + h.Set("X-Forwarded-For", clientIP) + } +} + +func cloneHeader(h http.Header) http.Header { + h2 := make(http.Header, len(h)) + for k, vv := range h { + vv2 := make([]string, len(vv)) + copy(vv2, vv) + h2[k] = vv2 + } + return h2 +} + +func copyHeader(dst, src http.Header) { + for k, v := range src { + vv := make([]string, len(v)) + copy(vv, v) + dst[k] = vv + } +} + +type countWriter struct { + w io.Writer + count int64 +} + +func (cw *countWriter) Write(p []byte) (n int, err error) { + n, err = cw.w.Write(p) + cw.count += int64(n) + return +} + +type flushWriter struct { + w io.Writer +} + +func (fw flushWriter) Write(p []byte) (n int, err error) { + n, err = fw.w.Write(p) + if f, ok := fw.w.(http.Flusher); ok { + f.Flush() + } + return +} diff --git a/vendor/gopkg.in/yaml.v2/.travis.yml b/vendor/gopkg.in/yaml.v2/.travis.yml index 004172a..9f55693 100644 --- a/vendor/gopkg.in/yaml.v2/.travis.yml +++ b/vendor/gopkg.in/yaml.v2/.travis.yml @@ -4,6 +4,9 @@ go: - 1.4 - 1.5 - 1.6 + - 1.7 + - 1.8 + - 1.9 - tip go_import_path: gopkg.in/yaml.v2 diff --git a/vendor/gopkg.in/yaml.v2/NOTICE b/vendor/gopkg.in/yaml.v2/NOTICE new file mode 100644 index 0000000..866d74a --- /dev/null +++ b/vendor/gopkg.in/yaml.v2/NOTICE @@ -0,0 +1,13 @@ +Copyright 2011-2016 Canonical Ltd. + +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. diff --git a/vendor/gopkg.in/yaml.v2/README.md b/vendor/gopkg.in/yaml.v2/README.md index 7a512d6..b50c6e8 100644 --- a/vendor/gopkg.in/yaml.v2/README.md +++ b/vendor/gopkg.in/yaml.v2/README.md @@ -48,8 +48,6 @@ The yaml package is licensed under the Apache License 2.0. Please see the LICENS Example ------- -Some more examples can be found in the "examples" folder. - ```Go package main @@ -67,6 +65,8 @@ b: d: [3, 4] ` +// Note: struct fields must be public in order for unmarshal to +// correctly populate the data. type T struct { A string B struct { diff --git a/vendor/gopkg.in/yaml.v2/apic.go b/vendor/gopkg.in/yaml.v2/apic.go index 95ec014..1f7e87e 100644 --- a/vendor/gopkg.in/yaml.v2/apic.go +++ b/vendor/gopkg.in/yaml.v2/apic.go @@ -2,7 +2,6 @@ package yaml import ( "io" - "os" ) func yaml_insert_token(parser *yaml_parser_t, pos int, token *yaml_token_t) { @@ -48,9 +47,9 @@ func yaml_string_read_handler(parser *yaml_parser_t, buffer []byte) (n int, err return n, nil } -// File read handler. -func yaml_file_read_handler(parser *yaml_parser_t, buffer []byte) (n int, err error) { - return parser.input_file.Read(buffer) +// Reader read handler. +func yaml_reader_read_handler(parser *yaml_parser_t, buffer []byte) (n int, err error) { + return parser.input_reader.Read(buffer) } // Set a string input. @@ -64,12 +63,12 @@ func yaml_parser_set_input_string(parser *yaml_parser_t, input []byte) { } // Set a file input. -func yaml_parser_set_input_file(parser *yaml_parser_t, file *os.File) { +func yaml_parser_set_input_reader(parser *yaml_parser_t, r io.Reader) { if parser.read_handler != nil { panic("must set the input source only once") } - parser.read_handler = yaml_file_read_handler - parser.input_file = file + parser.read_handler = yaml_reader_read_handler + parser.input_reader = r } // Set the source encoding. @@ -81,14 +80,13 @@ func yaml_parser_set_encoding(parser *yaml_parser_t, encoding yaml_encoding_t) { } // Create a new emitter object. -func yaml_emitter_initialize(emitter *yaml_emitter_t) bool { +func yaml_emitter_initialize(emitter *yaml_emitter_t) { *emitter = yaml_emitter_t{ buffer: make([]byte, output_buffer_size), raw_buffer: make([]byte, 0, output_raw_buffer_size), states: make([]yaml_emitter_state_t, 0, initial_stack_size), events: make([]yaml_event_t, 0, initial_queue_size), } - return true } // Destroy an emitter object. @@ -102,9 +100,10 @@ func yaml_string_write_handler(emitter *yaml_emitter_t, buffer []byte) error { return nil } -// File write handler. -func yaml_file_write_handler(emitter *yaml_emitter_t, buffer []byte) error { - _, err := emitter.output_file.Write(buffer) +// yaml_writer_write_handler uses emitter.output_writer to write the +// emitted text. +func yaml_writer_write_handler(emitter *yaml_emitter_t, buffer []byte) error { + _, err := emitter.output_writer.Write(buffer) return err } @@ -118,12 +117,12 @@ func yaml_emitter_set_output_string(emitter *yaml_emitter_t, output_buffer *[]by } // Set a file output. -func yaml_emitter_set_output_file(emitter *yaml_emitter_t, file io.Writer) { +func yaml_emitter_set_output_writer(emitter *yaml_emitter_t, w io.Writer) { if emitter.write_handler != nil { panic("must set the output target only once") } - emitter.write_handler = yaml_file_write_handler - emitter.output_file = file + emitter.write_handler = yaml_writer_write_handler + emitter.output_writer = w } // Set the output encoding. @@ -252,41 +251,41 @@ func yaml_emitter_set_break(emitter *yaml_emitter_t, line_break yaml_break_t) { // // Create STREAM-START. -func yaml_stream_start_event_initialize(event *yaml_event_t, encoding yaml_encoding_t) bool { +func yaml_stream_start_event_initialize(event *yaml_event_t, encoding yaml_encoding_t) { *event = yaml_event_t{ typ: yaml_STREAM_START_EVENT, encoding: encoding, } - return true } // Create STREAM-END. -func yaml_stream_end_event_initialize(event *yaml_event_t) bool { +func yaml_stream_end_event_initialize(event *yaml_event_t) { *event = yaml_event_t{ typ: yaml_STREAM_END_EVENT, } - return true } // Create DOCUMENT-START. -func yaml_document_start_event_initialize(event *yaml_event_t, version_directive *yaml_version_directive_t, - tag_directives []yaml_tag_directive_t, implicit bool) bool { +func yaml_document_start_event_initialize( + event *yaml_event_t, + version_directive *yaml_version_directive_t, + tag_directives []yaml_tag_directive_t, + implicit bool, +) { *event = yaml_event_t{ typ: yaml_DOCUMENT_START_EVENT, version_directive: version_directive, tag_directives: tag_directives, implicit: implicit, } - return true } // Create DOCUMENT-END. -func yaml_document_end_event_initialize(event *yaml_event_t, implicit bool) bool { +func yaml_document_end_event_initialize(event *yaml_event_t, implicit bool) { *event = yaml_event_t{ typ: yaml_DOCUMENT_END_EVENT, implicit: implicit, } - return true } ///* @@ -348,7 +347,7 @@ func yaml_sequence_end_event_initialize(event *yaml_event_t) bool { } // Create MAPPING-START. -func yaml_mapping_start_event_initialize(event *yaml_event_t, anchor, tag []byte, implicit bool, style yaml_mapping_style_t) bool { +func yaml_mapping_start_event_initialize(event *yaml_event_t, anchor, tag []byte, implicit bool, style yaml_mapping_style_t) { *event = yaml_event_t{ typ: yaml_MAPPING_START_EVENT, anchor: anchor, @@ -356,15 +355,13 @@ func yaml_mapping_start_event_initialize(event *yaml_event_t, anchor, tag []byte implicit: implicit, style: yaml_style_t(style), } - return true } // Create MAPPING-END. -func yaml_mapping_end_event_initialize(event *yaml_event_t) bool { +func yaml_mapping_end_event_initialize(event *yaml_event_t) { *event = yaml_event_t{ typ: yaml_MAPPING_END_EVENT, } - return true } // Destroy an event object. @@ -471,7 +468,7 @@ func yaml_event_delete(event *yaml_event_t) { // } context // tag_directive *yaml_tag_directive_t // -// context.error = YAML_NO_ERROR // Eliminate a compliler warning. +// context.error = YAML_NO_ERROR // Eliminate a compiler warning. // // assert(document) // Non-NULL document object is expected. // diff --git a/vendor/gopkg.in/yaml.v2/decode.go b/vendor/gopkg.in/yaml.v2/decode.go index b38e6ec..e4e56e2 100644 --- a/vendor/gopkg.in/yaml.v2/decode.go +++ b/vendor/gopkg.in/yaml.v2/decode.go @@ -4,6 +4,7 @@ import ( "encoding" "encoding/base64" "fmt" + "io" "math" "reflect" "strconv" @@ -22,19 +23,22 @@ type node struct { kind int line, column int tag string - value string - implicit bool - children []*node - anchors map[string]*node + // For an alias node, alias holds the resolved alias. + alias *node + value string + implicit bool + children []*node + anchors map[string]*node } // ---------------------------------------------------------------------------- // Parser, produces a node tree out of a libyaml event stream. type parser struct { - parser yaml_parser_t - event yaml_event_t - doc *node + parser yaml_parser_t + event yaml_event_t + doc *node + doneInit bool } func newParser(b []byte) *parser { @@ -42,21 +46,30 @@ func newParser(b []byte) *parser { if !yaml_parser_initialize(&p.parser) { panic("failed to initialize YAML emitter") } - if len(b) == 0 { b = []byte{'\n'} } - yaml_parser_set_input_string(&p.parser, b) + return &p +} - p.skip() - if p.event.typ != yaml_STREAM_START_EVENT { - panic("expected stream start event, got " + strconv.Itoa(int(p.event.typ))) +func newParserFromReader(r io.Reader) *parser { + p := parser{} + if !yaml_parser_initialize(&p.parser) { + panic("failed to initialize YAML emitter") } - p.skip() + yaml_parser_set_input_reader(&p.parser, r) return &p } +func (p *parser) init() { + if p.doneInit { + return + } + p.expect(yaml_STREAM_START_EVENT) + p.doneInit = true +} + func (p *parser) destroy() { if p.event.typ != yaml_NO_EVENT { yaml_event_delete(&p.event) @@ -64,16 +77,35 @@ func (p *parser) destroy() { yaml_parser_delete(&p.parser) } -func (p *parser) skip() { - if p.event.typ != yaml_NO_EVENT { - if p.event.typ == yaml_STREAM_END_EVENT { - failf("attempted to go past the end of stream; corrupted value?") +// expect consumes an event from the event stream and +// checks that it's of the expected type. +func (p *parser) expect(e yaml_event_type_t) { + if p.event.typ == yaml_NO_EVENT { + if !yaml_parser_parse(&p.parser, &p.event) { + p.fail() } - yaml_event_delete(&p.event) + } + if p.event.typ == yaml_STREAM_END_EVENT { + failf("attempted to go past the end of stream; corrupted value?") + } + if p.event.typ != e { + p.parser.problem = fmt.Sprintf("expected %s event but got %s", e, p.event.typ) + p.fail() + } + yaml_event_delete(&p.event) + p.event.typ = yaml_NO_EVENT +} + +// peek peeks at the next event in the event stream, +// puts the results into p.event and returns the event type. +func (p *parser) peek() yaml_event_type_t { + if p.event.typ != yaml_NO_EVENT { + return p.event.typ } if !yaml_parser_parse(&p.parser, &p.event) { p.fail() } + return p.event.typ } func (p *parser) fail() { @@ -81,6 +113,10 @@ func (p *parser) fail() { var line int if p.parser.problem_mark.line != 0 { line = p.parser.problem_mark.line + // Scanner errors don't iterate line before returning error + if p.parser.error == yaml_SCANNER_ERROR { + line++ + } } else if p.parser.context_mark.line != 0 { line = p.parser.context_mark.line } @@ -103,7 +139,8 @@ func (p *parser) anchor(n *node, anchor []byte) { } func (p *parser) parse() *node { - switch p.event.typ { + p.init() + switch p.peek() { case yaml_SCALAR_EVENT: return p.scalar() case yaml_ALIAS_EVENT: @@ -118,7 +155,7 @@ func (p *parser) parse() *node { // Happens when attempting to decode an empty buffer. return nil default: - panic("attempted to parse unknown event: " + strconv.Itoa(int(p.event.typ))) + panic("attempted to parse unknown event: " + p.event.typ.String()) } } @@ -134,19 +171,20 @@ func (p *parser) document() *node { n := p.node(documentNode) n.anchors = make(map[string]*node) p.doc = n - p.skip() + p.expect(yaml_DOCUMENT_START_EVENT) n.children = append(n.children, p.parse()) - if p.event.typ != yaml_DOCUMENT_END_EVENT { - panic("expected end of document event but got " + strconv.Itoa(int(p.event.typ))) - } - p.skip() + p.expect(yaml_DOCUMENT_END_EVENT) return n } func (p *parser) alias() *node { n := p.node(aliasNode) n.value = string(p.event.anchor) - p.skip() + n.alias = p.doc.anchors[n.value] + if n.alias == nil { + failf("unknown anchor '%s' referenced", n.value) + } + p.expect(yaml_ALIAS_EVENT) return n } @@ -156,29 +194,29 @@ func (p *parser) scalar() *node { n.tag = string(p.event.tag) n.implicit = p.event.implicit p.anchor(n, p.event.anchor) - p.skip() + p.expect(yaml_SCALAR_EVENT) return n } func (p *parser) sequence() *node { n := p.node(sequenceNode) p.anchor(n, p.event.anchor) - p.skip() - for p.event.typ != yaml_SEQUENCE_END_EVENT { + p.expect(yaml_SEQUENCE_START_EVENT) + for p.peek() != yaml_SEQUENCE_END_EVENT { n.children = append(n.children, p.parse()) } - p.skip() + p.expect(yaml_SEQUENCE_END_EVENT) return n } func (p *parser) mapping() *node { n := p.node(mappingNode) p.anchor(n, p.event.anchor) - p.skip() - for p.event.typ != yaml_MAPPING_END_EVENT { + p.expect(yaml_MAPPING_START_EVENT) + for p.peek() != yaml_MAPPING_END_EVENT { n.children = append(n.children, p.parse(), p.parse()) } - p.skip() + p.expect(yaml_MAPPING_END_EVENT) return n } @@ -187,7 +225,7 @@ func (p *parser) mapping() *node { type decoder struct { doc *node - aliases map[string]bool + aliases map[*node]bool mapType reflect.Type terrors []string strict bool @@ -198,11 +236,13 @@ var ( durationType = reflect.TypeOf(time.Duration(0)) defaultMapType = reflect.TypeOf(map[interface{}]interface{}{}) ifaceType = defaultMapType.Elem() + timeType = reflect.TypeOf(time.Time{}) + ptrTimeType = reflect.TypeOf(&time.Time{}) ) func newDecoder(strict bool) *decoder { d := &decoder{mapType: defaultMapType, strict: strict} - d.aliases = make(map[string]bool) + d.aliases = make(map[*node]bool) return d } @@ -308,16 +348,13 @@ func (d *decoder) document(n *node, out reflect.Value) (good bool) { } func (d *decoder) alias(n *node, out reflect.Value) (good bool) { - an, ok := d.doc.anchors[n.value] - if !ok { - failf("unknown anchor '%s' referenced", n.value) - } - if d.aliases[n.value] { + if d.aliases[n] { + // TODO this could actually be allowed in some circumstances. failf("anchor '%s' value contains itself", n.value) } - d.aliases[n.value] = true - good = d.unmarshal(an, out) - delete(d.aliases, n.value) + d.aliases[n] = true + good = d.unmarshal(n.alias, out) + delete(d.aliases, n) return good } @@ -329,7 +366,7 @@ func resetMap(out reflect.Value) { } } -func (d *decoder) scalar(n *node, out reflect.Value) (good bool) { +func (d *decoder) scalar(n *node, out reflect.Value) bool { var tag string var resolved interface{} if n.tag == "" && !n.implicit { @@ -353,9 +390,26 @@ func (d *decoder) scalar(n *node, out reflect.Value) (good bool) { } return true } - if s, ok := resolved.(string); ok && out.CanAddr() { - if u, ok := out.Addr().Interface().(encoding.TextUnmarshaler); ok { - err := u.UnmarshalText([]byte(s)) + if resolvedv := reflect.ValueOf(resolved); out.Type() == resolvedv.Type() { + // We've resolved to exactly the type we want, so use that. + out.Set(resolvedv) + return true + } + // Perhaps we can use the value as a TextUnmarshaler to + // set its value. + if out.CanAddr() { + u, ok := out.Addr().Interface().(encoding.TextUnmarshaler) + if ok { + var text []byte + if tag == yaml_BINARY_TAG { + text = []byte(resolved.(string)) + } else { + // We let any value be unmarshaled into TextUnmarshaler. + // That might be more lax than we'd like, but the + // TextUnmarshaler itself should bowl out any dubious values. + text = []byte(n.value) + } + err := u.UnmarshalText(text) if err != nil { fail(err) } @@ -366,46 +420,54 @@ func (d *decoder) scalar(n *node, out reflect.Value) (good bool) { case reflect.String: if tag == yaml_BINARY_TAG { out.SetString(resolved.(string)) - good = true - } else if resolved != nil { + return true + } + if resolved != nil { out.SetString(n.value) - good = true + return true } case reflect.Interface: if resolved == nil { out.Set(reflect.Zero(out.Type())) + } else if tag == yaml_TIMESTAMP_TAG { + // It looks like a timestamp but for backward compatibility + // reasons we set it as a string, so that code that unmarshals + // timestamp-like values into interface{} will continue to + // see a string and not a time.Time. + // TODO(v3) Drop this. + out.Set(reflect.ValueOf(n.value)) } else { out.Set(reflect.ValueOf(resolved)) } - good = true + return true case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: switch resolved := resolved.(type) { case int: if !out.OverflowInt(int64(resolved)) { out.SetInt(int64(resolved)) - good = true + return true } case int64: if !out.OverflowInt(resolved) { out.SetInt(resolved) - good = true + return true } case uint64: if resolved <= math.MaxInt64 && !out.OverflowInt(int64(resolved)) { out.SetInt(int64(resolved)) - good = true + return true } case float64: if resolved <= math.MaxInt64 && !out.OverflowInt(int64(resolved)) { out.SetInt(int64(resolved)) - good = true + return true } case string: if out.Type() == durationType { d, err := time.ParseDuration(resolved) if err == nil { out.SetInt(int64(d)) - good = true + return true } } } @@ -414,44 +476,49 @@ func (d *decoder) scalar(n *node, out reflect.Value) (good bool) { case int: if resolved >= 0 && !out.OverflowUint(uint64(resolved)) { out.SetUint(uint64(resolved)) - good = true + return true } case int64: if resolved >= 0 && !out.OverflowUint(uint64(resolved)) { out.SetUint(uint64(resolved)) - good = true + return true } case uint64: if !out.OverflowUint(uint64(resolved)) { out.SetUint(uint64(resolved)) - good = true + return true } case float64: if resolved <= math.MaxUint64 && !out.OverflowUint(uint64(resolved)) { out.SetUint(uint64(resolved)) - good = true + return true } } case reflect.Bool: switch resolved := resolved.(type) { case bool: out.SetBool(resolved) - good = true + return true } case reflect.Float32, reflect.Float64: switch resolved := resolved.(type) { case int: out.SetFloat(float64(resolved)) - good = true + return true case int64: out.SetFloat(float64(resolved)) - good = true + return true case uint64: out.SetFloat(float64(resolved)) - good = true + return true case float64: out.SetFloat(resolved) - good = true + return true + } + case reflect.Struct: + if resolvedv := reflect.ValueOf(resolved); out.Type() == resolvedv.Type() { + out.Set(resolvedv) + return true } case reflect.Ptr: if out.Type().Elem() == reflect.TypeOf(resolved) { @@ -459,13 +526,11 @@ func (d *decoder) scalar(n *node, out reflect.Value) (good bool) { elem := reflect.New(out.Type().Elem()) elem.Elem().Set(reflect.ValueOf(resolved)) out.Set(elem) - good = true + return true } } - if !good { - d.terror(n, tag, out) - } - return good + d.terror(n, tag, out) + return false } func settableValueOf(i interface{}) reflect.Value { @@ -482,6 +547,10 @@ func (d *decoder) sequence(n *node, out reflect.Value) (good bool) { switch out.Kind() { case reflect.Slice: out.Set(reflect.MakeSlice(out.Type(), l, l)) + case reflect.Array: + if l != out.Len() { + failf("invalid array: want %d elements but got %d", out.Len(), l) + } case reflect.Interface: // No type hints. Will have to use a generic sequence. iface = out @@ -500,7 +569,9 @@ func (d *decoder) sequence(n *node, out reflect.Value) (good bool) { j++ } } - out.Set(out.Slice(0, j)) + if out.Kind() != reflect.Array { + out.Set(out.Slice(0, j)) + } if iface.IsValid() { iface.Set(out) } @@ -561,7 +632,7 @@ func (d *decoder) mapping(n *node, out reflect.Value) (good bool) { } e := reflect.New(et).Elem() if d.unmarshal(n.children[i+1], e) { - out.SetMapIndex(k, e) + d.setMapIndex(n.children[i+1], out, k, e) } } } @@ -569,6 +640,14 @@ func (d *decoder) mapping(n *node, out reflect.Value) (good bool) { return true } +func (d *decoder) setMapIndex(n *node, out, k, v reflect.Value) { + if d.strict && out.MapIndex(k) != zeroValue { + d.terrors = append(d.terrors, fmt.Sprintf("line %d: key %#v already set in map", n.line+1, k.Interface())) + return + } + out.SetMapIndex(k, v) +} + func (d *decoder) mappingSlice(n *node, out reflect.Value) (good bool) { outt := out.Type() if outt.Elem() != mapItemType { @@ -616,6 +695,10 @@ func (d *decoder) mappingStruct(n *node, out reflect.Value) (good bool) { elemType = inlineMap.Type().Elem() } + var doneFields []bool + if d.strict { + doneFields = make([]bool, len(sinfo.FieldsList)) + } for i := 0; i < l; i += 2 { ni := n.children[i] if isMerge(ni) { @@ -626,6 +709,13 @@ func (d *decoder) mappingStruct(n *node, out reflect.Value) (good bool) { continue } if info, ok := sinfo.FieldsMap[name.String()]; ok { + if d.strict { + if doneFields[info.Id] { + d.terrors = append(d.terrors, fmt.Sprintf("line %d: field %s already set in type %s", ni.line+1, name.String(), out.Type())) + continue + } + doneFields[info.Id] = true + } var field reflect.Value if info.Inline == nil { field = out.Field(info.Num) @@ -639,9 +729,9 @@ func (d *decoder) mappingStruct(n *node, out reflect.Value) (good bool) { } value := reflect.New(elemType).Elem() d.unmarshal(n.children[i+1], value) - inlineMap.SetMapIndex(name, value) + d.setMapIndex(n.children[i+1], inlineMap, name, value) } else if d.strict { - d.terrors = append(d.terrors, fmt.Sprintf("line %d: field %s not found in struct %s", n.line+1, name.String(), out.Type())) + d.terrors = append(d.terrors, fmt.Sprintf("line %d: field %s not found in type %s", ni.line+1, name.String(), out.Type())) } } return true diff --git a/vendor/gopkg.in/yaml.v2/decode_test.go b/vendor/gopkg.in/yaml.v2/decode_test.go index 770c716..b05c466 100644 --- a/vendor/gopkg.in/yaml.v2/decode_test.go +++ b/vendor/gopkg.in/yaml.v2/decode_test.go @@ -2,13 +2,14 @@ package yaml_test import ( "errors" - . "gopkg.in/check.v1" - "gopkg.in/yaml.v2" + "io" "math" - "net" "reflect" "strings" "time" + + . "gopkg.in/check.v1" + "gopkg.in/yaml.v2" ) var unmarshalIntTest = 123 @@ -19,8 +20,9 @@ var unmarshalTests = []struct { }{ { "", - &struct{}{}, - }, { + (*struct{})(nil), + }, + { "{}", &struct{}{}, }, { "v: hi", @@ -127,6 +129,9 @@ var unmarshalTests = []struct { }, { "bin: -0b101010", map[string]interface{}{"bin": -42}, + }, { + "bin: -0b1000000000000000000000000000000000000000000000000000000000000000", + map[string]interface{}{"bin": -9223372036854775808}, }, { "decimal: +685_230", map[string]int{"decimal": 685230}, @@ -239,6 +244,9 @@ var unmarshalTests = []struct { }, { "a: [1, 2]", &struct{ A []int }{[]int{1, 2}}, + }, { + "a: [1, 2]", + &struct{ A [2]int }{[2]int{1, 2}}, }, { "a: 1", &struct{ B int }{0}, @@ -397,6 +405,12 @@ var unmarshalTests = []struct { { "v: !!float '1.1'", map[string]interface{}{"v": 1.1}, + }, { + "v: !!float 0", + map[string]interface{}{"v": float64(0)}, + }, { + "v: !!float -1", + map[string]interface{}{"v": float64(-1)}, }, { "v: !!null ''", map[string]interface{}{"v": nil}, @@ -425,13 +439,6 @@ var unmarshalTests = []struct { }, { "a: &a [1, 2]\nb: *a", &struct{ B []int }{[]int{1, 2}}, - }, { - "b: *a\na: &a {c: 1}", - &struct { - A, B struct { - C int - } - }{struct{ C int }{1}, struct{ C int }{1}}, }, // Bug #1133337 @@ -517,6 +524,18 @@ var unmarshalTests = []struct { map[string]interface{}{"a": "50cent_of_dollar"}, }, + // issue #295 (allow scalars with colons in flow mappings and sequences) + { + "a: {b: https://github.com/go-yaml/yaml}", + map[string]interface{}{"a": map[interface{}]interface{}{ + "b": "https://github.com/go-yaml/yaml", + }}, + }, + { + "a: [https://github.com/go-yaml/yaml]", + map[string]interface{}{"a": []interface{}{"https://github.com/go-yaml/yaml"}}, + }, + // Duration { "a: 3s", @@ -568,11 +587,80 @@ var unmarshalTests = []struct { // Support encoding.TextUnmarshaler. { "a: 1.2.3.4\n", - map[string]net.IP{"a": net.IPv4(1, 2, 3, 4)}, + map[string]textUnmarshaler{"a": textUnmarshaler{S: "1.2.3.4"}}, }, { "a: 2015-02-24T18:19:39Z\n", - map[string]time.Time{"a": time.Unix(1424801979, 0).In(time.UTC)}, + map[string]textUnmarshaler{"a": textUnmarshaler{"2015-02-24T18:19:39Z"}}, + }, + + // Timestamps + { + // Date only. + "a: 2015-01-01\n", + map[string]time.Time{"a": time.Date(2015, 1, 1, 0, 0, 0, 0, time.UTC)}, + }, + { + // RFC3339 + "a: 2015-02-24T18:19:39.12Z\n", + map[string]time.Time{"a": time.Date(2015, 2, 24, 18, 19, 39, .12e9, time.UTC)}, + }, + { + // RFC3339 with short dates. + "a: 2015-2-3T3:4:5Z", + map[string]time.Time{"a": time.Date(2015, 2, 3, 3, 4, 5, 0, time.UTC)}, + }, + { + // ISO8601 lower case t + "a: 2015-02-24t18:19:39Z\n", + map[string]time.Time{"a": time.Date(2015, 2, 24, 18, 19, 39, 0, time.UTC)}, + }, + { + // space separate, no time zone + "a: 2015-02-24 18:19:39\n", + map[string]time.Time{"a": time.Date(2015, 2, 24, 18, 19, 39, 0, time.UTC)}, + }, + // Some cases not currently handled. Uncomment these when + // the code is fixed. + // { + // // space separated with time zone + // "a: 2001-12-14 21:59:43.10 -5", + // map[string]interface{}{"a": time.Date(2001, 12, 14, 21, 59, 43, .1e9, time.UTC)}, + // }, + // { + // // arbitrary whitespace between fields + // "a: 2001-12-14 \t\t \t21:59:43.10 \t Z", + // map[string]interface{}{"a": time.Date(2001, 12, 14, 21, 59, 43, .1e9, time.UTC)}, + // }, + { + // explicit string tag + "a: !!str 2015-01-01", + map[string]interface{}{"a": "2015-01-01"}, + }, + { + // explicit timestamp tag on quoted string + "a: !!timestamp \"2015-01-01\"", + map[string]time.Time{"a": time.Date(2015, 1, 1, 0, 0, 0, 0, time.UTC)}, + }, + { + // explicit timestamp tag on unquoted string + "a: !!timestamp 2015-01-01", + map[string]time.Time{"a": time.Date(2015, 1, 1, 0, 0, 0, 0, time.UTC)}, + }, + { + // quoted string that's a valid timestamp + "a: \"2015-01-01\"", + map[string]interface{}{"a": "2015-01-01"}, + }, + { + // explicit timestamp tag into interface. + "a: !!timestamp \"2015-01-01\"", + map[string]interface{}{"a": "2015-01-01"}, + }, + { + // implicit timestamp tag into interface. + "a: 2015-01-01", + map[string]interface{}{"a": "2015-01-01"}, }, // Encode empty lists as zero-length slices. @@ -611,6 +699,29 @@ var unmarshalTests = []struct { "a: 123456E1\n", M{"a": "123456E1"}, }, + // yaml-test-suite 3GZX: Spec Example 7.1. Alias Nodes + { + "First occurrence: &anchor Foo\nSecond occurrence: *anchor\nOverride anchor: &anchor Bar\nReuse anchor: *anchor\n", + map[interface{}]interface{}{ + "Reuse anchor": "Bar", + "First occurrence": "Foo", + "Second occurrence": "Foo", + "Override anchor": "Bar", + }, + }, + // Single document with garbage following it. + { + "---\nhello\n...\n}not yaml", + "hello", + }, + { + "a: 5\n", + &struct{ A jsonNumberT }{"5"}, + }, + { + "a: 5.5\n", + &struct{ A jsonNumberT }{"5.5"}, + }, } type M map[interface{}]interface{} @@ -628,29 +739,99 @@ func (s *S) TestUnmarshal(c *C) { for i, item := range unmarshalTests { c.Logf("test %d: %q", i, item.data) t := reflect.ValueOf(item.value).Type() - var value interface{} - switch t.Kind() { - case reflect.Map: - value = reflect.MakeMap(t).Interface() - case reflect.String: - value = reflect.New(t).Interface() - case reflect.Ptr: - value = reflect.New(t.Elem()).Interface() - default: - c.Fatalf("missing case for %s", t) + value := reflect.New(t) + err := yaml.Unmarshal([]byte(item.data), value.Interface()) + if _, ok := err.(*yaml.TypeError); !ok { + c.Assert(err, IsNil) + } + c.Assert(value.Elem().Interface(), DeepEquals, item.value, Commentf("error: %v", err)) + } +} + +// TODO(v3): This test should also work when unmarshaling onto an interface{}. +func (s *S) TestUnmarshalFullTimestamp(c *C) { + // Full timestamp in same format as encoded. This is confirmed to be + // properly decoded by Python as a timestamp as well. + var str = "2015-02-24T18:19:39.123456789-03:00" + var t time.Time + err := yaml.Unmarshal([]byte(str), &t) + c.Assert(err, IsNil) + c.Assert(t, Equals, time.Date(2015, 2, 24, 18, 19, 39, 123456789, t.Location())) + c.Assert(t.In(time.UTC), Equals, time.Date(2015, 2, 24, 21, 19, 39, 123456789, time.UTC)) +} + +func (s *S) TestDecoderSingleDocument(c *C) { + // Test that Decoder.Decode works as expected on + // all the unmarshal tests. + for i, item := range unmarshalTests { + c.Logf("test %d: %q", i, item.data) + if item.data == "" { + // Behaviour differs when there's no YAML. + continue } - err := yaml.Unmarshal([]byte(item.data), value) + t := reflect.ValueOf(item.value).Type() + value := reflect.New(t) + err := yaml.NewDecoder(strings.NewReader(item.data)).Decode(value.Interface()) if _, ok := err.(*yaml.TypeError); !ok { c.Assert(err, IsNil) } - if t.Kind() == reflect.String { - c.Assert(*value.(*string), Equals, item.value) - } else { - c.Assert(value, DeepEquals, item.value) + c.Assert(value.Elem().Interface(), DeepEquals, item.value) + } +} + +var decoderTests = []struct { + data string + values []interface{} +}{{ + "", + nil, +}, { + "a: b", + []interface{}{ + map[interface{}]interface{}{"a": "b"}, + }, +}, { + "---\na: b\n...\n", + []interface{}{ + map[interface{}]interface{}{"a": "b"}, + }, +}, { + "---\n'hello'\n...\n---\ngoodbye\n...\n", + []interface{}{ + "hello", + "goodbye", + }, +}} + +func (s *S) TestDecoder(c *C) { + for i, item := range decoderTests { + c.Logf("test %d: %q", i, item.data) + var values []interface{} + dec := yaml.NewDecoder(strings.NewReader(item.data)) + for { + var value interface{} + err := dec.Decode(&value) + if err == io.EOF { + break + } + c.Assert(err, IsNil) + values = append(values, value) } + c.Assert(values, DeepEquals, item.values) } } +type errReader struct{} + +func (errReader) Read([]byte) (int, error) { + return 0, errors.New("some read error") +} + +func (s *S) TestDecoderReadError(c *C) { + err := yaml.NewDecoder(errReader{}).Decode(&struct{}{}) + c.Assert(err, ErrorMatches, `yaml: input error: some read error`) +} + func (s *S) TestUnmarshalNaN(c *C) { value := map[string]interface{}{} err := yaml.Unmarshal([]byte("notanum: .NaN"), &value) @@ -664,23 +845,34 @@ var unmarshalErrorTests = []struct { {"v: !!float 'error'", "yaml: cannot decode !!str `error` as a !!float"}, {"v: [A,", "yaml: line 1: did not find expected node content"}, {"v:\n- [A,", "yaml: line 2: did not find expected node content"}, + {"a:\n- b: *,", "yaml: line 2: did not find expected alphabetic or numeric character"}, {"a: *b\n", "yaml: unknown anchor 'b' referenced"}, {"a: &a\n b: *a\n", "yaml: anchor 'a' value contains itself"}, {"value: -", "yaml: block sequence entries are not allowed in this context"}, {"a: !!binary ==", "yaml: !!binary value contains invalid base64 data"}, {"{[.]}", `yaml: invalid map key: \[\]interface \{\}\{"\."\}`}, {"{{.}}", `yaml: invalid map key: map\[interface\ \{\}\]interface \{\}\{".":interface \{\}\(nil\)\}`}, + {"b: *a\na: &a {c: 1}", `yaml: unknown anchor 'a' referenced`}, {"%TAG !%79! tag:yaml.org,2002:\n---\nv: !%79!int '1'", "yaml: did not find expected whitespace"}, } func (s *S) TestUnmarshalErrors(c *C) { - for _, item := range unmarshalErrorTests { + for i, item := range unmarshalErrorTests { + c.Logf("test %d: %q", i, item.data) var value interface{} err := yaml.Unmarshal([]byte(item.data), &value) c.Assert(err, ErrorMatches, item.error, Commentf("Partial unmarshal: %#v", value)) } } +func (s *S) TestDecoderErrors(c *C) { + for _, item := range unmarshalErrorTests { + var value interface{} + err := yaml.NewDecoder(strings.NewReader(item.data)).Decode(&value) + c.Assert(err, ErrorMatches, item.error, Commentf("Partial unmarshal: %#v", value)) + } +} + var unmarshalerTests = []struct { data, tag string value interface{} @@ -991,15 +1183,125 @@ func (s *S) TestUnmarshalSliceOnPreset(c *C) { c.Assert(v.A, DeepEquals, []int{2}) } +var unmarshalStrictTests = []struct { + data string + value interface{} + error string +}{{ + data: "a: 1\nc: 2\n", + value: struct{ A, B int }{A: 1}, + error: `yaml: unmarshal errors:\n line 2: field c not found in type struct { A int; B int }`, +}, { + data: "a: 1\nb: 2\na: 3\n", + value: struct{ A, B int }{A: 3, B: 2}, + error: `yaml: unmarshal errors:\n line 3: field a already set in type struct { A int; B int }`, +}, { + data: "c: 3\na: 1\nb: 2\nc: 4\n", + value: struct { + A int + inlineB `yaml:",inline"` + }{ + A: 1, + inlineB: inlineB{ + B: 2, + inlineC: inlineC{ + C: 4, + }, + }, + }, + error: `yaml: unmarshal errors:\n line 4: field c already set in type struct { A int; yaml_test.inlineB "yaml:\\",inline\\"" }`, +}, { + data: "c: 0\na: 1\nb: 2\nc: 1\n", + value: struct { + A int + inlineB `yaml:",inline"` + }{ + A: 1, + inlineB: inlineB{ + B: 2, + inlineC: inlineC{ + C: 1, + }, + }, + }, + error: `yaml: unmarshal errors:\n line 4: field c already set in type struct { A int; yaml_test.inlineB "yaml:\\",inline\\"" }`, +}, { + data: "c: 1\na: 1\nb: 2\nc: 3\n", + value: struct { + A int + M map[string]interface{} `yaml:",inline"` + }{ + A: 1, + M: map[string]interface{}{ + "b": 2, + "c": 3, + }, + }, + error: `yaml: unmarshal errors:\n line 4: key "c" already set in map`, +}, { + data: "a: 1\n9: 2\nnull: 3\n9: 4", + value: map[interface{}]interface{}{ + "a": 1, + nil: 3, + 9: 4, + }, + error: `yaml: unmarshal errors:\n line 4: key 9 already set in map`, +}} + func (s *S) TestUnmarshalStrict(c *C) { - v := struct{ A, B int }{} - - err := yaml.UnmarshalStrict([]byte("a: 1\nb: 2"), &v) - c.Check(err, IsNil) - err = yaml.Unmarshal([]byte("a: 1\nb: 2\nc: 3"), &v) - c.Check(err, IsNil) - err = yaml.UnmarshalStrict([]byte("a: 1\nb: 2\nc: 3"), &v) - c.Check(err, ErrorMatches, "yaml: unmarshal errors:\n line 1: field c not found in struct struct { A int; B int }") + for i, item := range unmarshalStrictTests { + c.Logf("test %d: %q", i, item.data) + // First test that normal Unmarshal unmarshals to the expected value. + t := reflect.ValueOf(item.value).Type() + value := reflect.New(t) + err := yaml.Unmarshal([]byte(item.data), value.Interface()) + c.Assert(err, Equals, nil) + c.Assert(value.Elem().Interface(), DeepEquals, item.value) + + // Then test that UnmarshalStrict fails on the same thing. + t = reflect.ValueOf(item.value).Type() + value = reflect.New(t) + err = yaml.UnmarshalStrict([]byte(item.data), value.Interface()) + c.Assert(err, ErrorMatches, item.error) + } +} + +type textUnmarshaler struct { + S string +} + +func (t *textUnmarshaler) UnmarshalText(s []byte) error { + t.S = string(s) + return nil +} + +func (s *S) TestFuzzCrashers(c *C) { + cases := []string{ + // runtime error: index out of range + "\"\\0\\\r\n", + + // should not happen + " 0: [\n] 0", + "? ? \"\n\" 0", + " - {\n000}0", + "0:\n 0: [0\n] 0", + " - \"\n000\"0", + " - \"\n000\"\"", + "0:\n - {\n000}0", + "0:\n - \"\n000\"0", + "0:\n - \"\n000\"\"", + + // runtime error: index out of range + " \ufeff\n", + "? \ufeff\n", + "? \ufeff:\n", + "0: \ufeff\n", + "? \ufeff: \ufeff\n", + } + for _, data := range cases { + var v interface{} + _ = yaml.Unmarshal([]byte(data), &v) + } } //var data []byte diff --git a/vendor/gopkg.in/yaml.v2/emitterc.go b/vendor/gopkg.in/yaml.v2/emitterc.go index 41de8b8..a1c2cc5 100644 --- a/vendor/gopkg.in/yaml.v2/emitterc.go +++ b/vendor/gopkg.in/yaml.v2/emitterc.go @@ -2,6 +2,7 @@ package yaml import ( "bytes" + "fmt" ) // Flush the buffer if needed. @@ -664,7 +665,7 @@ func yaml_emitter_emit_node(emitter *yaml_emitter_t, event *yaml_event_t, return yaml_emitter_emit_mapping_start(emitter, event) default: return yaml_emitter_set_emitter_error(emitter, - "expected SCALAR, SEQUENCE-START, MAPPING-START, or ALIAS") + fmt.Sprintf("expected SCALAR, SEQUENCE-START, MAPPING-START, or ALIAS, but got %v", event.typ)) } } @@ -842,7 +843,7 @@ func yaml_emitter_select_scalar_style(emitter *yaml_emitter_t, event *yaml_event return true } -// Write an achor. +// Write an anchor. func yaml_emitter_process_anchor(emitter *yaml_emitter_t) bool { if emitter.anchor_data.anchor == nil { return true @@ -995,9 +996,9 @@ func yaml_emitter_analyze_scalar(emitter *yaml_emitter_t, value []byte) bool { space_break = false preceded_by_whitespace = false - followed_by_whitespace = false - previous_space = false - previous_break = false + followed_by_whitespace = false + previous_space = false + previous_break = false ) emitter.scalar_data.value = value diff --git a/vendor/gopkg.in/yaml.v2/encode.go b/vendor/gopkg.in/yaml.v2/encode.go index 84f8499..0ee738e 100644 --- a/vendor/gopkg.in/yaml.v2/encode.go +++ b/vendor/gopkg.in/yaml.v2/encode.go @@ -3,38 +3,67 @@ package yaml import ( "encoding" "fmt" + "io" "reflect" "regexp" "sort" "strconv" "strings" "time" + "unicode/utf8" ) +// jsonNumber is the interface of the encoding/json.Number datatype. +// Repeating the interface here avoids a dependency on encoding/json, and also +// supports other libraries like jsoniter, which use a similar datatype with +// the same interface. Detecting this interface is useful when dealing with +// structures containing json.Number, which is a string under the hood. The +// encoder should prefer the use of Int64(), Float64() and string(), in that +// order, when encoding this type. +type jsonNumber interface { + Float64() (float64, error) + Int64() (int64, error) + String() string +} + type encoder struct { emitter yaml_emitter_t event yaml_event_t out []byte flow bool + // doneInit holds whether the initial stream_start_event has been + // emitted. + doneInit bool } -func newEncoder() (e *encoder) { - e = &encoder{} - e.must(yaml_emitter_initialize(&e.emitter)) +func newEncoder() *encoder { + e := &encoder{} + yaml_emitter_initialize(&e.emitter) yaml_emitter_set_output_string(&e.emitter, &e.out) yaml_emitter_set_unicode(&e.emitter, true) - e.must(yaml_stream_start_event_initialize(&e.event, yaml_UTF8_ENCODING)) - e.emit() - e.must(yaml_document_start_event_initialize(&e.event, nil, nil, true)) - e.emit() return e } -func (e *encoder) finish() { - e.must(yaml_document_end_event_initialize(&e.event, true)) +func newEncoderWithWriter(w io.Writer) *encoder { + e := &encoder{} + yaml_emitter_initialize(&e.emitter) + yaml_emitter_set_output_writer(&e.emitter, w) + yaml_emitter_set_unicode(&e.emitter, true) + return e +} + +func (e *encoder) init() { + if e.doneInit { + return + } + yaml_stream_start_event_initialize(&e.event, yaml_UTF8_ENCODING) e.emit() + e.doneInit = true +} + +func (e *encoder) finish() { e.emitter.open_ended = false - e.must(yaml_stream_end_event_initialize(&e.event)) + yaml_stream_end_event_initialize(&e.event) e.emit() } @@ -44,9 +73,7 @@ func (e *encoder) destroy() { func (e *encoder) emit() { // This will internally delete the e.event value. - if !yaml_emitter_emit(&e.emitter, &e.event) && e.event.typ != yaml_DOCUMENT_END_EVENT && e.event.typ != yaml_STREAM_END_EVENT { - e.must(false) - } + e.must(yaml_emitter_emit(&e.emitter, &e.event)) } func (e *encoder) must(ok bool) { @@ -59,13 +86,43 @@ func (e *encoder) must(ok bool) { } } +func (e *encoder) marshalDoc(tag string, in reflect.Value) { + e.init() + yaml_document_start_event_initialize(&e.event, nil, nil, true) + e.emit() + e.marshal(tag, in) + yaml_document_end_event_initialize(&e.event, true) + e.emit() +} + func (e *encoder) marshal(tag string, in reflect.Value) { - if !in.IsValid() { + if !in.IsValid() || in.Kind() == reflect.Ptr && in.IsNil() { e.nilv() return } iface := in.Interface() - if m, ok := iface.(Marshaler); ok { + switch m := iface.(type) { + case jsonNumber: + integer, err := m.Int64() + if err == nil { + // In this case the json.Number is a valid int64 + in = reflect.ValueOf(integer) + break + } + float, err := m.Float64() + if err == nil { + // In this case the json.Number is a valid float64 + in = reflect.ValueOf(float) + break + } + // fallback case - no number could be obtained + in = reflect.ValueOf(m.String()) + case time.Time, *time.Time: + // Although time.Time implements TextMarshaler, + // we don't want to treat it as a string for YAML + // purposes because YAML has special support for + // timestamps. + case Marshaler: v, err := m.MarshalYAML() if err != nil { fail(err) @@ -75,31 +132,34 @@ func (e *encoder) marshal(tag string, in reflect.Value) { return } in = reflect.ValueOf(v) - } else if m, ok := iface.(encoding.TextMarshaler); ok { + case encoding.TextMarshaler: text, err := m.MarshalText() if err != nil { fail(err) } in = reflect.ValueOf(string(text)) + case nil: + e.nilv() + return } switch in.Kind() { case reflect.Interface: - if in.IsNil() { - e.nilv() - } else { - e.marshal(tag, in.Elem()) - } + e.marshal(tag, in.Elem()) case reflect.Map: e.mapv(tag, in) case reflect.Ptr: - if in.IsNil() { - e.nilv() + if in.Type() == ptrTimeType { + e.timev(tag, in.Elem()) } else { e.marshal(tag, in.Elem()) } case reflect.Struct: - e.structv(tag, in) - case reflect.Slice: + if in.Type() == timeType { + e.timev(tag, in) + } else { + e.structv(tag, in) + } + case reflect.Slice, reflect.Array: if in.Type().Elem() == mapItemType { e.itemsv(tag, in) } else { @@ -191,10 +251,10 @@ func (e *encoder) mappingv(tag string, f func()) { e.flow = false style = yaml_FLOW_MAPPING_STYLE } - e.must(yaml_mapping_start_event_initialize(&e.event, nil, []byte(tag), implicit, style)) + yaml_mapping_start_event_initialize(&e.event, nil, []byte(tag), implicit, style) e.emit() f() - e.must(yaml_mapping_end_event_initialize(&e.event)) + yaml_mapping_end_event_initialize(&e.event) e.emit() } @@ -240,23 +300,36 @@ var base60float = regexp.MustCompile(`^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+(?:\.[0 func (e *encoder) stringv(tag string, in reflect.Value) { var style yaml_scalar_style_t s := in.String() - rtag, rs := resolve("", s) - if rtag == yaml_BINARY_TAG { - if tag == "" || tag == yaml_STR_TAG { - tag = rtag - s = rs.(string) - } else if tag == yaml_BINARY_TAG { + canUsePlain := true + switch { + case !utf8.ValidString(s): + if tag == yaml_BINARY_TAG { failf("explicitly tagged !!binary data must be base64-encoded") - } else { + } + if tag != "" { failf("cannot marshal invalid UTF-8 data as %s", shortTag(tag)) } + // It can't be encoded directly as YAML so use a binary tag + // and encode it as base64. + tag = yaml_BINARY_TAG + s = encodeBase64(s) + case tag == "": + // Check to see if it would resolve to a specific + // tag when encoded unquoted. If it doesn't, + // there's no need to quote it. + rtag, _ := resolve("", s) + canUsePlain = rtag == yaml_STR_TAG && !isBase60Float(s) } - if tag == "" && (rtag != yaml_STR_TAG || isBase60Float(s)) { - style = yaml_DOUBLE_QUOTED_SCALAR_STYLE - } else if strings.Contains(s, "\n") { + // Note: it's possible for user code to emit invalid YAML + // if they explicitly specify a tag and a string containing + // text that's incompatible with that tag. + switch { + case strings.Contains(s, "\n"): style = yaml_LITERAL_SCALAR_STYLE - } else { + case canUsePlain: style = yaml_PLAIN_SCALAR_STYLE + default: + style = yaml_DOUBLE_QUOTED_SCALAR_STYLE } e.emitScalar(s, "", tag, style) } @@ -281,9 +354,20 @@ func (e *encoder) uintv(tag string, in reflect.Value) { e.emitScalar(s, "", tag, yaml_PLAIN_SCALAR_STYLE) } +func (e *encoder) timev(tag string, in reflect.Value) { + t := in.Interface().(time.Time) + s := t.Format(time.RFC3339Nano) + e.emitScalar(s, "", tag, yaml_PLAIN_SCALAR_STYLE) +} + func (e *encoder) floatv(tag string, in reflect.Value) { - // FIXME: Handle 64 bits here. - s := strconv.FormatFloat(float64(in.Float()), 'g', -1, 32) + // Issue #352: When formatting, use the precision of the underlying value + precision := 64 + if in.Kind() == reflect.Float32 { + precision = 32 + } + + s := strconv.FormatFloat(in.Float(), 'g', -1, precision) switch s { case "+Inf": s = ".inf" diff --git a/vendor/gopkg.in/yaml.v2/encode_test.go b/vendor/gopkg.in/yaml.v2/encode_test.go index 84099bd..4a26600 100644 --- a/vendor/gopkg.in/yaml.v2/encode_test.go +++ b/vendor/gopkg.in/yaml.v2/encode_test.go @@ -1,18 +1,38 @@ package yaml_test import ( + "bytes" "fmt" "math" "strconv" "strings" "time" - . "gopkg.in/check.v1" - "gopkg.in/yaml.v2" "net" "os" + + . "gopkg.in/check.v1" + "gopkg.in/yaml.v2" ) +type jsonNumberT string + +func (j jsonNumberT) Int64() (int64, error) { + val, err := strconv.Atoi(string(j)) + if err != nil { + return 0, err + } + return int64(val), nil +} + +func (j jsonNumberT) Float64() (float64, error) { + return strconv.ParseFloat(string(j), 64) +} + +func (j jsonNumberT) String() string { + return string(j) +} + var marshalIntTest = 123 var marshalTests = []struct { @@ -22,6 +42,9 @@ var marshalTests = []struct { { nil, "null\n", + }, { + (*marshalerType)(nil), + "null\n", }, { &struct{}{}, "{}\n", @@ -70,6 +93,9 @@ var marshalTests = []struct { }, { map[string]interface{}{"v": float64(0.1)}, "v: 0.1\n", + }, { + map[string]interface{}{"v": float32(0.99)}, + "v: 0.99\n", }, { map[string]interface{}{"v": -0.1}, "v: -0.1\n", @@ -142,6 +168,9 @@ var marshalTests = []struct { }, { &struct{ A []int }{[]int{1, 2}}, "a:\n- 1\n- 2\n", + }, { + &struct{ A [2]int }{[2]int{1, 2}}, + "a:\n- 1\n- 2\n", }, { &struct { B int "a" @@ -197,6 +226,25 @@ var marshalTests = []struct { }{1, 0}, "a: 1\n", }, + { + &struct { + T1 time.Time "t1,omitempty" + T2 time.Time "t2,omitempty" + T3 *time.Time "t3,omitempty" + T4 *time.Time "t4,omitempty" + }{ + T2: time.Date(2018, 1, 9, 10, 40, 47, 0, time.UTC), + T4: newTime(time.Date(2098, 1, 9, 10, 40, 47, 0, time.UTC)), + }, + "t2: 2018-01-09T10:40:47Z\nt4: 2098-01-09T10:40:47Z\n", + }, + // Nil interface that implements Marshaler. + { + map[string]yaml.Marshaler{ + "a": nil, + }, + "a: null\n", + }, // Flow flag { @@ -302,10 +350,25 @@ var marshalTests = []struct { map[string]net.IP{"a": net.IPv4(1, 2, 3, 4)}, "a: 1.2.3.4\n", }, + // time.Time gets a timestamp tag. { - map[string]time.Time{"a": time.Unix(1424801979, 0)}, + map[string]time.Time{"a": time.Date(2015, 2, 24, 18, 19, 39, 0, time.UTC)}, "a: 2015-02-24T18:19:39Z\n", }, + { + map[string]*time.Time{"a": newTime(time.Date(2015, 2, 24, 18, 19, 39, 0, time.UTC))}, + "a: 2015-02-24T18:19:39Z\n", + }, + { + // This is confirmed to be properly decoded in Python (libyaml) without a timestamp tag. + map[string]time.Time{"a": time.Date(2015, 2, 24, 18, 19, 39, 123456789, time.FixedZone("FOO", -3*60*60))}, + "a: 2015-02-24T18:19:39.123456789-03:00\n", + }, + // Ensure timestamp-like strings are quoted. + { + map[string]string{"a": "2015-02-24T18:19:39Z"}, + "a: \"2015-02-24T18:19:39Z\"\n", + }, // Ensure strings containing ": " are quoted (reported as PR #43, but not reproducible). { @@ -322,18 +385,68 @@ var marshalTests = []struct { map[string]string{"a": "你好 #comment"}, "a: '你好 #comment'\n", }, + { + map[string]interface{}{"a": jsonNumberT("5")}, + "a: 5\n", + }, + { + map[string]interface{}{"a": jsonNumberT("100.5")}, + "a: 100.5\n", + }, + { + map[string]interface{}{"a": jsonNumberT("bogus")}, + "a: bogus\n", + }, } func (s *S) TestMarshal(c *C) { defer os.Setenv("TZ", os.Getenv("TZ")) os.Setenv("TZ", "UTC") - for _, item := range marshalTests { + for i, item := range marshalTests { + c.Logf("test %d: %q", i, item.data) data, err := yaml.Marshal(item.value) c.Assert(err, IsNil) c.Assert(string(data), Equals, item.data) } } +func (s *S) TestEncoderSingleDocument(c *C) { + for i, item := range marshalTests { + c.Logf("test %d. %q", i, item.data) + var buf bytes.Buffer + enc := yaml.NewEncoder(&buf) + err := enc.Encode(item.value) + c.Assert(err, Equals, nil) + err = enc.Close() + c.Assert(err, Equals, nil) + c.Assert(buf.String(), Equals, item.data) + } +} + +func (s *S) TestEncoderMultipleDocuments(c *C) { + var buf bytes.Buffer + enc := yaml.NewEncoder(&buf) + err := enc.Encode(map[string]string{"a": "b"}) + c.Assert(err, Equals, nil) + err = enc.Encode(map[string]string{"c": "d"}) + c.Assert(err, Equals, nil) + err = enc.Close() + c.Assert(err, Equals, nil) + c.Assert(buf.String(), Equals, "a: b\n---\nc: d\n") +} + +func (s *S) TestEncoderWriteError(c *C) { + enc := yaml.NewEncoder(errorWriter{}) + err := enc.Encode(map[string]string{"a": "b"}) + c.Assert(err, ErrorMatches, `yaml: write error: some write error`) // Data not flushed yet +} + +type errorWriter struct{} + +func (errorWriter) Write([]byte) (int, error) { + return 0, fmt.Errorf("some write error") +} + var marshalErrorTests = []struct { value interface{} error string @@ -455,8 +568,13 @@ func (s *S) TestSortedOutput(c *C) { "1", "2", "a!10", - "a/2", + "a/0001", + "a/002", + "a/3", "a/10", + "a/11", + "a/0012", + "a/100", "a~10", "ab/1", "b/1", @@ -471,6 +589,8 @@ func (s *S) TestSortedOutput(c *C) { "c2.10", "c10.2", "d1", + "d7", + "d7abc", "d12", "d12a", } @@ -499,3 +619,7 @@ func (s *S) TestSortedOutput(c *C) { last = index } } + +func newTime(t time.Time) *time.Time { + return &t +} diff --git a/vendor/gopkg.in/yaml.v2/example_embedded_test.go b/vendor/gopkg.in/yaml.v2/example_embedded_test.go index c8b241d..171c093 100644 --- a/vendor/gopkg.in/yaml.v2/example_embedded_test.go +++ b/vendor/gopkg.in/yaml.v2/example_embedded_test.go @@ -4,7 +4,7 @@ import ( "fmt" "log" - "gopkg.in/yaml.v2" + "gopkg.in/yaml.v2" ) // An example showing how to unmarshal embedded @@ -17,8 +17,8 @@ type StructA struct { type StructB struct { // Embedded structs are not treated as embedded in YAML by default. To do that, // add the ",inline" annotation below - StructA `yaml:",inline"` - B string `yaml:"b"` + StructA `yaml:",inline"` + B string `yaml:"b"` } var data = ` @@ -31,11 +31,11 @@ func ExampleUnmarshal_embedded() { err := yaml.Unmarshal([]byte(data), &b) if err != nil { - log.Fatal("cannot unmarshal data: %v", err) + log.Fatalf("cannot unmarshal data: %v", err) } - fmt.Println(b.A) - fmt.Println(b.B) - // Output: - // a string from struct A - // a string from struct B + fmt.Println(b.A) + fmt.Println(b.B) + // Output: + // a string from struct A + // a string from struct B } diff --git a/vendor/gopkg.in/yaml.v2/go.mod b/vendor/gopkg.in/yaml.v2/go.mod new file mode 100644 index 0000000..1934e87 --- /dev/null +++ b/vendor/gopkg.in/yaml.v2/go.mod @@ -0,0 +1,5 @@ +module "gopkg.in/yaml.v2" + +require ( + "gopkg.in/check.v1" v0.0.0-20161208181325-20d25e280405 +) diff --git a/vendor/gopkg.in/yaml.v2/readerc.go b/vendor/gopkg.in/yaml.v2/readerc.go index f450791..7c1f5fa 100644 --- a/vendor/gopkg.in/yaml.v2/readerc.go +++ b/vendor/gopkg.in/yaml.v2/readerc.go @@ -93,9 +93,18 @@ func yaml_parser_update_buffer(parser *yaml_parser_t, length int) bool { panic("read handler must be set") } + // [Go] This function was changed to guarantee the requested length size at EOF. + // The fact we need to do this is pretty awful, but the description above implies + // for that to be the case, and there are tests + // If the EOF flag is set and the raw buffer is empty, do nothing. if parser.eof && parser.raw_buffer_pos == len(parser.raw_buffer) { - return true + // [Go] ACTUALLY! Read the documentation of this function above. + // This is just broken. To return true, we need to have the + // given length in the buffer. Not doing that means every single + // check that calls this function to make sure the buffer has a + // given length is Go) panicking; or C) accessing invalid memory. + //return true } // Return if the buffer contains enough characters. @@ -389,6 +398,15 @@ func yaml_parser_update_buffer(parser *yaml_parser_t, length int) bool { break } } + // [Go] Read the documentation of this function above. To return true, + // we need to have the given length in the buffer. Not doing that means + // every single check that calls this function to make sure the buffer + // has a given length is Go) panicking; or C) accessing invalid memory. + // This happens here due to the EOF above breaking early. + for buffer_len < length { + parser.buffer[buffer_len] = 0 + buffer_len++ + } parser.buffer = parser.buffer[:buffer_len] return true } diff --git a/vendor/gopkg.in/yaml.v2/resolve.go b/vendor/gopkg.in/yaml.v2/resolve.go index 232313c..6c151db 100644 --- a/vendor/gopkg.in/yaml.v2/resolve.go +++ b/vendor/gopkg.in/yaml.v2/resolve.go @@ -6,7 +6,7 @@ import ( "regexp" "strconv" "strings" - "unicode/utf8" + "time" ) type resolveMapItem struct { @@ -75,7 +75,7 @@ func longTag(tag string) string { func resolvableTag(tag string) bool { switch tag { - case "", yaml_STR_TAG, yaml_BOOL_TAG, yaml_INT_TAG, yaml_FLOAT_TAG, yaml_NULL_TAG: + case "", yaml_STR_TAG, yaml_BOOL_TAG, yaml_INT_TAG, yaml_FLOAT_TAG, yaml_NULL_TAG, yaml_TIMESTAMP_TAG: return true } return false @@ -92,6 +92,19 @@ func resolve(tag string, in string) (rtag string, out interface{}) { switch tag { case "", rtag, yaml_STR_TAG, yaml_BINARY_TAG: return + case yaml_FLOAT_TAG: + if rtag == yaml_INT_TAG { + switch v := out.(type) { + case int64: + rtag = yaml_FLOAT_TAG + out = float64(v) + return + case int: + rtag = yaml_FLOAT_TAG + out = float64(v) + return + } + } } failf("cannot decode %s `%s` as a %s", shortTag(rtag), in, shortTag(tag)) }() @@ -125,6 +138,15 @@ func resolve(tag string, in string) (rtag string, out interface{}) { case 'D', 'S': // Int, float, or timestamp. + // Only try values as a timestamp if the value is unquoted or there's an explicit + // !!timestamp tag. + if tag == "" || tag == yaml_TIMESTAMP_TAG { + t, ok := parseTimestamp(in) + if ok { + return yaml_TIMESTAMP_TAG, t + } + } + plain := strings.Replace(in, "_", "", -1) intv, err := strconv.ParseInt(plain, 0, 64) if err == nil { @@ -158,28 +180,20 @@ func resolve(tag string, in string) (rtag string, out interface{}) { return yaml_INT_TAG, uintv } } else if strings.HasPrefix(plain, "-0b") { - intv, err := strconv.ParseInt(plain[3:], 2, 64) + intv, err := strconv.ParseInt("-" + plain[3:], 2, 64) if err == nil { - if intv == int64(int(intv)) { - return yaml_INT_TAG, -int(intv) + if true || intv == int64(int(intv)) { + return yaml_INT_TAG, int(intv) } else { - return yaml_INT_TAG, -intv + return yaml_INT_TAG, intv } } } - // XXX Handle timestamps here. - default: panic("resolveTable item not yet handled: " + string(rune(hint)) + " (with " + in + ")") } } - if tag == yaml_BINARY_TAG { - return yaml_BINARY_TAG, in - } - if utf8.ValidString(in) { - return yaml_STR_TAG, in - } - return yaml_BINARY_TAG, encodeBase64(in) + return yaml_STR_TAG, in } // encodeBase64 encodes s as base64 that is broken up into multiple lines @@ -206,3 +220,39 @@ func encodeBase64(s string) string { } return string(out[:k]) } + +// This is a subset of the formats allowed by the regular expression +// defined at http://yaml.org/type/timestamp.html. +var allowedTimestampFormats = []string{ + "2006-1-2T15:4:5.999999999Z07:00", // RCF3339Nano with short date fields. + "2006-1-2t15:4:5.999999999Z07:00", // RFC3339Nano with short date fields and lower-case "t". + "2006-1-2 15:4:5.999999999", // space separated with no time zone + "2006-1-2", // date only + // Notable exception: time.Parse cannot handle: "2001-12-14 21:59:43.10 -5" + // from the set of examples. +} + +// parseTimestamp parses s as a timestamp string and +// returns the timestamp and reports whether it succeeded. +// Timestamp formats are defined at http://yaml.org/type/timestamp.html +func parseTimestamp(s string) (time.Time, bool) { + // TODO write code to check all the formats supported by + // http://yaml.org/type/timestamp.html instead of using time.Parse. + + // Quick check: all date formats start with YYYY-. + i := 0 + for ; i < len(s); i++ { + if c := s[i]; c < '0' || c > '9' { + break + } + } + if i != 4 || i == len(s) || s[i] != '-' { + return time.Time{}, false + } + for _, format := range allowedTimestampFormats { + if t, err := time.Parse(format, s); err == nil { + return t, true + } + } + return time.Time{}, false +} diff --git a/vendor/gopkg.in/yaml.v2/scannerc.go b/vendor/gopkg.in/yaml.v2/scannerc.go index 0744844..077fd1d 100644 --- a/vendor/gopkg.in/yaml.v2/scannerc.go +++ b/vendor/gopkg.in/yaml.v2/scannerc.go @@ -871,12 +871,6 @@ func yaml_parser_save_simple_key(parser *yaml_parser_t) bool { required := parser.flow_level == 0 && parser.indent == parser.mark.column - // A simple key is required only when it is the first token in the current - // line. Therefore it is always allowed. But we add a check anyway. - if required && !parser.simple_key_allowed { - panic("should not happen") - } - // // If the current position may start a simple key, save it. // @@ -2475,6 +2469,10 @@ func yaml_parser_scan_flow_scalar(parser *yaml_parser_t, token *yaml_token_t, si } } + if parser.unread < 1 && !yaml_parser_update_buffer(parser, 1) { + return false + } + // Check if we are at the end of the scalar. if single { if parser.buffer[parser.buffer_pos] == '\'' { @@ -2487,10 +2485,6 @@ func yaml_parser_scan_flow_scalar(parser *yaml_parser_t, token *yaml_token_t, si } // Consume blank characters. - if parser.unread < 1 && !yaml_parser_update_buffer(parser, 1) { - return false - } - for is_blank(parser.buffer, parser.buffer_pos) || is_break(parser.buffer, parser.buffer_pos) { if is_blank(parser.buffer, parser.buffer_pos) { // Consume a space or a tab character. @@ -2592,19 +2586,10 @@ func yaml_parser_scan_plain_scalar(parser *yaml_parser_t, token *yaml_token_t) b // Consume non-blank characters. for !is_blankz(parser.buffer, parser.buffer_pos) { - // Check for 'x:x' in the flow context. TODO: Fix the test "spec-08-13". - if parser.flow_level > 0 && - parser.buffer[parser.buffer_pos] == ':' && - !is_blankz(parser.buffer, parser.buffer_pos+1) { - yaml_parser_set_scanner_error(parser, "while scanning a plain scalar", - start_mark, "found unexpected ':'") - return false - } - // Check for indicators that may end a plain scalar. if (parser.buffer[parser.buffer_pos] == ':' && is_blankz(parser.buffer, parser.buffer_pos+1)) || (parser.flow_level > 0 && - (parser.buffer[parser.buffer_pos] == ',' || parser.buffer[parser.buffer_pos] == ':' || + (parser.buffer[parser.buffer_pos] == ',' || parser.buffer[parser.buffer_pos] == '?' || parser.buffer[parser.buffer_pos] == '[' || parser.buffer[parser.buffer_pos] == ']' || parser.buffer[parser.buffer_pos] == '{' || parser.buffer[parser.buffer_pos] == '}')) { @@ -2656,10 +2641,10 @@ func yaml_parser_scan_plain_scalar(parser *yaml_parser_t, token *yaml_token_t) b for is_blank(parser.buffer, parser.buffer_pos) || is_break(parser.buffer, parser.buffer_pos) { if is_blank(parser.buffer, parser.buffer_pos) { - // Check for tab character that abuse indentation. + // Check for tab characters that abuse indentation. if leading_blanks && parser.mark.column < indent && is_tab(parser.buffer, parser.buffer_pos) { yaml_parser_set_scanner_error(parser, "while scanning a plain scalar", - start_mark, "found a tab character that violate indentation") + start_mark, "found a tab character that violates indentation") return false } diff --git a/vendor/gopkg.in/yaml.v2/sorter.go b/vendor/gopkg.in/yaml.v2/sorter.go index 5958822..4c45e66 100644 --- a/vendor/gopkg.in/yaml.v2/sorter.go +++ b/vendor/gopkg.in/yaml.v2/sorter.go @@ -51,6 +51,15 @@ func (l keyList) Less(i, j int) bool { } var ai, bi int var an, bn int64 + if ar[i] == '0' || br[i] == '0' { + for j := i-1; j >= 0 && unicode.IsDigit(ar[j]); j-- { + if ar[j] != '0' { + an = 1 + bn = 1 + break + } + } + } for ai = i; ai < len(ar) && unicode.IsDigit(ar[ai]); ai++ { an = an*10 + int64(ar[ai]-'0') } diff --git a/vendor/gopkg.in/yaml.v2/writerc.go b/vendor/gopkg.in/yaml.v2/writerc.go index 190362f..a2dde60 100644 --- a/vendor/gopkg.in/yaml.v2/writerc.go +++ b/vendor/gopkg.in/yaml.v2/writerc.go @@ -18,72 +18,9 @@ func yaml_emitter_flush(emitter *yaml_emitter_t) bool { return true } - // If the output encoding is UTF-8, we don't need to recode the buffer. - if emitter.encoding == yaml_UTF8_ENCODING { - if err := emitter.write_handler(emitter, emitter.buffer[:emitter.buffer_pos]); err != nil { - return yaml_emitter_set_writer_error(emitter, "write error: "+err.Error()) - } - emitter.buffer_pos = 0 - return true - } - - // Recode the buffer into the raw buffer. - var low, high int - if emitter.encoding == yaml_UTF16LE_ENCODING { - low, high = 0, 1 - } else { - high, low = 1, 0 - } - - pos := 0 - for pos < emitter.buffer_pos { - // See the "reader.c" code for more details on UTF-8 encoding. Note - // that we assume that the buffer contains a valid UTF-8 sequence. - - // Read the next UTF-8 character. - octet := emitter.buffer[pos] - - var w int - var value rune - switch { - case octet&0x80 == 0x00: - w, value = 1, rune(octet&0x7F) - case octet&0xE0 == 0xC0: - w, value = 2, rune(octet&0x1F) - case octet&0xF0 == 0xE0: - w, value = 3, rune(octet&0x0F) - case octet&0xF8 == 0xF0: - w, value = 4, rune(octet&0x07) - } - for k := 1; k < w; k++ { - octet = emitter.buffer[pos+k] - value = (value << 6) + (rune(octet) & 0x3F) - } - pos += w - - // Write the character. - if value < 0x10000 { - var b [2]byte - b[high] = byte(value >> 8) - b[low] = byte(value & 0xFF) - emitter.raw_buffer = append(emitter.raw_buffer, b[0], b[1]) - } else { - // Write the character using a surrogate pair (check "reader.c"). - var b [4]byte - value -= 0x10000 - b[high] = byte(0xD8 + (value >> 18)) - b[low] = byte((value >> 10) & 0xFF) - b[high+2] = byte(0xDC + ((value >> 8) & 0xFF)) - b[low+2] = byte(value & 0xFF) - emitter.raw_buffer = append(emitter.raw_buffer, b[0], b[1], b[2], b[3]) - } - } - - // Write the raw buffer. - if err := emitter.write_handler(emitter, emitter.raw_buffer); err != nil { + if err := emitter.write_handler(emitter, emitter.buffer[:emitter.buffer_pos]); err != nil { return yaml_emitter_set_writer_error(emitter, "write error: "+err.Error()) } emitter.buffer_pos = 0 - emitter.raw_buffer = emitter.raw_buffer[:0] return true } diff --git a/vendor/gopkg.in/yaml.v2/yaml.go b/vendor/gopkg.in/yaml.v2/yaml.go index 5e3c2da..de85aa4 100644 --- a/vendor/gopkg.in/yaml.v2/yaml.go +++ b/vendor/gopkg.in/yaml.v2/yaml.go @@ -9,6 +9,7 @@ package yaml import ( "errors" "fmt" + "io" "reflect" "strings" "sync" @@ -81,12 +82,58 @@ func Unmarshal(in []byte, out interface{}) (err error) { } // UnmarshalStrict is like Unmarshal except that any fields that are found -// in the data that do not have corresponding struct members will result in +// in the data that do not have corresponding struct members, or mapping +// keys that are duplicates, will result in // an error. func UnmarshalStrict(in []byte, out interface{}) (err error) { return unmarshal(in, out, true) } +// A Decorder reads and decodes YAML values from an input stream. +type Decoder struct { + strict bool + parser *parser +} + +// NewDecoder returns a new decoder that reads from r. +// +// The decoder introduces its own buffering and may read +// data from r beyond the YAML values requested. +func NewDecoder(r io.Reader) *Decoder { + return &Decoder{ + parser: newParserFromReader(r), + } +} + +// SetStrict sets whether strict decoding behaviour is enabled when +// decoding items in the data (see UnmarshalStrict). By default, decoding is not strict. +func (dec *Decoder) SetStrict(strict bool) { + dec.strict = strict +} + +// Decode reads the next YAML-encoded value from its input +// and stores it in the value pointed to by v. +// +// See the documentation for Unmarshal for details about the +// conversion of YAML into a Go value. +func (dec *Decoder) Decode(v interface{}) (err error) { + d := newDecoder(dec.strict) + defer handleErr(&err) + node := dec.parser.parse() + if node == nil { + return io.EOF + } + out := reflect.ValueOf(v) + if out.Kind() == reflect.Ptr && !out.IsNil() { + out = out.Elem() + } + d.unmarshal(node, out) + if len(d.terrors) > 0 { + return &TypeError{d.terrors} + } + return nil +} + func unmarshal(in []byte, out interface{}, strict bool) (err error) { defer handleErr(&err) d := newDecoder(strict) @@ -110,8 +157,8 @@ func unmarshal(in []byte, out interface{}, strict bool) (err error) { // of the generated document will reflect the structure of the value itself. // Maps and pointers (to struct, string, int, etc) are accepted as the in value. // -// Struct fields are only unmarshalled if they are exported (have an upper case -// first letter), and are unmarshalled using the field name lowercased as the +// Struct fields are only marshalled if they are exported (have an upper case +// first letter), and are marshalled using the field name lowercased as the // default key. Custom keys may be defined via the "yaml" name in the field // tag: the content preceding the first comma is used as the key, and the // following comma-separated options are used to tweak the marshalling process. @@ -125,7 +172,10 @@ func unmarshal(in []byte, out interface{}, strict bool) (err error) { // // omitempty Only include the field if it's not set to the zero // value for the type or to empty slices or maps. -// Does not apply to zero valued structs. +// Zero valued structs will be omitted if all their public +// fields are zero, unless they implement an IsZero +// method (see the IsZeroer interface type), in which +// case the field will be included if that method returns true. // // flow Marshal using a flow style (useful for structs, // sequences and maps). @@ -150,12 +200,47 @@ func Marshal(in interface{}) (out []byte, err error) { defer handleErr(&err) e := newEncoder() defer e.destroy() - e.marshal("", reflect.ValueOf(in)) + e.marshalDoc("", reflect.ValueOf(in)) e.finish() out = e.out return } +// An Encoder writes YAML values to an output stream. +type Encoder struct { + encoder *encoder +} + +// NewEncoder returns a new encoder that writes to w. +// The Encoder should be closed after use to flush all data +// to w. +func NewEncoder(w io.Writer) *Encoder { + return &Encoder{ + encoder: newEncoderWithWriter(w), + } +} + +// Encode writes the YAML encoding of v to the stream. +// If multiple items are encoded to the stream, the +// second and subsequent document will be preceded +// with a "---" document separator, but the first will not. +// +// See the documentation for Marshal for details about the conversion of Go +// values to YAML. +func (e *Encoder) Encode(v interface{}) (err error) { + defer handleErr(&err) + e.encoder.marshalDoc("", reflect.ValueOf(v)) + return nil +} + +// Close closes the encoder by writing any remaining data. +// It does not write a stream terminating string "...". +func (e *Encoder) Close() (err error) { + defer handleErr(&err) + e.encoder.finish() + return nil +} + func handleErr(err *error) { if v := recover(); v != nil { if e, ok := v.(yamlError); ok { @@ -211,6 +296,9 @@ type fieldInfo struct { Num int OmitEmpty bool Flow bool + // Id holds the unique field identifier, so we can cheaply + // check for field duplicates without maintaining an extra map. + Id int // Inline holds the field index if the field is part of an inlined struct. Inline []int @@ -290,6 +378,7 @@ func getStructInfo(st reflect.Type) (*structInfo, error) { } else { finfo.Inline = append([]int{i}, finfo.Inline...) } + finfo.Id = len(fieldsList) fieldsMap[finfo.Key] = finfo fieldsList = append(fieldsList, finfo) } @@ -311,11 +400,16 @@ func getStructInfo(st reflect.Type) (*structInfo, error) { return nil, errors.New(msg) } + info.Id = len(fieldsList) fieldsList = append(fieldsList, info) fieldsMap[info.Key] = info } - sinfo = &structInfo{fieldsMap, fieldsList, inlineMap} + sinfo = &structInfo{ + FieldsMap: fieldsMap, + FieldsList: fieldsList, + InlineMap: inlineMap, + } fieldMapMutex.Lock() structMap[st] = sinfo @@ -323,8 +417,23 @@ func getStructInfo(st reflect.Type) (*structInfo, error) { return sinfo, nil } +// IsZeroer is used to check whether an object is zero to +// determine whether it should be omitted when marshaling +// with the omitempty flag. One notable implementation +// is time.Time. +type IsZeroer interface { + IsZero() bool +} + func isZero(v reflect.Value) bool { - switch v.Kind() { + kind := v.Kind() + if z, ok := v.Interface().(IsZeroer); ok { + if (kind == reflect.Ptr || kind == reflect.Interface) && v.IsNil() { + return true + } + return z.IsZero() + } + switch kind { case reflect.String: return len(v.String()) == 0 case reflect.Interface, reflect.Ptr: diff --git a/vendor/gopkg.in/yaml.v2/yamlh.go b/vendor/gopkg.in/yaml.v2/yamlh.go index 3caeca0..e25cee5 100644 --- a/vendor/gopkg.in/yaml.v2/yamlh.go +++ b/vendor/gopkg.in/yaml.v2/yamlh.go @@ -1,6 +1,7 @@ package yaml import ( + "fmt" "io" ) @@ -239,6 +240,27 @@ const ( yaml_MAPPING_END_EVENT // A MAPPING-END event. ) +var eventStrings = []string{ + yaml_NO_EVENT: "none", + yaml_STREAM_START_EVENT: "stream start", + yaml_STREAM_END_EVENT: "stream end", + yaml_DOCUMENT_START_EVENT: "document start", + yaml_DOCUMENT_END_EVENT: "document end", + yaml_ALIAS_EVENT: "alias", + yaml_SCALAR_EVENT: "scalar", + yaml_SEQUENCE_START_EVENT: "sequence start", + yaml_SEQUENCE_END_EVENT: "sequence end", + yaml_MAPPING_START_EVENT: "mapping start", + yaml_MAPPING_END_EVENT: "mapping end", +} + +func (e yaml_event_type_t) String() string { + if e < 0 || int(e) >= len(eventStrings) { + return fmt.Sprintf("unknown event %d", e) + } + return eventStrings[e] +} + // The event structure. type yaml_event_t struct { @@ -521,9 +543,9 @@ type yaml_parser_t struct { read_handler yaml_read_handler_t // Read handler. - input_file io.Reader // File input data. - input []byte // String input data. - input_pos int + input_reader io.Reader // File input data. + input []byte // String input data. + input_pos int eof bool // EOF flag @@ -632,7 +654,7 @@ type yaml_emitter_t struct { write_handler yaml_write_handler_t // Write handler. output_buffer *[]byte // String output data. - output_file io.Writer // File output data. + output_writer io.Writer // File output data. buffer []byte // The working buffer. buffer_pos int // The current position of the buffer.