monopyly 1.4.3__tar.gz → 1.4.5__tar.gz

{monopyly-1.4.3 → monopyly-1.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: monopyly
-Version: 1.4.3
+Version: 1.4.5
 Summary: A homemade personal finance manager.
 Project-URL: Download, https://pypi.org/project/monopyly
 Project-URL: Homepage, http://monopyly.com
@@ -23,14 +23,15 @@ Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Office/Business :: Financial :: Accounting
 Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
 Requires-Python: <3.11,>=3.10
-Requires-Dist: authanor>=1.0.2
-Requires-Dist: flask-wtf
-Requires-Dist: flask>=2.2.2
-Requires-Dist: fuisce>1.0.0
-Requires-Dist: gunicorn>=21.2.0
-Requires-Dist: markdown>=3.4.3
-Requires-Dist: python-dateutil
-Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: authanor==1.1.0
+Requires-Dist: flask-wtf==1.2.1
+Requires-Dist: flask==3.0.2
+Requires-Dist: fuisce==1.0.2
+Requires-Dist: gunicorn==21.2.0
+Requires-Dist: markdown==3.6
+Requires-Dist: python-dateutil==2.9.0
+Requires-Dist: rich==13.7.1
+Requires-Dist: sqlalchemy==2.0.29
 Description-Content-Type: text/markdown
 
 <div id="header">

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/__init__.py

@@ -1,6 +1,7 @@
 """
 Run a development server for the Monopyly app.
 """
+
 from flask import Flask
 
 from monopyly.config import DevelopmentConfig, ProductionConfig
@@ -38,7 +39,7 @@ def register_blueprints(app):
     """
     Register blueprints with the app.
 
-    Note
+    Notes
     -----
     Blueprints are imported in this function to avoid loading modules
     that require database models before those models have been set up

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/_version.py

@@ -1,4 +1,4 @@
 # file generated by setuptools_scm
 # don't change, don't track in version control
-__version__ = version = '1.4.3'
-__version_tuple__ = version_tuple = (1, 4, 3)
+__version__ = version = '1.4.5'
+__version_tuple__ = version_tuple = (1, 4, 5)

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/auth/blueprint.py

@@ -1,6 +1,7 @@
 """
 Flask blueprint for site authentication.
 """
+
 from flask import Blueprint
 
 # Define the blueprint

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/auth/routes.py

@@ -1,6 +1,7 @@
 """
 Routes for site authentication.
 """
+
 from flask import (
     current_app,
     flash,

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/auth/tools.py

@@ -1,6 +1,7 @@
 """
 Tools for dealing with the authorization blueprint.
 """
+
 import functools
 
 from flask import current_app, g, redirect, session, url_for

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/accounts.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with bank accounts in the database.
 """
+
 import sqlalchemy.sql.functions as sql_func
 from authanor.database.handler import DatabaseViewHandler
 from werkzeug.exceptions import abort
@@ -57,7 +58,7 @@ class BankAccountTypeHandler(
         query = query.join(BankAccount).join(Bank).distinct()
         # Get only types for the specified bank
         query = query.where(Bank.id == bank_id)
-        account_types = cls._db.session.execute(query).scalars()
+        account_types = cls._db.session.scalars(query)
         return account_types
 
     @classmethod

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/actions.py

@@ -1,4 +1,5 @@
 """Module describing logical banking actions (to be used in routes)."""
+
 from ..common.utils import convert_date_to_midnight_timestamp
 from .accounts import BankAccountHandler, BankAccountTypeHandler
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/banks.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with banks in the database.
 """
+
 from authanor.database.handler import DatabaseHandler
 
 from ..database.models import Bank

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/blueprint.py

@@ -1,6 +1,7 @@
 """
 Flask blueprint for bank financials.
 """
+
 from flask import Blueprint
 
 # Define the blueprint

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/filters.py

@@ -1,6 +1,7 @@
 """
 Filters defined for the banking blueprint.
 """
+
 from .blueprint import bp
 
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/forms.py

@@ -1,6 +1,7 @@
 """
 Generate banking forms for the user to complete.
 """
+
 from wtforms.fields import BooleanField, FieldList, FormField, StringField, SubmitField
 from wtforms.validators import DataRequired, Optional
 
@@ -162,7 +163,7 @@ class BankTransactionForm(TransactionForm):
         last_four_digits = LastFourDigitsField(
             "Last Four Digits", validators=[DataRequired()]
         )
-        type_name = StringField("AccountType", validators=[DataRequired()])
+        type_name = StringField("Account Type", validators=[DataRequired()])
 
         def get_account(self):
             """Get the bank account described by the form data."""

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/routes.py

@@ -1,6 +1,7 @@
 """
 Routes for banking financials.
 """
+
 from flask import jsonify, redirect, render_template, request, url_for
 from fuisce.database import db_transaction
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/banking/transactions.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with the bank transactions in the database.
 """
+
 from authanor.database.handler import DatabaseViewHandler
 
 from ..common.forms.utils import execute_on_form_validation

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/cli/apps.py

@@ -1,4 +1,5 @@
 """Application objects for running the app via the CLI."""
+
 import multiprocessing
 import subprocess
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/cli/run.py

@@ -75,6 +75,8 @@ class Launcher:
 
     def __init__(self, mode, host=None, port=None):
         app_type = self._application_types[mode]
+        if mode == "development":
+            self.command = self.command + ["--debug"]
         self.host = host if host else "127.0.0.1"
         self.port = port if port else app_type.default_port
         self.app = app_type(host=self.host, port=self.port)

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/forms/_forms.py

@@ -1,6 +1,7 @@
 """
 General form constructions.
 """
+
 from abc import ABC, abstractmethod
 
 from flask_wtf import FlaskForm
@@ -33,8 +34,8 @@ class EntryForm(FlaskForm, metaclass=AbstractEntryFormMixinMeta):
         """
         Generate a duplicate prepopulated form.
 
-        Note
-        ----
+        Notes
+        -----
         WTForms requires that a form be instantiated in order to be
         able to properly introspect fields. Because of this, this method
         will only return a duplicate form matching the type of the

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/forms/fields.py

@@ -1,6 +1,7 @@
 """
 General form constructions.
 """
+
 from abc import ABC, abstractmethod
 
 from flask_wtf import FlaskForm
@@ -25,6 +26,15 @@ class DateField(wtforms_fields.DateField):
         super().__init__(*args, filters=filters, **kwargs)
 
 
+class OptionalDateField(DateField):
+    """A date field where the field value is optional."""
+
+    def process_formdata(self, valuelist):
+        """Process data from the form, ignoring an ommitted value."""
+        if valuelist != [""]:
+            super().process_formdata(valuelist)
+
+
 class CurrencyField(wtforms_fields.DecimalField):
     """A decimal field with currency-specific customizations."""
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/forms/utils.py

@@ -1,6 +1,7 @@
 """
 General utility objects for handling forms.
 """
+
 from functools import wraps
 
 from flask import current_app, flash
@@ -73,7 +74,7 @@ class Autocompleter:
         """Get autocomplete suggestions for a field."""
         # Get information from the database to use for autocompletion
         query = model.select_for_user(getattr(model, field))
-        values = current_app.db.session.execute(query).scalars()
+        values = current_app.db.session.scalars(query)
         suggestions = sort_by_frequency([value for value in values])
         return suggestions
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/forms/validators.py

@@ -1,6 +1,7 @@
 """
 Commonly shared form validators.
 """
+
 from wtforms.validators import ValidationError
 
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/transactions.py

@@ -1,6 +1,7 @@
 """
 Tools for building a common transaction interface.
 """
+
 from abc import abstractmethod
 
 from authanor.database.handler import DatabaseHandler, DatabaseViewHandler
@@ -248,7 +249,7 @@ class TransactionTagHandler(DatabaseHandler, model=TransactionTag):
         # Filter the query to get only subtags of the given tag
         parent_id = tag.id if tag else None
         query = query.where(cls.model.parent_id == parent_id)
-        subtags = cls._db.session.execute(query).scalars()
+        subtags = cls._db.session.scalars(query)
         return subtags
 
     @classmethod

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/common/utils.py

@@ -1,8 +1,10 @@
 """
 General utility objects.
 """
+
 import datetime
 from collections import Counter
+from datetime import timezone
 
 from dateutil.relativedelta import relativedelta
 
@@ -109,7 +111,7 @@ class _DateParser:
 
 def convert_date_to_midnight_timestamp(date, milliseconds=False):
     """
-    Convert a date to the corresponding Unix timestamp (at midnight).
+    Convert a date to the corresponding Unix timestamp (at midnight UTC).
 
     Parameters
     ----------
@@ -123,10 +125,11 @@ def convert_date_to_midnight_timestamp(date, milliseconds=False):
     Returns
     -------
     timestamp : int
-        The timestamp corresponding to the given date (at midnight).
+        The timestamp corresponding to the given date (at midnight UTC).
     """
     midnight = datetime.datetime.min.time()
-    timestamp = int(datetime.datetime.combine(date, midnight).timestamp())
+    utc_datetime = datetime.datetime.combine(date, midnight, tzinfo=timezone.utc)
+    timestamp = int(utc_datetime.timestamp())
     if milliseconds:
         timestamp *= 1000
     return timestamp

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/config/default_settings.py

@@ -1,4 +1,5 @@
 """Default configuration settings."""
+
 import json
 from pathlib import Path
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/config/settings.py

@@ -1,4 +1,5 @@
 """A module containing objects with various configuration settings."""
+
 import warnings
 from pathlib import Path
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/actions.py

@@ -1,4 +1,5 @@
 """Module describing logical core actions (to be used in routes)."""
+
 from datetime import datetime
 
 import markdown

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/blueprint.py

@@ -1,6 +1,7 @@
 """
 Flask blueprint for core functionality.
 """
+
 from flask import Blueprint
 
 # Define the blueprint

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/context_processors.py

@@ -1,6 +1,7 @@
 """
 Filters defined for the application.
 """
+
 from datetime import date
 from importlib import import_module
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/filters.py

@@ -1,6 +1,7 @@
 """
 Filters defined for the application.
 """
+
 from .blueprint import bp
 
 
@@ -29,8 +30,8 @@ def make_ordinal(integer):
         -  21 => 21st
         -  101 => 101st
 
-    Note
-    ----
+    Notes
+    -----
     This function is an adaptation of the one proposed by Stack Overflow user
     Florian Brucker (https://stackoverflow.com/a/50992575/8754471).
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/internal_transactions.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with internal transactions in the database.
 """
+
 from flask import current_app
 from sqlalchemy import insert
 

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/core/routes.py

@@ -1,6 +1,7 @@
 """
 Routes for core functionality.
 """
+
 from pathlib import Path
 
 from flask import g, render_template, render_template_string, session

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/accounts.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with credit accounts in the database.
 """
+
 from authanor.database.handler import DatabaseHandler
 
 from ..database.models import CreditAccount

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/actions.py

@@ -1,4 +1,5 @@
 """Module describing logical credit actions (to be used in routes)."""
+
 from ..banking.transactions import record_new_transfer
 from ..common.forms.utils import execute_on_form_validation
 from .cards import CreditCardHandler

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/blueprint.py

@@ -1,6 +1,7 @@
 """
 Flask blueprint for credit card financials.
 """
+
 from flask import Blueprint
 
 # Define the blueprint

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/cards.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with credit cards in the database.
 """
+
 from authanor.database.handler import DatabaseHandler
 
 from ..common.forms.utils import execute_on_form_validation

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/forms.py

@@ -1,6 +1,7 @@
 """
 Generate credit card forms for the user to complete.
 """
+
 from werkzeug.exceptions import abort
 from wtforms.fields import (
     BooleanField,
@@ -18,8 +19,8 @@ from ..banking.forms import BankSelectField, BankSubform
 from ..common.forms import AcquisitionSubform, EntryForm, EntrySubform, TransactionForm
 from ..common.forms.fields import (
     CustomChoiceSelectField,
-    DateField,
     LastFourDigitsField,
+    OptionalDateField,
     StringField,
 )
 from ..common.forms.utils import Autocompleter
@@ -69,13 +70,20 @@ class CreditCardForm(EntryForm):
         statement_issue_day = IntegerField("Statement Issue Day", [Optional()])
         statement_due_day = IntegerField("Statement Due Day", [Optional()])
 
-        def validate(self, *args, **kwargs):
-            """Validate the subform."""
-            # Unset subform `CustomChoiceSelectField` values will be invalid
+        def validate(self, extra_validators=None):
+            """
+            Validate the subform.
+
+            Notes
+            -----
+            Unset values on the ``CustomChoiceSelectField`` will take a
+            default value that will be considered to be invalid. They
+            must be replaced (after processing) with the inferred value.
+            """
             if self.bank_info.bank_id.data == -1:
                 account = self.get_account()
                 self.bank_info.bank_id.data = account.bank.id
-            return super().validate(*args, **kwargs)
+            return super().validate(extra_validators=extra_validators)
 
         def get_account(self):
             return self._produce_entry_from_field("account_id")
@@ -185,7 +193,7 @@ class CreditTransactionForm(TransactionForm):
         # Fields to identify the card/bank information for the statement
         card_info = FormField(CardSubform)
         # Fields pertaining to the statement
-        issue_date = DateField("Statement Date")
+        issue_date = OptionalDateField("Statement Date")
 
         def get_statement(self, transaction_date):
             """Get the credit card statement described by the form data."""

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/routes.py

@@ -1,6 +1,7 @@
 """
 Routes for credit card financials.
 """
+
 from itertools import islice
 
 from flask import flash, g, jsonify, redirect, render_template, request, url_for

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/statements.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with the credit statements in the database.
 """
+
 from authanor.database.handler import DatabaseViewHandler
 
 from ..common.utils import get_next_occurrence_of_day

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/transactions/__init__.py

@@ -1,4 +1,5 @@
 """
 Tools for interacting with the credit transactions in the database.
 """
+
 from ._transactions import CreditTagHandler, CreditTransactionHandler, save_transaction

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/credit/transactions/_transactions.py

@@ -1,6 +1,7 @@
 """
 Tools for interacting with the credit transactions in the database.
 """
+
 from authanor.database.handler import DatabaseHandler, DatabaseViewHandler
 
 from ...common.forms.utils import execute_on_form_validation

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/database/__init__.py

@@ -1,6 +1,7 @@
 """
 Expose commonly used database functionality to the rest of the package.
 """
+
 import sqlite3
 from pathlib import Path
 
@@ -49,7 +50,7 @@ class SQLAlchemy(_SQLAlchemy):
         super().initialize(app)
 
 
-SQLAlchemy.create_default_interface()
+SQLAlchemy.create_default_interface(echo_engine=False)
 
 
 @click.command("init-db")

{monopyly-1.4.3 → monopyly-1.4.5}/monopyly/database/models.py

@@ -1,5 +1,6 @@
 from authanor.database.models import AuthorizedAccessMixin, Model
 from sqlalchemy import Column, Date, Float, ForeignKey, Integer, String, Table
+from sqlalchemy.ext.hybrid import hybrid_property
 from sqlalchemy.orm import mapped_column, relationship
 
 
@@ -72,6 +73,8 @@ class TransactionTag(AuthorizedAccessMixin, Model):
     parent_id = mapped_column(Integer, ForeignKey("transaction_tags.id"))
     tag_name = mapped_column(String, nullable=False)
     # Relationships
+    parent = relationship("TransactionTag", back_populates="children", remote_side=[id])
+    children = relationship("TransactionTag", back_populates="parent")
     bank_subtransactions = relationship(
         "BankSubtransaction",
         secondary=bank_tag_link_table,
@@ -83,6 +86,13 @@ class TransactionTag(AuthorizedAccessMixin, Model):
         back_populates="tags",
     )
 
+    @property
+    def depth(self):
+        tag, depth = self, 0
+        while (tag := tag.parent) is not None:
+            depth += 1
+        return depth
+
 
 class Bank(AuthorizedAccessMixin, Model):
     __tablename__ = "banks"
@@ -256,6 +266,7 @@ class BankTransactionView(AuthorizedAccessMixin, Model):
     subtransactions = relationship(
         "BankSubtransaction",
         back_populates="transaction",
+        lazy="selectin",
     )
 
 
@@ -281,6 +292,7 @@ class BankSubtransaction(AuthorizedAccessMixin, Model):
         "TransactionTag",
         secondary=bank_tag_link_table,
         back_populates="bank_subtransactions",
+        lazy="selectin",
     )
 
 
@@ -429,6 +441,7 @@ class CreditTransactionView(AuthorizedAccessMixin, Model):
     subtransactions = relationship(
         "CreditSubtransaction",
         back_populates="transaction",
+        lazy="selectin",
     )
 
 
@@ -460,4 +473,5 @@ class CreditSubtransaction(AuthorizedAccessMixin, Model):
         "TransactionTag",
         secondary=credit_tag_link_table,
         back_populates="credit_subtransactions",
+        lazy="selectin",
     )