contacto@openit.ar | +54 9 3446434264

Convenciones de nomenclatura (naming conventions)

Convenciones de nomenclatura (naming conventions)

 En programación, existen varias convenciones de nomenclatura (naming conventions) que ayudan a mantener el código limpio, legible y consistente. Las más comunes son camel case, pascal case, snake case y kebab case. A continuación te explico cada una:



camelCase (camel case o low camel case)

  • Se escribe la primera palabra en minúscula y cada palabra siguiente inicia con mayúscula, sin espacios ni separadores.

  • Ejemplo: miVariableEjemplo, contarPalabras, edadDelUsuario.

  • Uso típico: nombres de variables, funciones y métodos en lenguajes como JavaScript, Java y C#.

PascalCase (pascal case o high camel case)

  • Todas las palabras, incluida la primera, empiezan con mayúscula, sin espacios ni separadores.

  • Ejemplo: MiVariableEjemplo, ContarPalabras, EdadDelUsuario.

  • Uso típico: nombres de clases, interfaces y, en algunos lenguajes, métodos. Muy común en C#, Java y .NET.

snake_case (snake case)

  • Todas las letras en minúscula y las palabras se separan por guiones bajos (_).

  • Ejemplo: mi_variable_ejemplo, contar_palabras, edad_del_usuario.

  • Uso típico: variables y funciones en Python, Ruby y C. También se utiliza en archivos de configuración.

kebab-case (kebab case)

  • Todas las letras en minúscula y las palabras se separan por guiones medios (-).

  • Ejemplo: mi-variable-ejemplo, contar-palabras, edad-del-usuario.

  • Uso típico: nombres de archivos, rutas de URL y algunos frameworks web. No se usa en nombres de variables en la mayoría de lenguajes porque el guion medio no es válido en identificadores.

SCREAMING_SNAKE_CASE

  • Variante de snake_case, pero todas las letras en mayúscula. Se usa principalmente para constantes.

  • Ejemplo: MI_VARIABLE_EJEMPLO.

  • Uso típico: constantes en C, C++, Python y otros lenguajes.


Recomendaciones de nomenclatura en Python

Python tiene convenciones de nomenclatura muy claras y ampliamente aceptadas, recogidas en la guía de estilo oficial conocida como PEP8. Las recomendaciones principales son:

  • Variables, funciones y métodos:
    Se recomienda usar el formato snake_case, es decir, todas las letras en minúscula y las palabras separadas por guiones bajos. Ejemplo:
    mi_variablecalcular_totalobtener_datos.

  • Clases:
    Se utiliza PascalCase (también llamado CapWords o CamelCase con inicial mayúscula), donde cada palabra comienza con mayúscula y no se usan guiones bajos. Ejemplo:
    MiClaseUsuarioRegistrado.

  • Constantes:
    Se usan todas las letras en mayúscula y las palabras se separan por guiones bajos, conocido como SCREAMING_SNAKE_CASE. Ejemplo:
    VALOR_MAXIMOCONFIG_PATH.

  • Módulos y archivos:
    Se recomienda el uso de snake_case en minúsculas, por ejemplo:
    mi_modulo.pyutilidades.py.

  • Paquetes:
    En minúsculas y, preferiblemente, sin guiones bajos:
    mipaquete.

Resumen de la convención

ElementoConvenciónEjemplo
Variablesnake_casemi_variable
Funciónsnake_casecalcular_total
ClasePascalCaseMiClase
ConstanteSCREAMING_SNAKE_CASEVALOR_MAXIMO
Módulo/Archivosnake_caseutilidades.py
Paqueteminúsculasmipaquete

Estas convenciones ayudan a que el código Python sea más legible, mantenible y coherente entre proyectos y equipos.

Compartir:

Post más reciente
Post anterior