chartflow 0.1__tar.gz

chartflow-0.1/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: chartflow
+Version: 0.1
+Summary: Self-use. with fsm. node. chart. edit. Used for fsm and run, structure graph. use pyqt to show and interact
+Author-email: 2229066748@qq.com
+Maintainer: Eagle'sBaby
+Maintainer-email: 2229066748@qq.com
+License: Apache Licence 2.0
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: PyQt6
+Requires-Dist: efr
+Requires-Dist: colorama
+Requires-Dist: Pillow
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

chartflow-0.1/chartflow/__init__.py

@@ -0,0 +1,28 @@
+"""
+chartflow - Finite state machine + flow chart library
+
+Standalone extraction of qwork's qfsm (state-machine engine) and qflow
+(flow-chart / node-graph layer), bundled with the qnode (node canvas) and
+pyedit (Python code editor) widgets they rely on, so the whole package is
+self-contained.
+
+Subpackages:
+    chartflow.fsm   - state machine: Stage, Logic, Scheduler, decorators, events
+    chartflow.flow  - flow charts: IChart/Chart, QFlowChart, StageEditor
+    chartflow.node  - node canvas GUI (NodeCanvas, NodeItem, ...)
+    chartflow.edit  - Python code editor widget (PythonEditor, ...)
+
+Importing the top-level package re-exports the fsm and flow APIs::
+
+    from chartflow import Stage, Logic, Scheduler, QFlowChart
+
+The node and edit widgets are imported explicitly when needed::
+
+    from chartflow.node import NodeCanvas
+    from chartflow.edit import PythonEditor
+"""
+
+from chartflow.fsm import *   # noqa: F401,F403
+from chartflow.flow import *  # noqa: F401,F403
+
+__version__ = "0.1.0"

chartflow-0.1/chartflow/_verify_importexport.py

