odoo-easy 0.1.0

Lightweight Python wrapper for the Odoo XML-RPC API

odoo-easy

A lightweight Python wrapper for the Odoo XML-RPC API. Stop writing boilerplate — connect and query Odoo in 3 lines.

Installation

pip install odoo-easy

Quick Start

from odoo_connect import OdooClient

odoo = OdooClient("https://mycompany.odoo.com", "my-database")
odoo.login("[e-mail]", "your-password")

# List products
products = odoo.search_read("product.template", fields=["name", "list_price"])

Usage

Connect

from odoo_connect import OdooClient

odoo = OdooClient("https://mycompany.odoo.com", "my-database")
odoo.login("[e-mail]", "your-password")

Search records

# Get all IDs
ids = odoo.search("product.template")

# With filters
ids = odoo.search("product.template", filters=[["type", "=", "product"]])

# With limit
ids = odoo.search("product.template", limit=10)

Search and read in one call

products = odoo.search_read(
    "product.template",
    filters=[["sale_ok", "=", True]],
    fields=["name", "list_price", "categ_id"],
    limit=50
)
# Returns: [{"id": 1, "name": "My Product", "list_price": 99.0, ...}, ...]

Read by IDs

records = odoo.read("res.partner", ids=[1, 2, 3], fields=["name", "email"])

Create a record

new_id = odoo.create("product.template", {
    "name": "New Product",
    "list_price": 49.99,
    "type": "product",
})
print(f"Created product with ID: {new_id}")

Update records

odoo.write("product.template", ids=[1, 2, 3], values={
    "list_price": 59.99
})

Delete records

odoo.unlink("product.template", ids=[99])

Count records

total = odoo.count("product.template", filters=[["active", "=", True]])
print(f"Total active products: {total}")

Inspect model fields

fields = odoo.get_fields("product.template", attributes=["string", "type"])

Get server version

info = odoo.version()
print(info)  # {'server_version': '18.0', ...}

Error Handling

from odoo_connect import OdooClient, OdooAuthError, OdooError

try:
    odoo = OdooClient("https://mycompany.odoo.com", "my-database")
    odoo.login("[e-mail]", "badpassword")
except OdooAuthError as e:
    print(f"Authentication failed: {e}")
except OdooError as e:
    print(f"Odoo error: {e}")

Compatibility

• Python 3.8+
• Odoo 14, 15, 16, 17, 18

License

MIT