planetscale 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (378) hide show
  1. checksums.yaml +7 -0
  2. data/.github/workflows/ci.yml +24 -0
  3. data/.github/workflows/gem-push.yml +38 -0
  4. data/.github/workflows/licensed.yml +43 -0
  5. data/.gitignore +10 -0
  6. data/.licensed.yml +9 -0
  7. data/.licenses/go/github.com/armon/circbuf.dep.yml +31 -0
  8. data/.licenses/go/github.com/gorilla/mux.dep.yml +41 -0
  9. data/.licenses/go/github.com/hashicorp/go-cleanhttp.dep.yml +375 -0
  10. data/.licenses/go/github.com/mitchellh/go-homedir.dep.yml +32 -0
  11. data/.licenses/go/github.com/pkg/errors.dep.yml +36 -0
  12. data/.licenses/go/github.com/planetscale/planetscale-go/planetscale.dep.yml +160 -0
  13. data/.licenses/go/github.com/planetscale/sql-proxy/proxy.dep.yml +180 -0
  14. data/.licenses/go/go.uber.org/atomic.dep.yml +31 -0
  15. data/.licenses/go/go.uber.org/multierr.dep.yml +30 -0
  16. data/.licenses/go/go.uber.org/zap.dep.yml +30 -0
  17. data/.licenses/go/go.uber.org/zap/buffer.dep.yml +30 -0
  18. data/.licenses/go/go.uber.org/zap/internal/bufferpool.dep.yml +30 -0
  19. data/.licenses/go/go.uber.org/zap/internal/color.dep.yml +30 -0
  20. data/.licenses/go/go.uber.org/zap/internal/exit.dep.yml +31 -0
  21. data/.licenses/go/go.uber.org/zap/zapcore.dep.yml +31 -0
  22. data/.licenses/go/golang.org/x/net/context/ctxhttp.dep.yml +63 -0
  23. data/.licenses/go/golang.org/x/oauth2.dep.yml +44 -0
  24. data/.licenses/go/golang.org/x/oauth2/internal.dep.yml +38 -0
  25. data/.ruby_version +1 -0
  26. data/Gemfile +8 -0
  27. data/LICENSE +201 -0
  28. data/README.md +88 -0
  29. data/Rakefile +10 -0
  30. data/bin/console +15 -0
  31. data/bin/setup +17 -0
  32. data/controller.go +255 -0
  33. data/go.mod +16 -0
  34. data/go.sum +428 -0
  35. data/lib/generators/planetscale/install_generator.rb +58 -0
  36. data/lib/planetscale.rb +137 -0
  37. data/lib/planetscale/version.rb +5 -0
  38. data/planetscale.gemspec +44 -0
  39. data/proxy.go +128 -0
  40. data/vendor/github.com/armon/circbuf/.gitignore +22 -0
  41. data/vendor/github.com/armon/circbuf/LICENSE +20 -0
  42. data/vendor/github.com/armon/circbuf/README.md +28 -0
  43. data/vendor/github.com/armon/circbuf/circbuf.go +92 -0
  44. data/vendor/github.com/armon/circbuf/go.mod +1 -0
  45. data/vendor/github.com/golang/protobuf/AUTHORS +3 -0
  46. data/vendor/github.com/golang/protobuf/CONTRIBUTORS +3 -0
  47. data/vendor/github.com/golang/protobuf/LICENSE +28 -0
  48. data/vendor/github.com/golang/protobuf/proto/buffer.go +324 -0
  49. data/vendor/github.com/golang/protobuf/proto/defaults.go +63 -0
  50. data/vendor/github.com/golang/protobuf/proto/deprecated.go +113 -0
  51. data/vendor/github.com/golang/protobuf/proto/discard.go +58 -0
  52. data/vendor/github.com/golang/protobuf/proto/extensions.go +356 -0
  53. data/vendor/github.com/golang/protobuf/proto/properties.go +306 -0
  54. data/vendor/github.com/golang/protobuf/proto/proto.go +167 -0
  55. data/vendor/github.com/golang/protobuf/proto/registry.go +317 -0
  56. data/vendor/github.com/golang/protobuf/proto/text_decode.go +801 -0
  57. data/vendor/github.com/golang/protobuf/proto/text_encode.go +560 -0
  58. data/vendor/github.com/golang/protobuf/proto/wire.go +78 -0
  59. data/vendor/github.com/golang/protobuf/proto/wrappers.go +34 -0
  60. data/vendor/github.com/gorilla/mux/AUTHORS +8 -0
  61. data/vendor/github.com/gorilla/mux/LICENSE +27 -0
  62. data/vendor/github.com/gorilla/mux/README.md +805 -0
  63. data/vendor/github.com/gorilla/mux/doc.go +306 -0
  64. data/vendor/github.com/gorilla/mux/go.mod +3 -0
  65. data/vendor/github.com/gorilla/mux/middleware.go +74 -0
  66. data/vendor/github.com/gorilla/mux/mux.go +606 -0
  67. data/vendor/github.com/gorilla/mux/regexp.go +388 -0
  68. data/vendor/github.com/gorilla/mux/route.go +736 -0
  69. data/vendor/github.com/gorilla/mux/test_helpers.go +19 -0
  70. data/vendor/github.com/hashicorp/go-cleanhttp/LICENSE +363 -0
  71. data/vendor/github.com/hashicorp/go-cleanhttp/README.md +30 -0
  72. data/vendor/github.com/hashicorp/go-cleanhttp/cleanhttp.go +58 -0
  73. data/vendor/github.com/hashicorp/go-cleanhttp/doc.go +20 -0
  74. data/vendor/github.com/hashicorp/go-cleanhttp/go.mod +3 -0
  75. data/vendor/github.com/hashicorp/go-cleanhttp/handlers.go +48 -0
  76. data/vendor/github.com/mitchellh/go-homedir/LICENSE +21 -0
  77. data/vendor/github.com/mitchellh/go-homedir/README.md +14 -0
  78. data/vendor/github.com/mitchellh/go-homedir/go.mod +1 -0
  79. data/vendor/github.com/mitchellh/go-homedir/homedir.go +167 -0
  80. data/vendor/github.com/pkg/errors/.gitignore +24 -0
  81. data/vendor/github.com/pkg/errors/.travis.yml +10 -0
  82. data/vendor/github.com/pkg/errors/LICENSE +23 -0
  83. data/vendor/github.com/pkg/errors/Makefile +44 -0
  84. data/vendor/github.com/pkg/errors/README.md +59 -0
  85. data/vendor/github.com/pkg/errors/appveyor.yml +32 -0
  86. data/vendor/github.com/pkg/errors/errors.go +288 -0
  87. data/vendor/github.com/pkg/errors/go113.go +38 -0
  88. data/vendor/github.com/pkg/errors/stack.go +177 -0
  89. data/vendor/github.com/planetscale/planetscale-go/planetscale/backups.go +139 -0
  90. data/vendor/github.com/planetscale/planetscale-go/planetscale/branches.go +258 -0
  91. data/vendor/github.com/planetscale/planetscale-go/planetscale/certs.go +142 -0
  92. data/vendor/github.com/planetscale/planetscale-go/planetscale/client.go +305 -0
  93. data/vendor/github.com/planetscale/planetscale-go/planetscale/databases.go +131 -0
  94. data/vendor/github.com/planetscale/planetscale-go/planetscale/deploy_requests.go +368 -0
  95. data/vendor/github.com/planetscale/planetscale-go/planetscale/organizations.go +78 -0
  96. data/vendor/github.com/planetscale/planetscale-go/planetscale/service_tokens.go +163 -0
  97. data/vendor/github.com/planetscale/sql-proxy/proxy/client.go +467 -0
  98. data/vendor/github.com/planetscale/sql-proxy/proxy/tls_cache.go +73 -0
  99. data/vendor/go.uber.org/atomic/.codecov.yml +19 -0
  100. data/vendor/go.uber.org/atomic/.gitignore +12 -0
  101. data/vendor/go.uber.org/atomic/.travis.yml +27 -0
  102. data/vendor/go.uber.org/atomic/CHANGELOG.md +76 -0
  103. data/vendor/go.uber.org/atomic/LICENSE.txt +19 -0
  104. data/vendor/go.uber.org/atomic/Makefile +78 -0
  105. data/vendor/go.uber.org/atomic/README.md +63 -0
  106. data/vendor/go.uber.org/atomic/bool.go +81 -0
  107. data/vendor/go.uber.org/atomic/bool_ext.go +53 -0
  108. data/vendor/go.uber.org/atomic/doc.go +23 -0
  109. data/vendor/go.uber.org/atomic/duration.go +82 -0
  110. data/vendor/go.uber.org/atomic/duration_ext.go +40 -0
  111. data/vendor/go.uber.org/atomic/error.go +51 -0
  112. data/vendor/go.uber.org/atomic/error_ext.go +39 -0
  113. data/vendor/go.uber.org/atomic/float64.go +76 -0
  114. data/vendor/go.uber.org/atomic/float64_ext.go +47 -0
  115. data/vendor/go.uber.org/atomic/gen.go +26 -0
  116. data/vendor/go.uber.org/atomic/go.mod +8 -0
  117. data/vendor/go.uber.org/atomic/go.sum +9 -0
  118. data/vendor/go.uber.org/atomic/int32.go +102 -0
  119. data/vendor/go.uber.org/atomic/int64.go +102 -0
  120. data/vendor/go.uber.org/atomic/nocmp.go +35 -0
  121. data/vendor/go.uber.org/atomic/string.go +54 -0
  122. data/vendor/go.uber.org/atomic/string_ext.go +43 -0
  123. data/vendor/go.uber.org/atomic/uint32.go +102 -0
  124. data/vendor/go.uber.org/atomic/uint64.go +102 -0
  125. data/vendor/go.uber.org/atomic/value.go +31 -0
  126. data/vendor/go.uber.org/multierr/.codecov.yml +15 -0
  127. data/vendor/go.uber.org/multierr/.gitignore +4 -0
  128. data/vendor/go.uber.org/multierr/.travis.yml +23 -0
  129. data/vendor/go.uber.org/multierr/CHANGELOG.md +60 -0
  130. data/vendor/go.uber.org/multierr/LICENSE.txt +19 -0
  131. data/vendor/go.uber.org/multierr/Makefile +42 -0
  132. data/vendor/go.uber.org/multierr/README.md +23 -0
  133. data/vendor/go.uber.org/multierr/error.go +449 -0
  134. data/vendor/go.uber.org/multierr/glide.yaml +8 -0
  135. data/vendor/go.uber.org/multierr/go.mod +8 -0
  136. data/vendor/go.uber.org/multierr/go.sum +11 -0
  137. data/vendor/go.uber.org/multierr/go113.go +52 -0
  138. data/vendor/go.uber.org/zap/.codecov.yml +17 -0
  139. data/vendor/go.uber.org/zap/.gitignore +32 -0
  140. data/vendor/go.uber.org/zap/.readme.tmpl +109 -0
  141. data/vendor/go.uber.org/zap/.travis.yml +23 -0
  142. data/vendor/go.uber.org/zap/CHANGELOG.md +432 -0
  143. data/vendor/go.uber.org/zap/CODE_OF_CONDUCT.md +75 -0
  144. data/vendor/go.uber.org/zap/CONTRIBUTING.md +81 -0
  145. data/vendor/go.uber.org/zap/FAQ.md +156 -0
  146. data/vendor/go.uber.org/zap/LICENSE.txt +19 -0
  147. data/vendor/go.uber.org/zap/Makefile +63 -0
  148. data/vendor/go.uber.org/zap/README.md +134 -0
  149. data/vendor/go.uber.org/zap/array.go +320 -0
  150. data/vendor/go.uber.org/zap/buffer/buffer.go +123 -0
  151. data/vendor/go.uber.org/zap/buffer/pool.go +49 -0
  152. data/vendor/go.uber.org/zap/checklicense.sh +17 -0
  153. data/vendor/go.uber.org/zap/config.go +264 -0
  154. data/vendor/go.uber.org/zap/doc.go +113 -0
  155. data/vendor/go.uber.org/zap/encoder.go +79 -0
  156. data/vendor/go.uber.org/zap/error.go +80 -0
  157. data/vendor/go.uber.org/zap/field.go +539 -0
  158. data/vendor/go.uber.org/zap/flag.go +39 -0
  159. data/vendor/go.uber.org/zap/glide.yaml +34 -0
  160. data/vendor/go.uber.org/zap/global.go +168 -0
  161. data/vendor/go.uber.org/zap/global_go112.go +26 -0
  162. data/vendor/go.uber.org/zap/global_prego112.go +26 -0
  163. data/vendor/go.uber.org/zap/go.mod +13 -0
  164. data/vendor/go.uber.org/zap/go.sum +56 -0
  165. data/vendor/go.uber.org/zap/http_handler.go +81 -0
  166. data/vendor/go.uber.org/zap/internal/bufferpool/bufferpool.go +31 -0
  167. data/vendor/go.uber.org/zap/internal/color/color.go +44 -0
  168. data/vendor/go.uber.org/zap/internal/exit/exit.go +64 -0
  169. data/vendor/go.uber.org/zap/level.go +132 -0
  170. data/vendor/go.uber.org/zap/logger.go +344 -0
  171. data/vendor/go.uber.org/zap/options.go +140 -0
  172. data/vendor/go.uber.org/zap/sink.go +161 -0
  173. data/vendor/go.uber.org/zap/stacktrace.go +85 -0
  174. data/vendor/go.uber.org/zap/sugar.go +304 -0
  175. data/vendor/go.uber.org/zap/time.go +27 -0
  176. data/vendor/go.uber.org/zap/writer.go +99 -0
  177. data/vendor/go.uber.org/zap/zapcore/console_encoder.go +161 -0
  178. data/vendor/go.uber.org/zap/zapcore/core.go +113 -0
  179. data/vendor/go.uber.org/zap/zapcore/doc.go +24 -0
  180. data/vendor/go.uber.org/zap/zapcore/encoder.go +443 -0
  181. data/vendor/go.uber.org/zap/zapcore/entry.go +264 -0
  182. data/vendor/go.uber.org/zap/zapcore/error.go +115 -0
  183. data/vendor/go.uber.org/zap/zapcore/field.go +227 -0
  184. data/vendor/go.uber.org/zap/zapcore/hook.go +68 -0
  185. data/vendor/go.uber.org/zap/zapcore/increase_level.go +66 -0
  186. data/vendor/go.uber.org/zap/zapcore/json_encoder.go +534 -0
  187. data/vendor/go.uber.org/zap/zapcore/level.go +175 -0
  188. data/vendor/go.uber.org/zap/zapcore/level_strings.go +46 -0
  189. data/vendor/go.uber.org/zap/zapcore/marshaler.go +61 -0
  190. data/vendor/go.uber.org/zap/zapcore/memory_encoder.go +179 -0
  191. data/vendor/go.uber.org/zap/zapcore/sampler.go +208 -0
  192. data/vendor/go.uber.org/zap/zapcore/tee.go +81 -0
  193. data/vendor/go.uber.org/zap/zapcore/write_syncer.go +123 -0
  194. data/vendor/golang.org/x/net/AUTHORS +3 -0
  195. data/vendor/golang.org/x/net/CONTRIBUTORS +3 -0
  196. data/vendor/golang.org/x/net/LICENSE +27 -0
  197. data/vendor/golang.org/x/net/PATENTS +22 -0
  198. data/vendor/golang.org/x/net/context/context.go +56 -0
  199. data/vendor/golang.org/x/net/context/ctxhttp/ctxhttp.go +71 -0
  200. data/vendor/golang.org/x/net/context/go17.go +73 -0
  201. data/vendor/golang.org/x/net/context/go19.go +21 -0
  202. data/vendor/golang.org/x/net/context/pre_go17.go +301 -0
  203. data/vendor/golang.org/x/net/context/pre_go19.go +110 -0
  204. data/vendor/golang.org/x/oauth2/.travis.yml +13 -0
  205. data/vendor/golang.org/x/oauth2/AUTHORS +3 -0
  206. data/vendor/golang.org/x/oauth2/CONTRIBUTING.md +26 -0
  207. data/vendor/golang.org/x/oauth2/CONTRIBUTORS +3 -0
  208. data/vendor/golang.org/x/oauth2/LICENSE +27 -0
  209. data/vendor/golang.org/x/oauth2/README.md +36 -0
  210. data/vendor/golang.org/x/oauth2/go.mod +9 -0
  211. data/vendor/golang.org/x/oauth2/go.sum +361 -0
  212. data/vendor/golang.org/x/oauth2/internal/client_appengine.go +14 -0
  213. data/vendor/golang.org/x/oauth2/internal/doc.go +6 -0
  214. data/vendor/golang.org/x/oauth2/internal/oauth2.go +37 -0
  215. data/vendor/golang.org/x/oauth2/internal/token.go +294 -0
  216. data/vendor/golang.org/x/oauth2/internal/transport.go +33 -0
  217. data/vendor/golang.org/x/oauth2/oauth2.go +381 -0
  218. data/vendor/golang.org/x/oauth2/token.go +178 -0
  219. data/vendor/golang.org/x/oauth2/transport.go +89 -0
  220. data/vendor/google.golang.org/appengine/LICENSE +202 -0
  221. data/vendor/google.golang.org/appengine/internal/api.go +678 -0
  222. data/vendor/google.golang.org/appengine/internal/api_classic.go +169 -0
  223. data/vendor/google.golang.org/appengine/internal/api_common.go +123 -0
  224. data/vendor/google.golang.org/appengine/internal/app_id.go +28 -0
  225. data/vendor/google.golang.org/appengine/internal/base/api_base.pb.go +308 -0
  226. data/vendor/google.golang.org/appengine/internal/base/api_base.proto +33 -0
  227. data/vendor/google.golang.org/appengine/internal/datastore/datastore_v3.pb.go +4367 -0
  228. data/vendor/google.golang.org/appengine/internal/datastore/datastore_v3.proto +551 -0
  229. data/vendor/google.golang.org/appengine/internal/identity.go +55 -0
  230. data/vendor/google.golang.org/appengine/internal/identity_classic.go +61 -0
  231. data/vendor/google.golang.org/appengine/internal/identity_flex.go +11 -0
  232. data/vendor/google.golang.org/appengine/internal/identity_vm.go +134 -0
  233. data/vendor/google.golang.org/appengine/internal/internal.go +110 -0
  234. data/vendor/google.golang.org/appengine/internal/log/log_service.pb.go +1313 -0
  235. data/vendor/google.golang.org/appengine/internal/log/log_service.proto +150 -0
  236. data/vendor/google.golang.org/appengine/internal/main.go +16 -0
  237. data/vendor/google.golang.org/appengine/internal/main_common.go +7 -0
  238. data/vendor/google.golang.org/appengine/internal/main_vm.go +69 -0
  239. data/vendor/google.golang.org/appengine/internal/metadata.go +60 -0
  240. data/vendor/google.golang.org/appengine/internal/net.go +56 -0
  241. data/vendor/google.golang.org/appengine/internal/regen.sh +40 -0
  242. data/vendor/google.golang.org/appengine/internal/remote_api/remote_api.pb.go +361 -0
  243. data/vendor/google.golang.org/appengine/internal/remote_api/remote_api.proto +44 -0
  244. data/vendor/google.golang.org/appengine/internal/transaction.go +115 -0
  245. data/vendor/google.golang.org/appengine/internal/urlfetch/urlfetch_service.pb.go +527 -0
  246. data/vendor/google.golang.org/appengine/internal/urlfetch/urlfetch_service.proto +64 -0
  247. data/vendor/google.golang.org/appengine/urlfetch/urlfetch.go +210 -0
  248. data/vendor/google.golang.org/protobuf/AUTHORS +3 -0
  249. data/vendor/google.golang.org/protobuf/CONTRIBUTORS +3 -0
  250. data/vendor/google.golang.org/protobuf/LICENSE +27 -0
  251. data/vendor/google.golang.org/protobuf/PATENTS +22 -0
  252. data/vendor/google.golang.org/protobuf/encoding/prototext/decode.go +773 -0
  253. data/vendor/google.golang.org/protobuf/encoding/prototext/doc.go +7 -0
  254. data/vendor/google.golang.org/protobuf/encoding/prototext/encode.go +371 -0
  255. data/vendor/google.golang.org/protobuf/encoding/protowire/wire.go +538 -0
  256. data/vendor/google.golang.org/protobuf/internal/descfmt/stringer.go +318 -0
  257. data/vendor/google.golang.org/protobuf/internal/descopts/options.go +29 -0
  258. data/vendor/google.golang.org/protobuf/internal/detrand/rand.go +69 -0
  259. data/vendor/google.golang.org/protobuf/internal/encoding/defval/default.go +213 -0
  260. data/vendor/google.golang.org/protobuf/internal/encoding/messageset/messageset.go +241 -0
  261. data/vendor/google.golang.org/protobuf/internal/encoding/tag/tag.go +207 -0
  262. data/vendor/google.golang.org/protobuf/internal/encoding/text/decode.go +665 -0
  263. data/vendor/google.golang.org/protobuf/internal/encoding/text/decode_number.go +190 -0
  264. data/vendor/google.golang.org/protobuf/internal/encoding/text/decode_string.go +161 -0
  265. data/vendor/google.golang.org/protobuf/internal/encoding/text/decode_token.go +373 -0
  266. data/vendor/google.golang.org/protobuf/internal/encoding/text/doc.go +29 -0
  267. data/vendor/google.golang.org/protobuf/internal/encoding/text/encode.go +265 -0
  268. data/vendor/google.golang.org/protobuf/internal/errors/errors.go +89 -0
  269. data/vendor/google.golang.org/protobuf/internal/errors/is_go112.go +39 -0
  270. data/vendor/google.golang.org/protobuf/internal/errors/is_go113.go +12 -0
  271. data/vendor/google.golang.org/protobuf/internal/filedesc/build.go +158 -0
  272. data/vendor/google.golang.org/protobuf/internal/filedesc/desc.go +631 -0
  273. data/vendor/google.golang.org/protobuf/internal/filedesc/desc_init.go +471 -0
  274. data/vendor/google.golang.org/protobuf/internal/filedesc/desc_lazy.go +704 -0
  275. data/vendor/google.golang.org/protobuf/internal/filedesc/desc_list.go +450 -0
  276. data/vendor/google.golang.org/protobuf/internal/filedesc/desc_list_gen.go +356 -0
  277. data/vendor/google.golang.org/protobuf/internal/filedesc/placeholder.go +107 -0
  278. data/vendor/google.golang.org/protobuf/internal/filetype/build.go +297 -0
  279. data/vendor/google.golang.org/protobuf/internal/flags/flags.go +24 -0
  280. data/vendor/google.golang.org/protobuf/internal/flags/proto_legacy_disable.go +9 -0
  281. data/vendor/google.golang.org/protobuf/internal/flags/proto_legacy_enable.go +9 -0
  282. data/vendor/google.golang.org/protobuf/internal/genid/any_gen.go +34 -0
  283. data/vendor/google.golang.org/protobuf/internal/genid/api_gen.go +106 -0
  284. data/vendor/google.golang.org/protobuf/internal/genid/descriptor_gen.go +829 -0
  285. data/vendor/google.golang.org/protobuf/internal/genid/doc.go +11 -0
  286. data/vendor/google.golang.org/protobuf/internal/genid/duration_gen.go +34 -0
  287. data/vendor/google.golang.org/protobuf/internal/genid/empty_gen.go +19 -0
  288. data/vendor/google.golang.org/protobuf/internal/genid/field_mask_gen.go +31 -0
  289. data/vendor/google.golang.org/protobuf/internal/genid/goname.go +25 -0
  290. data/vendor/google.golang.org/protobuf/internal/genid/map_entry.go +16 -0
  291. data/vendor/google.golang.org/protobuf/internal/genid/source_context_gen.go +31 -0
  292. data/vendor/google.golang.org/protobuf/internal/genid/struct_gen.go +116 -0
  293. data/vendor/google.golang.org/protobuf/internal/genid/timestamp_gen.go +34 -0
  294. data/vendor/google.golang.org/protobuf/internal/genid/type_gen.go +184 -0
  295. data/vendor/google.golang.org/protobuf/internal/genid/wrappers.go +13 -0
  296. data/vendor/google.golang.org/protobuf/internal/genid/wrappers_gen.go +175 -0
  297. data/vendor/google.golang.org/protobuf/internal/impl/api_export.go +177 -0
  298. data/vendor/google.golang.org/protobuf/internal/impl/checkinit.go +141 -0
  299. data/vendor/google.golang.org/protobuf/internal/impl/codec_extension.go +223 -0
  300. data/vendor/google.golang.org/protobuf/internal/impl/codec_field.go +830 -0
  301. data/vendor/google.golang.org/protobuf/internal/impl/codec_gen.go +5637 -0
  302. data/vendor/google.golang.org/protobuf/internal/impl/codec_map.go +388 -0
  303. data/vendor/google.golang.org/protobuf/internal/impl/codec_map_go111.go +37 -0
  304. data/vendor/google.golang.org/protobuf/internal/impl/codec_map_go112.go +11 -0
  305. data/vendor/google.golang.org/protobuf/internal/impl/codec_message.go +217 -0
  306. data/vendor/google.golang.org/protobuf/internal/impl/codec_messageset.go +123 -0
  307. data/vendor/google.golang.org/protobuf/internal/impl/codec_reflect.go +209 -0
  308. data/vendor/google.golang.org/protobuf/internal/impl/codec_tables.go +557 -0
  309. data/vendor/google.golang.org/protobuf/internal/impl/codec_unsafe.go +17 -0
  310. data/vendor/google.golang.org/protobuf/internal/impl/convert.go +496 -0
  311. data/vendor/google.golang.org/protobuf/internal/impl/convert_list.go +141 -0
  312. data/vendor/google.golang.org/protobuf/internal/impl/convert_map.go +121 -0
  313. data/vendor/google.golang.org/protobuf/internal/impl/decode.go +276 -0
  314. data/vendor/google.golang.org/protobuf/internal/impl/encode.go +201 -0
  315. data/vendor/google.golang.org/protobuf/internal/impl/enum.go +21 -0
  316. data/vendor/google.golang.org/protobuf/internal/impl/extension.go +156 -0
  317. data/vendor/google.golang.org/protobuf/internal/impl/legacy_enum.go +219 -0
  318. data/vendor/google.golang.org/protobuf/internal/impl/legacy_export.go +92 -0
  319. data/vendor/google.golang.org/protobuf/internal/impl/legacy_extension.go +176 -0
  320. data/vendor/google.golang.org/protobuf/internal/impl/legacy_file.go +81 -0
  321. data/vendor/google.golang.org/protobuf/internal/impl/legacy_message.go +558 -0
  322. data/vendor/google.golang.org/protobuf/internal/impl/merge.go +176 -0
  323. data/vendor/google.golang.org/protobuf/internal/impl/merge_gen.go +209 -0
  324. data/vendor/google.golang.org/protobuf/internal/impl/message.go +276 -0
  325. data/vendor/google.golang.org/protobuf/internal/impl/message_reflect.go +465 -0
  326. data/vendor/google.golang.org/protobuf/internal/impl/message_reflect_field.go +543 -0
  327. data/vendor/google.golang.org/protobuf/internal/impl/message_reflect_gen.go +249 -0
  328. data/vendor/google.golang.org/protobuf/internal/impl/pointer_reflect.go +178 -0
  329. data/vendor/google.golang.org/protobuf/internal/impl/pointer_unsafe.go +174 -0
  330. data/vendor/google.golang.org/protobuf/internal/impl/validate.go +576 -0
  331. data/vendor/google.golang.org/protobuf/internal/impl/weak.go +74 -0
  332. data/vendor/google.golang.org/protobuf/internal/order/order.go +89 -0
  333. data/vendor/google.golang.org/protobuf/internal/order/range.go +115 -0
  334. data/vendor/google.golang.org/protobuf/internal/pragma/pragma.go +29 -0
  335. data/vendor/google.golang.org/protobuf/internal/set/ints.go +58 -0
  336. data/vendor/google.golang.org/protobuf/internal/strs/strings.go +196 -0
  337. data/vendor/google.golang.org/protobuf/internal/strs/strings_pure.go +27 -0
  338. data/vendor/google.golang.org/protobuf/internal/strs/strings_unsafe.go +94 -0
  339. data/vendor/google.golang.org/protobuf/internal/version/version.go +79 -0
  340. data/vendor/google.golang.org/protobuf/proto/checkinit.go +71 -0
  341. data/vendor/google.golang.org/protobuf/proto/decode.go +278 -0
  342. data/vendor/google.golang.org/protobuf/proto/decode_gen.go +603 -0
  343. data/vendor/google.golang.org/protobuf/proto/doc.go +94 -0
  344. data/vendor/google.golang.org/protobuf/proto/encode.go +319 -0
  345. data/vendor/google.golang.org/protobuf/proto/encode_gen.go +97 -0
  346. data/vendor/google.golang.org/protobuf/proto/equal.go +167 -0
  347. data/vendor/google.golang.org/protobuf/proto/extension.go +92 -0
  348. data/vendor/google.golang.org/protobuf/proto/merge.go +139 -0
  349. data/vendor/google.golang.org/protobuf/proto/messageset.go +93 -0
  350. data/vendor/google.golang.org/protobuf/proto/proto.go +43 -0
  351. data/vendor/google.golang.org/protobuf/proto/proto_methods.go +19 -0
  352. data/vendor/google.golang.org/protobuf/proto/proto_reflect.go +19 -0
  353. data/vendor/google.golang.org/protobuf/proto/reset.go +43 -0
  354. data/vendor/google.golang.org/protobuf/proto/size.go +97 -0
  355. data/vendor/google.golang.org/protobuf/proto/size_gen.go +55 -0
  356. data/vendor/google.golang.org/protobuf/proto/wrappers.go +29 -0
  357. data/vendor/google.golang.org/protobuf/reflect/protodesc/desc.go +276 -0
  358. data/vendor/google.golang.org/protobuf/reflect/protodesc/desc_init.go +248 -0
  359. data/vendor/google.golang.org/protobuf/reflect/protodesc/desc_resolve.go +286 -0
  360. data/vendor/google.golang.org/protobuf/reflect/protodesc/desc_validate.go +374 -0
  361. data/vendor/google.golang.org/protobuf/reflect/protodesc/proto.go +252 -0
  362. data/vendor/google.golang.org/protobuf/reflect/protoreflect/methods.go +77 -0
  363. data/vendor/google.golang.org/protobuf/reflect/protoreflect/proto.go +504 -0
  364. data/vendor/google.golang.org/protobuf/reflect/protoreflect/source.go +128 -0
  365. data/vendor/google.golang.org/protobuf/reflect/protoreflect/source_gen.go +461 -0
  366. data/vendor/google.golang.org/protobuf/reflect/protoreflect/type.go +665 -0
  367. data/vendor/google.golang.org/protobuf/reflect/protoreflect/value.go +285 -0
  368. data/vendor/google.golang.org/protobuf/reflect/protoreflect/value_pure.go +59 -0
  369. data/vendor/google.golang.org/protobuf/reflect/protoreflect/value_union.go +411 -0
  370. data/vendor/google.golang.org/protobuf/reflect/protoreflect/value_unsafe.go +98 -0
  371. data/vendor/google.golang.org/protobuf/reflect/protoregistry/registry.go +869 -0
  372. data/vendor/google.golang.org/protobuf/runtime/protoiface/legacy.go +15 -0
  373. data/vendor/google.golang.org/protobuf/runtime/protoiface/methods.go +167 -0
  374. data/vendor/google.golang.org/protobuf/runtime/protoimpl/impl.go +44 -0
  375. data/vendor/google.golang.org/protobuf/runtime/protoimpl/version.go +56 -0
  376. data/vendor/google.golang.org/protobuf/types/descriptorpb/descriptor.pb.go +4039 -0
  377. data/vendor/modules.txt +79 -0
  378. metadata +495 -0
