docstr: Display a horizontal rule.
  
  .. note::
      You can achieve the same effect with st.write("---") or
      even just "---" in your script (via magic).
  
  Example
  -------
  >>> import streamlit as st
  >>>
  >>> st.divider()
code: def divider(self) -> "DeltaGenerator":
      """Display a horizontal rule.
  
      .. note::
          You can achieve the same effect with st.write("---") or
          even just "---" in your script (via magic).
  
      Example
      -------
      >>> import streamlit as st
      >>>
      >>> st.divider()
  
      """
      divider_proto = MarkdownProto()
      divider_proto.body = MARKDOWN_HORIZONTAL_RULE_EXPRESSION
      divider_proto.element_type = MarkdownProto.Type.DIVIDER
      return self.dg._enqueue("markdown", divider_proto)
  
file_path: streamlit/lib/streamlit/elements/markdown.py
imports: from typing import TYPE_CHECKING, Optional, Union, cast
  from streamlit.proto.Markdown_pb2 import Markdown
  from streamlit.runtime.metrics_util import gather_metrics
  from streamlit.string_util import clean_text
  from streamlit.type_util import SupportsStr, is_sympy_expession
label_desc: Use image node_id 5 for calling the MarkdownMixin obj's underlying member method code with example usage: obj.divider() and returns: self