FinTrack 1.0.0__tar.gz

fintrack-1.0.0/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-02-13
+
+### Added
+- Initial release of Portfolio Tracker
+- Portfolio management with buy/sell transaction tracking
+- Dynamic stock price fetching using yfinance
+- Multi-currency support with automatic conversion
+- Cash management system with transaction and dividend tracking
+- Historical portfolio value analysis
+- Index return comparison functionality
+- SQLite-based data storage for holdings, prices, and cash balances
+- Support for dividend tracking and automatic cash updates
+
+### Features
+- `Portfolio_tracker` class for portfolio initialization and management
+- `update_portfolio()` method for refreshing portfolio data
+- `get_portfolio_value()` for historical value analysis
+- `get_current_holdings()` for viewing current positions
+- `get_past_holdings()` for viewing all historical positions
+- `get_portfolio_cash()` for cash balance queries
+- `get_index_returns()` for benchmark comparison
+
+## [Unreleased]
+
+### Planned
+- Web dashboard for portfolio visualization
+- Performance analytics and reporting
+- Tax lot tracking
+- Advanced rebalancing suggestions
+- API for programmatic portfolio updates
+- CSV export of holdings and performance data

fintrack-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FinTrack Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fintrack-1.0.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include src *.py
+recursive-include tests *.py
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *$py.class

