libTerm 0.0.1__tar.gz

libterm-0.0.1/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

libterm-0.0.1/.idea/libTerm.iml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.12 virtualenv at /run/media/jeroen/CCCOMA_X64FRE_EN-GB_DV9/libTerm/.venv" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

libterm-0.0.1/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/libTerm.iml" filepath="$PROJECT_DIR$/.idea/libTerm.iml" />
+    </modules>
+  </component>
+</project>

libterm-0.0.1/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

libterm-0.0.1/.idea/workspace.xml

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="bc73ff2f-338a-4651-a389-91491c2041b6" name="Changes" comment="">
+      <change afterPath="$PROJECT_DIR$/.idea/inspectionProfiles/profiles_settings.xml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.idea/libTerm.iml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.idea/modules.xml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.idea/vcs.xml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/doc/dev/project.md" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/__init__.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/term/__init__.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/term/cursor.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/term/posix.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/term/types.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/libTerm/term/winnt.py" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/test.py" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 1
+}</component>
+  <component name="ProjectId" id="32XLRp94VBFj5lgNkdim9ARFbbU" />
+  <component name="ProjectLevelVcsManager">
+    <ConfirmationsSetting value="2" id="Add" />
+  </component>
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "Python.__init__ (1).executor": "Run",
+    "Python.__init__.executor": "Run",
+    "Python.test.executor": "Run",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "git-widget-placeholder": "master",
+    "last_opened_file_path": "/run/media/jeroen/CCCOMA_X64FRE_EN-GB_DV9/libTerm",
+    "settings.editor.selected.configurable": "com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable"
+  }
+}]]></component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="H:\libTerm" />
+      <recent name="H:\libTerm\src\libTerm" />
+    </key>
+  </component>
+  <component name="RunManager" selected="Python.test">
+    <configuration name="__init__ (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="libTerm" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/src/libTerm" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/src/libTerm/__init__.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="true" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="__init__" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="libTerm" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/src/libTerm/term" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/src/libTerm/term/__init__.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="test" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="libTerm" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/src" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/src/test.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="true" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python.test" />
+        <item itemvalue="Python.__init__ (1)" />
+        <item itemvalue="Python.__init__" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="bc73ff2f-338a-4651-a389-91491c2041b6" name="Changes" comment="" />
+      <created>1757561965114</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1757561965114</updated>
+    </task>
+    <servers />
+  </component>
+  <component name="XDebuggerManager">
+    <breakpoint-manager>
+      <breakpoints>
+        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
+          <url>file://$PROJECT_DIR$/src/libTerm/term/posix.py</url>
+          <line>1</line>
+          <option name="timeStamp" value="1" />
+        </line-breakpoint>
+      </breakpoints>
+    </breakpoint-manager>
+  </component>
+  <component name="github-copilot-workspace">
+    <instructionFileLocations>
+      <option value=".github/instructions" />
+    </instructionFileLocations>
+    <promptFileLocations>
+      <option value=".github/prompts" />
+    </promptFileLocations>
+  </component>
+</project>

libterm-0.0.1/PKG-INFO

@@ -0,0 +1,3 @@
+Metadata-Version: 2.4
+Name: libTerm
+Version: 0.0.1

libterm-0.0.1/README.md

