refactor(java): add exception classes to java.nio.file (#360)

add supporting classes to java.util and java.lang

Author: cesarcoatl

ignition-api-stubs/stubs/java/lang/__init__.pyi

@@ -235,6 +235,11 @@ class IllegalArgumentException(RuntimeException):
         self, message: Optional[str] = ..., cause: Optional[Throwable] = ...
     ) -> None: ...
 
+class IllegalStateException(RuntimeException):
+    def __init__(
+        self, message: Optional[str] = ..., cause: Optional[Throwable] = ...
+    ) -> None: ...
+
 class IndexOutOfBoundsException(RuntimeException):
     def __init__(self, arg: Optional[Union[int, AnyStr]] = ...) -> None: ...
 

ignition-api-stubs/stubs/java/nio/file/__init__.pyi

@@ -1,8 +1,25 @@
 from typing import Any, Iterator, List, Optional, Set, Union
 
 from dev.coatl.helper.types import AnyStr
-from java.io import BufferedReader, BufferedWriter, InputStream, OutputStream
-from java.lang import AutoCloseable, CharSequence, Class, Enum, Object
+from java.io import (
+    BufferedReader,
+    BufferedWriter,
+    InputStream,
+    IOException,
+    OutputStream,
+)
+from java.lang import (
+    AutoCloseable,
+    CharSequence,
+    Class,
+    Enum,
+    IllegalArgumentException,
+    IllegalStateException,
+    Object,
+    RuntimeException,
+    Throwable,
+    UnsupportedOperationException,
+)
 from java.nio.channels import SeekableByteChannel
 from java.nio.charset import Charset
 from java.nio.file.attribute import (
@@ -14,6 +31,7 @@ from java.nio.file.attribute import (
     PosixFilePermission,
     UserPrincipal,
 )
+from java.util import ConcurrentModificationException
 from java.util.function import BiPredicate
 from java.util.stream import Stream
 
@@ -39,6 +57,76 @@ class FileStore(Object):
     def supportsFileAttributeView(self, type: Class) -> bool: ...
     def type(self) -> AnyStr: ...
 
+class ClosedDirectoryStreamException(IllegalStateException):
+    def __init__(self) -> None: ...
+
+class ClosedFileSystemException(IllegalStateException):
+    def __init__(self) -> None: ...
+
+class DirectoryIteratorException(ConcurrentModificationException):
+    def __init__(self, cause: Throwable) -> None: ...
+
+class FileSystemAlreadyExistsException(RuntimeException):
+    def __init__(self, message: Optional[str] = ...) -> None: ...
+
+class FileSystemException(IOException):
+    def __init__(
+        self,
+        file: AnyStr,
+        other: Optional[AnyStr] = ...,
+        reason: Optional[AnyStr] = ...,
+    ) -> None: ...
+    def getFile(self) -> AnyStr: ...
+    def getOtherFile(self) -> Optional[AnyStr]: ...
+    def getReason(self) -> Optional[AnyStr]: ...
+
+class AccessDeniedException(FileSystemException):
+    def __init__(
+        self,
+        file: AnyStr,
+        other: Optional[AnyStr] = ...,
+        reason: Optional[AnyStr] = ...,
+    ) -> None: ...
+
+class AtomicMoveNotSupportedException(FileSystemException):
+    def __init__(self, source: AnyStr, target: AnyStr, reason: AnyStr) -> None: ...
+
+class DirectoryNotEmptyException(FileSystemException):
+    def __init__(self, dir_: AnyStr) -> None: ...
+
+class FileAlreadyExistsException(FileSystemException):
+    def __init__(
+        self,
+        file: AnyStr,
+        other: Optional[AnyStr] = ...,
+        reason: Optional[AnyStr] = ...,
+    ) -> None: ...
+
+class FileSystemLoopException(FileSystemException):
+    def __init__(self, file: AnyStr) -> None: ...
+
+class FileSystemNotFoundException(RuntimeException):
+    def __init__(self, message: Optional[str] = ...) -> None: ...
+
+class NoSuchFileException(FileSystemException):
+    def __init__(
+        self,
+        file: AnyStr,
+        other: Optional[AnyStr] = ...,
+        reason: Optional[AnyStr] = ...,
+    ) -> None: ...
+
+class NotDirectoryException(FileSystemException):
+    def __init__(self, file: AnyStr) -> None: ...
+
+class NotLinkException(FileSystemException):
+    def __init__(
+        self,
+        file: AnyStr,
+        other: Optional[AnyStr] = ...,
+        reason: Optional[AnyStr] = ...,
+    ) -> None: ...
+
 class FileVisitOption(Enum):
     FOLLOW_LINKS: FileVisitOption
     @staticmethod
@@ -160,6 +248,12 @@ class Files(Object):
     @staticmethod
     def writeString(path: Path, csq: CharSequence, *args: Any) -> Path: ...
 
+class InvalidPathException(IllegalArgumentException):
+    def __init__(self, input: str, reason: str, index: Optional[int] = ...) -> None: ...
+    def getIndex(self) -> Optional[int]: ...
+    def getInput(self) -> AnyStr: ...
+    def getReason(self) -> AnyStr: ...
+
 class LinkOption(Enum, CopyOption, OpenOption):
     NOFOLLOW_LINKS: LinkOption
     @staticmethod
@@ -196,6 +290,9 @@ class Paths(Object):
     @staticmethod
     def get(*args: Any) -> Path: ...
 
+class ReadOnlyFileSystemException(UnsupportedOperationException):
+    def __init__(self) -> None: ...
+
 class StandardCopyOption(Enum, CopyOption, OpenOption):
     ATOMIC_MOVE: StandardCopyOption
     COPY_ATTRIBUTES: StandardCopyOption

ignition-api-stubs/stubs/java/util/__init__.pyi

@@ -2,7 +2,7 @@ from typing import Any, Dict, Iterable, List, Mapping, Optional, Set, Union
 
 from dev.coatl.helper.types import AnyStr
 from java.io import InputStream, OutputStream
-from java.lang import Class, Object
+from java.lang import Class, Object, RuntimeException, Throwable
 from java.nio import ByteBuffer
 from java.time import Instant, ZoneId
 from java.util.function import (
@@ -381,6 +381,11 @@ class Calendar(Object):
     def setWeekDate(self, weekYear: int, weekOfYear: int, dayOfWeek: int) -> None: ...
     def toInstant(self) -> Instant: ...
 
+class ConcurrentModificationException(RuntimeException):
+    def __init__(
+        self, message: Optional[str] = ..., cause: Optional[Throwable] = ...
+    ) -> None: ...
+
 class Currency(Object):
     @staticmethod
     def getAvailableCurrencies() -> Set[Currency]: ...

ignition-api/.pylintrc

@@ -93,7 +93,7 @@ prefer-stubs=no
 
 # Minimum Python version to use for version dependent checks. Will default to
 # the version used to run pylint.
-py-version=3.13
+py-version=3.14
 
 # Discover python modules and packages in the file system subtree.
 recursive=no
@@ -104,10 +104,6 @@ recursive=no
 # source root.
 source-roots=
 
-# When enabled, pylint would attempt to guess common misconfiguration and emit
-# user-friendly hints instead of false-positive error messages.
-suggestion-mode=yes
-
 # Allow loading of arbitrary C extensions. Extensions are imported into the
 # active Python interpreter and may run arbitrary code.
 unsafe-load-any-extension=no
@@ -229,6 +225,11 @@ name-group=
 # not require a docstring.
 no-docstring-rgx=^_
 
+# Regular expression matching correct parameter specification variable names.
+# If left empty, parameter specification variable names will be checked with
+# the set naming style.
+#paramspec-rgx=
+
 # List of decorators that produce properties, such as abc.abstractproperty. Add
 # to this list to register other decorators that produce valid properties.
 # These decorators are taken in consideration only for invalid-name.
@@ -242,6 +243,10 @@ property-classes=abc.abstractproperty
 # variable names will be checked with the set naming style.
 #typevar-rgx=
 
+# Regular expression matching correct type variable tuple names. If left empty,
+# type variable tuple names will be checked with the set naming style.
+#typevartuple-rgx=
+
 # Naming style matching correct variable names.
 variable-naming-style=any
 
@@ -339,7 +344,9 @@ indent-after-paren=4
 # tab).
 indent-string='    '
 
-# Maximum number of characters on a single line.
+# Maximum number of characters on a single line. Pylint's default of 100 is
+# based on PEP 8's guidance that teams may choose line lengths up to 99
+# characters.
 max-line-length=120
 
 # Maximum number of lines in a module.
@@ -455,6 +462,9 @@ timeout-methods=requests.api.delete,requests.api.get,requests.api.head,requests.
 
 [MISCELLANEOUS]
 
+# Whether or not to search for fixme's in docstrings.
+check-fixme-in-docstring=no
+
 # List of note tags to take in consideration, separated by a comma.
 notes=FIXME,
       XXX,

ignition-api/src/java/lang/__init__.py

@@ -15,6 +15,7 @@
     "Enum",
     "Exception",
     "IllegalArgumentException",
+    "IllegalStateException",
     "IndexOutOfBoundsException",
     "Iterable",
     "NullPointerException",
@@ -796,6 +797,16 @@ def __init__(self, message=None, cause=None):
         super(IllegalArgumentException, self).__init__(message, cause)
 
 
+class IllegalStateException(RuntimeException):
+    """Signals that a method has been invoked at an illegal or
+    inappropriate time.
+    """
+
+    def __init__(self, message=None, cause=None):
+        # type: (Optional[str], Optional[Throwable]) -> None
+        super(IllegalStateException, self).__init__(message, cause)
+
+
 class IndexOutOfBoundsException(RuntimeException):
     """Thrown to indicate that an index of some sort (such as to an
     array, to a string, or to a vector) is out of range.