lxml 学习笔记

Hallstatt 哈尔施塔特

人生苦短,我用Python。

起初,这篇文章是打算来写 XPath 的,可是后来一想,我需要的仅是 XPath 的一部分,我仅仅是打算在写爬虫的时候,抓取特定数据的,并且这是需要结合 lxml 的,So ,索性就来写 lxml 来了。(lxml supports XPath 1.0, XSLT 1.0 and the EXSLT extensions through libxml2 and libxslt in a standards compliant way.这是教程上的一段话,但是XPath现在是有2.0版本的。)

关于教程方面官方网站上给出了三个教程:

  • the lxml.etree tutorial for XML processing 这个是官方的教程。
  • John Shipman's tutorial on Python XML processing with lxml 这个是 New Mexico Tech 大学的一个教程。嗯 ,有点久了,最后更新时间是 2013-08-24 ,当时应该是 3.2 版本的。不过易读性还是比官方的强。
  • Fredrik Lundh's tutorial for ElementTree 这个是 Fredrik Lundh 维护的一个第三方库,后来也被整合到 Python 标准库 xml 中了。这个没时间可以不看,我感觉用不到应该。

lxml is the most feature-rich and easy-to-use library for processing XML and HTML in the Python language.

lxml 是提供了一个 Pythonic API ,并且她也是几乎完全兼容 ElementTree API 的。lxml 的开发团队也是力求减少开发者的学习成本,不过 lxml 的教程感觉一点都不友好。

在看官方教程的时候,发现了一些小疑惑:

lxml 模块并不仅仅是我们在网上搜到的 etree ,lxml 下面还有很多的模块,有 etree 、html 、cssselect 等众多模块。另外我也看到了 BeautifulSoup 。

lxml can make use of BeautifulSoup as a parser backend, just like BeautifulSoup can employ lxml as a parser.

lxml interfaces with BeautifulSoup through the lxml.html.soupparser module.

BeautifulSoup 可以将 lxml 作为解析器,这个我是知道的,但是 lmxl.html.soupparser 可以调用 BeautifulSoup 我就不明白了。刚开始以为理解错误,但是确实在源码中找到的证据,soupparser 模块中引入了 BeautifulSoup ,并且也调用了该函数。

两者之间可以相互调用,并且两者之间的函数也是很相似的,就连 css 选择器两个也都有。有意思了。难道 BeautifulSoup 是 lxml 的一部分?

BeautifulSoup 是在 2004 年发布的。lxml 大约是在 2005 年发布。

2008 年,lxml v2.0 发布,lxml.html 添加到库中;在 v2.0.3 版本中 lxml.html.soupparser 才出现。

直到 2012 年 bs4 发布,BeautifulSoup 才可以选择从内置解析器、html5lib 、lxml 这三个中选一个作为解析器,而之前版本使用的是却是另一个。

显然,这两个是两码事。可是两者之间的区别以及联系是什么(因为相似度有点高),特定的情况下又该做出何种选择?这个疑问先立在这里,容我以后回答。我所知道的是 BeautifulSoup 强大检测编码能力,并且能够以 utf-8 形式输出;lxml 具有速度飞起的文本解析力。

本篇文章的介绍顺序是 lxml.etreeXPathlxml.html

lxml.etree

作为一个强大的 xml 处理模块,该有的功能她都是有的。

