.. image:: https://img.shields.io/pypi/v/jaraco.financial.svg
:target: https://pypi.org/project/jaraco.financial
.. image:: https://img.shields.io/pypi/pyversions/jaraco.financial.svg
.. image:: https://github.com/jaraco/jaraco.financial/actions/workflows/main.yml/badge.svg
:target: https://github.com/jaraco/jaraco.financial/actions?query=workflow%3A%22tests%22
:alt: tests
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
:target: https://github.com/astral-sh/ruff
:alt: Ruff
.. image:: https://readthedocs.org/projects/jaracofinancial/badge/?version=latest
:target: https://jaracofinancial.readthedocs.io/en/latest/?badge=latest
.. image:: https://img.shields.io/badge/skeleton-2023-informational
:target: https://blog.jaraco.com/skeleton
``jaraco.financial`` implements tools for financial management, particularly
around Open Financial Exchange and Microsoft Money. These scripts help
facilitate the continued use of Money using the free, sunset release, by
enabling mechanical downloads of OFX data from institutions that support OFX.
Getting Started
---------------
The primary use of this package is the `ofx` command. After installing, run
`ofx --help` for usage. Before using the project, you will want to supply
institution and account information. See below for details on defining these
input files.
This project is still a work in progress, but if you think you might find
it useful, don't hesitate to contact the author for help.
Planned Changes
---------------
The author plans to add some of the following features:
* Integrate some of the most common institutions.
Accounts File
-------------
The "ofx download-all" command of `jaraco.financial` will retrieve the
OFX transactions in a batch for a group of accounts defined in a YAML file.
Currently, that file must be located in ~/Documents/Financial/accounts.yaml.
The file should be a list of objects,
each with `institution` and `account` attributes. It should also have a
`type` property of "checking", "savings", "creditline", or other appropriate
OFX type. The institution must match exactly an institution as defined below.
Here is an example accounts.yaml::
- institution: Bank of America
account: "12345679"
type: savings
- institution: Wells Fargo
account: "872634126"
type: moneymrkt
- institution: Chase (credit card)
account: "4000111122223333"
username: myusername
The `username` attribute must be included if the username of the local user
(running the ofx command) differs from the account name on the account.
Institutions Definition
-----------------------
Institution definitions can be provided in a YAML format in the file
``~/Documents/Financial/institutions.yaml``. The following is an example
definition for a credit card::
Chase (credit card):
caps:
- SIGNON
- CCSTMT
fid: "10898"
fiorg: B1
url: https://ofx.chase.com
To check that your institutions are being loaded correctly, use the
``ofx list-institutions`` command.
Raw data
{
"_id": null,
"home_page": "https://github.com/jaraco/jaraco.financial",
"name": "jaraco.financial",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Jason R. Coombs",
"author_email": "jaraco@jaraco.com",
"download_url": "https://files.pythonhosted.org/packages/12/9c/3630cc927bb0dba9d7cb902779d63537525a7ab237aacffb27ebdbcd63f8/jaraco.financial-2.2.0.tar.gz",
"platform": null,
"description": ".. image:: https://img.shields.io/pypi/v/jaraco.financial.svg\n :target: https://pypi.org/project/jaraco.financial\n\n.. image:: https://img.shields.io/pypi/pyversions/jaraco.financial.svg\n\n.. image:: https://github.com/jaraco/jaraco.financial/actions/workflows/main.yml/badge.svg\n :target: https://github.com/jaraco/jaraco.financial/actions?query=workflow%3A%22tests%22\n :alt: tests\n\n.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json\n :target: https://github.com/astral-sh/ruff\n :alt: Ruff\n\n.. image:: https://readthedocs.org/projects/jaracofinancial/badge/?version=latest\n :target: https://jaracofinancial.readthedocs.io/en/latest/?badge=latest\n\n.. image:: https://img.shields.io/badge/skeleton-2023-informational\n :target: https://blog.jaraco.com/skeleton\n\n``jaraco.financial`` implements tools for financial management, particularly\naround Open Financial Exchange and Microsoft Money. These scripts help\nfacilitate the continued use of Money using the free, sunset release, by\nenabling mechanical downloads of OFX data from institutions that support OFX.\n\nGetting Started\n---------------\n\nThe primary use of this package is the `ofx` command. After installing, run\n`ofx --help` for usage. Before using the project, you will want to supply\ninstitution and account information. See below for details on defining these\ninput files.\n\nThis project is still a work in progress, but if you think you might find\nit useful, don't hesitate to contact the author for help.\n\nPlanned Changes\n---------------\n\nThe author plans to add some of the following features:\n\n* Integrate some of the most common institutions.\n\nAccounts File\n-------------\n\nThe \"ofx download-all\" command of `jaraco.financial` will retrieve the\nOFX transactions in a batch for a group of accounts defined in a YAML file.\nCurrently, that file must be located in ~/Documents/Financial/accounts.yaml.\nThe file should be a list of objects,\neach with `institution` and `account` attributes. It should also have a\n`type` property of \"checking\", \"savings\", \"creditline\", or other appropriate\nOFX type. The institution must match exactly an institution as defined below.\nHere is an example accounts.yaml::\n\n - institution: Bank of America\n account: \"12345679\"\n type: savings\n\n - institution: Wells Fargo\n account: \"872634126\"\n type: moneymrkt\n\n - institution: Chase (credit card)\n account: \"4000111122223333\"\n username: myusername\n\nThe `username` attribute must be included if the username of the local user\n(running the ofx command) differs from the account name on the account.\n\nInstitutions Definition\n-----------------------\n\nInstitution definitions can be provided in a YAML format in the file\n``~/Documents/Financial/institutions.yaml``. The following is an example\ndefinition for a credit card::\n\n Chase (credit card):\n caps:\n - SIGNON\n - CCSTMT\n fid: \"10898\"\n fiorg: B1\n url: https://ofx.chase.com\n\nTo check that your institutions are being loaded correctly, use the\n``ofx list-institutions`` command.\n",
"bugtrack_url": null,
"license": "",
"summary": "Tools and routines for managing personal finances by jaraco",
"version": "2.2.0",
"project_urls": {
"Homepage": "https://github.com/jaraco/jaraco.financial"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7cbe62fcd8a7b6a7c01d9ebb7ff2a4cda6c0343e0a88572abca60a0be612eea0",
"md5": "afdf8a5fb16eed07127a826971b0effc",
"sha256": "a184cb60b0dd1647fd178136586437b9dd12ec63f4434004b2afbc60cb5ab141"
},
"downloads": -1,
"filename": "jaraco.financial-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "afdf8a5fb16eed07127a826971b0effc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18692,
"upload_time": "2024-02-04T15:23:31",
"upload_time_iso_8601": "2024-02-04T15:23:31.736659Z",
"url": "https://files.pythonhosted.org/packages/7c/be/62fcd8a7b6a7c01d9ebb7ff2a4cda6c0343e0a88572abca60a0be612eea0/jaraco.financial-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "129c3630cc927bb0dba9d7cb902779d63537525a7ab237aacffb27ebdbcd63f8",
"md5": "af3a2993f46ac25d90f1a8ed9b141efe",
"sha256": "202a81c8ccb8a800c5a0eb7dff45b439e6b3e3d5365cdb7370635fb415dfef99"
},
"downloads": -1,
"filename": "jaraco.financial-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "af3a2993f46ac25d90f1a8ed9b141efe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 23104,
"upload_time": "2024-02-04T15:23:32",
"upload_time_iso_8601": "2024-02-04T15:23:32.843742Z",
"url": "https://files.pythonhosted.org/packages/12/9c/3630cc927bb0dba9d7cb902779d63537525a7ab237aacffb27ebdbcd63f8/jaraco.financial-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-04 15:23:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jaraco",
"github_project": "jaraco.financial",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "jaraco.financial"
}
JSON
