Fix warnings.

Author: Thrameos

native/jpype_module/src/main/java/org/jpype/bridge/Backend.java

@@ -124,7 +124,7 @@ public interface Backend
   // Get the signature of a Python callable.
   PyObject getSignature(PyCallable obj);
 
-  PyObject getattrDefault(PyObject obj, Object key);
+  PyObject getattrDefault(PyObject obj, Object key, PyObject defaultValue);
 
   // Get an attribute from a Python object by key.
   PyObject getattrObject(PyObject obj, Object key);
@@ -289,17 +289,16 @@ public interface Backend
   // Create an empty Python `set`.
   PySet set();
 
-  // Set an attribute on a Python object.
-  void setattrString(Object obj, CharSequence attrName, Object value);
 
   // Set an attribute on a Python object and return the updated object.
   PyObject setattrReturn(PyObject obj, CharSequence attrName, PyObject value);
-
-  // Set an item in a Python mapping object by string key.
-  void setitemFromString(Object obj, CharSequence key, Object value);
+  // Set an attribute on a Python object.
+  void setattrString(Object obj, CharSequence attrName, Object value);
 
   // Set an item in a Python mapping object by object key.
   PyObject setitemFromObject(Object obj, Object key, Object value);
+  // Set an item in a Python mapping object by string key.
+  void setitemFromString(Object obj, CharSequence key, Object value);
 
   // Create a Python `slice` object.
   PySlice slice(Integer start, Integer stop, Integer step);
@@ -319,9 +318,7 @@ public interface Backend
   // Get the `__dict__` attribute of a Python object.
   PyDict vars(Object obj);
 
-  public PyZip zipFromArray(PyObject[] objects);
-
-  public PyZip zipFromArray(Object[] objects);
+  PyZip zipFromArray(Object[] objects);
 
   // Create a Python `zip` object from multiple objects.
   <T> PyZip zipFromIterable(T... objects);

native/jpype_module/src/main/java/python/lang/PyBuiltIn.java

@@ -184,18 +184,6 @@ public static void exec(CharSequence statement, PyDict globals, PyMapping locals
     backend().eval(statement, globals, locals);
   }
 
-  /**
-   * Retrieves the value of an attribute from a Python object.
-   *
-   * @param obj the Python object to inspect.
-   * @param key the name of the attribute to retrieve.
-   * @return the value of the attribute as a {@link PyObject}.
-   */
-  public static PyObject getattr(PyObject obj, CharSequence key)
-  {
-    return backend().getattrString(obj, key);
-  }
-
   /**
    * Retrieves the value of an attribute from a Python object.
    *
@@ -210,7 +198,7 @@ public static PyObject getattr(PyObject obj, Object key)
 
   public static PyObject getattrDefault(PyObject obj, Object key, PyObject defaultValue)
   {
-    return backend().getattrDefault(obj, key);
+    return backend().getattrDefault(obj, key, defaultValue);
   }
 
   /**
@@ -472,13 +460,13 @@ public static <T> PyTuple tuple()
   /**
    * Creates a Python tuple from a variable-length array of arguments.
    *
-   * @param args the objects to include in the tuple.
+   * @param items the objects to include in the tuple.
    * @param <T> the type of the objects.
    * @return a new {@link PyTuple} instance containing the objects.
    */
-  public static <T> PyTuple tuple(T... args)
+  public static <T> PyTuple tuple(T... items)
   {
-    return backend().newTupleFromArray(args);
+    return backend().newTupleFromArray(items);
   }
 
   /**

native/jpype_module/src/main/java/python/lang/PyByteArray.java

@@ -94,21 +94,49 @@ static PyByteArray fromHex(CharSequence str)
   }
 
   /**
-   * Decodes the contents of the bytearray using the specified encoding.
-   * Optionally, specific bytes can be deleted during decoding.
+   * Decodes a bytearray object into a Python string.
    *
-   * @param encoding the encoding to use for decoding (e.g., "utf-8").
-   * @param delete the bytes to delete during decoding, or {@code null} for no
-   * deletion.
-   * @return a {@link PyObject} representing the decoded string.
+   * <p>
+   * Values for encoding include:</p>
+   * <ul>
+   * <li>"utf-8" (default)</li>
+   * <li>"ascii"</li>
+   * <li>"latin-1"</li>
+   * <li>"utf-16"</li>
+   * <li>"utf-32"</li>
+   * <li>"cp1252" (Windows encoding)</li>
+   * </ul>
+   *
+   * <p>
+   * Values for errors include:</p>
+   * <ul>
+   * <li>"strict" (default): Raises a UnicodeDecodeError for invalid data.</li>
+   * <li>"ignore": Ignores invalid characters.</li>
+   * <li>"replace": Replaces invalid characters with a replacement character
+   * (e.g., ? or �).</li>
+   * <li>"backslashreplace": Replaces invalid characters with Python-style
+   * escape sequences (e.g., \xNN).</li>
+   * <li>"namereplace": Replaces invalid characters with \N{name} escape
+   * sequences.</li>
+   * <li>"surrogateescape": Uses special surrogate code points for invalid
+   * bytes.</li>
+   * </ul>
+   *
+   * @param encoding The character encoding to use for decoding the bytes
+   * object. Common values include "utf-8", "ascii", "latin-1", etc or null if
+   * not applicable.
+   * @param errors An optional argument to specify how to handle errors during
+   * decoding. Can be "strict", "ignore", "replace", etc., or null if not
+   * applicable.
+   * @return A new string resulting from decoding the bytearray object.
    */
