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
