ForkDatabricks (DBRX)Databricks (DBRX)published Oct 27, 2023seen 5d

databricks/api-linter

forked from googleapis/api-linter

Open original ↗

Captured source

source ↗
GH
GitHub/github.com/databricks/api-linter
databricks/api-linter repository metadata
Source ↗
published Oct 27, 2023seen 5dcaptured 17hhttp 200method plain

databricks/api-linter

Description: A linter for APIs defined in protocol buffers.

License: Apache-2.0

Stars: 0

Forks: 0

Open issues: 0

Created: 2023-10-27T18:21:04Z

Pushed: 2023-10-27T00:56:18Z

Default branch: main

Fork: yes

Parent repository: googleapis/api-linter

Archived: no

README:

Google API Linter

![ci](https://github.com/googleapis/api-linter/actions/workflows/ci.yaml)

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.

[apache 2.0]: https://www.apache.org/licenses/LICENSE-2.0 [api improvement proposals]: https://aip.dev/ [protocol buffers]: https://developers.google.com/protocol-buffers [rule documentation]: ./rules/index.md