envoyproxy/envoy

Create a machine-consumable lists for deprecated fields

Open

#9,842 创建于 2020年1月27日

在 GitHub 查看
 (4 评论) (0 反应) (0 负责人)C++ (5,373 fork)batch import
area/configurationhelp wanted

仓库指标

Star
 (27,997 star)
PR 合并指标
 (平均合并 8天) (30 天内合并 378 个 PR)

描述

When minor API versions deprecate fields or mark them fatal-by-default, config needs to be updated (or overidden in the Runtime). Newly deprecated and newly fatal fields can be difficult to reliably detect.

As suggested by @htuch, could we add a protoc plugin to produce machine-consumable lists for deprecated and fatal fields to make things easier?

贡献者指南

研究方向
首先，通过查阅 protobuf 文档和 Envoy 仓库中的现有示例（例如 tools/protoplasm 或类似工具），理解 protoc 插件接口。研究 Envoy 的 protobuf 文件结构，以识别已弃用的字段。该插件应输出机器可读的列表（例如 JSON），列出标记为已弃用或默认致命的字段。考虑从一个简单的 protoc 插件模板开始，并根据维护者的反馈进行迭代。
技术栈
cpp
领域
backendapitooling
议题类型
功能
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-2 天
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
活跃
清晰度议题是否清楚说明期望改动、验收标准和下一步。
清晰
前置要求
C++Protocol Buffers
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
45