与我们的时间跟踪器接口的py脚本
trkr的Python项目详细描述
#trkr
trkr是一个命令行工具,可以帮助跟踪我们的团队正在进行的工作和 他们花了多长时间做这件事。通过Trello和Google Sheets的集成,它允许 您可以搜索并选择相关的Trello卡,然后直接写入工作表。
##要求
python 2.6+或3+
##安装
`python pip install trkr `
##用法
使用trkr就像运行trkr run一样简单。有效命令列表可用 运行trkr–help。
###说明
提供已完成工作的描述。如果没有提供,则提交 将使用头部最后一次提交的消息。
###工作分钟数
以分钟为单位的工作时间(必须是有效的整数)。
###特雷罗卡
你可以选择(i)输入卡片的网址,模糊地查找卡片,(p)点击 指定卡的列表,或选择不包含卡。
###日期
以mm/dd/yyyy格式输入时间戳。可以跳过此操作,而是 使用当前日期。
##设置
要启动安装脚本,请运行trkr setup。它需要一封电子邮件,特雷罗 API键和工作表URL。所有设置都保存在~/.trkr/config.json, 以后可以修改。
###trello身份验证
####查找客户ID和线路板ID
在trello上,导航到一个板并将.json附加到url。它应该看起来 类似于https://trello.com/c/<;url>;.json。当json数据加载后, hthe firstid将是board id;复制并保存到某个地方。
下一步搜索您的姓名或用户名,找到与其关联的id,然后 把它保存在某个地方;这是您的client id。
####API密钥和令牌
Trello API密钥可以在[trello.com/app key](https://trello.com/app-key)中找到。 在key下找到的散列是您的api key,在secret下找到的散列是您的 api secret。可以通过单击同一页上的标记生成标记;此 是您的令牌。
###google sheets身份验证
一旦您创建了一个新的google工作表,它的url就是documenturl,并且 底部工作表的名称是worksheet name。
要授权trkr从工作表中读/写,请执行以下步骤 在[授权pygsheets](https://pygsheets.readthedocs.io/en/latest/authorizing.html)中分层显示。 手握json文件,将其移动到~/.trkr/keyfile.json。最后,分享 包含电子邮件的工作表位于keyfile.json中。现在应该设置trkr 准备使用!
##确认
trkr依赖于[pygsheets]所做的伟大工作(https://github.com/nithinmurali/pygsheets/) 和[py trello](https://github.com/sarumont/py-trello)团队。