python-comport 0.1.0__tar.gz

python_comport-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: python-comport
+Version: 0.1.0
+Summary: Interactive arrow-key serial COM port terminal
+License: MIT
+Keywords: serial,com port,uart,terminal,tty
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Terminals :: Serial
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pyserial>=3.5
+
+# python-comport
+
+An interactive serial COM port terminal for the command line.
+
+- Arrow-key menu to select the port
+- Remembers your last port and baud rate — just press Enter to reconnect
+- Works on Linux, macOS, and Windows
+- No extra dependencies beyond `pyserial`
+
+## Installation
+
+```bash
+pip install python-comport
+```
+
+## Usage
+
+```bash
+comport
+```
+
+1. Use `↑ ↓` to select a COM port and press **Enter**
+2. Enter a baud rate (or press **Enter** to use the last saved value, default 9600)
+3. Type messages and press **Enter** to send
+4. Type `exit` or press **Ctrl+C** to quit
+
+Settings are saved to `~/.comport-settings.json` so your last port and baud rate are pre-selected on the next run.
+
+## Requirements
+
+- Python 3.7+
+- pyserial
+
+## License
+
+MIT

python_comport-0.1.0/README.md

@@ -0,0 +1,36 @@
+# python-comport
+
+An interactive serial COM port terminal for the command line.
+
+- Arrow-key menu to select the port
+- Remembers your last port and baud rate — just press Enter to reconnect
+- Works on Linux, macOS, and Windows
+- No extra dependencies beyond `pyserial`
+
+## Installation
+
+```bash
+pip install python-comport
+```
+
+## Usage
+
+```bash
+comport
+```
+
+1. Use `↑ ↓` to select a COM port and press **Enter**
+2. Enter a baud rate (or press **Enter** to use the last saved value, default 9600)
+3. Type messages and press **Enter** to send
+4. Type `exit` or press **Ctrl+C** to quit
+
+Settings are saved to `~/.comport-settings.json` so your last port and baud rate are pre-selected on the next run.
+
+## Requirements
+
+- Python 3.7+
+- pyserial
+
+## License
+
+MIT

python_comport-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-comport"
+version = "0.1.0"
+description = "Interactive arrow-key serial COM port terminal"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.7"
+dependencies = ["pyserial>=3.5"]
+keywords = ["serial", "com port", "uart", "terminal", "tty"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Topic :: Terminals :: Serial",
+]
+
+[project.scripts]
+comport = "python_comport:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["python_comport*"]

python_comport-0.1.0/python_comport/__init__.py

