some patches

Author: ZeroIntensity

docs/getting_started.md

@@ -24,3 +24,16 @@ $ pip install .
 ```
 
 **Python 3.6+ is required**
+
+Now, to ensure everything is working properly we can run this simple program:
+
+```py
+from pointers import to_ptr
+
+ptr = to_ptr("hello world")
+print(*ptr)
+```
+
+Running this should print `hello world` into the console.
+
+Congratulations, you have written a program with the worst library every created!

docs/index.md

@@ -41,7 +41,8 @@ fclose(file)
 -   Reworked documentation
 -   Several bug fixes
 -   Optimized internal API
--   Better type safety
+-   Better and fixed type safety
+-   New memory safety features
 
 ### Features
 

docs/pointers.md

@@ -0,0 +1 @@
+# Using Pointers

src/pointers/__init__.py

@@ -1,3 +1,7 @@
+from .base_pointers import (
+    BaseAllocatedPointer, BaseCPointer, BaseObjectPointer, BasePointer,
+    BasicPointer, Dereferencable, IterDereferencable, Sized, Typed
+)
 from .bindings import *
 from .c_pointer import (
     StructPointer, TypedCPointer, VoidPointer, array, cast, to_c_ptr,

src/pointers/_cstd.py

@@ -144,44 +144,44 @@ class lconv(ctypes.Structure):
 dll.calloc.argtypes = (ctypes.c_size_t, ctypes.c_size_t)
 dll.calloc.restype = ctypes.c_void_p
 # int isalnum(int c)
-dll.isalnum.argtypes = (ctypes.c_int,)
+dll.isalnum.argtypes = (ctypes.c_char,)
 dll.isalnum.restype = ctypes.c_int
 # int isalpha(int c)
-dll.isalpha.argtypes = (ctypes.c_int,)
+dll.isalpha.argtypes = (ctypes.c_char,)
 dll.isalpha.restype = ctypes.c_int
 # int iscntrl(int c)
-dll.iscntrl.argtypes = (ctypes.c_int,)
+dll.iscntrl.argtypes = (ctypes.c_char,)
 dll.iscntrl.restype = ctypes.c_int
 # int isdigit(int c)
-dll.isdigit.argtypes = (ctypes.c_int,)
+dll.isdigit.argtypes = (ctypes.c_char,)
 dll.isdigit.restype = ctypes.c_int
 # int isgraph(int c)
-dll.isgraph.argtypes = (ctypes.c_int,)
+dll.isgraph.argtypes = (ctypes.c_char,)
 dll.isgraph.restype = ctypes.c_int
 # int islower(int c)
-dll.islower.argtypes = (ctypes.c_int,)
+dll.islower.argtypes = (ctypes.c_char,)
 dll.islower.restype = ctypes.c_int
 # int isprint(int c)
-dll.isprint.argtypes = (ctypes.c_int,)
+dll.isprint.argtypes = (ctypes.c_char,)
 dll.isprint.restype = ctypes.c_int
 # int ispunct(int c)
-dll.ispunct.argtypes = (ctypes.c_int,)
+dll.ispunct.argtypes = (ctypes.c_char,)
 dll.ispunct.restype = ctypes.c_int
 # int isspace(int c)
-dll.isspace.argtypes = (ctypes.c_int,)
+dll.isspace.argtypes = (ctypes.c_char,)
 dll.isspace.restype = ctypes.c_int
 # int isupper(int c)
-dll.isupper.argtypes = (ctypes.c_int,)
+dll.isupper.argtypes = (ctypes.c_char,)
 dll.isupper.restype = ctypes.c_int
 # int isxdigit(int c)
-dll.isxdigit.argtypes = (ctypes.c_int,)
+dll.isxdigit.argtypes = (ctypes.c_char,)
 dll.isxdigit.restype = ctypes.c_int
 # int tolower(int c)
-dll.tolower.argtypes = (ctypes.c_int,)
-dll.tolower.restype = ctypes.c_int
+dll.tolower.argtypes = (ctypes.c_char,)
+dll.tolower.restype = ctypes.c_char
 # int toupper(int c)
-dll.toupper.argtypes = (ctypes.c_int,)
-dll.toupper.restype = ctypes.c_int
+dll.toupper.argtypes = (ctypes.c_char,)
+dll.toupper.restype = ctypes.c_char
 # char* setlocale(int category, const char* locale)
 dll.setlocale.argtypes = (ctypes.c_int, ctypes.c_char_p)
 dll.setlocale.restype = ctypes.c_char_p

src/pointers/_pointer.py renamed to src/pointers/base_pointers.py

@@ -173,7 +173,7 @@ def _make_stream_and_ptr(
         self,
         size: int,
         address: int,
-    ) -> Tuple[ctypes.pointer, bytes]:
+    ) -> Tuple[ctypes._PointerLike, bytes]:
         ...
 
 
@@ -279,7 +279,7 @@ def _make_stream_and_ptr(
         self,
         size: int,
         address: int,
-    ) -> Tuple[ctypes.pointer, bytes]:
+    ) -> Tuple[ctypes._PointerLike, bytes]:
         bytes_a = (ctypes.c_ubyte * size).from_address(address)
         return self.make_ct_pointer(), bytes(bytes_a)
 
@@ -394,7 +394,7 @@ def _make_stream_and_ptr(
         self,
         size: int,
         address: int,
-    ) -> Tuple[ctypes.pointer, bytes]:
+    ) -> Tuple[ctypes._PointerLike, bytes]:
         if self.freed:
             raise FreedMemoryError("memory has been freed")