Wrong type annotations for read only mapping types.

Abierto Apto para principiantes
#2,244 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 3 días

@RasmusNygren ya está trabajando en esto.

Desde el 6/5/2026.

  • #2245 de @RasmusNygren — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
python
Área
api

Línea de trabajo

Empieza en src/confluent_kafka/admin/init.py, alrededor del argumento conf mostrado en el issue, y luego busca otros argumentos de mapping de solo lectura anotados con Dict. Sustituye las anotaciones aplicables por collections.abc.Mapping y verifica que los type-checkers acepten una configuración dict[str, str].

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

status:under-review

There are type annotations that uses Dict to annotate read-only mapping arguments, e.g. the conf argument here: https://github.com/confluentinc/confluent-kafka-python/blob/7d0abd551c5061e655fbf403f9baa09af040e29b/src/confluent_kafka/admin/__init__.py#L118

The problem is that Dict is invariant in its value type, meaning that in the example above where conf is typed as conf: Dict[str, Union[str, int, float, bool] it is not valid to assign a dict of type Dict[str, str].

That means code like this

from confluent_kafka.admin import AdminClient
conf = {
    "bootstrap.servers": "kafka:9092"),
} # inferred type dict[str, str]
admin_client = AdminClient(conf)

is rejected by type-checkers.

The solution here would be to annotate conf with collections.abc.Mapping instead of Dict, as Mapping is covariant in its value-type.

Lenguaje dominante
Python
Estrellas
528
Forks
977
Merge medio
2 d 19 h
PR fusionados (30 d)
19

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de confluentinc/confluent-kafka-python

Todos los issues de confluentinc/confluent-kafka-python

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.