Skip to content

Latest commit

 

History

History
206 lines (127 loc) · 6.76 KB

CHANGELOG.md

File metadata and controls

206 lines (127 loc) · 6.76 KB
Raw

Changelog

All noteworthy changes to this project will be documented in this file.

The format is based on Keep a Changelog (as of Feb 2018) and this project adheres to Semantic Versioning.

Unreleased

CHANGELOG is now available with each release rather than in this file

Changed

  • Escape special characters in markdown anchors #460
  • Bump go to 1.17, protoc to 3.18.1, and leverage go:embed #461

v1.5.0

  • Add source_relative flag #450

v1.4.1

  • Add support for OneOf in templates #436
  • Note deprecated fields in HTML, Markdown, and Docbook outputs #426
  • Tidy up modules

v1.3.2 - May 7, 2020

Changed

  • Stripped unnecessary whitespace from markdown templates #410
  • Renamed lyft_validate extension to envoyproxy_validate #392
  • Fixed envoyproxy_validate rules with slice values such as in and not_in #392

v1.3.1 - March 3, 2020

Changed

  • Switched from dep to go modules

v1.3.0 - April 15, 2019

Added

  • Support for options and extended options in files, services, methods, enums, enum values, messages and fields #376

Changed

Fixed

v1.2.0 - March 13, 2019

Added

  • Added Sprig functions to renderer contexts
  • Added IsMap to MessageField objects indicating whether or not the field is a map field
  • Added RequestStreaming and ResponseStreaming to ServiceMethod objects indicating whether the request and/or response are streaming. Updated the templates to add "stream" indicators to method requests and responses.
  • Support for recursively adding nested enums and messages.

Changed

  • Bumped protobuf to 3.6.1 in docker container

Fixed

  • CI issue related to Regexp comparison on Golang master
  • Markdown template was incorrectly links response types to request types
  • Markdown template anchor tags were self-closing (invalid).

v1.1.0 - March 13, 2018

Added

  • Switch to using protokit to handle parsing and running the plugin
  • Default values are not included in the built-in templates
  • Added the ability to ignore certain files by adding :pattern[,pattern] to --doc_opt
  • Added -help and -version flags to the binary (e.g. ./protoc-gen-doc -help)

Changed

  • Dev tooling, now using dep and retool
  • CI setup to use go 1.10 (and master) and protoc 3.5.1
  • Docker image updated to use protoc 3.5.1 as well

Fixed

  • Several issues with the documentation
  • NrBr filter was a little too aggressive

Removed

  • The entire parser package (in favor of protokit)

v1.0.0 - September 26, 2017

This is the tenth official release. (However, it's the first 1.x release!!)

New things

  • Support for both proto2 and proto3!
  • Application is now dockerized, no need to install it (unless you want to of course)
  • Ported to Go and precompiled for Linux, OSX, and Windows
  • Added test coverage to ensure functionality and prevent regressions
  • Ignore comments starting with @exclude
  • Added (and backfilled) CHANGELOG.md
  • Added CONTRIBUTING.md

Bug fixes

  • Message enums no longer included in file enums (#288)
  • Added top-level files key for JSON output and camelCased all fields (#289)
  • Fixed issue with TOC in Markdown not nesting correctly (#293)
  • No need to worry about expiring apt keys (#295)
  • Extra slashes in comment prefix no longer show up in output (#298)
  • Added field details for templates (#300)
  • Markdown headers include new line so they render correctly (#303)

Breaking changes

  • File-level comments are now attached to the syntax directive
  • JSON fields are now camelCased
  • Mustache templates replaced with golang templates
  • Dropped direct support for PDF generation (still possible with FOP)
  • doc_out flag removed in favor of doc_opt

v0.9 - February 26, 2017

This is the ninth official release.

changes

  • Improve installation instructions for macOS (thanks @guozheng)
  • Improve installation instructions for Debian/Ubuntu (thanks @mhaberler)
  • Add asciidoc.mustache example template (thanks @ArcEye)
  • Don't do HTML escaping in Markdown template (thanks @sunfmin)
  • Add support for JSON output

v0.8 - February 26, 2016

This is the eight official release.

changes

  • Add support for documenting files (#9)
  • Add support for default values (#11)
  • Add no-exclude flag to ignore @exclude directives (#13)
  • Add support for RPC services (#14) (thanks to @murph0 !)

v0.7 - January 7, 2016

This is the seventh official release.

changes

  • Added support for extensions (thanks @masterzen !)
  • Added Custom Templates wiki page
  • Added additional distro packages for Debian 8, Ubuntu 15.04 + 15.10 and Fedora 22 + 23

v0.6 - April 8, 2015

This is the sixth official release.

No functional changes were made, but Linux distribution package repositories are now provided for Ubuntu, Arch, Fedora and openSUSE through the Open Build Service, and an RPM for CentOS 7 here below.

v0.5 - December 19, 2014

This is the fifth official release.

changes

  • Support exclusion also of enum values (accidental omission in 0.4).

v0.4 - December 19, 2014

This is the fourth official release.

changes

  • Updated to a newer version of qt-mustache.
  • Updated Windows zip to libprotobuf/libprotoc 2.6.1.
  • Added support for excluding messages/enums/fields.

v0.3 - August 19, 2014

This is the third official release.

changes

  • Updated to a newer version of qt-mustache which is more spec compliant.
  • Added missing documentation for enums to Markdown output.

v0.2 - August 14, 2014

This is the second official release.

  • No functional changes were made, but the build system was improved.

v0.1 - August 6, 2014

  • Initial release