Let scyjava.config accept JPype keyword arguments

Closes #79.

Author: ctrueden

src/scyjava/_jvm.py

@@ -198,7 +198,8 @@ def start_jvm(options=None, *, fetch_java: bool = True) -> None:
     _logger.debug("Starting JVM")
     if options is None:
         options = scyjava.config.get_options()
-    jpype.startJVM(*options, interrupt=True)
+    kwargs = scyjava.config.get_kwargs()
+    jpype.startJVM(*options, **kwargs)
 
     # replace JPype/JVM shutdown handling with our own
     jpype.config.onexit = False

src/scyjava/config.py

@@ -20,6 +20,7 @@
 _cache_dir = Path.home() / ".jgo"
 _m2_repo = Path.home() / ".m2" / "repository"
 _options = []
+_kwargs = {"interrupt": True}
 _shortcuts = {}
 
 
@@ -320,6 +321,27 @@ def get_options() -> list[str]:
     return _options
 
 
+def add_kwargs(**kwargs) -> None:
+    """
+    Add keyword arguments to be passed to JPype at JVM startup. Examples:
+
+        jvmpath = "/path/to/my_jvm"
+        ignoreUnrecognized = True
+        convertStrings = True
+        interrupt = True
+    """
+    global _kwargs
+    _kwargs.update(kwargs)
+
+
+def get_kwargs() -> dict[str, str]:
+    """
+    Get the keyword arguments to be passed to JPype at JVM startup.
+    """
+    global _kwargs
+    return _kwargs
+
+
 def add_shortcut(k: str, v: str):
     """
     Add a shortcut key/value to be used by jgo for evaluating endpoints.