This is an Odoo client library for Python with support for the OpenStack Integration add-on, intended to be used by OpenStack projects such as Distil.

This library provides a higher level interface than OdooRPC (which is used internally), and is intended to make it possible to develop applications against a well-defined API, without having to take into account considerations such as backward-incompatible changes between Odoo versions.

The OpenStack Odoo Client library supports Python 3.10 and later.

To install the library package, simply install the openstack-odooclient package using pip.

python -m pip install openstack-odooclient

To connect to an Odoo server, create an openstack_odooclient.Client object and pass the connection details to it.

openstack_odooclient.Client( *, hostname: str, database: str, username: str, password: str, protocol: str="jsonrpc", port: int=8069, verify: bool|str|Path=True, version: str|None=None, ) ->Client

This is the recommended way of creating the Odoo client object, as it provides some extra parameters for convenience.

fromopenstack_odooclientimportClientasOdooClientodoo_client=OdooClient( hostname="localhost", database="odoodb", user="test-user", password="<password>", protocol="jsonrpc", # HTTP, or "jsonrpc+ssl" for HTTPS.port=8069, # verify=True, # Enable/disable SSL verification, or pass the path to a CA certificate.# version="14.0", # Optionally specify the server version. Default is to auto-detect. )

If you have a pre-existing odoorpc.ODOO connection object, that can instead be passed directly into openstack_odooclient.Client.

openstack_odooclient.Client(*, odoo: odoorpc.ODOO) ->Client

This allows for sharing a single OdooRPC connection object with other code.

fromodoorpcimportODOOfromopenstack_odooclientimportClientasOdooClientodoo=ODOO( host="localhost", port=8069, protocol="jsonrpc", # HTTP, or "jsonrpc+ssl" for HTTPS.# version="14.0", # Optionally specify the server version. Default is to auto-detect. ) odoo.login("odoodb", "test-user", "<password>") odoo_client=OdooClient(odoo=odoo)

The Odoo client object exposes a number of record managers, which contain methods used to query specific record types, or create one or more new records of that type.

For example, performing a simple search query would look something like this:

>>>fromopenstack_odooclientimportClientasOdooClient>>>odoo_client=OdooClient( ... hostname="localhost", ... port=8069, ... protocol="jsonrpc", ... database="odoodb", ... user="test-user", ... password="<password>", ... ) >>>odoo_client.users.search([("id", "=", odoo_client.user_id)], as_id=True) [1234]

For more information on the available managers and their functions, check the Managers page in the documentation.

Record manager methods return record objects for the corresponding model in Odoo.

Record fields can be accessed as attributes on these record objects. The record classes are fully type hinted, allowing IDEs and validation tools such as Mypy to verify that your application is using the fields correctly.

>>>fromopenstack_odooclientimportClientasOdooClient, User>>>user: User|None=None>>>odoo_client=OdooClient( ... hostname="localhost", ... port=8069, ... protocol="jsonrpc", ... database="odoodb", ... user="test-user", ... password="<password>", ... ) >>>user=odoo_client.users.get(1234) >>>userUser(record={'id': 1234, ...}, fields=None) >>>user.id1234

For more information on the available managers and their functions, check the Records section in the documentation.