若操作一个 XML ,首先要能读写,能将字符串或流读进来解析成 ElementTree ,又能将 ElementTree 转换为字符串或流。在这方面 lxml 提供了几个可用的函数:

  • etree.fromstring( string )

    将 string 解析为 Element 或者 ElementTree 。

  • etree.parse( file )

    将文件或者是 file_like 对象解析为 ElementTree (not an Element object),因为 parse() 一般解析整篇文档,字符串解析函数一般只解析片段。其中 file 还可以是 HTTP/FTP URL ,也就是说,file 应该是一个 Bytes 流。不过 libxml2 中的 HTTP/FTP client 比较简单,所以可以考虑使用第三方库。

  • XML( text ) / HTML( text )

    行为比较像 fromstring() ,比较直接的对 XML 和 HTML 文档进行特定解析,可以修改解析器 parser 参数,不同的解析器设置区别还是蛮大的。其中 parser 可以由相应的 XMLParser() / HTMLParser() 函数生成,可设置项有很多不仅限于 encoding 、recover 、remove_blank_text 、remove_comments ,但是默认值是存在不同的。比如 recover 在 XML 中是 False ,而在 HTML 中是 True 。在 HTML 中会使用 libxml2 的 recover 算法对不盒饭的标签进行修复。

  • etree.tostring( elt )

    将一个 Element 或者 ElementTree 转换为 string 形式。这里面有几个可选参数:pretty_print=False 表示是否格式化提高可读性;method="xml" 选择输出后的文档格式,不同的选择,做的修改也不相同,可选参数有 xml 、html 、text (文本内容不包括标签,就是纯文本内容,tail也是) 、c14n (规范化 xml );encoding=None 表示以什么编码的字符串输出,在无 xml 文档声明情况下默认是 ASCⅡ ,可通过 encoding=None 进行修改,但是如果所改编码不是 utf-8 兼容,那么将会启用默认声明。

  • ElementTree.write( file )

    这个是 ElementTree 特有的方法,是将 ElementTree 写到 a file, a file-like object, or a URL (via FTP PUT or HTTP POST) 。可选参数和 tostring() 差不多,也有不同。

剩下就是操作了,增删查改一样也不少,而查找是剩下三个的基础。

etree 对于每种元素都有一个创建函数,比如 Element() 、ElementTree() 、SubElement() 以及 Comment() 。基本所有的函数都是基于这些实例对象的,lxml 的 API 是比较 Pythonic 的,Element 的行为和 list 比较像可以使用 len() 函数切片等,Element 的 attrib 就是一个 dist ;其中 Element 实例拥有 41 个属性和方法,包含了所有:

append() insert()

clear() remove()

find*() get*() iter*() xpath()

set() 以及属性 .tag .attrib .text .tail等的操作

ElementTree 实例拥有的方法较少,常用的大概有 7 种,主要是查找find*() get*() xpath()

Element 的属性介绍:

  • .tag

    元素的名称

  • .attrib

    一个包含元素属性的字典,key 是属性名,value 是对应的值。

  • .text

    Element 的文本均为直接子文本,不包含子元素中的文本,这其中又包含两部分 .text 和 .tail 。.text 是第一个子元素标签之前的,如果没有则为 None 。

  • .tail

    .tail 为 Element 的关闭标签之后的文本,并且是在下一个兄弟子标签之前的部分。没有则为 None 。

