Aquí esta el gist: README.MD
Introducción a NPM
Acerca de NPM, paquetes y módulos
Instalación
Cómo instalar un NPM en Windows
Cómo instalar un NPM en Mac
Configuración
Iniciar un proyecto
Instalación de dependencias
Instalación de dependencias con force
Cómo actualizar y eliminar paquetes
Package lock y el uso los símbolos ^ y ~
Ejecutar tareas
Solución de problemas en proyectos con NPM
Gestionar la seguridad en proyectos con NPM
Publicar un paquete
Crear un paquete para NPM
Publicar un paquete en NPM
Paquetes privados
Cierre del curso
No tienes acceso a esta clase
¡Continúa aprendiendo! Únete y comienza a potenciar tu carrera
Crear cuenta
Si ya tienes una cuenta,
Iniciar sesión
Paquetes privados
14/15Recursos
Para usar paquetes privados, debes:
- Estar usando una versión igual o superior a la 2.7.0 de NPM
- Tener una cuenta de usuario u organización de pago
En un paquete privado de NPM, solo pueden participar el propietario y los colaboradores autorizados. De esta manera, puedes seguir construyendo el paquete con una combinación de código privado y dependencias públicas.
Actualizar tus paquetes con buenas prácticas
Tu paquete debe contener toda la información posible para que el usuario puede instalarlo, utilizarlo y hasta colaborar para solucionar posibles bugs. Por ende, es necesario que tengas configurado, por lo menos, un archivo README.md y un repositorio remoto (GitHub, GitLab, etc.).
Una vez tengas estos requisitos, puedes actualizar tu paquete a una nueva versión, luego publicalo nuevamente.
Crear un archivo README.md para tu paquete
Para crear un archivo README.md puedes utilizar esta estructura base y adecuarla a tu proyecto. Puedes mirar el código haciendo clic en el botón “Raw”.
Crear un archivo repositorio remoto para tu paquete
Para crear un repositorio remoto, utiliza el comando pertinente para conectar tu repositorio local de Git con un servicio en la nube, usualmente se utiliza GitHub. Por ejemplo:
$ git remote add origin <https://...>
Si no conoces este comando, te recomiendo seguir con el Curso Profesional de Git y GitHub, en el que aprenderás el software de control de versiones de tu código más importante en tu carrera como desarrollador.
Después, debes actualizar tu archivo de package.json con la información de tu repositorio remoto. Puedes hacerlo manualmente modificando el archivo, o emplear el comando npm init que no cambiará tu configuración, solamente la actualizará con la nueva información que ingreses.
Debería agregar las propiedades "repository", "bugs" y "homepage" con los enlaces pertinentes del repositorio remoto, en el archivo de configuración de la siguiente manera:
//package.json
{
... ,
"repository": {
"type": "git",
"url": "http://github/.../random-msg.git"
},
"bugs": {
"url": "http://github/.../random-msg/issues"
},
"homepage": {
"url": "http://github/.../random-msg#readme"
}
}
Contribución creada con aportes de: Andrés Guano.
Aportes 176
Preguntas 14
Ordenar por:
Les comparto mi package, el cual retorna frases celebres de manera aleatorio para motivar nuestra labor como desarrolladores.
Para poder enviar el comando:
npm version patch/minor/major
Deben primero dejar limpio el working directory de git, es decir deben hacer un commit de los cambios que se realizaron o revertir cambios.
Este error puede ocurrir cuando se añade en el package.json el repositorio de git, como se modifica el archivo es necesario hacerle commit antes de enviar el version patch
- Para mejorar nuestros paquete y que cuente con los requerimientos mínimos para serlo haremos lo siguiente:
- crearemos un buen
README.mden donde vamos a explicar lo que hará nuestro paquete osea toda nuestra documentación, además esto debe estar en ingles. - Ademas debemos Conectarlo a un repositorio de github
- npm init ahora veremos que ya esta ligado a un repositorio, de igual forma podemos ver esta información en el package.json
- crearemos un buen
npm version <major |minor |patch>nos permite actualizar la versión de nuestro proyecto o paquete ejemnpm version patchy el resultado seria v1.0.1, muchas veces nos dira que debemos actualizar a la versión mas reciente de npm y lo hacemos consudo install -g npm, si nos vamos al package veremos que la versión a cambiado, y para publicarlos volvemos a ejecutar el comandonpm publishnpm unpublish -fpara despublicar un paquete recuerda que debes estar ubicado en la carpeta raíz del proyecto
Hola, les comparto mi package, con este package podrán crear la estructura de de un API con express con son los end-points que le especifiquen.
Ya quedó disponible el paquete en el repositorio para que cualquier persona lo utilice. Pero se debe cumplir un estándar.
- Contar con un README.md. Preferiblemente en inglés.
- Cambiar la descripcion del package.json
"description": "I don't know what to write for the first commit." - Colocar las pruebas para la revion del paquete.
"test": "echo \"Error: no test specified\" && exit 1". Colocar más pruebas y se recomienda este curso https://platzi.com/cursos/jest/.
Adicionar mi repositorio a GitHub
git remote add origin https://github.com/DavidBaezDbz/Estudio/tree/master/GestionDeDependenciasYPaquetesConNPM/random-messages
Podría ser necesario inicializar el repositorio
git init
Volver a ejecutar npm init y aparecerá en el repositorio.
"repository": {
"type": "git",
"url": "git+https://github.com/DavidBaezDbz/Estudio/tree/master/GestionDeDependenciasYPaquetesConNPM/random-messages.git"
},
"bugs": {
"url": "https://github.com/DavidBaezDbz/Estudio/tree/master/GestionDeDependenciasYPaquetesConNPM/random-messages/issues"
},
"homepage": "https://github.com/DavidBaezDbz/Estudio/tree/master/GestionDeDependenciasYPaquetesConNPM/random-messages#readme"
Se va a modificar la version https://docs.npmjs.com/cli/version
- Cambio mayor
npm version major - Cambio menor
npm version minor - Parche a nuestro paquete
npm version patch
Como nuestro cambio es solo un parche en el paquete se ejecuta npm version patch
"name": "random-messages-dbz",
"version": "1.0.1",
"description": "I don't know what to write for the first commit.",
"main": "src/index.js",
Se debe volver a publicar el paquete npm publish
Acuérdense que hay un repositorio para empresas en NPM y poder colaborar remotamente. Hay que revisar por qué ya NPM es parte de GitHub.
Aquí está mi paquete: https://www.npmjs.com/package/random-messages-jm
Les dejo mi paquete el cual hace fetch a una API para obtener las quotes. De esta forma tengo acceso a muchísimas quotes sin tener que mantenerlas.
En mi proyecto también incluyo tests automatizados con Github Actions y archivos de configuración para Prettier y Eslint.
Proyecto: UltiRequiem/ranmess
Super este curso, aquí mi paquete 😄
Lo logre! jajaj casi que no, muchos errores pero aprendí https://www.npmjs.com/package/paufernanda2397-random-messages
Luego de conectar con el repositorio y hacer los cambios al dar npm version me salió el siguiente error:
npm ERR! Git working directory not clean.
Para solucionar este error usé el siguiente comando:
** git stash**
Con este comando pude seguir todos los pasos para cambiar la versión, espero que le ayude a alguien que pudiera tener este problema.
Porque cuando quiero publicar me da este error, los enlaces son a mis repositorios.
Ademas cuando da este error cierra repentinamente el post y lo borra todo lo que querias compartir 😦 😦 😦
Listo! Aquí está mi package
Buenas! les comparto mi humilde package, el cual retorna las excusas mas usadas por los desarrolladores en el dia a dia, y en el README toda la teoria del curso 😛
Hola, ¿y como pudiera importar ese paquete?
Es decir, por medio de require o import a otro proyecto.
Pueden crear un archivo llamado .npmignore que funciona de forma idéntica a .gitignore para evitar adjuntar al paquete archivos o directorios indeseados.
EL argumento que se le pasa a version debe ser una cadena ‘semantic versioner’ válida, uno de estos (patch, minor, major, prepatch, preminor, premajor, prerelease) de npm-version
cuando instale paquetes de forma global no se que le sucedió a mi computadora perdí derechos de administrador no podía abrir carpetas , ejecutar programas ni eliminar archivos tuve que formatear mi computadora. Alguien sabe por que me paso eso??
Paquetes privados
Nos colocamos en el proyecto que publicamos y debemos colocar un buen readme y conectarlo a un buen repositorio
Debemos colocar un repositorio vacio y aggregarlo a la carpeta con
git init
git remote add origin link de github
Despues ejecutamos un comando
npm init : va a reconocer que ya tiene una configuracion de github, ya va a detectar todo desde los bugs, repositorios y la pagina, revisamos que el archivo ya tenga los valores
Es momento de irnos a la terminar para publicarlo
npm version patch // cambio pequeño
Nos mostrara un mensaje si necesitamos actualizar algunos paquetes
npm -v
npm publish: con esto va a publicar nuestro paquete con la version a npm
Notas del curso Aquí
Aquí les dejo mi repositorio https://github.com/raycris/random-names-raycris.git
y tambien un link de como crear un repositorio en github por si no saben como hacerlo, es muy importante https://intelequia.com/blog/post/2121/cómo-subir-un-proyecto-a-un-repositorio-de-github
Les comparto mi proyecto. #JSChallenge
Generador Mensajes Random
Estupenda explicación paso a paso de cómo crear nuestro proyecto npm, acá comparto el mío:
https://www.npmjs.com/package/ulzahk-random-messages
https://github.com/Ulzahk/ulzahk-random-messages
Por cierto, si les sale el error: npm ERR! 403 a package version that is forbidden by your security policy. En mi caso pude solucionarlo al cambiar el nombre del paquete en el archivo package.json por una diferente, por ejemplo:
“name”: “random-messages” -> “name”: “ulzahk-random-messages”
Estuvo muy bueno el curso, hubiera sido genial que tocaran temas como npx o los custom registry, que a veces usan las empresas, o cómo pegarse a un registry custom.
Saludos!
Ya publicamos nuestro paquete y ahora cualquiera puede obtenerlo en su computador.
En nuestro editor de codigo aparece el README que es donde debemos de agregar una descripcion y mostrar las utilidades y funciones que pueda tener nuestro paquete. TODOS LOS README DEBEN DE ESTAR EN INGLES.
Debemos de ligar nuestro repositorio a un repositorio vacio en Github.
Ahora para poder asignar esto debemos iniciar de nuevo:
npm init
Donde reconocera que ya tenemos un repositorio y una configuracion y actualizara toda la informacion. Solo decimos que yes.
Ahora necesitamos actualizar la version si solo fue un cambio mayor, menor o parche, asi que escribimos
npm version patch/minor/major
De esta forma hara automaticamente el cambio de nuestro package. Ahora solo toca volver a publicarlo con la nueva version, solo se hace de forma igual que antes
npm publish
En la parte de empresas podemos ver como podemos crear paquetes privados entre un equipo de programadores en una empresa.
Acá esta mi package => https://www.npmjs.com/package/eaespana-random-messages
Hola! Aquí está mi paquete, al ejecutarlo devuelve el nombre de algún piloto de F1 https://www.npmjs.com/package/random-f1-driver
muy útil el curso Gracias Oscar. https://www.npmjs.com/package/random-dante
Aquí está, el curso muy interesante 😄
https://www.npmjs.com/package/random-names-dev
Ya que todos comparten su paquete, este es el mío:
https://www.npmjs.com/package/random-messages-israelyance
Mi paquete randomnames-drp
aqui esta mi paquete https://www.npmjs.com/package/nandoes90-random-messages
y mi repositorio en GitHub https://github.com/FernandoNunez1990/nandoes90-random-messages
Este es mi paquete
https://www.npmjs.com/package/npm-test-random-msg
Muy buena clase
Les dejo por acá mi paquete, por si le quieren echar un vistazo.
Hey aquí esta mi primer paquete pikdo
Una forma de conectar un repo local hacia github es usando la herramienta gh.
En Ubuntu linux por ejemplo, asumiendo que ya hicieron git init, git add . y git commit -m “mensaje”.
Instalan gh
sudo apt install gh // Para instalar
gh repo create // Para subir un repo local hacia github
Van a aparecer 2 opciones:
? What would you like to do? [Use arrows to move, type to filter]
Create a new repository on GitHub from scratch
> Push an existing local repository to GitHub
Seleccionan “Push an existing local repository to Github” con la tecla de flecha abajo y siguen los pasos guía.
https://www.npmjs.com/package/@ldaca/formatter-date Excelente curso!
https://www.npmjs.com/package/random-messages-vladi
Waohhhh este curso es increible… me encantooo muchooooo
explicó cómo hacerlo privado al final? No me funcionó lo de probar el paquete ni subirlo.
Acá les paso mi paquete de algunos quotes de IT.
random-it-quote
¡Saludos!
Estuve jugando con el versionamiento, y con una funcion que solo imprime un log o mensaje .
https://www.npmjs.com/package/module-1-sri
Esta muy bien el curso
excelente curso,
Hola!, les comparto mi npm package llamado “imbored”, es un paquete que te devuelve por consola una actividad aleatoria para hacer cuando estes ab[email protected], gracias:)
https://www.npmjs.com/package/imbored
Aqui esta mi package https://www.npmjs.com/package/swipe-direction 😃
les comparto mi paquete que genera un array con datos de un usuario de manera aleatoria
Este es mi primer package de npm, cambie un poco a frases multinacionales que encontré en internet:
https://www.npmjs.com/package/my-motivational-random-messages
En el README podemos explicar que hace nuestro paquete, como se instala y mostrar que comandos puede tener.
Cree mi propio paquete npm y lo llame node-random-names.
Realice los ajustes en el codigo y en el readme. 👌👌😃
Ha explotado la cabeza con tanta información, pero hemos conseguido el objetivo de crear el paquete y subirlo.
Aquí el link: https://www.npmjs.com/package/jr-ramdom-messages
Espero ir creciendo compartir paquetes con mayor uso.
Hola con todos, les comparto mi humilde package, que permite obtener las ciudades de un país respectivamente de manera aleatoria.
GitHub -> https://github.com/cesarchoqueskater/random-country-cities
Npm -> https://www.npmjs.com/package/country-cities-random
Gracias
Aquí el mio: random-messages-sophia
Excelente curso, mi repo: https://github.com/davidtimana/random-messages-david-timana/blob/main/readme.md
Aquí dejo mi package de npm , random-messages-jose-platzi.
A mí se me ocurrió que mostrara frases de forma aleatoria, pero que también cambiara el color de las frases.
Hice este paquete! https://www.npmjs.com/package/liltanie-time
Usando get-time podés saber el día, mes y hora. Además en ciertas situaciones aparece una frase especial. Es solo una mini práctica, pero me hacía ilusión.
Aqui mi package del curso 😄
https://www.npmjs.com/package/random-messages-ivi-mendietaplatzi
En mi caso hice un paquete que devolviera valores aleatorios de un array o de un rango con un mínimo y máximo
https://www.npmjs.com/package/randomize-values?activeTab=versions
Con todo el revuelo de la nueva serie de Netflix “Arcane” decidí hacer un generador de nombres aleatorios de la serie, siéntanse libres de contribuír con más nombres o de probarlo en sus entornos. 😁
Oscar gracias por este curso fue genial.
Este es mi paquete
https://www.npmjs.com/package/random-messages-ley
En este enlace pueden crear y editar su README con todas las de la ley! 💪
Este es mi paquete
Aca dejo mi primer paquete publicado en NPM:
Que alegría mi primer paquete publicado en NPM, comparto este logro:
https://www.npmjs.com/package/random-messages-percy
🤓😎🤓
Aquí esta mi proyecto, muestra frases motivadora y sus autores 😎
Les dejo mi repositorio. Coge las 3.000 palabras más usadas del inglés e imprime 10 de ellas al azar en la consola, tan solo hay que escribir en consola:
npx random-msg
Una vez instalado el paquete con:
npm i random-messages-from-3000-words
Aquí les dejo el link a npm
Ejemplo Output:
make crime evil obviously capture carry wrote also capacity way
hero season roll occupy ceiling discount wherever coffee my abroad
Paquetes privados
sudo npm link
sudo npm install /home/santiagobr/personalProjects/course-npm/random-messages
npm adduser
npm publish
Actualizar la version de mi proyecto npm
/*Cambio parche*/
npm version patch
/*Cambio menor*/
npm version minor
/*Cambio mayor*/
npm version mahjor
Les comparto mi package de prueba.
Les comparto mi package, lo que hace es retornar frases “inspiradoras”, tal vez en un futuro retorne mejores frases y para distintos moods.
Great messages
Proyecto: javascript-random-messages
Github
npm package
Aqui compartiendo mi primer paquetito… 😅😅😅
Buenas, aqu’i les dejo mi paquete publicado con npm:
Excelente clase!
Lista la publicación:
https://www.npmjs.com/package/random-messages-ticos
IMPORTANTE:
A la fecha NPM cuenta con verificación de doble factor y en mi caso tuve que usar un nombre (name) del paquete descrito en el archivo package.jsondiferente (único) para poder publicarlo.
espero que esto aclare muchas dudas!
Salu2!
Aquí te dejo mi proyecto Osquitar!
https://www.npmjs.com/package/random-messages_by-gomezjuanefe
Alfin me salió 😊 Mi repositorio en npm
Mi paquete:
Aquí esta mi paquete, no agregue nada especial por ahora, solo lo que hicimos en el curso, pero me siento satisfecho:
https://www.npmjs.com/package/random-messages-platzi-edward-frans
Aquí está publicado mi proyecto: Muestra frases random de pensamientos positivos.
Proyecto
Nada más que palabras en ingles con la letra a.
Aquí está el mío.
Comparto mi paquete también.
https://www.npmjs.com/package/jf-random-messages
Hay un archivo de notas en donde he añadido alguna información que comparte la comunidad interesante.
A todo esto, gracias.
Les comparto mi repositorio que genera frases de poetas aleatoriamente npm-poetic-phrases.
Aquí está mi paquete
Gracias de verda!!! curso terminado!!!
Aquí les dejo el mío, da un pokemon aleatorio 😄
https://www.npmjs.com/package/random-pokemon-jtest
Les comparto mi proyecto
–
Y aqui pueden checar el repositorio 💚
Los aportes, preguntas y respuestas son vitales para aprender en comunidad. Regístrate o inicia sesión para participar.