coder-firefly-cli 1.1.0__tar.gz → 1.1.2__tar.gz

{coder_firefly_cli-1.1.0 → coder_firefly_cli-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coder-firefly-cli
-Version: 1.1.0
+Version: 1.1.2
 Summary: Firefly III CLI - 个人财务管理命令行工具
 Home-page: https://github.com/joyous-coder/coder-firefly-cli
 Author: coder

{coder_firefly_cli-1.1.0 → coder_firefly_cli-1.1.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="coder-firefly-cli",
-    version="1.1.0",
+    version="1.1.2",
     description="Firefly III CLI - 个人财务管理命令行工具",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",

{coder_firefly_cli-1.1.0 → coder_firefly_cli-1.1.2}/src/coder_firefly_cli/commands/accounts.py

@@ -47,22 +47,32 @@ def accounts_get(id):
               help="账户类型")
 @click.option("--currency-code", default="USD", help="货币代码 (ISO 4217)")
 @click.option("--opening-balance", default="0", help="初始余额")
+@click.option("--opening-balance-date", help="开户日期 (YYYY-MM-DD)，当 --opening-balance 非 0 时必填")
 @click.option("--account-role", help="账户角色 (用于资产账户)")
 @click.option("--iban", help="IBAN")
 @click.option("--bic", help="BIC")
 @click.option("--account-number", help="账户号码")
 @click.option("--notes", help="备注")
-def accounts_create(name, type, currency_code, opening_balance, account_role, iban, bic, account_number, notes):
+def accounts_create(name, type, currency_code, opening_balance, opening_balance_date, account_role, iban, bic, account_number, notes):
     """创建新账户"""
     client = get_client()
-    
+
+    # 当 --opening-balance 非默认值 0 时，要求同时提供 --opening-balance-date
+    # Firefly III 后端会拒绝创建带余额但无开户日期的账户 (422)
+    if opening_balance and opening_balance != "0" and not opening_balance_date:
+        raise click.UsageError(
+            "当 --opening-balance 非 0 时，必须同时指定 --opening-balance-date (YYYY-MM-DD)"
+        )
+
     data = {
         "name": name,
         "type": type,
         "currency_code": currency_code,
         "opening_balance": opening_balance,
     }
-    
+
+    if opening_balance_date:
+        data["opening_balance_date"] = opening_balance_date
     if account_role:
         data["account_role"] = account_role
     if iban:

{coder_firefly_cli-1.1.0 → coder_firefly_cli-1.1.2}/src/coder_firefly_cli/commands/transactions.py

@@ -74,12 +74,15 @@ def transactions_create(description, amount, source_account, destination_account
     """创建新交易"""
     client = get_client()
 
+    # 始终在 transaction_data 内部设置 group_title=""，避免 Firefly III
+    # 自动将 description 复制为 group_title，导致首页显示 "xxx: xxx"
     transaction_data = {
         "type": type,
         "date": date,
         "amount": amount,
         "description": description,
         "source_id": source_account,
+        "group_title": group_title if group_title else "",
     }
 
     if destination_account:
@@ -101,11 +104,6 @@ def transactions_create(description, amount, source_account, destination_account
         "transactions": [transaction_data]
     }
 
-    # 仅当显式传入 --group-title 时才设置分组标题
-    # 不传则避免和 description 重复导致首页显示 "描述: 描述"
-    if group_title:
-        data["group_title"] = group_title
-
     result = client.create_transaction(data)
     output(result)
 
@@ -117,7 +115,9 @@ def transactions_create(description, amount, source_account, destination_account
 @click.option("--category", help="分类名称")
 @click.option("--tags", help="标签 (逗号分隔)")
 @click.option("--notes", help="备注")
-def transactions_update(id, description, amount, category, tags, notes):
+@click.option("--group-title", "group_title", default=None,
+              help="分组标题（可选）。传空字符串可清空分组标题，解决首页 '描述: 描述' 冗余问题。")
+def transactions_update(id, description, amount, category, tags, notes, group_title):
     """更新现有交易"""
     client = get_client()
 
@@ -132,6 +132,9 @@ def transactions_update(id, description, amount, category, tags, notes):
         transaction_data["tags"] = [tag.strip() for tag in tags.split(",")]
     if notes:
         transaction_data["notes"] = notes
+    # 仅当显式传入 group_title（包含空字符串）时才设置
+    if group_title is not None:
+        transaction_data["group_title"] = group_title
 
     if not transaction_data:
         click.echo("错误: 至少需要提供一个更新字段", err=True)

{coder_firefly_cli-1.1.0 → coder_firefly_cli-1.1.2}/src/coder_firefly_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coder-firefly-cli
-Version: 1.1.0
+Version: 1.1.2
 Summary: Firefly III CLI - 个人财务管理命令行工具
 Home-page: https://github.com/joyous-coder/coder-firefly-cli
 Author: coder