tools/api: add support for 1) deprecating message types and 2) moving nested message types up · envoyproxy/envoy#10740

(2 commenti) (0 reazioni) (0 assegnatari)C++ (5373 fork)batch import

api/v3help wanted

Metriche repository

Title: add support for 1) deprecating message types and 2) moving nested message types up

Description:

at the moment, there are already a few message types that have been deprecated, e.g.
- bootstrap.v2.Runtime
  - tools/api already support removing it from the next API version by adding option deprecated = true;
- trace.v3.Tracing
  - if option deprecated = true; is added, tools/api will remove the message along with its nested types, which is not desired (see next point)
additionally, there is a case where a nested message type needs to be moved up, e.g.
- trace.v3.Tracing.Http => trace.v4.HttpTracer
- and, probably, even trace.v3.Tracing.Http => trace.v3.HttpTracer

Context:

Direzione di ricerca: Esamina il codice esistente di tools/api per capire come vengono implementati la deprecazione dei messaggi e il versionamento. Guarda esempi come 'bootstrap.v2.Runtime' e 'trace.v3.Tracing'. Poi implementa il supporto per deprecare i tipi di messaggio senza rimuovere i loro tipi nidificati, e il supporto per spostare i tipi di messaggio nidificati verso l'alto, a un genitore o in una nuova posizione.
Tech stack: Nessuno
Dominio: api
Tipo issue: Funzionalità
Difficoltà: 2
Tempo stimato: Mezza giornata
Stato attività: Attiva
Chiarezza: Abbastanza chiara
Prerequisiti: Git
Adatta ai principianti: 75