Refactor modules ( BREAKING CHANGES )

1. rename cleo -> addition
2. move call_function, call_method, free_library, load_library, get_proc_address into memory modules
3. move test_cheat into common module
4. Update all examples

Author: user-grinch

runtime/PyLoader/libstd/addition.py

@@ -0,0 +1,103 @@
+from typing import Tuple
+import _addition
+
+def get_car_handle(pVeh :int) -> int:
+	'''Get vehicle handle from pointer'''
+
+	return _addition.get_car_handle(pVeh)
+
+def get_car_pointer(hveh :int) -> int:
+	'''Get vehicle pointer from handle'''
+
+	return _addition.get_car_pointer(hveh)
+
+def get_char_handle(pPed :int) -> int:
+	'''Get char handle from pointer'''
+
+	return _addition.get_char_handle(pPed)
+
+def get_char_pointer(hped :int) -> int:
+	'''Get char pointer from handle'''
+
+	return _addition.get_char_pointer(hped)
+
+def get_closest_ped() -> int:
+	'''Returns the closest ped to player'''
+
+	return _addition.get_closest_ped()
+
+def get_closest_vehicle() -> int:
+	'''Returns the closest vehicle to player'''
+
+	return _addition.get_closest_vehicle()
+
+def get_largest_gangid_in_zone() -> int:
+	'''Returns the gang id of the largest gang in player's current zone'''
+
+	return _addition.get_largest_gangid_in_zone()
+
+def get_object_handle(pObj :int) -> int:
+	'''Get object handle from pointer'''
+
+	return _addition.get_object_handle(pObj)
+
+def get_object_pointer(hObj :int) -> int:
+	'''Get object pointer from handle'''
+
+	return _addition.get_object_pointer(hObj)
+
+def get_player_targeted_char() -> int:
+	'''Get the char player is targetting with a weapon'''
+
+	return _addition.get_player_targeted_char()
+
+def get_target_marker_coords() -> Tuple[float, float, float]:
+	'''Get coordinates of target marker. Returns -1, -1, -1 on failure'''
+
+	return _addition.get_target_marker_coords()
+
+def get_vehicle_current_gear(hveh :int) -> int:
+	'''Get the current gear of the vehicle'''
+
+	return _addition.get_vehicle_current_gear(hveh)
+
+def get_vehicle_model_from_name(name :str) -> int:
+	'''Get vehicle model from name'''
+
+	return _addition.get_vehicle_model_from_name(name)
+
+def get_vehicle_model_name(model :int) -> str:
+	'''Get vehicle name from model'''
+
+	return _addition.get_vehicle_model_name(model)
+
+def get_vehicle_number_of_gears(hveh :int) -> int:
+	'''Get number of total vehicle gears'''
+
+	return _addition.get_vehicle_number_of_gears(hveh)
+
+def is_on_cutscene() -> bool:
+	'''Is a cutscene being played'''
+
+	return _addition.is_on_cutscene()
+
+def is_on_mission() -> bool:
+	'''Is a mission running'''
+
+	return _addition.is_on_mission()
+
+def is_vehicle_engine_on(hveh :int) -> bool:
+	'''Is vehicle engine is turned on'''
+
+	return _addition.is_vehicle_engine_on(hveh)
+
+def is_vehicle_siren_on(hveh: int) -> bool:
+	'''Is vehicle siren is on'''
+
+	return _addition.is_vehicle_siren_on(hveh)
+
+def set_vehicle_engine_state(hveh :int, state: bool) -> None:
+	'''Sets the engine state of the vehicle'''
+
+	_addition.set_vehicle_engine_state(hveh, state)
+

runtime/PyLoader/libstd/cleo.py

@@ -25,3 +25,8 @@ def wait(time_ms: int = 0):
     '''Freezes the script for specified amount of time. Must be used inside each loop'''
 
     _common.wait(time_ms)
+
+def test_cheat(cheat :str) -> bool:
+	'''Checks whether the particular character sequence was pressed'''
+
+	return _common.test_cheat(cheat)

runtime/PyLoader/libstd/common.py

@@ -29,15 +29,15 @@ def on_ped_destroy(hped :int) -> None:
     pass
 
 def on_obj_create(hobj :int) -> None:
-    '''Called after a new object is created'''
+    '''Called after a new object is created. Doesn't work with SilentPatch'''
     pass
 
 def on_obj_render(hobj :int) -> None:
-    '''Called when a object is being rendered'''
+    '''Called when a object is being rendered. Doesn't work with SilentPatch'''
     pass
 
 def on_obj_destroy(hobj :int) -> None:
-    '''Called before a object is destroyed'''
+    '''Called before a object is destroyed. Doesn't work with SilentPatch'''
     pass
 
 def on_game_restart() -> None:

runtime/PyLoader/libstd/events.py

@@ -7,8 +7,7 @@
 
 from abc import ABCMeta, abstractmethod, abstractproperty, abstractstaticmethod
 from typing import Tuple, Final, Generic, TypeVar
-from libstd.memory import read_memory, write_memory, read_float, write_float
-from libstd.cleo import call_function, call_method
+from libstd.memory import read_memory, write_memory, read_float, write_float, call_function, call_method
 from enum import Enum
 import ctypes
 

runtime/PyLoader/libstd/game_sa/__pycache__/_cppinterface.cpython-38.pyc

@@ -1,5 +1,4 @@
-from typing import List
-import cleo
+import memory
 from libstd.game_sa._cppinterface import mem_handler
 
 class CClock:
@@ -21,36 +20,36 @@ class CClock:
 
     # Returns number of minutes to specified hour & minute.
     def GetGameClockMinutesUntil(self, hours :int, minutes :int):
-        return cleo.call_function(0x52CEB0, 2, 0, hours, minutes)
+        return memory.call_function(0x52CEB0, 2, 0, hours, minutes)
 
     # Returns true current hour is in range of two specified hours.
     def GetIsTimeInRange(self, hourA :int, hourB :int):
-        return cleo.call_function(0x52CEE0, 2, 0, hourA, hourB)
+        return memory.call_function(0x52CEE0, 2, 0, hourA, hourB)
 
     def Initialise(self, milisecondsPerGameMinute :int):
-        cleo.call_function(0x52CD90, 1, 0, milisecondsPerGameMinute)
+        memory.call_function(0x52CD90, 1, 0, milisecondsPerGameMinute)
 
     # Normalizes game clock
     # For example hour of 24 means new day and hour 1.
     def NormaliseGameClock(self):
-        cleo.call_function(0x52CDE0, 1, 0)
+        memory.call_function(0x52CDE0, 1, 0)
 
     # Sets new day
     # Directions (0 = one day backwards, 1 = one day forwards)
     def OffsetClockByADay(self, timeDirection :int):
-        cleo.call_function(0x52D0B0, 1, 0, timeDirection)
+        memory.call_function(0x52D0B0, 1, 0, timeDirection)
 
     def RestoreClock(self): 
-        cleo.call_function(0x52D070, 0, 0)
+        memory.call_function(0x52D070, 0, 0)
 
     def SetGameClock(self, hours, minutes, day):
-        cleo.call_function(0x52D150, 3, 0, hours, minutes, day)
+        memory.call_function(0x52D150, 3, 0, hours, minutes, day)
 
     def StoreClock(self):
-        cleo.call_function(0x52D020, 0, 0)
+        memory.call_function(0x52D020, 0, 0)
 
     def Update(self):
-        cleo.call_function(0x52CF10, 0, 0)
+        memory.call_function(0x52CF10, 0, 0)
 
 # Create instance
 CClock = CClock()