nodeeditor-qtpy 0.8.1__py3-none-any.whl

nodeeditor/qss/nodestyle.qss

@@ -0,0 +1,3 @@
+QDMNodeContentWidget { background: transparent; }
+QDMNodeContentWidget QLabel { color: #e0e0e0;  }
+QGraphicsView { selection-background-color: rgb(255, 255, 255); }

nodeeditor/utils.py

@@ -0,0 +1,108 @@
+# -*- encoding: utf-8 -*-
+"""
+Module with some helper functions
+"""
+from typing import cast
+from nodeeditor import _QT_API_NAME as QT_API
+from qtpy.QtCore import QFile, QByteArray
+from qtpy.QtWidgets import QApplication
+
+from nodeeditor.utils_no_qt import pp, dumpException
+
+
+def loadStylesheet(filename: str) -> None:
+    """
+    Loads an qss stylesheet to the current QApplication instance
+
+    :param filename: Filename of qss stylesheet
+    :type filename: str
+    Raises:
+        RuntimeError: If no QApplication instance exists
+    """
+    print('STYLE loading:', filename)
+    # app = QApplication.instance()
+    app = cast(QApplication, QApplication.instance())
+    if app is None:
+        raise RuntimeError("No QApplication instance found")
+
+    file = QFile(filename)
+    file.open(QFile.OpenModeFlag.ReadOnly | QFile.OpenModeFlag.Text)
+    try:
+        stylesheet: QByteArray = file.readAll()
+        stylesheet_str = stylesheet.data().decode('utf-8')
+        app.setStyleSheet(stylesheet_str)
+    finally:
+        file.close()
+
+
+def loadStylesheets(*args) -> None:
+    """
+    Loads multiple qss stylesheets. Concatenates them together and applies the final stylesheet to the current QApplication instance
+
+    :param args: variable number of filenames of qss stylesheets
+    :type args: str, str,...
+    Raises:
+        RuntimeError: If no QApplication instance exists
+    """
+    app = cast(QApplication, QApplication.instance())
+    if app is None:
+        raise RuntimeError("No QApplication instance found")
+
+    res = ''
+    for arg in args:
+        file = QFile(arg)
+        file.open(QFile.OpenModeFlag.ReadOnly | QFile.OpenModeFlag.Text)
+        try:
+            stylesheet: QByteArray = file.readAll()
+            res += "\n" + stylesheet.data().decode('utf-8')
+        finally:
+            file.close()
+    app.setStyleSheet(res)
+
+
+def isCTRLPressed(event):
+    """
+    Checks whether the Control key is held down in the given event.
+
+    :param event: Qt's mouse or key event
+    :type event: ``QEvent``
+    :return: the Control modifier of the event, truthy when the key is held
+    :rtype: ``int``
+    """
+    from qtpy.QtCore import Qt
+    if QT_API in ("pyqt5", "pyside2"):
+        return event.modifiers() & Qt.CTRL
+    if QT_API in ("pyqt6", "pyside6"):
+        return event.modifiers() & Qt.KeyboardModifier.ControlModifier
+
+
+def isSHIFTPressed(event):
+    """
+    Checks whether the Shift key is held down in the given event.
+
+    :param event: Qt's mouse or key event
+    :type event: ``QEvent``
+    :return: the Shift modifier of the event, truthy when the key is held
+    :rtype: ``int``
+    """
+    from qtpy.QtCore import Qt
+    if QT_API in ("pyqt5", "pyside2"):
+        return event.modifiers() & Qt.SHIFT
+    if QT_API in ("pyqt6", "pyside6"):
+        return event.modifiers() & Qt.KeyboardModifier.ShiftModifier
+
+
+def isALTPressed(event):
+    """
+    Checks whether the Alt key is held down in the given event.
+
+    :param event: Qt's mouse or key event
+    :type event: ``QEvent``
+    :return: the Alt modifier of the event, truthy when the key is held
+    :rtype: ``int``
+    """
+    from qtpy.QtCore import Qt
+    if QT_API in ("pyqt5", "pyside2"):
+        return event.modifiers() & Qt.ALT
+    if QT_API in ("pyqt6", "pyside6"):
+        return event.modifiers() & Qt.KeyboardModifier.AltModifier

nodeeditor/utils_no_qt.py

@@ -0,0 +1,21 @@
+"""
+Module with helper functions which do not depend on Qt
+"""
+import traceback
+from pprint import PrettyPrinter
+
+
+def dumpException(e=None) -> None:
+    """
+    Prints out an Exception message with a traceback to the console
+
+    :param e: Exception to print out
+    :type e: Exception
+    """
+    # print("%s EXCEPTION:" % e.__class__.__name__, e)
+    # traceback.print_tb(e.__traceback__)
+    traceback.print_exc()
+
+
+pp = PrettyPrinter(indent=4).pprint
+

nodeeditor_qtpy-0.8.1.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: nodeeditor-qtpy
+Version: 0.8.1
+Summary: Framework for building node editors and graph UIs in Qt, independent of the Qt binding (PyQt5/PyQt6/PySide2/PySide6 via QtPy)
+Keywords: node editor,nodeeditor,node graph,graph,visual programming,qt,qtpy,pyqt6,pyside6
+Author: Azad Kshitij
+Author-email: Azad Kshitij <azadkshitij08302001@gmail.com>
+License-Expression: MIT
+License-File: LICENCE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Typing :: Typed
+Requires-Dist: orjson>=3.12.0
+Requires-Dist: qtpy>=2.4.3
+Requires-Dist: pyqt6>=6.0 ; extra == 'pyqt6'
+Requires-Dist: pyside6>=6.0 ; extra == 'pyside6'
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/AzadKshitij/qtpy-nodeeditor
+Project-URL: Repository, https://github.com/AzadKshitij/qtpy-nodeeditor.git
+Project-URL: Issues, https://github.com/AzadKshitij/qtpy-nodeeditor/issues
+Project-URL: Changelog, https://github.com/AzadKshitij/qtpy-nodeeditor/blob/master/HISTORY.rst
+Provides-Extra: pyqt6
+Provides-Extra: pyside6
+Description-Content-Type: text/markdown
+
+# nodeeditor-qtpy
+
+A node editor framework for Qt. Build interactive graph interfaces out of
+draggable nodes, connectable sockets and edges, with undo/redo, JSON
+serialization and support for your own evaluation logic.
+
+The distribution is called `nodeeditor-qtpy`; the import package is `nodeeditor`.
+The framework itself is binding-agnostic: it talks to Qt through
+[QtPy](https://github.com/spyder-ide/qtpy), so it runs on PyQt5, PySide2,
+PyQt6 and PySide6.
+
+![Calculator example](https://raw.githubusercontent.com/AzadKshitij/qtpy-nodeeditor/main/examples/calculator_ss_1.png)
+
+## Features
+
+- full framework for customizable nodes, sockets and edges
+- undo / redo and serialization into JSON files in a VCS friendly way
+- support for implementing evaluation logic
+- hovering effects, dragging edges, cutting lines, snapping and more
+- node groups, multi-input nodes, custom socket shapes and color schemes
+- ready-made examples you can copy from
+
+## Requirements
+
+- Python 3.10+
+- A Qt binding: PyQt6 or PySide6 (any Qt 5/6 binding QtPy supports works)
+
+## Installation
+
+From PyPI, including a Qt binding:
+
+```
+pip install nodeeditor-qtpy[pyqt6]
+```
+
+or, for PySide6:
+
+```
+pip install nodeeditor-qtpy[pyside6]
+```
+
+Without an extra, the package installs no binding and uses whichever
+PyQt5/PySide2/PyQt6/PySide6 you already have. When several are installed,
+QtPy picks one from the `QT_API` environment variable.
+
+Directly from source code to get the latest version:
+
+```
+pip install "nodeeditor-qtpy[pyqt6] @ git+https://github.com/AzadKshitij/qtpy-nodeeditor.git"
+```
+
+Or clone the repository:
+
+```
+git clone https://github.com/AzadKshitij/qtpy-nodeeditor.git
+```
+
+## Quick start
+
+A node is a `Node` belonging to a `Scene`. Give it sockets, then connect an
+output socket to an input socket with an `Edge`:
+
+```python
+import sys
+
+from qtpy.QtWidgets import QApplication
+
+from nodeeditor.node_editor_widget import NodeEditorWidget
+from nodeeditor.node_node import Node
+from nodeeditor.node_edge import Edge
+
+app = QApplication(sys.argv)
+
+editor = NodeEditorWidget()
+scene = editor.scene
+
+# a node with one output socket
+source = Node(scene, title="Value", outputs=[1], output_text=["out"])
+
+# a node with one input socket
+sink = Node(scene, title="Print", inputs=[1], input_text=["in"])
+
+# connect the output of the first node to the input of the second
+Edge(scene, source.outputs[0], sink.inputs[0])
+
+editor.show()
+sys.exit(app.exec())
+```
+
+`NodeEditorWidget` creates the `Scene` for you. Use `Scene` on its own when
+you want to drive the graph without a widget:
+
+```python
+from nodeeditor.node_scene import Scene
+from nodeeditor.node_node import Node
+
+scene = Scene()
+node = Node(scene, title="Value", outputs=[1], output_text=["out"])
+```
+
+The `inputs` and `outputs` lists hold socket types, and the matching
+`input_text` / `output_text` lists hold the labels drawn next to them. Both
+`Node` and `Edge` register themselves with the scene when created, so there is
+nothing to add by hand.
+
+## Import names
+
+```python
+from nodeeditor import NodeEditorColorScheme, get_socket_shape
+from nodeeditor.node_scene import Scene
+from nodeeditor.node_node import Node
+from nodeeditor.node_edge import Edge
+```
+
+## Credits
+
+This project is a fork of the original
+[PyQt Node Editor](https://gitlab.com/pavel.krupala/pyqt-node-editor) by
+[Pavel Křupala](https://gitlab.com/pavel.krupala), which is released under the
+MIT licence. The original author is credited in [LICENCE](LICENCE), and the
+history of the upstream project is kept in
+[CHANGES.md](CHANGES.md) and [HISTORY.rst](HISTORY.rst).
+
+## Links
+
+- [Documentation](https://azadkshitij.github.io/qtpy-nodeeditor/)
+- [Examples](https://github.com/AzadKshitij/qtpy-nodeeditor/tree/main/examples)
+- [Original project](https://gitlab.com/pavel.krupala/pyqt-node-editor)
+- [Contribute](https://github.com/AzadKshitij/qtpy-nodeeditor/blob/main/CONTRIBUTING.md)
+- [Issues](https://github.com/AzadKshitij/qtpy-nodeeditor/issues)
+- [Pull requests](https://github.com/AzadKshitij/qtpy-nodeeditor/pulls)
+- [Release history](https://github.com/AzadKshitij/qtpy-nodeeditor/blob/main/HISTORY.rst)
+- [Upstream changelog (pre-fork)](https://github.com/AzadKshitij/qtpy-nodeeditor/blob/main/CHANGES.md)

nodeeditor_qtpy-0.8.1.dist-info/RECORD

@@ -0,0 +1,40 @@
+nodeeditor/__init__.py,sha256=XTuvO4iP1WvzBtY9KDasTsppNlWKiY65WjBvtlaTF5s,2320
+nodeeditor/node_colors_config.py,sha256=ww8I_UNU2WS8IxHJFmUEzQgG7f1HHVy6iT8mnCzaJ1A,10695
+nodeeditor/node_content_widget.py,sha256=XuOWCpHB6R60vQQIqFv5aRP__ys0G7JYSBQMeH-fHsc,5119
+nodeeditor/node_decorators.py,sha256=KqwWekiTL3LEz-HlvXBMsaNtGHjE_iUMrFk8Ekg8V00,2540
+nodeeditor/node_edge.py,sha256=rxd5d_nd1DYjjTi0AzEHRePm8Y8zswEkHKN8z1YCkzM,20143
+nodeeditor/node_edge_dragging.py,sha256=lhg4-Ycgux_Yt_m48M2J1rDA_Z_0cPHiST6ONU-oj4o,7368
+nodeeditor/node_edge_intersect.py,sha256=2K5vc6O_7tBHf4m6vsyv5-PHvL_CUvC2teYrIqHyNr4,8205
+nodeeditor/node_edge_rerouting.py,sha256=LyGVTFhEskFKuteKvACdl1hNsvLoanWx9g_QkvRMOUQ,8759
+nodeeditor/node_edge_snapping.py,sha256=Van0hJJTJi6WedH4ktEgMsYXb6X9bEiwWBaYN2Ihztg,3784
+nodeeditor/node_edge_validators.py,sha256=BXBeeZbFNgDYSu-5tBAbO-XivI1-cOeRso88Xshn2eM,2676
+nodeeditor/node_editor_widget.py,sha256=BYzsxqEQwylo1t9xyEBxfUr91HKr4FFDa9JJZynSqsg,8873
+nodeeditor/node_editor_window.py,sha256=snZ0_6HiFH7PJiXX9BjKP6e_hsQ_ZaWP85MnUveN5y0,17708
+nodeeditor/node_graph.py,sha256=B3i64NFwwETbUZaDnxpazmQqBkuKatgK6Bs9L-BEa08,20039
+nodeeditor/node_graphics_cutline.py,sha256=0-XTN9eYjV43eSAp4mdWU3Ms1_0a06V6oCstWdZ2Oxw,1784
+nodeeditor/node_graphics_edge.py,sha256=Z_mTy3ySGdlH6HrQPUS1QZ7kGymYMS5TlpZtuFJZB1c,15356
+nodeeditor/node_graphics_edge_path.py,sha256=2i0wvJVARA0wATOF1aTg2E1JQXMRwiGKEOTeZMEX7tQ,7456
+nodeeditor/node_graphics_node.py,sha256=eKM29YyTA-9PxIFCOKW4iR5AlFH0_pEuij0MQStRmvY,27218
+nodeeditor/node_graphics_scene.py,sha256=lsfi9DFHRtz4P7IaUxaSgRiuPDfyHavAC3t0Lq_EOyA,14731
+nodeeditor/node_graphics_socket.py,sha256=k3PsdDjXDx6kN8Ka6_VZRzQsr1RFndwhxOIzuYYit00,8977
+nodeeditor/node_graphics_view.py,sha256=HkrYcGH7PjmBnmwMmvLnvDQIUIRr7FZ1pSul__OtPkE,36214
+nodeeditor/node_group.py,sha256=1bIX1Rc4UqDQAKT84z7a2tSmxMN2DHfBJO5AVAwaE54,50102
+nodeeditor/node_group_node.py,sha256=TrV8P1vscZWF9aIPzPpXLe2oh_yX4eAGSSQLQIOJR2E,254
+nodeeditor/node_icon_content_widget.py,sha256=hBY7ko3mCE_wI_qL1lnk3JXIBA-7jKmW_5uB8tYk8fw,6947
+nodeeditor/node_icon_graphics_node.py,sha256=lsn6v4bFsziMDfDCYNaWdPnoquXXKjINeHIIyXe8KFY,21493
+nodeeditor/node_multi_input_node.py,sha256=hDdZdKHvvOtgjx2684DGyNGAGY_I-QurbtGuqrrd0wo,17811
+nodeeditor/node_node.py,sha256=bEgGdbuG5_5G3GkUPTfZWQZSD72NFZhB7NY3qBerDXQ,34813
+nodeeditor/node_scene.py,sha256=1bzSoS61zjZCnqeqdZYmIXh6H4AeuxusW62NmvSeqro,42236
+nodeeditor/node_scene_clipboard.py,sha256=vkIljNAi5EvkOUO_VJf4MI2d07rlpevkDUcZ7JOCfFs,11742
+nodeeditor/node_scene_history.py,sha256=R8-azhzAuQ7tpJWpJ8IjUwrYpHIILQkgGoKWLQYzO20,20099
+nodeeditor/node_serializable.py,sha256=Z4uFqS-JI4EDnRrhqG1CimY0HNBUMtrQa8FnitQvEMg,1666
+nodeeditor/node_socket.py,sha256=SUvxIF5AyDvewPzq_9MKGyS5T28XchSH5AjKNoDd4kE,17231
+nodeeditor/node_socket_shapes.py,sha256=Ff3m9my-INwfK6wvuMukTNhibNuAw4TSwYzX1UNFWNw,8735
+nodeeditor/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nodeeditor/qss/nodestyle.qss,sha256=eU8hdcmX_NuGux8KA-xdkwaMXqXQndZsoUqe-dgCFxw,164
+nodeeditor/utils.py,sha256=Hts5U3m67rtXNMf8xnYZHnmfmtvD-oB02NNu2MfwiQ4,3342
+nodeeditor/utils_no_qt.py,sha256=B8d5aX3TH-iolGhkSBZ3VT3BDd59XyLC9mLxKKnQyw8,457
+nodeeditor_qtpy-0.8.1.dist-info/licenses/LICENCE,sha256=uOd7uoKZsgX55xpCk9EXhPIMKKEW8tDIAlkhl3RXeK0,1111
+nodeeditor_qtpy-0.8.1.dist-info/WHEEL,sha256=1dD_GoEqEIxQ7VnrUExgdj_eExY4b4UgfR0iBlGKVac,80
+nodeeditor_qtpy-0.8.1.dist-info/METADATA,sha256=FOZOG5He98EJWaM0w4obvh8_F0vLX_IJKcTf1_D-oiM,5699
+nodeeditor_qtpy-0.8.1.dist-info/RECORD,,

nodeeditor_qtpy-0.8.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.4
+Root-Is-Purelib: true
+Tag: py3-none-any

nodeeditor_qtpy-0.8.1.dist-info/licenses/LICENCE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2019, Pavel Křupala
+Copyright (c) 2024-2026, Azad Kshitij
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+