npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@siclik-birlos/protocol-buffers

v1.9.0

Published

Módulo encargado de centralizar los protos de siclik

Downloads

7

Readme

Librería de protos

Esta librería esta encargada de centralizar los archivos proto para la comunicación entre los diferentes micro servicios de siclik.

Cada vez que un archivo proto se modifique o se cree uno nuevo, es necesario actualizar la librería siguiendo la arquitectura de la siguiente manera:

.
|── helpers
| └─ proto-paths.json //paths de los protos
|── proto-files //contenedor de protos por servicio
| └─ users
|   └─ read.proto //archivos proto
|   └─ write.proto
| └─ customers
| └─ products
| └─ ....
|── .eslintrc.js
|── .gitignore
|── index.js //se carga el proto para ser usado
|── test.js //archivo de pruebas
|── package.json
|── yarn.lock
.

Realizar pruebas en local

Empaquetar el modulo

Cuando deseamos realizar cambios o ajustes en nuestro modulo y tenemos la necesidad de probar los cambios, tenemos que realizar una serie de pasos para poder empaquetarlo e instalarlo en el api u otro modulo donde sera utilizado.

1 - Empaquetamos el modulo:

$ npm pack

Esto nos genera un archivo .tgz con el nombre de nuestro proyecto, (para mantener un orden en las pruebas se puede renombrar el archivo solo concatenando la versión ejem. protoBufV2.tgz)

2 - Listar contenido en el archivo .tgz:

$ tar -tf <Nombre del archivo .tgz>

Instalar el paquete

Cuando tenemos nuestro modulo terminado y empaquetado en un archivo .tgz ahora podemos proceder a instalarlo para realizar pruebas con el como un modulo de npm.

Para lograr esto primero tenemos que saber la ubicación del paquete en nuestra maquina, posteriormente con un simple comando podemos instalarlo en el proyecto.

// Con el gestor de paquetes NPM
$ npm install ../<ubicación del paquete>.tgz

// Con el gestor de paquetes YARN
$ yarn add ../<ubicación del paquete>.tgz

Actualizar versión

Una vez que se realizaron las modificaciones necesarias para hacer uso de los archivos protos en la librería, se debe actualizar la versión de la misma desde el archivo de configuración o package.json desde la raiz del proyecto siguiendo un versionado semántico.

{
  "name": "@compusoluciones/protocol-buffers",
  "version": "0.0.9", // versión del proyecto
  "description": "Módulo encargado de centralizar los protos que usaran los micro servicios de siclik.",
  "main": "index.js",
}

Publicar modulo en NPM

Cuando las modificaciones a la librería se hayan realizado correctamente y se valido su correcto funcionamiento, es necesario publicar en npm la nueva versión para mantenerla al dia con los protos que usan l os micro servicios.

Pasos para publicar una nueva versión se debe seguir los siguientes pasos.:

  • Tener una cuenta de npm con el correo de la empresa @compusoluciones
  • Acceso a la organización compusoluciones dada por una administrador de la misma.
  • Permisos para publicar en la organización.
  • Tener instalado el gestor de paquetes npm en tu maquina.
  • Asociar npm a tu cuenta con npm login (solo la primera vez).
  • Publicar con npm publish --access=public

Modo de uso

Una vez que la nueva versión de la librería haya sido liberada y avisado al equipo de los cambios por medio del grupo en slack, es necesario indicar de la nueva versión al modulo de grpc-connections ya que esta es la que consume directamente la librería de protos y no podremos hacer uso de ella hasta no realizar estos cambios.

Cuando grpc-connections haya sido actualizada desde su package.son y publicada en npm con los cambios también se debe realizar el mismo procedimiento con los micro servicios que consumirán ambos módulos desde node.