Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

grpc-docs

Package Overview
Dependencies
Maintainers
1
Versions
15
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

grpc-docs

gRPC API Documentation

  • 1.1.4
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source
gRPC Docs logo

Interactive gRPC API Documentation

NPM JavaScript Style Guide

We're like Swagger UI, but for gRPC APIs. Give us a star if you like the project.

Live demo

Live demo is available at https://gendocu-demo.web.app/.

gRPC Docs logo

Quickstart

docker run -rm --network host \
  -v <your-proto-root>:/input \
  -v $(pwd)/output:/output \
  gendocu/grpc-docs

Install

Only for node 12+ (you can check your node version with node -v)

npm install --save grpc-docs

Or

yarn add grpc-docs

Usage

You can find all the integration types in example/src/App.tsx file.

You can use this widget standalone or with GenDocu Cloud gRPC CI/CD. Feature comparison is below.

Running example

  1. Clone this project
  2. Go to example directory and use yarn start to run the frontend
  3. In case you want be able to modify the library open the repository root directory in second terminal and run yarn start

Standalone within existing react frontend

  1. Install grpc-docs - instruction in Setup section
  2. Generate json description from protobuf api with project protoc-gen-doc: protoc --doc_out=./ --doc_opt=json,description.json *.proto
  3. Inside your React project create API Reference component - you can see example of usage in example/src/App.tsx
import React from 'react'

import { GRPCSelfGeneratedAPIReference } from 'grpc-docs'

const Example = () => {
  // return <GRPCSelfGeneratedAPIReference file='url-to-json-description-of-api'/>

  // return <GRPCSelfGeneratedAPIReference definition='A json string definition that got generated by protoc'/>

  return <GRPCSelfGeneratedAPIReference file='example-descriptors/description.json'/>
}
  1. [optional] You can also provide the environments and authentication description - add scheme='path-to-scheme-file.yaml'. Use GenDocu Cloud Api Specification Scheme. You can find example file here.

Hosting the generated protoc JSON behind auth.

You can provide a protoc definition as text directly to the <GRPCSelfGeneratedAPIReference /> component. So you should be able to fetch your hosted json with the correct headers and provide it to the compoenent in the definition prop.

import React from 'react'

import { GRPCSelfGeneratedAPIReference } from 'grpc-docs'

const Example = async () => {
  const resp = await fetch('my-company.com/protoc.json')
  const definition = await resp.text()

  return <GRPCSelfGeneratedAPIReference definition={definition}/>
}

With GenDocu

  1. Install grpc-docs - instruction in Setup section
  2. Create a project on Gendocu Cloud
  3. Use component inside your React project
import React from 'react'

import { GRPCGenDocuAPIReference } from 'grpc-docs'

const App = () => {
  //return <GRPCGenDocuAPIReference project='your-gendocu-project' organization='your-organization'/>
  return <GRPCGenDocuAPIReference project='LibraryApp' organization='gendocu'/>
}
export default App;

You can also implement your own backend wrapper - API documentation is available here.

Feature comparison

FeatureStandalone gRPC-docsgRPC-docs with GenDocuGenDocu Developer Portal
Setup steps
API Reference
Code snippets
Password protected documentation
Programming languages166
Environment selection❌^❌^
Authentication description❌^❌^
Try it out❌^
RBAC protected documentation
SSO

^ to be implemented

Customize style

To create your own styled documentation change the implementation in style/default - you can find there all the files implementing the UI of documentation. We strongly recommend to create own style directory, like style/my-style instead of overwriting the style/default components.

Troubleshooting

  1. ... is not allowed. Add this origin in your documentation settings. You have to add the host in your GenDocu project settings. If the project is not owned by you, ask project owner.

License

MIT © gendocu-com

FAQs

Package last updated on 01 Feb 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc