Bringing the hell of pointers to Python.
Project description
pointers.py
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pointers.py-1.3.2.tar.gz
(16.4 kB
view hashes)
Built Distribution
Close
Hashes for pointers.py-1.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bc752656a360e575ceb0798ab70f2b5e6d25ffb9004a432660d70929ab267230 |
|
MD5 | 8582deb0d933b5ecc4bdc36f7e4bea2b |
|
BLAKE2b-256 | e75a5ab007b80d9e27b1ce8c7619db6709e206be24e64aefc05594db08b3314c |