From 8e48a6edc75ca67a34924bbe54463ca913ae6e58 Mon Sep 17 00:00:00 2001
From: Sebastian Pipping <sebastian@pipping.org>
Date: Thu, 2 Jan 2025 13:54:38 +0100
Subject: gh-126624: Expose error code ``XML_ERROR_NOT_STARTED`` of Expat
 >=2.6.4 (#126625)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Expose error code ``XML_ERROR_NOT_STARTED`` in `xml.parsers.expat.errors` which was
introduced in Expat 2.6.4.


Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
---
 Doc/library/pyexpat.rst                                            | 7 +++++++
 .../next/Library/2024-11-09-15-59-51.gh-issue-126624.bN53Va.rst    | 2 ++
 Modules/pyexpat.c                                                  | 5 ++++-
 3 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 Misc/NEWS.d/next/Library/2024-11-09-15-59-51.gh-issue-126624.bN53Va.rst

diff --git a/Doc/library/pyexpat.rst b/Doc/library/pyexpat.rst
index c0e9999..0f3b58e 100644
--- a/Doc/library/pyexpat.rst
+++ b/Doc/library/pyexpat.rst
@@ -941,6 +941,13 @@ The ``errors`` module has the following attributes:
    has been breached.
 
 
+.. data:: XML_ERROR_NOT_STARTED
+
+   The parser was tried to be stopped or suspended before it started.
+
+   .. versionadded:: next
+
+
 .. rubric:: Footnotes
 
 .. [1] The encoding string included in XML output should conform to the
diff --git a/Misc/NEWS.d/next/Library/2024-11-09-15-59-51.gh-issue-126624.bN53Va.rst b/Misc/NEWS.d/next/Library/2024-11-09-15-59-51.gh-issue-126624.bN53Va.rst
new file mode 100644
index 0000000..468840a
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2024-11-09-15-59-51.gh-issue-126624.bN53Va.rst
@@ -0,0 +1,2 @@
+Expose error code :data:`~xml.parsers.expat.errors.XML_ERROR_NOT_STARTED`
+of Expat >=2.6.4 in :mod:`xml.parsers.expat.errors`.
diff --git a/Modules/pyexpat.c b/Modules/pyexpat.c
index cf7714e..9931ca2 100644
--- a/Modules/pyexpat.c
+++ b/Modules/pyexpat.c
@@ -1767,7 +1767,10 @@ struct ErrorInfo error_info_of[] = {
     {"XML_ERROR_NO_BUFFER", "a successful prior call to function XML_GetBuffer is required"},
 
     /* Added in 2.4.0. */
-    {"XML_ERROR_AMPLIFICATION_LIMIT_BREACH", "limit on input amplification factor (from DTD and entities) breached"}
+    {"XML_ERROR_AMPLIFICATION_LIMIT_BREACH", "limit on input amplification factor (from DTD and entities) breached"},
+
+    /* Added in 2.6.4. */
+    {"XML_ERROR_NOT_STARTED", "parser not started"},
 };
 
 static int
-- 
cgit v0.12