avrodoc-plus

avrodoc-plus is a documentation tool for Apache Avro schemas.

This project originates from ept/avrodoc -> ckatzorke/avrodoc-plus -> leosilvadev/avrodoc-plus, which are all great, but received no further updates.

Usage

npm install --global @mikaello/avrodoc-plus

avrodoc-plus -i source -o out.html

Or without installation:

npx @mikaello/avrodoc-plus -i source -o out.html

Options

USAGE:
    avrodoc-plus [FLAGS] [OPTIONS] [AVRO FILES...]

FLAGS:
        --ignore-invalid     Ignore avsc files that can not be parsed as JSON (instead of quiting)

OPTIONS:
    -i, --input <folder>          Pass in a source folder that will recursively parsed and crawled for avsc files
    -o, --output <file>           The file where the generated doc should be written to
        --title <title>           The title that will be used in the generated HTML page, defaults to "Avrodoc".
    -s, --style <file>            Your own CSS file, appended after the default styles to override specific styles
        --annotation-fields <f>   Comma-separated list of annotation keys to show in field tables.
                                  Defaults to "logicalType,aliases,order".

ARGS:
    <AVRO FILES>...          If not --input is given, you can specify individual AVRO files here

EXAMPLES:
    avrodoc-plus --ignore-invalid --input ./schemas --output avrodoc.html --title "My First Avrodoc"

    avrodoc-plus --output avro.html --style my-styles.css avro_schema1.avsc avro_schema2.avsc avro_schema3.avsc

Enhancements

• support for input folders
• support of schema/type search (search by namespace and/or schema/type)
• support for custom page title