manyterm 1.0.0__py3-none-any.whl

manyterm/__init__.py

@@ -0,0 +1,2 @@
+from .manyterm import Terminal
+#from .manyterm_tk import Terminal

manyterm/manyterm.py

@@ -0,0 +1,130 @@
+import subprocess
+import socket
+import atexit
+import uuid
+import sys
+import os
+
+_MANYTERM_PORT = 16161
+_MANYTERM_HOST = '127.0.0.1'
+
+
+if sys.platform not in ["linux", "win32", "darwin"]:
+    raise Exception(f"Platform \"{sys.platform}\" not supported for package manyterm")
+
+# server for sending text and listening for new connections
+# all static methods so there is only one instance
+class _Server:
+
+    _running = False
+    _socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    _connections = {}
+
+    @staticmethod
+    def start():
+        if not _Server._running:
+            _Server._running = True
+            _Server._socket.bind((_MANYTERM_HOST, _MANYTERM_PORT))
+            _Server._socket.settimeout(10)
+            # close server and windows on exit
+            atexit.register(_Server.stop)
+
+
+    # listen for new connections
+    @staticmethod
+    def listen():
+        data, addr = _Server._socket.recvfrom(1024)
+        if data is not None:
+            _Server._connections[data.decode('utf-8')] = addr
+        else:
+            assert Exception("Could not bind window to server")
+
+
+    @staticmethod # print to a window based on the uid
+    def send(uid, b):
+        addr = _Server._connections.get(uid, None)
+        if addr is not None:
+            _Server._socket.sendto(b, addr)
+        else:
+            assert Exception("Cannot print to closed terminal")
+
+    @staticmethod # close a window based on the uid
+    def close(uid):
+        _Server._socket.sendto(bytes(0), _Server._connections.get(uid))
+        _Server._connections.pop(uid)
+
+    @staticmethod
+    def stop(): # close all windows
+        for key in _Server._connections:
+            _Server._socket.sendto(bytes(0), _Server._connections.get(key))
+        _Server._socket.close()
+        _Server._running = False
+
+
+class Terminal:
+    _path = os.path.abspath(__file__)
+
+    def __init__(self, title="Terminal"):
+        """
+        Start a new terminal window
+        :param title: the title of the window (linux only)
+        """
+        # start server (if not running)
+        _Server.start()
+        # make uid for self
+        self._uid = str(uuid.uuid4())  # could also use uuid1()
+        # open window
+        if sys.platform == "linux":
+            subprocess.run(('gnome-terminal', '-t', f'{title}', '--', 'bash', '-c', f'{sys.executable} {self._path} {self._uid}'), shell=False)
+        elif sys.platform == "win32":
+            subprocess.run(('start', '/wait','cmd', '/c', f'{sys.executable} {self._path} {self._uid}'), shell=True)
+        elif sys.platform == "darwin":
+            subprocess.run(("osascript", "-e", f"tell application \"Terminal\" to do script \"{sys.executable} {self._path} {self._uid};exit\""), shell=False)
+        _Server.listen()  # wait for window to open and listen for new connection
+
+    def print(self, txt, end="\n"):
+        """
+        Prints to the window
+        :param txt: the string to print
+        :param end: the end of the string
+        """
+        _Server.send(self._uid, bytes(txt+end, 'utf-8'))
+
+    def close(self):
+        """
+        Closes the window
+        """
+        _Server.close(self._uid)
+
+    def close_all(self):
+        """
+        Closes all windows
+        """
+        _Server.stop()
+
+
+# called from subprocess to open window
+# acts as a client to connect to the server and listens for data to print
+class _TerminalClient:
+    def __init__(self):
+        if len(sys.argv) != 2:
+            raise Exception("Usage: python3 manyterm.py <uid>")
+
+        self._uid = sys.argv[1]
+
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+
+        # send uid to server
+        s.sendto(bytes(self._uid, 'utf-8'), (_MANYTERM_HOST, _MANYTERM_PORT))
+
+        while True:
+            data, addr = s.recvfrom(1024)
+            if data == bytes(0):
+                break
+            else:
+                print(data.decode('utf-8'), end="")
+        s.close()
+
+
+if __name__ == '__main__':
+    _TerminalClient()

manyterm/manyterm_tk.py