@@ -0,0 +1,186 @@
+# libTerm
+
+A small, cross-platform Python utility library for terminal interaction and control.
+
+libTerm provides a lightweight abstraction over terminal APIs for POSIX and Windows, exposing helpers for:
+
+- querying and tracking terminal size
+- reading and manipulating cursor position
+- discovering terminal color settings
+- entering basic terminal modes (raw/cbreak) on POSIX
+
+The project uses a src-layout and aims to be minimal and easy to extend for CLI tools and terminal UI experiments.
+
+---
+
+## Quick links
+
+- Source: `src/libTerm`
+- POSIX implementation: `src/libTerm/term/posix.py`
+- Windows implementation: `src/libTerm/term/winnt.py`
+- Types & helpers: `src/libTerm/term/types.py`
+- Cursor helpers: `src/libTerm/term/cursor.py`
+- Tests: `tests/`
+- Packaging metadata: `pyproject.toml`
+
+---
+
+## Status
+
+This library is an early-stage utility package (version 0.0.1 in `pyproject.toml`). Some APIs are partial or defensive and a few implementation stubs exist (see `winnt.py` and `cursor.py`). Use in production after reviewing and adding tests for your use case.
+
+---
+
+## Install (development)
+
+From the repository root you can install in editable mode for development:
+
+```bash
+python -m pip install -e .
+```
+
+This will make the `libTerm` package importable from your environment.
+
+---
+
+## Basic usage
+
+The library exposes a `Term` object that delegates to a platform-specific implementation:
+
+```python
+from libTerm import Term
+
+term = Term()
+print("size:", term.size.rc)     # (cols, rows)
+print("width:", term.size.width)
+print("height:", term.size.height)
+
+# Colors and cursor helpers are available under `term.color` and `term.cursor` on supported platforms
+# Example (POSIX):
+print(term.color.fg)  # dataclass with RGB values for foreground (may be None on some terminals)
+
+# Term modes (POSIX):
+term.mode('ctl')   # switch to non-canonical, no-echo mode (POSIX only)
+term.mode('normal')
+```
+
+Note: Windows and POSIX code paths differ. Some methods are stubs on Windows; inspect `src/libTerm/term/winnt.py` before use.
+
+---
+
+## Project layout and "what goes where"
+
+This repository follows a common Python "src" layout. Keep these rules in mind when contributing:
+
+- `src/libTerm/` – the runtime package. All new package modules should live under here.
+  - `src/libTerm/term/` – terminal-related implementation and platform layers. Add new terminal utilities here.
+- `tests/` – unit and integration tests. Add pytest-compatible tests here. Import the package the same way end-users will: `from libTerm import Term`.
+- `doc/` – longer documentation and design notes. Use `doc/dev/` for contributor-facing docs.
+- `build/` – build artifacts (ignored by VCS for contributors). Do not commit build outputs unless intentional.
+- `pyproject.toml` – project metadata and build-system. This project uses setuptools and setuptools-scm.
+
+Files to update when changing public behavior:
+
+- `pyproject.toml` — update the version or rely on tags (setuptools-scm).
+- `PKG-INFO` / packaging metadata — will be generated by packaging tools.
+
+---
+
+## Naming conventions & coding practices
+
+Follow these conventions to keep the codebase consistent and maintainable:
+
+- Project and package name: `libTerm` (package root: `src/libTerm`).
+- Modules should be snake_case (e.g. `cursor.py`, `types.py`, `posix.py`).
+- Classes should use CapWords (PascalCase) and be exported from the package `__init__` only when part of the public API.
+- Prefer small, focused modules. Keep platform-dependent code behind clear boundaries (see `term/__init__.py` which chooses implementation by `os.name`).
+- Use dataclasses for small value types (the codebase already uses `@dataclass`).
+- Avoid reading from stdin/stdout at import time. Prefer lazily reading when a method is called so the package can be imported safely in tests and tooling.
+- Keep side effects (like registering atexit or writing to stdout) in initialization code that is explicit and documented.
+- Add type hints when practical. The codebase mixes dynamic typing and dataclasses; use static typing gradually and keep tests updated.
+
+---
+
+## Tests
+
+There is a minimal `tests/test.py` file. Contributing changes should include tests covering:
+
+- POSIX behavior (can run on CI runners using linux/mac)
+- Windows behavior (when adding or changing `winnt.py`) — use matrix CI with a Windows runner where possible
+
+Run tests locally (recommended to use a virtualenv):
+
+```bash
+python -m pip install -U pytest
+python -m pytest -q
+```
+
+Add tests under `tests/` with clear names and focused assertions. Use small, isolated tests for platform-specific code and avoid relying on interactive stdin in CI.
+
+---
+
+## Development workflow and contributing
+
+Suggested developer workflow:
+
+1. Fork the repository and create a feature branch from `main` (or master if available): `feature/your-short-description`.
+2. Run the existing tests and linting locally.
+3. Implement your change with small commits and add tests that demonstrate the fix/feature.
+4. Update or add documentation in `doc/` if the public API changes.
+5. Open a Pull Request describing the change, tests, and rationale.
+
+Pull request checklist for contributors:
+
+- [ ] Tests added/updated and pass locally
+- [ ] Style checks (PEP8) applied
+- [ ] Documentation updated where public behavior changes
+- [ ] CI (if added) passes for target platforms
+
+---
+
+## Packaging & release
+
+This project uses `setuptools` and `setuptools-scm` for versioning. Typical release steps:
+
+1. Tag a release in git (for setuptools-scm to pick up version):
+
+```bash
+git tag -a vX.Y.Z -m "Release X.Y.Z"
+git push --tags
+```
+
+2. Build a distribution:
+
+```bash
+python -m pip install -U build
+python -m build
+```
+
+3. Upload to PyPI (if intended):
+
+```bash
+python -m pip install -U twine
+python -m twine upload dist/*
+```
+
+Add CI workflows for automated builds and tests on push/PRs.
+
+---
+
+## Known gaps & TODOs
+
+- Some methods are partial or stubbed (for example `vCursor.__update__` in `cursor.py`). Review and implement or document intended behavior before relying on them.
+- Windows implementation (`winnt.py`) contains simplified code paths and stubs — test on real Windows terminals before assuming parity with POSIX.
+- Interactive stdin parsing in `cursor.py` and `types.Colors._ansiparser_` reads from `sys.stdin` synchronously. This is fragile in automated environments and should be replaced with safer, testable parsers.
+- Add a `LICENSE` file to clarify usage and contribution rights.
+
+---
+
+## Getting help
+
+If you need help getting started, open an issue describing the platform and what you tried. Include `python --version` and OS details.
+
+---
+
+Thank you for contributing! Your patches, tests and documentation improvements are welcome.
+

