txStatHat 0.2.0

一个Twisted API包装器，用于StatHat的EZ API。

使用方法非常简单

from twisted.internet import reactor
from twisted.internet.defer import inlineCallbacks
from txstathat import txStatHat


@inlineCallbacks
def doSomeStats():
    sh = txStatHat('ezKeyOrEmail')
    yield sh.count('aCounter')  # Counts by 1 by default
    yield sh.count('anotherCounter', 42)
    yield sh.value('aValue', 0.42)


reactor.callLater(1, doSomeStats)
reactor.run()

ezKeyOrEmail是您的电子邮件地址，但可以在账户设置中更改为一个更安全的地址。没有密码。

默认情况下，错误会被静默吞没，因此StatHat上的中断不会意外地导致您的服务中断。要获取网络异常以及API错误消息，在实例化txStatHat时设置ignore_errors=False。只有在您有充分的理由时才这样做。

请注意：目前，StatHat.com在提交错误的EZ API密钥时不会报告错误。因此，即使您没有替换API密钥，上述示例也将没有任何效果。

StatHat.com在错误处理上似乎与txStatHat有类似的态度。除非您使用API错误（例如不提供API密钥），否则它们会返回OK。区别在于，如果ignore_errors保留为默认值True，访问API时的网络问题也会被忽略。

根据pyOpenSSL（http://pypi.python.org/pypi/pyOpenSSL/）的可用性，txStatHat尽可能使用HTTPS进行API调用。虽然攻击者如果劫持您的API密钥对您造成的实际损害不大，但我强烈建议您安装并使用它。