@@ -0,0 +1,71 @@
+from time import sleep
+import tkinter as tk
+from tkinter import ttk
+import threading
+
+
+class Terminal(threading.Thread):
+
+    def __init__(self, title="Terminal", height=20, width=100, font=("Courier New", "12"), backgroundColor="gray5", textColor="snow", allowClosing=True, redirectClosedPrints=True):
+        #params
+        self.title = title
+        self.height = height
+        self.width = width
+        self.font = font
+        self.backgroundColor = backgroundColor
+        self.textColor = textColor
+        self.allowClosing = allowClosing
+        self.redirectClosedPrints = redirectClosedPrints
+        #internal variables
+        self._root = None  # main window
+        self._tb = None  # text box
+        self.isOpen = False  # if the window is open
+        self._safeExit = False  # if the window is safe to exit
+        threading.Thread.__init__(self, daemon=True)  # kill child thread on main thread exit
+        self.start()
+        sleep(0.5)  # wait for window to open
+
+    def close(self):
+        if self.isOpen and self._safeExit:  # safeExit is True is no operations are being done (i.e. print)
+            self.isOpen = False
+            self._root.quit()
+            self._root.update()
+            self._root = None
+
+    def run(self):
+        self._root = tk.Tk()
+        if self.allowClosing: self._root.protocol("WM_DELETE_WINDOW", self.close)
+        else: self._root.protocol("WM_DELETE_WINDOW", lambda: None)
+        self._root.title(self.title)
+        self._tb = tk.Text(self._root, height=self.height, width=self.width, wrap="none", font=self.font)
+        self._tb.pack(side="left", fill="both", expand=True)
+        self._tb.configure(state="disabled", bg=self.backgroundColor, fg=self.textColor)
+        sizegrip = ttk.Sizegrip(self._tb)
+        sizegrip.configure(cursor="sizing")
+        sizegrip.bind("<1>", self._resize_start)
+        sizegrip.bind("<B1-Motion>", self._resize_update)
+        self.isOpen = True
+        self._safeExit = True
+        self._root.mainloop()
+
+    def print(self, toPrint, end="\n"):
+        if self._root is None or not self.isOpen:
+            if self.redirectClosedPrints: print(toPrint, end=end)  # redirect output
+            #return print(f"Terminal \"{self.title}\" is closed")
+            #raise Exception(f"Terminal \"{self.title}\" is closed")
+        else:
+            self._safeExit = False  # needed so that we don't kill mainloop while printing
+            self._tb.configure(state="normal")
+            self._tb.see("end")
+            self._tb.insert("end", f"{toPrint}{end}")
+            self._tb.configure(state="disabled")
+            self._safeExit = True
+
+    def _resize_start(self, event):
+        self._x = event.x
+        self._y = event.y
+
+    def _resize_update(self, event):
+        delta_x = event.x - self._x
+        delta_y = event.y - self._y
+        self._tb.place_configure(width=self._tb.winfo_width() + delta_x, height=self._tb.winfo_height() + delta_y)

manyterm-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Tyler Bowers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

manyterm-1.0.0.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.1
+Name: manyterm
+Version: 1.0.0
+Summary: manyterm - spawn multiple terminals to print to
+Author: Tyler Bowers
+Author-email: tylerebowers@gmail.com
+License: MIT
+Project-URL: Source, https://github.com/tylerebowers/manyterm-python
+Project-URL: PyPI, https://pypi.org/project/manyterm/
+Keywords: python,terminal,print
+Classifier: Topic :: Terminals
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Manyterm
+Spawn multiple terminals to print to.  
+Compatible with Windows, Linux, and MacOS.    
+### Installation
+`pip install manyterm`
+### Usage
+```py
+import manyterm 
+
+t1 = manyterm.Terminal() # init a new window
+
+t1.print("Hello World") # print to the window
+
+t1.print("supercalifragilisticexpialidocious", end="") # default end="\n"
+
+t1.close() # close the window
+```
+### Description
+This program creates multiple terminals in python. New terminals can only be printed to (no input). `tests/test.py` contains an example of how to use this program. A server is used to print to client windows based on a uuid. When a new window object is made `manyterm.Terminal()` the program check to make sure that the server is running, then assigns itself a uuid, and then the program calls itself from a new terminal using the uuid as an argument. The new program contacts the server with its' uuid and the connection is made.
+## Windows 11
+![Picture showing windows example](tests/screenshot-win.png)
+## Linux (Ubuntu 23.10)
+![Picture showing windows example](tests/screenshot-linux.png)
+## MacOS Sonoma
+![Picture showing windows example](tests/screenshot-macos.jpg)

manyterm-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+manyterm/__init__.py,sha256=j0xHtJEbaS7LjUBZvFVIuRnvvmgJCup7nGkamf4It1I,65
+manyterm/manyterm.py,sha256=bD3JLdL5tp4kWXQp9jlmiUNp-txtNCwOuC7HJc85C1A,3968
+manyterm/manyterm_tk.py,sha256=oyTN9AYgMBqPcgDerTML5GGDIipfqv94zatd53pw4fY,2962
+manyterm-1.0.0.dist-info/LICENSE,sha256=hjzpaUekXMmk3H45s6cm049FnUxrJ4QDOhv_8ClITO8,1069
+manyterm-1.0.0.dist-info/METADATA,sha256=zo0_srBLSml6sc0f0FVBqdkq7STOD8I-DBCRjfJ9VO4,1887
+manyterm-1.0.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+manyterm-1.0.0.dist-info/top_level.txt,sha256=A9uJ6-Un6lnPFdgdge78cCzPqG4bbp8yYE9Ky1YOl4M,9
+manyterm-1.0.0.dist-info/RECORD,,

manyterm-1.0.0.dist-info/WHEEL

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

manyterm-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+manyterm