Correct docstrings/comments and ignore jinja2 vulnerability

Author: Iain-S

.safety-policy.yml

@@ -30,7 +30,7 @@ report:
           reason: We cannot currently use SQL Alchemy v2.
           expires: '2024-12-12'
         70612:
-          reason: No known fix for jinja2==3.1.4.
+          reason: We do not use untrusted templates that would require the from_string() method.
           expires: '2024-12-12'
 
 

rctab/routers/accounting/routes.py

@@ -426,7 +426,7 @@ def get_approvals(sub_id: UUID) -> Select:
 
 @db_select
 def get_finance(sub_id: UUID) -> Select:
-    """Get all finance items."""
+    """Get all finance items for a subscription."""
     return (
         select(
             [
@@ -446,8 +446,7 @@ def get_finance(sub_id: UUID) -> Select:
 
 @db_select
 def get_costrecovery(sub_id: UUID) -> Select:
-    """Get all cost recovery items for a subscription in asc date order."""
-    # order by month asc
+    """Get all cost recovery items for a subscription."""
     return (
         select(
             [
@@ -466,7 +465,7 @@ def get_costrecovery(sub_id: UUID) -> Select:
 
 @db_select
 def get_usage(sub_id: UUID, target_date: datetime.datetime) -> Select:
-    """Get all of the usage items."""
+    """Get all usage items for a subscription."""
     return (
         select(
             [