Skip to content

feat(IValidateComponent): update ToggleMessage return value as Task #6112

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

Merged
merged 5 commits into from
May 29, 2025

Conversation

ArgoZhang
Copy link
Member

@ArgoZhang ArgoZhang commented May 29, 2025

Link issues

fixes #6111

Summary By Copilot

Regression?

  • Yes
  • No

Risk

  • High
  • Medium
  • Low

Verification

  • Manual (required)
  • Automated

Packaging changes reviewed?

  • Yes
  • No
  • N/A

☑️ Self Check before Merge

⚠️ Please check all items below before review. ⚠️

  • Doc is updated/provided or not needed
  • Demo is updated/provided or not needed
  • Merge the latest code from the main branch

Summary by Sourcery

Convert validation message toggling to an asynchronous model by changing the ToggleMessage API to return Task and updating all related validation and error-handling methods to use async/await

Enhancements:

  • Change IValidateComponent.ToggleMessage to return Task and update its overrides to return Task.CompletedTask
  • Make SetError and InternalSetError methods asynchronous and await ToggleMessage
  • Propagate async ToggleMessage calls through ValidateObject, ValidateFieldAsync, ValidateProperty and component SetValue workflows

ArgoZhang added 5 commits May 29, 2025 09:58
# Conflicts:
#	src/BootstrapBlazor/Components/Validate/IValidateComponent.cs
#	src/BootstrapBlazor/Components/Validate/ValidateBase.cs
@bb-auto bb-auto bot added the enhancement New feature or request label May 29, 2025
Copy link
Contributor

sourcery-ai bot commented May 29, 2025

Reviewer's Guide

This PR refactors validation messaging to be fully asynchronous by changing ToggleMessage to return Task, updating SetError methods to async, and awaiting all ToggleMessage calls across validation and form components.

Sequence Diagram: Async ToggleMessage in ValidateForm.SetError

sequenceDiagram
    participant C as Caller
    participant VF as ValidateForm
    participant IVC as IValidateComponent

    C->>+VF: SetError(expression, errorMessage)
    Note over VF: Method signature changed to async Task
    VF->>+VF: await InternalSetError(exp, errorMessage)
    Note over VF: Method signature changed to async Task
    VF->>-IVC: await ToggleMessage(results)
    IVC-->>VF: Task (completed)
    VF-->>C: Task (completed)
Loading

Sequence Diagram: Async ToggleMessage Call in Validation Methods

sequenceDiagram
    participant S as System/Event Trigger
    participant VF as ValidateForm
    participant IVC as IValidateComponent

    S->>+VF: ValidateFieldAsync(context, results)
    Note over VF: (or ValidateObject, ValidateProperty)
    VF->>+IVC: await ToggleMessage(messages)
    IVC-->>-VF: Task (completed)
    VF-->>-S: Task (completed)
Loading

Updated Class Diagram for IValidateComponent and Asynchronous Validation

classDiagram
direction LR
class IValidateComponent {
    <<Interface>>
    +Task ToggleMessage(IReadOnlyCollection~ValidationResult~ results)
}
class ValidateBase~TValue~ {
    +Task ToggleMessage(IReadOnlyCollection~ValidationResult~ results)
}
ValidateBase --|> IValidateComponent

class UploadBase~TValue~ {
    +Task ToggleMessage(IReadOnlyCollection~ValidationResult~ results)
}
UploadBase --|> ValidateBase

class InputUpload {
    +Task ToggleMessage(IReadOnlyCollection~ValidationResult~ results)
}
InputUpload --|> UploadBase

class ValidateForm {
    +Task SetError~TModel~(Expression~Func~TModel, object~~ expression, string errorMessage)
    +Task SetError(string propertyName, string errorMessage)
    -Task InternalSetError(MemberExpression exp, string errorMessage)
    #Task ValidateObject(ValidationContext context, List~ValidationResult~ results)
    #Task ValidateFieldAsync(ValidationContext context, List~ValidationResult~ results)
    -Task ValidateProperty(ValidationContext context, List~ValidationResult~ results)
}
ValidateForm ..> IValidateComponent : uses

class MultiSelect {
    -Task SetValue()
}
MultiSelect --|> ValidateBase

class MultiSelectGeneric {
    -Task SetValue()
}
MultiSelectGeneric --|> ValidateBase

class Transfer {
    -Task TransferItems(List~SelectedItem~ source, List~SelectedItem~ target)
}
Transfer --|> ValidateBase
Loading

