Es importante no crear un modulo llamado random.py
en el mismo directorio donde esta el script (o en el directorio de trabajo actual en el caso del interprete interactivo) que intenta importar random.randint
de la stdlib. En general hay que intentar evitar nombrar nuestros script con nombres que puedan entrar en conflictos con la biblioteca estándar o con otras bibliotecas externas instaladas (como nombrar módulos con la palabra "django" cuando se trabaja con este framework).
Esto tiene que ver en que directorios y en qué orden se resuelven los imports. Cuando se importa un módulo (importe absoluto), por ejemplo usando:
>>> import random
El intérprete busca ese módulo en las siguientes localizaciones y por este orden:
Módulos built-in.
El directorio que contiene el script o el directorio actual si no se especifica ningún script (por ejemplo al ejecutar el interprete interactivo en la terminal).
Búsqueda en el PYTHONPATH
Ruta predeterminada dependiente de la instalación, por ejemplo
/usr/local/lib/python
.
No todos los módulos de la biblioteca estándar son módulos built-in (preconstruidos). Los módulos built-in están escritos en C y son compilados como parte del propio intérprete Python, por lo tanto no tienen un archivo .py ni los vamos a encontrar por ningún lado. Estos módulos se pueden listar mediante:
>>> import sys >>> sys.builtin_module_names ('_abc', '_ast', '_codecs', '_collections', '_functools', '_imp', '_io', '_locale', '_operator', '_signal', '_sre', '_stat', '_string', '_symtable', '_thread', '_tracemalloc', '_warnings', '_weakref', 'atexit', 'builtins', 'errno', 'faulthandler', 'gc', 'itertools', 'marshal', 'posix', 'pwd', 'sys', 'time', 'xxsubtype')
¿Entonces que ocurre aquí?. Pues que random
no ésta entre los módulos buit-in aunque sea de la stdlib y como aclara la documentación:
Después de la inicialización, los programas de Python pueden modificar
sys.path
. El directorio que contiene el script que se está ejecutando se coloca al principio de la ruta de búsqueda, por delante de la ruta de biblioteca estándar. Esto significa que los scripts de ese directorio se cargarán en lugar de los módulos del mismo nombre de la stdlib. Esto es un error, a menos que el reemplazo esté pensado.
Esto también ocurre cuando se ejecuta un script que está dentro de un paquete, ya que Python no interpretará ese directorio como un paquete, agregando así el directorio de trabajo al PYTHONPATH
igual que lo comentado antes.
Por lo tanto cualquier directorio o módulo que llamemos igual que a un módulo de la stdlib no built-in o de terceros instalado solapará a éstos. Solo los módulos builtin como sys están a salvo de ésto.
Nota: los módulos buit-in dependen de la instalación, no en todos los casos van a ser los mismos.
Observase que tendremos un error muy similar si nuestro script se llama igual que un paquete de terceros instalado que tratamos de importar.
Si por ejemplo tratamos de importar pandas
con el típico import pandas as pd
y nuestro script se llama pandas.py
, el script se importará a si mismo y no al paquete pandas dado que está antes en el orden como mencionamos arriba.
Si tratamos de usar from
para importar una clase, función, paquete, etc en específico nos encontramos directamente con un error del tipo:
pandas.py
from pandas import DataFrame
ImportError: cannot import name 'DataFrame' from partially initialized module 'pandas' (most likely due to a circular import)
debido al intento de importarse a si mismo del módulo.