Contrib.social

Add validation constraints to core.entity_form_mode.*.*

Open on Drupal.org →
Created on 21 May 2024, about 1 month ago
Updated 27 June 2024, 3 days ago

Problem/Motivation

Form modes have 3 property paths that are not yet validatable:

vendor/bin/drush config:inspect --filter-keys=core.entity_form_mode.user.register --detail --list-constraints
➜  🤖 Analyzing…

 Legend for Data: 
  ✅❓  → Correct primitive type, detailed validation impossible.
  ✅✅  → Correct primitive type, passed all validation constraints.
 ---------------------------------------------------------------- --------- ------------- ------ --------------------------------------------------------------------------------------------- 
  Key                                                              Status    Validatable   Data   Validation constraints                                                                       
 ---------------------------------------------------------------- --------- ------------- ------ --------------------------------------------------------------------------------------------- 
  core.entity_form_mode.user.register                              Correct   79%           ✅❓   ValidKeys: '<infer>'                                                                         
   core.entity_form_mode.user.register:                            Correct   Validatable   ✅✅   ValidKeys: '<infer>'                                                                         
   core.entity_form_mode.user.register:_core                       Correct   Validatable   ✅✅   ValidKeys:                                                                                   
                                                                                                    - default_config_hash                                                                      
   core.entity_form_mode.user.register:_core.default_config_hash   Correct   Validatable   ✅✅   NotNull: {  }                                                                                
                                                                                                  Regex: '/^[a-zA-Z0-9\-_]+$/'                                                                 
                                                                                                  Length: 43                                                                                   
                                                                                                  ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:cache                       Correct   Validatable   ✅✅   ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:dependencies                Correct   Validatable   ✅✅   ValidKeys: '<infer>'                                                                         
   core.entity_form_mode.user.register:dependencies.module         Correct   NOT           ✅❓   ❌ @todo Add validation constraints to ancestor type: config_dependencies                    
   core.entity_form_mode.user.register:dependencies.module.0       Correct   Validatable   ✅✅   NotBlank: {  }                                                                               
                                                                                                  ExtensionName: {  }                                                                          
                                                                                                  ExtensionExists: module                                                                      
                                                                                                  ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:description                 Correct   Validatable   ✅✅   Regex:                                                                                       
                                                                                                    pattern: '/([^\PC\x09\x0a\x0d])/u'                                                         
                                                                                                    match: false                                                                               
                                                                                                    message: 'Text is not allowed to contain control characters, only visible characters.'     
                                                                                                  ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:id                          Correct   NOT           ✅❓   ⚠️  @todo Add validation constraints to config entity type: core.entity_form_mode.*.*        
   core.entity_form_mode.user.register:label                       Correct   Validatable   ✅✅   Regex:                                                                                       
                                                                                                    pattern: '/([^\PC])/u'                                                                     
                                                                                                    match: false                                                                               
                                                                                                    message: 'Labels are not allowed to span multiple lines or contain control characters.'    
                                                                                                  NotBlank: {  }                                                                               
                                                                                                  ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:langcode                    Correct   Validatable   ✅✅   NotNull: {  }                                                                                
                                                                                                  Choice:                                                                                      
                                                                                                    callback: 'Drupal\Core\TypedData\Plugin\DataType\LanguageReference::getAllValidLangcodes'  
                                                                                                  ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:status                      Correct   Validatable   ✅✅   ↣ PrimitiveType: {  }                                                                        
   core.entity_form_mode.user.register:targetEntityType            Correct   NOT           ✅❓   ⚠️  @todo Add validation constraints to config entity type: core.entity_form_mode.*.*        
   core.entity_form_mode.user.register:uuid                        Correct   Validatable   ✅✅   Uuid: {  }                                                                                   
                                                                                                  ↣ PrimitiveType: {  }                                                                        
 ---------------------------------------------------------------- --------- ------------- ------ ---------------------------------------------------------------------------------------------

Steps to reproduce

  1. Get a local git clone of Drupal core 11.x.
  2. composer require drupal/config_inspector — or manually install https://www.drupal.org/project/config_inspector/releases/2.1.5 → or newer (which supports Drupal 11!)
  3. composer require drush/drush
  4. vendor/bin/drush config:inspect --filter-keys=core.entity_form_mode.user.register --detail --list-constraints

Proposed resolution

Add validation constraints to:

  1. core.entity_form_mode.*.*:dependencies.module
  2. core.entity_form_mode.*.*:id
  3. core.entity_form_mode.*.*:targetEntityType

This requires looking at the existing code and admin UI (if any) to understand which values could be considered valid. Eventually this needs to be reviewed by the relevant subsystem maintainer.

For examples, search *.schema.yml files for the string constraints: 😊

Reach out to @borisson_ or @wimleers in the #distributions-and-recipes.

Remaining tasks

User interface changes

None.

API changes

None.

Data model changes

More validation 🚀

Release notes snippet

None.

📌 Task
Status

Needs work

Version

11.0 🔥

Component
Base  →

Last updated 23 minutes ago

Created by

