条目导出器

BaseItemExporter¶

classscrapy.exporters.BaseItemExporter(fields_to_export=None, export_empty_fields=False, encoding='utf-8', indent=0, dont_fail=False)¶

这是所有项目导出器的（抽象）基类。它支持所有（具体）项目导出器使用的公共特性，例如定义要导出的字段、是否导出空字段或要使用的编码。

这些功能可以通过 __init__ 填充各自实例属性的方法参数： fields_to_export ， export_empty_fields ， encoding ， indent .

2.0 新版功能: 这个 dont_fail 参数。

export_item(item)¶

导出给定项。此方法必须在子类中实现。

serialize_field(field, name, value)¶

返回给定字段的序列化值。如果要控制特定字段或值的序列化/导出方式，可以重写此方法（在自定义项导出器中）。

默认情况下，此方法查找序列化程序 declared in the item field 并返回将该序列化程序应用于值的结果。如果找不到序列化程序，则返回未更改的值。

参数

• field (Field object or a dict instance) -- 正在序列化的字段。如果来源 item object 不定义字段元数据， 领域 是空的 dict .

• name (str) -- 正在序列化的字段的名称

• value -- 正在序列化的值

start_exporting()¶

指示导出过程的开始。某些导出器可能会使用此命令生成某些必需的头（例如， XmlItemExporter ）在导出任何项之前必须调用此方法。

finish_exporting()¶

发出输出过程结束的信号。一些导出器可能会使用此命令生成一些必需的页脚（例如， XmlItemExporter ）在没有其他要导出的项之后，必须始终调用此方法。

fields_to_export¶

包含要导出的字段名称的列表，或 None 如果要导出所有字段。默认为 None .

一些出口商（如 CsvItemExporter ）遵守此属性中定义的字段的顺序。

使用时 item objects 如果不公开所有可能的字段，则不支持导出每个项目的不同字段子集的导出器将只导出在导出的第一个项目中找到的字段。使用 fields_to_export 定义要导出的所有字段。

export_empty_fields¶

是否在导出的数据中包含空/未填充的项字段。默认为 False . 一些出口商（如 CsvItemExporter ）忽略此属性并始终导出所有空字段。

对dict项忽略此选项。

encoding¶

输出字符编码。

indent¶

用于在每个级别上缩进输出的空间量。默认为 0 .

• indent=None 选择最紧凑的表示形式，同一行中的所有项都没有缩进

• indent<=0 每个项目都在自己的行上，没有缩进

• indent>0 每一项都在自己的行上，用提供的数值缩进