jonike / omgrpc

omgrpc

omgRPC aims to be a GUI client for interacting with gRPC services, similar to what Postman is for REST APIs.

The goal is for it to be easy to use. Just open your .proto file and specify the address of the server you want to connect to and you're ready to start making requests.

Kubernetes support

Version v0.2.0 and later can automatically setup a port-forward for connecting to services inside of Kubernetes. If kubectl exists in your path, a dropdown will appear allowing you to choose which kubectl config to use, with the current kubectl config selected by default. You can then use the {servicename}.{namespace}:{port|port name} as the server address and omgRPC will figure out how a destination pod to setup a port forward.

Contributing

Please consider contributing, I will try to make it as easy as possible. This started as a proof-of-concept as I first started working with gRPC at Weave and it's just sort of grown organically from there. As a result, it's quite a mess and can use a lot of love. I'm open to any and all ideas.

Setting Up

In order to run omgRPC from source, execute the following steps from the root directory:

• Install Node JS.
• Update Node's package manager NPM
• Install nwjs, which is an installer for NW.js (NodeWebkit): npm install -g nwjs.
• Install nw.js 0.22.3-sdk by running nw install 0.25.0-sdk
• Install project dependencies by running npm install
• Install npm install -g node-pre-gyp
• Install npm install -g nw-gyp
• Most annoying step of all, rebuild the node gRPC dependency for your platform by running something like npm rebuild grpc --build-from-source --runtime=node-webkit --target=0.25.0 --target_arch=x64 --target_platform=darwin (set target_arch and target_platform to whatever you are building for. See here)
• Run omgRPC by running nw .

To be able to run the repo's example gRPC service (which is fully optional) you must have Go installed, along with all of the example's required dependencies. If you need help with this, let me know. This miniature Go project is a little different than your average Go project because it might not be in your normal GOPATH.

Frameworks and Organization

The project uses Angular 1 (or AngularJS or whatever we're calling it these days). I choice this because I was already familiar with it and didn't want to learn a new framework if this project wasn't even going to work. Now that it does work I'm leaning towards choosing something else, such as React or Angular-whatever-the-newest-is.

Bootstap is the CSS framework, but again switching to some material-design framework might be worth it.

The app itself lives in app. It imports dependencies from node_modules. The structure is pretty simple. There are only a couple of views that each have controllers, and a couple of services that handle some common dependencies. The code's organization could use some cleanup and rework as well.

There is an example gRPC service (written in Go) that can be used (and altered) to quickly and easily test omgRPC. This lives in exampleSvc.

Building for Distribution

I am sure there is a better way to do this (and one that will utilize minification better).

For now I am just using a tool called nw-builder. You can run ./build.sh, which runs a gulp file that mostly just copies everything it needs into a build folder, then runs this command: nwbuild -v 0.25.0 -p osx64 ./build/ -o dist. It drops the built resources into a folder called dist.

Some Miscellaneous Notes

• Import statements in the proto file need to be relative to the proto file from some shared root path.