~openerp-community/openobject-doc/ksa-openobject-doc-6.0

.. i18n: Take care with default values for arguments: they are only evaluated once when the module is loaded and then used at each call. This means that if you use a mutable object as default value, and then modify that object, at the next call you will receive the modified object as default argument value. This applies to dict and list objects which are very often used as default values. If you want to use such objects as default value, you must either ensure that they won't be modified or use another default value (such as None) and test it. For example:

Take care with default values for arguments: they are only evaluated once when the module is loaded and then used at each call. This means that if you use a mutable object as default value, and then modify that object, at the next call you will receive the modified object as default argument value. This applies to dict and list objects which are very often used as default values. If you want to use such objects as default value, you must either ensure that they won't be modified or use another default value (such as None) and test it. For example:

.. i18n: .. code-block:: python

.. i18n:

.. i18n: def foo(a=None):

.. i18n:

.. i18n: if a is None:

.. i18n:

.. i18n: a=[]

.. i18n:

.. i18n: # ...

.. code-block:: python

def foo(a=None):

if a is None:

a=[]

# ...

.. i18n: This is what is [in the Python documentation]. In addition it is good practice to avoid modifying objects that you receive as arguments if it is not specified. If you want to do so, prefer to copy the object first. A list can easily be copied with the syntax

This is what is [in the Python documentation]. In addition it is good practice to avoid modifying objects that you receive as arguments if it is not specified. If you want to do so, prefer to copy the object first. A list can easily be copied with the syntax

.. i18n: copy = original[:]

copy = original[:]

.. i18n: A lot of other objects, such as dict, define a copy method.

A lot of other objects, such as dict, define a copy method.

.. i18n: File names

.. i18n: -----------

File names

-----------

.. i18n: The structure of a module should be like this::

.. i18n:

.. i18n: /module/

.. i18n:

.. i18n: /__init__.py

.. i18n: /__terp__.py

.. i18n: /module.py

.. i18n: /module_other.py

.. i18n: /module_view.xml

.. i18n: /module_wizard.xml

.. i18n: /module_report.xml

.. i18n: /module_data.xml

.. i18n: /module_demo.xml

.. i18n: /wizard/

.. i18n: /__init__.py

.. i18n: /wizard_name.py

.. i18n:

.. i18n: /report/

.. i18n:

.. i18n: /__init__.py

.. i18n: /report_name.sxw

.. i18n: /report_name.rml

.. i18n: /report_name.py

The structure of a module should be like this::

/module/

/__init__.py

/__terp__.py

100

/module.py

101

/module_other.py

102

/module_view.xml

103

/module_wizard.xml

104

/module_report.xml

105

/module_data.xml

106

/module_demo.xml

107

/wizard/

108

/__init__.py

109

/wizard_name.py

110

111

/report/

112

113

/__init__.py

114

/report_name.sxw

115

/report_name.rml

116

/report_name.py

117

118

.. i18n: Naming conventions

119

.. i18n: ------------------

120

121

122

Naming conventions

123

------------------

124

125

.. i18n: * modules: modules must be written in lower case, with underscores. The name of the module is the name of the directory in the addons path of the server. If the module depends on other modules, you can write several module names separated by underscores, starting by the most important name. Example:

126

.. i18n: + sale

127

.. i18n: + sale_commission

128

.. i18n:

129

.. i18n: * objects: the name of an object must be of the form name_of_module.name1.name2.name3.... The namei part of the object must go from the most important name to the least important one, from left to right, in lower case. Try not to use plurals in object names and to avoid shortcuts in the names. Example:

130

.. i18n: + sale.order

131

.. i18n: + sale.order.line

132

.. i18n: + sale.shop

133

.. i18n: + sale_commission.commission.rate

134

.. i18n:

135

.. i18n: * fields: field must be in lowercase, separated by underscores. Try to use commonly used names for fields: name, state, active, partner_id, eso. Conventions for the field name depends on the field type:

136

.. i18n: + many2one: must end by '_id' (eg: partner_id, order_line_id)

137

.. i18n: + many2many: must end by '_ids' (eg: category_ids)

138

.. i18n: + one2many: must end by '_ids' (eg: line_ids

139

140

141

* modules: modules must be written in lower case, with underscores. The name of the module is the name of the directory in the addons path of the server. If the module depends on other modules, you can write several module names separated by underscores, starting by the most important name. Example:

142

+ sale

143

+ sale_commission

144

145

* objects: the name of an object must be of the form name_of_module.name1.name2.name3.... The namei part of the object must go from the most important name to the least important one, from left to right, in lower case. Try not to use plurals in object names and to avoid shortcuts in the names. Example:

146

+ sale.order

147

+ sale.order.line

148

+ sale.shop

149

+ sale_commission.commission.rate

150

151

* fields: field must be in lowercase, separated by underscores. Try to use commonly used names for fields: name, state, active, partner_id, eso. Conventions for the field name depends on the field type:

152

+ many2one: must end by '_id' (eg: partner_id, order_line_id)

153

+ many2many: must end by '_ids' (eg: category_ids)

154

+ one2many: must end by '_ids' (eg: line_ids

Older »