manage-iocs 0.1.0__py3-none-any.whl

manage_iocs/__init__.py

@@ -0,0 +1,11 @@
+"""Top level API.
+
+.. data:: __version__
+    :type: str
+
+    Version number as calculated by https://github.com/pypa/setuptools_scm
+"""
+
+from ._version import __version__
+
+__all__ = ["__version__"]

manage_iocs/__main__.py

@@ -0,0 +1,38 @@
+"""Interface for ``python -m manage_iocs``."""
+
+import inspect
+import sys
+from collections.abc import Callable
+
+from . import commands
+
+
+def get_command_from_args(args: list[str]) -> Callable:
+    if len(args) < 2:
+        raise RuntimeError("No command provided!")
+
+    command = getattr(commands, args[1], None)
+    if not command or not inspect.isfunction(command):
+        raise RuntimeError(f"Unknown command: {args[1]}")
+
+    if not bool(inspect.signature(command).parameters):
+        return command
+    elif len(args) < 3:
+        raise RuntimeError(f"Command '{command.__name__}' requires additional arguments!")
+
+    # Return a lambda that calls the command with the additional args
+    # Assign it the same name as the original command for testing purposes
+    def command_w_args():
+        return command(*args[2:])
+
+    command_w_args.__name__ = command.__name__
+
+    return command_w_args
+
+
+def main():
+    get_command_from_args(sys.argv)()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

manage_iocs/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None

manage_iocs/commands.py

