From c53442c30de5d2333b900c60300cfc84b78f9b6b Mon Sep 17 00:00:00 2001
From: Stephen Morton <git@tungol.org>
Date: Tue, 26 Nov 2024 20:45:48 -0800
Subject: [PATCH] add encodings.raw_unicode_escape and encodings.unicode_escape
 (#13114)

---
 stdlib/@tests/stubtest_allowlists/common.txt |  2 --
 stdlib/encodings/raw_unicode_escape.pyi      | 34 ++++++++++++++++++++
 stdlib/encodings/unicode_escape.pyi          | 34 ++++++++++++++++++++
 3 files changed, 68 insertions(+), 2 deletions(-)
 create mode 100644 stdlib/encodings/raw_unicode_escape.pyi
 create mode 100644 stdlib/encodings/unicode_escape.pyi

diff --git a/stdlib/@tests/stubtest_allowlists/common.txt b/stdlib/@tests/stubtest_allowlists/common.txt
index 5b14c03dc..010a2a3ab 100644
--- a/stdlib/@tests/stubtest_allowlists/common.txt
+++ b/stdlib/@tests/stubtest_allowlists/common.txt
@@ -60,8 +60,6 @@ weakref.WeakValueDictionary.update
 # ==========
 encodings.ascii
 encodings.latin_1
-encodings.raw_unicode_escape
-encodings.unicode_escape
 turtledemo
 turtledemo\..+
 xml.sax.expatreader
diff --git a/stdlib/encodings/raw_unicode_escape.pyi b/stdlib/encodings/raw_unicode_escape.pyi
new file mode 100644
index 000000000..74abb4623
--- /dev/null
+++ b/stdlib/encodings/raw_unicode_escape.pyi
@@ -0,0 +1,34 @@
+import codecs
+import sys
+from _typeshed import ReadableBuffer
+
+class Codec(codecs.Codec):
+    # At runtime, this is codecs.raw_unicode_escape_encode
+    @staticmethod
+    def encode(str: str, errors: str | None = None, /) -> tuple[bytes, int]: ...
+    # At runtime, this is codecs.raw_unicode_escape_decode
+    if sys.version_info >= (3, 9):
+        @staticmethod
+        def decode(data: str | ReadableBuffer, errors: str | None = None, final: bool = True, /) -> tuple[str, int]: ...
+    else:
+        @staticmethod
+        def decode(data: str | ReadableBuffer, errors: str | None = None, /) -> tuple[str, int]: ...
+
+class IncrementalEncoder(codecs.IncrementalEncoder):
+    def encode(self, input: str, final: bool = False) -> bytes: ...
+
+if sys.version_info >= (3, 9):
+    class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
+        def _buffer_decode(self, input: str | ReadableBuffer, errors: str | None, final: bool) -> tuple[str, int]: ...
+
+else:
+    class IncrementalDecoder(codecs.IncrementalDecoder):
+        def decode(self, input: str | ReadableBuffer, final: bool = False) -> str: ...
+
+class StreamWriter(Codec, codecs.StreamWriter): ...
+
+class StreamReader(Codec, codecs.StreamReader):
+    if sys.version_info >= (3, 9):
+        def decode(self, input: str | ReadableBuffer, errors: str = "strict") -> tuple[str, int]: ...  # type: ignore[override]
+
+def getregentry() -> codecs.CodecInfo: ...
diff --git a/stdlib/encodings/unicode_escape.pyi b/stdlib/encodings/unicode_escape.pyi
new file mode 100644
index 000000000..1e942f579
--- /dev/null
+++ b/stdlib/encodings/unicode_escape.pyi
@@ -0,0 +1,34 @@
+import codecs
+import sys
+from _typeshed import ReadableBuffer
+
+class Codec(codecs.Codec):
+    # At runtime, this is codecs.unicode_escape_encode
+    @staticmethod
+    def encode(str: str, errors: str | None = None, /) -> tuple[bytes, int]: ...
+    # At runtime, this is codecs.unicode_escape_decode
+    if sys.version_info >= (3, 9):
+        @staticmethod
+        def decode(data: str | ReadableBuffer, errors: str | None = None, final: bool = True, /) -> tuple[str, int]: ...
+    else:
+        @staticmethod
+        def decode(data: str | ReadableBuffer, errors: str | None = None, /) -> tuple[str, int]: ...
+
+class IncrementalEncoder(codecs.IncrementalEncoder):
+    def encode(self, input: str, final: bool = False) -> bytes: ...
+
+if sys.version_info >= (3, 9):
+    class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
+        def _buffer_decode(self, input: str | ReadableBuffer, errors: str | None, final: bool) -> tuple[str, int]: ...
+
+else:
+    class IncrementalDecoder(codecs.IncrementalDecoder):
+        def decode(self, input: str | ReadableBuffer, final: bool = False) -> str: ...
+
+class StreamWriter(Codec, codecs.StreamWriter): ...
+
+class StreamReader(Codec, codecs.StreamReader):
+    if sys.version_info >= (3, 9):
+        def decode(self, input: str | ReadableBuffer, errors: str = "strict") -> tuple[str, int]: ...  # type: ignore[override]
+
+def getregentry() -> codecs.CodecInfo: ...