bda.awstatsparser 1.2.1

用法

此egg包含一个用于解析AwStats文件的解析器，提供了一个方便的类似于字典的API

>>> from bda.awstatsparser.defaults import (
...     PREFIX,
...     POSTFIX,
...     SECTIONDEFS,
... )

PREFIX 和 POSTFIX 用于构建目标统计文件路径，SECTIONDEFS 定义了统计文件的预期结构和用于提供多个值的键。

API是由于ParsedStatistics类提供的

>>> from bda.awstatsparser.parser import ParsedStatistics
>>> parser = ParsedStatistics(domain='same_as_awstats_conf_name',
...                           dir='/var/lib/awstats',
...                           PREFIX, POSTFIX, SECTIONDEFS)

您可以请求可用的统计键

>>> parser.available
['012010', '122009']

您可以查询最新的可用统计键

>>> parser.latest
'012010'

访问一些统计信息

>>> sider = parser[parser.latest]['SIDER']
>>> stat = sider['/path/which/was/logged']
>>> stat['pages']
99

贡献者

• Jens Klein <jens@bluedynamics.com>

• Robert Niederreiter <rnix@squarewave.at>

历史

许可证

版权所有 (c) 2006-2012, BlueDynamics Alliance, 奥地利，瑞士，德国

GNU通用公共许可证

复制、分发和修改的条款和条件

0. 本许可证适用于任何包含版权所有者放置的通知，表明它可以根据本通用公共许可证的条款进行分发的工作或程序。以下“程序”一词指的是此类程序或工作，“基于程序的工作”是指程序或根据版权法产生的任何衍生作品：也就是说，包含程序或其一部分的工作，无论是原样还是经过修改和/或翻译成另一种语言的。（以下，翻译包括但不限于“修改”一词的含义。）每个许可证持有人均称为“你”。

   本许可证不适用于除复制、分发和修改以外的活动；它们超出了其范围。运行程序的行为不受限制，并且只有当程序的内容构成基于程序的工作时（无论是否通过运行程序生成），程序输出的内容才受到保护。（这取决于程序的行为。）

1. 你可以按你收到的样子，以任何媒体形式复制和分发程序源代码的准确副本，只要你在每个副本上明显且恰当地公布适当的版权声明和免责声明；保持所有引用本许可证和声明无任何保证的通知完整；并且向程序的其他接收者提供本许可证的副本以及程序。

   你可以对转移副本的物理行为收取费用，你也可以选择以费用为交换条件提供保证。

2. 你可以修改你的程序副本或其任何部分，从而形成基于程序的工作，并在上述第1节规定的条款下复制和分发这些修改或工作，前提是你也满足以下所有条件

   a) 你必须使修改后的文件包含显眼的声明，说明你已更改文件，并注明任何更改的日期。

   b) 你必须使你分发或发布的任何工作，无论其全部或部分是否包含或源自程序或其任何部分，都根据本许可证的条款作为整体免费许可给所有第三方。

   c) 如果修改后的程序在运行时通常以交互方式读取命令，你必须使其在以最普通的方式启动用于此类交互使用时打印或显示一个公告，包括适当的版权声明和没有保证（或者，如果你提供保证，则说明你提供保证）的通知，以及用户可以按照这些条件重新分发程序的通知，并告诉用户如何查看本许可证的副本。（例外：如果程序本身是交互式的但通常不打印此类公告，则基于该程序的工作不需要打印公告。）

   这些要求适用于整个修改作品。如果该作品的可识别部分不是源自程序，并且可以合理地被认为是独立且独立的作品，那么当你将其作为单独的工作分发时，本许可证及其条款不适用于这些部分。但是，当你将相同的部分作为整体的一部分分发，而该整体是基于程序的工作时，整个的分发必须符合本许可证的条款，其许可权扩展到整个整体，从而扩展到每个部分，无论其作者是谁。

   因此，本节的目的并非主张权利或质疑您对完全由您撰写的作品的著作权；相反，目的是行使对基于本程序衍生或集体作品的分发控制权。

   此外，将另一个非基于本程序的作品与本程序（或基于本程序的作品）一起聚集在存储或分发介质的某一卷中，并不意味着将该作品纳入本许可证的范围。

