vmware/pyvmomi

Make vim more explicit in the code

Open

#941 aberto em 14 de jan. de 2021

Ver no GitHub
 (0 comments) (0 reactions) (0 assignees)Python (807 forks)batch import
documentationhelp wantedquestion

Métricas do repositório

Stars
 (2.141 stars)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

If I want to view someone else's code and I see a line like:

from pyVmomi import vim

I immediately want to check out what is vim. But this in turn, takes me to the section of https://github.com/vmware/pyvmomi/blob/a2d5df0b57d7e359b220493c9c77d1635705ef12/pyVmomi/__init__.py#L219 where I read lines like "Files can just import the top level namespace and we will figure out what to load and when". That's great, but I don't have the tools to figure this out, so I need to know what this vim exactly is.

Guia do colaborador

Direção de pesquisa
Examine o mecanismo de carregamento lento na linha 219 do arquivo init .py. Proponha renomear a importação 'vim' para algo mais descritivo ou adicionar comentários inline para esclarecer que 'vim' é um namespace para as classes do VMware Infrastructure Model. Garanta a compatibilidade com versões anteriores se renomear.
Pilha de tecnologia
python
Domain
apideveloper experience
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
1
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Python
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
90