会计和财务数据引擎amatino api的绑定
amatino的Python项目详细描述
阿马蒂诺Python
阿马蒂诺是一个复式记帐系统。它通过http api提供作为服务的复式记帐。amatino python是一个用于在python应用程序中与amatino api交互的库。通过使用amatino python,python开发人员可以使用amatino服务,而无需处理原始http请求。
关于Amatino
Amatino为您提供了一整套存储、组织和检索财务信息的工具。您不需要设置数据库或编写任何自己的复式记帐逻辑。你只需要这个库,一个Amatino account (Try free for two weeks!),你就可以离开并运行了。
在建
现在,amatino api通过http请求提供了一系列的记帐服务。但是,这个amatino python库处于“alpha”状态。它的能力是有限的。完整Amatino功能的子集可用。
要查看amatino python中准备好的amatino特性的比例,请查看Documentation页面。链接类可用,未链接类仍在构建中。
安装
amatino python可以通过PIP安装。
$ pip install amatino
要使用amatino python,您需要一个活动的amatino订阅。您可以在https://amatino.io/subscribe开始免费试用。
示例用法
第一步是通过创建Session实例登录到amatino。然后,该会话将成为使用amatino类的关键。
fromamatinoimportSessionsession=Session.create_with_email(email='clever@cookie.com',secret='uncrackable epic passphrase!')
amatino将财务数据存储在离散的Entities中。一个实体可以描述一个人、项目、公司,或者你想用财务数据描述的其他实体。
fromamatinoimportEntitymega_corporation=Entity.create(session=session,# Created abovename='Mega Corporation')
实体结构为Accounts的层次树。您可能希望创建一个科目表,以反映所描述实体的真实结构。
fromamatinoimportAccountrevenue=Account.create(entity=mega_corporation,# Created abovedescription='Revenue from world domination',am_type=AMType.revenue,# An AMType enumeration optiondenomination=USD# A GlobalUnit)
真正的乐趣从Transactions开始,借项和贷项在这里发挥作用
fromamatinoimportTransaction,Entry,SidefromdatetimeimportdatetimefromdecimalimportDecimalrevenue_recognition=Transaction.create(entity=mega_corporation,time=datetime.utcnow(),entries=[Entry(Side.debit,Decimal(10),cash),Entry(Side.credit,Decimal(5),revenue),Entry(Side.credit,Decimal(5),customer_deposits)]denomination=USD)
查看Amatino Python documentation
API稳定性和版本控制
amatino python遵守Semantic Version约定。在v1.0.0之前,python api(不要与amatinohttpapi混淆)应该被认为是不稳定的,并且随时都可能更改。
Watch out! API currently unstable!
您可以看到可用的版本in GitHub's releases section或in PyPi's release history section。
告诉我们你的想法/想要/喜欢/恨
请加入我们的Amatino discussion forums并给我们您的反馈。我们很想听到你的消息。Amatino正处于开发的早期阶段,您的反馈将影响它前进的方向。
拉取请求、评论、问题、分叉等等也都是most welcome on Github!
有用链接
- Amatino home
- Development blog
- Development newsletter
- Discussion forum
- More Amatino client libraries
- HTTP Documentation
- Python Documentation
- Billing and account management
- About Amatino Pty Ltd
联系
快速和人类谈论阿马蒂诺,email hugh@amatino.io或yell at him on Twitter (@hugh_jeremy)。