[IMP] Add support for JSON-2 API (Odoo >= 19.0 with API key)

[sebalix]

Address #101

What's changed with JSON-2 API enabled

• ODOO.login() now accepts a new keyword argument api_key, used only if Odoo >= 19.0. If set, login and password parameters will be ignored, and new ODOO.json2_ready property will return True, meaning the connection is using JSON-2 API.
• Positional arguments are automatically transformed into named parameters thanks to the new /doc-bearer/<model>.json endpoint which provides method signatures.
• new ODOO.json2_ready property can be used by users to detect if current connection is JSON-2 ready (and adapt RPC queries accordingly)

TODO :

• adapt odoorpc.db to use /web/database controllers

[Julien00859]

odoo.env["res.partner"].create({"name": "Joe"}) # /!\ DOESN'T WORK ANYMORE WITH JSON-2
odoo.env["res.partner"].create(vals_list={"name": "Joe"}) # Keyword arguments must be used

I could be a good idea to special-case the few CRUD (create, search, write, unlink) methods and to have an automatic rewrite positional -> keyword handled by the lib.

[sebalix]

@Julien00859 I was wondering the same indeed. At first it was a design to not implement methods client-side but browse, but it could be convenient at this point.

[Julien00859]

One last thing, you can download the technical documentation of every model through the /doc/<model_name>.json (session cookie) or /doc-bearer/<model_name>.json (http authentication header, with an API key), that technical documentation contains the exact signature of every method. When we updated¹ our own odoo-client-lib, we decided to download those documents to translate on-the-fly positional arguments to named one. I'm not saying you should do the same, I'm merely sharing our own experience migrating jsonrpc -> json2 🙂

Footnotes

1. https://github.com/odoo/odoo-client-lib/commit/2b5956025048f7e70f47b6ab72529ae1d1965509 ↩

[sebalix]

@Julien00859 nice! Good to know indeed

[sebalix]

@Julien00859 thank you for your input about /doc-bearer/<model>.json endpoint, there is no breaking change anymore in OdooRPC with this! (so no need to adapt the documentation and confuse users).