TextBase 0.15

什么是textbase文件？

一个简单的格式，用单个字符分隔数据记录（我们使用的所有文件都在一行中有一个$字符。对于每条记录，字段名是该行上的第一个单词，通常是大写。字段名之后的任何文本是该字段的值。对于字段名的重复值，可以使用分号在连续行上指定。如果字段的文本值非常长需要换行，则从行首开始一个或多个空格。

为什么重新发明轮子？

我们已经有CSV文件、JSON文件或YAML文件，为什么还要创建这个？好吧，我没有发明这个。它实际上是InMagic软件套件中使用的一种格式：http://www.inmagic.com/products/dbtext-library-suite/

自从80年代初以来，我们就使用dbText软件创建了大量数据文件，这在互联网领域已经是很久以前的事情了。这些确切的数据文件至今仍在驱动大量软件，并在过去几年中证明非常有用。把它想象成Markdown与HTML，或者是一个更简单的数据格式，具有超级简单的键：值记录，易于人类阅读。

示例文件

FOO A Foo field
BAR A Baz field with mulitple entries
; Another
; and yet even more
$
FOO This is the FOO field for the next record
BAR Nothing

主功能类是TextBase。它可以使用打开的文件或名为sourcefile的字符串缓冲区进行初始化。sourcefile将被遍历，将内容分割成块。每个块将被解析并添加到内部缓冲区列表中。内部缓冲区包含每个记录的字典。字典中的每个条目都以DBText记录的字段名作为键，条目本身是值列表。

TextBase对象可以用作生成器遍历内容，或者像列表一样索引Textbase对象。

示例用法

import textbase
t = textbase.TextBase(somebuf)

print len(t)

for x in t[10:20]:
    print x.keys()

print t[0]

如果您不希望将记录解析为Python字典，只想以文本块的形式处理记录，请按以下方式初始化

t = textbase.TextBase(somebuf, parse=False)