Reorganize examples (#507)

Co-authored-by: Samuel Colvin <[email protected]>

Author: dmontagu

.gitignore

@@ -10,6 +10,6 @@ env*/
 /TODO.md
 /postgres-data/
 .DS_Store
-/pydantic_ai_examples/.chat_app_messages.sqlite
+examples/pydantic_ai_examples/.chat_app_messages.sqlite
 .cache/
 .vscode/

docs/.hooks/main.py

@@ -48,11 +48,11 @@ def sub_run(m: re.Match[str]) -> str:
     ```"""
 
 
-EXAMPLES_DIR = Path(__file__).parent.parent.parent / 'pydantic_ai_examples'
+EXAMPLES_DIR = Path(__file__).parent.parent.parent / 'examples'
 
 
 def render_examples(markdown: str) -> str:
-    return re.sub(r'^#! *pydantic_ai_examples/(.+)', sub_example, markdown, flags=re.M)
+    return re.sub(r'^#! *examples/(.+)', sub_example, markdown, flags=re.M)
 
 
 def sub_example(m: re.Match[str]) -> str:

docs/examples/bank-support.md

@@ -19,5 +19,5 @@ python/uv-run -m pydantic_ai_examples.bank_support
 ## Example Code
 
 ```python {title="bank_support.py"}
-#! pydantic_ai_examples/bank_support.py
+#! examples/pydantic_ai_examples/bank_support.py
 ```

docs/examples/chat-app.md

@@ -30,17 +30,17 @@ TODO screenshot.
 Python code that runs the chat app:
 
 ```python {title="chat_app.py"}
-#! pydantic_ai_examples/chat_app.py
+#! examples/pydantic_ai_examples/chat_app.py
 ```
 
 Simple HTML page to render the app:
 
 ```html {title="chat_app.html"}
-#! pydantic_ai_examples/chat_app.html
+#! examples/pydantic_ai_examples/chat_app.html
 ```
 
 TypeScript to handle rendering the messages, to keep this simple (and at the risk of offending frontend developers) the typescript code is passed to the browser as plain text and transpiled in the browser.
 
 ```ts {title="chat_app.ts"}
-#! pydantic_ai_examples/chat_app.ts
+#! examples/pydantic_ai_examples/chat_app.ts
 ```

docs/examples/pydantic-model.md

@@ -26,5 +26,5 @@ PYDANTIC_AI_MODEL=gemini-1.5-pro python/uv-run -m pydantic_ai_examples.pydantic_
 ## Example Code
 
 ```python {title="pydantic_model.py"}
-#! pydantic_ai_examples/pydantic_model.py
+#! examples/pydantic_ai_examples/pydantic_model.py
 ```

docs/examples/rag.md

@@ -45,5 +45,5 @@ python/uv-run -m pydantic_ai_examples.rag search "How do I configure logfire to
 ## Example Code
 
 ```python {title="rag.py"}
-#! pydantic_ai_examples/rag.py
+#! examples/pydantic_ai_examples/rag.py
 ```

docs/examples/sql-gen.md

@@ -35,5 +35,5 @@ This model uses `gemini-1.5-flash` by default since Gemini is good at single sho
 ## Example Code
 
 ```python {title="sql_gen.py"}
-#! pydantic_ai_examples/sql_gen.py
+#! examples/pydantic_ai_examples/sql_gen.py
 ```

docs/examples/stream-markdown.md

@@ -17,5 +17,5 @@ python/uv-run -m pydantic_ai_examples.stream_markdown
 ## Example Code
 
 ```python
-#! pydantic_ai_examples/stream_markdown.py
+#! examples/pydantic_ai_examples/stream_markdown.py
 ```

docs/examples/stream-whales.md

@@ -22,5 +22,5 @@ Should give an output like this:
 ## Example Code
 
 ```python {title="stream_whales.py"}
-#! pydantic_ai_examples/stream_whales.py
+#! examples/pydantic_ai_examples/stream_whales.py
 ```

docs/examples/weather-agent.md

@@ -26,5 +26,5 @@ python/uv-run -m pydantic_ai_examples.weather_agent
 ## Example Code
 
 ```python {title="pydantic_ai_examples/weather_agent.py"}
-#! pydantic_ai_examples/weather_agent.py
+#! examples/pydantic_ai_examples/weather_agent.py
 ```