Skip to content

confluent cli description update #8786

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

alluri02
Copy link
Member

@alluri02 alluri02 commented May 23, 2025


This checklist is used to make sure that common guidelines for a pull request are followed.

Related command

General Guidelines

  • Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
  • Have you run python scripts/ci/test_index.py -q locally? (pip install wheel==0.30.0 required)
  • My extension version conforms to the Extension version schema

For new extensions:

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

@Copilot Copilot AI review requested due to automatic review settings May 23, 2025 11:18
Copy link

Validation for Breaking Change Starting...

Thanks for your contribution!

Copy link

Hi @alluri02,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in setup.py as well.

@yonzhan
Copy link
Collaborator

yonzhan commented May 23, 2025

Thank you for your contribution! We will review the pull request and get back to you soon.

Copy link

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates the Confluent CLI command descriptions and improves the parameter validation logic for various organization operations. Key changes include updated docstrings for better clarity, adjustments to argument definitions (such as the email regex pattern and resource group options), and renaming internal classes in the list command to more accurately reflect their purpose.

Reviewed Changes

Copilot reviewed 40 out of 40 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/confluent/azext_confluent/aaz/latest/confluent/organization/access/default/_list_cluster.py Updated command description for listing clusters
src/confluent/azext_confluent/aaz/latest/confluent/organization/access/__cmd_group.py Updated command group registration and description
src/confluent/azext_confluent/aaz/latest/confluent/organization/_wait.py Added read_only flag to a schema property
src/confluent/azext_confluent/aaz/latest/confluent/organization/_update.py Updated command description, removed redundant resource group options, adjusted email regex escaping, and added read_only flag
src/confluent/azext_confluent/aaz/latest/confluent/organization/_show.py Improved docstring and set read_only flag
src/confluent/azext_confluent/aaz/latest/confluent/organization/_list_users.py, _list_service_accounts.py, _list_role_binding.py Updated descriptions for listing details
src/confluent/azext_confluent/aaz/latest/confluent/organization/_list_region.py Added new command for listing supported regions
src/confluent/azext_confluent/aaz/latest/confluent/organization/_list.py Updated list command logic and renamed inner classes to align endpoints with conditions
src/confluent/azext_confluent/aaz/latest/confluent/organization/_delete.py, _create_user.py, _create_role_binding.py, _create.py Updated descriptions and argument formats
src/confluent/azext_confluent/aaz/latest/confluent/organization/init.py, __cmd_group.py Updated init imports and command group description
src/confluent/HISTORY.rst Bumped version and added CLI description update history
Comments suppressed due to low confidence (1)

src/confluent/azext_confluent/aaz/latest/confluent/organization/_update.py:170

  • The updated email regex pattern now uses proper escaping; please ensure this pattern fully meets your email validation requirements in production scenarios.
pattern="^\\S+@\\S+\\.\\S+$",

return cls._args_schema

def _execute_operations(self):
self.pre_operations()
condition_0 = has_value(self.ctx.args.resource_group) and has_value(self.ctx.subscription_id)
condition_1 = has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
condition_0 = has_value(self.ctx.subscription_id) and has_value(self.ctx.args.resource_group) is not True
Copy link
Preview

Copilot AI May 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The logic for determining which inner class to invoke (i.e. OrganizationListBySubscription versus OrganizationListByResourceGroup) relies on dividing conditions in a non-obvious way. Consider refactoring or adding inline comments to clarify the intent and ensure that each endpoint URL aligns with the corresponding condition.

Copilot uses AI. Check for mistakes.

Copy link

CodeGen Tools Feedback Collection

Thank you for using our CodeGen tool. We value your feedback, and we would like to know how we can improve our product. Please take a few minutes to fill our codegen survey

Copy link

github-actions bot commented May 23, 2025

@github-actions github-actions bot added the release-version-block Updates do not qualify release version rules. NOTE: please do not edit it manually. label May 23, 2025
@yonzhan yonzhan requested a review from kairu-ms May 23, 2025 14:02
@@ -2,6 +2,10 @@

Release History
===============
0.7.0
Copy link
Member

@AllyW AllyW May 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
0.7.0
1.0.0

as per the reviewer suggestion

Co-authored-by: AllyW <[email protected]>
@github-actions github-actions bot removed the release-version-block Updates do not qualify release version rules. NOTE: please do not edit it manually. label May 27, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants