sysic-root 0.1.0__tar.gz

sysic_root-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

sysic_root-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.1
+Name: sysic-root
+Version: 0.1.0
+Summary: sysic_root: Windows system-level toolkit. Admin detection, subprocess wrapper, thread-io helper.
+Author-email: SYSIC <a.0146@icloud.com>
+License: MIT
+Keywords: windows,system,admin,cmd,powershell,subprocess,thread,toolkit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# sysic_root
+
+纯 Python 实现的 Windows 系统级工具库，无第三方依赖。
+
+- 管理员权限检测
+- cmd / PowerShell 命令调用
+- 后台线程文件读取解析
+
+## 安装
+
+```bash
+pip install -e .            # 可编辑模式（开发调试，改源码即时生效）
+# 或打包后安装
+pip install ./dist/sysic_root-0.1.0-py3-none-any.whl
+```
+
+## 快速上手
+
+```python
+import sysic_root as si
+
+si.cmd("echo hello")            # 执行 cmd，返回输出文本
+si.powershell("Get-Process")    # 执行 PowerShell，返回输出文本
+si.admin()                      # 当前是否管理员权限 True/False
+```
+
+命令失败时抛 `RuntimeError`。
+
+## API 一览
+
+| 函数 | 说明 |
+|---|---|
+| `cmd(command)` | 执行 cmd 命令，返回标准输出文本 |
+| `powershell(command)` | 执行 PowerShell 命令，返回标准输出文本 |
+| `admin()` | 当前进程是否为管理员权限 |
+| `is_admin()` | 同 `admin()`，旧版命名 |
+| `run_cmd(cmd, ...)` | 进阶：执行 cmd，返回 `(stdout, stderr, returncode)` |
+| `run_powershell(ps_cmd, ...)` | 进阶：执行 PowerShell，返回三元组 |
+| `ThreadedFileLoader` | 进阶：后台线程读取文件，子类覆写 `parse_chunk` 自定义解析 |
+
+## 测试
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## 构建
+
+```bash
+python -m pip wheel . -w dist --no-deps
+```
+
+## 许可
+
+MIT

sysic_root-0.1.0/README.md

@@ -0,0 +1,55 @@
+# sysic_root
+
+纯 Python 实现的 Windows 系统级工具库，无第三方依赖。
+
+- 管理员权限检测
+- cmd / PowerShell 命令调用
+- 后台线程文件读取解析
+
+## 安装
+
+```bash
+pip install -e .            # 可编辑模式（开发调试，改源码即时生效）
+# 或打包后安装
+pip install ./dist/sysic_root-0.1.0-py3-none-any.whl
+```
+
+## 快速上手
+
+```python
+import sysic_root as si
+
+si.cmd("echo hello")            # 执行 cmd，返回输出文本
+si.powershell("Get-Process")    # 执行 PowerShell，返回输出文本
+si.admin()                      # 当前是否管理员权限 True/False
+```
+
+命令失败时抛 `RuntimeError`。
+
+## API 一览
+
+| 函数 | 说明 |
+|---|---|
+| `cmd(command)` | 执行 cmd 命令，返回标准输出文本 |
+| `powershell(command)` | 执行 PowerShell 命令，返回标准输出文本 |
+| `admin()` | 当前进程是否为管理员权限 |
+| `is_admin()` | 同 `admin()`，旧版命名 |
+| `run_cmd(cmd, ...)` | 进阶：执行 cmd，返回 `(stdout, stderr, returncode)` |
+| `run_powershell(ps_cmd, ...)` | 进阶：执行 PowerShell，返回三元组 |
+| `ThreadedFileLoader` | 进阶：后台线程读取文件，子类覆写 `parse_chunk` 自定义解析 |
+
+## 测试
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## 构建
+
+```bash
+python -m pip wheel . -w dist --no-deps
+```
+
+## 许可
+
+MIT

sysic_root-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sysic-root"
+version = "0.1.0"
+description = "sysic_root: Windows system-level toolkit. Admin detection, subprocess wrapper, thread-io helper."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "SYSIC", email = "a.0146@icloud.com" }
+]
+keywords = ["windows", "system", "admin", "cmd", "powershell", "subprocess", "thread", "toolkit"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: System :: Systems Administration",
+]
+
+[tool.setuptools]
+packages = ["sysic_root"]

sysic_root-0.1.0/setup.cfg

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

sysic_root-0.1.0/sysic_root/__init__.py

@@ -0,0 +1,10 @@
+from .core import (
+    is_admin, run_cmd, run_powershell, ThreadedFileLoader,
+    cmd, powershell, admin,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "cmd", "powershell", "admin",
+    "is_admin", "run_cmd", "run_powershell", "ThreadedFileLoader",
+]

sysic_root-0.1.0/sysic_root/core.py

@@ -0,0 +1,118 @@
+import ctypes
+import sys
+import subprocess
+import threading
+import queue
+
+
+def is_admin() -> bool:
+    """检测当前进程是否拥有管理员权限(仅Windows)"""
+    if sys.platform != "win32":
+        return False
+    try:
+        return bool(ctypes.windll.shell32.IsUserAnAdmin())
+    except Exception:
+        return False
+
+
+def run_cmd(cmd: str, capture_output: bool = True, text: bool = True):
+    """执行cmd.exe命令
+    :param cmd: cmd命令字符串
+    :param capture_output: 是否捕获输出
+    :param text: 返回字符串，否则返回bytes
+    :return: (stdout, stderr, returncode)
+    """
+    proc = subprocess.run(
+        ["cmd.exe", "/c", cmd],
+        capture_output=capture_output,
+        text=text
+    )
+    return proc.stdout, proc.stderr, proc.returncode
+
+
+def cmd(command: str) -> str:
+    """简化版：执行cmd命令，直接返回输出文本。失败抛RuntimeError。"""
+    proc = subprocess.run(
+        ["cmd.exe", "/c", command],
+        capture_output=True, text=True, errors="replace"
+    )
+    if proc.returncode != 0:
+        raise RuntimeError(proc.stderr.strip() or f"命令失败, 退出码 {proc.returncode}")
+    return proc.stdout
+
+
+def powershell(command: str) -> str:
+    """简化版：执行PowerShell命令，直接返回输出文本。失败抛RuntimeError。"""
+    proc = subprocess.run(
+        ["powershell.exe", "-Command", command],
+        capture_output=True, text=True, errors="replace"
+    )
+    if proc.returncode != 0:
+        raise RuntimeError(proc.stderr.strip() or f"命令失败, 退出码 {proc.returncode}")
+    return proc.stdout
+
+
+def admin() -> bool:
+    """简化版：当前进程是否为管理员权限。"""
+    return is_admin()
+
+
+def run_powershell(ps_cmd: str, capture_output: bool = True, text: bool = True):
+    """执行PowerShell命令"""
+    proc = subprocess.run(
+        ["powershell.exe", "-Command", ps_cmd],
+        capture_output=capture_output,
+        text=text
+    )
+    return proc.stdout, proc.stderr, proc.returncode
+
+
+class ThreadedFileLoader:
+    """后台线程读取文件，解析结果放入线程安全队列"""
+
+    def __init__(self):
+        self._q = queue.Queue()
+        self._thread = None
+        self._running = False
+        self._error = None
+
+    def _worker(self, filepath: str, chunk_size: int):
+        try:
+            with open(filepath, "rb") as f:
+                while self._running:
+                    chunk = f.read(chunk_size)
+                    if not chunk:
+                        break
+                    parsed = self.parse_chunk(chunk)
+                    self._q.put(parsed)
+        except Exception as e:
+            self._error = e
+
+    def start_load(self, filepath: str, chunk_size: int = 1024):
+        """启动后台读取线程(daemon)"""
+        if self._thread and self._thread.is_alive():
+            return
+        self._running = True
+        self._thread = threading.Thread(
+            target=self._worker, args=(filepath, chunk_size), daemon=True
+        )
+        self._thread.start()
+
+    def get_available(self) -> list:
+        """取出所有已解析数据(非阻塞)。若读取线程出错，抛出错异常"""
+        if self._error is not None:
+            raise self._error
+        out = []
+        while not self._q.empty():
+            out.append(self._q.get_nowait())
+        return out
+
+    def stop(self):
+        """停止读取线程并等待其退出"""
+        self._running = False
+        if self._thread:
+            self._thread.join(timeout=5)
+
+    def parse_chunk(self, chunk: bytes):
+        """子类可覆写：自定义二进制/文本解析逻辑"""
+        return chunk

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

