74361[TASK] Properly deprecate the check for the SiteLanguageAwareTrait
Commit message
Review
-
Code review CR +2 Done
- Stefan Bürk +2
- Oliver Hader +1
- Simon Schaufelberger +1
-
Verified V +2 Done
- Stefan Bürk +2
- Oliver Hader +1
- core-ci +1 CI
Issues 2
Files 2
Review log 4454
Show 2429 earlier messages
-
Oliver Klee uploaded patch set 1 04/20/22, 12:22
-
core-ci voted on patch set 1 V -1 04/20/22, 12:32 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26229
-
Oliver Klee marked it work in progress 04/20/22, 12:53
-
Oliver Klee uploaded patch set 2 04/20/22, 14:20
-
Oliver Klee marked it ready for review 04/20/22, 14:20
-
core-ci voted on patch set 2 V +1 04/20/22, 14:33 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26235
-
Oli Bartsch commented on patch set 2 04/20/22, 14:43
Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:20We should add the purpose here as well "using the SiteLanguageAwareTrait for ..."Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:22Could we please add corresponding sections "Affected installations" and "Migration"? The latter might contain a code example. -
Oliver Klee commented on patch set 2 04/20/22, 14:49
Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:12ReplyAckDeprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:20ReplyAckDeprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:22ReplyAck -
Oliver Klee marked it work in progress 04/20/22, 14:49
-
Oliver Klee uploaded patch set 3 04/22/22, 10:18
-
Oliver Klee commented on patch set 2 04/22/22, 10:18
This change is ready for review.Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:12ReplyDone.Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:20ReplyDone.Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:22ReplyDone. -
Oliver Klee marked it ready for review 04/22/22, 10:18
-
core-ci voted on patch set 3 V +1 04/22/22, 10:30 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26294
-
Stefan Bürk commented on patch set 3 04/22/22, 16:34
Deprecated in v12, removal in v13. So no backport of this. The comment in v11 is good enough and need no change at all.AspectFactory.php:120Should we not add a proper `trigger_error('deprected', E_USER_DEPRECATED)` with proper message here ? -
Nikita Hovratov uploaded patch set 4 04/22/22, 19:31
-
Nikita Hovratov commented on patch set 4 04/22/22, 19:32
Added the deprecation trigger and emphasized, that the trait is internal and should not be used in user extensions.Reply
DoneAspectFactory.php:120ReplyDone -
core-ci voted on patch set 4 V +1 04/22/22, 19:40 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26318
-
Oliver Klee commented on patch set 4 CR +1 04/22/22, 19:53
Thanks, Nikita! -
Stefan Bürk commented on patch set 4 04/24/22, 19:44
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56Using `use SiteLanguageAwareTrait;` is valid to get the functionality in, if not implenting the interface methods directly. I think we should state that properly, that either implement the methods OR using the trait is okay (as long as the Inteface is implemented. Eventually emphasizes with a dedicated _note block to make that clear. -
Nikita Hovratov commented on patch set 4 04/24/22, 19:47
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56ReplyI removed the recommendation for the trait as it is marked as @internal. Not sure if it is necessary in the end and we can open it for public API. -
Oli Bartsch commented on patch set 4 04/25/22, 08:53
AspectFactory.php:124I think this message is a bit misleading now, since no information is given, regarding what stops working in v13. -
Oliver Klee commented on patch set 5 04/25/22, 14:30
Published edit on patch set 4. -
Oliver Klee commented on patch set 5 04/25/22, 14:30
AspectFactory.php:124ReplyDone -
Oliver Klee voted on patch set 5 CR +1 04/25/22, 14:30
-
core-ci voted on patch set 5 V +1 04/25/22, 14:37 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26401
-
Oliver Klee commented on patch set 5 04/25/22, 14:51
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56ReplyDone -
Nikita Hovratov uploaded patch set 6 04/25/22, 15:20
-
Nikita Hovratov commented on patch set 6 04/25/22, 15:21
Added full migration example and wrapping of deprecation text. -
Oliver Klee commented on patch set 6 CR +1 04/25/22, 15:21
Thanks, Nikita!
-
core-ci voted on patch set 6 V +1 04/25/22, 15:32 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26406
-
Nikita Hovratov voted on patch set 6 V +1 CR +1 04/25/22, 15:33
-
Oliver Klee rebased onto patch set 7 05/05/22, 07:50
-
core-ci voted on patch set 7 V +1 05/05/22, 08:00 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/26872
-
Oliver Hader commented on patch set 7 05/05/22, 12:56
I guess we can directly remove the trait (breaking) and add a corresponding RST for it, can't we? -
Oliver Klee commented on patch set 7 05/05/22, 12:59
Reply
No, we cannot yet (if I'm not mistaken)): The trait (as a marker) was not properly deprecated in V11 (which we now are doing for V12). So the first time we can remove it is for V13. -
Nikita Hovratov voted on patch set 7 V +1 CR +1 05/05/22, 17:05
-
Simon Schaufelberger commented on patch set 7 CR -1 05/11/22, 11:37
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56don't we use PSR2 in docs as well? -
Oliver Klee commented on patch set 8 05/11/22, 11:43
Published edit on patch set 7. -
Oliver Klee commented on patch set 8 05/11/22, 11:44
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56ReplyDone -
core-ci voted on patch set 8 V -1 05/11/22, 11:45 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/27114
-
Stefan Bürk commented on patch set 8 05/11/22, 11:53
Reply
The point is, if we want to deprecate/remove the trait at all - here it is depreacted to be used as "marker" for something. If class switches to the interface, the trait can be still used to share the same code. If I'm not wrong, core uses the trait along with the interface to use new registration but share the code. Or am I wrong ? Maybe we should decide to deprectate the trait at all, which means that classes have to be adjusted not using the trait.Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:45Missing "class" in front is a hard error as this is invalid code then. ``` class MyClass ```Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56ReplyI think normally it should be PSR2 - maybe done to spare one line in example. However, missing "class" in front is a hard error as this is invalid code then. ``` class MyClass implements .... ``` -
Stefan Bürk rebased onto patch set 9 05/11/22, 11:53
-
Stefan Bürk commented on patch set 9 05/11/22, 11:54
> Patch Set 8: Verified-1 > > Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/27114 Rebase missing (enforcing pinned dind-image) .. thus the completly fail of the pipeline. Rebased to mitigate this. -
core-ci voted on patch set 9 V +1 05/11/22, 12:00 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/27115
-
Oliver Klee commented on patch set 10 05/11/22, 12:12
Published edit on patch set 9. -
Oliver Klee commented on patch set 10 05/11/22, 12:13
Deprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:45ReplyDoneDeprecation-97435-UsageOfSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:56ReplyDone -
core-ci voted on patch set 10 V +1 05/11/22, 12:21 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/27117
-
Simon Schaufelberger voted on patch set 10 CR +1 05/11/22, 12:22
-
Oliver Klee commented on patch set 10 05/11/22, 12:22
I think there has been an misunderstanding: The point of this patch is to only deprecate using the trait without the interface, but not deprecating the trait. (Or in other words, deprecate properly what was already semi-deprecated.) :-) @Olly, do you have plans to deprecate the trait? Or are you fine with this approach? -
Oliver Hader commented on patch set 10 V +1 CR +1 05/30/22, 07:15
Reply
Sorry, I also have not been precise on that topic: 1) I never planned to remove the trait 2) I suggested to remove the USAGE of the trait in given class, since the trait implementation is @internal -
Oliver Hader commented on patch set 10 05/30/22, 07:21
An additional check via extension scanner still might be useful to detect these trait usages... however it does not look like the AST-component currently would support it -
Stefan Bürk voted on patch set 10 V +2 CR +2 06/03/22, 15:31
-
Stefan Bürk commented on patch set 10 06/03/22, 15:31
Reply
Done -
Stefan Bürk merged patch set 11 06/03/22, 15:32
Deprecation-97435-DeprecateSiteLanguageAwareTraitToDenoteSiteLanguageAwareness.rst:12