hypershell 2.6.4__tar.gz → 2.6.5__tar.gz

{hypershell-2.6.4 → hypershell-2.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hypershell
-Version: 2.6.4
+Version: 2.6.5
 Summary: A cross-platform, high-throughput computing utility for processing shell commands over a distributed, asynchronous queue.
 License: Apache-2.0
 Keywords: distributed-computing,command-line-tool,shell-scripting,high-performance-computing,high-throughput-computing

{hypershell-2.6.4 → hypershell-2.6.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hypershell"
-version = "2.6.4"
+version = "2.6.5"
 description = "A cross-platform, high-throughput computing utility for processing shell commands over a distributed, asynchronous queue."
 readme = "README.rst"
 license = "Apache-2.0"

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/__init__.py

@@ -4,16 +4,19 @@
 """Initialization and entry-point for console application."""
 
 
-# standard libs
+# Path sanitizer must happen first
+import hypershell.core.sys
+
+# Standard libs
 import sys
 from importlib.metadata import version as get_version
 from platform import python_version
 
-# external libs
+# External libs
 from cmdkit.app import Application, ApplicationGroup
 from cmdkit.cli import Interface
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger, initialize_logging
 from hypershell.core.signal import register_handlers
 from hypershell.submit import SubmitApp
@@ -24,12 +27,12 @@ from hypershell.task import TaskGroupApp
 from hypershell.config import ConfigApp
 from hypershell.data import InitDBApp
 
-# public interface
+# Public interface
 __all__ = ['HyperShellApp', 'main', '__version__']
 
 # project metadata
 __version__     = get_version('hypershell')
-__website__     = 'https://github.com/glentner/hypershell'
+__website__     = 'https://github.com/hypershell/hypershell'
 __description__ = 'Process shell commands over a distributed, asynchronous queue.'
 __citation__    = """\
 @inproceedings{lentner_2022,
@@ -47,7 +50,7 @@ __citation__    = """\
 }\
 """
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name('hypershell')
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/client.py

@@ -28,12 +28,12 @@ Warning:
 """
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import List, Tuple, Optional, Callable, Dict, IO, Type, Final
 from types import TracebackType
 
-# standard libs
+# Standard libs
 import os
 import sys
 import time
@@ -48,12 +48,12 @@ from socket import gaierror
 from dataclasses import dataclass
 from multiprocessing import AuthenticationError, cpu_count
 
-# external libs
+# External libs
 from cmdkit.app import Application, exit_status
 from cmdkit.cli import Interface, ArgumentError
 from cmdkit.config import Namespace
 
-# internal libs
+# Internal libs
 from hypershell.data.model import Task
 from hypershell.core.heartbeat import Heartbeat, ClientState
 from hypershell.core.platform import default_path
@@ -67,14 +67,14 @@ from hypershell.core.template import Template, DEFAULT_TEMPLATE
 from hypershell.core.exceptions import (handle_exception, handle_disconnect,
                                         handle_address_unknown, HostAddressInfo, get_shared_exception_mapping)
 
-# public interface
+# Public interface
 __all__ = ['run_client', 'ClientThread', 'ClientApp', 'ClientInfo',
            'DEFAULT_BUNDLESIZE', 'DEFAULT_BUNDLEWAIT', 'DEFAULT_TEMPLATE',
            'DEFAULT_NUM_TASKS', 'DEFAULT_DELAY', 'DEFAULT_SIGNALWAIT',
            'DEFAULT_HEARTRATE', 'DEFAULT_HOST', 'DEFAULT_PORT', 'DEFAULT_AUTH',
            'set_client_standalone']
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/cluster/__init__.py

@@ -4,21 +4,21 @@
 """Run full cluster with server and managed clients."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import IO, Optional, Iterable, Dict, Callable, Type
 from types import TracebackType
 
-# standard libs
+# Standard libs
 import sys
 import shlex
 from functools import cached_property
 
-# external libs
+# External libs
 from cmdkit.app import Application
 from cmdkit.cli import Interface, ArgumentError
 
-# internal libs
+# Internal libs
 from hypershell.core.config import config, blame
 from hypershell.core.queue import QueueConfig
 from hypershell.core.logging import Logger
@@ -35,14 +35,14 @@ from hypershell.cluster.remote import (run_cluster, RemoteCluster, AutoScalingCl
                                        DEFAULT_AUTOSCALE_MIN_SIZE, DEFAULT_AUTOSCALE_MAX_SIZE,
                                        DEFAULT_AUTOSCALE_INIT_SIZE)
 
-# public interface
+# Public interface
 __all__ = ['run_local', 'run_cluster', 'run_ssh',
            'LocalCluster', 'RemoteCluster', 'AutoScalingCluster', 'SSHCluster',
            'DEFAULT_REMOTE_EXE', 'DEFAULT_AUTOSCALE_FACTOR', 'DEFAULT_AUTOSCALE_PERIOD',
            'DEFAULT_AUTOSCALE_MIN_SIZE', 'DEFAULT_AUTOSCALE_MAX_SIZE', 'DEFAULT_AUTOSCALE_INIT_SIZE',
            'ClusterApp', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/cluster/local.py

@@ -4,15 +4,15 @@
 """Local cluster implementation."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Iterable, IO
 
-# standard libs
+# Standard libs
 import time
 import secrets
 
-# internal libs
+# Internal libs
 from hypershell.core.thread import Thread
 from hypershell.core.logging import Logger
 from hypershell.core.template import DEFAULT_TEMPLATE
@@ -20,10 +20,10 @@ from hypershell.submit import DEFAULT_BUNDLEWAIT
 from hypershell.server import ServerThread, DEFAULT_BUNDLESIZE, DEFAULT_ATTEMPTS
 from hypershell.client import ClientThread, DEFAULT_DELAY, DEFAULT_SIGNALWAIT, set_client_standalone
 
-# public interface
+# Public interface
 __all__ = ['run_local', 'LocalCluster']
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name('hypershell.cluster')
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/cluster/remote.py

@@ -4,11 +4,11 @@
 """Remote cluster implementation."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Tuple, List, Dict, IO, Iterable, Callable, Type, Final
 
-# standard libs
+# Standard libs
 import os
 import sys
 import time
@@ -19,7 +19,7 @@ from datetime import datetime, timedelta
 from functools import cached_property
 from subprocess import Popen
 
-# internal libs
+# Internal libs
 from hypershell.core.fsm import State, StateMachine
 from hypershell.core.config import default, load_task_env
 from hypershell.core.thread import Thread
@@ -30,14 +30,14 @@ from hypershell.client import DEFAULT_DELAY, DEFAULT_SIGNALWAIT
 from hypershell.submit import DEFAULT_BUNDLEWAIT
 from hypershell.server import ServerThread, DEFAULT_PORT, DEFAULT_BUNDLESIZE, DEFAULT_ATTEMPTS
 
-# public interface
+# Public interface
 __all__ = ['run_cluster', 'RemoteCluster', 'AutoScalingCluster',
            'DEFAULT_REMOTE_EXE', 'DEFAULT_LAUNCHER',
            'DEFAULT_AUTOSCALE_POLICY', 'DEFAULT_AUTOSCALE_PERIOD', 'DEFAULT_AUTOSCALE_FACTOR',
            'DEFAULT_AUTOSCALE_INIT_SIZE', 'DEFAULT_AUTOSCALE_MIN_SIZE', 'DEFAULT_AUTOSCALE_MAX_SIZE',
            'DEFAULT_AUTOSCALE_LAUNCHER', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name('hypershell.cluster')
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/cluster/ssh.py

@@ -4,11 +4,11 @@
 """SSH-based cluster implementation."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Type, List, Iterable, Tuple, IO, Final
 
-# standard libs
+# Standard libs
 import re
 import sys
 import time
@@ -16,10 +16,10 @@ import shlex
 import secrets
 from subprocess import Popen
 
-# external libs
+# External libs
 from cmdkit.config import ConfigurationError, Namespace
 
-# internal libs
+# Internal libs
 from hypershell.core.config import config, blame
 from hypershell.core.thread import Thread
 from hypershell.core.logging import Logger, HOSTNAME
@@ -28,10 +28,10 @@ from hypershell.client import DEFAULT_DELAY, DEFAULT_SIGNALWAIT
 from hypershell.submit import DEFAULT_BUNDLEWAIT
 from hypershell.server import ServerThread, DEFAULT_PORT, DEFAULT_BUNDLESIZE, DEFAULT_ATTEMPTS
 
-# public interface
+# Public interface
 __all__ = ['run_ssh', 'SSHCluster', 'NodeList', 'DEFAULT_REMOTE_EXE']
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name('hypershell.cluster')
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/config.py

@@ -4,11 +4,11 @@
 """Manage configuration."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Any
 
-# standard libs
+# Standard libs
 import os
 import io
 import sys
@@ -16,7 +16,7 @@ import json
 import contextlib
 import subprocess
 
-# external libs
+# External libs
 import tomlkit
 from pygments.styles import STYLE_MAP as CONSOLE_THEMES
 from cmdkit.app import Application, ApplicationGroup
@@ -25,7 +25,7 @@ from cmdkit.config import ConfigurationError
 from rich.console import Console
 from rich.syntax import Syntax
 
-# internal libs
+# Internal libs
 from hypershell.core.platform import path
 from hypershell.core.types import smart_coerce
 from hypershell.core.logging import Logger
@@ -33,10 +33,10 @@ from hypershell.core.exceptions import get_shared_exception_mapping
 from hypershell.core.config import (load_file, update, ACTIVE_CONFIG_VARS,
                                     default as default_config, config as full_config)
 
-# public interface
+# Public interface
 __all__ = ['ConfigApp', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/config.py

@@ -4,11 +4,11 @@
 """Runtime configuration for HyperShell."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import TypeVar, Union, List, Optional, Protocol, Final, Iterator
 
-# standard libs
+# Standard libs
 import os
 import re
 import sys
@@ -19,15 +19,16 @@ import socket
 import functools
 from datetime import datetime
 
-# external libs
+# External libs
 from cmdkit.config import Namespace, Configuration, Environ, ConfigurationError
 from cmdkit.app import exit_status
 
-# internal libs
+# Internal libs
 from hypershell.core.platform import path, home
 from hypershell.core.exceptions import write_traceback
+from hypershell.core.sys import PATH_SEP
 
-# public interface
+# Public interface
 __all__ = ['config', 'update', 'default', 'ConfigurationError', 'Namespace', 'blame',
            'load', 'reload', 'reload_local', 'load_file', 'reload_file', 'load_env', 'reload_env', 'load_task_env',
            'DEFAULT_LOGGING_STYLE', 'LOGGING_STYLES', 'ACTIVE_CONFIG_VARS', 'SSH_GROUPS',
@@ -328,18 +329,12 @@ def _inplace_update(original: dict, partial: dict) -> dict:
     return original
 
 
-if os.name == 'nt':
-    PATH_DELIMITER = ';'
-else:
-    PATH_DELIMITER = ':'
-
-
 T = TypeVar('T')
 
 
 def __collapse_if_list_impl(value: Union[T, List[str]]) -> Union[T, str]:
     """If `value` is a list, collapse it to a path-like list (with ':' or ';')."""
-    return value if not isinstance(value, list) else PATH_DELIMITER.join([str(member) for member in value])
+    return value if not isinstance(value, list) else PATH_SEP.join([str(member) for member in value])
 
 
 def __collapse_lists(ns: Namespace) -> Namespace:

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/exceptions.py

@@ -4,7 +4,7 @@
 """Core exception handling useful for import-time issues."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Dict, Union, Callable, Type
 
@@ -16,16 +16,16 @@ import functools
 import traceback
 from datetime import datetime
 
-# external libs
+# External libs
 from cmdkit.app import exit_status
 from cmdkit.config import Namespace
 from cmdkit.config import ConfigurationError
 from cmdkit.ansi import faint, bold, magenta, yellow, red, COLOR_STDERR
 
-# internal libs
+# Internal libs
 from hypershell.core.platform import default_path
 
-# public interface
+# Public interface
 __all__ = ['display_warning', 'display_error', 'display_critical', 'traceback_filepath', 'write_traceback',
            'handle_exception', 'handle_exception_silently', 'handle_disconnect', 'handle_address_unknown',
            'HostAddressInfo', 'DatabaseUninitialized',

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/fsm.py

@@ -4,11 +4,11 @@
 """Instrumentation for building finite state machines."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Dict, Callable, Type
 
-# standard libs
+# Standard libs
 from enum import Enum
 from abc import ABC
 # FUZZ: import time
@@ -16,11 +16,11 @@ from abc import ABC
 # PERF: from collections import defaultdict
 # PERF: from time import perf_counter
 
-# internal libs
+# Internal libs
 from hypershell.core.exceptions import write_traceback
 from hypershell.core.logging import Logger
 
-# public interface
+# Public interface
 __all__ = ['State', 'StateMachine', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/heartbeat.py

@@ -4,20 +4,20 @@
 """Heartbeat data passed between client and server."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Type
 
-# standard libs
+# Standard libs
 import json
 from enum import Enum
 from datetime import datetime
 from dataclasses import dataclass
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import HOSTNAME, INSTANCE
 
-# public interface
+# Public interface
 __all__ = ['ClientState', 'Heartbeat']
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/logging.py

@@ -4,7 +4,7 @@
 """Logging configuration."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Tuple, Dict, Any, Type
 
@@ -16,16 +16,16 @@ import logging
 import functools
 import datetime
 
-# external libs
+# External libs
 from cmdkit.app import exit_status
 from cmdkit.config import ConfigurationError
 from cmdkit.ansi import Ansi, COLOR_STDERR
 
-# internal libs
+# Internal libs
 from hypershell.core.config import config, blame
 from hypershell.core.exceptions import write_traceback
 
-# public interface
+# Public interface
 __all__ = ['Logger', 'HOSTNAME', 'INSTANCE', 'handler', 'initialize_logging', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/platform.py

@@ -10,18 +10,18 @@
 # to leave this module in place for the time being.
 
 
-# standard libs
+# Standard libs
 import os
 import sys
 import ctypes
 import platform
 
-# external libs
+# External libs
 from cmdkit.config import Namespace
 from cmdkit.app import exit_status
 from cmdkit.ansi import bold, magenta
 
-# public interface
+# Public interface
 __all__ = ['cwd', 'home', 'site', 'path', 'default_path']
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/queue.py

@@ -4,21 +4,21 @@
 """Queue server/client implementation."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Dict, List, Callable, Union, Optional, Any, Iterable, Type
 from types import TracebackType
 
-# standard libs
+# Standard libs
 from multiprocessing.managers import BaseManager
 from multiprocessing import JoinableQueue
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
 
-# internal libs
+# Internal libs
 from hypershell.core.config import default, config as _config
 
-# public interface
+# Public interface
 __all__ = ['QueueConfig', 'QueueInterface', 'QueueServer', 'QueueClient']
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/remote.py

@@ -4,29 +4,29 @@
 """Manage remote connections and data."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Tuple, Optional, Type, Union, IO
 from types import TracebackType
 
-# standard libs
+# Standard libs
 import os
 import sys
 from dataclasses import dataclass
 
-# external libs
+# External libs
 from paramiko import SSHClient, SFTPClient, ProxyCommand, AutoAddPolicy, SSHConfig as SSHConfigParser
 from paramiko.channel import ChannelStdinFile, ChannelFile, ChannelStderrFile
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger
 from hypershell.core.config import config
 from hypershell.core.thread import Thread
 
-# public interface
+# Public interface
 __all__ = ['SSHConfig', 'SSHConnection', 'RemoteProcess', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/signal.py

@@ -4,20 +4,20 @@
 """Signal handling facility."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Optional, Final, Dict
 from types import FrameType
 
-# standard libs
+# Standard libs
 import platform
 from signal import signal as register
 
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger
 
-# public interface
+# Public interface
 __all__ = ['check_signal', 'RECEIVED', 'SIGNAL_MAP',
            'handler', 'register_handlers', 'register',
            'SIGUSR1', 'SIGUSR2', 'SIGINT', 'SIGTERM', 'SIGKILL']
@@ -36,7 +36,7 @@ else:
     SIGKILL: Final[int] = 9
 
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

hypershell-2.6.5/src/hypershell/core/sys.py

@@ -0,0 +1,69 @@
+# SPDX-FileCopyrightText: 2025 Geoffrey Lentner
+# SPDX-License-Identifier: Apache-2.0
+
+"""
+Sanitize and supplement package environment.
+
+For most installations this module does nothing and can be ignored.
+For system-wide user-facing non-library installations we do not want user
+programs (which may be Python-based with PYTHONPATH implications) to interfere
+with this program.
+
+The HYPERSHELL_PYTHONPATH environment variable takes the place of the normal
+PYTHONPATH environment variable. However, if this variable exists and points to
+a file, the contents of that file represents a frozen path list.
+"""
+
+
+# Type annotations
+from __future__ import annotations
+from typing import List, Final
+
+# Standard libs
+import os
+import sys
+import platform
+
+# Public interface
+__all__ = ['HYPERSHELL_PYTHONPATH', 'PATH_SEP']
+
+
+if platform.system() == 'Windows':
+    PATH_SEP: Final[str] = ';'
+else:
+    PATH_SEP: Final[str] = ':'
+
+
+HYPERSHELL_PYTHONPATH: Final[str | None] = os.getenv("HYPERSHELL_PYTHONPATH", None)
+
+
+# If the HYPERSHELL_PYTHONPATH refers to a file path we interpret it to be a frozen list.
+# E.g., (/etc/hypershell.pythonpath)
+#    /usr/local/lib
+#    /usr/local/lib/python3.12
+#    /usr/local/lib/python3.12/lib-dynload
+#    /usr/local/lib/python3.12/site-packages
+#    /usr/local/lib/hypershell/site-packages
+if HYPERSHELL_PYTHONPATH and os.path.isfile(HYPERSHELL_PYTHONPATH):
+    sys.path.clear()
+    with open(HYPERSHELL_PYTHONPATH, mode='r') as stream:
+        lines = stream.read().strip().split('\n')
+        for path in lines:
+            if path and not path.startswith('#'):
+                if os.path.exists(path):
+                    sys.path.append(path)
+                else:
+                    print(f'Error: "{path}" not found (HYPERSHELL_PYTHONPATH={HYPERSHELL_PYTHONPATH})',
+                          file=sys.stderr, flush=True)
+                    sys.exit(3)  # exit_status.bad_config
+
+# Otherwise HYPERSHELL_PYTHONPATH is treated exactly like the normal PYTHONPATH variable.
+elif HYPERSHELL_PYTHONPATH:
+    lines = HYPERSHELL_PYTHONPATH.strip().split(PATH_SEP)
+    for path in lines:
+        if os.path.exists(path):
+            sys.path.append(path)
+        else:
+            print(f'Error: "{path}" not found (HYPERSHELL_PYTHONPATH={HYPERSHELL_PYTHONPATH})',
+                  file=sys.stderr, flush=True)
+            sys.exit(3)  # exit_status.bad_config

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/tag.py

@@ -4,17 +4,17 @@
 """Tag interface and parsing."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Dict, List, Optional, Type
 
-# standard libs
+# Standard libs
 from dataclasses import dataclass
 
-# internal libs
+# Internal libs
 from hypershell.core.types import JSONValue, smart_coerce
 
-# public interface
+# Public interface
 __all__ = ['Tag', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/template.py

@@ -4,12 +4,12 @@
 """Template expansion facility for task execution."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Dict, Callable
 from types import ModuleType
 
-# standard libs
+# Standard libs
 import os
 import re
 import math
@@ -17,10 +17,10 @@ import datetime
 import subprocess
 import functools
 
-# internal libs
+# Internal libs
 from hypershell.core.types import smart_coerce
 
-# public interface
+# Public interface
 __all__ = ['Template', 'DEFAULT_TEMPLATE', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/thread.py

@@ -4,15 +4,15 @@
 """Thread base class implementation."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Optional, Type
 
-# standard libs
+# Standard libs
 import threading
 from abc import ABC, abstractmethod
 
-# public interface
+# Public interface
 __all__ = ['Thread', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/core/types.py

@@ -4,10 +4,10 @@
 """Automatic type coercion of input data."""
 
 
-# type annotations
+# Type annotations
 from typing import TypeVar
 
-# public interface
+# Public interface
 __all__ = ['smart_coerce', 'JSONValue']
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/data/__init__.py

@@ -4,15 +4,15 @@
 """Database interface, models, and methods."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Final
 
-# standard libs
+# Standard libs
 import sys
 import functools
 
-# external libs
+# External libs
 from cmdkit.app import Application, exit_status
 from cmdkit.cli import Interface
 from cmdkit.config import ConfigurationError
@@ -20,17 +20,17 @@ from sqlalchemy import inspect
 from sqlalchemy.orm import close_all_sessions
 from sqlalchemy.exc import OperationalError
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger
 from hypershell.core.config import config
 from hypershell.core.exceptions import handle_exception, DatabaseUninitialized, get_shared_exception_mapping
 from hypershell.data.core import engine, in_memory, schema
 from hypershell.data.model import Entity, Task
 
-# public interface
+# Public interface
 __all__ = ['InitDBApp', 'initdb', 'truncatedb', 'checkdb', 'ensuredb', 'DATABASE_ENABLED', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/data/core.py

@@ -4,16 +4,16 @@
 """Core interface for database engine and session manager."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import Any, Type
 
-# standard libs
+# Standard libs
 import sys
 import logging
 from urllib.parse import urlencode
 
-# external libs
+# External libs
 from cmdkit.app import exit_status
 from cmdkit.config import Namespace, ConfigurationError
 from sqlalchemy.engine import create_engine, Engine
@@ -21,12 +21,12 @@ from sqlalchemy.pool import StaticPool
 from sqlalchemy.orm import sessionmaker, scoped_session
 from sqlalchemy.exc import ArgumentError
 
-# internal libs
+# Internal libs
 from hypershell.core.config import config
 from hypershell.core.logging import handler
 from hypershell.core.exceptions import display_critical, write_traceback
 
-# public interface
+# Public interface
 __all__ = ['DatabaseURL', 'engine', 'Session', 'config', 'in_memory', 'schema', ]
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/data/model.py

@@ -4,17 +4,17 @@
 """Database models."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import List, Dict, Tuple, Any, Type, TypeVar, Union, Optional
 
-# standard libs
+# Standard libs
 import re
 import json
 from uuid import uuid4 as gen_uuid
 from datetime import datetime
 
-# external libs
+# External libs
 from sqlalchemy import Column, Index, func
 from sqlalchemy.orm import Query, DeclarativeBase, Mapped, mapped_column
 from sqlalchemy.orm.exc import NoResultFound, MultipleResultsFound
@@ -22,17 +22,17 @@ from sqlalchemy.ext.declarative import declared_attr
 from sqlalchemy.types import Integer, DateTime, Text, Boolean, JSON as _JSON
 from sqlalchemy.dialects.postgresql import SMALLINT, UUID as POSTGRES_UUID, JSONB as POSTGRES_JSON
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger, HOSTNAME, INSTANCE
 from hypershell.core.heartbeat import Heartbeat
 from hypershell.core.types import JSONValue
 from hypershell.core.tag import Tag
 from hypershell.data.core import schema, Session
 
-# public interface
+# Public interface
 __all__ = ['Task', 'Client', 'Entity', 'to_json_type', 'from_json_type', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/server.py

@@ -40,12 +40,12 @@ Warning:
 """
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import List, Dict, Tuple, Iterable, IO, Optional, Callable, Type, Final
 from types import TracebackType
 
-# standard libs
+# Standard libs
 import sys
 import time
 from enum import Enum
@@ -54,11 +54,11 @@ from functools import cached_property
 from itertools import islice
 from queue import Empty as QueueEmpty, Full as QueueFull
 
-# external libs
+# External libs
 from cmdkit.app import Application
 from cmdkit.cli import Interface, ArgumentError
 
-# internal libs
+# Internal libs
 from hypershell.core.exceptions import get_shared_exception_mapping
 from hypershell.core.config import config, default, find_available_ports
 from hypershell.core.logging import Logger
@@ -72,13 +72,13 @@ from hypershell.data import ensuredb, DATABASE_ENABLED
 from hypershell.submit import SubmitThread, LiveSubmitThread, DEFAULT_BUNDLEWAIT
 from hypershell.client import ClientInfo
 
-# public interface
+# Public interface
 __all__ = ['serve_from', 'serve_file', 'serve_forever', 'ServerThread', 'ServerApp',
            'DEFAULT_BUNDLESIZE', 'DEFAULT_BUNDLEWAIT', 'DEFAULT_ATTEMPTS',
            'DEFAULT_EVICT', 'DEFAULT_EAGER_MODE', 'DEFAULT_QUERY_PAUSE',
            'DEFAULT_BIND', 'DEFAULT_PORT', 'DEFAULT_AUTH']
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/submit.py

@@ -37,12 +37,12 @@ Warning:
 """
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import List, Iterable, Iterator, IO, Optional, Dict, Callable, Type, Final
 from types import TracebackType
 
-# standard libs
+# Standard libs
 import io
 import sys
 import functools
@@ -50,12 +50,12 @@ from enum import Enum
 from datetime import datetime
 from queue import Queue, Empty as QueueEmpty, Full as QueueFull
 
-# external libs
+# External libs
 from cmdkit.config import ConfigurationError
 from cmdkit.app import Application
 from cmdkit.cli import Interface, ArgumentError
 
-# internal libs
+# Internal libs
 from hypershell.core.logging import Logger
 from hypershell.core.config import config, default
 from hypershell.core.fsm import State, StateMachine
@@ -68,11 +68,11 @@ from hypershell.data.model import Task
 from hypershell.data import initdb, checkdb
 from hypershell.task import Tag
 
-# public interface
+# Public interface
 __all__ = ['submit_from', 'submit_file', 'SubmitThread', 'LiveSubmitThread',
            'SubmitApp', 'DEFAULT_BUNDLESIZE', 'DEFAULT_BUNDLEWAIT', 'DEFAULT_TEMPLATE']
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

{hypershell-2.6.4 → hypershell-2.6.5}/src/hypershell/task.py

@@ -4,11 +4,11 @@
 """Task based operations."""
 
 
-# type annotations
+# Type annotations
 from __future__ import annotations
 from typing import List, Dict, Callable, IO, Tuple, Any, Optional, Type, Final
 
-# standard libs
+# Standard libs
 import os
 import re
 import sys
@@ -21,7 +21,7 @@ from datetime import timedelta, datetime
 from dataclasses import dataclass
 from shutil import copyfileobj
 
-# external libs
+# External libs
 import yaml
 from rich.console import Console
 from rich.syntax import Syntax
@@ -34,7 +34,7 @@ from sqlalchemy.orm import Query
 from sqlalchemy.orm.exc import StaleDataError
 from sqlalchemy.sql.elements import BinaryExpression
 
-# internal libs
+# Internal libs
 from hypershell.core.platform import default_path
 from hypershell.core.config import config
 from hypershell.core.exceptions import handle_exception, handle_exception_silently, get_shared_exception_mapping
@@ -46,10 +46,10 @@ from hypershell.data.core import Session
 from hypershell.data.model import Task, to_json_type
 from hypershell.data import ensuredb
 
-# public interface
+# Public interface
 __all__ = ['TaskGroupApp', ]
 
-# initialize logger
+# Initialize logger
 log = Logger.with_name(__name__)
 
 

hypershell-2.6.4/src/hypershell/core/sys.py

@@ -1,39 +0,0 @@
-# SPDX-FileCopyrightText: 2025 Geoffrey Lentner
-# SPDX-License-Identifier: Apache-2.0
-
-"""
-Sanitize and supplement package environment.
-
-For most installations this module does nothing and can be ignored.
-For system installation as an application (non-library use) we do not want user
-programs (which may be Python-based with PYTHONPATH implications) to interfere
-with this program.
-
-If we are not installed in the user-site, we strip the user site-packages from
-`sys.path` as well as the current working directory. It should not matter what
-directory you run this program from.
-
-If `ctx.path.system.config`/hypershell.pth exists it will take this as truth
-"""
-
-# Standard libs
-import sys
-
-if sys
-
-# NOTE:
-#    This special module freezes the internal sys.path used by the application.
-#    We do not want to do this for library use or under any normal circumstances.
-#    When the program is installed system wide as a utility we need to ensure that
-#    we are not being polluted by some other applications environment (e.g., PYTHONPATH).
-#    This also allows us to suppliment with special locations of vendored dependencies.
-print('FIXING IMPORTS', flush=True)
-sys.path.clear()
-sys.path.extend([
-    '/Library/Frameworks/Python.framework/Versions/3.12/lib/python312.zip',
-    '/Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12',
-    '/Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/lib-dynload',
-    '/Users/geoffrey/Library/Caches/pypoetry/virtualenvs/hypershell-NY9Seigz-py3.12/lib/python3.12/site-packages',
-    '/Users/geoffrey/Code/github.com/hypershell/hypershell/src'
-])
-print('FIXING IMPORTS - DONE', flush=True)