Rename find_java function to jreflect

To me, the name `find_java` suggests we will be locating a JVM
installation, rather than "finding" information about Java objects.
The information doesn't need to be "found" or "located", but rather
only introspected or interrogated. Technically, I suppose
"introspection" implies read/access while "reflection" implies
write/mutation, but `jintrospect` is rather clunky, whereas the
term "reflection" is widely known in both Java and Python circles.

Author: ctrueden

src/scyjava/__init__.py

@@ -94,8 +94,8 @@
 from ._introspect import (
     attrs,
     fields,
-    find_java,
     java_source,
+    jreflect,
     methods,
     src,
 )

src/scyjava/_introspect.py

@@ -9,10 +9,10 @@
 from scyjava._types import isjava, jinstance, jclass
 
 
-def find_java(data, aspect: str) -> List[Dict[str, Any]]:
+def jreflect(data, aspect: str) -> List[Dict[str, Any]]:
     """
     Use Java reflection to introspect the given Java object,
-    returning a table of its available methods.
+    returning a table of its available methods or fields.
 
     :param data: The object or class or fully qualified class name to inspect.
     :param aspect: Either 'methods' or 'fields'
@@ -152,7 +152,7 @@ def _print_data(data, aspect, static: Optional[bool] = None, source: bool = True
     :param static: Boolean filter on Static or Instance methods. Optional, default is None (prints all).
     :param source: Whether to print any available source code. Default True.
     """
-    table = find_java(data, aspect)
+    table = jreflect(data, aspect)
     if len(table) == 0:
         print(f"No {aspect} found")
         return

tests/test_introspect.py

@@ -17,27 +17,27 @@ class TestIntrospection(object):
     Test introspection functionality.
     """
 
-    def test_find_java_methods(self):
+    def test_jreflect_methods(self):
         if mode == Mode.JEP:
             # JEP does not support the jclass function.
             return
         str_String = "java.lang.String"
         String = scyjava.jimport(str_String)
-        str_Obj = scyjava.find_java(str_String, "methods")
-        jimport_Obj = scyjava.find_java(String, "methods")
+        str_Obj = scyjava.jreflect(str_String, "methods")
+        jimport_Obj = scyjava.jreflect(String, "methods")
         assert len(str_Obj) > 0
         assert len(jimport_Obj) > 0
         assert jimport_Obj is not None
         assert jimport_Obj == str_Obj
 
-    def test_find_java_fields(self):
+    def test_jreflect_fields(self):
         if mode == Mode.JEP:
             # JEP does not support the jclass function.
             return
         str_BitSet = "java.util.BitSet"
         BitSet = scyjava.jimport(str_BitSet)
-        str_Obj = scyjava.find_java(str_BitSet, "fields")
-        bitset_Obj = scyjava.find_java(BitSet, "fields")
+        str_Obj = scyjava.jreflect(str_BitSet, "fields")
+        bitset_Obj = scyjava.jreflect(BitSet, "fields")
         assert len(str_Obj) == 0
         assert len(bitset_Obj) == 0
         assert bitset_Obj is not None
@@ -61,7 +61,7 @@ def test_imagej_legacy(self):
             # JEP does not support the jclass function.
             return
         str_RE = "ij.plugin.RoiEnlarger"
-        table = scyjava.find_java(str_RE, aspect="methods")
+        table = scyjava.jreflect(str_RE, aspect="methods")
         assert len([entry for entry in table if entry["static"]]) == 3
         github_home = "https://github.com/"
         assert scyjava.java_source(str_RE).startsWith(github_home)