@@ -0,0 +1,387 @@
+import inspect
+import socket
+import sys
+import time as ttime
+from subprocess import PIPE, Popen
+
+from . import __version__, utils
+
+EXTRA_PAD_WIDTH = 5
+
+# Length added to string to account for ANSI color escape codes
+ANSI_COLOR_ESC_CODE_LEN = 9
+
+
+def version():
+    """Print the version of the manage-iocs package."""
+
+    print(f"Version: {__version__}")
+    return 0
+
+
+def help():
+    """Display this help message."""
+    version()
+    print("Usage: manage-iocs [command] <ioc>")
+    print("Available commands:")
+    docs: dict[str, str] = {}
+    signatures: dict[str, list[str]] = {}
+    for func in inspect.getmembers(sys.modules[__name__], inspect.isfunction):
+        docs[func[0]] = str(func[1].__doc__)
+        signatures[func[0]] = list(inspect.signature(func[1]).parameters.keys())
+
+    usages = [
+        f"  {name} " + " ".join(f"<{param}>" for param in params)
+        for name, params in signatures.items()
+    ]
+    max_sig_len = max(len(sig) for sig in usages)
+
+    for usage, doc in zip(usages, docs.values(), strict=False):
+        print(f"  {usage.ljust(max_sig_len + EXTRA_PAD_WIDTH)} - {doc}")
+    return 0
+
+
+@utils.requires_ioc_installed
+def attach(ioc: str):
+    """Connect to procServ telnet server for the given IOC."""
+
+    is_running, _ = utils.get_ioc_status(ioc)
+    if is_running != "Running":
+        raise RuntimeError(f"Cannot attach to IOC '{ioc}': IOC is not running!")
+
+    procserv_port = utils.get_ioc_procserv_port(ioc)
+    print(f"Attaching to IOC '{ioc}' at port {procserv_port}...")
+    proc = Popen(
+        ["telnet", "localhost", str(procserv_port)],
+        stdin=PIPE,
+        stdout=PIPE,
+    )
+    return proc.wait()
+
+
+def report():
+    """Show config(s) of an all IOCs on localhost"""
+    base_hostname = socket.gethostname()
+    if "." in base_hostname:
+        base_hostname = base_hostname.split(".")[0]
+
+    iocs = [
+        ioc_config
+        for ioc_config in utils.find_iocs().values()
+        if ioc_config.host == "localhost"
+        or ioc_config.host == base_hostname
+        or ioc_config.host == socket.gethostname()
+    ]
+
+    if len(iocs) == 0:
+        print("No IOCs found on configured to run on this host.")
+        print(f"Searched in: {utils.IOC_SEARCH_PATH}")
+        return 1
+
+    if len({ioc.procserv_port for ioc in iocs}) < len(iocs):
+        print("Warning: Detected multiple IOCs configured to use the same procServ port!")
+    elif len({ioc.name for ioc in iocs}) < len(iocs):
+        print("Warning: Detected multiple IOCs configured with the same name!")
+
+    max_base_len = max(len(str(ioc.path)) for ioc in iocs) + EXTRA_PAD_WIDTH
+    max_ioc_name_len = max(len(ioc.name) for ioc in iocs) + EXTRA_PAD_WIDTH
+    max_user_len = max(len(ioc.user) for ioc in iocs) + EXTRA_PAD_WIDTH
+    max_port_len = max(len(str(ioc.procserv_port)) for ioc in iocs) + EXTRA_PAD_WIDTH
+    max_exec_len = max(len(ioc.exec_path) for ioc in iocs) + max_base_len - EXTRA_PAD_WIDTH
+
+    header = (
+        f"{'BASE'.ljust(max_base_len)}| {'IOC'.ljust(max_ioc_name_len)}| "
+        f"{'USER'.ljust(max_user_len)}| {'PORT'.ljust(max_port_len)}| "
+        f"{'EXEC'.ljust(max_exec_len)}"
+    )
+    print(header)
+    print("-" * len(header))
+    for ioc in iocs:
+        ttime.sleep(0.01)
+        print(
+            f"{str(ioc.path).ljust(max_base_len)}| {ioc.name.ljust(max_ioc_name_len)}| "
+            f"{ioc.user.ljust(max_user_len)}| {str(ioc.procserv_port).ljust(max_port_len)}| "
+            f"{str(ioc.path / ioc.chdir / ioc.exec_path).ljust(max_exec_len)}"
+        )
+
+
+@utils.requires_root
+@utils.requires_ioc_installed
+def disable(ioc: str):
+    """Disable autostart for the given IOC."""
+
+    _, _, ret = utils.systemctl_passthrough("disable", ioc)
+    if ret == 0:
+        print(f"Autostart disabled for IOC '{ioc}'")
+    else:
+        raise RuntimeError(f"Failed to disable autostart for IOC '{ioc}'!")
+    return ret
+
+
+@utils.requires_root
+@utils.requires_ioc_installed
+def enable(ioc: str):
+    """Enable autostart for the given IOC."""
+
+    _, _, ret = utils.systemctl_passthrough("enable", ioc)
+    if ret == 0:
+        print(f"Autostart enabled for IOC '{ioc}'")
+    else:
+        raise RuntimeError(f"Failed to enable autostart for IOC '{ioc}'!")
+    return ret
+
+
+@utils.requires_ioc_installed
+def start(ioc: str):
+    """Start the given IOC."""
+
+    _, _, ret = utils.systemctl_passthrough("start", ioc)
+    if ret == 0:
+        print(f"IOC '{ioc}' started successfully.")
+    else:
+        raise RuntimeError(f"Failed to start IOC '{ioc}'!")
+    return ret
+
+
+def startall():
+    """Start all IOCs on this host."""
+
+    iocs = utils.find_installed_iocs().values()
+    ret = 0
+    for ioc in iocs:
+        ret += start(ioc.name)
+    return ret
+
+
+@utils.requires_ioc_installed
+def stop(ioc: str):
+    """Stop the given IOC."""
+
+    _, _, ret = utils.systemctl_passthrough("stop", ioc)
+    if ret == 0:
+        print(f"IOC '{ioc}' stopped successfully.")
+    else:
+        raise RuntimeError(f"Failed to stop IOC '{ioc}'!")
+    return ret
+
+
+def stopall():
+    """Stop all IOCs on this host."""
+
+    iocs = utils.find_installed_iocs().values()
+    ret = 0
+    for ioc in iocs:
+        ret += stop(ioc.name)
+    return ret
+
+
+@utils.requires_root
+def enableall():
+    """Enable autostart for all IOCs on this host."""
+
+    iocs = utils.find_installed_iocs().values()
+    ret = 0
+    for ioc in iocs:
+        ret += enable(ioc.name)
+    return ret
+
+
+@utils.requires_root
+def disableall():
+    """Disable autostart for all IOCs on this host."""
+
+    iocs = utils.find_installed_iocs().values()
+    ret = 0
+    for ioc in iocs:
+        ret += disable(ioc.name)
+    return ret
+
+
+@utils.requires_ioc_installed
+def restart(ioc: str):
+    """Restart the given IOC."""
+
+    _, _, ret = utils.systemctl_passthrough("restart", ioc)
+    if ret == 0:
+        print(f"IOC '{ioc}' restarted successfully.")
+    else:
+        raise RuntimeError(f"Failed to restart IOC '{ioc}'!")
+    return ret
+
+
+@utils.requires_root
+def uninstall(ioc: str):
+    """Remove /etc/systemd/system/softioc-[ioc].service"""
+
+    _, _, ret = utils.systemctl_passthrough("stop", ioc)
+    if ret != 0:
+        raise RuntimeError(f"Failed to stop IOC '{ioc}' before uninstalling!")
+    _, _, ret = utils.systemctl_passthrough("disable", ioc)
+    if ret != 0:
+        raise RuntimeError(f"Failed to disable IOC '{ioc}' before uninstalling!")
+    _, _, ret = utils.systemctl_passthrough("uninstall", ioc)
+    if ret == 0:
+        print(f"IOC '{ioc}' uninstalled successfully.")
+    else:
+        raise RuntimeError(f"Failed to uninstall IOC '{ioc}'!")
+    return ret
+
+
+@utils.requires_root
+def install(ioc: str):
+    """Create /etc/systemd/system/softioc-[ioc].service"""
+
+    iocs = utils.find_installed_iocs()
+    if ioc in iocs:
+        raise RuntimeError(f"IOC '{ioc}' is already installed!")
+
+    procserv_ports = [ioc.procserv_port for ioc in utils.find_installed_iocs().values()]
+    if utils.find_iocs()[ioc].procserv_port in procserv_ports:
+        raise RuntimeError(
+            f"Cannot install IOC '{ioc}': procServ port "
+            f"{utils.find_iocs()[ioc].procserv_port} is already in use!"
+        )
+
+    service_file = utils.SYSTEMD_SERVICE_PATH / f"softioc-{ioc}.service"
+    ioc_config = utils.find_iocs()[ioc]
+    base_hostname = socket.gethostname()
+    if "." in base_hostname:
+        base_hostname = base_hostname.split(".")[0]
+
+    if ioc_config.host not in [base_hostname, "localhost", socket.gethostname()]:
+        raise RuntimeError(
+            f"Cannot install IOC '{ioc}' on this host; configured host is '{ioc_config.host}'!"
+        )
+
+    if ioc_config.user == "root":
+        raise RuntimeError(f"Refusing to install IOC '{ioc}' to run as user 'root'!")
+
+    with open(service_file, "w") as f:
+        f.write(
+            f"""
+#
+# Installed by manage-iocs
+#
+[Unit]
+Description=IOC {ioc} via procServ
+After=network.target remote_fs.target local_fs.target syslog.target time.target centrifydc.service
+ConditionFileIsExecutable=/usr/bin/procServ
+
+[Service]
+User={ioc_config.user}
+ExecStart=/usr/bin/procServ -f -q -c {ioc_config.path} -i ^D^C^] -p /var/run/softioc-{ioc}.pid \
+  -n {ioc} --restrict -L /var/log/softioc/{ioc}/{ioc}.log \
+  {ioc_config.procserv_port} {ioc_config.path}/{ioc_config.exec_path}
+Environment="PROCPORT={ioc_config.procserv_port}"
+Environment="HOSTNAME={ioc_config.host}"
+Environment="IOCNAME={ioc}"
+Environment="TOP={ioc_config.path}"
+#Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+"""
+        )
+
+    _, stderr, ret = utils.systemctl_passthrough("install", ioc)
+    if ret == 0:
+        print(f"IOC '{ioc}' installed successfully.")
+    else:
+        raise RuntimeError(f"Failed to install IOC '{ioc}'!: {stderr.strip()}")
+    return ret
+
+
+def status():
+    """Get the status of the given IOC."""
+
+    ret = 0
+    statuses: dict[str, tuple[str, bool]] = {}
+    installed_iocs = utils.find_installed_iocs().keys()
+    if len(installed_iocs) == 0:
+        print("No Installed IOCs found on this host.")
+        return 1
+
+    for installed_ioc in installed_iocs:
+        try:
+            statuses[installed_ioc] = utils.get_ioc_status(installed_ioc)
+        except RuntimeError:
+            pass  # TODO: Handle this better?
+
+    max_ioc_name_len = max(len(ioc_name) for ioc_name in statuses.keys()) + EXTRA_PAD_WIDTH
+    max_status_len = max(len(status[0]) for status in statuses.values()) + EXTRA_PAD_WIDTH
+    max_enabled_len = len("Auto-Start")
+
+    print(f"{'IOC'.ljust(max_ioc_name_len)}{'Status'.ljust(max_status_len)}Auto-Start")
+    ttime.sleep(0.01)
+    print("-" * (max_ioc_name_len + max_status_len + max_enabled_len))
+    for ioc_name, (state, is_enabled) in statuses.items():
+        ttime.sleep(0.01)
+        if state == "Running":
+            state_str = f"\033[92m{state}\033[0m"  # Green
+        elif state == "Stopped":
+            state_str = f"\033[91m{state}\033[0m"  # Red
+        else:
+            state_str = f"\033[93m{state}\033[0m"  # Yellow
+        print(
+            f"{ioc_name.ljust(max_ioc_name_len)}{state_str.ljust(max_status_len + ANSI_COLOR_ESC_CODE_LEN)}{'Enabled' if is_enabled else 'Disabled'}"  # noqa: E501
+        )
+
+    return ret
+
+
+def nextport():
+    """Find the next unused procServ port."""
+
+    used_ports = [ioc.procserv_port for ioc in utils.find_iocs().values()]
+
+    print(max(used_ports) + 1 if len(used_ports) > 0 else 4000)
+    return 0
+
+
+@utils.requires_ioc_installed
+def lastlog(ioc: str):
+    """Display the output of the last IOC startup"""
+
+    log_file = utils.MANAGE_IOCS_LOG_PATH / f"{ioc}.log"
+    if not log_file.exists():
+        raise RuntimeError(f"No log file found for IOC '{ioc}' at '{log_file}'!")
+
+    with open(log_file) as f:
+        log = f.readlines()
+        start_index = 0
+        for i, line in reversed(list(enumerate(log))):
+            if line.strip() == f'@@@ Restarting child "{ioc}"':
+                start_index = i
+                break
+        if start_index == 0:
+            last_log = "".join(log)
+        else:
+            last_log = "".join(log[start_index:])
+        print(last_log)
+    return 0
+
+
+@utils.requires_ioc_installed
+@utils.requires_root
+def rename(ioc: str, new_name: str):
+    """Rename an installed IOC."""
+
+    state, is_enabled = utils.get_ioc_status(ioc)
+    uninstall(ioc)
+
+    ioc_config = utils.find_iocs()[ioc]
+    with open(ioc_config.path / "config", "w") as f:
+        f.write(f"NAME={new_name}\n")
+        f.write(f"HOST={ioc_config.host}\n")
+        f.write(f"PORT={ioc_config.procserv_port}\n")
+        f.write(f"USER={ioc_config.user}\n")
+        if ioc_config.exec_path:
+            f.write(f"EXEC={ioc_config.exec_path}\n")
+        if ioc_config.chdir and len(ioc_config.chdir) > 0:
+            f.write(f"CHDIR={ioc_config.chdir}\n")
+
+    install(new_name)
+    if is_enabled:
+        enable(new_name)
+    if state == "Running":
+        start(new_name)

