anthem 0.14.0

依赖项

要运行测试，你必须有运行中的Postgresql，并且你有用户的访问权限（否则你将不得不修改 tests/config/odoo.cfg，加上你的数据库用户名和密码）。

运行测试

要运行圣歌（anthem）的测试，最好在一个虚拟环境中对其做一个可编辑的安装。你还必须通过安装Odoo包来准备环境。

Odoo 9.0 (Python 2)

Odoo 10.0 (Python 2)

Odoo 11.0 (Python 3)

如果需要，你可以使用（根据版本调整）删除测试数据库

这些步骤将下载Odoo的夜间版本，将其安装为包，然后安装数据库，以便测试可以针对它运行（这也是为什么使用虚拟环境很重要的原因！）

当调用 pytest 时，你必须使用将要用于测试的Odoo数据库的配置文件定义 OPENERP_SERVER 环境变量。

加载数据

有一个能力以方便的CSV格式提供数据 - 圣歌（Anthem）能够解析并加载这些数据。 load_csv 方法是为了这样做的主要入口点

CSV格式类似于Odoo导出格式，即：它应该包含一个字段名称集合在标题中 * 每一行连续定义一组值，用于在给定的模型上创建记录

记录

本节专门介绍针对记录的方法。

from anthem.records import add_xmlid

[...]
@anthem.log
def add_xmlid_to_foo(ctx):
    """Make Jhony Foo great again."""
    foo = ctx.env['res.partner'].create({
        'name': 'Jhony',
        'lastname': 'Foo',
    })
    add_xmlid(foo, '__setup__.res_partner_foo_jhony')

from anthem.records import create_or_update

[...]
@anthem.log
def create_partner_foo(ctx):
    """Ensure that Jhony Foo is known to our Company."""
    create_or_update(
        ctx,
        model='res.partner',
        xmlid='__setup__.res_partner_foo_jhony',
        values={
            'name': 'Jhony',
            'lastname': 'Foo',
        }
    )

模块

本节专门介绍针对模块的方法。

from anthem.lyrics.modules import uninstall

[...]
@anthem.log
def uninstall_foo(ctx):
    """Get rid of legacy `foo` and `bar`."""
    uninstall(ctx, ['foo', 'bar'])

未发布

功能

错误修复

改进

文档

构建

0.14.0 (2023-05-16)

错误修复

• 修复更新_translation函数，并更新black版本22.3.0

• 将Setuptools版本固定在< 58

• 修复Odoo 15的环境初始化

• 修复Odoo 15的add_xmlid

改进

• 启用Travis-CI为Odoo 14和Odoo 15测试

• 添加：nuke_translations以允许删除已存在的翻译

0.13.0 (2019-08-29)

功能

• 重大变更：更改默认overwrite值

  lyrics.modules.update_translations为False

• 支持Odoo SaaS版本

错误修复

• 使lyrics.modules.update_translations与Odoo >= 11.0兼容

0.12.2 (2019-06-21)

改进

• 将“tracking_disable=True”作为默认上下文加载CSV（避免创建“mail.message”记录并加快导入过程）

构建

• 打包：构建通用wheels

0.12.1 (2018-11-09)

文档

• 改进API文档

构建

• 现在，当添加标签时，Travis会自动将lib发布到Pypi

0.12.0 (2018-03-19)

功能

• 添加新的选项--odoo-data-path或环境变量ODOO_DATA_PATH。

• 现在，lyrics.loaders.load_csv方法现在接受一个相对路径附加到新的选项“odoo数据路径”。绝对路径仍然允许。

错误修复

• lyrics.loaders.update_translations现在已弃用，因为它与lyrics.modules.update_translations重复

0.11.0 (2017-12-22)

功能

• 使其与Python 3和Odoo 11兼容

构建

• 切换到unicodecsv而不是自定义代码来处理它

• 修复测试设置中的波动。由于某些原因，删除了tox。

• 在构建中添加lint检查

0.10.0 (2017-09-19)

错误修复

• 禁用Odoo的xmlrpc端口

构建

• 添加“build-release.sh”脚本，其中包含构建和上传dist文件的命令

0.9.0 (2017-08-21)

功能

• 新的lyrics：modules.update_translations用于从po文件更新翻译

• 将lyrics的“uninstall”从uninstaller.uninstall移动到modules.uninstall，以前的路径仍然适用于向后兼容

• 新的lyrics上下文管理器“records.switch_company”

0.8.0 (2017-07-24)

功能

• 新的lyrics：定义设置，如处于界面中

• 添加CSV加载列控制（列白名单和黑名单）

错误修复

• 修复加载没有行的CSV时的错误

0.7.0 (2017-04-28)

改进

• 将CSV加载器拆分为函数，以便能够从CSV获取行或将行加载进来，例如在加载之前修改行

• create_or_update lyrics现在接受一个模型，因此我们可以更改其环境（用户、上下文等）

• 新的lyrics来卸载模块

0.6.0 (2017-01-18)

功能

• CSV加载器可以使用模型，以便传递上下文

错误修复

• 通过安装来自odoo/requirements.txt的eggs来修复测试

0.5.0 (2016-10-12)

功能

• 支持Odoo 10

• 允许指定导入文件的编码，默认为utf8

错误修复

• “records.add_xmlid”lyrics不再在它已存在时失败

0.4.0 (2016-08-19)

功能

• 新的lyrics：从路径或流中加载CSV

• 添加新的ctx.log_line以打印一个符合当前缩进的行

改进

• 为现有的lyrics添加测试

构建

• 最终绿色构建！

0.3.0 (2016-07-26)

功能

• 添加–quiet模式

修复

• 将记录的字符串编码为默认编码或utf8

• 允许使用Ctrl-c停止anthem。

• 将openerp的loglevel设置为ERROR，它的日志会弄乱anthem的输出

0.2.0 (2016-07-22)

功能

• 使用上下文管理器Context.log和装饰器anthem.log，在歌曲中记录描述和计时信息。

  from anthem import log
  
  @log
  def setup_company(ctx):
      """ Setup company """
      # do stuff
      with ctx.log('other stuff'):
          # do other stuff
  
  @log
  def load_data(ctx):
      """ Load data """
      # load
  
  @log
  def main(ctx):
      setup_company(ctx)
      load_data(ctx)

  如果我们运行anthem在main上，我们将得到

  running... main
     running... Setup company
        running... other stuff
        other stuff: 0.850s
     Setup company: 1.100s
     running... Load data
     Load data: 2.900s
  main: 4.000s

0.1.3 (2016-07-07)

修复

• 修正歌词以创建或更新记录

0.1.2 (2016-07-07)

• 添加创建xmlid的歌词

• 添加歌词以创建或更新记录

0.1.1 (2016-06-23)

• 修复了在不可编辑安装中发生的崩溃。

0.1.0 (2016-06-23)

初始发布。