project-chip/connectedhomeip

Support "specification name" across more items within the SDK

Open

#38.891 aperta il 12 mag 2025

Vedi su GitHub
 (1 commento) (0 reazioni) (0 assegnatari)C++ (1659 fork)batch import
good first issuestale

Metriche repository

Star
 (6410 star)
Metriche merge PR
 (Merge medio 8g 5h) (375 PR mergiate in 30 g)

Descrizione

The ZAP templates vary usage of asUpperCamelCase and asUpperCamelCase preserveAcronyms=true and code generation is inconsistent for acronym handling (e.g. C++ and darwin differ).

When preserveAcronyms makes a difference, we should preserve the XML name (with spaces and special characters and all) so that code generation can make a decision on how to encode things.

https://github.com/project-chip/connectedhomeip/pull/38888 adds support for constant names. We should go beyond that:

  • determine a good syntax throughout (for enums/bitmaps/struct/command names, structure member names, cluster names)
  • apply this syntax to update clusters. It is likely constants are the main ones affected though. May need to manually validate (e.g. using the Unit testing cluster)

Guida contributor

Direzione di ricerca
Investiga l'uso corrente di asUpperCamelCase e preserveAcronyms nei template ZAP, quindi proponi una sintassi coerente per i nomi delle specifiche tra enum, bitmap, struct, nomi di comandi, nomi di membri di struttura e nomi di cluster. Inizia esaminando la PR #38888 e il cluster di test unitari.
Tech stack
cpp
Dominio
backend
Tipo issue
Refactoring
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
4
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
Oltre 1 settimana
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Abbastanza chiara
Prerequisiti
GitC++
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
20