@@ -0,0 +1,98 @@
1
+ // Copyright 2018 The Go Authors. All rights reserved.
2
+ // Use of this source code is governed by a BSD-style
3
+ // license that can be found in the LICENSE file.
4
+
5
+ // +build !purego,!appengine
6
+
7
+ package protoreflect
8
+
9
+ import (
10
+ "unsafe"
11
+
12
+ "google.golang.org/protobuf/internal/pragma"
13
+ )
14
+
15
+ type (
16
+ stringHeader struct {
17
+ Data unsafe.Pointer
18
+ Len int
19
+ }
20
+ sliceHeader struct {
21
+ Data unsafe.Pointer
22
+ Len int
23
+ Cap int
24
+ }
25
+ ifaceHeader struct {
26
+ Type unsafe.Pointer
27
+ Data unsafe.Pointer
28
+ }
29
+ )
30
+
31
+ var (
32
+ nilType = typeOf(nil)
33
+ boolType = typeOf(*new(bool))
34
+ int32Type = typeOf(*new(int32))
35
+ int64Type = typeOf(*new(int64))
36
+ uint32Type = typeOf(*new(uint32))
37
+ uint64Type = typeOf(*new(uint64))
38
+ float32Type = typeOf(*new(float32))
39
+ float64Type = typeOf(*new(float64))
40
+ stringType = typeOf(*new(string))
41
+ bytesType = typeOf(*new([]byte))
42
+ enumType = typeOf(*new(EnumNumber))
43
+ )
44
+
45
+ // typeOf returns a pointer to the Go type information.
46
+ // The pointer is comparable and equal if and only if the types are identical.
47
+ func typeOf(t interface{}) unsafe.Pointer {
48
+ return (*ifaceHeader)(unsafe.Pointer(&t)).Type
49
+ }
50
+
51
+ // value is a union where only one type can be represented at a time.
52
+ // The struct is 24B large on 64-bit systems and requires the minimum storage
53
+ // necessary to represent each possible type.
54
+ //
55
+ // The Go GC needs to be able to scan variables containing pointers.
56
+ // As such, pointers and non-pointers cannot be intermixed.
57
+ type value struct {
58
+ pragma.DoNotCompare // 0B
59
+
60
+ // typ stores the type of the value as a pointer to the Go type.
61
+ typ unsafe.Pointer // 8B
62
+
63
+ // ptr stores the data pointer for a String, Bytes, or interface value.
64
+ ptr unsafe.Pointer // 8B
65
+
66
+ // num stores a Bool, Int32, Int64, Uint32, Uint64, Float32, Float64, or
67
+ // Enum value as a raw uint64.
68
+ //
69
+ // It is also used to store the length of a String or Bytes value;
70
+ // the capacity is ignored.
71
+ num uint64 // 8B
72
+ }
73
+
74
+ func valueOfString(v string) Value {
75
+ p := (*stringHeader)(unsafe.Pointer(&v))
76
+ return Value{typ: stringType, ptr: p.Data, num: uint64(len(v))}
77
+ }
78
+ func valueOfBytes(v []byte) Value {
79
+ p := (*sliceHeader)(unsafe.Pointer(&v))
80
+ return Value{typ: bytesType, ptr: p.Data, num: uint64(len(v))}
81
+ }
82
+ func valueOfIface(v interface{}) Value {
83
+ p := (*ifaceHeader)(unsafe.Pointer(&v))
84
+ return Value{typ: p.Type, ptr: p.Data}
85
+ }
86
+
87
+ func (v Value) getString() (x string) {
88
+ *(*stringHeader)(unsafe.Pointer(&x)) = stringHeader{Data: v.ptr, Len: int(v.num)}
89
+ return x
90
+ }
91
+ func (v Value) getBytes() (x []byte) {
92
+ *(*sliceHeader)(unsafe.Pointer(&x)) = sliceHeader{Data: v.ptr, Len: int(v.num), Cap: int(v.num)}
93
+ return x
94
+ }
95
+ func (v Value) getIface() (x interface{}) {
96
+ *(*ifaceHeader)(unsafe.Pointer(&x)) = ifaceHeader{Type: v.typ, Data: v.ptr}
97
+ return x
98
+ }
@@ -0,0 +1,869 @@
1
+ // Copyright 2018 The Go Authors. All rights reserved.
2
+ // Use of this source code is governed by a BSD-style
3
+ // license that can be found in the LICENSE file.
4
+
5
+ // Package protoregistry provides data structures to register and lookup
6
+ // protobuf descriptor types.
7
+ //
8
+ // The Files registry contains file descriptors and provides the ability
9
+ // to iterate over the files or lookup a specific descriptor within the files.
10
+ // Files only contains protobuf descriptors and has no understanding of Go
11
+ // type information that may be associated with each descriptor.
12
+ //
13
+ // The Types registry contains descriptor types for which there is a known
14
+ // Go type associated with that descriptor. It provides the ability to iterate
15
+ // over the registered types or lookup a type by name.
16
+ package protoregistry
17
+
18
+ import (
19
+ "fmt"
20
+ "os"
21
+ "strings"
22
+ "sync"
23
+
24
+ "google.golang.org/protobuf/internal/encoding/messageset"
25
+ "google.golang.org/protobuf/internal/errors"
26
+ "google.golang.org/protobuf/internal/flags"
27
+ "google.golang.org/protobuf/reflect/protoreflect"
28
+ )
29
+
30
+ // conflictPolicy configures the policy for handling registration conflicts.
31
+ //
32
+ // It can be over-written at compile time with a linker-initialized variable:
33
+ // go build -ldflags "-X google.golang.org/protobuf/reflect/protoregistry.conflictPolicy=warn"
34
+ //
35
+ // It can be over-written at program execution with an environment variable:
36
+ // GOLANG_PROTOBUF_REGISTRATION_CONFLICT=warn ./main
37
+ //
38
+ // Neither of the above are covered by the compatibility promise and
39
+ // may be removed in a future release of this module.
40
+ var conflictPolicy = "panic" // "panic" | "warn" | "ignore"
41
+
42
+ // ignoreConflict reports whether to ignore a registration conflict
43
+ // given the descriptor being registered and the error.
44
+ // It is a variable so that the behavior is easily overridden in another file.
45
+ var ignoreConflict = func(d protoreflect.Descriptor, err error) bool {
46
+ const env = "GOLANG_PROTOBUF_REGISTRATION_CONFLICT"
47
+ const faq = "https://developers.google.com/protocol-buffers/docs/reference/go/faq#namespace-conflict"
48
+ policy := conflictPolicy
49
+ if v := os.Getenv(env); v != "" {
50
+ policy = v
51
+ }
52
+ switch policy {
53
+ case "panic":
54
+ panic(fmt.Sprintf("%v\nSee %v\n", err, faq))
55
+ case "warn":
56
+ fmt.Fprintf(os.Stderr, "WARNING: %v\nSee %v\n\n", err, faq)
57
+ return true
58
+ case "ignore":
59
+ return true
60
+ default:
61
+ panic("invalid " + env + " value: " + os.Getenv(env))
62
+ }
63
+ }
64
+
65
+ var globalMutex sync.RWMutex
66
+
67
+ // GlobalFiles is a global registry of file descriptors.
68
+ var GlobalFiles *Files = new(Files)
69
+
70
+ // GlobalTypes is the registry used by default for type lookups
71
+ // unless a local registry is provided by the user.
72
+ var GlobalTypes *Types = new(Types)
73
+
74
+ // NotFound is a sentinel error value to indicate that the type was not found.
75
+ //
76
+ // Since registry lookup can happen in the critical performance path, resolvers
77
+ // must return this exact error value, not an error wrapping it.
78
+ var NotFound = errors.New("not found")
79
+
80
+ // Files is a registry for looking up or iterating over files and the
81
+ // descriptors contained within them.
82
+ // The Find and Range methods are safe for concurrent use.
83
+ type Files struct {
84
+ // The map of descsByName contains:
85
+ // EnumDescriptor
86
+ // EnumValueDescriptor
87
+ // MessageDescriptor
88
+ // ExtensionDescriptor
89
+ // ServiceDescriptor
90
+ // *packageDescriptor
91
+ //
92
+ // Note that files are stored as a slice, since a package may contain
93
+ // multiple files. Only top-level declarations are registered.
94
+ // Note that enum values are in the top-level since that are in the same
95
+ // scope as the parent enum.
96
+ descsByName map[protoreflect.FullName]interface{}
97
+ filesByPath map[string]protoreflect.FileDescriptor
98
+ }
99
+
100
+ type packageDescriptor struct {
101
+ files []protoreflect.FileDescriptor
102
+ }
103
+
104
+ // RegisterFile registers the provided file descriptor.
105
+ //
106
+ // If any descriptor within the file conflicts with the descriptor of any
107
+ // previously registered file (e.g., two enums with the same full name),
108
+ // then the file is not registered and an error is returned.
109
+ //
110
+ // It is permitted for multiple files to have the same file path.
111
+ func (r *Files) RegisterFile(file protoreflect.FileDescriptor) error {
112
+ if r == GlobalFiles {
113
+ globalMutex.Lock()
114
+ defer globalMutex.Unlock()
115
+ }
116
+ if r.descsByName == nil {
117
+ r.descsByName = map[protoreflect.FullName]interface{}{
118
+ "": &packageDescriptor{},
119
+ }
120
+ r.filesByPath = make(map[string]protoreflect.FileDescriptor)
121
+ }
122
+ path := file.Path()
123
+ if prev := r.filesByPath[path]; prev != nil {
124
+ r.checkGenProtoConflict(path)
125
+ err := errors.New("file %q is already registered", file.Path())
126
+ err = amendErrorWithCaller(err, prev, file)
127
+ if r == GlobalFiles && ignoreConflict(file, err) {
128
+ err = nil
129
+ }
130
+ return err
131
+ }
132
+
133
+ for name := file.Package(); name != ""; name = name.Parent() {
134
+ switch prev := r.descsByName[name]; prev.(type) {
135
+ case nil, *packageDescriptor:
136
+ default:
137
+ err := errors.New("file %q has a package name conflict over %v", file.Path(), name)
138
+ err = amendErrorWithCaller(err, prev, file)
139
+ if r == GlobalFiles && ignoreConflict(file, err) {
140
+ err = nil
141
+ }
142
+ return err
143
+ }
144
+ }
145
+ var err error
146
+ var hasConflict bool
147
+ rangeTopLevelDescriptors(file, func(d protoreflect.Descriptor) {
148
+ if prev := r.descsByName[d.FullName()]; prev != nil {
149
+ hasConflict = true
150
+ err = errors.New("file %q has a name conflict over %v", file.Path(), d.FullName())
151
+ err = amendErrorWithCaller(err, prev, file)
152
+ if r == GlobalFiles && ignoreConflict(d, err) {
153
+ err = nil
154
+ }
155
+ }
156
+ })
157
+ if hasConflict {
158
+ return err
159
+ }
160
+
161
+ for name := file.Package(); name != ""; name = name.Parent() {
162
+ if r.descsByName[name] == nil {
163
+ r.descsByName[name] = &packageDescriptor{}
164
+ }
165
+ }
166
+ p := r.descsByName[file.Package()].(*packageDescriptor)
167
+ p.files = append(p.files, file)
168
+ rangeTopLevelDescriptors(file, func(d protoreflect.Descriptor) {
169
+ r.descsByName[d.FullName()] = d
170
+ })
171
+ r.filesByPath[path] = file
172
+ return nil
173
+ }
174
+
175
+ // Several well-known types were hosted in the google.golang.org/genproto module
176
+ // but were later moved to this module. To avoid a weak dependency on the
177
+ // genproto module (and its relatively large set of transitive dependencies),
178
+ // we rely on a registration conflict to determine whether the genproto version
179
+ // is too old (i.e., does not contain aliases to the new type declarations).
180
+ func (r *Files) checkGenProtoConflict(path string) {
181
+ if r != GlobalFiles {
182
+ return
183
+ }
184
+ var prevPath string
185
+ const prevModule = "google.golang.org/genproto"
186
+ const prevVersion = "cb27e3aa (May 26th, 2020)"
187
+ switch path {
188
+ case "google/protobuf/field_mask.proto":
189
+ prevPath = prevModule + "/protobuf/field_mask"
190
+ case "google/protobuf/api.proto":
191
+ prevPath = prevModule + "/protobuf/api"
192
+ case "google/protobuf/type.proto":
193
+ prevPath = prevModule + "/protobuf/ptype"
194
+ case "google/protobuf/source_context.proto":
195
+ prevPath = prevModule + "/protobuf/source_context"
196
+ default:
197
+ return
198
+ }
199
+ pkgName := strings.TrimSuffix(strings.TrimPrefix(path, "google/protobuf/"), ".proto")
200
+ pkgName = strings.Replace(pkgName, "_", "", -1) + "pb" // e.g., "field_mask" => "fieldmaskpb"
201
+ currPath := "google.golang.org/protobuf/types/known/" + pkgName
202
+ panic(fmt.Sprintf(""+
203
+ "duplicate registration of %q\n"+
204
+ "\n"+
205
+ "The generated definition for this file has moved:\n"+
206
+ "\tfrom: %q\n"+
207
+ "\tto: %q\n"+
208
+ "A dependency on the %q module must\n"+
209
+ "be at version %v or higher.\n"+
210
+ "\n"+
211
+ "Upgrade the dependency by running:\n"+
212
+ "\tgo get -u %v\n",
213
+ path, prevPath, currPath, prevModule, prevVersion, prevPath))
214
+ }
215
+
216
+ // FindDescriptorByName looks up a descriptor by the full name.
217
+ //
218
+ // This returns (nil, NotFound) if not found.
219
+ func (r *Files) FindDescriptorByName(name protoreflect.FullName) (protoreflect.Descriptor, error) {
220
+ if r == nil {
221
+ return nil, NotFound
222
+ }
223
+ if r == GlobalFiles {
224
+ globalMutex.RLock()
225
+ defer globalMutex.RUnlock()
226
+ }
227
+ prefix := name
228
+ suffix := nameSuffix("")
229
+ for prefix != "" {
230
+ if d, ok := r.descsByName[prefix]; ok {
231
+ switch d := d.(type) {
232
+ case protoreflect.EnumDescriptor:
233
+ if d.FullName() == name {
234
+ return d, nil
235
+ }
236
+ case protoreflect.EnumValueDescriptor:
237
+ if d.FullName() == name {
238
+ return d, nil
239
+ }
240
+ case protoreflect.MessageDescriptor:
241
+ if d.FullName() == name {
242
+ return d, nil
243
+ }
244
+ if d := findDescriptorInMessage(d, suffix); d != nil && d.FullName() == name {
245
+ return d, nil
246
+ }
247
+ case protoreflect.ExtensionDescriptor:
248
+ if d.FullName() == name {
249
+ return d, nil
250
+ }
251
+ case protoreflect.ServiceDescriptor:
252
+ if d.FullName() == name {
253
+ return d, nil
254
+ }
255
+ if d := d.Methods().ByName(suffix.Pop()); d != nil && d.FullName() == name {
256
+ return d, nil
257
+ }
258
+ }
259
+ return nil, NotFound
260
+ }
261
+ prefix = prefix.Parent()
262
+ suffix = nameSuffix(name[len(prefix)+len("."):])
263
+ }
264
+ return nil, NotFound
265
+ }
266
+
267
+ func findDescriptorInMessage(md protoreflect.MessageDescriptor, suffix nameSuffix) protoreflect.Descriptor {
268
+ name := suffix.Pop()
269
+ if suffix == "" {
270
+ if ed := md.Enums().ByName(name); ed != nil {
271
+ return ed
272
+ }
273
+ for i := md.Enums().Len() - 1; i >= 0; i-- {
274
+ if vd := md.Enums().Get(i).Values().ByName(name); vd != nil {
275
+ return vd
276
+ }
277
+ }
278
+ if xd := md.Extensions().ByName(name); xd != nil {
279
+ return xd
280
+ }
281
+ if fd := md.Fields().ByName(name); fd != nil {
282
+ return fd
283
+ }
284
+ if od := md.Oneofs().ByName(name); od != nil {
285
+ return od
286
+ }
287
+ }
288
+ if md := md.Messages().ByName(name); md != nil {
289
+ if suffix == "" {
290
+ return md
291
+ }
292
+ return findDescriptorInMessage(md, suffix)
293
+ }
294
+ return nil
295
+ }
296
+
297
+ type nameSuffix string
298
+
299
+ func (s *nameSuffix) Pop() (name protoreflect.Name) {
300
+ if i := strings.IndexByte(string(*s), '.'); i >= 0 {
301
+ name, *s = protoreflect.Name((*s)[:i]), (*s)[i+1:]
302
+ } else {
303
+ name, *s = protoreflect.Name((*s)), ""
304
+ }
305
+ return name
306
+ }
307
+
308
+ // FindFileByPath looks up a file by the path.
309
+ //
310
+ // This returns (nil, NotFound) if not found.
311
+ func (r *Files) FindFileByPath(path string) (protoreflect.FileDescriptor, error) {
312
+ if r == nil {
313
+ return nil, NotFound
314
+ }
315
+ if r == GlobalFiles {
316
+ globalMutex.RLock()
317
+ defer globalMutex.RUnlock()
318
+ }
319
+ if fd, ok := r.filesByPath[path]; ok {
320
+ return fd, nil
321
+ }
322
+ return nil, NotFound
323
+ }
324
+
325
+ // NumFiles reports the number of registered files.
326
+ func (r *Files) NumFiles() int {
327
+ if r == nil {
328
+ return 0
329
+ }
330
+ if r == GlobalFiles {
331
+ globalMutex.RLock()
332
+ defer globalMutex.RUnlock()
333
+ }
334
+ return len(r.filesByPath)
335
+ }
336
+
337
+ // RangeFiles iterates over all registered files while f returns true.
338
+ // The iteration order is undefined.
339
+ func (r *Files) RangeFiles(f func(protoreflect.FileDescriptor) bool) {
340
+ if r == nil {
341
+ return
342
+ }
343
+ if r == GlobalFiles {
344
+ globalMutex.RLock()
345
+ defer globalMutex.RUnlock()
346
+ }
347
+ for _, file := range r.filesByPath {
348
+ if !f(file) {
349
+ return
350
+ }
351
+ }
352
+ }
353
+
354
+ // NumFilesByPackage reports the number of registered files in a proto package.
355
+ func (r *Files) NumFilesByPackage(name protoreflect.FullName) int {
356
+ if r == nil {
357
+ return 0
358
+ }
359
+ if r == GlobalFiles {
360
+ globalMutex.RLock()
361
+ defer globalMutex.RUnlock()
362
+ }
363
+ p, ok := r.descsByName[name].(*packageDescriptor)
364
+ if !ok {
365
+ return 0
366
+ }
367
+ return len(p.files)
368
+ }
369
+
370
+ // RangeFilesByPackage iterates over all registered files in a given proto package
371
+ // while f returns true. The iteration order is undefined.
372
+ func (r *Files) RangeFilesByPackage(name protoreflect.FullName, f func(protoreflect.FileDescriptor) bool) {
373
+ if r == nil {
374
+ return
375
+ }
376
+ if r == GlobalFiles {
377
+ globalMutex.RLock()
378
+ defer globalMutex.RUnlock()
379
+ }
380
+ p, ok := r.descsByName[name].(*packageDescriptor)
381
+ if !ok {
382
+ return
383
+ }
384
+ for _, file := range p.files {
385
+ if !f(file) {
386
+ return
387
+ }
388
+ }
389
+ }
390
+
391
+ // rangeTopLevelDescriptors iterates over all top-level descriptors in a file
392
+ // which will be directly entered into the registry.
393
+ func rangeTopLevelDescriptors(fd protoreflect.FileDescriptor, f func(protoreflect.Descriptor)) {
394
+ eds := fd.Enums()
395
+ for i := eds.Len() - 1; i >= 0; i-- {
396
+ f(eds.Get(i))
397
+ vds := eds.Get(i).Values()
398
+ for i := vds.Len() - 1; i >= 0; i-- {
399
+ f(vds.Get(i))
400
+ }
401
+ }
402
+ mds := fd.Messages()
403
+ for i := mds.Len() - 1; i >= 0; i-- {
404
+ f(mds.Get(i))
405
+ }
406
+ xds := fd.Extensions()
407
+ for i := xds.Len() - 1; i >= 0; i-- {
408
+ f(xds.Get(i))
409
+ }
410
+ sds := fd.Services()
411
+ for i := sds.Len() - 1; i >= 0; i-- {
412
+ f(sds.Get(i))
413
+ }
414
+ }
415
+
416
+ // MessageTypeResolver is an interface for looking up messages.
417
+ //
418
+ // A compliant implementation must deterministically return the same type
419
+ // if no error is encountered.
420
+ //
421
+ // The Types type implements this interface.
422
+ type MessageTypeResolver interface {
423
+ // FindMessageByName looks up a message by its full name.
424
+ // E.g., "google.protobuf.Any"
425
+ //
426
+ // This return (nil, NotFound) if not found.
427
+ FindMessageByName(message protoreflect.FullName) (protoreflect.MessageType, error)
428
+
429
+ // FindMessageByURL looks up a message by a URL identifier.
430
+ // See documentation on google.protobuf.Any.type_url for the URL format.
431
+ //
432
+ // This returns (nil, NotFound) if not found.
433
+ FindMessageByURL(url string) (protoreflect.MessageType, error)
434
+ }
435
+
436
+ // ExtensionTypeResolver is an interface for looking up extensions.
437
+ //
438
+ // A compliant implementation must deterministically return the same type
439
+ // if no error is encountered.
440
+ //
441
+ // The Types type implements this interface.
442
+ type ExtensionTypeResolver interface {
443
+ // FindExtensionByName looks up a extension field by the field's full name.
444
+ // Note that this is the full name of the field as determined by
445
+ // where the extension is declared and is unrelated to the full name of the
446
+ // message being extended.
447
+ //
448
+ // This returns (nil, NotFound) if not found.
449
+ FindExtensionByName(field protoreflect.FullName) (protoreflect.ExtensionType, error)
450
+
451
+ // FindExtensionByNumber looks up a extension field by the field number
452
+ // within some parent message, identified by full name.
453
+ //
454
+ // This returns (nil, NotFound) if not found.
455
+ FindExtensionByNumber(message protoreflect.FullName, field protoreflect.FieldNumber) (protoreflect.ExtensionType, error)
456
+ }
457
+
458
+ var (
459
+ _ MessageTypeResolver = (*Types)(nil)
460
+ _ ExtensionTypeResolver = (*Types)(nil)
461
+ )
462
+
463
+ // Types is a registry for looking up or iterating over descriptor types.
464
+ // The Find and Range methods are safe for concurrent use.
465
+ type Types struct {
466
+ typesByName typesByName
467
+ extensionsByMessage extensionsByMessage
468
+
469
+ numEnums int
470
+ numMessages int
471
+ numExtensions int
472
+ }
473
+
474
+ type (
475
+ typesByName map[protoreflect.FullName]interface{}
476
+ extensionsByMessage map[protoreflect.FullName]extensionsByNumber
477
+ extensionsByNumber map[protoreflect.FieldNumber]protoreflect.ExtensionType
478
+ )
479
+
480
+ // RegisterMessage registers the provided message type.
481
+ //
482
+ // If a naming conflict occurs, the type is not registered and an error is returned.
483
+ func (r *Types) RegisterMessage(mt protoreflect.MessageType) error {
484
+ // Under rare circumstances getting the descriptor might recursively
485
+ // examine the registry, so fetch it before locking.
486
+ md := mt.Descriptor()
487
+
488
+ if r == GlobalTypes {
489
+ globalMutex.Lock()
490
+ defer globalMutex.Unlock()
491
+ }
492
+
493
+ if err := r.register("message", md, mt); err != nil {
494
+ return err
495
+ }
496
+ r.numMessages++
497
+ return nil
498
+ }
499
+
500
+ // RegisterEnum registers the provided enum type.
501
+ //
502
+ // If a naming conflict occurs, the type is not registered and an error is returned.
503
+ func (r *Types) RegisterEnum(et protoreflect.EnumType) error {
504
+ // Under rare circumstances getting the descriptor might recursively
505
+ // examine the registry, so fetch it before locking.
506
+ ed := et.Descriptor()
507
+
508
+ if r == GlobalTypes {
509
+ globalMutex.Lock()
510
+ defer globalMutex.Unlock()
511
+ }
512
+
513
+ if err := r.register("enum", ed, et); err != nil {
514
+ return err
515
+ }
516
+ r.numEnums++
517
+ return nil
518
+ }
519
+
520
+ // RegisterExtension registers the provided extension type.
521
+ //
522
+ // If a naming conflict occurs, the type is not registered and an error is returned.
523
+ func (r *Types) RegisterExtension(xt protoreflect.ExtensionType) error {
524
+ // Under rare circumstances getting the descriptor might recursively
525
+ // examine the registry, so fetch it before locking.
526
+ //
527
+ // A known case where this can happen: Fetching the TypeDescriptor for a
528
+ // legacy ExtensionDesc can consult the global registry.
529
+ xd := xt.TypeDescriptor()
530
+
531
+ if r == GlobalTypes {
532
+ globalMutex.Lock()
533
+ defer globalMutex.Unlock()
534
+ }
535
+
536
+ field := xd.Number()
537
+ message := xd.ContainingMessage().FullName()
538
+ if prev := r.extensionsByMessage[message][field]; prev != nil {
539
+ err := errors.New("extension number %d is already registered on message %v", field, message)
540
+ err = amendErrorWithCaller(err, prev, xt)
541
+ if !(r == GlobalTypes && ignoreConflict(xd, err)) {
542
+ return err
543
+ }
544
+ }
545
+
546
+ if err := r.register("extension", xd, xt); err != nil {
547
+ return err
548
+ }
549
+ if r.extensionsByMessage == nil {
550
+ r.extensionsByMessage = make(extensionsByMessage)
551
+ }
552
+ if r.extensionsByMessage[message] == nil {
553
+ r.extensionsByMessage[message] = make(extensionsByNumber)
554
+ }
555
+ r.extensionsByMessage[message][field] = xt
556
+ r.numExtensions++
557
+ return nil
558
+ }
559
+
560
+ func (r *Types) register(kind string, desc protoreflect.Descriptor, typ interface{}) error {
561
+ name := desc.FullName()
562
+ prev := r.typesByName[name]
563
+ if prev != nil {
564
+ err := errors.New("%v %v is already registered", kind, name)
565
+ err = amendErrorWithCaller(err, prev, typ)
566
+ if !(r == GlobalTypes && ignoreConflict(desc, err)) {
567
+ return err
568
+ }
569
+ }
570
+ if r.typesByName == nil {
571
+ r.typesByName = make(typesByName)
572
+ }
573
+ r.typesByName[name] = typ
574
+ return nil
575
+ }
576
+
577
+ // FindEnumByName looks up an enum by its full name.
578
+ // E.g., "google.protobuf.Field.Kind".
579
+ //
580
+ // This returns (nil, NotFound) if not found.
581
+ func (r *Types) FindEnumByName(enum protoreflect.FullName) (protoreflect.EnumType, error) {
582
+ if r == nil {
583
+ return nil, NotFound
584
+ }
585
+ if r == GlobalTypes {
586
+ globalMutex.RLock()
587
+ defer globalMutex.RUnlock()
588
+ }
589
+ if v := r.typesByName[enum]; v != nil {
590
+ if et, _ := v.(protoreflect.EnumType); et != nil {
591
+ return et, nil
592
+ }
593
+ return nil, errors.New("found wrong type: got %v, want enum", typeName(v))
594
+ }
595
+ return nil, NotFound
596
+ }
597
+
598
+ // FindMessageByName looks up a message by its full name,
599
+ // e.g. "google.protobuf.Any".
600
+ //
601
+ // This returns (nil, NotFound) if not found.
602
+ func (r *Types) FindMessageByName(message protoreflect.FullName) (protoreflect.MessageType, error) {
603
+ if r == nil {
604
+ return nil, NotFound
605
+ }
606
+ if r == GlobalTypes {
607
+ globalMutex.RLock()
608
+ defer globalMutex.RUnlock()
609
+ }
610
+ if v := r.typesByName[message]; v != nil {
611
+ if mt, _ := v.(protoreflect.MessageType); mt != nil {
612
+ return mt, nil
613
+ }
614
+ return nil, errors.New("found wrong type: got %v, want message", typeName(v))
615
+ }
616
+ return nil, NotFound
617
+ }
618
+
619
+ // FindMessageByURL looks up a message by a URL identifier.
620
+ // See documentation on google.protobuf.Any.type_url for the URL format.
621
+ //
622
+ // This returns (nil, NotFound) if not found.
623
+ func (r *Types) FindMessageByURL(url string) (protoreflect.MessageType, error) {
624
+ // This function is similar to FindMessageByName but
625
+ // truncates anything before and including '/' in the URL.
626
+ if r == nil {
627
+ return nil, NotFound
628
+ }
629
+ if r == GlobalTypes {
630
+ globalMutex.RLock()
631
+ defer globalMutex.RUnlock()
632
+ }
633
+ message := protoreflect.FullName(url)
634
+ if i := strings.LastIndexByte(url, '/'); i >= 0 {
635
+ message = message[i+len("/"):]
636
+ }
637
+
638
+ if v := r.typesByName[message]; v != nil {
639
+ if mt, _ := v.(protoreflect.MessageType); mt != nil {
640
+ return mt, nil
641
+ }
642
+ return nil, errors.New("found wrong type: got %v, want message", typeName(v))
643
+ }
644
+ return nil, NotFound
645
+ }
646
+
647
+ // FindExtensionByName looks up a extension field by the field's full name.
648
+ // Note that this is the full name of the field as determined by
649
+ // where the extension is declared and is unrelated to the full name of the
650
+ // message being extended.
651
+ //
652
+ // This returns (nil, NotFound) if not found.
653
+ func (r *Types) FindExtensionByName(field protoreflect.FullName) (protoreflect.ExtensionType, error) {
654
+ if r == nil {
655
+ return nil, NotFound
656
+ }
657
+ if r == GlobalTypes {
658
+ globalMutex.RLock()
659
+ defer globalMutex.RUnlock()
660
+ }
661
+ if v := r.typesByName[field]; v != nil {
662
+ if xt, _ := v.(protoreflect.ExtensionType); xt != nil {
663
+ return xt, nil
664
+ }
665
+
666
+ // MessageSet extensions are special in that the name of the extension
667
+ // is the name of the message type used to extend the MessageSet.
668
+ // This naming scheme is used by text and JSON serialization.
669
+ //
670
+ // This feature is protected by the ProtoLegacy flag since MessageSets
671
+ // are a proto1 feature that is long deprecated.
672
+ if flags.ProtoLegacy {
673
+ if _, ok := v.(protoreflect.MessageType); ok {
674
+ field := field.Append(messageset.ExtensionName)
675
+ if v := r.typesByName[field]; v != nil {
676
+ if xt, _ := v.(protoreflect.ExtensionType); xt != nil {
677
+ if messageset.IsMessageSetExtension(xt.TypeDescriptor()) {
678
+ return xt, nil
679
+ }
680
+ }
681
+ }
682
+ }
683
+ }
684
+
685
+ return nil, errors.New("found wrong type: got %v, want extension", typeName(v))
686
+ }
687
+ return nil, NotFound
688
+ }
689
+
690
+ // FindExtensionByNumber looks up a extension field by the field number
691
+ // within some parent message, identified by full name.
692
+ //
693
+ // This returns (nil, NotFound) if not found.
694
+ func (r *Types) FindExtensionByNumber(message protoreflect.FullName, field protoreflect.FieldNumber) (protoreflect.ExtensionType, error) {
695
+ if r == nil {
696
+ return nil, NotFound
697
+ }
698
+ if r == GlobalTypes {
699
+ globalMutex.RLock()
700
+ defer globalMutex.RUnlock()
701
+ }
702
+ if xt, ok := r.extensionsByMessage[message][field]; ok {
703
+ return xt, nil
704
+ }
705
+ return nil, NotFound
706
+ }
707
+
708
+ // NumEnums reports the number of registered enums.
709
+ func (r *Types) NumEnums() int {
710
+ if r == nil {
711
+ return 0
712
+ }
713
+ if r == GlobalTypes {
714
+ globalMutex.RLock()
715
+ defer globalMutex.RUnlock()
716
+ }
717
+ return r.numEnums
718
+ }
719
+
720
+ // RangeEnums iterates over all registered enums while f returns true.
721
+ // Iteration order is undefined.
722
+ func (r *Types) RangeEnums(f func(protoreflect.EnumType) bool) {
723
+ if r == nil {
724
+ return
725
+ }
726
+ if r == GlobalTypes {
727
+ globalMutex.RLock()
728
+ defer globalMutex.RUnlock()
729
+ }
730
+ for _, typ := range r.typesByName {
731
+ if et, ok := typ.(protoreflect.EnumType); ok {
732
+ if !f(et) {
733
+ return
734
+ }
735
+ }
736
+ }
737
+ }
738
+
739
+ // NumMessages reports the number of registered messages.
740
+ func (r *Types) NumMessages() int {
741
+ if r == nil {
742
+ return 0
743
+ }
744
+ if r == GlobalTypes {
745
+ globalMutex.RLock()
746
+ defer globalMutex.RUnlock()
747
+ }
748
+ return r.numMessages
749
+ }
750
+
751
+ // RangeMessages iterates over all registered messages while f returns true.
752
+ // Iteration order is undefined.
753
+ func (r *Types) RangeMessages(f func(protoreflect.MessageType) bool) {
754
+ if r == nil {
755
+ return
756
+ }
757
+ if r == GlobalTypes {
758
+ globalMutex.RLock()
759
+ defer globalMutex.RUnlock()
760
+ }
761
+ for _, typ := range r.typesByName {
762
+ if mt, ok := typ.(protoreflect.MessageType); ok {
763
+ if !f(mt) {
764
+ return
765
+ }
766
+ }
767
+ }
768
+ }
769
+
770
+ // NumExtensions reports the number of registered extensions.
771
+ func (r *Types) NumExtensions() int {
772
+ if r == nil {
773
+ return 0
774
+ }
775
+ if r == GlobalTypes {
776
+ globalMutex.RLock()
777
+ defer globalMutex.RUnlock()
778
+ }
779
+ return r.numExtensions
780
+ }
781
+
782
+ // RangeExtensions iterates over all registered extensions while f returns true.
783
+ // Iteration order is undefined.
784
+ func (r *Types) RangeExtensions(f func(protoreflect.ExtensionType) bool) {
785
+ if r == nil {
786
+ return
787
+ }
788
+ if r == GlobalTypes {
789
+ globalMutex.RLock()
790
+ defer globalMutex.RUnlock()
791
+ }
792
+ for _, typ := range r.typesByName {
793
+ if xt, ok := typ.(protoreflect.ExtensionType); ok {
794
+ if !f(xt) {
795
+ return
796
+ }
797
+ }
798
+ }
799
+ }
800
+
801
+ // NumExtensionsByMessage reports the number of registered extensions for
802
+ // a given message type.
803
+ func (r *Types) NumExtensionsByMessage(message protoreflect.FullName) int {
804
+ if r == nil {
805
+ return 0
806
+ }
807
+ if r == GlobalTypes {
808
+ globalMutex.RLock()
809
+ defer globalMutex.RUnlock()
810
+ }
811
+ return len(r.extensionsByMessage[message])
812
+ }
813
+
814
+ // RangeExtensionsByMessage iterates over all registered extensions filtered
815
+ // by a given message type while f returns true. Iteration order is undefined.
816
+ func (r *Types) RangeExtensionsByMessage(message protoreflect.FullName, f func(protoreflect.ExtensionType) bool) {
817
+ if r == nil {
818
+ return
819
+ }
820
+ if r == GlobalTypes {
821
+ globalMutex.RLock()
822
+ defer globalMutex.RUnlock()
823
+ }
824
+ for _, xt := range r.extensionsByMessage[message] {
825
+ if !f(xt) {
826
+ return
827
+ }
828
+ }
829
+ }
830
+
831
+ func typeName(t interface{}) string {
832
+ switch t.(type) {
833
+ case protoreflect.EnumType:
834
+ return "enum"
835
+ case protoreflect.MessageType:
836
+ return "message"
837
+ case protoreflect.ExtensionType:
838
+ return "extension"
839
+ default:
840
+ return fmt.Sprintf("%T", t)
841
+ }
842
+ }
843
+
844
+ func amendErrorWithCaller(err error, prev, curr interface{}) error {
845
+ prevPkg := goPackage(prev)
846
+ currPkg := goPackage(curr)
847
+ if prevPkg == "" || currPkg == "" || prevPkg == currPkg {
848
+ return err
849
+ }
850
+ return errors.New("%s\n\tpreviously from: %q\n\tcurrently from: %q", err, prevPkg, currPkg)
851
+ }
852
+
853
+ func goPackage(v interface{}) string {
854
+ switch d := v.(type) {
855
+ case protoreflect.EnumType:
856
+ v = d.Descriptor()
857
+ case protoreflect.MessageType:
858
+ v = d.Descriptor()
859
+ case protoreflect.ExtensionType:
860
+ v = d.TypeDescriptor()
861
+ }
862
+ if d, ok := v.(protoreflect.Descriptor); ok {
863
+ v = d.ParentFile()
864
+ }
865
+ if d, ok := v.(interface{ GoPackagePath() string }); ok {
866
+ return d.GoPackagePath()
867
+ }
868
+ return ""
869
+ }