Changed load_* to return the libraries they load

Author: tarkatronic

CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.3.0] - 2022-03-04
+
+- Changed `load_*` to return the libraries that have been loaded.
+
 ## [0.2.1] - 2022-03-04
 
 - Added `minimum_allocation` and `header_size` properties to the `Cobhan` class

cobhan/cobhan.py

@@ -11,13 +11,14 @@
 
 # Pending https://github.com/python/typing/issues/593
 CBuf = bytearray  # Cobhan buffer -- returned from ffi.new()
+FFILibrary = Any
 
 
 class Cobhan:
     """Class representing the Cobhan translation layer"""
 
     def __init__(self):
-        self._lib: Optional[Any] = None
+        self._lib: Optional[FFILibrary] = None
         self.__ffi: FFI = FFI()
         self.__sizeof_int32: int = self.__ffi.sizeof("int32_t")
         self.__sizeof_int64: int = self.__ffi.sizeof("int64_t")
@@ -37,7 +38,9 @@ def header_size(self):
         """The size, in bytes, of a buffer's header"""
         return self.__sizeof_header
 
-    def load_library(self, library_path: str, library_name: str, cdefines: str) -> None:
+    def load_library(
+        self, library_path: str, library_name: str, cdefines: str
+    ) -> FFILibrary:
         """Locate and load a library based on the current platform.
 
         :param library_path: The filesystem path where the library is located
@@ -90,7 +93,9 @@ def load_library(self, library_path: str, library_name: str, cdefines: str) -> N
         if need_chdir:
             os.chdir(old_dir)
 
-    def load_library_direct(self, library_file_path: str, cdefines: str) -> None:
+        return self._lib
+
+    def load_library_direct(self, library_file_path: str, cdefines: str) -> FFILibrary:
         """Directly load a specific library file.
 
         Generally speaking, you probably don't want this. Instead, you probably
@@ -104,6 +109,7 @@ def load_library_direct(self, library_file_path: str, cdefines: str) -> None:
         """
         self.__ffi.cdef(cdefines)
         self._lib = self.__ffi.dlopen(library_file_path)
+        return self._lib
 
     def to_json_buf(self, obj: Any) -> CBuf:
         """Serialize an object into JSON in a Cobhan buffer.

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "cobhan"
-version = "0.2.1"
+version = "0.3.0"
 description = "Cobhan FFI"
 authors = [
     "Jeremiah Gowdy <jeremiah@gowdy.me>",