• Read currency exchange rates from pricedb
• use for cash account balance calculation
• use for stock value calculation

Add the setting for default currency, and perhaps a cli parameter.
The currency is currently hard-coded.

• compare class allocation to the sum of children's allocation

As noted in #1, the price database will need to be external. Perhaps another tool, that populates the data?

• Look into Finance::Quote scripts.
• GnuCash book has a price database
• Separate project? (again, shared for Android MMEX and PC)

When using --full parameter, for Cash asset class, display line per currency.

One stock can belong to multiple asset classes. I.e. a bond fund belongs 60% to international and 40% to domestic bonds.

Configuration file is required in order not to constantly repeat parameters.

• create configuration file
• add logic for reading the configuration values
• add option for the location of the database, with default value.
• add option for the location of the Price database.
• add cli command for editing config value? It is easier to edit it via text editor.
• add cli command for deleting the current user's file (when run the next time, it will be created automatically)
• add cli command to set the aa db path

Since the default option is to output ASCII-formatted asset allocation report, a parameter would allow formatting the output as HTML.
Only works with the print (default) option.

--output html

Use Price Db library for storing and fetching the security prices.

Accept a date parameter and request prices on this day, to allow displaying historical reports.

To the package setup.

• Get the parser from GnuCash Portfolio project.
• load values from GC book
• load prices from price db

Instead of assembling the rows, create a view model that is to be used for display.
The model is a display row, with columns as properties. Simple string values?

Allow editing asset class from cli.
If modifying Allocation, always recalculate total. It has to be 100%. Provide a Warning if it does not. Exception would block editing while Warning allows the user to modify another record and correct the allocation.

aa edit "id" --allocation "10"

Create a package so that it is available to other projects.

Links:

• distributing packages
• How to create a python package

Try some of the available options on Android, based on the list:

• Chaquopy. Android Studio plugin. Builds into a native Android app.
• PyBee
  VOC => transpiles single modules into .class files. Does not convert the project dependencies but only individual python modules. Errors when running. No go.
• Kivy
  • Python for Android. Compiles only on Linux.
  • Buildozer
• QPython; can not install SQLAlchemy.
• PyDroid. Interpreter on Android. Works!
• Termux <= works! This is the option of choice.

Allow creating an asset class record through cli.

• create asset class with minimum attributes, i.e. name. Others are set to default and can be modified by editing.
• auto-assign and return id on creation

aa add "asset class name" --parent "id"

Depends on #5.

check the values manually:

• stock value
• currency calculation
• ac sum of stock values
• allocation diff calculation
• % calculation (set value)

In addition to #16, allow displaying stock information for each asset class:

• name/symbol
• current value
• current %, based on value

Indent stock info one level below each class. This is not shown by default but a switch enables it.

the show option displays an ascii report for asset allocation

Depends on #2 to get the aa tree.

This is intended for GnuCash Portfolio.

for each asset class calculate current allocation and difference to set allocation.

between allocated % / value and current.
add columns to the output
this is used for threshold (i.e. 20% diff triggers a notification)

Generate schema with SQLAlchemy. After #1, this is the next step in accessing the data store.

Links:

• First steps with SQLAlchemy
• SQLAlchemy quick start

Allow a command-line interface (CLI) for easy testing and use.

• the default action is to display the standard allocation report (this is the main output)
• Try it on Android.
• add option to output HTML

Links:

• Check Click

Setting for the default currency

From alensiljak/gnucash-portfolio#44.

Allow manual adjustments (buffers) to allocation difference amounts.
This is used when switching allocations but do not want to make an immediate transfer but freeze the amount based on the current prices.
The resulting amount will then depend on the price swings. When allocation is increased by purchasing more stock, the adjustment can be modified.

Create a data store for asset allocation. Use the implementation from MoneyManagerEx for Android for start.

In order to get the cash asset class amount, there must be a setting that lists the cash accounts to use.
Options:

• specify all the cash accounts to use
• specify one, top-level, account to use for cash

The second option should work well, unless there is a specific need to list multiple accounts explicitly.

Find holdings that are not part of asset allocation.
These are securities (non-currency) that

• exist in the book
• have non-zero balance
• are not found in the aa mapping table (stock links)

When loading the currency rates, use the currency parameter to locate the correct currency pair. This is for safety in case there are rates expressed in multiple currencies.

Compare the report to the one in MMEX for Android and identify any discrepancies.
Also compare to GC Portfolio.

Option to display the Asset Class tree with IDs, assigned allocations.

This text file can be used by pricedb to download prices.

allow setting difference threshold (i.e. 20%)
and mark the rows in the output, with difference % larger than this value

Create a method for AA model validation.
It can be called via CLI explicitly. It is also utilized at some key points in the app. The validation errors are not exceptions but are reported to the user so that they can be mitigated.

Especially useful when the partial allocation is implemented as it will ensure that the value of any specific symbol is correctly allocated among asset classes.

publish via Pip, as a precursor to #22.