Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

{CI} Linter check faulty_help_example_parameters_rule error

Open
#331 0 comments 0 reactions 1 assignee View on GitHub

@wangzelin007 is already working on this.

Since Apr 28, 2022.

Assessment

This issue has not been assessed yet.

Description

bug CI

Linter check raise the following error in PR:
https://dev.azure.com/azure-sdk/public/_build/results?buildId=1532217&view=logs&j=168ccbe3-da49-5c0b-6478-08f7016e4bf5&t=10a595be-4223-5cc7-9a73-012871b6eaee&s=96ac2280-8cb4-5df5-99de-dd2da759617d
image

After debugging, it is caused by:
https://github.com/Azure/azure-cli-dev-tools/blob/c94bff479f633845ccce1279eebac60426e985ab/azdev/operations/linter/rules/help_rules.py#L124

Linter rule faulty_help_example_parameters_rule will get example_text from _help.py file.

One of the generated example_text
az aks connection create keyvault -g ClusterRG -n MyCluster --tg KeyvaultRG --vault MyVault --service-principal client-id=XX secret=XX missing optional parameter object-id=XX

The workaround is adding object-id=XX to _help.py file

The following three problems need to be solved :

  1. The generation logic of example_text
  2. How to optimize the error message, there is no connection between the current error log and the actual problem.
  3. An exception in one of the linter checks will cause the remaining linter checks to abort and exit
Dominant language
Python
Stars
91
Forks
134
Avg merge
2h 51m
Merged PRs (30d)
1

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Azure/azure-cli-dev-tools

All issues in Azure/azure-cli-dev-tools

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.