FINporter
A framework for detecting and transforming investing data.
FINporter is part of the OpenAlloc family of open source Swift software tools.
Used by investing apps like FlowAllocator and FlowWorth.
Disclaimer
The developers of this project (presently OpenAlloc LLC) are not financial advisers and do not offer tax or investing advice.
Where explicit support is provided for the transformation of data format associated with a service (brokerage, etc.), it is not a recommendation or endorsement of that service.
Software will have defects. Input data can have errors or become outdated. Carefully examine the output from FINporter for accuracy to ensure it is consistent with your investment goals.
For additional disclaiming, read the LICENSE, which is Apache 2.0.
Supported Schema
At present FINporter supports the schemas of the OpenAlloc project, documented at openalloc/AllocData. Applications which support those schemas can make use of FINporter's importers to ingest the specialized formats it supports.
Supported Data Formats
NOTE: support of a data format for a service is not an endorsement or recommendation of that service.
Applications which have integrated FINporter will typically support imports through a menu item or drag-and-drop. The examples below show how the command-line tool, finport, may be used to transform input files to delimited files of standardized schema.
See Also
The rest of the FINporter family of libraries/tools (by the same author):
- FINporterCLI - the command-line interface (CLI) incorporating supported importers
- FINporterChuck - importers for the Schwab brokerage
- FINporterFido - importers for the Fidelity brokerage
- FINporterAllocSmart - importer for the Allocate Smartly service
- FINporterTabular - importer for transforming the AllocData schema
Swift open-source libraries (by the same author):
- AllocData - standardized data formats for investing-focused apps and tools
- SwiftCompactor - formatters for the concise display of Numbers, Currency, and Time Intervals
- SwiftModifiedDietz - A tool for calculating portfolio performance using the Modified Dietz method
- SwiftNiceScale - generate 'nice' numbers for label ticks over a range, such as for y-axis on a chart
- SwiftRegressor - a linear regression tool that’s flexible and easy to use
- SwiftSeriesResampler - transform a series of coordinate values into a new series with uniform intervals
- SwiftSimpleTree - a nested data structure that’s flexible and easy to use
And open source apps using this library (by the same author):
- FlowAllocator - portfolio rebalancing tool for macOS
- FlowWorth - a new portfolio performance and valuation tracking tool for macOS
License
Copyright 2021, 2022 OpenAlloc LLC
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Contributing
Contributions are welcome. You are encouraged to submit pull requests to fix bugs, improve documentation, or offer new features.
The pull request need not be a production-ready feature or fix. It can be a draft of proposed changes, or simply a test to show that expected behavior is buggy. Discussion on the pull request can proceed from there.
Contributions should ultimately have adequate test coverage and command-line support. See tests for current importers to see what coverage is expected.