google / google/python-card-framework

Add missing type hints to public API classes in card_framework/v2

Aberta
#11 0 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
Python
Estrelas
23
Forks
6
Métricas de merge de PRs
Nenhum PR com merge em 30d

Descrição

I noticed that several public-facing classes in `card_framework/v2` don’t currently have full type annotations on their methods.
Adding type hints would improve IDE autocomplete, static analysis, and overall developer experience, without changing any runtime behavior.

Suggested scope:

- `card_framework/v2/card.py`
- `card_framework/v2/header.py`
- `card_framework/v2/section.py`
- Common widgets like `text_paragraph.py`, `image.py`, etc.

This should be a purely additive change (type hints + imports from `typing`) and should not affect existing tests or serialization logic.

If this sounds reasonable, I’d be happy to take this up as a first contribution.

Guia de contribuição

Abrir o guia de contribuição

Direção de pesquisa

Start by reviewing the public classes in card_framework/v2/card.py, header.py, section.py, and common widgets such as text_paragraph.py and image.py. Identify methods lacking annotations and check nearby typing imports and existing tests before making additive changes. Done means the scoped public API methods have type hints without changing serialization behavior, and the existing tests still pass.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
python
Domínio
developer-experience
Tipo de issue
Refatoração
Dificuldade
4/5
Tempo estimado
3-5 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
45/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.