python / python/cpython

`csv.get_dialect()` returns a `_csv.Dialect` object, not `csv.Dialect` as documented.

Aberta
#138,352 5 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
35.9k
Métricas de merge de PRs
Métricas de PR pendentes

Descrição

The documentation at https://docs.python.org/3/library/csv.html#csv.Dialect indicates that this class is what is returned when calling csv.get_dialect(). But the C implemented class _csv.Dialect() is returned instead.

>>> import csv
>>> csv.get_dialect("excel")
<_csv.Dialect object at 0x0000026C0004DBC0>

This makes writing typesafe code that uses Dialect a challenge. See related typeshed issue at https://github.com/python/typeshed/issues/14667

It's not clear whether this is a documentation or implementation issue.

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 pelo ponto de entrada csv.get_dialect() e pela documentação de csv.Dialect vinculada na issue; em seguida, compare o tipo de retorno documentado com a classe _csv.Dialect produzida em tempo de execução. Consulte a issue relacionada do typeshed para entender o contexto da tipagem. O trabalho estará concluído quando for decidido se a documentação ou a implementação deve ser alterada e o comportamento público e os tipos forem alinhados de acordo.

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

Avaliação

Stack de tecnologia
python
Domínio
backend
Tipo de issue
Bug
Dificuldade
3/5
Tempo estimado
1-2 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
42/100

Receba novas issues na sua caixa de entrada

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