Introducción a la Programación de Python: Creación de un Proyecto de Python de Ejemplo

2020-07-22 16:34:20 | #programming #python | Parte 1 de 7

Verificado En

  • Linux Ubuntu 20.04
  • Windows 10
  • macOS Catalina

¿Qué es Python, por qué vale la pena aprender y cómo se compara con otros lenguajes de programación?

Python es un lenguaje de programación de propósito general, lo que significa que se puede usar para codificar una variedad de aplicaciones, incluyendo backend (lado del servidor), móvil, escritorio, análisis de datos y scripts de sistema independientes. Hoy, vamos a aprender los pasos que debe realizar al comienzo de cada proyecto de Python.

Instalar Python en Windows 10

Descargue e instale el último paquete Python 3 y asegúrese de seleccionar la casilla de verificación "Add Python 3.x a PATH "durante este proceso. Usaremos Python 3.8 en este tutorial. Una vez completada la instalación, abra o vuelva a iniciar PowerShell, escriba/run python --version y asegúrese de ver Python 3.8.x.

Ahora instale VirtualEnv ejecutando pip install virtualenv

Instalar Python en Linux Ubuntu

Primero, verifique si Python 3 ya está instalado ejecutando python --version en la línea de comando. Si la versión es 3.7 o superior, puede omitir los pasos de instalación.

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.8

Asegúrese de tener python y pip para la versión 3.8+ ejecutando python --version y pip --version

Ahora instale VirtualEnv ejecutando pip install virtualenv

Instalar Python 3 en macOS

brew install pyenv
pyenv install 3.8.2
pyenv global 3.8.2
echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.bash_profile

Asegúrese de tener python y pip para la versión 3.8+ ejecutando python -V y pip -V

Ahora instale VirtualEnv ejecutando pip install virtualenv

Configurar una carpeta de proyecto de Python

Nuestro proyecto implementará estándares para facilitar la comprensión de los archivos y carpetas de nuestro proyecto cuando volvamos a ellos en el futuro. También facilitan a los miembros del equipo, que están familiarizados con el estándar, identificar dónde está todo.

Uno de los primeros pasos más cruciales es configurar un entorno virtual para nuestro proyecto. Esto nos permite mantener todas las dependencias del módulo y sus versiones aisladas dentro del proyecto, para que cada proyecto pueda tener sus propias dependencias sin causar conflictos.

Creación de archivos y carpetas con Windows 10 PowerShell 2.0+

cd ~
New-Item -ItemType "directory" -Path ".\python-boilerplate"
cd python-boilerplate
New-Item -ItemType "file" -Path . -Name "main.py"
New-Item -ItemType "file" -Path . -Name "README.md"
New-Item -ItemType "file" -Path . -Name "requirements.txt"
New-Item -ItemType "file" -Path . -Name "setup.py"
New-Item -ItemType "file" -Path . -Name ".gitignore"
virtualenv venv
.\venv\Scripts\activate

Es posible que vea el siguiente error al ejecutar el comando .\venv\Scripts\activate:

Error
.\venv\Scripts\activate : File C:\Users\username\python-boilerplate\venv\Scripts\activate.ps1
cannot be loaded because running scripts is disabled on this system. For more information,
see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\venv\Scripts\activate
+ ~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

Para resolver esto, cierre PowerShell y reinícielo con la opción "Run as Administrator" o "Ejecutar como administrador". Puede que tenga que buscar PowerShell en la barra de herramientas, haga clic en el botón > y luego haga clic en el botón "Ejecutar como administrador" de la lista.

Luego ejecute lo siguiente:

Set-ExecutionPolicy RemoteSigned
cd ~
.\venv\Scripts\activate

Para verificar que el entorno virtual esté activo, asegúrese de que (venv) esté en el símbolo del sistema de PowerShell. Por ejemplo, (venv) PS C:\Users\username\python-boilerplate>

Creación de archivos y carpetas con Linux Ubuntu 14.04+ o macOS

cd ~
mkdir python-boilerplate
cd python-boilerplate
pip install powershell
virtualenv -p python3 venv
source venv/bin/activate
touch main.py
touch README.md
touch requirements.txt
touch setup.py
touch .gitignore

Para verificar que el entorno virtual esté activo, asegúrese de que (venv) esté en el símbolo del sistema del terminal.

Después de ejecutar los comandos anteriores, asegúrese de que su esqueleto se vea como el siguiente ejemplo y que el entorno virtual esté activo.

▾ python-boilerplate/
  ▸ venv/
  main.py
  README.md
  requirements.txt
  setup.py
  .gitignore

Archivo README.md de Ejemplo

Copie lo siguiente en su archivo README.md. Use este archivo para documentar los pasos de instalación y ejecución para que no necesite recordar cómo ejecutar su programa en el futuro.

Nombre del archivo: README.md

# python-boilerplate

```
# Crear VirtualEnv
virtualenv venv

# Cómo activar VirtualEnv (Windows 10)
.\venv\Scripts\activate

# Cómo activar VirtualEnv (Linux Ubuntu / macOS
source venv/bin/activate

# Cómo instalar dependecias de Python
pip install -r requirements.txt

# Cómo ejecutar
python main.py

# Desactivar VirtualEnv
deactivate
```

