Copy in existing example app and add title to each file

Author: schloerke

src/posit/connect/external/databricks.py

@@ -1,15 +1,17 @@
+"""
+Databricks SDK credentials implementations which support interacting with Posit OAuth integrations on Connect.
+
+NOTE: These APIs are provided as a convenience and are subject to breaking changes:
+https://github.com/databricks/databricks-sdk-py#interface-stability
+"""
+
 import abc
 from typing import Callable, Dict, Optional
 
 from ..client import Client
 from ..oauth import Credentials
 from .external import is_local
 
-"""
-NOTE: These APIs are provided as a convenience and are subject to breaking changes:
-https://github.com/databricks/databricks-sdk-py#interface-stability
-"""
-
 POSIT_OAUTH_INTEGRATION_AUTH_TYPE = "posit-oauth-integration"
 
 # The Databricks SDK CredentialsProvider == Databricks SQL HeaderFactory

src/posit/connect/external/snowflake.py

@@ -1,14 +1,65 @@
+"""Snowflake SDK credentials implementations which support interacting with Posit OAuth integrations on Connect.
+
+NOTE: The APIs in this module are provided as a convenience and are subject to breaking changes.
+"""
+
 from typing import Optional
 
 from ..client import Client
 from .external import is_local
 
-"""
-NOTE: The APIs in this module are provided as a convenience and are subject to breaking changes.
-"""
-
 
 class PositAuthenticator:
+    """
+    Authenticator for Snowflake SDK which supports Posit OAuth integrations on Connect.
+
+    Examples
+    --------
+    ```python
+    import os
+
+    import pandas as pd
+    import snowflake.connector
+    import streamlit as st
+
+    from posit.connect.external.snowflake import PositAuthenticator
+
+    ACCOUNT = os.getenv("SNOWFLAKE_ACCOUNT")
+    WAREHOUSE = os.getenv("SNOWFLAKE_WAREHOUSE")
+
+    # USER is only required when running the example locally with external browser auth
+    USER = os.getenv("SNOWFLAKE_USER")
+
+    # https://docs.snowflake.com/en/user-guide/sample-data-using
+    DATABASE = os.getenv("SNOWFLAKE_DATABASE", "snowflake_sample_data")
+    SCHEMA = os.getenv("SNOWFLAKE_SCHEMA", "tpch_sf1")
+    TABLE = os.getenv("SNOWFLAKE_TABLE", "lineitem")
+
+    session_token = st.context.headers.get("Posit-Connect-User-Session-Token")
+    auth = PositAuthenticator(
+        local_authenticator="EXTERNALBROWSER", user_session_token=session_token
+    )
+
+    con = snowflake.connector.connect(
+        user=USER,
+        account=ACCOUNT,
+        warehouse=WAREHOUSE,
+        database=DATABASE,
+        schema=SCHEMA,
+        authenticator=auth.authenticator,
+        token=auth.token,
+    )
+
+    snowflake_user = con.cursor().execute("SELECT CURRENT_USER()").fetchone()
+    st.write(f"Hello, {snowflake_user[0]}!")
+
+    with st.spinner("Loading data from Snowflake..."):
+        df = pd.read_sql_query(f"SELECT * FROM {TABLE} LIMIT 10", con)
+
+    st.dataframe(df)
+    ```
+    """
+
     def __init__(
         self,
         local_authenticator: Optional[str] = None,