Skip to content
This repository has been archived by the owner on Oct 24, 2019. It is now read-only.

square/pilgrim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pilgrim

Pilgrim is a one page application that provides documentation for protocol buffers. It is compiled into a static site by middleman.

DEPRECATED

This project is no longer maintained.


This application does not upload your bundle to the server and relies on CORS to fetch proto bundles.

Creating your own proto bundle

Proto bundles are created with protob.

How to use?

Serve pilgrim/build from your favourite web-server.

To fetch your own proto bundle, use pilgrimize.

  • Create a protos.json file to specify your dependencies
  • Install pilgrimize npm install -g pilgrimize
  • Run pilgrimize in the same directory as your protos.json file

For example. To run your own bundle of the marvel comics api, protos.json:

[
  { "git": "https://github.com/hassox/google-protos.git" },
  { "git": "https://github.com/hassox/fender.git" },
  { "git": "https://github.com/hassox/marvel-protos.git" }
]

Then:

$ npm install -g pilgrimize
$ pilgrimize

Then head over to pilgrim

About

A documentation browser for protocol buffers

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages