odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/developer/reference/backend/module.md

@@ -0,0 +1,159 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/developer/reference/backend/module.html"
+---
+
+# 
+# Module Manifests
+
+
+
+.. _reference/module/manifest:
+
+# Manifest
+
+The manifest file serves to declare a python package as an Odoo module
+and to specify module metadata.
+
+It is a file called `__manifest__.py` and contains a single Python
+dictionary, where each key specifies module metadatum.
+
+::
+
+    {
+        'name': "A Module",
+        'version': '1.0',
+        'depends': ['base'],
+        'author': "Author Name",
+        'category': 'Category',
+        'description': """
+        Description text
+        """,
+        # data files always loaded at installation
+        'data': [
+            'views/mymodule_view.xml',
+        ],
+        # data files containing optionally loaded demonstration data
+        'demo': [
+            'demo/demo_data.xml',
+        ],
+    }
+
+Available manifest fields are:
+
+`name` (`str`, required)
+    the human-readable name of the module
+`version` (`str`)
+    this module's version, should follow `semantic versioning`_ rules
+`description` (`str`)
+    extended description for the module, in reStructuredText
+`author` (`str`)
+    name of the module author
+`website` (`str`)
+    website URL for the module author
+`license` (`str`, defaults: `LGPL-3`)
+    distribution license for the module.
+    Possible values:
+
+    * `GPL-2`
+    * `GPL-2 or any later version`
+    * `GPL-3`
+    * `GPL-3 or any later version`
+    * `AGPL-3`
+    * `LGPL-3`
+    * `Other OSI approved licence`
+    * `OEEL-1` (Odoo Enterprise Edition License v1.0)
+    * `OPL-1` (Odoo Proprietary License v1.0)
+    * `Other proprietary`
+
+`category` (`str`, default: `Uncategorized`)
+    classification category within Odoo, rough business domain for the module.
+
+    Although using `existing categories`_ is recommended, the field is
+    freeform and unknown categories are created on-the-fly. Category
+    hierarchies can be created using the separator `/` e.g. `Foo / Bar`
+    will create a category `Foo`, a category `Bar` as child category of
+    `Foo`, and will set `Bar` as the module's category.
+`depends` (`list(str)`)
+    Odoo modules which must be loaded before this one, either because this
+    module uses features they create or because it alters resources they
+    define.
+
+    When a module is installed, all of its dependencies are installed before
+    it. Likewise dependencies are loaded before a module is loaded.
+
+> **note**:
+>     Module `base` is always installed in any Odoo instance.
+    But you still need to specify it as dependency to make sure your module is updated when `base` is updated.
+
+`data` (`list(str)`)
+    List of data files which must always be installed or updated with the
+    module. A list of paths from the module root directory
+`demo` (`list(str)`)
+    List of data files which are only installed or updated in *demonstration
+    mode*
+`auto_install` (`bool` or `list(str)`, default: `False`)
+    If `True`, this module will automatically be installed if all of its
+    dependencies are installed.
+
+    It is generally used for "link modules" implementing synergetic integration
+    between two otherwise independent modules.
+
+    For instance `sale_crm` depends on both `sale` and `crm` and is set
+    to `auto_install`. When both `sale` and `crm` are installed, it
+    automatically adds CRM campaigns tracking to sale orders without either
+    `sale` or `crm` being aware of one another.
+
+    If it is a list, it must contain a subset of the dependencies. This module will automatically be
+    installed as soon as all the dependencies in the subset are installed. The remaining
+    dependencies will be automatically installed as well. If the list is empty, this module will
+    always be automatically installed regardless of its dependencies and these will be installed as
+    well.
+
+`external_dependencies` (`dict(key=list(str))`)
+    A dictionary containing python and/or binary dependencies.
+
+    For python dependencies, the `python` key must be defined for this
+    dictionary and a list of python modules to be imported should be assigned
+    to it.
+
+    For binary dependencies, the `bin` key must be defined for this
+    dictionary and a list of binary executable names should be assigned to it.
+
+    The module won't be installed if either the python module is not installed
+    in the host machine or the binary executable is not found within the
+    host machine's PATH environment variable.
+`application` (`bool`, default: `False`)
+    Whether the module should be considered as a fully-fledged application
+    (`True`) or is just a technical module (`False`) that provides some
+    extra functionality to an existing application module.
+`assets` (`dict`)
+    A definition of how all static files are loaded in various assets bundles.
+    See the :ref:`assets <reference/assets>` page for more details on how to
+    describe bundles.
+`installable` (`bool` default: `True`)
+    Whether a user should be able to install the module from the Web UI or not.
+`maintainer` (`str`)
+    Person or entity in charge of the maintenance of this module, by default
+    it is assumed that the author is the maintainer.
+`{pre_init, post_init, uninstall}_hook` (`str`)
+    Hooks for module installation/uninstallation, their value should be a
+    string representing the name of a function defined inside the module's
+    `__init__.py`.
+
+    `pre_init_hook` takes a cursor as its only argument, this function is
+    executed prior to the module's installation.
+
+    `post_init_hook` takes a cursor and a registry as its arguments, this
+    function is executed right after the module's installation.
+
+    `uninstall_hook` takes a cursor and a registry as its arguments, this
+    function is executed after the module's uninstallation.
+
+    These hooks should only be used when setup/cleanup required for this module
+    is either extremely difficult or impossible through the api.
+`active` (`bool`)
+    Deprecated. Replaced by `auto_install`.
+
+.. _semantic versioning: https://semver.org
+.. _existing categories: {GITHUB_PATH}/odoo/addons/base/data/ir_module_category_data.xml

package/payload/skills/odoo18-docs/references/docs/developer/reference/backend/orm/changelog.md

@@ -0,0 +1,109 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/developer/reference/backend/orm/changelog.html"
+---
+
+.. _reference/orm/changelog:
+# 
+# Changelog
+
+# Odoo version 18.0
+
+- Searching by name is now implemented as `_search_display_name` like all other fields.
+  See [#174967 ](https://github.com/odoo/odoo/pull/174967).
+- New methods to check access rights and rules now combine both access rights
+  and rules: `check_access`, `has_access` and `_filtered_access`.
+  See [#179148 ](https://github.com/odoo/odoo/pull/179148).
+- Translations are made available from the `Environment` with [#174844 ](https://github.com/odoo/odoo/pull/174844).
+
+
+# Odoo Online version 17.4
+
+- The internal operator `inselect` is removed. The alternative is to use `in`
+  with a Query or SQL object. [#171371 ](https://github.com/odoo/odoo/pull/171371).
+
+
+# Odoo Online version 17.3
+
+- We can now group by date parts numbers in `read_group`, `_read_group` and domains with [#159528 ](https://github.com/odoo/odoo/pull/159528).
+
+
+# Odoo Online version 17.2
+
+- The :attr:`group_operator` attribute of :class:`~odoo.fields.Field` is renamed into
+  :attr:`aggregator` with [#127353 ](https://github.com/odoo/odoo/pull/127353).
+- We can now group/aggregate/order by related no-store field with
+  [#127353 ](https://github.com/odoo/odoo/pull/127353).
+
+# Odoo Online version 17.1
+
+- Method :meth:`~odoo.models.Model._flush_search` has been deprecated with
+  [#144747 ](https://github.com/odoo/odoo/pull/144747).
+  The flushing of fields is now done by :meth:`~odoo.api.Environment.execute_query`,
+  and is based on metadata put in the :class:`~odoo.tools.SQL` object by
+  :meth:`~odoo.models.BaseModel._search` and other low-level ORM methods that
+  build such objects.  Those methods are also responsible for checking the access
+  rights on the fields that are used in the SQL object.
+
+# Odoo version 17.0
+
+- Introduce an :class:`~odoo.tools.SQL` wrapper object to make SQL composition
+  easier and safer with respect to SQL injections. Methods of the ORM now use it
+  internally. Introduced by [#134677 ](https://github.com/odoo/odoo/pull/134677).
+
+# Odoo Online version 16.4
+
+- Method :meth:`~odoo.models.Model.name_get` has been deprecated with
+  [#122085 ](https://github.com/odoo/odoo/pull/122085).
+  Read field `display_name` instead.
+
+# Odoo Online version 16.3
+
+- Method :meth:`~odoo.models.Model._read_group` has a new signature with
+  [#110737 ](https://github.com/odoo/odoo/pull/110737)
+
+# Odoo Online version 16.2
+
+- Refactor the implementation of searching and reading methods to be able to
+  combine both in a minimal number of SQL queries. We introduce two new methods
+  :meth:`~odoo.models.Model.search_fetch` and :meth:`~odoo.models.Model.fetch`
+  that take advantage of the combination. More details can be found on the pull
+  request [#112126 ](https://github.com/odoo/odoo/pull/112126).
+
+# Odoo version 16.0
+
+- Translations for translated fields are stored as JSONB values with
+  [#97692 ](https://github.com/odoo/odoo/pull/97692)
+  and [#101115 ](https://github.com/odoo/odoo/pull/101115).
+  Code translations are no longer stored into the database.
+  They become static and are extracted from the PO files when needed.
+- :meth:`~odoo.models.Model.search_count` takes the :attr:`limit` argument into account with [#95589 ](https://github.com/odoo/odoo/pull/95589).
+  It limits the number of records to count, improving performance when a partial result is acceptable.
+
+# Odoo Online version 15.4
+
+- New API for flushing to the database and invalidating the cache with
+  [#87527 ](https://github.com/odoo/odoo/pull/87527).
+  New methods have been added to `odoo.models.Model` and `odoo.api.Environment`,
+  and are less confusing about what is actually done in each case.
+  See the section :ref:`SQL Execution <reference/orm/sql>`.
+
+# Odoo Online version 15.3
+
+- The argument `args` is renamed to `domain` for :meth:`~odoo.models.Model.search`, :meth:`~odoo.models.Model.search_count`
+  and :meth:`~odoo.models.Model._search`. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+- :meth:`~odoo.models.Model.filtered_domain` conserves the order of the current recordset. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+- :meth:`~odoo.models.Model.browse` does not accept :class:`str` as `ids`. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+- The methods :meth:`~odoo.models.Model.fields_get_keys` and :meth:`~odoo.models.Model.get_xml_id` on :class:`~odoo.models.Model` are deprecated. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+- The method :meth:`~odoo.models.Model._mapped_cache` is removed. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+- Remove the :attr:`limit` attribute of :class:`~odoo.fields.One2many` and :class:`~odoo.fields.Many2many`. [#83687 ](https://github.com/odoo/odoo/pull/83687)
+
+# Odoo Online version 15.2
+
+- Specific index types on fields:  With [#83274 ](https://github.com/odoo/odoo/pull/83274) and
+  [#83015 ](https://github.com/odoo/odoo/pull/83015), developers can now define what type of
+  indexes can be used on fields by PostgreSQL. See the :ref:`index property <reference/fields>` of
+  `odoo.fields.Field`.
+- The :attr:`_sequence` attribute of :class:`~odoo.models.Model` is removed. Odoo lets PostgreSQL use the default sequence of the primary key. [#82727 ](https://github.com/odoo/odoo/pull/82727)
+- The method :meth:`~odoo.models.Model._write` does not raise an error for non-existing records. [#82727 ](https://github.com/odoo/odoo/pull/82727)
+- The :attr:`column_format` and :attr:`deprecated` attributes of :class:`~odoo.fields.Field` are removed. [#82727 ](https://github.com/odoo/odoo/pull/82727)