pyOS-kernel 0.1.0__tar.gz → 0.2.0__tar.gz

pyos_kernel-0.2.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pyOS-kernel
+Version: 0.2.0
+Summary: Build operating systems in Python — freestanding C runtime + ASM bootloader
+Author-email: i87kxxzz <redtgx32@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/i87kxxz/pyOS
+Project-URL: Documentation, https://github.com/i87kxxz/pyOS#readme
+Project-URL: Repository, https://github.com/i87kxxz/pyOS
+Project-URL: Issues, https://github.com/i87kxxz/pyOS/issues
+Keywords: operating-system,os,kernel,x86,bootloader,qemu,nasm,systems-programming,cybersecurity
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: System :: Operating System Kernels
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+
+# pyOS
+
+**Build operating systems in Python.** You write a simple Python API; pyOS builds a real freestanding **C kernel** and an **ASM bootloader**, then runs it in QEMU.
+
+```text
+Your Python  →  C glue + C runtime  →  GCC -m32  ┐
+                                                 ├→ os.bin → QEMU
+ASM bootloader → NASM                            ┘
+```
+
+## Requirements (Windows)
+
+| Tool | Role | Install |
+|------|------|---------|
+| **MinGW-w64 (GCC)** | Compile C runtime (`-m32`) | `winget install -e --id BrechtSanders.WinLibs.POSIX.UCRT` |
+| **NASM** | Assemble bootloader | `winget install -e --id NASM.NASM` |
+| **QEMU** | Run the OS | `winget install -e --id SoftwareFreedomConservancy.QEMU` |
+
+Then verify:
+
+```bash
+pyos check
+```
+
+## Install pyOS
+
+```bash
+pip install pyOS-kernel
+# or from source:
+pip install -e .
+```
+
+## Hello World
+
+```python
+from pyos import Kernel, Screen
+
+kernel = Kernel(arch="x86")
+
+@kernel.on_boot
+def main():
+    Screen.clear()
+    Screen.set_color("green", "black")
+    Screen.print("Hello World!")
+
+kernel.build("myos.bin")
+```
+
+```bash
+pyos run myos.bin
+pyos debug myos.bin   # human-readable serial log / panics
+```
+
+## Keyboard (runtime)
+
+```python
+@kernel.on_keypress
+def on_key(key=None):
+    pass  # enables IRQ1 echo in the C runtime
+```
+
+## Architecture
+
+| Layer | What it does |
+|-------|----------------|
+| **Python API** | `Kernel`, `Screen`, decorators — records intent at build time |
+| **C runtime** | VGA, keyboard, IDT/PIC, heap, syscalls, panic/serial |
+| **ASM** | 16→32-bit bootloader only (`pyos/boot/bootloader.asm`) |
+
+pyOS is **not** a full Python-to-machine-code compiler. Boot functions run once at build time; their `Screen.*` operations become C calls into the runtime.
+
+## Human debug
+
+Panics print clear messages on the serial port (and VGA):
+
+```text
+========== pyOS PANIC ==========
+Where : @kernel Screen.print
+Why   : Print position is outside the VGA text screen (0..24 rows, 0..79 cols)
+Hint  : Pass a valid row/col, or omit them to use the cursor
+Detail: EIP=0x....   (secondary technical detail)
+================================
+```
+
+```bash
+pyos debug myos.bin
+```
+
+## CLI
+
+```bash
+pyos check
+pyos new myos
+pyos build main.py -o myos.bin
+pyos run myos.bin
+pyos debug myos.bin
+pyos c main.py -o glue.c    # inspect generated C glue
+```
+
+## Examples
+
+```bash
+python examples/hello_world.py
+python examples/keyboard_input.py
+python examples/advanced_os.py
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -q
+```
+
+## License
+
+MIT

pyos_kernel-0.2.0/README.md