fintrack-1.0.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: FinTrack
+Version: 1.0.0
+Summary: A Python package for tracking a dynamic portfolio of stocks with daily price monitoring, cash management, and dividend handling
+Home-page: https://github.com/arofre/FinTrack
+Author: Aron Fredriksson
+Author-email: Aron Fredriksson <arofre903@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/arofre/FinTrack
+Project-URL: Repository, https://github.com/arofre/FinTrack.git
+Project-URL: Bug Tracker, https://github.com/arofre/FinTrack/issues
+Project-URL: Documentation, https://github.com/arofre/FinTrack#readme
+Keywords: portfolio,stock-tracking,finance,stocks,yfinance,investment
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: yfinance>=0.2.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# FinTrack
+
+A Python package for tracking a dynamic portfolio of stocks with daily price monitoring, cash management, and dividend handling. This tool helps you maintain a record of your stock holdings, monitor their values over time, and automatically track cash flows from transactions and dividends.
+
+## Features
+
+- **Portfolio Management**: Track multiple stock holdings with buy/sell transactions
+- **Dynamic Price Tracking**: Automatically fetch and store historical stock prices using yfinance
+- **Multi-Currency Support**: Handle stocks traded in different currencies with automatic conversion
+- **Cash Management**: Maintain accurate cash balances accounting for buy/sell transactions and dividend payments
+- **Dividend Tracking**: Automatically capture and account for dividend payments
+- **Historical Analysis**: Query portfolio composition and value at any point in time
+- **Index Comparison**: Compare your portfolio returns against benchmark indices
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install FinTrack
+```
+
+## Quick Start
+
+### 1. Create a Transaction CSV File
+
+First, create a CSV file with your transactions (`transactions.csv`):
+
+```
+Date;Ticker;Type;Amount;Price
+2023-01-15;AAPL;Buy;10;150.00
+2023-02-20;MSFT;Buy;5;250.00
+2023-03-10;AAPL;Sell;5;165.00
+```
+
+**CSV Columns:**
+- `Date`: Transaction date (YYYY-MM-DD format)
+- `Ticker`: Stock ticker symbol
+- `Type`: Either "Buy" or "Sell"
+- `Amount`: Number of shares
+- `Price`: Price per share (in the stock's native currency)
+
+### 2. Initialize the Portfolio Tracker
+
+```python
+from portfolio_tracker import Portfolio_tracker
+import datetime
+
+# Initialize with starting cash and currency
+portfolio = Portfolio_tracker(
+    initial_cash=150000,
+    currency="SEK",  # Your portfolio's base currency
+    csv_file="transactions.csv"
+)
+
+# Update portfolio (fetches latest prices and processes new transactions)
+portfolio.update_portfolio()
+```
+
+### 3. Query Your Portfolio
+
+```python
+# Get current holdings
+current_holdings = portfolio.get_current_holdings()
+print(f"Current holdings: {current_holdings}")
+
+# Get all holdings ever owned
+all_holdings = portfolio.get_past_holdings()
+print(f"All past holdings: {all_holdings}")
+
+# Get portfolio value for a date range
+portfolio_values = portfolio.get_portfolio_value(
+    from_date=datetime.date(2023, 1, 1),
+    to_date=datetime.date(2023, 12, 31)
+)
+
+# Get cash balance at a specific date
+cash_balance = portfolio.get_portfolio_cash(datetime.date(2023, 6, 15))
+print(f"Cash balance: {cash_balance}")
+
+# Compare against index returns
+index_returns = portfolio.get_index_returns(
+    ticker="^GSPC",  # S&P 500
+    start_date=datetime.date(2023, 1, 1),
+    end_date=datetime.date(2023, 12, 31)
+)
+```
+
+## How It Works
+
+### Data Storage
+
+The package uses SQLite to store three main tables:
+
+1. **Portfolio Table**: Tracks holdings for each date based on transactions
+2. **Cash Table**: Maintains cash balance accounting for transactions and dividends
+3. **Prices Table**: Stores historical prices for all stocks in the portfolio
+
+### Price Management
+
+- Prices are automatically fetched from Yahoo Finance using yfinance
+- Multi-currency portfolios are supported with automatic conversion to your base currency
+- Prices are forward-filled for missing trading days
+- You can specify custom prices for specific dates by adding a "Prices" sheet to your CSV
+
+### Cash Flow Tracking
+
+Cash balance is updated for:
+- Stock purchases (cash out)
+- Stock sales (cash in)
+- Dividend payments (cash in)
+
+## Advanced Features
+
+### Custom Price Specifications
+
+You can specify custom prices for certain dates by including them in your transaction CSV. The package will use these instead of fetching from Yahoo Finance when available.
+
+### Portfolio Reset
+
+Reset your portfolio to start fresh:
+
+```python
+portfolio.reset_portfolio()
+```
+
+## Requirements
+
+- Python >= 3.7
+- pandas
+- yfinance
+
+## Supported Currencies
+
+The package supports any currency pair available on Yahoo Finance, including:
+- Major currencies: USD, EUR, GBP, JPY, CHF, AUD, CAD, SEK, NOK, DKK
+- Cryptocurrencies through crypto tickers
+- Emerging market currencies
+
+## Limitations
+
+- Prices are fetched from Yahoo Finance; ensure data quality
+- Intra-day trading is not supported (daily resolution only)
+- Corporate actions (stock splits, mergers) should be manually adjusted in transactions
+- Past dividend data depends on Yahoo Finance's historical dividend records
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request on GitHub.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Disclaimer
+
+Always verify your portfolio calculations independently. The author is not responsible for any financial losses resulting from the use of this software.
+
+## Support
+
+For issues, questions, or suggestions, please open an issue on the GitHub repository.

fintrack-1.0.0/README.md

@@ -0,0 +1,161 @@
+# FinTrack
+
+A Python package for tracking a dynamic portfolio of stocks with daily price monitoring, cash management, and dividend handling. This tool helps you maintain a record of your stock holdings, monitor their values over time, and automatically track cash flows from transactions and dividends.
+
+## Features
+
+- **Portfolio Management**: Track multiple stock holdings with buy/sell transactions
+- **Dynamic Price Tracking**: Automatically fetch and store historical stock prices using yfinance
+- **Multi-Currency Support**: Handle stocks traded in different currencies with automatic conversion
+- **Cash Management**: Maintain accurate cash balances accounting for buy/sell transactions and dividend payments
+- **Dividend Tracking**: Automatically capture and account for dividend payments
+- **Historical Analysis**: Query portfolio composition and value at any point in time
+- **Index Comparison**: Compare your portfolio returns against benchmark indices
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install FinTrack
+```
+
+## Quick Start
+
+### 1. Create a Transaction CSV File
+
+First, create a CSV file with your transactions (`transactions.csv`):
+
+```
+Date;Ticker;Type;Amount;Price
+2023-01-15;AAPL;Buy;10;150.00
+2023-02-20;MSFT;Buy;5;250.00
+2023-03-10;AAPL;Sell;5;165.00
+```
+
+**CSV Columns:**
+- `Date`: Transaction date (YYYY-MM-DD format)
+- `Ticker`: Stock ticker symbol
+- `Type`: Either "Buy" or "Sell"
+- `Amount`: Number of shares
+- `Price`: Price per share (in the stock's native currency)
+
+### 2. Initialize the Portfolio Tracker
+
+```python
+from portfolio_tracker import Portfolio_tracker
+import datetime
+
+# Initialize with starting cash and currency
+portfolio = Portfolio_tracker(
+    initial_cash=150000,
+    currency="SEK",  # Your portfolio's base currency
+    csv_file="transactions.csv"
+)
+
+# Update portfolio (fetches latest prices and processes new transactions)
+portfolio.update_portfolio()
+```
+
+### 3. Query Your Portfolio
+
+```python
+# Get current holdings
+current_holdings = portfolio.get_current_holdings()
+print(f"Current holdings: {current_holdings}")
+
+# Get all holdings ever owned
+all_holdings = portfolio.get_past_holdings()
+print(f"All past holdings: {all_holdings}")
+
+# Get portfolio value for a date range
+portfolio_values = portfolio.get_portfolio_value(
+    from_date=datetime.date(2023, 1, 1),
+    to_date=datetime.date(2023, 12, 31)
+)
+
+# Get cash balance at a specific date
+cash_balance = portfolio.get_portfolio_cash(datetime.date(2023, 6, 15))
+print(f"Cash balance: {cash_balance}")
+
+# Compare against index returns
+index_returns = portfolio.get_index_returns(
+    ticker="^GSPC",  # S&P 500
+    start_date=datetime.date(2023, 1, 1),
+    end_date=datetime.date(2023, 12, 31)
+)
+```
+
+## How It Works
+
+### Data Storage
+
+The package uses SQLite to store three main tables:
+
+1. **Portfolio Table**: Tracks holdings for each date based on transactions
+2. **Cash Table**: Maintains cash balance accounting for transactions and dividends
+3. **Prices Table**: Stores historical prices for all stocks in the portfolio
+
+### Price Management
+
+- Prices are automatically fetched from Yahoo Finance using yfinance
+- Multi-currency portfolios are supported with automatic conversion to your base currency
+- Prices are forward-filled for missing trading days
+- You can specify custom prices for specific dates by adding a "Prices" sheet to your CSV
+
+### Cash Flow Tracking
+
+Cash balance is updated for:
+- Stock purchases (cash out)
+- Stock sales (cash in)
+- Dividend payments (cash in)
+
+## Advanced Features
+
+### Custom Price Specifications
+
+You can specify custom prices for certain dates by including them in your transaction CSV. The package will use these instead of fetching from Yahoo Finance when available.
+
+### Portfolio Reset
+
+Reset your portfolio to start fresh:
+
+```python
+portfolio.reset_portfolio()
+```
+
+## Requirements
+
+- Python >= 3.7
+- pandas
+- yfinance
+
+## Supported Currencies
+
+The package supports any currency pair available on Yahoo Finance, including:
+- Major currencies: USD, EUR, GBP, JPY, CHF, AUD, CAD, SEK, NOK, DKK
+- Cryptocurrencies through crypto tickers
+- Emerging market currencies
+
+## Limitations
+
+- Prices are fetched from Yahoo Finance; ensure data quality
+- Intra-day trading is not supported (daily resolution only)
+- Corporate actions (stock splits, mergers) should be manually adjusted in transactions
+- Past dividend data depends on Yahoo Finance's historical dividend records
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request on GitHub.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Disclaimer
+
+Always verify your portfolio calculations independently. The author is not responsible for any financial losses resulting from the use of this software.
+
+## Support
+
+For issues, questions, or suggestions, please open an issue on the GitHub repository.

fintrack-1.0.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "FinTrack"
+version = "1.0.0"
+description = "A Python package for tracking a dynamic portfolio of stocks with daily price monitoring, cash management, and dividend handling"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "Aron Fredriksson", email = "arofre903@gmail.com"}
+]
+keywords = [
+    "portfolio",
+    "stock-tracking",
+    "finance",
+    "stocks",
+    "yfinance",
+    "investment"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dependencies = [
+    "pandas>=1.3.0",
+    "yfinance>=0.2.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/arofre/FinTrack"
+Repository = "https://github.com/arofre/FinTrack.git"
+"Bug Tracker" = "https://github.com/arofre/FinTrack/issues"
+Documentation = "https://github.com/arofre/FinTrack#readme"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+portfolio_tracker = ["py.typed"]

fintrack-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fintrack-1.0.0/setup.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python
+"""Setup script for FinTrack package."""
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="FinTrack",
+    version="1.0.0",
+    author="Aron Fredriksson",
+    author_email="arofre903@gmail.com",
+    description="A Python package for tracking a dynamic portfolio of stocks with daily price monitoring, cash management, and dividend handling",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/arofre/FinTrack",
+    project_urls={
+        "Bug Tracker": "https://github.com/arofre/FinTrack/issues",
+        "Documentation": "https://github.com/arofre/FinTrack#readme",
+        "Source Code": "https://github.com/arofre/FinTrack",
+    },
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Financial and Insurance Industry",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Office/Business :: Financial :: Investment",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "pandas>=1.3.0",
+        "yfinance>=0.2.0",
+    ],
+    keywords=[
+        "portfolio",
+        "stock-tracking",
+        "finance",
+        "stocks",
+        "yfinance",
+        "investment",
+    ],
+    zip_safe=False,
+)

fintrack-1.0.0/src/FinTrack/__init__.py

@@ -0,0 +1,36 @@
+"""FinTrack - A Python package for tracking stock portfolios."""
+
+__version__ = "1.0.0"
+__author__ = "Aron Fredriksson"
+__email__ = "arofre903@gmail.com"
+__license__ = "MIT"
+
+from .portfolio import FinTrack
+from .yf_tools import (
+    get_returns,
+    get_dividends,
+    get_exchange_rate,
+    get_currency_from_ticker,
+)
+from .parsing_tools import (
+    build_holding_table,
+    get_portfolio,
+    build_cash_table,
+    generate_price_table,
+    get_current_holdings_longnames,
+    get_past_holdings_longnames,
+)
+
+__all__ = [
+    "FinTrack",
+    "get_returns",
+    "get_dividends",
+    "get_exchange_rate",
+    "get_currency_from_ticker",
+    "build_holding_table",
+    "get_portfolio",
+    "build_cash_table",
+    "generate_price_table",
+    "get_current_holdings_longnames",
+    "get_past_holdings_longnames",
+]