Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

`MultiSearchResponse` type does not account for union search response shape

Abierto Apto para principiantes
#128 0 comentarios 0 reacciones 0 asignados Ver en GitHub

@tharropoulos ya está trabajando en esto.

Desde el 4/5/2026.

  • #130 de @tharropoulos — abierto

Evaluación

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

Línea de trabajo

Empieza en src/typesense/types/multi_search.py y sigue la anotación del tipo de retorno de multi_search.perform(). Compara la respuesta federada descrita en el issue con la forma de union=True en la documentación de la API enlazada. El trabajo estará terminado cuando el tipado de MultiSearchResponse represente correctamente ambas formas de respuesta sin inducir a error a quienes la utilizan.

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

Descripción

The MultiSearchResponse type in src/typesense/types/multi_search.py only models the federated (default) multi-search response shape:

class MultiSearchResponse(typing.TypedDict):
    results: typing.List[SearchResponse[typing.Any]]

However, the /multi_search endpoint has two distinct response shapes depending on whether union is set in the request:

  • Federated search (union absent or False): returns { "results": [ ...one SearchResponse per query... ] }
  • Union search (union: True): returns with no results wrapper doc

The current type is incorrect for the union case and gives users a misleading return type annotation when they call multi_search.perform() with union=True.

Lenguaje dominante
Python
Estrellas
247
Forks
66
Merge medio
22 h 47 min
PR fusionados (30 d)
8

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 typesense/typesense-python

Todos los issues de typesense/typesense-python

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.