File-Level Changes

Change Details Files
Convert ToggleMessage to async Task in interface and implementations
  • Change IValidateComponent.ToggleMessage signature from void to Task
  • Update ValidateBase.ToggleMessage to return Task with Task.CompletedTask
  • Modify UploadBase and InputUpload overrides to return Task and include Task.CompletedTask
src/BootstrapBlazor/Components/Validate/IValidateComponent.cs
src/BootstrapBlazor/Components/Validate/ValidateBase.cs
src/BootstrapBlazor/Components/Upload/UploadBase.cs
src/BootstrapBlazor/Components/Upload/InputUpload.razor.cs
Make SetError methods in ValidateForm async and propagate awaits
  • Change SetError overloads to async Task
  • Convert InternalSetError to async Task
  • Await calls to InternalSetError and validator.ToggleMessage
src/BootstrapBlazor/Components/ValidateForm/ValidateForm.razor.cs
Await ToggleMessage in validation workflows
  • Add await before validator.ToggleMessage in ValidateObject and ValidateFieldAsync
  • Await ToggleMessage in ValidateProperty loops
src/BootstrapBlazor/Components/ValidateForm/ValidateForm.razor.cs
Update UI components to await validation messaging
  • Await ToggleMessage in MultiSelect.OnSetValue
  • Await ToggleMessage in MultiSelectGeneric.OnSetValue
  • Await ToggleMessage in Transfer.TransferItems
src/BootstrapBlazor/Components/Select/MultiSelect.razor.cs
src/BootstrapBlazor/Components/SelectGeneric/MultiSelectGeneric.razor.cs
src/BootstrapBlazor/Components/Transfer/Transfer.razor.cs

Assessment against linked issues

Issue Objective Addressed Explanation
#6111 Change the return value of the ToggleMessage method in IValidateComponent to Task to make it asynchronous.

Possibly linked issues


Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@bb-auto bb-auto bot added this to the v9.6.0 milestone May 29, 2025
@ArgoZhang ArgoZhang requested a review from Copilot May 29, 2025 02:11
Copy link

@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 ToggleMessage API to be asynchronous by changing its return type from void to Task and propagating async/await calls throughout the validation and upload components.

  • Updated ToggleMessage signatures in IValidateComponent, ValidateBase, UploadBase, and related component files
  • Modified SetError and validation workflows in ValidateForm and Transfer components to await ToggleMessage calls
  • Bumped the package version in BootstrapBlazor.csproj

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
src/BootstrapBlazor/Components/ValidateForm/ValidateForm.razor.cs Updated SetError and InternalSetError methods to use async/await with ToggleMessage calls
src/BootstrapBlazor/Components/Validate/ValidateBase.cs Changed virtual ToggleMessage to return Task and updated its implementation
src/BootstrapBlazor/Components/Validate/IValidateComponent.cs Modified interface method ToggleMessage to be asynchronous
src/BootstrapBlazor/Components/Upload/UploadBase.cs Updated ToggleMessage override to return Task with Task.CompletedTask return
src/BootstrapBlazor/Components/Upload/InputUpload.razor.cs Adjusted ToggleMessage implementation to be asynchronous
src/BootstrapBlazor/Components/Transfer/Transfer.razor.cs Changed ToggleMessage calls to be awaited in Transfer components
src/BootstrapBlazor/Components/SelectGeneric/MultiSelectGeneric.razor.cs Updated ToggleMessage call to await the asynchronous method
src/BootstrapBlazor/Components/Select/MultiSelect.razor.cs Changed ToggleMessage calls to asynchronous usage
src/BootstrapBlazor/BootstrapBlazor.csproj Bumped version from 9.6.5-beta03 to 9.7.0

Copy link

codecov bot commented May 29, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (a6167cd) to head (bc7da21).
Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #6112   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          703       703           
  Lines        31019     31022    +3     
  Branches      4386      4386           
=========================================
+ Hits         31019     31022    +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey @ArgoZhang - I've reviewed your changes and they look great!

Here's what I looked at during the review
  • 🟡 General issues: 1 issue found
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟢 Documentation: all looks good

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@ArgoZhang ArgoZhang merged commit 7065ff2 into main May 29, 2025
5 checks passed
@ArgoZhang ArgoZhang deleted the refactor-validate branch May 29, 2025 02:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

feat(IValidateComponent): update ToggleMessage return value as Task
1 participant