Browser and Node (Open Source)
Última actualización
Última actualización
Siempre que crees una nueva librería invierte tiempo en buscar un buen nombre (compártelo con el equipo)
Primero, . Asegúrate de que sea público.
Luego puedes crear el paquete con npm init
, el cual te preguntará algunos detalles del paquete, o crear manualmente un package.json
.
package.json
En el archivo package.json
debemos llenar al menos los siguientes campos.
Puedes agregar como autor a Platanus y a ti como colaborador:
Al menos deberías instalar las siguientes dependencias:
jest
: Testing
eslint-plugin-import
: Permite utilizar el linter para revisar sintaxis de import/export.
Opcionalmente, puedes instalar:
eslint-plugin-jest
: en caso de no instalarlo reemplazar jest/globals
en env
de .eslintrc.json
por solo jest
.
Si estamos desarrollando un paquete de Node (y no de web) debemos usar la sintaxis de CommonJS para imports/exports:
Se puede utilizar esta sintaxis manualmente o utilizar la sintaxis de ES6 y luego compilar con un bundle como webpack para que la librería quede en formato CommonJS.
Para correr algún archivo con un comando personalizado se deben seguir los siguientes pasos:
Crear un archivo cli.js
o una carpeta cli
con archivos que queremos que se ejecuten.
Al principio de estos archivos colocar:
En package.json
agregar una sección de:
Correr npm link
(permite simular la instalación del paquete), reiniciar la terminal y probar corriendo alguno de los comandos creados. Si se modifica alguno de los archivos javascript no es necesario volver a correr npm link
.
Si no has iniciado sesión en tu cuenta desde tu terminal, corre:
En NPM debes registrar el paquete y publicar directamente cada versión.
IMPORTANTE: Las publicaremos con nuestro usuario personal pero debemos agregar como owner al usuario de platanus.
eslint
: Linter. Puedes copiar las que vienen en Potassium. Puede ser necesario eliminar las reglas relacionadas a Vue y Tailwind si no serán utilizados.
Los paquetes deben ser publicados en . Si no la tienes, deberás crearte una cuenta personal.