libterm-0.0.1/pyproject.toml

@@ -0,0 +1,8 @@
+#/usr/bin/env python -m setuptools
+[project]
+name = "libTerm"
+version = "0.0.1"
+[build-system]
+requires = ["setuptools", "setuptools-scm"]
+build-backend = "setuptools.build_meta"
+		

libterm-0.0.1/setup.cfg

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

libterm-0.0.1/src/libTerm/__init__.py

@@ -0,0 +1,2 @@
+from libTerm.term import Term
+

libterm-0.0.1/src/libTerm/term/__init__.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python
+import os
+if os.name == 'nt':
+	from libTerm.term.winnt import Term
+else:
+	from libTerm.term.posix import Term

libterm-0.0.1/src/libTerm/term/cursor.py

@@ -0,0 +1,123 @@
+
+from dataclasses import dataclass
+from enum import Enum
+from collections import namedtuple
+import re
+from libTerm.term.types import Coord
+from time import time_ns
+import sys
+@dataclass()
+class ANSI_Cursor(str, Enum):
+	esc = '\x1b'
+	q = '6n'
+	save = 's'
+	load = 'u'
+	show = '?25h'
+	hide = '?25l'
+
+	def __str__(self):
+		return '{ESC}[{CODE}'.format(ESC=self.ESC,CODE=self.value)
+	def __repr__(self):
+		return repr(self.value)
+
+
+class Cursor():
+	def __init__(__s, term):
+		super().__init__()
+		__s.term = term
+		__s.ansi = ANSI_Cursor
+
+		__s.re = re.compile(r"^.?\x1b\[(?P<Y>\d*);(?P<X>\d*)R", re.VERBOSE)
+		__s.position = __s.__update__
+		__s._xy=Coord(0,0)
+		__s.XY=Coord(0,0)
+		__s.history = [*(None,) * 64]
+		__s.init = __s.__update__()
+	@property
+	def xy(__s):
+		__s._xy=__s.__update__()
+		return __s._xy
+
+	def __update__(__s, get='XY'):
+		def Parser():
+			buf = ' '
+			while buf[-1] != "R":
+				buf += sys.stdin.read(1)
+			# reading the actual values, but what if a keystroke appears while reading
+			# from stdin? As dirty work around, getpos() returns if this fails: None
+			try:
+				groups = __s.re.search(buf).groupdict()
+				result = Coord(int(groups['X']), int(groups['Y']))
+			except AttributeError:
+				result = None
+			return result
+
+		result = None
+		timeout = {}
+		timeout['limit'] = 500
+		timeout['start'] = time_ns() // 1e6
+		timeout['running'] = 0
+		while not result:
+			result = __s.term.ansi(''.join([__s.ansi.esc,'[', __s.ansi.q]), Parser)
+		__s.XY =result
+		return result
+
+	def show(__s, state=True):
+		if state:
+			print('\x1b[?25h', end='', flush=True)
+		else:
+			__s.hide()
+
+	def hide(__s, state=True):
+		if state:
+			print('\x1b[?25l', end='', flush=True)
+			atexit.register(__s.show)
+		else:
+			__s.show()
+
+	@property
+	def x(__s):
+		__s.X=__s.__update__('X')
+		return __s.X
+
+	@property
+	def y(__s):
+		__s.Y=__s.__update__('Y')
+		return __s.Y
+
+
+class vCursor(Cursor):
+	def __init__(__s, term,cursor):
+		__s.term = term
+		__s.realcursor=cursor
+		__s.position = Coord(__s.realcursor.x,__s.realcursor.y)
+		__s.history = [*(None,) * 64]
+		__s.controled = False
+		__s.bound = True
+		__s.frozen = False
+		__s.init = __s.__update__()
+
+	def freeze(__s, state=True):
+		if state:
+			__s.frozen = True
+			__s.bind(False)
+			__s.control(False)
+		else:
+			__s.frozen = False
+
+	def __update__(__s, get='XY'):
+		pass
+
+	def show(__s, state=True):
+		if state:
+			print('\x1b[?25h', end='', flush=True)
+		else:
+			__s.hide()
+
+	def hide(__s, state=True):
+		if state:
+			print('\x1b[?25l', end='', flush=True)
+			atexit.register(__s.show)
+		else:
+			__s.show()
+