-  PyObject decode(PyObject encoding, PyObject delete);
+  PyObject decode(PyObject encoding, PyObject errors);
 
   default int size()
   {
     return Interpreter.getBackend().len(this);
   }
-  
+
   /**
    * Translates the contents of the bytearray using a translation table. The
    * translation table maps byte values to their replacements.

native/jpype_module/src/main/java/python/lang/PyBytes.java

@@ -96,8 +96,50 @@ static PyType type()
     return (PyType) PyBuiltIn.eval("bytes", null, null);
   }
 
-  PyObject decode(PyObject string, PyObject encoding);
+  /**
+   * Decodes a bytes object into a Python string.
+   *
+   * <p>
+   * Values for encoding include:</p>
+   * <ul>
+   * <li>"utf-8" (default)</li>
+   * <li>"ascii"</li>
+   * <li>"latin-1"</li>
+   * <li>"utf-16"</li>
+   * <li>"utf-32"</li>
+   * <li>"cp1252" (Windows encoding)</li>
+   * </ul>
+   *
+   * <p>
+   * Values for errors include:</p>
+   * <ul>
+   * <li>"strict" (default): Raises a UnicodeDecodeError for invalid data.</li>
+   * <li>"ignore": Ignores invalid characters.</li>
+   * <li>"replace": Replaces invalid characters with a replacement character
+   * (e.g., ? or �).</li>
+   * <li>"backslashreplace": Replaces invalid characters with Python-style
+   * escape sequences (e.g., \xNN).</li>
+   * <li>"namereplace": Replaces invalid characters with \N{name} escape
+   * sequences.</li>
+   * <li>"surrogateescape": Uses special surrogate code points for invalid
+   * bytes.</li>
+   * </ul>
+   *
+   * @param encoding The character encoding to use for decoding the bytes
+   * object. Common values include "utf-8", "ascii", "latin-1", etc or null if
+   * not applicable.
+   * @param errors An optional argument to specify how to handle errors during
+   * decoding. Can be "strict", "ignore", "replace", etc., or null if not
+   * applicable.
+   * @return a new string resulting from decoding the bytes object.
+   */
+  PyString decode(CharSequence encoding, CharSequence errors);
 
