python / python/cpython

Context.items/keys/values docstrings claim lists but return iterators

Aberta
#142,918 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

docs
Linguagem predominante
Python
Estrelas
77.2k
Forks
36k
Métricas de merge de PRs
Métricas de PR pendentes

Descrição

_contextvars.Context.items(), .keys(), and .values() return iterator objects, but their docstrings state that they return lists.

Linked PRs
  • gh-142919
  • gh-143266

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece localizando as docstrings de _contextvars.Context.items(), keys() e values(), depois compare os tipos de retorno indicados com o comportamento dos iteradores descrito na issue. O trabalho estará concluído quando as três docstrings descreverem corretamente o retorno de iteradores; os PRs vinculados gh-142919 e gh-143266 indicam que esse trabalho pode já estar em andamento.

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

Avaliação

Stack de tecnologia
python
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
1/5
Tempo estimado
Menos de uma hora
Status de atividade
Estagnada
Clareza
Claramente especificada
Facilidade para iniciantes
25/100

Receba novas issues na sua caixa de entrada

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