Document and export MISSING sentinel

3 years ago · 500bf77103
2 changed files with 9 additions and 0 deletions
--- a/discord/utils.py
+++ b/discord/utils.py
@ -88,12 +88,15 @@ __all__ = (
    'escape_mentions',
    'as_chunks',
    'format_dt',
+    'MISSING',
 )

 DISCORD_EPOCH = 1420070400000


 class _MissingSentinel:
+    __slots__ = ()
+
    def __eq__(self, other):
        return False

--- a/docs/api.rst
+++ b/docs/api.rst
@ -1311,6 +1311,12 @@ Utility Functions

 .. autofunction:: discord.utils.as_chunks

+.. data:: MISSING
+
+    A type safe sentinel used in the library to represent something as missing. Used to distinguish from ``None`` values.
+
+    .. versionadded:: 2.0
+
 .. _discord-api-enums:

 Enumerations