openerp-sane 0.2.1

安装

你迫不及待想在模块中使用它，对吧？openerp-sane 可以从 PyPI 安装

$ pip install openerp-sane

当你在模块中使用它时，你可以在你的 __openerp__.py 中记录对其的依赖

{
    # [...]
    'external_dependencies': {
        'python': ['openerp_sane'],
    },
    # [...]
}

@oemeth

@oemeth 是一个方法装饰器，它接受2个（可选，默认为 False）参数： single 和 browse。默认情况下，它仅仅确保 ids 是一个列表

from openerp_sane import oemeth

# [...]

@oemeth
def myaction(self, cr, uid, ids, context=None):
    # Write code that assumes ids is a list

当 single 设置为 True 时，我们将强制使用单个 int id

@oemeth(single=True)
def myaction(self, cr, uid, objid, context=None):
    # objid is an ``int``.
    # WARNING: Use this only when you're sure that you'll only ever have single arguments.
    # If the input is a list with a len() != 1, an exception is raised.

当 browse 设置为 True 时，我们将使用 self.browse() 调用来包装我们的 id(s)

@oemeth(browse=True)
def myaction(self, cr, uid, objs, context=None):
    # objs is a list of browse records

s2d/d2s

s2d() 和 d2s() （意为“字符串转日期”和“日期转字符串”）的存在是为了缓解我们在实际处理和比较日期时遇到的糟糕问题。如果没有这些辅助工具，我们必须手动转换正确的日期格式，这可能会很快变得很繁重。

s2d(string_date) 从日期字段中获取字符串值并返回一个 datetime.date。如果它无法解析它，它将返回 False。

d2s(date) 接受一个 datetime.date 并返回一个可以写入日期字段的字符串。如果 date 不是一个日期，我们返回 False（也可以写入日期字段）。

在这两个函数中，我们使用 OE 的 DEFAULT_SERVER_DATE_FORMAT 常量。

一些经验之谈

不要在 on_change 方法中使用 single（这要求始终恰好有一个 id）。当然，大多数情况下你只会得到一个 id，但如果你在一个尚未提交的记录上调用它，你将得到零个 id，这将引发异常。未来，single 模式可能会支持零个 id 的情况。