Prioridad de importación Python: ¿paquetes o módulos?

Question

No estaba claro cómo nombrar correctamente esta pregunta.

Caso 1

Supongamos que tengo la siguiente estructura de directorios.

foo 
| 
+- bar/__init__.py 
| 
+- bar.py 

Si tengo

from foo import bar 

¿Cómo sé qué barra (bar.py o bar/__init__.py) se importa? ¿Hay alguna manera fácil de detectar esto automáticamente?

Caso 2

foo 
| 
+- foo.py 
| 
+- other.py 

Si other.py tiene la línea

import foo 

¿Cómo sé cual foo (foo o foo.foo) se importa? De nuevo, ¿hay alguna forma fácil de detectar automáticamente que esto ocurra?

Answer 1

TLDR; un paquete tiene prioridad sobre un módulo del mismo nombre si están en el mismo directorio.

A partir de los documentos:

"Cuando un módulo denominado spam es importado, las búsquedas de intérprete para un archivo llamado spam.py en el directorio actual, y luego en el listado de directorios especificados por la variable de entorno PYTHONPATH. Tiene la misma sintaxis que la variable de shell PATH, es decir, una lista de nombres de directorio ".

Esto es un poco engañoso porque el intérprete también buscará un paquete llamado spam (un directorio llamado spam que contiene un archivo __init__.py). Dado que las entradas del directorio se ordenan antes de la búsqueda, los paquetes tienen prioridad sobre los módulos con el mismo nombre si están en el mismo directorio porque spam viene antes de spam.py.

Tenga en cuenta que el "directorio actual" es relativo a la ruta del script principal (aquel en el que __name__ == '__main__' is True). Por lo tanto, si se encuentra en /home/billg llamando al /foo/bar.py, "directorio actual" se refiere a /foo.

Answer 2

en el primer caso que estamos tratando de importar la barra de funciones de archivo 'foo.py'

En el segundo que está tratando de importar el archivo 'foo.py'

Answer 3

Paquetes (directorios con __init__.py) tienen prioridad sobre los módulos. La documentación de este hecho es difícil de encontrar, pero puede ver esto en la fuente: python 2.7, python 3.6 (gracias @qff por el hallazgo).

También necesitará un __init__.py dentro del directorio foo para que su ejemplo funcione.

Si other.py está dentro de foo/ entonces se cargue foo.py (no el directorio foo/), ya que se verá en el directorio actual en primer lugar (a menos que hayas jugado con PYTHONPATH o sys.path).

Answer 4

de una concha de pitón:

from foo import bar 

print bar.__file__ 

debería decirle qué archivo se ha importado

Rob