{"id":21403,"library":"grpc-gateway-protoc-gen-openapiv2","title":"gRPC Gateway OpenAPI v2 Protoc Generator","description":"Provides the missing pieces for gRPC Gateway, specifically the protoc-gen-openapiv2 plugin for generating OpenAPI v2 specs from gRPC protobuf definitions. Current version 0.1.0, requires Python >=3.6, early development.","status":"active","version":"0.1.0","language":"python","source_language":"en","source_url":"https://github.com/hack-edu/py_protoc_gen_openapiv2","tags":["grpc","gateway","openapi","protobuf","plugin"],"install":[{"cmd":"pip install grpc-gateway-protoc-gen-openapiv2","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Required for protobuf definitions","package":"protobuf","optional":false},{"reason":"Required for gRPC protoc plugin support","package":"grpcio-tools","optional":true}],"imports":[{"wrong":"import grpc_gateway_protoc_gen_openapiv2.plugin","symbol":"protoc_gen_openapiv2","correct":"import protoc_gen_openapiv2"}],"quickstart":{"code":"import os\nfrom grpc_gateway_protoc_gen_openapiv2.plugin import generate_openapi\n\n# Example usage - replace with actual proto file path\nproto_file = \"api.proto\"\noutput_dir = \"./openapi\"\n\n# Generate OpenAPI spec\n# generate_openapi(proto_file, output_dir)  # uncomment when ready\nprint(\"Quickstart placeholder - see README\")\n","lang":"python","description":"Basic import and placeholder usage of the plugin."},"warnings":[{"fix":"Monitor repository for updates and pin version.","message":"Package name is under development; import paths may change without major version bump.","severity":"breaking","affected_versions":"0.1.0"},{"fix":"Ensure protoc and protoc-gen-openapiv2 are in PATH.","message":"The plugin is a Python wrapper; protoc itself and protoc-gen-openapiv2 binary must be installed separately.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'0.1.0':32 '3.6':35 'current':30 'definit':29 'develop':37 'earli':36 'gateway':2,13,39 'gen':18 'generat':6,22 'grpc':1,12,27,38 'miss':9 'openapi':3,23,40 'openapiv2':19 'piec':10 'plugin':20,42 'protobuf':28,41 'protoc':5,17 'protoc-gen-openapiv2':16 'provid':7 'python':34 'requir':33 'spec':25 'specif':14 'v2':4,24 'version':31","created_at":"2026-04-27T16:59:43.630035+00:00","updated_at":"2026-04-27T16:59:43.630035+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.1.0","cli_name":"protoc-gen-openapiv2","cli_version":"sh: 1: protoc-gen-openapiv2: not found","type":"library","homepage":null,"github":"https://github.com/hack-edu/py_protoc_gen_openapiv2","docs":null,"changelog":null,"pypi":"https://pypi.org/project/grpc-gateway-protoc-gen-openapiv2/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-30","last_verified":"2026-06-30","next_check":"2026-07-30","install_tag":null}}