xml.dom.minidom uses names from superseded drafts of DOM Level 3
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- Python
- Estrelas
- 77.2k
- Forks
- 36k
- Métricas de merge de PRs
- Métricas de PR pendentes
Descrição
Several public attributes and methods of xml.dom.minidom come from working drafts of DOM Level 3, and were renamed before the Recommendation was published in 2004. The code says so itself:
# DOM Level 3 attributes, based on the 22 Oct 2002 draft
# DOM Level 3 (WD 9 April 2002)
| minidom | DOM Level 3 Core |
|---|---|
Node.getInterface(), DOMImplementation.getInterface() |
getFeature() |
Attr.schemaType, Element.schemaType |
schemaTypeInfo |
Text.isWhitespaceInElementContent |
isElementContentWhitespace |
Document.actualEncoding |
inputEncoding |
Document.encoding |
xmlEncoding |
Document.version |
xmlVersion |
Document.standalone |
xmlStandalone |
Entity.actualEncoding, Entity.encoding, Entity.version |
the same three renames |
Document.errorHandler is from the same drafts; in the Recommendation it became a parameter of domConfig.
None of these names are documented, so nothing tells a user that they are neither DOM Level 1/2 (which xml.dom documents) nor DOM Level 3 (which minidom does not claim, see gh-50348).
Adding the specified names and keeping the old ones as aliases breaks nothing, and lets the documented API match the specification.
Linked PRs
- gh-156696
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Direção de pesquisa
Comece pelo ponto de entrada xml.dom.minidom e inspecione os atributos e métodos públicos listados na issue, juntamente com seus comentários do DOM Level 3. Compare cada nome atual com o nome especificado na Recommendation; o trabalho estará concluído quando os nomes especificados estiverem disponíveis como aliases sem quebrar os nomes antigos, com cobertura adequada nos testes existentes.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- python
- Domínio
- backend
- Tipo de issue
- Funcionalidade
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Status de atividade
- Estagnada
- Clareza
- Claramente especificada
- Facilidade para iniciantes
- 35/100