Dovrei usare `import os.path` o` import os`?

Secondo la documentazione ufficiale , os.pathè un modulo. Quindi, qual è il modo preferito di importarlo?

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

O...

# Is importing os enough?
import os

Per favore NON rispondere "importare osopere per me". Lo so, funziona anche per me adesso (a partire da Python 2.6). Quello che voglio sapere è qualsiasi raccomandazione ufficiale su questo problema. Quindi, se rispondi a questa domanda, pubblica i tuoi riferimenti .

os.pathfunziona in modo divertente. Sembra che osdovrebbe essere un pacchetto con un sottomodulo path, ma in realtà osè un modulo normale che fa magie sys.modulesper iniettare os.path. Ecco cosa succede:

• Quando Python si avvia, carica un mucchio di moduli in sys.modules. Non sono associati a nessun nome nel tuo script, ma puoi accedere ai moduli già creati quando li importi in qualche modo.

  • sys.modulesè un dict in cui i moduli sono memorizzati nella cache. Quando si importa un modulo, se è già stato importato da qualche parte, viene archiviata l'istanza sys.modules.

• osè tra i moduli che vengono caricati all'avvio di Python. Assegna il suo pathattributo a un modulo percorso specifico del sistema operativo.

• Inietta in sys.modules['os.path'] = pathmodo che tu possa fare " import os.path" come se fosse un sottomodulo.

Tendo a pensare os.pathcome un modulo che voglio usare piuttosto che una cosa nel osmodulo , quindi anche se non è in realtà un sottomodulo di un pacchetto chiamato os, lo importa in un certo senso come è uno e lo faccio sempreimport os.path . Ciò è coerente con come os.pathè documentato.

Per inciso, questo tipo di struttura porta a molta confusione iniziale dei programmatori Python su moduli, pacchetti e organizzazione del codice, credo. Questo è davvero per due motivi

1. Se pensi osa un pacchetto e sai che puoi fare import ose avere accesso al sottomodulo os.path, potresti essere sorpreso in seguito quando non puoi farlo import twistede accedervi automaticamente twisted.spreadsenza importarlo.

2. È confuso che os.nameè una cosa normale, una stringa ed os.pathè un modulo. Strutturo sempre i miei pacchetti con __init__.pyfile vuoti in modo che allo stesso livello abbia sempre un tipo di cose: un modulo / pacchetto o altro. Diversi grandi progetti Python adottano questo approccio, che tende a rendere il codice più strutturato.

Secondo PEP-20 di Tim Peters, "Esplicito è meglio di implicito" e "Contabilità della lettura". Se tutto ciò di cui hai bisogno dal osmodulo è sotto os.path, import os.pathsarebbe più esplicito e far sapere agli altri cosa ti interessa davvero.

Allo stesso modo, PEP-20 dice anche "Semplice è meglio che complesso", quindi se hai bisogno anche di cose che risiedono sotto l' osombrello più generale , import ossarebbe preferibile.

Risposta definitiva: import ose uso os.path. non import os.pathdirettamente.

Dalla documentazione del modulo stesso:

>>> 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).
...

È interessante notare che l'importazione di os.path importerà tutto il sistema operativo. prova quanto segue nel prompt interattivo:

import os.path
dir(os)

Il risultato sarà lo stesso di se hai appena importato os. Questo perché os.path farà riferimento a un modulo diverso in base al sistema operativo in uso, quindi python importerà os per determinare quale modulo caricare per il percorso.

riferimento

Con alcuni moduli, dire import foonon esporrà foo.bar, quindi immagino che dipenda davvero dal design del modulo specifico.

In generale, l'importazione dei moduli espliciti necessari dovrebbe essere leggermente più veloce. Sulla mia macchina:

import os.path: 7.54285810068e-06 secondi

import os: 9.21904878972e-06 secondi

Questi tempi sono abbastanza vicini da essere abbastanza trascurabili. Il tuo programma potrebbe dover utilizzare altri moduli da osora o in un momento successivo, quindi di solito ha senso sacrificare i due microsecondi e utilizzarlo import osper evitare questo errore in un secondo momento. Di solito mi schierò con l'importazione del sistema operativo nel suo insieme, ma posso capire perché alcuni preferirebbero import os.pathessere tecnicamente più efficienti e trasmettere ai lettori del codice che questa è l'unica parte del osmodulo che dovrà essere utilizzata. In sostanza si riduce a una domanda di stile nella mia mente.

Il buon senso funziona qui: osè un modulo ed os.pathè anche un modulo. Quindi basta importare il modulo che si desidera utilizzare:

• Se si desidera utilizzare funzionalità nel osmodulo, quindi importare os.

• Se si desidera utilizzare funzionalità nel os.pathmodulo, quindi importare os.path.

• Se si desidera utilizzare le funzionalità in entrambi i moduli, importare entrambi i moduli:

  import os
  import os.path

Per riferimento:

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

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

• Lib / surepip / init .py usa entrambi e importa entrambi.

Impossibile trovare alcun riferimento definitivo, ma vedo che il codice di esempio per os.walk utilizza os.path ma importa solo os