Avoid variable shadowing

Author: cpsievert

pkg-py/docs/CHANGELOG.md

@@ -19,6 +19,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * The current SQL query and title can now be programmatically set through the `.sql()` and `.title()` methods of `QueryChat()`. (#98, #101)
 
+* New `querychat.data` module provides sample datasets (`titanic()` and `tips()`) to make it easier to get started without external dependencies. (#118)
+
 * Added a `.generate_greeting()` method to help you create a greeting message for your querychat bot. (#87)
 
 * Added `querychat_reset_dashboard()` tool for easily resetting the dashboard filters when asked by the user. (#81)

pkg-py/docs/build.qmd

@@ -187,8 +187,7 @@ from shinywidgets import render_plotly
 from querychat.express import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 qc.sidebar()
 
 with ui.layout_columns():
@@ -227,8 +226,7 @@ from querychat.data import titanic
 from faicons import icon_svg
 import plotly.express as px
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 qc.sidebar()
 
 with ui.layout_column_wrap(fill=False):
@@ -358,10 +356,9 @@ from shiny.express import render, ui
 from querychat.express import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
 penguins = load_dataset("penguins")
 
-qc_titanic = QueryChat(titanic, "titanic")
+qc_titanic = QueryChat(titanic(), "titanic")
 qc_penguins = QueryChat(penguins, "penguins")
 
 with ui.sidebar():
@@ -400,12 +397,9 @@ from querychat.express import QueryChat
 from querychat.data import titanic
 import plotly.express as px
 
-# Load data
-titanic = titanic()
-
 # Create QueryChat
 qc = QueryChat(
-    titanic,
+    titanic(),
     "titanic",
     data_description="Titanic passenger data with survival outcomes",
 )

pkg-py/docs/context.qmd

@@ -14,9 +14,7 @@ For full visibility into the full system prompt that Querychat generates for the
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 print(qc.system_prompt)
 ```
 

pkg-py/docs/data-sources.qmd

@@ -162,10 +162,8 @@ import duckdb
 import pandas as pd
 from querychat.data import titanic
 
-titanic = titanic()
-
 conn = duckdb.connect("my_database.duckdb")
-conn.register('titanic_df', titanic)
+conn.register('titanic_df', titanic())
 conn.execute("""
     CREATE TABLE titanic AS
     SELECT * FROM titanic_df

pkg-py/docs/index.qmd

@@ -43,8 +43,7 @@ The quickest way to start chatting is to call the `.app()` method, which returns
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic", client="openai/gpt-4.1")
+qc = QueryChat(titanic(), "titanic", client="openai/gpt-4.1")
 app = qc.app()
 ```
 

pkg-py/docs/models.qmd

@@ -12,10 +12,8 @@ To use a particular model, pass a `"{provider}/{model}"` string to the `client`
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-
 qc = QueryChat(
-    titanic,
+    titanic(),
     "titanic",
     client="anthropic/claude-sonnet-4-5"
 )

pkg-py/docs/tools.qmd

@@ -25,8 +25,7 @@ Here's a basic example of this tool in action with the `.app()` method. Notice h
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 app = qc.app()
 ```
 
@@ -48,8 +47,7 @@ Here's an example of it in action:
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 app = qc.app()
 ```
 

pkg-py/examples/01-hello-app.py

@@ -1,6 +1,5 @@
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 app = qc.app()

pkg-py/examples/02-prompt-app.py

@@ -3,13 +3,11 @@
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-
 greeting = Path(__file__).parent / "greeting.md"
 data_desc = Path(__file__).parent / "data_description.md"
 
 qc = QueryChat(
-    titanic,
+    titanic(),
     "titanic",
     greeting=greeting,
     data_description=data_desc,

pkg-py/examples/03-sidebar-core-app.py

@@ -2,10 +2,8 @@
 from querychat import QueryChat
 from querychat.data import titanic
 
-titanic = titanic()
-
 # 1. Provide data source to QueryChat
-qc = QueryChat(titanic, "titanic")
+qc = QueryChat(titanic(), "titanic")
 
 app_ui = ui.page_sidebar(
     # 2. Create sidebar chat control