Tutorial10 min de lectura

Publicar tu Primer Paquete

Guía paso a paso para publicar un paquete en LatinoPM

1. Estructura del Proyecto

Un paquete Latino típico tiene esta estructura:

mi-paquete/
├── latino.pkg.json    # Manifiesto del paquete
├── src/
│   └── principal.lat  # Código fuente
├── README.md          # Documentación
└── .gitignore         # Archivos a ignorar

2. Crear el Manifiesto

El archivo latino.pkg.json contiene la metadata de tu paquete:

{
  "name": "mi-paquete",
  "version": "1.0.0",
  "description": "Descripción de tu paquete",
  "keywords": ["util", "helper"],
  "license": "MIT",
  "author": "Tu Nombre <tu@email.com>",
  "repository": "https://github.com/tu-usuario/mi-paquete",
  "main": "src/principal.lat"
}

⚠️ Reglas para el nombre:

  • • Solo letras minúsculas, números y guiones
  • • Debe ser único en el registry
  • • No puede empezar con número
  • • Longitud máxima: 214 caracteres

3. Inicializar el Proyecto

Ejecuta el comando de inicialización:

lpm init mi-paquete 1.0.0

Esto creará el archivo latino.pkg.jsony el directorio latino_modules/.

4. Autenticarse

Necesitas una cuenta para publicar paquetes:

lpm login tu@email.com tu-password

¿No tienes cuenta? Regístrate aquí

5. Publicar el Paquete

Navega al directorio de tu proyecto y publica:

lpm publish

El CLI empaquetará tu código y lo subirá al registry.

✓ Consejo:

Asegúrate de tener un .gitignore para excluir archivos innecesarios como latino_modules/,.latipm-cache/, etc.

6. Actualizar Versiones

Para publicar una nueva versión, actualiza el número en tu manifiesto:

{
  "name": "mi-paquete",
  "version": "1.0.1",  // Cambia esto
  ...
}

Luego publica nuevamente:

lpm publish

📌 Versionado Semántico:

  • 1.0.0 - Versión inicial
  • 1.0.1 - Patch (bug fixes)
  • 1.1.0 - Minor (nuevas features)
  • 2.0.0 - Major (breaking changes)

¿Necesitas Ayuda?

Si tienes problemas al publicar, estamos aquí para ayudarte