@@ -0,0 +1,116 @@
+# pyOS
+
+**Build operating systems in Python.** You write a simple Python API; pyOS builds a real freestanding **C kernel** and an **ASM bootloader**, then runs it in QEMU.
+
+```text
+Your Python  →  C glue + C runtime  →  GCC -m32  ┐
+                                                 ├→ os.bin → QEMU
+ASM bootloader → NASM                            ┘
+```
+
+## Requirements (Windows)
+
+| Tool | Role | Install |
+|------|------|---------|
+| **MinGW-w64 (GCC)** | Compile C runtime (`-m32`) | `winget install -e --id BrechtSanders.WinLibs.POSIX.UCRT` |
+| **NASM** | Assemble bootloader | `winget install -e --id NASM.NASM` |
+| **QEMU** | Run the OS | `winget install -e --id SoftwareFreedomConservancy.QEMU` |
+
+Then verify:
+
+```bash
+pyos check
+```
+
+## Install pyOS
+
+```bash
+pip install pyOS-kernel
+# or from source:
+pip install -e .
+```
+
+## Hello World
+
+```python
+from pyos import Kernel, Screen
+
+kernel = Kernel(arch="x86")
+
+@kernel.on_boot
+def main():
+    Screen.clear()
+    Screen.set_color("green", "black")
+    Screen.print("Hello World!")
+
+kernel.build("myos.bin")
+```
+
+```bash
+pyos run myos.bin
+pyos debug myos.bin   # human-readable serial log / panics
+```
+
+## Keyboard (runtime)
+
+```python
+@kernel.on_keypress
+def on_key(key=None):
+    pass  # enables IRQ1 echo in the C runtime
+```
+
+## Architecture
+
+| Layer | What it does |
+|-------|----------------|
+| **Python API** | `Kernel`, `Screen`, decorators — records intent at build time |
+| **C runtime** | VGA, keyboard, IDT/PIC, heap, syscalls, panic/serial |
+| **ASM** | 16→32-bit bootloader only (`pyos/boot/bootloader.asm`) |
+
+pyOS is **not** a full Python-to-machine-code compiler. Boot functions run once at build time; their `Screen.*` operations become C calls into the runtime.
+
+## Human debug
+
+Panics print clear messages on the serial port (and VGA):
+
+```text
+========== pyOS PANIC ==========
+Where : @kernel Screen.print
+Why   : Print position is outside the VGA text screen (0..24 rows, 0..79 cols)
+Hint  : Pass a valid row/col, or omit them to use the cursor
+Detail: EIP=0x....   (secondary technical detail)
+================================
+```
+
+```bash
+pyos debug myos.bin
+```
+
+## CLI
+
+```bash
+pyos check
+pyos new myos
+pyos build main.py -o myos.bin
+pyos run myos.bin
+pyos debug myos.bin
+pyos c main.py -o glue.c    # inspect generated C glue
+```
+
+## Examples
+
+```bash
+python examples/hello_world.py
+python examples/keyboard_input.py
+python examples/advanced_os.py
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -q
+```
+
+## License
+
+MIT