libterm-0.0.1/src/libTerm/term/posix.py

@@ -0,0 +1,183 @@
+#!/usr/bin/env python
+import os
+import termios
+import tty
+import atexit
+import re
+import sys
+from time import time_ns
+from shutil import get_terminal_size
+from dataclasses import dataclass, field
+from enum import Enum
+from collections import namedtuple
+from libTerm.term.types import Coord,color, Size,Colors
+from libTerm.term.cursor import  Cursor, vCursor
+
+
+
+# Indices for termios list.
+IFLAG = 0
+OFLAG = 1
+CFLAG = 2
+LFLAG = 3
+ISPEED = 4
+OSPEED = 5
+CC = 6
+TCSAFLUSH = termios.TCSAFLUSH
+ECHO = termios.ECHO
+ICANON = termios.ICANON
+
+VMIN = 6
+VTIME = 5
+
+
+class TermAttrs():
+	def __init__(s):
+		s.stack=[]
+		s.init=None
+		s.staged=None
+		s.active=None
+	def stage(s):
+		s.staged=list(s.active)
+	def update(s,new=None):
+		if new is None:
+			new=s.staged
+		s.stack+=[list(s.active)]
+		s.active=new
+		s.staged=None
+	def restore(s):
+		if s.stack:
+			s.staged=s.stack.pop()
+		return s.staged
+
+
+
+class Term():
+	def __init__(s,*a,**k):
+		# super().__init__()
+		s.pid       = os.getpid()
+		s.ppid      = os.getpid()
+		
+		s.fd        = sys.stdin.fileno()
+		s.tty       = os.ttyname(s.fd)
+
+		s.TCSAFLUSH = termios.TCSAFLUSH
+		s.ECHO      = termios.ECHO
+		s.ICANON    = termios.ICANON
+		s.TCSANOW   = termios.TCSANOW
+
+		s.attrs     = TermAttrs()
+
+
+		s.attrs.active =  s.tcgetattr()
+		s.attrs.init   =  list([*s.attrs.active])
+		s.attrs.stack += [list(s.attrs.active)]
+
+		s._mode     = 0
+		s.mode      = s.__mode__
+		atexit.register(s.mode,'normal')
+		s.cursor    = Cursor(s)
+		s.vcursors  = {0:vCursor(s,s.cursor)}
+		s.size      = Size(parent=s)
+		s.color     = Colors(parent=s)
+
+
+	def tcgetattr(s):
+		return termios.tcgetattr(s.fd)
+
+	def tcsetattr(s,attr,when=TCSAFLUSH):
+		termios.tcsetattr(s.fd,when,attr)
+
+	def setraw(s, when=TCSAFLUSH):
+		"""Put terminal into raw mode."""
+		from termios import IGNBRK,BRKINT,IGNPAR,PARMRK,INPCK,ISTRIP,INLCR,IGNCR,ICRNL,IXON,IXANY,IXOFF,OPOST,PARENB,CSIZE,CS8,ECHO,ECHOE,ECHOK,ECHONL,ICANON,IEXTEN,ISIG,NOFLSH,TOSTOP
+		s.attrs.stage()
+		# Clear all POSIX.1-2017 input mode flags.
+		# See chapter 11 "General Terminal Interface"
+		# of POSIX.1-2017 Base Definitions.
+		s.attrs.staged[IFLAG] &= ~( IGNBRK | BRKINT | IGNPAR | PARMRK | INPCK | ISTRIP | INLCR | IGNCR | ICRNL | IXON
+									| IXANY | IXOFF)
+		# Do not post-process output.
+		s.attrs.staged[OFLAG] &= ~OPOST
+		# Disable parity generation and detection; clear character size mask;
+		# let character size be 8 bits.
+		s.attrs.staged[CFLAG] &= ~(PARENB | CSIZE)
+		s.attrs.staged[CFLAG] |= CS8
+		# Clear all POSIX.1-2017 local mode flags.
+		s.attrs.staged[LFLAG] &= ~(ECHO | ECHOE | ECHOK | ECHONL | ICANON | IEXTEN | ISIG | NOFLSH | TOSTOP)
+		# POSIX.1-2017, 11.1.7 Non-Canonical Mode Input Processing,
+		# Case B: MIN>0, TIME=0
+		# A pending read shall block until MIN (here 1) bytes are received,
+		# or a signal is received.
+		s.attrs.staged[CC] = list(s.attr.staged[CC])
+		s.attrs.staged[CC][VMIN] = 1
+		s.attrs.staged[CC][VTIME] = 0
+		s.update(when)
+
+	def setcbreak(s,when=TCSAFLUSH):
+		"""Put terminal into cbreak mode."""
+		# this code was lifted from the tty module and adapted for being a method
+		s.attrs.stage()
+		# Do not echo characters; disable canonical input.
+		s.attrs.staged[LFLAG] &= ~(ECHO | ICANON)
+		# POSIX.1-2017, 11.1.7 Non-Canonical Mode Input Processing,
+		# Case B: MIN>0, TIME=0
+		# A pending read shall block until MIN (here 1) bytes are received,
+		# or a signal is received.
+		s.attrs.staged[CC] = list(s.attrs.staged[CC])
+		s.attrs.staged[CC][VMIN] = 1
+		s.attrs.staged[CC][VTIME] = 0
+		s.update(when)
+
+	def echo(s,enable=False):
+		s.attrs.stage()
+		s.attrs.staged[3] &= ~s.ECHO
+		if enable:
+			s.attrs.staged[3] |= s.ECHO
+		s.update()
+
+	def canonical(s,enable):
+		s.attrs.stage()
+		s.attrs.staged[3] &= ~s.ICANON
+		if enable:
+			s.attrs.staged[3] |= s.ICANON
+		s.update()
+
+	def __mode__(s,mode=None):
+		def Normal():
+			# s.cursor.show(True)
+			s.echo(True)
+			s.canonical(True)
+			s.tcsetattr(s.attrs.init)
+			s._mode = nmodi.get('normal')
+
+		def Ctl():
+			# s.cursor.show(False)
+			s.echo(False)
+			s.canonical(False)
+			s._mode = nmodi.get('ctl')
+
+		nmodi={'normal' : 1,'ctl': 2 }
+		fmodi = {
+			1   :  Normal,
+			2   :  Ctl,
+		}
+		if mode is not None and mode != s._mode:
+			nmode=nmodi.get(mode)
+			fmodi.get(nmode)()
+		return s._mode
+		
+	def update(s,when=TCSAFLUSH):
+		s.tcsetattr( s.attrs.staged,when)
+		s.attrs.update(s.tcgetattr())
+
+	def ansi(s, ansi, parser):
+		s.setcbreak()
+		try:
+			sys.stdout.write(ansi)
+			sys.stdout.flush()
+			result = parser()
+		finally:
+			s.tcsetattr(s.attrs.restore())
+		return result
+#

