C++ OdooRPC

author: Gallay David

Goals

• lightweight
• minimal
• few dependencies (libcurl and std, that's all)
• but still simple

future developments

Only fix will be done here. For higher level library, see: OdooCpp which use this library and some other as nlohmann/json.

Use

1. Create a client

   const std::string URL = "my-url.com";
   const std::string DATABASE = "my-database";
   
   // Create Credentials
   Credentials creds("login", "password");
   
   OdooRPC client (
       URL,
       DATABASE,
       creds
   );

   could be written all-in-one

   OdooRPC client (
       "my-url.com",
       "my-database",
       {
       	"login",
       	"password"
       }
   );

   This will automatically authenticate the user and retrieve it's uid which is needed for most of the queries. The uid is related to the database, it is stored into the RPC client.

2. use raw_query method

   This will return the request body as a string. It could be parsed using any json library, for example nlohmann/json which is header-only.

   Knowing the follwing function in python exists:

   def search_read(self, domain=None, fields=None, offset=0, limit=None, order=None):
   	...

   We can use it so:

   std::cout << client.raw_query(
       "res.partner",
       "search_read",
       {
           "[]",                        // domain
           R"(["name", "user_id"])",    // fields
           0,                           // offset
           5                            // limit
       }
   ) << std::endl;

   It asks for fields "name" and "user_id" for the 5 first partners starting at offset 0 in the database with default order

   • Args are set in the same order as for the function in python.
   • Note the use of C++11 Raw-string-literals, params muse be given in json format

   We can also manually create our jsonrpc body if really needed