SwiftBeanCountTangerineMapper

CI Status Documentation percentage License: MIT Latest version platforms supported: linux | macOS | iOS | watchOS | tvOS SPM compatible

本项目是 SwiftBeanCount 的一部分,请查看主要文档此处

内容

这是一个小型库,用于将从 Tangerine 下载的数据(通过TangerineDownloader)转换为 Beancount 格式(通过SwiftBeanCountModel)。

Beancount 元数据

该库依赖于您的 Beancount 文件中的元数据来查找您的账户。 对于信用卡,请添加 importer-type: "tangerine-card"last-four: "XXXX" (其中 XXXX 为您卡号的后四位)到您的信用卡负债账户。 对于其他账户类型(如支票、储蓄和信用额度),请添加 importer-type: "tangerine-account"number: "XXXX" (其中 XXXX 为账户号码)作为元数据添加到 Beancount 文件中的账户。

可选地,您可以将 tangerine-interest 与账户号码(可以有多个,用空格分隔)添加到您希望记录利息的收入账户的元数据中。 您还可以将 tangerine-rewards 与信用卡返现奖励存入的(储蓄)账户号码添加到您希望记录奖励/返现收入的收入账户的元数据中。

使用方法

  1. 加载您的账本,例如通过 SwiftBeanCountParser
  2. 使用账本创建 SwiftBeanCountTangerineMapper 的实例
  3. 通过 TangerineDownloader 下载您要转换的账户和活动
  4. 在 mapper 上使用 createBalancescreateTransactions 来转换下载的数据

请查看完整的文档 此处

用法

该库支持 Swift Package Manager,因此只需在您的 Package.swift 中添加依赖项即可

.package(url: "https://github.com/Nef10/SwiftBeanCountTangerineMapper.git", .exact(from: "X.Y.Z")),

注意:根据语义版本控制,所有版本更改 < 1.0.0 都可能是破坏性的,所以现在请使用 .exact

版权

虽然我的代码是根据 MIT 许可证 授权的,但源代码仓库可能包含 Tangerine、Scotiabank 或其他实体的名称或其他商标; 这些元素的潜在使用限制仍然适用,不受软件许可证的影响。 API 设计同样适用。 我与 Tangerine 没有任何关联,除了是他们的客户。