e3sertools 0.0.1__tar.gz

e3sertools-0.0.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: e3sertools
+Version: 0.0.1
+Summary: Tools for interacting with e3series
+Author-email: kham@tuta.io
+Maintainer-email: kham@tuta.io
+License-Expression: Unlicense
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: unlicense
+Dynamic: license-file
+
+# Python package `e3sertools`
+
+Handy tools for working with Zuken E3.series API using e3series package.

e3sertools-0.0.1/e3sertools/__init__.py

@@ -0,0 +1,99 @@
+import os
+import sys
+from contextvars import ContextVar
+
+import psutil
+from e3series import Application
+
+active_app: ContextVar[Application | None] = ContextVar("active_app", default=None)
+
+
+def show(*values: object) -> None:
+    message = " ".join(map(str, values))
+    print(message)
+    if app := active_app.get():
+        app.PutMessageEx(0, message, 0, 100, 50, 255)
+
+
+def warn(*values: object) -> None:
+    message = " ".join(map(str, values))
+    print("W:", message, file=sys.stderr)
+    if app := active_app.get():
+        app.PutWarning(0, message)
+
+
+def alert(*values: object) -> None:
+    message = " ".join(map(str, values))
+    print("E:", message, file=sys.stderr)
+    if app := active_app.get():
+        app.PutError(0, message)
+
+
+def _set_active_e3(app: Application) -> int:
+    active_app.set(app)
+    return app.GetId()
+
+
+def resolve_e3() -> int:
+    if pid := int(os.environ.get("E3_SERIES_PID", 0)):
+        return _set_active_e3(Application(pid))
+    ppid = os.getpid()
+    while ppid:
+        try:
+            process = psutil.Process(ppid)
+        except psutil.NoSuchProcess:
+            break
+        if process.exe().endswith("\\E3.series"):
+            pid = ppid
+            break
+        ppid = process.ppid()
+    if not pid:
+        pids = get_running_e3s()
+        pid = pids[0] if len(pids) == 1 else prompt_user_to_select_e3(pids)
+    os.environ["E3_SERIES_PID"] = str(pid)
+    return _set_active_e3(Application(pid))
+
+
+def prompt_user_to_select_e3(pids: list[int] | None = None) -> int:
+    import tkinter as tk
+
+    if pids is None:
+        pids = get_running_e3s()
+    if not pids:
+        # raise UserError("Running process missing")
+        raise ProcessLookupError("No process running")
+    name: str = ""
+    options: dict[int, str] = {}
+    for pid in pids:
+        app = Application(pid)
+        name = app.GetName()
+        path = app.GetProjectInformation("")[1]
+        description = f"{name} [{pid}] {path}"
+        options[pid] = description
+    pid = 0
+
+    def submit() -> None:
+        nonlocal pid
+        if pid := user_selection.get():
+            win.quit()
+
+    win = tk.Tk()
+    win.title(name)
+    user_selection = tk.IntVar(value=pid)
+    for pid, description in options.items():
+        tk.Radiobutton(win, variable=user_selection, value=pid, text=description).pack(anchor=tk.W)
+    tk.Button(win, text="OK".center(10), command=submit).pack(pady=2)
+    win.mainloop()
+    if not pid:
+        raise KeyboardInterrupt("User canceled connection")
+    return pid
+
+
+def get_running_e3s() -> list[int]:
+    import e3series.tools
+
+    return e3series.tools.get_running_e3s()
+
+
+class UserError(Exception):
+    pass

e3sertools-0.0.1/e3sertools/job.py

@@ -0,0 +1,38 @@
+import gc
+from collections.abc import Generator
+from contextlib import contextmanager
+from contextvars import ContextVar
+from typing import Any
+
+from e3series import Application, Job
+
+from . import active_app, resolve_e3
+
+active_job: ContextVar[Job | None] = ContextVar("active_job", default=None)
+
+
+@contextmanager
+def use(job: Job) -> Generator[None]:
+    try:
+        with active_job.set(job):
+            yield None
+    finally:
+        del job
+        gc.collect()
+
+
+@contextmanager
+def connect_to_application(app: Application | int | None = None) -> Generator[None]:
+    if app is None:
+        app = Application(resolve_e3())
+    elif isinstance(app, int):
+        app = Application(app)
+    with active_app.set(app):
+        with use(app.CreateJobObject()):
+            yield None
+
+
+def __getattr__(name: str) -> Any:
+    if job := active_job.get():
+        return getattr(job, name)
+    raise ValueError("Missing active job")

e3sertools-0.0.1/e3sertools.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: e3sertools
+Version: 0.0.1
+Summary: Tools for interacting with e3series
+Author-email: kham@tuta.io
+Maintainer-email: kham@tuta.io
+License-Expression: Unlicense
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: unlicense
+Dynamic: license-file
+
+# Python package `e3sertools`
+
+Handy tools for working with Zuken E3.series API using e3series package.

e3sertools-0.0.1/e3sertools.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+pyproject.toml
+readme.md
+unlicense
+e3sertools/__init__.py
+e3sertools/job.py
+e3sertools/py.typed
+e3sertools.egg-info/PKG-INFO
+e3sertools.egg-info/SOURCES.txt
+e3sertools.egg-info/dependency_links.txt
+e3sertools.egg-info/top_level.txt

e3sertools-0.0.1/e3sertools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

e3sertools-0.0.1/e3sertools.egg-info/top_level.txt

@@ -0,0 +1 @@
+e3sertools

e3sertools-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "e3sertools"
+version = "0.0.1"
+description = "Tools for interacting with e3series"
+readme = "readme.md"
+requires-python = ">=3.14"
+license = "Unlicense"
+license-files = ["unlicense"]
+authors = [{ email = "kham@tuta.io" }]
+maintainers = [{ email = "kham@tuta.io" }]
+keywords = []
+classifiers = [
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Typing :: Typed",
+]
+dependencies = []
+
+# [project.scripts]
+# e3tools = "e3tools:main"

e3sertools-0.0.1/readme.md

@@ -0,0 +1,3 @@
+# Python package `e3sertools`
+
+Handy tools for working with Zuken E3.series API using e3series package.

e3sertools-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

e3sertools-0.0.1/unlicense

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org/>