zaim api的python绑定
zaim的Python项目详细描述
如何安装
$ pip install zaim
或
$ git clone https://github.com/hiromu2000/zaim $ python setup.py install
如何使用
对于不需要验证的功能
>>>importzaim>>>api=zaim.Api()>>>api.default_account()
对于需要验证的功能
>>>importzaim>>>api=zaim.Api(consumer_key='consumer_key',consumer_secret='consumer_secret',access_token='access_token',access_token_secret='access_token_secret')>>>api.verify()>>>response=api.payment(category_id='101',genre_id='10101',amount=1,date='2020-04-01',comment='comment',name='name',place='place',from_account_id=0)>>>api.money(mapping=1,mode='payment',start_date='2020-04-01',end_date='2020-04-01')>>>api.delete(mode='payment',money_id=response['money']['id'])
对于扩展功能
>>>importzaim>>>api=zaim.ExtendedApi(consumer_key='consumer_key',consumer_secret='consumer_secret',access_token='access_token',access_token_secret='access_token_secret')>>>response=api.payment(category_id='101',genre_id='10101',amount=1,date='2020-04-01',comment='comment',name='name',place='place',from_account_id=0)>>>api.search(mapping=1,mode='payment',place='place',name='name',comment='comment')>>>api.delete(mode='payment',money_id=response['money']['id'])>>>api.search_category(u'食費')>>>api.search_genre(u'カフェ')>>>api.search_account(u'銀行')
如何使用命令行脚本
$ exportZAIM_CONSUMER_KEY="YOUR CONSUMER KEY" $ exportZAIM_CONSUMER_SECRET="YOUR CONSUMER SECRET" $ zaim token_get --callback-uri http://example.com
$ exportZAIM_CONSUMER_KEY=consumer_key $ exportZAIM_CONSUMER_SECRET=consumer_secret $ exportZAIM_ACCESS_TOKEN=access_token $ exportZAIM_ACCESS_TOKEN_SECRET=access_token_secret $ zaim money $ zaim payment --category-id 101 --genre-id 10101 --amount 1 --place 'place' --date '2020-04-01' --comment 'comment' --name 'name' $ zaim delete --mode payment --money-id XXXXXXXXX
如何开发
测试
$ cd /path/to/zaim $ exportPYTHONPATH=$PYTHONPATH:/path/to/zaim/zaim $ python tests/test_zaim_no_auth.py $ exportZAIM_CONSUMER_KEY=consumer_key $ exportZAIM_CONSUMER_SECRET=consumer_secret $ exportZAIM_ACCESS_TOKEN=access_token $ exportZAIM_ACCESS_TOKEN_SECRET=access_token_secret $ python tests/test_api.py $ python tests/test_extended_api.py
或者干脆
$ sudo pip install tox $ cd /path/to/zaim $ exportZAIM_CONSUMER_KEY=consumer_key $ exportZAIM_CONSUMER_SECRET=consumer_secret $ exportZAIM_ACCESS_TOKEN=access_token $ exportZAIM_ACCESS_TOKEN_SECRET=access_token_secret $ tox
建造
$ python setup.py sdist $ python setup.py bdist_wheel --universal
待办事项
- 文档(用sphinx(rest)编写并托管在readthedocs中)
- 丰富命令行脚本
- cli的参数验证(例如,帐户id)
致谢
- 部分代码最初来自here。
更改日志
0.2.3(2019-03-23)
- 支持3.6&3.7,放弃3.4。
0.2.2(2015-11-15)
新功能
- 向命令行脚本(zaim)添加了创建、更新和删除操作。
- 已将place添加到income的参数列表中。
0.2.1(2015-10-31)
新功能
- 已将所有读取操作添加到命令行脚本(zaim)。
0.2.0(2015-10-17)
新功能
- 添加了命令行脚本(zaim)。它目前只支持token get,但将支持zaim api中的许多函数。
错误修复
- 修正了影响python 3.x的一个错误:extended_api.py现在可以导入api.py
0.1.0(2015-10-11)
新功能
- 添加了扩展API(^{TT7}$,^{TT8}$,^{TT9}$,^{TT10}$