@@ -0,0 +1,169 @@
+"""验证 import/export 全量 bug 修复的往返(round-trip)脚本。
+
+对每个 bug: 构造对应画布状态 -> export -> import 到新画布 -> 断言属性保留。
+"""
+import os
+os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+
+import copy
+from PyQt6.QtGui import QColor, QPen
+from PyQt6.QtCore import Qt, QPointF
+from PyQt6.QtWidgets import QApplication
+
+from chartflow.node import (
+    QNodeCanvas, QNodeItem, NodeShape, ConnectionType,
+)
+from chartflow.node.enums import ConnectionType as CT
+
+app = QApplication([])
+
+
+def make_canvas():
+    c = QNodeCanvas()
+    c.resize(800, 600)
+    c.show()
+    app.processEvents()
+    return c
+
+
+def roundtrip(canvas):
+    """export -> json -> import 到全新画布, 返回新画布。"""
+    import json
+    js = canvas.exportToJson()
+    new = make_canvas()
+    new.importData(js)
+    return new
+
+
+def check(name, cond, detail=""):
+    status = "PASS" if cond else "FAIL"
+    print(f"[{status}] {name}" + (f"  -- {detail}" if detail and not cond else ""))
+    if not cond:
+        check.failed += 1
+check.failed = 0
+
+
+# ---- Bug 1: decorator 往返 ----
+c = make_canvas()
+n = c.addNode("A", QPointF(50, 50))
+n.decorator = "recursive"
+n2 = c.addNode("B", QPointF(200, 50))
+n2.decorator = "behavior"
+new = roundtrip(c)
+ns = {x.name: x for x in new._nodes}
+check("Bug1 decorator 往返", ns["A"].decorator == "recursive" and ns["B"].decorator == "behavior",
+      f"A={ns['A'].decorator!r} B={ns['B'].decorator!r}")
+
+# ---- Bug 2: custom 标记可见性 ----
+c = make_canvas()
+n = c.addNode("A", QPointF(50, 50))
+n.setCustomMarkerStyle(text="★", bg_color=QColor(255, 0, 0))
+n.setCustomMarkerVisible(True)
+app.processEvents()
+new = roundtrip(c)
+nA = {x.name: x for x in new._nodes}["A"]
+check("Bug2 custom 标记可见性往返",
+      nA._is_custom_marker_visible is True,
+      f"visible={nA._is_custom_marker_visible}, marker存在={nA._custom_marker is not None}")
+
+# ---- Bug 3: single 标记可见性 ----
+c = make_canvas()
+n = c.addNode("A", QPointF(50, 50))
+n.setSingleMarkerVisible(True)
+app.processEvents()
+new = roundtrip(c)
+nA = {x.name: x for x in new._nodes}["A"]
+check("Bug3 single 标记可见性往返", nA._is_single_marker_visible is True,
+      f"visible={nA._is_single_marker_visible}")
+
+# ---- Bug 4: stroke_width<=0 (无边框) 还原为 NoPen ----
+c = make_canvas()
+n = c.addNode("A", QPointF(50, 50))
+n.setBorder(0)  # <=0 -> NoPen
+assert n.pen().style() == QPen(Qt.PenStyle.NoPen).style(), "前置: setBorder(0) 应为 NoPen"
+new = roundtrip(c)
+nA = {x.name: x for x in new._nodes}["A"]
+check("Bug4 无边框(NoPen)往返", nA.pen().style() == QPen(Qt.PenStyle.NoPen).style(),
+      f"pen style={nA.pen().style()}")
+
+# ---- Bug 5: 连线 style(颜色/线宽) 往返 ----
+c = make_canvas()
+a = c.addNode("A", QPointF(50, 50))
+b = c.addNode("B", QPointF(300, 50))
+conn = c.addConnection(a, b)
+conn._style.normal_color = QColor("#FF00FF")
+conn._style.stroke_width = 5.0
+conn._setupStyle()
+new = roundtrip(c)
+if new._connections:
+    nc = new._connections[0]
+    check("Bug5 连线 normal_color 往返", nc._style.normal_color.name() == "#ff00ff",
+          f"got {nc._style.normal_color.name()}")
+    check("Bug5 连线 stroke_width 往返", nc._style.stroke_width == 5.0,
+          f"got {nc._style.stroke_width}")
+else:
+    check("Bug5 连线存在", False, "导入后无连线")
+
+# ---- Bug 6: connectable=False 端点的连接被跳过(警告, 非崩溃) ----
+import io, contextlib
+c = make_canvas()
+a = c.addNode("A", QPointF(50, 50))
+b = c.addNode("B", QPointF(300, 50))
+# 构造一份"带连接但 B 不可连线"的外部 JSON, 模拟手工/历史数据
+js = c.exportToJson()
+import json
+data = json.loads(js)
+# 诊断: 确认连接确实被导出
+check("Bug6 诊断 连接已导出", len(data.get("connections", [])) == 1,
+      f"connections count={len(data.get('connections', []))}")
+# 把 B 的 connectable 置 False, 但保留连接(正常流程不可能, 模拟外部数据)
+for nd in data["nodes"]:
+    if nd["name"] == "B":
+        nd["connectable"] = False
+buf = io.StringIO()
+new = make_canvas()
+with contextlib.redirect_stdout(buf):
+    new.importData(json.dumps(data))
+out = buf.getvalue()
+check("Bug6 connectable=False 跳过时打印警告",
+      "警告" in out and "connectable=False" in out,
+      f"stdout={out!r}")
+# 诊断: 确认 B 导入后确实不可连线(否则警告条件根本不触发)
+bn = {x.name: x for x in new._nodes}["B"]
+check("Bug6 诊断 B 导入后 connectable=False", not bn.isConnectable(),
+      f"B connectable={bn.isConnectable()}")
+# 且不应崩溃, A/B 节点都在
+check("Bug6 跳过连接不崩溃",
+      {x.name for x in new._nodes} == {"A", "B"})
+
+# ---- Bug 7: data 浅拷贝 -> deepcopy ----
+c = make_canvas()
+n = c.addNode("A", QPointF(50, 50))
+n.data["targets"] = ["B", "C"]
+d = c.export()  # dict 形式
+# 原地修改 export 返回的 dict 中的 list, 不应污染节点
+d["nodes"][0]["data"]["targets"].append("D")
+check("Bug7 data deepcopy 不污染原节点",
+      n.data["targets"] == ["B", "C"],
+      f"原节点 targets={n.data['targets']}")
+
+# ---- Bug 8: 布局失败不再被误报为"非 json 非 dict" ----
+# 通过让 autoLayout 抛异常来验证(模拟)。直接验证 _importDict 路径。
+c = make_canvas()
+flat = {"X": {"code": "1", "targets": ["Y"]}, "Y": {"code": "2", "targets": []}}
+buf = io.StringIO()
+new = make_canvas()
+with contextlib.redirect_stdout(buf):
+    new.importData(copy.deepcopy(flat))
+out = buf.getvalue()
+# 不应出现旧的误导性文案; 布局即使失败也只是"布局失败"告警
+check("Bug8 不再误报 'neither a json or a dict'",
+      "neither a json or a dict" not in out,
+      f"stdout={out!r}")
+
+print(f"\n{'='*50}")
+print(f"总计失败: {check.failed}")
+if check.failed:
+    print("存在失败项, 请检查上方 FAIL 详情。")
+else:
+    print("全部验证通过 ✅")