+/**
+ * Gets the length of a bytearray object in bytes.
+ * 
+ * @return the length of the bytearray object, measured in bytes.
+ */
   default int size()
   {
     return Interpreter.getBackend().len(this);

native/jpype_module/src/main/java/python/lang/PyList.java

@@ -21,6 +21,7 @@
 import java.util.Collection;
 import java.util.Iterator;
 import java.util.List;
+import java.util.ListIterator;
 import org.jpype.bridge.Interpreter;
 
 /**
@@ -70,18 +71,6 @@
 public interface PyList extends PyObject, List<PyObject>, PyIterable
 {
 
-  /**
-   * Creates a new Python `list` object from the given a list of objects.
-   *
-   * @param items is an array whose elements will populate the new Python list.
-   * @return a new {@link PyList} instance containing the elements.
-   */
-
-  public static PyList of(Object... items)
-  {
-    return Interpreter.getBackend().newListFromArray(items);
-  }
-
   /**
    * Creates a new Python `list` object from the given {@link Iterable}.
    *
@@ -97,6 +86,18 @@ public static PyList fromItems(Iterable c)
     return Interpreter.getBackend().newListFromIterable(c);
   }
 
+  /**
+   * Creates a new Python `list` object from the given a list of objects.
+   *
+   * @param items is an array whose elements will populate the new Python list.
+   * @return a new {@link PyList} instance containing the elements.
+   */
+
+  public static PyList of(Object... items)
+  {
+    return Interpreter.getBackend().newListFromArray(items);
+  }
+
   /**
    * Retrieves the Python type object for `list`. This is equivalent to
    * evaluating `type(list)` in Python.
@@ -252,6 +253,35 @@ default Iterator<PyObject> iterator()
     return new PyIterator(this.iter());
   }
 
+  /**
+   * Returns a list iterator over the elements in the tuple.
+   *
+   * @return a list iterator starting at the beginning of the tuple
+   */
+  @Override
+  default ListIterator<PyObject> listIterator()
+  {
+    return new PyListIterator(this, 0);
+  }
+
+  /**
+   * Returns a list iterator over the elements in the tuple, starting at the
+   * specified index.
+   *
+   * @param index the starting index for the iterator
+   * @return a list iterator starting at the specified index
+   * @throws IndexOutOfBoundsException if the index is out of range
+   */
+  @Override
+  default ListIterator<PyObject> listIterator(int index)
+  {
+    if (index < 0 || index > size())
+    {
+      throw new IndexOutOfBoundsException();
+    }
+    return new PyListIterator(this, index);
+  }
+
   /**
    * Removes the first occurrence of the specified object from the list.
    *
@@ -402,4 +432,5 @@ default <T> T[] toArray(T[] a)
   {
     return (T[]) new ArrayList<>(this).toArray(a);
   }
+
 }

native/jpype_module/src/main/java/python/protocol/PyAttributes.java

@@ -23,6 +23,7 @@
 import org.jpype.bridge.Interpreter;
 import python.lang.PyDict;
 import python.lang.PyDictItems;
+import python.lang.PyDictKeySet;
 import python.lang.PyList;
 import python.lang.PyObject;
 
@@ -65,8 +66,6 @@
  * attributes.clear();
  * </pre>
  *
- * @param <CharSequence> The type of keys used for attribute names.
- * @param <PyObject> The type of values stored in the attributes.
  */
 public class PyAttributes implements Map<CharSequence, PyObject>
 {
@@ -170,7 +169,7 @@ public PyList dir()
 
   @Override
   public Set<Entry<CharSequence, PyObject>> entrySet()
-  {  
+  {
     return new PyDictItems(this.asDict());
   }
 
@@ -238,7 +237,7 @@ public boolean isEmpty()
   @Override
   public Set<CharSequence> keySet()
   {
-    throw new UnsupportedOperationException("Not supported yet."); // Generated from nbfs://nbhost/SystemFileSystem/Templates/Classes/Code/GeneratedMethodBody
+    return new PyDictKeySet(asDict());
   }
 
   /**
@@ -261,7 +260,7 @@ public PyObject put(CharSequence key, PyObject value)
   /**
    * Unsupported operation for adding multiple attributes.
    *
-   * @param collection The map of attributes to add.
+   * @param map is the map of attributes to add.
    * @throws UnsupportedOperationException Always thrown.
    */
   @Override

native/jpype_module/src/main/java/python/protocol/PyCallable.java

@@ -196,24 +196,24 @@ public CallBuilder(PyCallable callable)
     /**
      * Adds a single positional argument to the call sequence.
      *
-     * @param arg the argument to add
-     * @return this {@link CallBuilder} instance for chaining
+     * @param value is the argument to add.
+     * @return this {@link CallBuilder} instance for chaining.
      */
-    public CallBuilder arg(Object arg)
+    public CallBuilder arg(Object value)
     {
-      jargs.add(arg);
+      jargs.add(value);
       return this;
     }
 
     /**
      * Adds multiple positional arguments to the call sequence.
      *
-     * @param args the arguments to add
-     * @return this {@link CallBuilder} instance for chaining
+     * @param values is the arguments to add.
+     * @return this {@link CallBuilder} instance for chaining.
      */
-    public CallBuilder arg(Object... args)
+    public CallBuilder arg(Object... values)
     {
-      jargs.addAll(Arrays.asList(args));
+      jargs.addAll(Arrays.asList(values));
       return this;
     }
 

native/jpype_module/src/test/java/python/lang/PyTupleNGTest.java

@@ -75,6 +75,7 @@ public void testType()
   }
 
   @Test
+  @SuppressWarnings("element-type-mismatch")
   public void testContains()
   {
     PyTuple tuple = PyTuple.of("a", "b");