Element 的方法介绍:

  • append( child )

    添加一个新的子节点(可以是 Element 、Comment)到当前 Element 中。

  • insert( index, elt)

    将子元素 elt 插入到指定位置,这个 index 的随意性比较大,如果是正数但是超过了最大值,那么 lxml 会直接将这个元素插到末尾,如果是负数,但是这个负数所指位置不存在,那么就插到末尾,这个负数的位置计算规则和列表的那个不太一样,不知道正确的规律是什么,但是经过测试,-n所插的位置,后面有 n (以变化前计算)个元素。如果对 Element 中的子元素执行 insert() 操作,那么子元素位置会按 index 指定的变换。

  • clear()

    调用该函数,将移除所有内容 .attrib 将被移除 .text 和 .tail 将被设置为 None 所有的子节点将被删除。

  • remove( child )

    将子节点 child 从Element 中移除 ,如果child 不是 Element 的子节点,将会引发 ValueError 异常。

  • find( path )

    从 Element 的子元素及后代元素中查找第一个符合 path 的 subelement 。如果没有返回 None 。

    ElementPath 是 ElementTree 自带的一个 XPath-like 的路径语言,和 XPath 差不太多,主要区别是 ElementPath 能用 {namespace}tag,但是 ElementPath 不能使用值比较和函数。

  • findall( path )

    返回一个匹配的 Element 的列表。

  • findtext( path, default=None )

    返回第一个匹配元素的 .text 内容,如果存在匹配,但是没有 .text 内容,那么将返回一个空字符串,如果没有一个匹配的元素,那么将会返回一个 None ,但是有 default 参数,返回 default 所指定的。

  • get( key, default=None )

    返回字符串形式的 属性 key 的值,没有返回 None 或者 default 指定的。

  • getchildren()

    返回一个包含 Element 子元素的列表。

  • getiterator( tag=None, *tags )

    返回元素的一个生成器,返回元素类别取决于参数 tag ,生成顺序是in document order (depth first pre-order) 深度优先的先根遍历。如果没有参数的话,则第一个就是元素本身。如果想使用一个高效的生成器,可以使用 .iter() 。

  • getroottree()

    返回该元素的 ElementTree 。

  • iter( tag=None, *tags )

    过滤特定标签,生成迭代器。默认情况下,iter() 迭代所有的节点,包括PI(处理指令) 、Comment(注释) 等,如果只想迭代标签元素,可以使用 Element factory 做参数e.iter(tag = etree.Element)

  • iterfind( path )

    迭代所有匹配 ElementPath 的 Element 。

  • itertext( tag=None, *tags, with_tail=True )

    迭代 Element 元素的文本内容,with_tail 参数决定是否迭代子元素的 tail 。Element 的tail 不会进行迭代。

  • iterancestors( tag=None )

    如果忽略参数,那么将会迭代所有先辈,加标签名可以只迭代该标签先辈。

  • iterchildren( reversed=False, tag=None )

    通过设置 reversed=True 可以以反向的顺序迭代子元素。

  • itersiblings( preceding=False )

    迭代 Element 之后的兄弟元素,可以通过设置 preceding=True 仅迭代 Element 之前的兄弟元素。

  • iterdescendants( tag=None )

    同 iterancestors()

  • items()

    返回由元素属性的键值所构成的( name, value)元组的列表。

  • keys()

    返回一个没有特定顺序的元素属性名的列表。

  • set(A, V)

    创建或者改变属性 A 的值为 V。

  • xpath()

ElementTree 方法介绍:

没有介绍的方法,是前面的类似,或者已经介绍过。

  • find( path )

  • findall( path )

  • findtext( path )

  • getiterator( tag=None, *tags )

  • getroot()

    获得 ElementTree 的 root 元素,一般情况下是树的根节点的 Element 的实例,但是 ElementTree 是经没有任何东西创建出来的,将返回 None 。

  • xpath()

  • write()

XPath

XPath 是一门在 XML 文档中查找信息的路径语言,W3C 文档:XML Path Language (XPath), Version 1.0

所有的查找都是基于参考定位的,依靠两者之间存在的某种关系,或主从,或平级,这样一步一步的查到。

在 XPath 中,有七种类型的节点:元素、属性、文本、命名空间、处理指令、注释以及文档节点(或称为根节点)。

XPath 使用路径表达式在 XML 文档中选取节点。节点是通过沿着路径或者 step 来选取的。

下面列出了最有用的路径表达式:

表达式 描述
nodename 选取此节点的所有子节点。
/ 从根节点选取。
// 从匹配选择的当前节点选择文档中的节点,而不考虑它们的位置。
. 选取当前节点。
.. 选取当前节点的父节点。
@ 选取属性。

XPath 通配符可用来选取未知的 XML 元素。

通配符 描述
* 匹配任何元素节点。
@* 匹配任何属性节点。
node() 匹配任何类型的节点。

通过在路径表达式中使用“|”运算符,可以选取若干个路径,“|”两边的表达式是互相独立的,并非是一个表达式下。

除了上面介绍的还有两个概念需要知道:轴(Axes)谓语

通过以上介绍我们基本可以进行选取节点了,但是有可能选的节点有点多,那么这时候就需要用谓语了。谓语就是用来做过滤的,过滤条件均写在[]中。

这个过滤条件可写内容有很多:运算符表达式、数字、函数以及文字( Literal ,W3C 的英文介绍没仔细看,没太懂 Literal 说的是什么)。

