add: command 'doc'

Author: Tardo

_locales/en/translation.json

@@ -276,6 +276,14 @@
       "value": "Name/Value/Argument"
     }
   },
+  "cmdDoc": {
+    "args": {
+      "method": "The method name",
+      "model": "The model technical name"
+    },
+    "definition": "Open thecnical documentation page",
+    "detail": "Open thecnical documentation page."
+  },
   "cmdEffect": {
     "args": {
       "options": "The extra options to use",

_locales/es/translation.json

@@ -276,6 +276,14 @@
       "value": "Nombre/Valor/Argumento"
     }
   },
+  "cmdDoc": {
+    "args": {
+      "method": "El nombre del método",
+      "model": "El nombre técnico del modelo"
+    },
+    "definition": "Abre la página de documentación técnica",
+    "detail": "Abre la página de documentación técnica."
+  },
   "cmdEffect": {
     "args": {
       "options": "Las opciones adicionales para usar",

src/js/page/odoo/commands/backoffice/__all__.mjs

@@ -7,6 +7,7 @@ import cmdEffect from './effect';
 import cmdLang from './lang';
 import cmdSettings from './settings';
 import cmdView from './view';
+import cmdDoc from './doc';
 import type VMachine from '@trash/vmachine';
 
 export default function (vm: VMachine) {
@@ -15,4 +16,5 @@ export default function (vm: VMachine) {
   vm.registerCommand('lang', cmdLang());
   vm.registerCommand('action', cmdAction());
   vm.registerCommand('effect', cmdEffect());
+  vm.registerCommand('doc', cmdDoc());
 }

src/js/page/odoo/commands/backoffice/doc.mjs

@@ -0,0 +1,71 @@
+// @flow strict
+// Copyright  Alexandre Díaz <dev@redneboa.es>
+// License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+// $FlowIgnore
+import i18n from 'i18next';
+import cachedSearchRead from '@odoo/net_utils/cached_search_read';
+import getOdooVersion from '@odoo/utils/get_odoo_version';
+import {ARG} from '@trash/constants';
+import type {CMDCallbackArgs, CMDCallbackContext, CMDDef} from '@trash/interpreter';
+import type Terminal from '@terminal/terminal';
+
+async function cmdDoc(this: Terminal, kwargs: CMDCallbackArgs, ctx: CMDCallbackContext): Promise<void> {
+  const OdooVerMajor = getOdooVersion('major');
+  if (typeof OdooVerMajor === 'number' && OdooVerMajor < 19) {
+    // Soft-Error
+    ctx.screen.printError(
+      i18n.t('cmdDoc.error.incompatibleOdooVersion', 'This command is only available in Odoo 19.0+'),
+    );
+    return;
+  }
+
+  let pathname = '/doc';
+  if (kwargs.model) {
+    pathname += `/${kwargs.model}`;
+  }
+  if (kwargs.method) {
+    pathname += `#${kwargs.method}`;
+  }
+  window.location = `${window.location.origin}${pathname}`;
+}
+
+async function getOptions(this: Terminal, arg_name: string) {
+  if (arg_name === 'model') {
+    return cachedSearchRead(
+      'options_ir.model_active',
+      'ir.model',
+      [],
+      ['model'],
+      await this.getContext({active_test: true}),
+      undefined,
+      {orderBy: 'model ASC'},
+      item => item.model,
+    );
+  }
+  return [];
+}
+
+export default function (): Partial<CMDDef> {
+  return {
+    definition: i18n.t('cmdDoc.definition', 'Open thecnical documentation page'),
+    callback: cmdDoc,
+    options: getOptions,
+    detail: i18n.t('cmdDoc.detail', 'Open thecnical documentation page.'),
+    args: [
+      [
+        ARG.String,
+        ['m', 'model'],
+        false,
+        i18n.t('cmdDoc.args.model', 'The model technical name'),
+      ],
+      [
+        ARG.String,
+        ['me', 'method'],
+        false,
+        i18n.t('cmdDoc.args.method', 'The method name'),
+      ],
+    ],
+    example: '-m sale_management',
+  };
+}