chartflow-0.1/chartflow/edit/__init__.py

@@ -0,0 +1,119 @@
+"""
+PyEdit - Python代码编辑器模块
+
+基于PyQt6和Python 3.12的高级Python代码编辑器
+
+功能特性：
+- Python语法高亮（浅色主题）
+- 智能代码补全（类似PyCharm）
+- 上下文分析（支持隐藏的上下文代码）
+- 代码折叠（Ctrl++ / Ctrl+-）
+- 行号显示
+- 缩略图滑块
+
+使用示例：
+    from chartflow.edit import PythonEditor
+    
+    editor = PythonEditor()
+    
+    # 设置上下文代码（隐藏但参与分析）
+    editor.set_context_code(
+        code_a="class A(CL):\\n    NAME = ''\\n    ...",
+        code_b="def myfn(self, c:OuterClassRef, k: KnowRef, *refs):\\n    v = 0",
+        prefix="    "
+    )
+    
+    # 设置编辑器中的代码
+    editor.set_code("self.do_something()")
+    
+    # 获取代码
+    code = editor.get_code()
+"""
+
+__version__ = '1.0.0'
+__author__ = 'PyEdit Team'
+
+# 主要组件
+from .python_editor import (
+    PythonEditor,
+    PythonEditorDialog,
+    PythonEditorFactory,
+    create_editor,
+    create_editor_with_context,
+)
+
+from .code_editor import CodeEditor
+from .syntax_highlighter import PythonSyntaxHighlighter
+from .completer import (
+    CodeCompleter,
+    SmartCompleter,
+    CompletionItem,
+    CompletionWorker,
+)
+from .context_analyzer import (
+    ContextAnalyzer,
+    ContextInfo,
+    CodeContext,
+    ScopeAnalyzer,
+)
+from .code_folder import (
+    CodeFolder,
+    FoldRegion,
+    FoldMarkerPainter,
+    get_fold_indicator,
+)
+from .line_number_area import (
+    LineNumberArea,
+    LineNumberDelegate,
+    FoldingIndicator,
+)
+from .minimap import (
+    MinimapWidget,
+    MinimapSlider,
+    MinimapPanel,
+    CodeOverview,
+)
+
+__all__ = [
+    # 主编辑器
+    'PythonEditor',
+    'PythonEditorDialog',
+    'PythonEditorFactory',
+    'create_editor',
+    'create_editor_with_context',
+    
+    # 代码编辑器组件
+    'CodeEditor',
+    
+    # 语法高亮
+    'PythonSyntaxHighlighter',
+    
+    # 代码补全
+    'CodeCompleter',
+    'SmartCompleter',
+    'CompletionItem',
+    'CompletionWorker',
+    
+    # 上下文分析
+    'ContextAnalyzer',
+    'ContextInfo',
+    'CodeContext',
+    'ScopeAnalyzer',
+    
+    # 代码折叠
+    'CodeFolder',
+    'FoldRegion',
+    'FoldMarkerPainter',
+    'get_fold_indicator',
+    
+    # 行号
+    'LineNumberArea',
+    'LineNumberDelegate',
+    'FoldingIndicator',
+    
+    # 缩略图
+    'MinimapWidget',
+    'MinimapSlider',
+    'MinimapPanel',
+    'CodeOverview',
+]