3. 您可以在上述第1条和第2条的条款下，以目标代码或可执行形式复制和分发程序（或根据第2节基于该程序的作品），前提是您还做以下之一：

   a) 伴随完整的对应机器可读源代码，该代码必须按照上述第1条和第2条的条款在通常用于软件交换的媒介上分发；或者，

   b) 伴随一份书面要约，至少有效三年，向任何第三方提供完整机器可读的对应源代码的副本，其费用不超过您物理分发源代码的成本，该源代码的副本将按照上述第1条和第2条的条款在通常用于软件交换的媒介上分发；或者，

   c) 伴随您收到的关于分发对应源代码要约的信息。（此替代方案仅适用于非商业分发，并且仅当您根据上述b节收到以目标代码或可执行形式提供此类要约的程序时才允许。）

   作品的源代码是指对其进行修改的首选形式。对于可执行作品，完整的源代码意味着所有模块的源代码，加上任何相关的接口定义文件，加上用于控制编译和安装可执行文件的脚本。但是，作为一项特殊例外，分发的源代码不必包括通常与操作系统的主要组件（编译器、内核等）一起分发的任何内容（无论是源代码还是二进制形式），除非该组件本身伴随可执行文件。

   如果通过提供从指定地点复制的方式分发可执行或目标代码，则提供从同一地点复制源代码的等效访问权限视为分发源代码，即使第三方没有被强制与目标代码一起复制源代码。

4. 您不得复制、修改、转授许可或分发程序，除非本许可证明确提供。任何其他复制、修改、转授许可或分发程序的行为均属无效，并且将自动终止您根据本许可证享有的权利。但是，根据本许可证从您那里收到副本或权利的各方，只要这些方完全遵守本许可证，其许可证不会被终止。

5. 您不必接受本许可证，因为您没有签署它。然而，没有其他许可授予您修改或分发程序或其衍生作品的权利。如果您不接受本许可证，这些行为将受到法律的禁止。因此，通过修改或分发程序（或基于程序的任何作品），您表明您接受本许可证以及所有复制、分发或修改程序或基于程序的作品的条款和条件。

6. 每次您重新分发程序（或基于程序的任何作品），接受者自动从原始许可方获得一份许可证，以根据这些条款和条件复制、分发或修改程序。您不得对接受者行使本许可证赋予的权利施加任何进一步的限制。您不负责强制第三方遵守本许可证。

7. 如果由于法院判决、专利侵权指控或其他原因（不仅限于专利问题），对你（无论是由法院命令、协议或其他方式）施加的条件与本许可证的条件相冲突，这并不能免除你对本许可证条件的遵守。如果你不能同时满足本许可证和任何其他相关义务的分配要求，那么作为结果，你可能根本不能分配该程序。例如，如果专利许可证不允许所有直接或间接通过你获得副本的人免费重新分配程序，那么满足这两个条件唯一的方法是完全停止程序的分配。

   如果在本节任何部分在特定情况下被判定为无效或不可执行，本节的其他部分应适用，并且本节整体在其他情况下应适用。

   本节的目的不是为了诱使你侵犯任何专利或其他财产权主张或质疑此类主张的有效性；本节唯一的目的在于保护自由软件分发系统的完整性，该系统通过公共许可证实践实施。许多人已经通过该系统为广泛分布的软件做出了慷慨的贡献，依赖于该系统的持续应用；作者/捐赠者决定是否愿意通过任何其他系统分发软件，许可证持有人无权强制选择。

   本节旨在彻底阐明本许可证其他部分被认为是的结果。

8. 如果由于专利或版权接口，某些国家限制了对程序的分发和使用，将程序置于本许可证之下的原始版权所有者可以添加一个明确的地理分发限制，排除这些国家，以便只在或在这些被排除的国家之间允许分发。在这种情况下，本许可证将包含此限制，就好像它是本许可证正文的一部分一样。

9. 自由软件基金会可能会不时发布修订版和/或新版本的通用公共许可证。这些新版本的精神将与当前版本相似，但在细节上可能有所不同，以解决新的问题或担忧。

   每个版本都有一个区分的版本号。如果程序指定了适用于它的本许可证的版本号以及“任何后续版本”，你有权选择遵循该版本或由自由软件基金会发布的任何后续版本的条款和条件。如果程序没有指定本许可证的版本号，你可以选择自由软件基金会发布的任何版本。

10. 如果你希望将程序的部分内容纳入其他分发条件不同的自由程序中，请写信给作者请求许可。对于由自由软件基金会拥有的版权软件，请写信给自由软件基金会；我们有时会为此做出例外。我们的决定将受保护我们所有免费软件派生品的自由状态和促进软件的共享和再使用的两个目标的指导。

无保修

11. 由于程序是免费许可的，因此根据适用的法律，程序不提供任何保证。除非以书面形式另有声明，否则版权所有者/其他各方提供的程序是“按原样”提供的，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于对适销性和特定用途的适用性的暗示保证。程序的质量和性能的全部风险由你承担。如果程序被证明存在缺陷，你将承担所有必要的服务、维修或纠正的费用。

12. 除非适用法律要求或书面同意，否则在任何情况下，版权持有者或任何其他有权修改和/或根据上述规定重新分发该程序的当事人，对您不承担任何责任，包括但不限于使用或无法使用该程序（包括但不限于数据丢失或数据不准确、您或第三方遭受的损失或该程序与其他程序无法协同运行）产生的任何一般性、特殊性、偶然性或后果性损害，即使该持有者或其他当事人已被告知可能发生此类损害。

条款和条件结束