project-chip/connectedhomeip

Support "specification name" across more items within the SDK

Open

#38.891 aberto em 12 de mai. de 2025

Ver no GitHub
 (1 comment) (0 reactions) (0 assignees)C++ (1.659 forks)batch import
good first issuestale

Métricas do repositório

Stars
 (6.410 stars)
Métricas de merge de PR
 (Mesclagem média 8d 5h) (375 fundiu PRs em 30d)

Description

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)

Guia do colaborador

Direção de pesquisa
Investigue o uso atual de asUpperCamelCase e preserveAcronyms nos modelos ZAP e, em seguida, proponha uma sintaxe consistente para nomes de especificação em enums, bitmaps, structs, nomes de comandos, nomes de membros de estrutura e nomes de cluster. Comece examinando o PR #38888 e o cluster de teste de unidade.
Pilha de tecnologia
cpp
Domain
backend
Tipo Issue
Refatoração
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
4
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Mais de 1 semana
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
GitC++
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
20