🇮🇳India narendraR Jaipur, India

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

  • Issue created by @narendraR
  • Merge request !8135Config validation added → (Open) created by narendraR
  • Pipeline finished with Failed
    about 1 month ago
    Total: 700s
    #177826
  • Pipeline finished with Success
    about 1 month ago
    Total: 694s
    #178093
  • Pipeline finished with Success
    about 1 month ago
    Total: 567s
    #178982
  • Status changed to Needs review about 1 month ago
  • Comment about 1 month ago →
    🇮🇳India narendraR Jaipur, India
  • First commit to issue fork.
  • Status changed to RTBC about 1 month ago
  • Comment about 1 month ago →
    🇺🇸United States smustgrave

    Applied some nitpicky typehint return voids

    Applied the MR to a 11.x install using standard profile
    Believe the only entity_form_mode is for core.entity_form_mode.user.register
    Ran updb and hook ran without issue

    Manually downloaded config_inspector to 11.x setup and confirmed seeing fully validatable now

  • Pipeline finished with Success
    about 1 month ago
    Total: 671s
    #179348
  • Status changed to Needs work about 1 month ago
  • Comment about 1 month ago →
    🇬🇧United Kingdom catch

    One issue with the presave hook on the MR - missing a deprecation notice.

  • Pipeline finished with Failed
    about 1 month ago
    Total: 572s
    #180953
  • Pipeline finished with Failed
    about 1 month ago
    Total: 607s
    #183186
  • Pipeline finished with Failed
    about 1 month ago
    Total: 177s
    #183218
  • Pipeline finished with Success
    about 1 month ago
    Total: 562s
    #183223
  • Status changed to Needs review about 1 month ago
  • Comment about 1 month ago →
    🇮🇳India narendraR Jaipur, India
  • Status changed to Needs work about 1 month ago
  • Comment about 1 month ago →
    🇺🇸United States smustgrave

    Left some comments on MR.

  • Pipeline finished with Failed
    about 1 month ago
    Total: 187s
    #183780
  • Pipeline finished with Success
    about 1 month ago
    Total: 626s
    #183819
  • Status changed to Needs review about 1 month ago
  • Comment about 1 month ago →
    🇮🇳India narendraR Jaipur, India
  • Status changed to RTBC about 1 month ago
  • Comment about 1 month ago →
    🇺🇸United States smustgrave

    Deprecation appears to be correct to me.

  • Status changed to Needs work about 1 month ago
  • Comment about 1 month ago →
    🇬🇧United Kingdom catch

    One small comment on the deprecation message. Hard to fit this sort of thing into the standard format.

  • Pipeline finished with Success
    about 1 month ago
    Total: 537s
    #184322
  • Status changed to Needs review about 1 month ago
  • Comment about 1 month ago →
    🇮🇳India narendraR Jaipur, India
  • Status changed to RTBC about 1 month ago
  • Comment about 1 month ago →
    🇺🇸United States smustgrave

    Message seems good

  • Status changed to Needs review about 1 month ago
  • Comment about 1 month ago →
    🇦🇺Australia larowlan 🇦🇺🏝.au GMT+10

    Left one question on the MR, great work here - bit more involved with the update hook!

  • Pipeline finished with Success
    about 1 month ago
    Total: 545s
    #184678
  • Comment about 1 month ago →
    🇮🇳India narendraR Jaipur, India

    This issue is ready for re-review. I have added the return FALSE. Thanks

  • Status changed to Needs work about 1 month ago
  • Comment about 1 month ago →
    🇺🇸United States phenaproxima Massachusetts

    Looks okay but I have a couple of questions here.

  • Pipeline finished with Failed
    about 1 month ago
    Total: 634s
    #185834
  • Pipeline finished with Success
    about 1 month ago
    Total: 602s
    #185908
  • Pipeline finished with Success
    27 days ago
    Total: 543s
    #189663
  • Status changed to Needs review 27 days ago
  • Comment 27 days ago →
    🇮🇳India narendraR Jaipur, India
  • Status changed to Needs work 27 days ago
  • Comment 27 days ago →
    🇺🇸United States phenaproxima Massachusetts

    Only one tiny thing and then I think this looks good.

  • Pipeline finished with Canceled
    25 days ago
    Total: 102s
    #191374
  • Pipeline finished with Failed
    25 days ago
    Total: 548s
    #191375
  • Pipeline finished with Success
    25 days ago
    Total: 515s
    #191506
  • Status changed to Needs review 25 days ago
  • Comment 25 days ago →
    🇮🇳India narendraR Jaipur, India
  • Status changed to RTBC 20 days ago
  • Comment 20 days ago →
    🇺🇸United States smustgrave

    Applied MR on a standard install for 11.x with config inspector and getting all green checks.

    Looking at MR 8135 and from what I can tell all feedback has been addressed.

  • Pipeline finished with Success
    12 days ago
    Total: 507s
    #201781
  • Status changed to Needs work 3 days ago
  • Comment 3 days ago →
    🇬🇧United Kingdom alexpott 🇪🇺🌍

    If I go to admin/structure/display-modes/form/ and edit the user registration form and save the form mode with no description then the system_entity_form_mode_presave() will trigger a deprecation notice.

    We need to add something to the form to convert empty strings to NULLs... normally we'd say use #config_target but we've not worked out how to using #config_target like stuff with config entities yet.

contrib.social Blog FAQ Discussions
Production build 0.69.0 2024