Clarify compilation target in package documentation

Updated documentation to clarify that the compilation targets LLVM IR instead of eBPF bytecode directly.

.gitignore

@@ -7,3 +7,4 @@ __pycache__/
 *.ll
 *.o
 .ipynb_checkpoints/
+vmlinux.py

pythonbpf/__init__.py

@@ -2,7 +2,7 @@
 PythonBPF - A Python frontend for eBPF programs.
 
 This package provides decorators and compilation tools to write BPF programs
-in Python syntax and compile them to eBPF bytecode that can run in the kernel.
+in Python syntax and compile them to LLVM IR that can be compiled to eBPF bytecode.
 """
 
 from .decorators import bpf, map, section, bpfglobal, struct

pythonbpf/debuginfo/dtypes.py

@@ -5,6 +5,7 @@ import llvmlite.ir as ir
 
 class DwarfBehaviorEnum:
     """DWARF module flag behavior constants for LLVM."""
+
     ERROR_IF_MISMATCH = ir.Constant(ir.IntType(32), 1)
     WARNING_IF_MISMATCH = ir.Constant(ir.IntType(32), 2)
     OVERRIDE_USE_LARGEST = ir.Constant(ir.IntType(32), 7)

pythonbpf/decorators.py

@@ -40,6 +40,7 @@ def section(name: str):
     Returns:
         A decorator function that marks the function with the section name
     """
+
     def wrapper(fn):
         """Decorator that sets the section name on the function."""
         fn._section = name

pythonbpf/functions/functions_pass.py

@@ -33,6 +33,7 @@ class LocalSymbol:
         ir_type: LLVM IR type of the variable
         metadata: Optional metadata (e.g., struct type name)
     """
+
     var: ir.AllocaInstr
     ir_type: ir.Type
     metadata: Any = None

pythonbpf/helper/bpf_helper_handler.py

@@ -25,6 +25,7 @@ logger: Logger = logging.getLogger(__name__)
 
 class BPFHelperID(Enum):
     """Enumeration of BPF helper function IDs."""
+
     BPF_MAP_LOOKUP_ELEM = 1
     BPF_MAP_UPDATE_ELEM = 2
     BPF_MAP_DELETE_ELEM = 3

pythonbpf/maps/maps.py

@@ -6,6 +6,7 @@ These are used for type checking and map definition; the actual BPF maps
 are generated as LLVM IR during compilation.
 """
 
+
 # This file provides type  and function hints only and does not actually give any functionality.
 class HashMap:
     """

pythonbpf/maps/maps_pass.py

@@ -44,6 +44,7 @@ def is_map(func_node):
 
 class BPFMapType(Enum):
     """Enumeration of BPF map types."""
+
     UNSPEC = 0
     HASH = 1
     ARRAY = 2

tests/passing_tests/ringbuf.py

@@ -33,3 +33,5 @@ compile_to_ir("ringbuf.py", "ringbuf.ll")
 compile()
 b = BPF()
 b.load_and_attach()
+while True:
+    print("running")