nodezator 1.4.5__tar.gz → 1.5.0__tar.gz

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: nodezator
-Version: 1.4.5
-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)
 
@@ -78,7 +78,7 @@ There's also a [youtube video][] presenting Nodezator:
 
 [![thumb of youtube video](https://img.youtube.com/vi/GlQJvuU7Z_8/hqdefault.jpg)](https://www.youtube.com/watch?v=GlQJvuU7Z_8)
 
-Nodezator is made with [pygame][], by [Kennedy Richard Silva Guerra][] (born in 1990), as part of the [Indie Python][] project.
+Nodezator is made with pure Python on top of the [pygame-ce][] library, by [Kennedy Richard Silva Guerra][] (born in 1990), as part of the [Indie Python][] project.
 
 After you finish reading this README file, you may also want to visit Nodezator's [homepage][]. 
 
@@ -90,10 +90,10 @@ To launch and use Nodezator you can either install it with `pip` or you can just
 
 ### Installing Nodezator with pip
 
-If you want to install it, just execute the command below. It will install nodezator and also, if not available yet, [pygame][] and [numpy][].
+If you want to install it, just execute the command below. It will install nodezator and also, if not available yet, [pygame-ce][] and [numpy][].
  
 ```
-pip install nodezator
+pip install --upgrade nodezator
 ```
 
 If everything goes well, after installing you should be able to launch the app by typing `nodezator` or `python -m nodezator` in your command line (or `python3 -m nodezator` depending on you system).
@@ -103,7 +103,7 @@ If everything goes well, after installing you should be able to launch the app b
 
 If you want to use Nodezator without installing it, you'll need 02 things:
 
-- to have Python installed in your system along with the [pygame][] and [numpy][] libraries;
+- to have Python installed in your system along with the [pygame-ce][] and [numpy][] libraries;
 - to download Nodezator's source (the `nodezator` folder in the top level of this repository).
 
 Then, to launch the app, you just need to go to the location where you put the `nodezator` folder containing the source (not inside it), open the command line and run `python -m nodezator` or `python3 -m nodezator`, depending on your system.
@@ -161,6 +161,7 @@ More complex pull requests will also be welcome in the future, but due to the co
 
 ## Issues
 
+
 ### Urgent/critical issues
 
 If you find a bug that...
@@ -180,7 +181,8 @@ Please, include as much information as you can:
 
 If possible, also read the Nodezator's [manual][] to ensure you are doing everything as they are supposed to be done. I often find myself wondering if I there is any problem only to later find out that I was doing something wrong myself.
 
-Nevertheless, never hesitate to ask for help, regardless of how much info you have about the problem or your technical expertise.
+Nevertheless, never hesitate to ask for help, even if you don't have much info about the problem or don't have any technical expertise.
+
 
 ### Minor issues
 
@@ -216,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][].
 
@@ -260,13 +262,13 @@ Also, other parts of the code, despite being carefully designed, might be redesi
 [PyPI]: https://pypi.org
 [numpy.save()]: https://numpy.org/doc/stable/reference/generated/numpy.save.html
 [youtube video]: https://www.youtube.com/watch?v=GlQJvuU7Z_8
-[pygame]: https://pygame.org
+[pygame-ce]: https://pyga.me
 [numpy]: https://numpy.org
 [Indie Python]: https://indiepython.com
 
 [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.5 → 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)
 
@@ -41,7 +41,7 @@ There's also a [youtube video][] presenting Nodezator:
 
 [![thumb of youtube video](https://img.youtube.com/vi/GlQJvuU7Z_8/hqdefault.jpg)](https://www.youtube.com/watch?v=GlQJvuU7Z_8)
 
-Nodezator is made with [pygame][], by [Kennedy Richard Silva Guerra][] (born in 1990), as part of the [Indie Python][] project.
+Nodezator is made with pure Python on top of the [pygame-ce][] library, by [Kennedy Richard Silva Guerra][] (born in 1990), as part of the [Indie Python][] project.
 
 After you finish reading this README file, you may also want to visit Nodezator's [homepage][]. 
 
@@ -53,10 +53,10 @@ To launch and use Nodezator you can either install it with `pip` or you can just
 
 ### Installing Nodezator with pip
 
-If you want to install it, just execute the command below. It will install nodezator and also, if not available yet, [pygame][] and [numpy][].
+If you want to install it, just execute the command below. It will install nodezator and also, if not available yet, [pygame-ce][] and [numpy][].
  
 ```
-pip install nodezator
+pip install --upgrade nodezator
 ```
 
 If everything goes well, after installing you should be able to launch the app by typing `nodezator` or `python -m nodezator` in your command line (or `python3 -m nodezator` depending on you system).
@@ -66,7 +66,7 @@ If everything goes well, after installing you should be able to launch the app b
 
 If you want to use Nodezator without installing it, you'll need 02 things:
 
-- to have Python installed in your system along with the [pygame][] and [numpy][] libraries;
+- to have Python installed in your system along with the [pygame-ce][] and [numpy][] libraries;
 - to download Nodezator's source (the `nodezator` folder in the top level of this repository).
 
 Then, to launch the app, you just need to go to the location where you put the `nodezator` folder containing the source (not inside it), open the command line and run `python -m nodezator` or `python3 -m nodezator`, depending on your system.
@@ -124,6 +124,7 @@ More complex pull requests will also be welcome in the future, but due to the co
 
 ## Issues
 
+
 ### Urgent/critical issues
 
 If you find a bug that...
@@ -143,7 +144,8 @@ Please, include as much information as you can:
 
 If possible, also read the Nodezator's [manual][] to ensure you are doing everything as they are supposed to be done. I often find myself wondering if I there is any problem only to later find out that I was doing something wrong myself.
 
-Nevertheless, never hesitate to ask for help, regardless of how much info you have about the problem or your technical expertise.
+Nevertheless, never hesitate to ask for help, even if you don't have much info about the problem or don't have any technical expertise.
+
 
 ### Minor issues
 
@@ -179,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][].
 
@@ -223,13 +225,13 @@ Also, other parts of the code, despite being carefully designed, might be redesi
 [PyPI]: https://pypi.org
 [numpy.save()]: https://numpy.org/doc/stable/reference/generated/numpy.save.html
 [youtube video]: https://www.youtube.com/watch?v=GlQJvuU7Z_8
-[pygame]: https://pygame.org
+[pygame-ce]: https://pyga.me
 [numpy]: https://numpy.org
 [Indie Python]: https://indiepython.com
 
 [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.5 → 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.5 → 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, 5, "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.5 → 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
@@ -325,20 +330,22 @@ class AudioPlayer(Object2D):
 
             except Exception as err:
 
-                msg = str(err)
+                log_message = (
+                    "An error ocurred while trying to"
+                    " load current audio file."
+                )
 
-                logger.exception(msg)
-                USER_LOGGER.exception(msg)
+                logger.exception(log_message)
+                USER_LOGGER.exception(log_message)
 
-                create_and_show_dialog(
-                    (
-                        "An error ocurred while trying to"
-                        " load current audio file. Check the"
-                        " user log for details"
-                    ),
-                    level_name="error",
+                dialog_message = log_message + (
+                    " Check the user log for details (on the graph/canvas,"
+                    " press <Ctrl+Shift+j> or access the \"Help > Show user"
+                    " log\" option on the menubar)."
                 )
 
+                create_and_show_dialog(dialog_message, level_name='error')
+
             else:
 
                 music.set_volume(self.volume)

{nodezator-1.4.5 → 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.5 → nodezator-1.5.0}/nodezator/colorsman/editor/panel/colorsop.py

@@ -209,10 +209,13 @@ class ColorsOperations:
         if not property_names:
 
             create_and_show_dialog(
-                "Can't sort colors because no properties are"
-                " listed in the list sorting button with the"
-                " property names (the one to the right of the"
-                " 'Sort' button)"
+                (
+                    "Can't sort colors because no properties are"
+                    " listed in the list sorting button with the"
+                    " property names (the one to the right of the"
+                    " 'Sort' button)"
+                ),
+                level_name='info',
             )
 
             return

{nodezator-1.4.5 → nodezator-1.5.0}/nodezator/colorsman/editor/panel/data.py

@@ -12,8 +12,17 @@ from ....ourstdlibs.color.custom import custom_format_color
 
 from ....dialog import create_and_show_dialog
 
+from ....logman.main import get_new_logger
+
 from ....fileman.main import select_paths
 
+from ....our3rdlibs.userlogger import USER_LOGGER
+
+
+
+### create logger for module
+logger = get_new_logger(__name__)
+
 
 class ImportExportOperations:
     """Operations to import/export colors."""
@@ -48,11 +57,19 @@ class ImportExportOperations:
 
         except Exception as err:
 
-            create_and_show_dialog(
-                f"Error while loading colors: {str(err)}",
-                level_name="error",
+            log_message = "An error ocurred while loading colors."
+
+            logger.exception(log_message)
+            USER_LOGGER.exception(log_message)
+
+            dialog_message = log_message + (
+                " For more info check the user log (on the graph/canvas, press"
+                " <Ctrl+Shift+j> or access the \"Help > Show user log\" option"
+                " on the menubar)."
             )
 
+            create_and_show_dialog(dialog_message, level_name='error')
+
         else:
 
             ### set the colors into the colors panel
@@ -77,7 +94,7 @@ class ImportExportOperations:
 
             create_and_show_dialog(
                 "must provide a single file path",
-                level_name="warning",
+                level_name='warning',
             )
 
             return
@@ -92,8 +109,16 @@ class ImportExportOperations:
             )
 
         except Exception as err:
+            
+            log_message = "An error ocurred while saving the colors."
 
-            create_and_show_dialog(
-                f"error while saving colors: {str(err)}",
-                level_name="error",
+            logger.exception(log_message)
+            USER_LOGGER.exception(log_message)
+
+            dialog_message = log_message + (
+                " For more info check the user log (on the graph/canvas, press"
+                " <Ctrl+Shift+j> or access the \"Help > Show user log\" option"
+                " on the menubar)."
             )
+
+            create_and_show_dialog(dialog_message, level_name='error')

{nodezator-1.4.5 → 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.5 → nodezator-1.5.0}/nodezator/data/app_themes/emeralds_on_coal.pyl

@@ -18,7 +18,7 @@
 
     "BUTTON_FG"         : (238, 238, 238),
     "BUTTON_BG"         : ( 47,  47,  60),
-    "HOVERED_BUTTON_BG" : ( 66,  66,  84),
+    "HOVERED_BUTTON_BG" : ( 20, 110,  60),
 
     "THUMB_BG"           : (  77,  77,  90),
     "IMAGE_NOT_FOUND_FG" : ( 255,  70,  70),

{nodezator-1.4.5 → 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.4.5 → nodezator-1.5.0}/nodezator/data/aww/manual.nodezator.pysite/ch-loading-nodes.htsl

@@ -202,9 +202,15 @@ pip install mynodepack
 
 <p>User-defined nodes are identified in the .ndz file (in the <i>script_id</i> keys) using a combination of the node pack name, the category name and the script folder name where the node script is located. This is so regardless of whether the node pack is local or installed.</p>
 
-<p>As such, if you rename any of those folders and open a .ndz file containing nodes affected by the renaming, Nodezator will look for the old folder names in the identification of the node and won't find them and will thus show a dialogue that says it isn't possible to load the file due to missing node scripts, listing those missing scripts, like in the image below:</p>
+<p>As such, if you rename any of those folders and open a .ndz file containing nodes affected by the renaming, Nodezator will look for the old folder names in the identification of the node and won't find them and will thus show a dialogue with a general message saying that one or more errors were found when trying to load the node packs, like in the image below:</p>
 
-<img src="images/ch-loading-nodes_img03.png" alt="Dialogue listing missing node scripts" />
+<img src="images/ch-loading-nodes_dialog_problems_node_packs.png" alt="Dialogue informing user of problems when loading node packs" />
+
+<p>This general message will actually appear for many other kinds of problems that can be found when trying to load node packs (either by opening a new file or via the form from the <b>Graph &gt; Load nodes</b> option in the menubar).</p>
+
+<p>Just like the dialog says, the full error(s) report can be found in the user log. Opening the user log will explain the problem in detail. In our specific case, the problem reported is a node script that could not be found (it is missing), as seen in the screenshot of the user log shown below:</p>
+
+<img src="images/ch-loading-nodes_user_log_showing_missing.png" alt="User log with error information (missing node scripts)." />
 
 <p>To solve the problems, just open the .ndz file in any text editor of your preference and look for the lines that say <i>script_id</i>, and update the names of the folders you changed. It may be boring but is usually quick work. As Nodezator evolves over time, dedicated UI should be created so the user can perform this task in the app itself.</p>