NAME

pq - jq for protobuf - parse protobuf generically

SYNOPSIS

pq [ --msgtype=STRING] [ --stream] [ --force] [file]

DESCRIPTION

pq parses a compiled protobuf message with .fdset files located in '~/.pq/'

POSITIONAL ARGS

(OPTIONAL)file

 

Read message from a file. Default is stdin.

OPTIONS

--msgtype=STRING

 

Use this message type to decode protobuf - must be a fully qualified message name e.g. 'com.example.dog.Dog'. Default behavior is to try to guess the message type. Guessing and msgtype apply to every message in a stream.

 

**WARNING**: since protobuf treats fields as positional, similar protos (e.g. Dog: <Int: age, String: breed>, Person: <Int: ssn, String: name>) are indistinguishable.

--stream

 

Parse varint32-delimited stream. This is the way it's done by Google in delimited_message_util.

--force

Forcefully decode by removing bytes until success (or no bytes are left). This will apply to every message in a stream.

ENVIRONMENT VARIABLES

FDSET_PATH

 

Specify alternative fdset path. Default is '~/.pq/'.