manage_iocs/utils.py

@@ -0,0 +1,136 @@
+import functools
+import os
+import socket
+from collections.abc import Callable
+from dataclasses import dataclass
+from pathlib import Path
+from subprocess import PIPE, Popen
+
+IOC_SEARCH_PATH = [Path("/epics/iocs"), Path("/opt/epics/iocs"), Path("/opt/iocs")]
+if "MANAGE_IOCS_SEARCH_PATH" in os.environ:
+    IOC_SEARCH_PATH.extend(
+        [Path(p) for p in os.environ["MANAGE_IOCS_SEARCH_PATH"].split(os.pathsep)]
+    )
+
+SYSTEMD_SERVICE_PATH = Path("/etc/systemd/system")
+MANAGE_IOCS_LOG_PATH = Path("/var/log/softioc")
+
+
+@dataclass
+class IOC:
+    name: str
+    user: str
+    procserv_port: int
+    path: Path
+    host: str
+    exec_path: str
+    chdir: str
+
+
+def read_config_file(config_path: Path) -> dict[str, str]:
+    """Read config file for IOC"""
+    config: dict[str, str] = {}
+    with open(config_path) as f:
+        for line in f:
+            line = line.strip()
+            if line and not line.startswith("#"):
+                key, value = line.split("=", 1)
+                config[key.strip()] = value.strip()
+    return config
+
+
+def find_iocs() -> dict[str, IOC]:
+    """Get a list of IOCs available in the search paths."""
+    iocs = {}
+    search_paths = IOC_SEARCH_PATH
+    for search_path in search_paths:
+        if os.path.exists(search_path):
+            for item in os.listdir(search_path):
+                if os.path.isdir(search_path / item) and os.path.exists(
+                    search_path / item / "config"
+                ):
+                    config = read_config_file(search_path / item / "config")
+                    iocs[item] = IOC(
+                        name=item,
+                        procserv_port=int(config["PORT"]),
+                        path=search_path / item,
+                        host=config.get("HOST", "localhost"),
+                        user=config.get("USER", "iocuser"),
+                        exec_path=config.get("EXEC", "st.cmd"),
+                        chdir=config.get("CHDIR", "."),
+                    )
+    return iocs
+
+
+def find_iocs_on_host() -> dict[str, IOC]:
+    """Get a list of IOCs available on the given host."""
+    all_iocs = find_iocs()
+    return {
+        name: ioc
+        for name, ioc in all_iocs.items()
+        if ioc.host == socket.gethostname() or ioc.host == "localhost"
+    }
+
+
+def find_installed_iocs() -> dict[str, IOC]:
+    """Get a list of IOCs that have systemd service files installed."""
+    iocs = {}
+    for ioc in find_iocs().values():
+        service_file = SYSTEMD_SERVICE_PATH / f"softioc-{ioc.name}.service"
+        if service_file.exists():
+            iocs[ioc.name] = ioc
+    return iocs
+
+
+def get_ioc_procserv_port(ioc: str) -> int:
+    """Get the procServ port number for the given IOC."""
+
+    return find_iocs()[ioc].procserv_port
+
+
+def systemctl_passthrough(action: str, ioc: str) -> tuple[str, str, int]:
+    """Helper to call systemctl with the given action and IOC name."""
+    proc = Popen(["systemctl", action, f"softioc-{ioc}.service"], stdin=PIPE, stdout=PIPE)
+    out, err = proc.communicate()
+    decoded_out = out.decode().strip() if out else ""
+    decoded_err = err.decode().strip() if err else ""
+    return decoded_out, decoded_err, proc.returncode
+
+
+def get_ioc_status(ioc_name: str) -> tuple[str, bool]:
+    """Get the active and enabled status of the given IOC."""
+
+    state, err, _ = systemctl_passthrough("is-active", ioc_name)
+
+    # Convert to more user-friendly terms
+    if state == "active":
+        state = "Running"
+    elif state == "inactive":
+        state = "Stopped"
+
+    enabled, err, _ = systemctl_passthrough("is-enabled", ioc_name)
+    if enabled not in ("enabled", "disabled"):
+        raise RuntimeError(err)
+
+    return state.capitalize(), enabled == "enabled"
+
+
+def requires_root(func: Callable):
+    @functools.wraps(func)
+    def wrapper(*args):
+        if os.geteuid() != 0:
+            raise PermissionError(f"Command {func.__name__} requires root privileges.")
+        return func(*args)
+
+    return wrapper
+
+
+def requires_ioc_installed(func: Callable):
+    @functools.wraps(func)
+    def wrapper(ioc: str, *args, **kwargs):
+        installed_iocs = find_installed_iocs()
+        if ioc not in installed_iocs:
+            raise RuntimeError(f"No IOC with name '{ioc}' is installed!")
+        return func(ioc, *args, **kwargs)
+
+    return wrapper

