{"id":385,"date":"2024-12-05T19:30:25","date_gmt":"2024-12-05T19:30:25","guid":{"rendered":"https:\/\/equipomedios.com\/blog\/?p=385"},"modified":"2024-10-18T19:31:36","modified_gmt":"2024-10-18T19:31:36","slug":"modulos-en-python","status":"publish","type":"post","link":"https:\/\/equipomedios.com\/blog\/modulos-en-python\/","title":{"rendered":"M\u00f3dulos en Python"},"content":{"rendered":"

M\u00f3dulos Python<\/h1>\n

Un m\u00f3dulo le permite a usted organizar l\u00f3gicamente su c\u00f3digo Python. Agrupando c\u00f3digo relacionado dentro de un m\u00f3dulo hace el c\u00f3digo mas f\u00e1cil de entender y usar. Un m\u00f3dulo es un objeto de Python con atributos con nombres arbitrarios que puede enlazar y hacer referencia.<\/p>\n

Simplemente, un m\u00f3dulo es no es otra cosa sino un archivo con extensi\u00f3n\u00a0.py<\/strong>. Un m\u00f3dulo puede definir funciones, clases y variables, tambi\u00e9n puede incluir c\u00f3digo ejecutable.<\/p>\n

El c\u00f3digo Python para un m\u00f3dulo nombrado\u00a0funciones<\/span><\/code>\u00a0normalmente reside un archivo llamado\u00a0utilidades.py<\/span><\/code>. A continuaci\u00f3n un ejemplo de un simple m\u00f3dulo llamado\u00a0utilidades.py<\/span><\/code>:<\/p>\n

\n
\n
\"\"\" M\u00f3dulo para c\u00e1lculos diversos \"\"\"<\/span>\r\n\r\ndef<\/span> suma_total<\/span>(<\/span>monto<\/span>=<\/span>0<\/span>):<\/span>\r\n    \"\"\" Calcula la suma total \"\"\"<\/span>\r\n    calculo_suma<\/span> =<\/span> 20<\/span>\r\n    calculo_suma<\/span> +=<\/span> monto<\/span>\r\n    return<\/span> calculo_suma<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
<\/span><\/p>\n
Sentencia import<\/h2>\n
La sentencia\u00a0import<\/span><\/code>\u00a0se utiliza para importar un m\u00f3dulo. Usted puede usar cualquier archivo de c\u00f3digo Python como un m\u00f3dulo ejecutando esta sentencia en otro archivo de c\u00f3digo Python. La sentencia\u00a0import<\/span><\/code>\u00a0tiene la siguiente sintaxis:<\/p>\n
\n
\n
>>> <\/span>import<\/span> os<\/span>\r\n>>> <\/span>import<\/span> re<\/span>,<\/span> datetime<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
Cuando el interprete encuentra una sentencia\u00a0import<\/span><\/code>, este importa el m\u00f3dulo si el mismo esta presente en la ruta de b\u00fasqueda. Una ruta de b\u00fasqueda es una lista de directorios que el interprete busca antes de importar un m\u00f3dulo.<\/p>\n
Por ejemplo, al importar el m\u00f3dulo\u00a0utilidades.py<\/span><\/code>, usted necesita colocar la siguiente sentencia al tope del otro script Python. A continuaci\u00f3n un ejemplo de un simple m\u00f3dulo,\u00a0calculo_factura_pipo.py<\/span><\/code>.<\/p>\n
\n
\n
# Importar el modulo llamado \"utilidades\"<\/span>\r\nimport<\/span> utilidades<\/span>\r\n\r\nprint<\/span> \"Importo el modulo '<\/span>{0}<\/span>'<\/span>\\n<\/span>\"<\/span>.<\/span>format<\/span>(<\/span>\r\n    utilidades<\/span>.<\/span>__file__<\/span>.<\/span>replace<\/span>(<\/span>\r\n    \tutilidades<\/span>.<\/span>__file__<\/span>,<\/span> \"utilidades.pyc\"<\/span>))<\/span>\r\n\r\nprint<\/span> u<\/span>\"Funci\u00f3n '<\/span>{0}<\/span>' del m\u00f3dulo '<\/span>{1}<\/span>' llamado y mostr\u00f3:\"<\/span>.<\/span>format<\/span>(<\/span>\r\n    utilidades<\/span>.<\/span>suma_total<\/span>.<\/span>__name__<\/span>,<\/span>\r\n    utilidades<\/span>.<\/span>__file__<\/span>.<\/span>replace<\/span>(<\/span>\r\n    \tutilidades<\/span>.<\/span>__file__<\/span>,<\/span> \"utilidades.pyc\"<\/span>))<\/span>\r\n\r\n# Usted puede llamar una funci\u00f3n definida dentro del m\u00f3dulo<\/span>\r\nprint<\/span> \"Monto total a facturar: <\/span>{0}<\/span> BsS.\"<\/span>.<\/span>format<\/span>(<\/span>\r\n\tutilidades<\/span>.<\/span>suma_total<\/span>(<\/span>int<\/span>(<\/span>input<\/span>(<\/span>\"Ingrese un monto: \"<\/span>))))<\/span> \r\n<\/pre>\n<\/div>\n<\/div>\n
Cuando el c\u00f3digo anterior es ejecutado, ese produce el siguiente resultado:<\/p>\n
\n
\n
Importo<\/span> el<\/span> modulo<\/span> 'utilidades.pyc'<\/span>\r\n\r\nFunci\u00f3n<\/span> 'suma_total'<\/span> del<\/span> m\u00f3dulo<\/span> 'utilidades.pyc'<\/span> llamado<\/span> y<\/span> mostr\u00f3<\/span>:<\/span>\r\nIngrese<\/span> un<\/span> monto<\/span>:<\/span> 56987<\/span>\r\nMonto<\/span> total<\/span> a<\/span> facturar<\/span>:<\/span> 57007<\/span> BsS<\/span>.<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
Un m\u00f3dulo se carga solo una vez, independientemente de la cantidad de veces que se importe. Esto evita que la ejecuci\u00f3n del m\u00f3dulo ocurra una y otra vez si se producen m\u00faltiples importaciones.<\/p>\n
La primera vez que un m\u00f3dulo es importado en un script de Python, se ejecuta su c\u00f3digo una vez. Si otro m\u00f3dulo importa el mismo m\u00f3dulo este no se cargar\u00e1 nuevamente; los m\u00f3dulos son inicializados una sola vez.<\/p>\n
Esto se debe al c\u00f3digo objeto compilado que genera en el mismo directorio del m\u00f3dulo que cargo con la extensi\u00f3n de archivo\u00a0.pyc<\/strong>, ejecutando las siguientes sentencias:<\/p>\n
\n
\n
>>> <\/span>import<\/span> funciones<\/span>,<\/span> os<\/span>\r\n>>> <\/span>archivos<\/span> =<\/span> os<\/span>.<\/span>listdir<\/span>(<\/span>os<\/span>.<\/span>path<\/span>.<\/span>abspath<\/span>(<\/span>\r\n... <\/span>    funciones<\/span>.<\/span>__file__<\/span>)<\/span>.<\/span>replace<\/span>(<\/span>\"\/utilidades.pyc\"<\/span>,<\/span> \"\/\"<\/span>))<\/span>\r\n>>> <\/span>print<\/span> filter<\/span>(<\/span>lambda<\/span> x<\/span>:<\/span> x<\/span>.<\/span>startswith<\/span>(<\/span>'funciones.'<\/span>),<\/span> archivos<\/span>)<\/span>\r\n['utilidades.py', 'utilidades.pyc']<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
De esta forma se comprueba que existe el archivo compilado de Python junto con el mismo m\u00f3dulo Python.<\/p>\n<\/div>\n
<\/span><\/p>\n
Localizando m\u00f3dulos<\/h2>\n
Cuando usted importa un m\u00f3dulo, el interprete Python busca por el m\u00f3dulo en la secuencia siguiente:<\/p>\n
    \n
  1. El directorio actual.<\/li>\n
  2. Si el m\u00f3dulo no es encontrado, Python entonces busca en cada directorio en la variable de entorno\u00a0PYTHONPATH<\/span>\u00a0del sistema operativo.<\/li>\n
  3. Si todas las anteriores fallan, Python busca la ruta predeterminada. En UNIX, la ruta predeterminada normalmente esta\u00a0\/usr\/local\/lib\/python\/<\/span><\/code>.<\/li>\n<\/ol>\n
    El ruta de b\u00fasqueda de m\u00f3dulo es almacenado en el m\u00f3dulo de system\u00a0sys<\/span><\/code>\u00a0como la variable\u00a0sys.path<\/span><\/code>. La variable\u00a0sys.path<\/span><\/code>\u00a0contiene el directorio actual,\u00a0PYTHONPATH<\/span><\/code>, y las predeterminadas dependencia de instalaci\u00f3n.<\/p>\n<\/div>\n
    <\/span><\/p>\n
    PYTHONPATH<\/h2>\n
    Es una variable de entorno del sistema operativo, consistiendo de una lista de directorios. La sintaxis de\u00a0PYTHONPATH<\/span><\/code>\u00a0es la misma como la del shell de la variable\u00a0PATH<\/span><\/code>.<\/p>\n
    As\u00ed es una t\u00edpica definici\u00f3n de\u00a0PYTHONPATH<\/span><\/code>\u00a0desde un sistema Windows, ejecutando:<\/p>\n
    \n
    \n
    set<\/span> PYTHONPATH<\/span> =<\/span> C<\/span>:<\/span>\\python20<\/span>\\lib<\/span>;<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
    As\u00ed es una t\u00edpica definici\u00f3n de\u00a0PYTHONPATH<\/span><\/code>\u00a0desde un sistema UNIX, ejecutando:<\/p>\n
    \n
    \n
    set<\/span> PYTHONPATH<\/span> =<\/span> \/<\/span>usr<\/span>\/<\/span>local<\/span>\/<\/span>lib<\/span>\/<\/span>python<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
    <\/span><\/p>\n
    Espacios de nombres y alcance<\/h2>\n
    Las\u00a0variables<\/span>\u00a0son nombres (identificadores) que se asignan a objetos.<\/p>\n
    Un espacio de nombres o namespace, es un diccionario de nombres de variables (claves) y sus objetos (valores) correspondientes.<\/p>\n
    Una sentencia de Python puede acceder a las variables en un espacio de nombres local y en el espacio de nombres global. Si una\u00a0variable local<\/em>\u00a0y una\u00a0variable global<\/em>\u00a0tienen el mismo nombre, la\u00a0variable local<\/em>\u00a0sombrea la\u00a0variable global<\/em>.<\/p>\n
    Cada\u00a0funci\u00f3n<\/span>\u00a0tiene su propio espacio de nombres local. Los\u00a0m\u00e9todos<\/span>\u00a0de Clase siguen la misma regla de alcance que las funciones ordinarias.<\/p>\n
    Python hace conjeturas educadas sobre si las variables son locales o globales. Se supone que cualquier variable asignada a un valor en una funci\u00f3n es local.<\/p>\n
    Por lo tanto, para asignar un valor a una variable global dentro de una funci\u00f3n, primero debe usar la sentencia\u00a0global<\/span>.<\/p>\n
    \n
    \n
    >>> <\/span>global<\/span> nombre<\/span>\r\n>>> <\/span>nombre<\/span>\r\n'Leonardo'<\/span>\r\n<\/pre>\n<\/div>\n<\/div>\n
    La sintaxis\u00a0global<\/span>\u00a0nombre<\/span><\/code>, le dice al interprete Python que la variable\u00a0nombre<\/span><\/code>\u00a0es una\u00a0variable global<\/em>. Python deja de buscar la variable en el espacio de nombres local.<\/p>\n
    Por ejemplo, defina una variable\u00a0Money<\/span><\/code>\u00a0en el espacio de nombres global. Dentro de la funci\u00f3n\u00a0Money<\/span><\/code>, asigna un valor a\u00a0Money<\/span><\/code>, por lo tanto, Python asume que\u00a0Money<\/span><\/code>\u00a0es una variable local. Sin embargo, accede al valor de la variable local\u00a0Money<\/span><\/code>\u00a0antes de configurarlo, por lo que el resultado es una excepci\u00f3n\u00a0UnboundLocalError<\/span>. Si descomenta la sentencia\u00a0global<\/span><\/code>, se soluciona el problema.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
    M\u00f3dulos Python Un m\u00f3dulo le permite a usted organizar l\u00f3gicamente su c\u00f3digo Python. Agrupando c\u00f3digo relacionado dentro de un m\u00f3dulo hace el c\u00f3digo mas f\u00e1cil de entender y usar. Un m\u00f3dulo es un objeto de Python con atributos con nombres arbitrarios que puede enlazar y hacer referencia. Simplemente, un m\u00f3dulo es no es otra cosa […]<\/p>\n","protected":false},"author":1,"featured_media":331,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false},"version":2}},"categories":[39,40],"tags":[],"class_list":["post-385","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-programacion","category-python"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/equipomedios.com\/blog\/wp-content\/uploads\/2024\/08\/python-logo-master-v3-TM.png?fit=601%2C203&ssl=1","jetpack_sharing_enabled":true,"jetpack-related-posts":[],"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/posts\/385","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/comments?post=385"}],"version-history":[{"count":1,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/posts\/385\/revisions"}],"predecessor-version":[{"id":386,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/posts\/385\/revisions\/386"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/media\/331"}],"wp:attachment":[{"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/media?parent=385"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/categories?post=385"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/equipomedios.com\/blog\/wp-json\/wp\/v2\/tags?post=385"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}