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 (stdlib).
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í?. EnPues que random
no ésta entre los módulos buit-in aunque sea de la stdlib y como aclara la documentación nos dan la respuesta:
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 pythonPython 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.