@@ -0,0 +1,78 @@
+Metadata-Version: 2.1
+Name: sysic-root
+Version: 0.1.0
+Summary: sysic_root: Windows system-level toolkit. Admin detection, subprocess wrapper, thread-io helper.
+Author-email: SYSIC <a.0146@icloud.com>
+License: MIT
+Keywords: windows,system,admin,cmd,powershell,subprocess,thread,toolkit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# sysic_root
+
+纯 Python 实现的 Windows 系统级工具库，无第三方依赖。
+
+- 管理员权限检测
+- cmd / PowerShell 命令调用
+- 后台线程文件读取解析
+
+## 安装
+
+```bash
+pip install -e .            # 可编辑模式（开发调试，改源码即时生效）
+# 或打包后安装
+pip install ./dist/sysic_root-0.1.0-py3-none-any.whl
+```
+
+## 快速上手
+
+```python
+import sysic_root as si
+
+si.cmd("echo hello")            # 执行 cmd，返回输出文本
+si.powershell("Get-Process")    # 执行 PowerShell，返回输出文本
+si.admin()                      # 当前是否管理员权限 True/False
+```
+
+命令失败时抛 `RuntimeError`。
+
+## API 一览
+
+| 函数 | 说明 |
+|---|---|
+| `cmd(command)` | 执行 cmd 命令，返回标准输出文本 |
+| `powershell(command)` | 执行 PowerShell 命令，返回标准输出文本 |
+| `admin()` | 当前进程是否为管理员权限 |
+| `is_admin()` | 同 `admin()`，旧版命名 |
+| `run_cmd(cmd, ...)` | 进阶：执行 cmd，返回 `(stdout, stderr, returncode)` |
+| `run_powershell(ps_cmd, ...)` | 进阶：执行 PowerShell，返回三元组 |
+| `ThreadedFileLoader` | 进阶：后台线程读取文件，子类覆写 `parse_chunk` 自定义解析 |
+
+## 测试
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+## 构建
+
+```bash
+python -m pip wheel . -w dist --no-deps
+```
+
+## 许可
+
+MIT

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

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+sysic_root/__init__.py
+sysic_root/core.py
+sysic_root.egg-info/PKG-INFO
+sysic_root.egg-info/SOURCES.txt
+sysic_root.egg-info/dependency_links.txt
+sysic_root.egg-info/top_level.txt
+tests/test_sysic.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+sysic_root

sysic_root-0.1.0/tests/test_sysic.py

@@ -0,0 +1,99 @@
+import os
+import sys
+import tempfile
+import time
+import unittest
+
+import sysic_root
+
+
+class TestAdmin(unittest.TestCase):
+    def test_admin_returns_bool(self):
+        self.assertIsInstance(sysic_root.admin(), bool)
+
+    def test_is_admin_alias(self):
+        self.assertEqual(sysic_root.is_admin(), sysic_root.admin())
+
+
+class TestCmd(unittest.TestCase):
+    def test_cmd_output(self):
+        out = sysic_root.cmd("echo hello")
+        self.assertEqual(out.strip(), "hello")
+
+    def test_cmd_failure_raises(self):
+        with self.assertRaises(RuntimeError):
+            sysic_root.cmd("this_command_does_not_exist_xyz")
+
+    def test_run_cmd_returns_tuple(self):
+        out, err, code = sysic_root.run_cmd("echo ok")
+        self.assertEqual(out.strip(), "ok")
+        self.assertEqual(code, 0)
+
+
+class TestPowershell(unittest.TestCase):
+    def test_powershell_output(self):
+        out = sysic_root.powershell("Write-Output hi")
+        self.assertEqual(out.strip(), "hi")
+
+    def test_powershell_failure_raises(self):
+        with self.assertRaises(RuntimeError):
+            sysic_root.powershell("this-command-does-not-exist-xyz")
+
+    def test_run_powershell_returns_tuple(self):
+        out, err, code = sysic_root.run_powershell("Write-Output ok")
+        self.assertEqual(out.strip(), "ok")
+        self.assertEqual(code, 0)
+
+
+class TestThreadedFileLoader(unittest.TestCase):
+    def _make_file(self, data: bytes):
+        fd, path = tempfile.mkstemp(suffix=".bin")
+        with os.fdopen(fd, "wb") as f:
+            f.write(data)
+        self.addCleanup(os.remove, path)
+        return path
+
+    def test_full_read_integrity(self):
+        data = b"HELLO" * 20
+        path = self._make_file(data)
+        loader = sysic_root.ThreadedFileLoader()
+        loader.start_load(path, chunk_size=6)
+        time.sleep(0.3)
+        loader.stop()
+        chunks = loader.get_available()
+        self.assertEqual(b"".join(chunks), data)
+
+    def test_missing_file_raises(self):
+        loader = sysic_root.ThreadedFileLoader()
+        loader.start_load(os.path.join(tempfile.gettempdir(), "no_such_file_xyz.bin"))
+        time.sleep(0.3)
+        loader.stop()
+        with self.assertRaises(FileNotFoundError):
+            loader.get_available()
+
+    def test_error_like_tuple_not_misjudged(self):
+        class TupleLoader(sysic_root.ThreadedFileLoader):
+            def parse_chunk(self, chunk):
+                return ("__error__", chunk) if len(chunk) > 3 else chunk
+
+        path = self._make_file(b"12345678")
+        loader = TupleLoader()
+        loader.start_load(path, chunk_size=4)
+        time.sleep(0.3)
+        loader.stop()
+        got = loader.get_available()
+        self.assertEqual(got[0], ("__error__", b"1234"))
+
+
+class TestModule(unittest.TestCase):
+    def test_version(self):
+        self.assertTrue(sysic_root.__version__)
+
+    def test_public_names(self):
+        for name in ("cmd", "powershell", "admin", "is_admin",
+                     "run_cmd", "run_powershell", "ThreadedFileLoader"):
+            self.assertTrue(hasattr(sysic_root, name), name)
+
+
+if __name__ == "__main__":
+    unittest.main()