class_docstr: The abstract base class that all Streamlit Connections must inherit from.
  
  This base class provides connection authors with a standardized way to hook into the
  ``st.connection()`` factory function: connection authors are required to provide an
  implementation for the abstract method ``_connect`` in their subclasses.
  
  Additionally, it also provides a few methods/properties designed to make
  implementation of connections more convenient. See the docstrings for each of the
  methods of this class for more information
  
  .. note::
      While providing an implementation of ``_connect`` is technically all that's
      required to define a valid connection, connections should also provide the user
      with context-specific ways of interacting with the underlying connection object.
      For example, the first-party SQLConnection provides a ``query()`` method for
      reads and a ``session`` property for more complex operations.
class_docstr_tok: ["The","abstract","base","class","that","all","Streamlit","Connections","must","inherit","from",".","This","base","class","provides","connection","authors","with","a","standardized","way","to","hook","into","the","``","st.connection","(",")","``","factory","function",":","connection","authors","are","required","to","provide","an","implementation","for","the","abstract","method","``","_connect","``","in","their","subclasses",".","Additionally",",","it","also","provides","a","few","methods\/properties","designed","to","make","implementation","of","connections","more","convenient",".","See","the","docstrings","for","each","of","the","methods","of","this","class","for","more","information","..","note",":",":","While","providing","an","implementation","of","``","_connect","``","is","technically","all","that's","required","to","define","a","valid","connection",",","connections","should","also","provide","the","user","with","context-specific","ways","of","interacting","with","the","underlying","connection","object",".","For","example",",","the","first-party","SQLConnection","provides","a","``","query","(",")","``","method","for","reads","and","a","``","session","``","property","for","more","complex","operations","."]
docstr: Return a human-friendly markdown string describing this connection.
  
  This is the string that will be written to the app if a user calls
  ``st.write(this_connection)``. Subclasses of BaseConnection can freely overwrite
  this method if desired.
  
  Returns
  -------
  str
docstr_tok: ["Return","a","human-friendly","markdown","string","describing","this","connection",".","This","is","the","string","that","will","be","written","to","the","app","if","a","user","calls","``","st.write","(","this_connection",")","``",".","Subclasses","of","BaseConnection","can","freely","overwrite","this","method","if","desired",".","Returns","--","--","--","-","str"]
code: def _repr_html_(self) -> str:
      """Return a human-friendly markdown string describing this connection.
  
      This is the string that will be written to the app if a user calls
      ``st.write(this_connection)``. Subclasses of BaseConnection can freely overwrite
      this method if desired.
  
      Returns
      -------
      str
      """
      module_name = getattr(self, "__module__", None)
      class_name = type(self).__name__
  
      cfg = (
          f"- Configured from `[connections.{self._connection_name}]`"
          if len(self._secrets)
          else ""
      )
  
      return f"""
  ---
  **st.connection {self._connection_name} built from `{module_name}.{class_name}`**
  {cfg}
  - Learn more using `st.help()`
  ---
  """
  
file_path: streamlit/lib/streamlit/connections/base_connection.py
imports: import json
  from abc import ABC, abstractmethod
  from typing import Any, Generic, Optional, TypeVar
  from streamlit.runtime.secrets import AttrDict, secrets_singleton
  from streamlit.util import calc_md5
label_desc: Use image node_id 4 for calling the BaseConnection obj's underlying member method code with example usage: obj._repr_html_() and returns: str, self, str, module_name, str, class_name, str, cfg, str