El README.md debería ser simple desde el principio. Indique el nombre del proyecto, los pasos de instalación y ejecución. En nuestro ejemplo, le indicamos al desarrollador que instale todas las dependencias en el entorno virtual. Mientras el entorno virtual está activado, puede ejecutar python main.py con la frecuencia que desee.

Si olvida activar el entorno virtual, a menudo recibirá un ModuleNotFoundError similar al siguiente. Esto solo significa que necesita ejecutar source venv/bin/activate o .\venv\Scripts\activate desde la carpeta raíz, luego pip install MODULENAME para cada dependencia pidiéndole que importe, y luego python main.py para ejecutar el programa.

Traceback (most recent call last):
    File "test_project.py", line 2, in 
      import pytest
  ModuleNotFoundError: No module named 'pytest'

Ejemplo de Archivo .gitignore

Add the following to your .gitignore file.

venv

Esta línea simplemente le dice a git que no confirme la carpeta venv en el repositorio. No necesitaremos confirmar venv porque la lista de dependencias se indica en el archivo requirements.txt.

Generando el Archivo requirements.txt

Después de ejecutar source venv/bin/activate o .\venv\Scripts\activate, notará que la carpeta venv contiene varios módulos. Vamos a crear una lista de todos esos módulos/dependencias con el siguiente comando:

pip freeze > requirements.txt

Ahora debería tener una lista de esos módulos y sus versiones. Esto hace un seguimiento de las dependencias y nos permite instalarlas fácilmente nuevamente en el futuro.

Ejemplo de Archivo Python setup.py

Copie lo siguiente en su archivo setup.py y actualícelo con sus propios detalles.

Nombre del archivo: setup.py

try:
    from setuptools import setup
except ImportError:
    from distutils.core import setup

config = {
    'description': 'Project description',
    'author': 'Name',
    'url': 'Home page of the application',
    'download_url': 'Download link',
    'author_email': 'user@email.com',
    'version': '0.1.0',
    'install_requires': ['pytest'],  # dependencies
    'packages': ['NAME'],
    'scripts': [],
    'name': 'projectname'
}

setup(**config)

El archivo setup.py contiene metadatos para nuestro proyecto. Esto es necesario si va a hacer que su proyecto se pueda instalar. Si no sabe lo que eso significa o simplemente quiere que este proyecto sea privado, puede omitir este archivo.

Ejemplo de código main.py

Copie lo siguiente en su archivo main.py.

Nombre del archivo: main.py

if __name__ == '__main__':
    print('¡Hola, mundo!')

Por el momento, solo imprimiremos "¡Hola, mundo!" a la terminal La línea 1 le dice al programa qué ejecutar cuando se invoca directamente, y no se importa, verificando si "nombre" está configurado para el script/módulo.

Ejecutando Nuestro Programa Python

Ejecute el siguiente comando:

python main.py

Si todo se configuró correctamente, debería ver ¡Hola mundo! impreso en la consola. Siéntase libre de experimentar con este archivo imprimiendo varias cosas en la consola.

Codificación de nuestra primera función de Python

Las funciones (o métodos) nos permiten definir la lógica reutilizable que podemos invocar con diferentes parámetros. Definimos funciones con la palabra clave def. El formato es:

def nombre_de_la_función(parámetro1, parámetro2...):
    # hacer algo

Usemos este ejemplo para actualizar su archivo main.py con el siguiente código:

def añadir(a, b):
    return a + b

if __name__ == '__main__':
    suma = añadir(1, 2)
    print(suma)
    print(añadir(2,2))

Aquí, definimos una función añadir que acepta las variables a y b, los agrega y devuelve la suma. En la línea 5, llamamos añadir, pasamos 1 y 2, y devolver 3, que podemos almacenar en la variable sum e imprimir en la consola.

Línea 7: nos muestra que no necesitamos almacenar el valor devuelto de añadir en la variable suma. Podemos pasar inmediatamente el valor devuelto a print directamente.

Ejecute python main.py nuevamente para ver los cálculos impresos en la consola. Con esto concluye nuestro tutorial sobre cómo configurar un proyecto básico de Python 3. Desactive su entorno virtual ejecutando desactivar desde el directorio raíz y confirme que (venv) ya no está en el símbolo del sistema.

¿Quieres ver más ejercicios?

Ver Ejercicios

Commentarios

Debes iniciar sesión para comentar. ¿No tienes una cuenta? Registrate gratis.

Subscribe to comments for this post

Regístrese para recibir más contenido gratuito

¿Le gustaría recibir recursos gratuitos, diseñados para ayudarlo a alcanzar sus objetivos de TI? Empiece ahora y deje su dirección de correo electrónico a continuación. Prometemos no hacer spam. También puede registrarse para obtener una cuenta gratuita o seguirnos en e interactuar con la comunidad. Puede optar por no participar en cualquier momento.



Háblanos de tu Proyecto









Contacta Con Nosotras

¿Tiene un problema de TI específico que necesita solución o simplemente tiene una pregunta general de TI? Utilice el formulario de contacto para ponerse en contacto con nosotros y un profesional de TI estará con usted en un momento.

Contratanos

Ofrecemos desarrollo web, desarrollo de software empresarial, control de calidad y pruebas, google analytics, dominios y hosting, bases de datos, seguridad, consultoría de TI y otros servicios relacionados con TI.

Tutoriales de TI gratuitos

Dirígete a nuestra sección tutoriales para aprender todo sobre cómo trabajar con soluciones de TI.

Contacto