nark 是一个 Python 3 支持库,用于(至少一个)日记、时间跟踪和个人关系管理应用程序。
nark 提供了一个 API,用于存储、检索和报告时间间隔数据,即时间表或日记帐条目。
注意:您可能想要安装客户端应用程序,例如dob – nark 通常会自动安装。
但如果你愿意,你可以使用pip手动安装 nark :
pip install nark
有关其他设置选项,请阅读
安装指南。
故事
nark的灵感来自
于GNOME备受推崇的时间跟踪应用程序
Hamster。
nark 对仓鼠友好。
升级您现有的数据库
并立即开始操作!
nark是潜在的现代hamster-lib代码重写的一个分支。nark 开发人员很欣赏这样一个美妙的起点!
nark只是一个事实存储和报告 API,不关心数据库和用户界面。nark 只做一件事——而且只做一件事——希望做得好!
开发nark的目标是让任何 Python 开发人员——只要多花几分钟时间和冒险精神——在它坏掉时都能舒服地敲击它,或者在他们认为需要改进的地方添加新功能。(但希望你会发现 nark 可以正常工作,并且它已经完成了你想要的工作!)
特征
专为现代 Python 版本(3.6、3.7 和 3.8)而设计。
自然兼容 Unicode - 为您的笔记增添趣味!
可以迁移旧版 Hamster 数据库(也可以修复完整性问题)。
受人尊敬的报道(让您知道您的事实是安全的)。
体面的文档(包括带有内联指令的现场演示)。
舒适的代码库(专注于功能,而不是格式)。
免费和开源 - 破解!
了解如何
为项目做出贡献
。
例子
这是一个使用 Python 解释器的简单 nark 库使用示例,展示了如何从Factoid字符串创建Fact实例:
$ python3
>>> from nark.items import Fact
>>> factoid = '08:00 to 2019-02-16 10:00: act@cat: #tag1: Hello, nark!'
>>> fact, err = Fact.create_from_factoid(factoid, time_hint='verify_both')
>>> fact
# Fact(
# pk=None,
# deleted=False,
# split_from=None,
# _start='08:00',
# _end=datetime.datetime(2019, 2, 16, 10, 0),
# _description='Hello, nark!',
# activity=Activity(
# pk=None
# deleted=False,
# _name='act',
# category=Category(
# pk=None,
# deleted=False,
# _name='cat',
# ),
# ),
# tags=[Tag(
# pk=None,
# deleted=False,
# _name='tag1',
# )],
# )