pyos_kernel-0.2.0/pyOS_kernel.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pyOS-kernel
+Version: 0.2.0
+Summary: Build operating systems in Python — freestanding C runtime + ASM bootloader
+Author-email: i87kxxzz <redtgx32@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/i87kxxz/pyOS
+Project-URL: Documentation, https://github.com/i87kxxz/pyOS#readme
+Project-URL: Repository, https://github.com/i87kxxz/pyOS
+Project-URL: Issues, https://github.com/i87kxxz/pyOS/issues
+Keywords: operating-system,os,kernel,x86,bootloader,qemu,nasm,systems-programming,cybersecurity
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: System :: Operating System Kernels
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+
+# pyOS
+
+**Build operating systems in Python.** You write a simple Python API; pyOS builds a real freestanding **C kernel** and an **ASM bootloader**, then runs it in QEMU.
+
+```text
+Your Python  →  C glue + C runtime  →  GCC -m32  ┐
+                                                 ├→ os.bin → QEMU
+ASM bootloader → NASM                            ┘
+```
+
+## Requirements (Windows)
+
+| Tool | Role | Install |
+|------|------|---------|
+| **MinGW-w64 (GCC)** | Compile C runtime (`-m32`) | `winget install -e --id BrechtSanders.WinLibs.POSIX.UCRT` |
+| **NASM** | Assemble bootloader | `winget install -e --id NASM.NASM` |
+| **QEMU** | Run the OS | `winget install -e --id SoftwareFreedomConservancy.QEMU` |
+
+Then verify:
+
+```bash
+pyos check
+```
+
+## Install pyOS
+
+```bash
+pip install pyOS-kernel
+# or from source:
+pip install -e .
+```
+
+## Hello World
+
+```python
+from pyos import Kernel, Screen
+
+kernel = Kernel(arch="x86")
+
+@kernel.on_boot
+def main():
+    Screen.clear()
+    Screen.set_color("green", "black")
+    Screen.print("Hello World!")
+
+kernel.build("myos.bin")
+```
+
+```bash
+pyos run myos.bin
+pyos debug myos.bin   # human-readable serial log / panics
+```
+
+## Keyboard (runtime)
+
+```python
+@kernel.on_keypress
+def on_key(key=None):
+    pass  # enables IRQ1 echo in the C runtime
+```
+
+## Architecture
+
+| Layer | What it does |
+|-------|----------------|
+| **Python API** | `Kernel`, `Screen`, decorators — records intent at build time |
+| **C runtime** | VGA, keyboard, IDT/PIC, heap, syscalls, panic/serial |
+| **ASM** | 16→32-bit bootloader only (`pyos/boot/bootloader.asm`) |
+
+pyOS is **not** a full Python-to-machine-code compiler. Boot functions run once at build time; their `Screen.*` operations become C calls into the runtime.
+
+## Human debug
+
+Panics print clear messages on the serial port (and VGA):
+
+```text
+========== pyOS PANIC ==========
+Where : @kernel Screen.print
+Why   : Print position is outside the VGA text screen (0..24 rows, 0..79 cols)
+Hint  : Pass a valid row/col, or omit them to use the cursor
+Detail: EIP=0x....   (secondary technical detail)
+================================
+```
+
+```bash
+pyos debug myos.bin
+```
+
+## CLI
+
+```bash
+pyos check
+pyos new myos
+pyos build main.py -o myos.bin
+pyos run myos.bin
+pyos debug myos.bin
+pyos c main.py -o glue.c    # inspect generated C glue
+```
+
+## Examples
+
+```bash
+python examples/hello_world.py
+python examples/keyboard_input.py
+python examples/advanced_os.py
+```
+
+## Tests
+
+```bash
+python -m pytest tests/ -q
+```
+
+## License
+
+MIT

{pyos_kernel-0.1.0 → pyos_kernel-0.2.0}/pyOS_kernel.egg-info/SOURCES.txt

@@ -1,12 +1,6 @@
-LICENSE
-MANIFEST.in
 README.md
 pyproject.toml
-requirements.txt
 setup.py
-examples/advanced_os.py
-examples/hello_world.py
-examples/keyboard_input.py
 pyOS_kernel.egg-info/PKG-INFO
 pyOS_kernel.egg-info/SOURCES.txt
 pyOS_kernel.egg-info/dependency_links.txt
@@ -16,8 +10,10 @@ pyOS_kernel.egg-info/top_level.txt
 pyos/__init__.py
 pyos/builder.py
 pyos/cli.py
+pyos/debug.py
 pyos/emulator.py
 pyos/kernel.py
+pyos/toolchain.py
 pyos/boot/__init__.py
 pyos/boot/bootloader.asm
 pyos/compiler/__init__.py
@@ -32,5 +28,29 @@ pyos/interrupts/idt.py
 pyos/memory/__init__.py
 pyos/memory/gdt.py
 pyos/memory/manager.py
+pyos/runtime/linker.ld
+pyos/runtime/include/debug.h
+pyos/runtime/include/heap.h
+pyos/runtime/include/idt.h
+pyos/runtime/include/io.h
+pyos/runtime/include/kernel.h
+pyos/runtime/include/keyboard.h
+pyos/runtime/include/pic.h
+pyos/runtime/include/screen.h
+pyos/runtime/include/syscall.h
+pyos/runtime/include/types.h
+pyos/runtime/src/debug.c
+pyos/runtime/src/heap.c
+pyos/runtime/src/idt.c
+pyos/runtime/src/isr.S
+pyos/runtime/src/isr.asm
+pyos/runtime/src/keyboard.c
+pyos/runtime/src/kmain.c
+pyos/runtime/src/pic.c
+pyos/runtime/src/screen.c
+pyos/runtime/src/start.S
+pyos/runtime/src/start.asm
+pyos/runtime/src/syscall.c
 pyos/syscalls/__init__.py