libterm-0.0.1/src/libTerm/term/types.py

@@ -0,0 +1,193 @@
+from dataclasses import dataclass,field
+from collections import namedtuple
+from os import get_terminal_size
+from  time import sleep, time_ns
+import sys
+
+
+@dataclass()
+class Coord(namedtuple('Coord', ['x', 'y'])):
+	__module__ = None
+	__qualname__='Coord'
+	_x: int = field(default=0)
+	_y: int = field(default=0)
+
+	def __str__(__s):
+		return f'\x1b[{__s.y + 1};{__s.x + 1}H'
+
+	def __repr__(s):
+		return f"{s.__class__.__name__}({s.x}, {s.y})"
+
+	def __len__(self):
+		return 2
+	def __iter__(self):
+		yield self.x
+		yield self.y
+	def __getitem__(s, index):
+		if 0 > index > 2:
+			raise IndexError("numberpair index out of range")
+		return (
+			((index == 0)*s.x)+
+			((index == 1)*s.y))
+	def __add__(s, other):
+		if isinstance(other,Coord2D):
+			x=s.x+other.x
+			y=s.y+other.y
+			return Coord2D(x,y)
+		elif isinstance(other,complex):
+			x=s.x+other.real
+			y=s.y+other.imag
+			return Coord2D(x,y)
+		elif isinstance(other,str):
+			return f'{s.__str__()}{other}'
+		else:
+			raise TypeError(f"cannot add {type(s)} to {type(other)}")
+
+
+
+	@property
+	def xy(s) -> tuple[int, int]:
+		return (s.x, s.y)
+
+	@property
+	def y(s):
+		return s._y
+
+	@property
+	def x(s):
+		return s._x
+
+
+@dataclass(frozen=True)
+class color:
+	R: int = field(default=0, metadata={"range": (0, 65535)})
+	G: int = field(default=0, metadata={"range": (0, 65535)})
+	B: int = field(default=0, metadata={"range": (0, 65535)})
+	BIT: int = field(default=8, metadata={"set": (4, 8, 16, 32)})
+
+	def __post_init__(self):
+		for attr_name in ("R", "G", "B"):
+			value = getattr(self, attr_name)
+			if not isinstance(value, int):
+				raise ValueError(f"{attr_name.upper()} must be an integer between 0 and 65535. Got {value}.")
+		if not isinstance(getattr(self, "BIT"), int):
+			raise ValueError(f"{attr_name.upper()} must be one of 4,8,16,32. Got {value}.")
+
+	@property
+	def RGB(self) -> tuple[int, int, int]:
+		return (self.R, self.G, self.B)
+
+# @dataclass()
+# class TermCo(namedtuple('Co',['x','y'])):
+# 	x:int=field(default=0)
+# 	y:int=field(default=0)
+# class Line(namedtuple('Line',['a','b'])):
+# 	a:Co=field(default_factory=Co)
+# 	b:Co=field(default_factory=Co)
+# 	@classmethod
+# 	def __add__(s, o):
+# 		if isinstance(o,Line):
+# 			if len(s.a)!=0 and len(s.b)!=0:
+# 				lenx=abs(s.b.x-s.a.x)+abs(o.b.x-o.a.x)
+# 				leny=abs(s.b.y-s.a.y)+abs(o.b.y-o.a.y)
+# 				L=Line(s.a,Co(s.a.x+lenx,s.a.y+leny))
+# 			else:
+# 				return 0
+#
+# 	def __len__(s):
+# 		if len(s.a) != 0 and len(s.b) != 0:
+# 			lenx = abs(s.b.x - s.a.x) + abs(o.b.x - o.a.x)
+# 			leny = abs(s.b.y - s.a.y) + abs(o.b.y - o.a.y)
+# 			return ((lenx**2+leny**2)**(1/2))
+
+class Size():
+	def __init__(__s, **k):
+		__s.parent = k.get('parent')
+		__s.getsize = get_terminal_size
+		__s.time = None
+		__s.last = None
+		__s.xy = Coord(1, 1)
+		__s._tmp = Coord(1, 1)
+		__s.rows = 1
+		__s.cols = 1
+
+		__s.history = []
+		__s.changed = False
+		__s.changing = False
+
+		__s.__kwargs__(**k)
+		__s.__update__()
+
+	@property
+	def width(__s):
+		__s.__update__()
+		return __s.cols
+	@property
+	def height(__s):
+		__s.__update__()
+		return __s.rows
+	@property
+	def rc(__s):
+		__s.__update__()
+		return (__s.cols, __s.rows)
+
+	def __kwargs__(__s, **k):
+		__s.term = k.get('parent')
+
+	def __update__(__s):
+		if __s.time is None:
+			__s.last = time_ns()
+		size = Coord(*__s.getsize())
+		if size != __s.xy:
+			if size != __s._tmp:
+				__s.changing = True
+				__s._tmp = size
+				__s._tmptime = time_ns()
+			if size == __s._tmp:
+				if (time_ns() - __s._tmptime) * 1e6 > 500:
+					__s.changing = False
+					__s.changed = True
+					__s.history += [__s.xy]
+					__s.xy = size
+					__s.rows = __s.xy.y
+					__s.cols = __s.xy.x
+				else:
+					__s._tmp = size
+		if size == __s.xy:
+			__s.changed = False
+
+class Colors():
+	def __init__(__s, **k):
+		__s.parent = None
+		__s.specs = {'fg': 10, 'bg': 11}
+		__s._ansi = '\x1b]{spec};?\a'
+		__s.__kwargs__(**k)
+		__s.fg = color(255, 255, 255)
+		__s.bg = color(0, 0, 0)
+		__s.init = __s.__update__()
+
+	def __kwargs__(__s, **k):
+		__s.term = k.get('parent')
+
+	@staticmethod
+	def _ansiparser_():
+		buf = ''
+		try:
+			for i in range(23):
+				buf += sys.stdin.read(1)
+			rgb = buf.split(':')[1].split('/')
+			rgb = [int(i, base=16) for i in rgb]
+			rgb = color(*rgb, 16)
+		except Exception as E:
+			# print(E)
+			rgb = None
+		return rgb
+
+	def __update__(__s):
+		for ground in __s.specs:
+			result = None
+			while not result:
+				result = __s.term.ansi(__s._ansi.format(spec=__s.specs[ground]), __s._ansiparser_)
+			__s.__setattr__(ground, result)
+
+		return {'fg': __s.fg, 'bg': __s.bg}

