docs: added documentation

Author: moneebullah25

Doc/library/base64.rst

@@ -72,7 +72,7 @@ POST request.
       Added the *wrapcol* parameter.
 
 
-.. function:: b64decode(s, altchars=None, validate=False)
+.. function:: b64decode(s, altchars=None, validate=False, *, ignorechars=None)
 
    Decode the Base64 encoded :term:`bytes-like object` or ASCII string
    *s* and return the decoded :class:`bytes`.
@@ -90,10 +90,19 @@ POST request.
    these non-alphabet characters in the input result in a
    :exc:`binascii.Error`.
 
+   Optional *ignorechars* must be a :term:`bytes-like object` specifying
+   characters to ignore during decoding. When provided, only characters in
+   this set will be silently ignored; other non-base64 characters will cause
+   a :exc:`binascii.Error`. When ``None`` (the default), the behavior is
+   controlled by the *validate* parameter.
+
    For more information about the strict base64 check, see :func:`binascii.a2b_base64`
 
    May assert or raise a :exc:`ValueError` if the length of *altchars* is not 2.
 
+   .. versionchanged:: next
+      Added the *ignorechars* parameter.
+
 .. function:: standard_b64encode(s)
 
    Encode :term:`bytes-like object` *s* using the standard Base64 alphabet

Doc/library/binascii.rst

@@ -48,7 +48,7 @@ The :mod:`binascii` module defines the following functions:
       Added the *backtick* parameter.
 
 
-.. function:: a2b_base64(string, /, *, strict_mode=False)
+.. function:: a2b_base64(string, /, *, strict_mode=False, ignorechars=None)
 
    Convert a block of base64 data back to binary and return the binary data. More
    than one line may be passed at a time.
@@ -63,9 +63,18 @@ The :mod:`binascii` module defines the following functions:
    * Contains no excess data after padding (including excess padding, newlines, etc.).
    * Does not start with a padding.
 
+   Optional *ignorechars* must be a :term:`bytes-like object` specifying
+   characters to ignore during decoding. When provided, only characters in
+   this set will be silently ignored; other non-base64 characters will cause
+   an error. When ``None`` (the default), all non-base64 characters are
+   silently ignored (unless *strict_mode* is true).
+
    .. versionchanged:: 3.11
       Added the *strict_mode* parameter.
 
+   .. versionchanged:: next
+      Added the *ignorechars* parameter.
+
 
 .. function:: b2a_base64(data, *, wrapcol=0, newline=True)
 

Doc/whatsnew/3.15.rst

@@ -444,13 +444,19 @@ base64
 * Added the *wrapcol* parameter in :func:`~base64.b64encode`.
   (Contributed by Serhiy Storchaka in :gh:`143214`.)
 
+* Added the *ignorechars* parameter in :func:`~base64.b64decode`.
+  (Contributed by Muneeb Ullah in :gh:`144001`.)
+
 
 binascii
 --------
 
 * Added the *wrapcol* parameter in :func:`~binascii.b2a_base64`.
   (Contributed by Serhiy Storchaka in :gh:`143214`.)
 
+* Added the *ignorechars* parameter in :func:`~binascii.a2b_base64`.
+  (Contributed by Muneeb Ullah in :gh:`144001`.)
+
 
 calendar
 --------