Investigate automatic singularization of function cmdlet nouns in the v3 generator
Maintainer thường phản hồi trong vòng 7 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 18/100
Hướng nghiên cứu
Start with the function-segment branch in tools/WrapperGenerator/CmdletNaming.cs, which adds the operation noun without the singularization applied to resource segments, and compare it with the Reports overrides in src/Reports/wrapper/Reports_cmdletConfigurations.cs. Survey how the v1.0 and beta naming data (parity-renames.v1.0.json and its beta counterpart) treat function nouns across the corpus. Done means a written rule or a list of deliberate exceptions, plus naming regression tests, and no change to the wire API, HTTP routes or builders.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Is your feature request related to a problem? Please describe the problem.
The v3 WrapperGenerator automatically singularizes resource path segments, but its action/function-segment branch adds the parsed operation noun directly, bypassing resource singularization. As a result, function-derived PowerShell nouns can retain plural endings unless an oracle-derived rename or curated module configuration corrects them.
Example from the Reports directive migration (#3870):
GET /reports/managedDeviceEnrollmentTopFailures()
Structural command: Get-MgReportManagedDeviceEnrollmentTopFailures
Intended command: Get-MgReportManagedDeviceEnrollmentTopFailure
The existing shared Reports.md directive specifies the singular ReportManagedDeviceEnrollmentTopFailure noun. Before this migration, v1.0 already received that name from an explicit entry in parity-renames.v1.0.json, while beta retained the structural plural because the committed derived naming data is v1.0-only. The shared Reports configuration now preserves the intended singular name in both profiles.
Describe the solution you'd like.
Investigate whether function-derived cmdlet nouns should be singularized automatically, consistently with resource-derived nouns, rather than requiring individual overrides for cases such as TopFailures → TopFailure.
Determine the correct rule before implementing it:
- Evaluate singularizing the appropriate noun portion of a function name, without rewriting the actual API function, HTTP route, Kiota builder, or wire parameters.
- Review corpus-wide effects in both v1.0 and beta, including meaningful plural names, irregular nouns, acronyms, parameterized overload suffixes, and possible command-name collisions.
- Check compatibility with published command names, shared AutoRest directive intent, and existing curated/oracle-derived overrides. Do not remove needed overrides merely because one example is addressed.
- Add naming regression coverage and document any deliberate exceptions if a general rule is adopted.
This issue is investigation only, not approval for a naming sweep. Whether action names need a similar rule should be assessed separately rather than assumed.
Additional context?
Raised during review of #3870. The user noted that function nouns should probably be singularized automatically and requested an issue marked as needing investigation.
Relevant source at the reviewed Reports PR head:
- Function-segment branch in CmdletNaming.cs
- Reports shared noun overrides
- Existing v1.0 oracle-derived TopFailure rename
No generator behavior or Reports configuration is changed as part of filing this issue.
- Ngôn ngữ chính
- C#
- Star
- 911
- Fork
- 236
- Merge trung bình
- 9 ngày 18 giờ
- Pull request đã merge (30 ngày)
- 33
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của microsoftgraph/msgraph-sdk-powershell
-
DirectoryObjects: drop the publicKeyInfrastructureRoot tag from the module mapping (v2)Có thể đã có người làm @gavinbarron đã nhận 8 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
microsoftgraph/msgraph-sdk-powershell#3752 · 1 reaction · 2 người được giao ·
Maintainer thường phản hồi trong vòng 7 ngày
-
status:waiting-for-triage type:bug
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 54/100
microsoftgraph/msgraph-sdk-powershell#3918 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 56/100
microsoftgraph/msgraph-sdk-powershell#3917 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
[v3 wrappers] Support arbitrary optional query parametersCó thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mởstatus:waiting-for-triage type:feature
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
microsoftgraph/msgraph-sdk-powershell#3897 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
Tracking for V3 UpgradeCó thể đã có người làm @ramsessanchez đã nhận 22 ngày trước. Đang mởtype:epic
microsoftgraph/msgraph-sdk-powershell#3874 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 7 ngày
Tất cả issue của microsoftgraph/msgraph-sdk-powershell
Issue tương tự
-
🐛 bug 🕒 low effort good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
guibranco/Sankhya-SDK-dotnet#654 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
a-corriger bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 86/100
christian-raj/S-Aloha#340 ·
-
遇到超大文件会卡住Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
Maintainer thường phản hồi trong vòng 4 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
microsoft/microsoft-ui-reactor#1626 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Triage:Untriaged Type:Bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 79/100