manage_iocs-0.1.0.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: manage-iocs
+Version: 0.1.0
+Summary: CLI utility for auto-creating phoebus engineering screens from EPICS db templates
+Author-email: Jakub Wlodek <jwlodek@bnl.gov>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Brookhaven National Laboratory
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Project-URL: GitHub, https://github.com/NSLS2/manage-iocs
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Provides-Extra: dev
+Requires-Dist: copier; extra == "dev"
+Requires-Dist: pipdeptree; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pyright; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: tox-direct; extra == "dev"
+Requires-Dist: types-mock; extra == "dev"
+Requires-Dist: import-linter; extra == "dev"
+Dynamic: license-file
+
+# Manage-IOCs [![CI](https://github.com/NSLS2/manage-iocs/actions/workflows/ci.yml/badge.svg)](https://github.com/NSLS2/manage-iocs/actions/workflows/ci.yml)
+
+A re-write of the `manage-iocs` utility in pure python.

manage_iocs-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+manage_iocs/__init__.py,sha256=Ksms_WJF8LTkbm38gEpm1jBpGqcQ8NGvmb2ZJlOE1j8,198
+manage_iocs/__main__.py,sha256=zdgO1if090egIEVwHFea4T73NuRIER-q8LAm1ioSyXE,1005
+manage_iocs/_version.py,sha256=5jwwVncvCiTnhOedfkzzxmxsggwmTBORdFL_4wq0ZeY,704
+manage_iocs/commands.py,sha256=wsvKlZ6xEj_JWyqfVg4lK1ovP4lpr1N4aoeKw3W5cWw,11874
+manage_iocs/utils.py,sha256=gAQVC5F908LHxQ32wp_BXpUieZnbtrT2I9b7TYN55Fc,4309
+manage_iocs-0.1.0.dist-info/licenses/LICENSE,sha256=kF_ROu6b6TScdLaB1UbUhxnQAya6_eS90L3YJWt8dlc,1545
+manage_iocs-0.1.0.dist-info/METADATA,sha256=DgPZHuEfeVJG98U2Xq5VJ1YFHe8HXs2RIXzT557kA_c,3032
+manage_iocs-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+manage_iocs-0.1.0.dist-info/entry_points.txt,sha256=GtfxlU1jaRqK2R3Zd7kux1m1ySTiMk6ftaElbbKUEuE,58
+manage_iocs-0.1.0.dist-info/top_level.txt,sha256=ZWSNEmez5G5Em-4EPOM83S1ypgwVHDOFl4YVpt3r2-E,12
+manage_iocs-0.1.0.dist-info/RECORD,,

manage_iocs-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

manage_iocs-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+manage-iocs = manage_iocs.__main__:main

manage_iocs-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Brookhaven National Laboratory
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

manage_iocs-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+manage_iocs