Skip to content

ZeroIntensity/pointers.py

master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

pointers.py

Tests

Bringing the hell of pointers to Python

Why would you ever need this

Example

from pointers import to_ptr, Pointer, decay

a: str = '123'
b: str = 'abc'

@decay
def move(ptr_a: Pointer[str], ptr_b: Pointer[str]):
    ptr_a <<= ptr_b

move(a, b)
print(a, b) # abc abc

Example with bindings

from pointers import fopen, fprintf, fclose

file = fopen("/dev/null", "w")
fprintf(file, "hello world")
fclose(file)

Example with custom bindings

from pointers import binds, Struct
import ctypes

dll = ctypes.CDLL("libc.so.6")

class DivStruct(Struct):
    quot: int
    rem: int

class div_t(ctypes.Structure):
    _fields_ = [
        ("quot", ctypes.c_int),
        ("rem", ctypes.c_int),
    ]

dll.div.restype = div_t

@binds(dll.div, struct=DivStruct)
def div(numer: int, denom: int) -> DivStruct:
    ...

print((div(10, 10).quot))

Example with malloc

from pointers import malloc, free

memory = malloc(52)
memory <<= "abc"
print(*memory) # abc
free(memory)
print(*memory) # FreedMemoryError

Why does this exist?

The main purpose of pointers.py is to simply break the rules of Python, but has some other use cases:

  • Can help C/C++ developers get adjusted to Python
  • Provides a nice learning environment for programmers learning how pointers work
  • Makes it very easy to manipulate memory in Python
  • Why not?

Installation

Linux/macOS

python3 -m pip install -U pointers.py

Windows

py -3 -m pip install -U pointers.py

Running Documentation

$ git clone https://github.com/ZeroIntensity/pointers.py && cd pointers.py
$ pip install -U mkdocs
$ mkdocs serve

About

Bringing the hell of pointers to Python.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published