class_docstr: Base class in ``setuptools`` warning hierarchy.
class_docstr_tok: ["Base","class","in","``","setuptools","``","warning","hierarchy","."]
docstr: Private: reserved for ``setuptools`` internal use only
docstr_tok: ["Private",":","reserved","for","``","setuptools","``","internal","use","only"]
code: def emit(
      cls,
      summary: Optional[str] = None,
      details: Optional[str] = None,
      due_date: Optional[_DueDate] = None,
      see_docs: Optional[str] = None,
      see_url: Optional[str] = None,
      stacklevel: int = 2,
      **kwargs,
  ):
      """Private: reserved for ``setuptools`` internal use only"""
      # Default values:
      summary_ = summary or getattr(cls, "_SUMMARY", None) or ""
      details_ = details or getattr(cls, "_DETAILS", None) or ""
      due_date = due_date or getattr(cls, "_DUE_DATE", None)
      docs_ref = see_docs or getattr(cls, "_SEE_DOCS", None)
      docs_url = (
          docs_ref
          and f"https://setuptools.pypa.io/en/latest/{docs_ref}"
      )
      see_url = see_url or getattr(cls, "_SEE_URL", None)
      due = date(*due_date) if due_date else None
  
      text = cls._format(
          summary_, details_, due, see_url or docs_url, kwargs
      )
      if due and due < date.today() and _should_enforce():
          raise cls(text)
      warnings.warn(text, cls, stacklevel=stacklevel + 1)
  
file_path: catboost/contrib/python/setuptools/py3/setuptools/warnings.py
imports: import os
  import warnings
  from datetime import date
  from inspect import cleandoc
  from textwrap import indent
  from typing import Optional, Tuple
label_desc: Use image node_id 1 for calling the SetuptoolsWarning obj's underlying member method code with example usage: obj.emit(cls, summary, details, due_date, see_docs, see_url, stacklevel) without return types