project-chip/connectedhomeip

Support "specification name" across more items within the SDK

Open

#38.891 geöffnet am 12. Mai 2025

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (0 zugewiesene Personen)C++ (1.659 Forks)batch import
good first issuestale

Repository-Metriken

Stars
 (6.410 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 8T 5h) (375 gemergte PRs in 30 T)

Beschreibung

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)

Contributor Guide

Research-Richtung
Untersuchen Sie die aktuelle Verwendung von asUpperCamelCase und preserveAcronyms in ZAP Vorlagen und schlagen Sie dann eine konsistente Syntax für Spezifikationsnamen in Aufzählungen, Bitmaps, Strukturen, Befehlsnamen, Strukturmitgliedernamen und Clusternamen vor. Beginnen Sie mit der Überprüfung von PR #38888 und dem Unit Testing Cluster.
Tech Stack
cpp
Domain
backend
Issue Type
Refactoring
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
4
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Über 1 Woche
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Meist klar
Voraussetzungen
GitC++
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
20