w3school 给的一个例子,比较有代表性吧。

路径表达式 结果
/bookstore/book[1] 选取属于 bookstore 子元素的第一个 book 元素。
/bookstore/book[last()] 选取属于 bookstore 子元素的最后一个 book 元素。
/bookstore/book[last()-1] 选取属于 bookstore 子元素的倒数第二个 book 元素。
/bookstore/book[position()<3] 选取最前面的两个属于 bookstore 元素的子元素的 book 元素。
//title[@lang] 选取所有拥有名为 lang 的属性的 title 元素。
//title[@lang='eng'] 选取所有 title 元素,且这些元素拥有值为 eng 的 lang 属性。
/bookstore/book[price>35.00] 选取 bookstore 元素的所有 book 元素,且其中的 price 元素的值须大于 35.00。
/bookstore/book[price>35.00]/title 选取 bookstore 元素中的 book 元素的所有 title 元素,且其中的 price 元素的值须大于 35.00。

Xpath 的轴定于的是相对于当前节点具有某种相同特征的节点集。

轴名称 结果
ancestor 选取当前节点的所有先辈(父、祖父等)。
ancestor-or-self 选取当前节点的所有先辈(父、祖父等)以及当前节点本身。
attribute 选取当前节点的所有属性。
child 选取当前节点的所有子元素。
descendant 选取当前节点的所有后代元素(子、孙等)。
descendant-or-self 选取当前节点的所有后代元素(子、孙等)以及当前节点本身。
following 选取文档中当前节点的结束标签之后的所有节点。
namespace 选取当前节点的所有命名空间节点。
parent 选取当前节点的父节点。
preceding 选取文档中当前节点的开始标签之前的所有节点。
preceding-sibling 选取当前节点之前的所有同级节点。
self 选取当前节点。

每一个step都是由轴名称::NodeTest[谓语]构成。比如:child::*/child::pricechild::*child::price都是一个step

lxml.html

Since version 2.0, lxml comes with a dedicated Python package for dealing with HTML: lxml.html. It is based on lxml's HTML parser, but provides a special Element API for HTML elements, as well as a number of utilities for common HTML processing tasks.

The main API is based on the lxml.etree API, and thus, on the ElementTree API.

lxml.html 是一个专门用来处理 HTML 文档的,虽然他依旧是基于 HTML parser 的,但是她提供了很多有针对性的 API 。这里只作一个简单介绍,深入了解,请查阅官方文档。

首先在解析 HTML 文本上增加了几个方法:

  • document_fromstring(string)
  • fragment_fromstring(string, create_parent=False)
  • fragments_fromstring(string)

其次对于 HTML 元素,除了之前的方法之外又加了一些:

  • .drop_tree()

    删除该元素及其所有子元素,就像 el.getparent().remove(el),但是不会删除该元素的 .tail ,.tail 将会与前一个元素合并。

  • .drop_tag()

    删除该标签,但是会保留该元素的子元素与文本。

  • .find_class(class_name)

    返回一个含有 class_name CSS 的元素列表。

  • .find_rel_links(rel)

    返回一个<a rel="{rel}">的元素列表

  • .get_element_by_id(id, default=None)

    通过 id 查找元素,如果没有返回默认,假如文档不合规出现多个同 id 的元素,仅返回第一个。

  • .text_content()

    返回元素的文本内容,包括其子代的文本内容。

  • .cssselect(expr)

    通过 CSS 选择器选择元素。

  • .set(key, value=None)

    设置元素属性,如果 value 没有给或者是 None ,那么将创建一个 boolean attribute (属性只要出现即表示真,无论 value 是什么,哪怕是个空串) E.g. <div checked></div>

正如文章开头说的那个, lxml.html.soupparser 可以引入 BeautifulSoup ,甚至可以仅使用 BeautifulSoup 的编码检测模块 UnicodeDammit 。

最后就是可以使用 lxml.html.open_in_browser(lxml_doc) 直接在浏览器中显示文档,甚至可以对文档的表单进行提交操作。

以上都是据自己的理解而写,如有错误之处,欢迎交流。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容