6

El dia de hoy trabajando en un proyecto tuve que recurrir a tratar de importar paquetes a la inversa es decir archivos en un directorio superior,para ubicarlos un poco esta seria mi jerarquia

  • proyecto
  • image.py
  • AllSource

    • source
    • installerfiles

      • installclient
        • Firstinstall.py
    • message
      • ErrorMessage.py

Lo que necesito es hacer 2 importaciones

La primera es desde Fisrtinstall.py importar el archivo image.py

y la segunda es que de Firstinstall.py importar ErrorMessage.py

para lo cual trate de hacer lo siguiente

Esto desde Firstinstall.py

from ..image.py import imageClass from ..message.ErrorMessage import Errorclass

pero me sale el siguiente error:

ValueError: attempted relative import beyond top-level package

Actualizacion

Despues de seguir la explicacion dada en la respuesta, trate de hacer un ejemplo mas simple con la siguiente estructura:

foo.py 
paquete
    subpaquete1
        subpaquete2
            modulo1.py
    bar.py  
    modulo2.py  

cada archivo.py contienen una funcion simple como esta:

def saludarNOMBRE():
    print("hola")

para importar el modulo2 desde el modulo1

escribí lo siguiente:

from ...modulo2 import modulo2hola

el error aparece de nuevo

nota: Para ejecutar estos archivos utilizo atom y la extension que permite ejecutar el archivo al instante presionando F5 no se si eso tiene algo que ver, con esto quiere decir que si tengo abierto el archivo modulo1.py presiono f5 y se ejecuta al instante.

Esta es la ruta completa en el sistema de donde se ubica mi proyecto:

C:\Users\Angel\Desktop\TES\paquete\subpaquete1\subpaquete2
2
  • @FJSevilla importado y usado por otro Commented el 13 ago. 2019 a las 5:20
  • @FJSevilla. soy nuevo en este temas podrias si fueras tan amable de explicarme un poco mejor lo de los impprts relativos Commented el 13 ago. 2019 a las 5:40

1 respuesta 1

10

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.

10
  • agradezco mucho tu explicacion y trate de entender y aplicar todo lo que me has dicho pero aun que trate de aplicarlo a un ejemplo mas simple me sale el mismo error de top-level Commented el 13 ago. 2019 a las 16:50
  • Angel la clave está como trato de explicar dónde se localiza el módulo que ejecutas como principal y que importa tu paquete o uno de sus módulos. Para que lo anterior funcione ese modulo debe estar fuera del paquete (proyecto en tu caso). Ten cuidado con los IDEs, pueden modificar la ruta de trabajo del script ejecutado. Si no te aclaras, comenta explicando como usas el paquete y desde dónde a ver si podemos aclarar lo que te está pasando.
    – FJSevilla
    Commented el 13 ago. 2019 a las 16:55
  • 1
    FJSevilla: abrí en Meta este debate: ¿Deberían las etiquetas [import] e [importación] ser sinónimas?. El consenso parece ir en el sentido de empezar a usar importación para la importación de datos y etiquetas específicas tipo python-import o javascript-import para casos particulares de lenguaje. Iba a empezar a hacerlo y vi muchas muy parecidas. ¿Crees que esta podría servir como canónica para intentar cerrar parte de las otras como duplicadas?
    – fedorqui
    Commented el 12 may. 2020 a las 11:18
  • 1
    @fedorqui'SOdejadedañar' , primero estoy de acuerdo con el consenso :) En cuanto a las duplicadas, pues es muy posible que pueda servir ésta si no hay alguna con mejores respuestas. Ahora mismo no tengo tiempo de explorar, dentro de un rato miro a ver. Si hay muchas candidatas y son claras podemos coordinarnos por chat por ejemplo y uso a Mjölnir XD y así no saturamos [más] la cola de cierre, a ver si de paso te echo una mano en el reetiquetado.
    – FJSevilla
    Commented el 12 may. 2020 a las 12:41
  • 1
    Fantástico, muchas gracias. Y muy contento de que te parezca bien, pues al fin y al cabo eres el que más conoce esta sección de SOes. Cuando puedas, no hay prisa, me dices lo de si te parece bien que esta sea canónica y procedemos con el martillo divino :D
    – fedorqui
    Commented el 12 may. 2020 a las 12:52

Tu Respuesta

By clicking “Publica tu respuesta”, you agree to our terms of service and acknowledge you have read our privacy policy.

¿No es la respuesta que buscas? Examina otras preguntas con la etiqueta o formula tu propia pregunta.