libterm-0.0.1/src/libTerm/term/winnt.py

@@ -0,0 +1,90 @@
+import shutil
+import ctypes
+import sys
+import msvcrt
+import atexit
+import struct
+from libTerm.term.types import color
+from libTerm.term.types import Size
+
+class Colors:
+	def __init__(s,**k):
+		s.parent = k.get('parent')
+		s.fg = color(255, 255, 255)
+		s.bg = color(0, 0, 0)
+		s.refresh()
+	def refresh(s):
+		# Windows API constants
+		STD_OUTPUT_HANDLE = -11
+		handle = ctypes.windll.kernel32.GetStdHandle(STD_OUTPUT_HANDLE)
+		csbi = ctypes.create_string_buffer(22)
+		res = ctypes.windll.kernel32.GetConsoleScreenBufferInfo(handle, csbi)
+		if res:
+			# Unpack the color attribute as a WORD (2 bytes) at offset 4
+			attr = struct.unpack('<H', csbi.raw[4:6])[0]
+			s.fg = attr & 0x0F
+			s.bg = (attr & 0xF0) >> 4
+			s.foreground = s.fg
+			s.background = s.bg
+		else:
+			s.fg = None
+			s.bg = None
+			s.foreground = None
+			s.background = None
+
+class Term:
+    def __init__(s, *a, **k):
+        s.pid = None  # Not relevant for Windows terminal
+        s.ppid = None
+        s.fd = None
+        s.tty = None
+        s.attrs = None
+        s._mode = 0
+        s.mode = s.__mode__
+        atexit.register(s.mode, 'normal')
+        s.cursor = None
+        s.vcursors = None
+        s.size = Size(parent=s)  # Reflects current terminal size
+        s.color = Colors(parent=s)  # Reflects current terminal colors
+
+
+    def getch(s):
+        """Read a single character from the terminal."""
+        return msvcrt.getch().decode('utf-8', errors='ignore')
+
+    def kbhit(s):
+        """Check if a keypress is available."""
+        return msvcrt.kbhit()
+
+    def __mode__(s, mode=None):
+        nmodi = {'normal': 1, 'ctl': 2}
+        if mode is not None and mode != s._mode:
+            s._mode = nmodi.get(mode)
+        return s._mode
+
+    def ansi(s, ansi, parser):
+        # Parse ANSI color code for foreground (e.g., \x1b[32m)
+        import re
+        match = re.search(r'\x1b\[(3[0-7])m', ansi)
+        if match:
+            s.last_ansi_fg = int(match.group(1)[1:])  # 30-37 -> 0-7
+        sys.stdout.write(ansi)
+        sys.stdout.flush()
+        return parser()
+
+    def refresh(s):
+        """Refresh the size and color settings."""
+        s.size.refresh()
+        s.color.refresh()
+
+    # Stub methods for compatibility
+    def setraw(s, when=None):
+        pass
+    def setcbreak(s, when=None):
+        pass
+    def echo(s, enable=False):
+        pass
+    def canonical(s, enable):
+        pass
+    def update(s, when=None):
+        pass

