CHANGELOG.md

Changelog

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

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

• Add concept of lint groups. The default lint group is named uber1. The lint group can be specified with the lint.group option.
• New uber2 lint group and associated V2 Style Guide representing the second version of our lint rules. These rules are almost entirely a superset of the V1 Style guide lint rules. If lint.group is set to uber2, this also will affect the create and format commands, as the uber2 lint group adds more file options to more closely match the Google Cloud APIs File Structure. In total, 39 lint rules have been added as compared to the uber1 lint group. and changes the value of go_package to take versions into account.
• New google lint group representing Google's minimal Style Guide.
• Add --list-lint-group flag to the lint command to list a lint group's rules.
• Add --diff-lint-groups flag to the lint command to print the diff between two lint groups
• Breaking change detector added as the break check command.
• A Docker image is now provided on Docker Hub as uber/prototool which provides an environment with commonly-used plugins.
• Switch to Golang Modules for dependency management.
• Add Bazel build files and bazel/deps.bzl to allow Prototool to be easily built within a Bazel workspace.
• Add lint.file_header option to allow a file header to be specified. This affects lint, format, and create.
• Allow generate.plugins.path to be relative. If a relative path is given, Prototool will search your PATH for the specified executable.
• Add generate.plugins.file_suffix option that allows for JAR generation with the built-in java plugin, and FileDescriptorSet generation with the built-in descriptor_set plugin.
• Add generate.plugins.include_imports and generate.plugins.include_source_info to be used with the built-in descriptor_set plugin.
• Add inspect top-level command with Protobuf inspection capabilities.
• Add cache top-level command to allow management of the protoc cache.
• Add --error-format flag to allow specific error fields to be printed.
• Add file locking around the protoc downloader to eliminate concurrency issues where multiple prototool invocations may be accessing the cache at the same time.
• Unix domain sockets can now be specified for the --address flag of the grpc command via the prefix unix://.

1.3.0 - 2018-09-17

Added

• Accept prototool.json files for configuation in addition to prototool.yaml files.
• Add --config-data flag.
• Add --protoc-bin-path and --protoc-wkt-path flags to manually set the paths for where protoc is run and where the Well-Known Types are included from.

1.2.0 - 2018-08-29

Added

• Add json flag to all, compile, format, generate and lint commands.

1.1.0 - 2018-08-24

Added

• Add support for Homebrew builds.

1.0.0 - 2018-08-23

• Initial release.

1.0.0-rc1 2018-08-16

Fixed

• Fixed regression where prototool version did not output 'Git commit' and 'Built'.

0.7.1 2018-08-15

Fixed

• Fixed an issue where Golang Mname=package modifiers were being duplicated.

0.7.0 - 2018-08-09

Changed

• Move protoc_includes and protoc_version settings under protoc key.
• Move allow_unused_imports to protoc.allow_unused_imports.
• Move protoc-url global flag under the applicable commands: all, compile, format, gen, and lint.
• Rename gen to generate.

0.6.0 - 2018-08-03

Changed

• Delete the ability to explicitly specify multiple files, and have the effect of one file being specified be the same as the former --dir-mode. See #16 for more details.
• Delete protoc_include_wkt setting. This is always set to true.
• Delete no_default_excludes setting. This is always set to true.
• Delete gen.go_options.no_default_modifiers setting.
• Delete lint.group setting.
• Delete harbormaster global flag.
• Refactor create.dir_to_base_package to the list create.packages See the documentation for more details.
• Rename create.dir_to_base_package -> create.dir_to_package.
• Move prototool init to prototool config init.
• Move gen.plugin_overrides to gen.plugins.path.
• Refactor lint configuration. See the documentation for details.
• Refactor format --no-rewrite so that the previous default is now enabled via format --fix.

Fixed

• Fix excludes setting to correctly match file path prefixes.

0.5.0 - 2018-07-26

Added

• A linter to verify that no enum uses the option allow_alias.
• The --protoc-url flag can now handle references to local protoc zip files as well as normal http references by handling urls of the form file:///path/to/protoc.zip.

Changed

• The formatter now prints primitive field options on the same line as the field.
• The commands binary-to-json, clean, descriptor-proto, download, field-descriptor-proto, json-to-binary, list-all-linters, list-all-lint-groups, list-linters, list-lint-group, and service-descriptor-proto are deleted to reduce the surface area for the v1.0 release.
• The commands list-all-linters and list-linters are now flags on the lint command.
• The flags --cache-path and --print-fields are deleted to reduce the surface area for the v1.0 release.
• The option lint.group in the prototool.yaml configuration is deleted to reduce the surface area for the v1.0 release.
• The command protoc-commands is now accessible via the --dry-run flag on the commands compile and gen.
• The grpc command now takes the flags --address, --method, and --data or --stdin as opposed to parsing these from variable-length command args.
• If more than one prototool.yaml is found for the input directory or files, an error is returned.
• The prototool binary package is moved under internal.

0.4.0 - 2018-06-22

Added

• A new command prototool create to auto-generate Protobuf files from a template. The generated files have the Protobuf package, go_package, java_multiple_files, java_outer_classname, and java_package values set depending on the location of your file and config settings. Make sure to update your Vim plugin setup as well if using the Vim integration. See the documentation for prototool create in the README.md for more details.

Changed

• The values for java_multiple_files, java_outer_classname, and java_package that pass lint by default now reflect what is expected by the Google Cloud APIs file structure. See https://cloud.google.com/apis/design/file_structure for more details.
• protobuf format will now automatically update the value of go_package, java_multiple_files, java_outer_classname, and java_package to match what is expected in the default Style Guide. This functionality can be suppressed with the flag --no-rewrite. See the documentation for prototool format in the README.md for more details.
• Formatting configuration options are removed. We think there should be only one way to format, so we went with defaults of two spaces for indents, semicolons at the end of RPCs if there are no RPC options, and always having a newline at the end of a file.

0.3.0 - 2018-06-14

Added

• Linters to verify that java_multiple_files and java_outer_classname are unset.

Fixed

• The formatting order now reflects https://cloud.google.com/apis/design/file_structure by moving the location of imports to be below syntax, package, and file options.
• Temporary files used for FileDescriptorSets are now properly cleaned up.
• Packages that begin with a keyword no longer produce an error when using prototool format or prototool lint.

0.2.0 - 2018-05-29

Added

• A default lint rule to verify that a package is always declared.
• A lint group all that contains all the lint rules, not just the default lint rules.
• A flag --harbormaster that will print failures in JSON that is compatible with the Harbormaster API.

Fixed

• prototool init will return an error if there is an existing prototool.yaml file instead of overwriting it.
• Nested options are now properly printed out from prototool format.
• Repeated options are now properly printed out from prototool format.
• Weak and public imports are now properly printed out from prototool format.
• Option keys with empty values are no longer printed out from prototool format.

0.1.0 - 2018-04-11

Added

• Initial release.