-pyos/syscalls/handler.py
+pyos/syscalls/handler.py
+tests/test_build.py

{pyos_kernel-0.1.0 → pyos_kernel-0.2.0}/pyOS_kernel.egg-info/requires.txt

@@ -2,5 +2,3 @@ click>=8.0.0
 
 [dev]
 pytest>=7.0.0
-black>=23.0.0
-flake8>=6.0.0

{pyos_kernel-0.1.0 → pyos_kernel-0.2.0}/pyos/__init__.py

@@ -10,7 +10,7 @@ from .memory.gdt import GDT
 from .interrupts.handler import Interrupts
 from .syscalls.handler import SysCall
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = [
     "Kernel",
     "Screen", 

pyos_kernel-0.2.0/pyos/boot/bootloader.asm

@@ -0,0 +1,126 @@
+; pyOS Bootloader — LBA (int 13h AH=42h), QEMU-friendly
+[BITS 16]
+[ORG 0x7C00]
+
+KERNEL_OFFSET equ 0x1000
+KERNEL_SEGS   equ 0x0000
+KERNEL_SECTORS equ 64
+
+start:
+    cli
+    xor ax, ax
+    mov ds, ax
+    mov es, ax
+    mov ss, ax
+    mov sp, 0x7C00
+    sti
+
+    mov [boot_drive], dl
+
+    mov al, 'B'
+    out 0xE9, al
+
+    ; Check extensions
+    mov ah, 0x41
+    mov bx, 0x55AA
+    mov dl, [boot_drive]
+    int 0x13
+    jc .no_lba
+    cmp bx, 0xAA55
+    jne .no_lba
+
+    mov al, 'X'
+    out 0xE9, al
+
+    ; LBA read: DAP
+    mov si, dap
+    mov ah, 0x42
+    mov dl, [boot_drive]
+    int 0x13
+    jc .error
+
+    mov al, 'L'
+    out 0xE9, al
+    jmp .pm
+
+.no_lba:
+    ; Fallback CHS: one track from sector 2 (17 sectors)
+    mov al, 'C'
+    out 0xE9, al
+    mov ax, KERNEL_SEGS
+    mov es, ax
+    mov bx, KERNEL_OFFSET
+    mov ah, 0x02
+    mov al, 17
+    mov ch, 0
+    mov cl, 2
+    mov dh, 0
+    mov dl, [boot_drive]
+    int 0x13
+    jc .error
+    mov al, 'L'
+    out 0xE9, al
+
+.pm:
+    cli
+    in al, 0x92
+    or al, 2
+    out 0x92, al
+    lgdt [gdt_desc]
+    mov eax, cr0
+    or eax, 1
+    mov cr0, eax
+    jmp 0x08:pm_start
+
+.error:
+    mov al, 'E'
+    out 0xE9, al
+    jmp $
+
+; Disk Address Packet
+align 4
+dap:
+    db 16
+    db 0
+    dw KERNEL_SECTORS
+    dw KERNEL_OFFSET
+    dw KERNEL_SEGS
+    dq 1                 ; LBA 1 (sector after MBR)
+
+gdt_start:
+    dq 0
+gdt_code:
+    dw 0xFFFF, 0x0000
+    db 0x00, 10011010b, 11001111b, 0x00
+gdt_data:
+    dw 0xFFFF, 0x0000
+    db 0x00, 10010010b, 11001111b, 0x00
+gdt_end:
+gdt_desc:
+    dw gdt_end - gdt_start - 1
+    dd gdt_start
+
+[BITS 32]
+pm_start:
+    mov ax, 0x10
+    mov ds, ax
+    mov es, ax
+    mov fs, ax
+    mov gs, ax
+    mov ss, ax
+    mov esp, 0x90000
+    mov al, 'K'
+    out 0xE9, al
+    call KERNEL_OFFSET
+    mov al, 'H'
+    out 0xE9, al
+    cli
+.halt:
+    hlt
+    jmp .halt
+
+[BITS 16]
+boot_drive: db 0
+
+times 510 - ($ - $$) db 0
+dw 0xAA55