Account for current flake8 errors with noqa.

- Ignore need for docstrings in function overloads.
- Ignore a line being too long due to a pyright: ignore + explanation.
 - Moving the explanation away from that line doesn't make the line short enough to pass. Removing the error code as well would be enough, but removing both has 2 downsides:
  a) The lack of explanation on the same line makes it harder to immediately see why the pyright: ignore was added when grepping.
  b) Having an unrestricted pyright: ignore (or type: ignore) can cover up other typechecking errors, which could cause a problem down the line.
 - Having a pyright: ignore, a noqa, and fmt: off/on for this one line isn't clean, but I'd like a second opinion on how to handle it.

Author: Sachaa-Thanasius

src/rfc3986/compat.py

@@ -21,12 +21,14 @@
 
 
 @t.overload
-def to_str(b: t.Union[str, bytes], encoding: str = "utf-8") -> str:
-    ...
+def to_str(  # noqa: D103
+    b: t.Union[str, bytes],
+    encoding: str = "utf-8",
+) -> str: ...
 
 
 @t.overload
-def to_str(b: None, encoding: str = "utf-8") -> None:
+def to_str(b: None, encoding: str = "utf-8") -> None:  # noqa: D103
     ...
 
 
@@ -41,12 +43,14 @@ def to_str(
 
 
 @t.overload
-def to_bytes(s: t.Union[str, bytes], encoding: str = "utf-8") -> bytes:
-    ...
+def to_bytes(  # noqa: D103
+    s: t.Union[str, bytes],
+    encoding: str = "utf-8",
+) -> bytes: ...
 
 
 @t.overload
-def to_bytes(s: None, encoding: str = "utf-8") -> None:
+def to_bytes(s: None, encoding: str = "utf-8") -> None:  # noqa: D103
     ...
 
 

src/rfc3986/normalizers.py

@@ -146,12 +146,12 @@ def remove_dot_segments(s: str) -> str:
 
 
 @t.overload
-def encode_component(uri_component: None, encoding: str) -> None:
+def encode_component(uri_component: None, encoding: str) -> None:  # noqa: D103
     ...
 
 
 @t.overload
-def encode_component(uri_component: str, encoding: str) -> str:
+def encode_component(uri_component: str, encoding: str) -> str:  # noqa: D103
     ...
 
 

src/rfc3986/validators.py

@@ -435,9 +435,9 @@ def subauthority_component_is_valid(
         return True
 
     try:
-        port = int(
-            subauthority_dict["port"]
-        )  # pyright: ignore[reportArgumentType] # Guarded by "except TypeError".
+        # fmt: off
+        port = int(subauthority_dict["port"])  # pyright: ignore[reportArgumentType] # noqa: E501 # Guarded by "except TypeError".
+        # fmt: on
     except TypeError:
         # If the port wasn't provided it'll be None and int(None) raises a
         # TypeError