nodezator 1.4.6__tar.gz → 1.5.0__tar.gz

{nodezator-1.4.6 → nodezator-1.5.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: nodezator
-Version: 1.4.6
-Summary: A multi-purpose visual node editor for the Python programming language
+Version: 1.5.0
+Summary: A generalist Python node editor
 Home-page: https://nodezator.com
 Author: Kennedy Richard
 Author-email: kennedy@kennedyrichard.com
@@ -37,7 +37,7 @@ Requires-Dist: numpy
 
 # Nodezator
 
-Nodezator is a multi-purpose visual node editor for the Python programming language. It is a desktop application that works by connecting Python functions (and callables in general) visually in order to produce flexible parametric behavior/data/applications/snippets.
+Nodezator is a generalist Python node editor. It is a desktop application that works by connecting Python functions (and callables in general) visually in order to produce flexible parametric behavior/data/applications/snippets.
 
 ![nodezator screenshot](https://nodezator.com/images/screenshot.png)
 
@@ -218,7 +218,7 @@ If you have...
 
 ## Contact
 
-Contact me any time via [Twitter][] or [email][].
+Contact me any time via [Twitter/X][] or [email][].
 
 You are also welcome on the Indie Python's [discord server][].
 
@@ -268,7 +268,7 @@ Also, other parts of the code, despite being carefully designed, might be redesi
 
 [manual]: https://manual.nodezator.com
 
-[Twitter]: https://twitter.com/KennedyRichard
+[Twitter/X]: https://x.com/KennedyRichard
 [email]: mailto:kennedy@kennedyrichard.com
 [discord server]: https://indiepython.com/discord
 

{nodezator-1.4.6 → nodezator-1.5.0}/README.md

@@ -1,6 +1,6 @@
 # Nodezator
 
-Nodezator is a multi-purpose visual node editor for the Python programming language. It is a desktop application that works by connecting Python functions (and callables in general) visually in order to produce flexible parametric behavior/data/applications/snippets.
+Nodezator is a generalist Python node editor. It is a desktop application that works by connecting Python functions (and callables in general) visually in order to produce flexible parametric behavior/data/applications/snippets.
 
 ![nodezator screenshot](https://nodezator.com/images/screenshot.png)
 
@@ -181,7 +181,7 @@ If you have...
 
 ## Contact
 
-Contact me any time via [Twitter][] or [email][].
+Contact me any time via [Twitter/X][] or [email][].
 
 You are also welcome on the Indie Python's [discord server][].
 
@@ -231,7 +231,7 @@ Also, other parts of the code, despite being carefully designed, might be redesi
 
 [manual]: https://manual.nodezator.com
 
-[Twitter]: https://twitter.com/KennedyRichard
+[Twitter/X]: https://x.com/KennedyRichard
 [email]: mailto:kennedy@kennedyrichard.com
 [discord server]: https://indiepython.com/discord
 

nodezator-1.5.0/nodezator/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.5.0"

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/__main__.py

@@ -1,19 +1,52 @@
 """Facility for launching the application.
 
-Nodezator: A Python node editor developed by
+Nodezator: A generalist Python node editor developed by
 Kennedy Richard <kennedy@kennedyrichard.com>.
 
 https://kennedyrichard.com
-https://twitter.com/KennedyRichard
+https://x.com/KennedyRichard
 
 https://nodezator.com
 https://github.com/IndiePython/nodezator
 """
 
-### standard library import
+### standard library imports
+
 from pathlib import Path
 
 
+## for temporary stdout suppression
+
+from io import StringIO
+
+from contextlib import redirect_stdout
+
+
+### third-party import (pygame-ce)
+
+## execute an import statement to guarantee pygame-ce is
+## installed, even though we don't intend to use it here;
+##
+## notice we prevent the message printed when pygame-ce is
+## first imported from appearing; we do so by temporarily
+## redirecting stdout to a temporary file;
+##
+## there is no ill-meaning towards the pygame message
+## here, since we display the very logo of the library
+## in our splash screen, with a link to its website;
+## that is, we properly credit it;
+##
+## we only avoid having the message printed in order to leave
+## the stdout clean for when we are launching the app repeatedly
+## for debugging
+
+with StringIO() as _temp_stream:
+
+    with redirect_stdout(_temp_stream):
+
+        import pygame
+
+
 ### local imports
 
 from .logman.main import get_new_logger

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/appinfo.py

@@ -20,7 +20,7 @@ from collections import namedtuple
 
 AppVersion = namedtuple("AppVersion", "major minor micro release_level")
 
-APP_VERSION = AppVersion(1, 4, 6, "release_candidate")
+APP_VERSION = AppVersion(1, 5, 0, "release_candidate")
 
 
 ### titles for the application
@@ -33,6 +33,8 @@ TITLE = "Nodezator"
 ## supported by any major operating system;
 APP_DIR_NAME = "nodezator"
 
+ORG_DIR_NAME = 'IndiePython' # org name for pygame.system.get_pref_path
+
 ABBREVIATED_TITLE = "NDZ"
 
 

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/audioplayer.py

@@ -213,17 +213,22 @@ class AudioPlayer(Object2D):
 
         loop_holder = self
 
-        while self.running:
-
-            ### perform various checkups for this frame;
-            ###
-            ### stuff like maintaing a constant framerate and more
-            SERVICES_NS.frame_checkups()
+        while True:
 
             try:
 
-                loop_holder.handle_input()
-                loop_holder.draw()
+                while self.running:
+
+                    ### perform various checkups for this frame;
+                    ###
+                    ### stuff like maintaing a constant framerate and more
+                    SERVICES_NS.frame_checkups()
+
+                    loop_holder.handle_input()
+                    loop_holder.draw()
+
+                ## if we leave the inner loop, also exit the outer one
+                break
 
             except SwitchLoopException as err:
                 loop_holder = err.loop_holder

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/classes2d/collections.py

@@ -318,15 +318,8 @@ class Iterable2D(Collection2D):
         Works by counting how many iterations it takes
         to finish iteration.
         """
-        ### start a count variable
-        count = 0
-
-        ### increment the count as you iterate
-        for _ in self.callable_obj():
-            count += 1
-
-        ### return the count
-        return count
+        ### return number of iterations
+        return sum(1 for _ in self.callable_obj())
 
     def __bool__(self):
         """Return True if there's at least one item."""

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/config.py

@@ -9,13 +9,18 @@ from pathlib import Path
 from subprocess import run as run_subprocess
 
 
+### third-party import
+from pygame.system import get_pref_path
+
+
 ### local imports
 
 from .ourstdlibs.collections.general import CallList
 
 from .ourstdlibs.path import TemporaryFilepathsManager
 
-from .appinfo import APP_DIR_NAME, NATIVE_FILE_EXTENSION
+from .appinfo import APP_DIR_NAME, ORG_DIR_NAME, NATIVE_FILE_EXTENSION
+
 
 
 ### an object to hold references/data used throughout the
@@ -48,12 +53,20 @@ APP_REFS = SimpleNamespace(
             temp_file_suffix=NATIVE_FILE_EXTENSION,
         )
     ),
+    ## flag to store system info
+    system_info={},
     ## flag to lock work-in-progress features, that is,
     ## features not ready for regular usage yet
-    wip_lock=True
+    wip_lock=True,
+    ## flag to check need to save system testing settings
+    ## at end of testing session
+    system_testing_set=False,
 )
 
 
+### data directory and its subdirectories
+
+
 DATA_DIR = Path(__file__).parent / "data"
 
 FONTS_DIR = DATA_DIR / "fonts"
@@ -64,9 +77,15 @@ SYNTAX_THEMES_DIR = DATA_DIR / "syntax_themes"
 
 APP_WIDE_WEB_DIR = DATA_DIR / "aww"
 
+SYSTEM_TESTING_DATA_DIR = DATA_DIR / "system_testing"
+
 APP_COLORS_FILE = DATA_DIR / "app_themes" / "emeralds_on_coal.pyl"
 
 
+### writeable path for config/logs, etc.
+WRITEABLE_PATH = Path(get_pref_path(ORG_DIR_NAME, APP_DIR_NAME))
+
+
 ### check whether ffmpeg (and ffprobe) is available, storing
 ### the info as a boolean
 

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/data/aww/help.nodezator.pysite/general-controls.htsl

@@ -42,7 +42,7 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Ctrl+Shift+s&gt;</b></td>
+      <td><b>&lt;Shift+Ctrl+s&gt;</b></td>
       <td>"Save as..." functionality; that is, creates a new .ndz file from the current one</td>
     </tr>
 
@@ -57,12 +57,17 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Ctrl+Shift+p&gt;</b></td>
+      <td><b>&lt;Shift+Ctrl+p&gt;</b></td>
       <td>Brings up the text viewer where you can preview your node layout as Python code</td>
     </tr>
 
     <tr>
       <td><b>&lt;Ctrl+w&gt;</b></td>
+      <td>Closes loaded file</td>
+    </tr>
+
+    <tr>
+      <td><b>&lt;Ctrl+q&gt;</b></td>
       <td>Quits application</td>
     </tr>
 
@@ -96,8 +101,13 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Shift + Numpad [1-9]&gt;</b>;</td>
-      <td>Moves to corner of node layout; each digit represents a corner analogous to the corner they occupy in the keyboard's numpad: 5 on the center, 1 on the bottomleft, 2 on the midbottom and so on.</td>
+      <td><b>&lt;b&gt;</b></td>
+      <td>Toggles bird's eye view: a visual representation of the whole graph that can also be used for navigation by hovering it with the mouse while keeping it pressed.</td>
+    </tr>
+
+    <tr>
+      <td><b>&lt;Shift + j&gt;</b></td>
+      <td>Jumps to specific node by providing its id. Presents an entry for user to specify the id.</td>
     </tr>
 
   </tbody>
@@ -144,8 +154,7 @@
 
 </table>
 
-
-<h2>Function buttons</h2>
+<h2>Function keys - general usage</h2>
 
 <table>
 
@@ -176,7 +185,7 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Shift + F12&gt;</b></td>
+      <td><b>&lt;Shift+F12&gt;</b></td>
       <td>Also executes the node layout, but all content printed is displayed in the text viewer after executing.</td>
     </tr>
 
@@ -185,7 +194,80 @@
 </table>
 
 
-<h2>All objects</h2>
+<h2>Function keys - system testing</h2>
+
+<p>When a system testing session is triggered, the app assumes control of the inputs and performs test cases using automatic GUI interactions. In other words, the app will start moving by itself while performing system tests. Don't worry, you still have control of the app and can pause/resume or abort the testing session entirely. Here are all the available controls.</p>
+
+<h3>Triggering a system testing session</h3>
+
+<p>A system testing session can be triggered from one of the options in the <b>GUI automation &gt; System testing</b> menu. Here are controls to access some (not all) of the available options.</p>
+
+<table>
+
+  <thead>
+
+    <tr>
+      <th class="col-3">Control</th>
+      <th class="col-7">Result</th>
+    </tr>
+
+  </thead>
+
+  <tbody>
+
+    <tr>
+      <td><b>&lt;Shift+Ctrl+F8&gt;</b></td>
+      <td>Run all system testing cases at maximum speed.</td>
+    </tr>
+
+    <tr>
+      <td><b>&lt;Shift+F8&gt;</b></td>
+      <td>Rerun previous system testing session.</td>
+    </tr>
+
+  </tbody>
+
+</table>
+
+
+<h3>Controlling the system testing session</h3>
+
+<p>Once a system testing session starts, additional controls are available to the user. Here we present such controls.</p>
+
+<table>
+
+  <thead>
+
+    <tr>
+      <th class="col-3">Control</th>
+      <th class="col-7">Result</th>
+    </tr>
+
+  </thead>
+
+  <tbody>
+
+    <tr>
+      <td><b>&lt;F7&gt;</b></td>
+      <td>Aborts the testing session.</td>
+    </tr>
+
+    <tr>
+      <td><b>&lt;F8&gt;</b></td>
+      <td>Pauses or resumes the system testing session.</td>
+    </tr>
+
+    <tr>
+      <td><b>&lt;F9&gt;</b></td>
+      <td>Toggles control over the mouse, that is, whether you want the mouse to follow to movements of the test or not.</td>
+    </tr>
+
+  </tbody>
+
+</table>
+
+
+<h2>Controls affecting all objects</h2>
 
 <table>
 
@@ -206,7 +288,7 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Ctrl+Shift+a&gt;</b></td>
+      <td><b>&lt;Shift+Ctrl+a&gt;</b></td>
       <td>Deselects all objects</td>
     </tr>
 
@@ -387,7 +469,7 @@
     </tr>
 
     <tr>
-      <td><b>&lt;Ctrl+Shift+j&gt;</b></td>
+      <td><b>&lt;Shift+Ctrl+j&gt;</b></td>
       <td>Displays the user log contents in the text viewer</td>
     </tr>
 

nodezator-1.5.0/nodezator/data/aww/nodezator.pysite/about.htsl

@@ -0,0 +1,23 @@
+<htsl>
+
+<head>
+  <title>About the app</title>
+</head>
+
+<body>
+
+  <h1>Nodezator - A generalist python node editor</h1>
+
+  <h2>Introduction</h2>
+
+  <p>Nodezator is a generalist Python node editor. It allows you to connect Python functions (and callables in general) visually in order to produce flexible parametric behaviour/data/applications/snippets.</p>
+
+  <p>For tutorials/examples/roadmap and more go to <a href="https://nodezator.com">nodezator.com</a>.</p>
+
+  <p>This software is developed by Kennedy Richard (<a href="https://kennedyrichard.com">website</a>|<a href="https://x.com/KennedyRichard">Twitter/X</a>) as part of the <a href="https://indiepython.com">Indie Python</a> project.</p>
+
+  <p>Please, become our patron on <a href="https://patreon.com/kennedyrichard">patreon</a> to support development of this and other useful software. All donation methods available, including methods that allow one-time donations are can be found here: <a href="https://indiepython.com/donate">https://indiepython.com/donate</a></p>
+
+</body>
+
+</htsl>

{nodezator-1.4.6 → nodezator-1.5.0}/nodezator/data/aww/nodezator.pysite/whats-new/index.htsl

@@ -10,6 +10,7 @@
 
 
 <ul>
+    <li><a href="whats-new/v1-5.htsl">v1.5</a></li>
     <li><a href="whats-new/v1-4.htsl">v1.4</a></li>
     <li><a href="whats-new/v1-3.htsl">v1.3.14</a></li>
 </ul>