Los imports relativos son unos "animales" curiosos en Python, voy a ver si puedo explicar su funcionamiento de forma más o menos resumida.
Empecemos por el principio, en Python hay dos formas diferentes de ejecutar un archivo:
Como script principal
En este caso el archivo es ejecutado directamente, es el primer archivo que el intérprete ejecuta, sirviendo de punto de entrada de nuestra aplicación. Solo puede haber uno por tanto. Ejecutamos un script como principal cuando en la terminal hacemos:
$ python miscript.py
Siempre que el intérprete ejecuta un archivo, le asigna un nombre. Dicho nombre se asocia al atributo especial __name__
del objeto que representa el módulo. En el caso de que se ejecute como principal, [su nombre es siempre "__main__"]
1.
Cuando un módulo se ejecuta como principal es imposible importar nada que esté por encima de su directorio padre sin recurrir a modificar PYTHONPATH o sys.path
, lo cual no suele ser tampoco buena idea en la mayoría de los casos, dado que se puede evitar esta situación generalmente reestructurando correctamente el proyecto.
Como módulo / importado
Otra forma de ejecutar un archivo es de forma indirecta importándolo desde otro archivo ejecutado o también desde la terminal con:
$ python -m miscript
En este caso, el nombre del módulo se compone del nombre del archivo precedido del nombre de todos los paquetes y subpaquetes de los que forma parte, usando un punto (.
) para separarlos.
Todo parece más o menos simple, pero hay un punto importante a tener en cuenta. En el caso de que un modulo contenido en un paquete sea importado, su nombre depende también de la ruta del archivo principal ejecutado, mejor un ejemplo:
foo.py
paquete
subpaquete1
subpaquete2
modulo1.py
modulo2.py
bar.py
si en foo.py (ejecutado como script principal) importamos modulo1.py el nombre de modulo1
queda como:
paquete.subpaquete1.subpaquete2.modulo1
si importamos desde bar.py (dentro del paquete) su nombre queda como:
subpaquete1.subpaquete2.modulo1
Esto se debe a que cuando Python busca el módulo importado coloca el directorio actual al inicio de sus directorios de búsqueda, si encuentra el módulo en ese directorio o en un subdirectorio no sabe ni tiene en cuenta si forma parte de un paquete o no. En nuestro ejemplo, al importar desde bar.py se pierde la información de que subpaquete1
, modulo2.py
y bar.py
forman parte de un paquete superior (paquete
). Como veremos, esto hay que tenerlo muy en cuenta.
Bien, como comentaba al inicio los imports relativos son algo especiales, esto se debe a que no se resuelven en base a la estructura del árbol de archivos en el disco, sino en base al nombre del módulo. Por eso entender todo lo anterior es crucial.
Cuando hacemos from .. import algo
cada .
indica subir un nivel en la estructura de paquetes. En el momento en el que intentemos subir más niveles de los que existen en el nombre del archivo tendremos el error que mencionas:
ValueError: attempted relative import beyond top-level package
Esto puede pasar por dos razones:
Hemos ejecutado el módulo como script principal, en cuyo caso su nombre es "__main__"
.
Hemos importado el módulo desde un script situado en el mismo directorio o en un nivel inferior al que el import relativo del módulo importado trata de acceder. En el caso que mencionamos antes:
Para que modulo1.py pueda importar modulo2.py debemos hacer:
from ... import modulo2
Si luego importamos modulo1
desde desde foo.py a través de su paquete:
import paquete.subpaquete1.subpaquete2.modulo1
no tenemos ningún problema. Pero si intentamos hacer los mismo desde bar.py:
Traceback (most recent call last):
File "bar.py", line 1, in <module>
import subpaquete1.subpaquete2.modulo1
File "/test/package/paquete/subpaquete1/subpaquete2/modulo1.py", line 1, in <module>
from ... import modulo2
ValueError: attempted relative import beyond top-level package
Esto se debe a lo explicado antes, al importar modulo1.py desde bar.py el nombre de este queda como:
subpaquete1.subpaquete2.modulo1
como intenta hacer un import con tres "puntos" y tiene dos en su nombre por lo que interpreta que pretendemos hacer lo que el error dice:
Intento de importación relativa más allá del paquete de nivel superior
el paquete de nivel superior en este caso es subpaquete1
no paquete
como ocurría al importar modulo1
desde foo.py
.
Resumiendo, los imports relativos solo deben usarse y solo funcionarán normalmente dentro de paquetes.
En tu caso, los imports relativos correctos en Fisrtinstall.py serían:
from ....image import imageClass
from ...message.ErrorMessage import Errorclass
pero ten en cuenta todo lo comentado antes, en especial si intentas ejecutar como script principal un módulo del paquete.