Skip to content

googleapis/api-linter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

93297bb Β· Feb 16, 2024
Jan 2, 2024
Jan 22, 2024
Jan 25, 2024
Feb 16, 2024
Jan 2, 2024
Jan 2, 2024
Feb 16, 2024
Aug 6, 2019
Oct 24, 2022
Dec 2, 2019
Aug 2, 2023
Feb 16, 2024
Feb 16, 2024
Apr 5, 2021
Jul 16, 2021
May 13, 2019
Aug 24, 2023
Apr 27, 2021
Jan 30, 2024
Jan 30, 2024

Repository files navigation

Google API Linter

ci latest release go version

The API linter provides real-time checks for compliance with many of Google's API standards, documented using API Improvement Proposals. It operates on API surfaces defined in protocol buffers.

It identifies common mistakes and inconsistencies in API surfaces:

// Incorrect.
message GetBookRequest {
  // This is wrong; it should be spelled `name`.
  string book = 1;
}

When able, it also offers a suggestion for the correct fix.

Read more ≫

Versioning

The Google API linter does not follow semantic versioning. Semantic versioning is challenging for a tool like a linter because the addition or correction of virtually any rule is "breaking" (in the sense that a file that previously reported no problems may now do so).

Therefore, the version numbers refer to the linter's core interface. In general:

  • Releases with only documentation, chores, dependency upgrades, and/or bugfixes are patch releases.
  • Releases with new rules (or potentially removed rules) are minor releases.
  • Releases with core interface alterations are major releases. This could include changes to the internal Go interface or the CLI user interface.

Note: Releases that increment the Go version will be considered minor.

This is an attempt to follow the spirit of semantic versioning while still being useful.

Contributing

If you are interested in contributing to the API linter, please review the contributing guide to learn more.

License

This software is made available under the Apache 2.0 license.