@@ -0,0 +1,175 @@
+import json
+import os
+import sys
+import threading
+import time
+
+try:
+    import serial
+    import serial.tools.list_ports
+except ImportError:
+    print("Error: 'pyserial' library is required but not installed.")
+    print("    pip install pyserial")
+    sys.exit(1)
+
+SETTINGS_FILE = os.path.join(os.path.expanduser("~"), ".comport-settings.json")
+
+
+def load_settings():
+    try:
+        with open(SETTINGS_FILE) as f:
+            return json.load(f)
+    except Exception:
+        return {}
+
+
+def save_settings(port, baudrate):
+    with open(SETTINGS_FILE, "w") as f:
+        json.dump({"port": port, "baudrate": baudrate}, f)
+
+
+def get_key():
+    """Cross-platform function to detect arrow keys and Enter."""
+    if os.name == 'nt':
+        import msvcrt
+        key = msvcrt.getch()
+        if key in (b'\r', b'\n'):
+            return 'enter'
+        elif key == b'\xe0':
+            key2 = msvcrt.getch()
+            if key2 == b'H':
+                return 'up'
+            elif key2 == b'P':
+                return 'down'
+        return None
+    else:
+        import termios
+        import tty
+        fd = sys.stdin.fileno()
+        old_settings = termios.tcgetattr(fd)
+        try:
+            tty.setraw(fd)
+            ch = sys.stdin.read(1)
+            if ch == '\x1b':
+                ch2 = sys.stdin.read(1)
+                if ch2 == '[':
+                    ch3 = sys.stdin.read(1)
+                    if ch3 == 'A':
+                        return 'up'
+                    elif ch3 == 'B':
+                        return 'down'
+            elif ch in ('\r', '\n'):
+                return 'enter'
+            return None
+        finally:
+            termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+
+
+class SimpleMenu:
+    """Simple arrow-key menu (no extra dependencies)."""
+
+    def __init__(self, options, default=0):
+        self.options = options
+        self.selected = default
+
+    def display(self):
+        os.system('cls' if os.name == 'nt' else 'clear')
+        print("=== Select COM Port ===")
+        print("Use ↑ ↓ arrow keys to move, press Enter to select.")
+        print("(cursor pre-set to last used port)\n")
+        for i, option in enumerate(self.options):
+            prefix = "→ " if i == self.selected else "  "
+            print(f"{prefix}{option}")
+
+    def run(self):
+        while True:
+            self.display()
+            key = get_key()
+            if key == 'up':
+                self.selected = (self.selected - 1) % len(self.options)
+            elif key == 'down':
+                self.selected = (self.selected + 1) % len(self.options)
+            elif key == 'enter':
+                return self.selected
+
+
+def main():
+    settings = load_settings()
+
+    ports = list(serial.tools.list_ports.comports())
+    if not ports:
+        print("No COM ports found on your system.")
+        sys.exit(1)
+
+    ports = [p for p in ports if p.description and p.description.lower() != 'n/a']
+    if not ports:
+        print("No COM ports with valid descriptions found.")
+        sys.exit(1)
+
+    options = [f"{p.device}  —  {p.description}" for p in ports]
+
+    saved_port = settings.get("port")
+    default_idx = next((i for i, p in enumerate(ports) if p.device == saved_port), 0)
+
+    menu = SimpleMenu(options, default=default_idx)
+    selected_idx = menu.run()
+
+    selected_port = ports[selected_idx].device
+
+    saved_baud = settings.get("baudrate", 9600)
+    baud_input = input(f"\nEnter baud rate for {selected_port} (default {saved_baud}): ").strip()
+    try:
+        baudrate = int(baud_input) if baud_input else saved_baud
+    except ValueError:
+        print(f"Invalid baud rate → using {saved_baud}")
+        baudrate = saved_baud
+
+    save_settings(selected_port, baudrate)
+
+    try:
+        ser = serial.Serial(
+            port=selected_port,
+            baudrate=baudrate,
+            bytesize=serial.EIGHTBITS,
+            parity=serial.PARITY_NONE,
+            stopbits=serial.STOPBITS_ONE,
+            timeout=0.1,
+            xonxoff=False,
+            rtscts=False,
+            dsrdtr=False,
+        )
+        print(f"\n✅ Connected to {selected_port} @ {baudrate} baud")
+    except Exception as e:
+        print(f"❌ Failed to open {selected_port}: {e}")
+        sys.exit(1)
+
+    def serial_reader():
+        while ser.is_open:
+            try:
+                if ser.in_waiting > 0:
+                    data = ser.read(ser.in_waiting).decode('utf-8', errors='replace')
+                    if data:
+                        print(data, end='', flush=True)
+            except Exception:
+                break
+            time.sleep(0.01)
+
+    threading.Thread(target=serial_reader, daemon=True).start()
+
+    print("\n=== Serial Terminal Ready ===")
+    print("• Type your message and press Enter to send")
+    print("• Type 'exit' (or Ctrl+C) to quit\n")
+
+    try:
+        while True:
+            cmd = input()
+            if cmd.strip().lower() in ("exit", "quit"):
+                break
+            ser.write((cmd + '\r\n').encode('utf-8'))
+            ser.flush()
+    except KeyboardInterrupt:
+        print("\n\nInterrupted by user.")
+    finally:
+        if ser.is_open:
+            ser.close()
+        print("Serial port closed. Goodbye!")

python_comport-0.1.0/python_comport.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: python-comport
+Version: 0.1.0
+Summary: Interactive arrow-key serial COM port terminal
+License: MIT
+Keywords: serial,com port,uart,terminal,tty
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Terminals :: Serial
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pyserial>=3.5
+
+# python-comport
+
+An interactive serial COM port terminal for the command line.
+
+- Arrow-key menu to select the port
+- Remembers your last port and baud rate — just press Enter to reconnect
+- Works on Linux, macOS, and Windows
+- No extra dependencies beyond `pyserial`
+
+## Installation
+
+```bash
+pip install python-comport
+```
+
+## Usage
+
+```bash
+comport
+```
+
+1. Use `↑ ↓` to select a COM port and press **Enter**
+2. Enter a baud rate (or press **Enter** to use the last saved value, default 9600)
+3. Type messages and press **Enter** to send
+4. Type `exit` or press **Ctrl+C** to quit
+
+Settings are saved to `~/.comport-settings.json` so your last port and baud rate are pre-selected on the next run.
+
+## Requirements
+
+- Python 3.7+
+- pyserial
+
+## License
+
+MIT

python_comport-0.1.0/python_comport.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+python_comport/__init__.py
+python_comport.egg-info/PKG-INFO
+python_comport.egg-info/SOURCES.txt
+python_comport.egg-info/dependency_links.txt
+python_comport.egg-info/entry_points.txt
+python_comport.egg-info/requires.txt
+python_comport.egg-info/top_level.txt

python_comport-0.1.0/python_comport.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

python_comport-0.1.0/python_comport.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+comport = python_comport:main

python_comport-0.1.0/python_comport.egg-info/requires.txt

@@ -0,0 +1 @@
+pyserial>=3.5

python_comport-0.1.0/python_comport.egg-info/top_level.txt

@@ -0,0 +1 @@
+python_comport

python_comport-0.1.0/setup.cfg

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