klnote 0.2.0__tar.gz → 0.3.0__tar.gz

{klnote-0.2.0 → klnote-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: klnote
-Version: 0.2.0
+Version: 0.3.0
 Summary: Stock note management tool
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -38,12 +38,17 @@ pip install klnote
 klnote stk ls              # 列出所有股票
 klnote stk add 000001 -n 平安银行    # 添加股票
 klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
 
 # 笔记操作
 klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
 klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
 ```
 
 ## 数据库
@@ -66,7 +71,9 @@ klnote --help
 klnote stk ls                       # 列出所有股票（表格对齐）
 klnote stk add <code> [-n name] [-d desc]   # 添加股票
 klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
 ```
 
 **输出示例：**
@@ -80,7 +87,9 @@ klnote stk delete <identifier>      # 删除股票
 ```
 klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
 klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
 ```
 
 ### 高级操作 (admin)

{klnote-0.2.0 → klnote-0.3.0}/README.md

@@ -27,12 +27,17 @@ pip install klnote
 klnote stk ls              # 列出所有股票
 klnote stk add 000001 -n 平安银行    # 添加股票
 klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
 
 # 笔记操作
 klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
 klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
 ```
 
 ## 数据库
@@ -55,7 +60,9 @@ klnote --help
 klnote stk ls                       # 列出所有股票（表格对齐）
 klnote stk add <code> [-n name] [-d desc]   # 添加股票
 klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
 ```
 
 **输出示例：**
@@ -69,7 +76,9 @@ klnote stk delete <identifier>      # 删除股票
 ```
 klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
 klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
 ```
 
 ### 高级操作 (admin)

klnote-0.3.0/klnote/__init__.py

@@ -0,0 +1,3 @@
+__version__ = "0.3.0"
+__author__ = "zimvir"
+__email__ = "zimvir@qq.com"

{klnote-0.2.0 → klnote-0.3.0}/klnote/cli.py

@@ -1,8 +1,10 @@
+
 import click
 
 from prettytable import PrettyTable
 
-from klnote.core import Service
+from .core import Service
+from .core.utils.time_1 import format_iso
 
 
 service = Service()
@@ -35,20 +37,17 @@ def ls():
     pt.align = "l"
     pt.horizontal_char = '-'
     pt.border = False
-    for s in stocks:
-
-        rows = [
-            [
-            s.get("id") or "None",
-            s.get("code") or "None",
-            s.get("name") or "None",
-            s.get("description") or "None",
-            str(len(s.get("notes") or [])),
-            s.get("created_at") or "None",
-            s.get("updated_at") or "None"
-            ] for s in stocks
-        ]
-        pt.add_rows(rows)
+
+    rows =[[
+        s.get("id") or "None",
+        s.get("code") or "None",
+        s.get("name") or "None",
+        s.get("description") or "None",
+        str(len(s.get("notes") or [])),
+        s.get("created_at") or "None",
+        s.get("updated_at") or "None"
+        ]for s in stocks]
+    pt.add_rows(rows)
     click.echo(pt)
 
 
@@ -83,6 +82,53 @@ def get(identifier):
 
 @stk.command()
 @click.argument('identifier')
+def get_meta(identifier):
+    """查看股票 metadata（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        s = service.stock_show(stock_id)
+        metadata = s.get("metadata", {})
+        click.echo(f"ID: {stock_id}")
+        for k, v in metadata.items():
+            click.echo(f"  {k}: {v}")
+        click.echo("-"*50)
+
+
+@stk.command()
+@click.argument('identifier')
+@click.option('--code', default=None, help='股票代码')
+@click.option('--name', default=None, help='股票名称')
+@click.option('--country', default=None, help='国家')
+@click.option('--label', default=None, help='标签, 如中国A股：A')
+def set_meta(identifier, code, name, country, label):
+    """更新股票 metadata（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        kwargs = {}
+        if code is not None:
+            kwargs["code"] = code
+        if name is not None:
+            kwargs["name"] = name
+        if country is not None:
+            kwargs["country"] = country
+        if label is not None:
+            kwargs["label"] = label
+        if not kwargs:
+            click.echo("请至少指定一个要更新的字段")
+            continue
+        service.update_metadata(stock_id, **kwargs)
+        click.echo(f"已更新 metadata")
+        click.echo("-"*50)
+
+
+@stk.command('del')
+@click.argument('identifier')
 def delete(identifier):
     """删除股票（支持 id/code/name）"""
     stock_ids = service.match_by_identifier(identifier)
@@ -131,16 +177,44 @@ def ls(stock_identifier):
             continue
         for i, n in enumerate(notes):
             click.echo(f"索引： {i}")
-            click.echo(f"创建时间: {n.get('created_at', '')}")
+            click.echo(f"创建时间: {format_iso(n.get('created_at', ''))}")
+            click.echo(f"更新时间: {format_iso(n.get('updated_at', ''))}")
             click.echo(f"摘要: {n.get('summary', '')}")
             if n.get('content'):
                 click.echo(f"内容： \n    {n.get('content', '')}")
+
             click.echo("-"*50)
 
 
 @note.command()
 @click.argument('stock_identifier')
 @click.argument('index', type=int)
+def read(stock_identifier, index):
+    """读取单条笔记（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        notes = service.note_read(stock_id)
+        if index < 0 or index >= len(notes):
+            click.echo(f"索引 {index} 不存在")
+            continue
+        n = notes[index]
+        click.echo(f"索引： {index}")
+        click.echo(f"创建时间: {format_iso(n.get('created_at', ''))}")
+        click.echo(f"更新时间: {format_iso(n.get('updated_at', ''))}")
+
+        click.echo(f"摘要: {n.get('summary', '')}")
+        if n.get('content'):
+            click.echo(f"内容：\n    {n.get('content', '')}")
+
+        click.echo("-"*50)
+
+
+@note.command('del')
+@click.argument('stock_identifier')
+@click.argument('index', type=int)
 def delete(stock_identifier, index):
     """删除笔记（支持 id/code/name）"""
     stock_ids = service.match_by_identifier(stock_identifier)
@@ -152,6 +226,27 @@ def delete(stock_identifier, index):
         click.echo(f"已删除第 {index} 条笔记")
         click.echo("-" * 50)
 
+
+@note.command()
+@click.argument('stock_identifier')
+@click.argument('index', type=int)
+@click.option('-s', '--summary', default=None, help='笔记摘要')
+@click.option('-c', '--content', default=None, help='笔记内容')
+@click.option('-e', '--editer', is_flag=True, help='弹出 GUI 编辑器')
+def edit(stock_identifier, index, summary, content, editer):
+    """编辑笔记（支持 id/code/name）"""
+    if not content and not summary and not editer:
+        click.echo("请指定 --content 或 --summary 或 --editer")
+        return
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        service.note_edit(stock_id, index, content=content, summary=summary, editer=editer)
+        click.echo(f"已编辑第 {index} 条笔记")
+        click.echo("-" * 50)
+
 # ============= admin 组 =============
 @cli.group()
 def admin():

{klnote-0.2.0 → klnote-0.3.0}/klnote/core/service.py

@@ -55,6 +55,21 @@ class Service:
     def stock_add(self, code: str, id: str = None, name: str = None, description: str = None):
         """新建股票条目"""
         self.db.create_and_add_new_stock_row(code=code, id=id, name=name, description=description)
+        stock_ids = self.match_by_id_code_name(id=id, code=code, name=name)
+        if stock_ids:
+            self.update_metadata(stock_ids[0], code=code, name=name)
+        return self
+
+    def update_metadata(self, stock_id: str, **kwargs):
+        """更新股票的 metadata 字段
+
+        :param stock_id: 股票 ID
+        :param kwargs: 任意 key=value，如 code="000001", name="平安银行", country="CN"
+        """
+        stock = self.stock_show(stock_id)
+        metadata = stock.get("metadata", {})
+        metadata.update(kwargs)
+        self.db.update(stock_id, "metadata", json.dumps(metadata))
         return self
 
     def stock_delete(self, id: str):
@@ -82,6 +97,10 @@ class Service:
             "extra": extra or {}
         }
 
+    def touch_updated_at(self, stock_id: str):
+        """更新股票的 updated_at 时间戳"""
+        self.db.update(stock_id, "updated_at", get_iso_timestamp())
+
     def note_add(self, stock_id: str, content: str, summary: str = None, extra: dict = None):
         """给股票添加一条笔记"""
         stock = self.stock_show(stock_id)
@@ -89,6 +108,7 @@ class Service:
         note = self._build_note(content, summary, extra)
         notes.append(note)
         self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
         return self
 
     def note_delete(self, stock_id: str, index: int):
@@ -97,6 +117,30 @@ class Service:
         notes = stock.get("notes", [])
         notes.pop(index)
         self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
+        return self
+
+    def note_edit(self, stock_id: str, index: int, content: str = None, summary: str = None, editer: bool = False):
+        """编辑股票指定索引的笔记"""
+        stock = self.stock_show(stock_id)
+        notes = stock.get("notes", [])
+        if index < 0 or index >= len(notes):
+            raise IndexError(f"笔记索引 {index} 不存在")
+        if editer:
+            from .utils.editor import edit_in_editor
+            edited = edit_in_editor(initial_content=notes[index].get("content") or "")
+            if edited is None:
+                return self
+            content = edited
+        now = get_iso_timestamp()
+        if content is not None:
+            notes[index]["content"] = content
+            notes[index]["updated_at"] = now
+        if summary is not None:
+            notes[index]["summary"] = summary
+            notes[index]["updated_at"] = now
+        self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
         return self
 
     def _read_notes(self, stock_id: str) -> list:

klnote-0.3.0/klnote/core/utils/time_1.py

@@ -0,0 +1,21 @@
+import os
+from datetime import datetime, timezone
+
+
+def get_iso_timestamp(microseconds=True):
+    """自定义是否包含微秒"""
+    if microseconds:
+        return datetime.now(timezone.utc).isoformat(timespec='microseconds').replace('+00:00', 'Z')
+    else:
+        return datetime.now(timezone.utc).isoformat(timespec='seconds').replace('+00:00', 'Z')
+
+
+def format_iso(iso_str: str | None) -> str:
+    """将 ISO 时间戳解码为本地可读格式，如 '2026-06-09 14:30:00'"""
+    if not iso_str:
+        return ""
+    try:
+        dt = datetime.fromisoformat(iso_str.replace('Z', '+00:00'))
+        return dt.strftime("%Y-%m-%d %H:%M:%S")
+    except (ValueError, TypeError):
+        return iso_str

{klnote-0.2.0 → klnote-0.3.0}/klnote.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: klnote
-Version: 0.2.0
+Version: 0.3.0
 Summary: Stock note management tool
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -38,12 +38,17 @@ pip install klnote
 klnote stk ls              # 列出所有股票
 klnote stk add 000001 -n 平安银行    # 添加股票
 klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
 
 # 笔记操作
 klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
 klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
 ```
 
 ## 数据库
@@ -66,7 +71,9 @@ klnote --help
 klnote stk ls                       # 列出所有股票（表格对齐）
 klnote stk add <code> [-n name] [-d desc]   # 添加股票
 klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
 ```
 
 **输出示例：**
@@ -80,7 +87,9 @@ klnote stk delete <identifier>      # 删除股票
 ```
 klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
 klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
 ```
 
 ### 高级操作 (admin)

{klnote-0.2.0 → klnote-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "klnote"
-version = "0.2.0"
+version = "0.3.0"
 description = "Stock note management tool"
 requires-python = ">=3.10"
 dependencies = [

klnote-0.2.0/klnote/__init__.py

@@ -1,3 +0,0 @@
-__version__ = "0.2.0"
-__author__ = "zimvir"
-__email__ = "zimvir@qq.com"

klnote-0.2.0/klnote/core/utils/time_1.py

@@ -1,8 +0,0 @@
-import os
-from datetime import datetime, timezone
-def get_iso_timestamp(microseconds=True):
-    """自定义是否包含微秒"""
-    if microseconds:
-        return datetime.now(timezone.utc).isoformat(timespec='microseconds').replace('+00:00', 'Z')
-    else:
-        return datetime.now(timezone.utc).isoformat(timespec='seconds').replace('+00:00', 'Z')