Devo usar `import os.path` ou` import os`?

De acordo com a documentação oficial , os.pathé um módulo. Assim, qual é a maneira preferida de importá-lo?

# Should I always import it explicitly?
import os.path

Ou...

# Is importing os enough?
import os

Por favor, NÃO responda "importar osobras para mim". Eu sei, ele funciona para mim também agora (a partir do Python 2.6). O que eu quero saber é alguma recomendação oficial sobre esse problema. Portanto, se você responder a essa pergunta, poste suas referências .

os.pathfunciona de uma maneira engraçada. Parece que osdeveria ser um pacote com um submódulo path, mas, na realidade, osé um módulo normal que faz mágica com sys.modulesa injeção os.path. Aqui está o que acontece:

• Quando o Python é iniciado, ele carrega vários módulos sys.modules. Eles não estão vinculados a nenhum nome no seu script, mas você pode acessar os módulos já criados quando importá-los de alguma forma.

  • sys.modulesé um ditado no qual os módulos são armazenados em cache. Quando você importa um módulo, se ele já foi importado em algum lugar, ele obtém a instância armazenada sys.modules.

• osestá entre os módulos carregados quando o Python é iniciado. Ele atribui seu pathatributo a um módulo de caminho específico do sistema operacional.

• Ele injeta sys.modules['os.path'] = pathpara que você possa fazer " import os.path" como se fosse um submódulo.

Eu costumo pensar os.pathcomo um módulo que eu quero usar, e não como algo no osmódulo , portanto, mesmo que não seja realmente um submódulo de um pacote chamado os, importo-o como se fosse um e sempre façoimport os.path . Isso é consistente com a os.pathdocumentação.

Aliás, esse tipo de estrutura leva a muitas confusões iniciais dos programadores de Python sobre módulos e pacotes e organização de códigos, eu acho. Isso é realmente por duas razões

1. Se você pensa osem um pacote e sabe que pode fazer import ose ter acesso ao submódulo os.path, poderá se surpreender mais tarde quando não puder fazer import twistede acessar automaticamente twisted.spreadsem importá-lo.

2. É confuso que os.nameé uma coisa normal, uma string e os.pathé um módulo. Eu sempre estruturo meus pacotes com __init__.pyarquivos vazios para que, no mesmo nível, eu sempre tenha um tipo de coisa: um módulo / pacote ou outra coisa. Vários grandes projetos Python adotam essa abordagem, que tende a criar código mais estruturado.

Conforme PEP-20 de Tim Peters, "Explícito é melhor que implícito" e "Legibilidade conta". Se tudo que você precisa do osmódulo estiver abaixo os.path, import os.pathseria mais explícito e deixaria outras pessoas saberem com o que você realmente se importa.

Da mesma forma, o PEP-20 também diz "Simples é melhor que complexo"; portanto, se você também precisar de coisas que residam sob o osguarda - chuva mais geral , import osseria preferido.

Resposta definitiva: import ose use os.path. não import os.pathdiretamente.

A partir da documentação do próprio módulo:

>>> import os
>>> help(os.path)
...
Instead of importing this module directly, import os and refer to
this module as os.path.  The "os.path" name is an alias for this
module on Posix systems; on other systems (e.g. Mac, Windows),
os.path provides the same operations in a manner specific to that
platform, and is an alias to another module (e.g. macpath, ntpath).
...

Curiosamente, a importação do os.path importará todo o os. tente o seguinte no prompt interativo:

import os.path
dir(os)

O resultado será o mesmo que se você tivesse importado os. Isso ocorre porque o os.path se refere a um módulo diferente com base em qual sistema operacional você possui, portanto, o python importará o os para determinar qual módulo carregar para o caminho.

referência

Em alguns módulos, o ditado import foonão será exposto foo.bar, então acho que depende realmente do design do módulo específico.

Em geral, apenas importar os módulos explícitos necessários deve ser um pouco mais rápido. Na minha máquina:

import os.path: 7.54285810068e-06 segundos

import os: 9.21904878972e-06 segundos

Estes tempos estão próximos o suficiente para serem razoavelmente insignificantes. Seu programa pode precisar usar outros módulos osagora ou mais tarde; portanto, geralmente faz sentido sacrificar os dois microssegundos e usá-lo import ospara evitar esse erro posteriormente. Eu costumo lado apenas importando os como um todo, mas posso ver por que alguns preferem import os.pathser tecnicamente mais eficientes e transmitir aos leitores do código que essa é a única parte do osmódulo que precisará ser usada. Essencialmente, tudo se resume a uma questão de estilo em minha mente.

O senso comum funciona aqui: osé um módulo e também os.pathé um módulo. Portanto, basta importar o módulo que você deseja usar:

• Se você deseja usar funcionalidades no osmódulo, importe os.

• Se você deseja usar funcionalidades no os.pathmódulo, importe os.path.

• Se você deseja usar funcionalidades nos dois módulos, importe os dois módulos:

  import os
  import os.path

Para referência:

• Lib / idlelib / rpc.py usa ose importa os.

• Lib / idlelib / idle.py usa os.pathe importa os.path.

• Lib / assegurarpip / init .py usa os dois e importa os dois.

Não foi possível encontrar nenhuma referência definitiva, mas vejo que o código de exemplo para os.walk usa os.path, mas importa apenas os