1
0
fin-depo/setup.py
takunomi-build-bot ef9aa91499
All checks were successful
Python Ruff Code Quality / ruff (push) Successful in 22s
Verify Python project can be installed, loaded and have version checked / Test (push) Successful in 23s
Run Python tests (through Pytest) / Test (push) Successful in 27s
🤖 Repository layout updated to latest version
This commit was automatically generated by a script: https://gitfub.space/Jmaa/repo-manager
2024-11-29 01:27:46 +01:00

145 lines
5.1 KiB
Python

# WARNING
#
# THIS IS AN AUTOGENERATED FILE.
#
# MANUAL CHANGES CAN AND WILL BE OVERWRITTEN.
import re
from setuptools import setup
PACKAGE_NAME = 'fin_depo'
PACKAGE_DESCRIPTION = """
# Financial Depository Fetchers.
Python library for programmatic download of asset position information from
personal depository accounts.
This library is a core part of my personal financial applications, as it allows
me to monitor my investments on financial markets and web3 investments.
A lot can be said (mostly negative) about web3, but at least they are serious
about API access, which the modern banking system is not great at providing.
Even in The European Union, where GDPR is law and OpenBanking is a requirement,
it is hugely difficult for ordinary people to access and control their own
personal financial information.
This is a library; if you want a simple program for downloading the information
exposed by one of the supported services, try [my personal-data-fetchers
program](https://gitfub.space/Jmaa/personal-data-fetchers).
## Supported websites/services
| Service | Description | Read assets | Swap assets |
| :-: | --- | :-: | :-: |
| [**Kraken**](https://www.kraken.com/) | Crypto-currency exchange (`KrakenDepoFetcher`): Uses their [publicly documented API](https://docs.kraken.com/rest/). This provides the same data as the homepage. | ✅︎ | |
| [**Kucoin**](https://www.kucoin.com/) | Crypto-currency exchange (`KucoinDepoFetcher`): Uses their [publicly documented API](https://www.kucoin.com/docs/beginners/introduction). This provides the same data as is available on the Assets Overview Page. This fetcher also allows for placing market orders, but be careful with this functionality. | ✅︎ | ✅︎ |
| [**Partisia Blockchain**](https://browser.partisiablockchain.com/) | Wallet balances on Partisia Blockchain (`PartisiaBlockchainAccountDepoFetcher`): Uses a public reader node to check the account state. This is the same data as can be found in the Partisia Browser Assets page. | ✅︎ | |
| [**Nordnet**](https://www.nordnet.dk) | Nordic investment bank (`NordnetDepoFetcher`): Uses their [API](https://www.nordnet.dk/externalapi/docs/api). Thanks to [Morten Helmstedt](https://helmstedt.dk/) for sharing his [Nordnet utilities](https://github.com/helmstedt/nordnet-utilities), which helped with implementing this functionality. Exposes the same data as the home page. | ✅︎ | |
## Example Application
The library ships with an example application in the form of a CLI program that
can display a tree representation of assets in known depositories:
```bash
python -m fin_depo
```
Example output:
```
Aggregated
├─ Kraken
│ ├─ BTC 0.00871009
│ └─ EUR 200.5
└─ Kucoin
├─ Kucoin trade
│ ├─ BTC 0.00169297
│ └─ USDT 20
└─ Kucoin main
├─ BTC 0
└─ USDT 40
```
## Usage
Using the Kraken API as an example:
```python
depo_fetcher = fin_depo.defi_kraken.KrakenDepoFetcher(
KRAKEN_KEY, KRAKEN_SECRET,
)
depo = depo_fetcher.get_depo()
depo.assets()
> [BTC, USDT]
depo.get_amount_of_asset(BTC)
> 0.1
```
## Future extension
- [ ] Investment Bank: Saxo Bank OpenAPI
- [ ] Personal Bank: Personal Bank Account (Open Banking).
* Maybe using [Enable Banking](https://enablebanking.com/)? They seem to
allow developers to access their own accounts in a sort of half production
half demo environment.
* [AIIA](https://www.aiia.eu/) is also a possiblity?
- [ ] Partisia Blockchain: Implement sharding routing correctly.
- [ ] Depository history: Allow users to query both the state of their deposity
in the past, and to allow them to query the transactions.
* Most backends only support listing the transactions themselves, so the
depository history needs to be computed backwards from these.
""".strip()
PACKAGE_DESCRIPTION_SHORT = """
Python library for programmatic download of asset position information from
personal depository accounts.""".strip()
def parse_version_file(text: str) -> str:
match = re.match(r'^__version__\s*=\s*(["\'])([\d\.]+)\1$', text)
if match is None:
msg = 'Malformed _version.py file!'
raise Exception(msg)
return match.group(2)
with open(PACKAGE_NAME + '/_version.py') as f:
version = parse_version_file(f.read())
REQUIREMENTS_MAIN = [
'enforce-typing',
'python-kucoin',
'krakenex',
'frozendict',
'fin-defs @ git+https://gitfub.space/Jmaa/fin-defs.git',
]
REQUIREMENTS_TEST = [
'pytest',
'secret_loader @ git+https://gitfub.space/Jmaa/secret_loader.git',
]
setup(
name=PACKAGE_NAME,
version=version,
description=PACKAGE_DESCRIPTION_SHORT,
long_description=PACKAGE_DESCRIPTION,
long_description_content_type='text/markdown',
author='Jon Michael Aanes',
author_email='jonjmaa@gmail.com',
url='https://gitfub.space/Jmaa/' + PACKAGE_NAME,
packages=[PACKAGE_NAME],
install_requires=REQUIREMENTS_MAIN,
extras_require={
'test': REQUIREMENTS_TEST,
},
python_requires='>=3.9',
)