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

Boolean list elements are encoded as True/False instead of true/false

Abierto Apto para principiantes
  • ¿Algo no está bien?
#1,947 3 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@inchang-ing ya está trabajando en esto.

Desde el 20/10/2026.

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
Activo
Stack tecnológico
python
Área
backend

Línea de trabajo

Empieza en stripe/_encode.py, en _api_encode(), y compara la rama de listas/tuplas con el tratamiento de Boolean para valores independientes y valores de diccionarios anidados. Después, ejecuta las pruebas de codificación que cubren _api_encode() y añade un caso para elementos Boolean en una lista. La tarea está terminada cuando los valores del array codificado son true y false en minúsculas, de forma coherente con las demás posiciones.

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

Descripción

bug
Describe the bug
Description

stripe._encode._api_encode() serializes Boolean values inconsistently depending on their position in the request parameters.

Top-level and nested-dictionary Booleans become lowercase true / false, but Booleans directly inside lists remain Python True / False when URL-encoded.

Minimal reproduction
from urllib.parse import urlencode
from stripe._encode import _api_encode

cases = {
    "standalone": {"enabled": True},
    "array": {"enabled": [True, False]},
    "nested": {"enabled": {"flag": True}},
}

for name, params in cases.items():
    print(name, urlencode(list(_api_encode(params))))
Actual behavior
standalone enabled=true
array enabled%5B0%5D=True&enabled%5B1%5D=False
nested enabled%5Bflag%5D=true
Expected behavior

Boolean array elements should be serialized consistently as lowercase true and false.

Root cause

The list/tuple branch of _api_encode() yields scalar array elements directly without applying the Boolean conversion used elsewhere.

Source:
https://github.com/stripe/stripe-python/blob/master/stripe/_encode.py

Existing tests cover top-level Boolean values and lists separately, but not Booleans directly inside lists.

Verification

Reproduced locally using the current upstream _api_encode() implementation in an isolated Python harness.

No live Stripe API request was made, and the full installed SDK test suite was not executed. The potential impact on specific API endpoints has not yet been established.

To Reproduce
  1. Use the current "stripe-python" "_api_encode()" implementation.
  2. Run the Python example provided in the Minimal reproduction section above. No Stripe API key or network access is required.
  3. Compare the URL-encoded output for standalone, nested, and array Boolean values.
  4. Observe that standalone and nested Booleans become lowercase "true" / "false", while array elements become uppercase "True" / "False".
  5. Expected: All Boolean values should use consistent lowercase encoding regardless of nesting.
Expected behavior

Boolean values should be consistently serialized as lowercase "true" and "false", regardless of whether they appear as standalone values, nested dictionary fields, or array elements.

For example:

enabled%5B0%5D=true&enabled%5B1%5D=false

Instead of:

enabled%5B0%5D=True&enabled%5B1%5D=False

The encoded representation should not depend on the nesting structure.

Code snippets
OS

ubuntu

Language version

Python 3.13

Library version

Development branch (master); isolated source reproduction, no installed SDK

API version

N/A — no Stripe API request performed

Additional context

No response

Lenguaje dominante
Python
Estrellas
2.1k
Forks
539
Merge medio
3 d 5 h
PR fusionados (30 d)
17

Preparar el entorno

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

Todos los issues de stripe/stripe-python

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.