[META] 3.x release roadmap

Created on 2 September 2024, 5 months ago

Updated 21 September 2024, 4 months ago

Eventually there will be a 3.x release of this module. (No release date is set or promised.)

This meta issue tracks the issues that will be part of the 3.0 release. Any issue not listed here can be fixed and committed at any time;G the issues listed here will have to be part of 3.x since they break backwards compatibility.

Must haves

📌 Migrate from Doctrine annotations to PHP attributes Active : Core is moving to PHP attributes, we should too. This is the most important feature for 3.0. I (ptmkenny, writer of this roadmap and acting co-maintainer) do not know much about PHP attributes, so if anyone else wants to tackle this, that would be great.
📌 Add a test for jsonrpc_discovery that verifies the methods returned Active : testing is cool, and regressions are not
📌 Remove 2.x deprecations from 3.x Fixed

Nice to haves

✨ Service discovery functionality should implement OpenRPC spec Active
📌 Add types for properties and arguments Fixed and 📌 Add types for return functions Postponed : add types to all function arguments and return values to ensure we are getting what we expect. Some of the phpdoc types are currently wrong, so it would be nice to clean this up so that everything is correct.
📌 [PP] 'object' is a reserved keyword as of PHP version 7.2 and should not be used in namespaces Fixed : This is a backwards-compatibility-breaking change, so we should fix it in the 3.0 release.

Everyone is welcome to contribute. Suggestions for additional features/fixes are welcome in the comments.

3.0 compatibility breaks

Basically everything is typed now. If you are using strict types, you will need to make sure your custom JSON-RPC methods are properly typed. ( 📌 Add types for properties and arguments Fixed and 📌 Add types for return functions Postponed )
The Object directory was renamed JsonRpcObject. Anything that extends the classes in that directory will need to be renamed. ( 📌 [PP] 'object' is a reserved keyword as of PHP version 7.2 and should not be used in namespaces Fixed )

📌 Task

Status

Active

Version

3.0

Component

Miscellaneous

Created by

🇯🇵Japan ptmkenny

Live updates comments and jobs are added and updated live.

Comments & Activities

contrib.social Blog FAQ Discussions

Production build 0.71.5 2024