libterm-0.0.1/src/libTerm.egg-info/PKG-INFO

@@ -0,0 +1,3 @@
+Metadata-Version: 2.4
+Name: libTerm
+Version: 0.0.1

libterm-0.0.1/src/libTerm.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+README.md
+pyproject.toml
+.idea/libTerm.iml
+.idea/modules.xml
+.idea/vcs.xml
+.idea/workspace.xml
+.idea/inspectionProfiles/profiles_settings.xml
+doc/dev/project.md
+src/libTerm/__init__.py
+src/libTerm.egg-info/PKG-INFO
+src/libTerm.egg-info/SOURCES.txt
+src/libTerm.egg-info/dependency_links.txt
+src/libTerm.egg-info/top_level.txt
+src/libTerm/term/__init__.py
+src/libTerm/term/cursor.py
+src/libTerm/term/posix.py
+src/libTerm/term/types.py
+src/libTerm/term/winnt.py
+tests/__init__.py
+tests/test.py

libterm-0.0.1/src/libTerm.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

libterm-0.0.1/src/libTerm.egg-info/top_level.txt

@@ -0,0 +1 @@
+libTerm

libterm-0.0.1/tests/__init__.py

@@ -0,0 +1 @@
+# /usr/bin/env pyhthon

libterm-0.0.1/tests/test.py

@@ -0,0 +1,2 @@
+from libTerm import Term
+