OdooTerminal - WebExtension

The BFG10k for Odoo developers

All the power of Odoo json-rpc in a really easy way!

This web extension adds a terminal-like to control Odoo (11 to 19). All implemented commands use the tools provided by the Odoo framework. An unwavering policy when developing this extension is to not modify or alter in any way the Odoo classes. This sometimes results in certain commands having reduced/increased capabilities depending on the Odoo version.

The terminal is fully initialized when it is first opened after loading the page. The time overhead for using this extension is ~24ms.

Downloads

Usage

When you visit an Odoo website, the browser action icon of the extension switches to the enabled state, indicating that the extension is ready to use on the current page.

Some commands are not available on the frontend. Use the help command to see what is available in the current context.

The terminal also includes an AI mode (autonomous agent) accessible via the AI button in the terminal toolbar.

You can toggle terminal using one of these options:

• Press CTRL + , (by default)
• Use extension browser action icon

Example Commands

A list is a string of values separated by commas, e.g. "5, 15, 8" (quotes included), or the array notation [5, 15, 8].

Commands can be called without named arguments, e.g.: create res.partner {name: 'Hipcut', street: 'Mystery street'}. Positional arguments fill values in the order they are defined. Mixing positional and named arguments is supported as long as the declaration order is respected.

Notes

• The extension includes a Preferences page where you can add commands to run on every session. This is useful for loading remote scripts or declaring custom aliases.
• The extension uses an internal terminal context that extends the user context. By default it sets active_test = false (see issue #14 for details). This context only affects terminal operations.
• The screen buffer is capped at 750 lines. Queries returning more than 749 records will be truncated. This limit exists to prevent excessive DOM node accumulation when rendering output as HTML.
• Keyboard shortcuts can be remapped at chrome://extensions/shortcuts.

Advance Usage

+ HELPERS

The following are available:

Examples:

• search $$RMOD
• write $$RMOD $$RID {name: 'The new name'}

+ Recordsets

search, read and create commands returns recordsets. Can use them to write values with commit command.

Example:

$rs = (search res.partner)
$rs[4]['name'] = 'The Name'
$rs[2]['name'] = 'Other Name'
commit $rs

$record = (read res.partner 8)
$record['name'] = 'Willy Wonka'
$record['city'] = 'O Courel'
commit $record

$new_rec = (create res.partner {name: 'The test'})
print $new_rec

+ Nested Calls

You can execute "commands" to use the result in a new command call. The syntax of 'nested calls' looks like (command).

For example: read -m res.users -i (search -m res.users -f id)[0]['id'] or read -m res.users -i (search -m res.users -f id)['ids']

+ Loops

Massive operations are possible using for loops. Print to screen is a expensive task, consider use the keyword silent to increase the performance.

Examples:

• Create 5000 res.partner:{ for ($i = 0; $i < 5000; $i += 1) { silent create -m res.partner -v {name: (gen str 12 8) + ' (Test)'} }
• Cancel all sale.order: $orders = (search sale.order); for ($i = 0; $i < $orders['length']; $i += 1) { silent call sale.order action_cancel [$orders[$i]['id']] }

+ Send files

Can use the command 'genfile' to create a file object that can be sent via post.

Example:

• post '/web/binary/upload_attachment' -d {callback: '', model: 'res.partner', id: 1, ufile: (genfile)}

+ Websockets

Can open websocket connections (Odoo 16.0+).

Example:

• $webs = (ws -o open -e /websocket)
  ws -o send -wo $webs -d "hello"
  

+ Math operations

Examples:

• Print 3*2 result: print 3 * 2
• Modify the lst_price of the 3,product.product: $prod = (read product.product 3 -f lst_price); $prod['lst_price'] = 5 * $prod['lst_price']; commit $prod;

+ If, Elif, Else

Example:

• if ((gen int 0 8) > 2) { print 'Yussef Dayes & Alfa Mist - Blacked Out' } else { print 'Vincenzo Salvia & PJ D\'Atri - The Elemental Dive' }
• $num = (gen int 0 8); if ($num > 2) { print 'Yes! ' + $num + ' > 2' } else { print 'No... ' + $num + ' <= 2' }
• $num = (gen int 0 8); if ($num > 4) { print 'Yes! ' + $num + ' > 4' } elif ($num > 2) { print 'Yes! ' + $num + ' > 2' } else { print 'No... ' + $num + ' <= 2' }

+ Functions

Example:

• function myfun(user_name) { print "Hello, " + $user_name }; myfun 'world!'
• $myfun = function (user_name) { print "Hello, " + $user_name }; $$myfun 'world!'

Extension Permissions

More Resources

• CHANGELOG
• Contributing
• Developing
• Testing
• TraSH
• Translations

License

Copyright Alexandre Díaz & contributors

AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)

This project is not affiliated with, endorsed by, or sponsored by Odoo S.A. Odoo is a trademark of Odoo S.A.