Skip to content

Commit 4c01f17

Browse files
docs: Re-execute notebooks with TLS disabled, add execution script
- Re-run all notebooks against PostgreSQL with DJ_USE_TLS=false - Removes SSL connection warning from notebook outputs - Add scripts/execute-notebooks.sh for reproducible notebook execution Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 074281a commit 4c01f17

22 files changed

Lines changed: 8613 additions & 5205 deletions

scripts/execute-notebooks.sh

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
#!/bin/bash
2+
# Execute all tutorial notebooks with outputs saved
3+
# Uses PostgreSQL backend with TLS disabled to avoid SSL warnings in output
4+
5+
set -e
6+
7+
cd "$(dirname "$0")/.."
8+
9+
# Database connection settings for PostgreSQL
10+
export DJ_HOST=localhost
11+
export DJ_PORT=5432
12+
export DJ_USER=postgres
13+
export DJ_PASS=tutorial
14+
export DJ_BACKEND=postgresql
15+
export DJ_USE_TLS=false
16+
17+
echo "Executing tutorials with PostgreSQL backend..."
18+
echo " Host: $DJ_HOST:$DJ_PORT"
19+
echo " User: $DJ_USER"
20+
echo " Backend: $DJ_BACKEND"
21+
echo " TLS: disabled"
22+
echo ""
23+
24+
# Execute all tutorial notebooks
25+
echo "Executing basics tutorials..."
26+
jupyter nbconvert --to notebook --execute --inplace src/tutorials/basics/*.ipynb
27+
28+
echo "Executing advanced tutorials..."
29+
jupyter nbconvert --to notebook --execute --inplace src/tutorials/advanced/*.ipynb
30+
31+
echo "Executing domain tutorials..."
32+
for dir in src/tutorials/domain/*/; do
33+
echo " Executing $dir..."
34+
jupyter nbconvert --to notebook --execute --inplace "$dir"*.ipynb
35+
done
36+
37+
echo "Executing how-to notebooks..."
38+
jupyter nbconvert --to notebook --execute --inplace src/how-to/*.ipynb
39+
40+
echo ""
41+
echo "All notebooks executed successfully!"

src/how-to/model-relationships.ipynb

Lines changed: 423 additions & 417 deletions
Large diffs are not rendered by default.

src/how-to/read-diagrams.ipynb

Lines changed: 365 additions & 359 deletions
Large diffs are not rendered by default.

src/tutorials/advanced/custom-codecs.ipynb

Lines changed: 40 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@
99
"\n",
1010
"This tutorial covers extending DataJoint's type system. You'll learn:\n",
1111
"\n",
12-
"- **Codec basics** \u2014 Encoding and decoding\n",
13-
"- **Creating codecs** \u2014 Domain-specific types\n",
14-
"- **Codec chaining** \u2014 Composing codecs"
12+
"- **Codec basics** Encoding and decoding\n",
13+
"- **Creating codecs** Domain-specific types\n",
14+
"- **Codec chaining** Composing codecs"
1515
]
1616
},
1717
{
@@ -20,22 +20,28 @@
2020
"id": "cell-1",
2121
"metadata": {
2222
"execution": {
23-
"iopub.execute_input": "2026-01-17T06:49:01.002998Z",
24-
"iopub.status.busy": "2026-01-17T06:49:01.002467Z",
25-
"iopub.status.idle": "2026-01-17T06:49:01.702707Z",
26-
"shell.execute_reply": "2026-01-17T06:49:01.702371Z"
23+
"iopub.execute_input": "2026-01-23T04:53:29.084329Z",
24+
"iopub.status.busy": "2026-01-23T04:53:29.084219Z",
25+
"iopub.status.idle": "2026-01-23T04:53:30.388323Z",
26+
"shell.execute_reply": "2026-01-23T04:53:30.388028Z"
2727
}
2828
},
2929
"outputs": [
3030
{
3131
"name": "stderr",
3232
"output_type": "stream",
3333
"text": [
34-
"[2026-01-17 00:49:01,696][INFO]: DataJoint 2.0.0a22 connected to root@127.0.0.1:3306\n"
34+
"[2026-01-22 22:53:30,380][INFO]: DataJoint 2.1.0a5 connected to postgres@localhost:5432\n"
3535
]
3636
}
3737
],
38-
"source": "import datajoint as dj\n\nimport numpy as np\n\nschema = dj.Schema('tutorial_codecs')"
38+
"source": [
39+
"import datajoint as dj\n",
40+
"\n",
41+
"import numpy as np\n",
42+
"\n",
43+
"schema = dj.Schema('tutorial_codecs')"
44+
]
3945
},
4046
{
4147
"cell_type": "markdown",
@@ -51,10 +57,10 @@
5157
"id": "cell-3",
5258
"metadata": {
5359
"execution": {
54-
"iopub.execute_input": "2026-01-17T06:49:01.704665Z",
55-
"iopub.status.busy": "2026-01-17T06:49:01.704433Z",
56-
"iopub.status.idle": "2026-01-17T06:49:01.707529Z",
57-
"shell.execute_reply": "2026-01-17T06:49:01.707241Z"
60+
"iopub.execute_input": "2026-01-23T04:53:30.390163Z",
61+
"iopub.status.busy": "2026-01-23T04:53:30.389939Z",
62+
"iopub.status.idle": "2026-01-23T04:53:30.392913Z",
63+
"shell.execute_reply": "2026-01-23T04:53:30.392560Z"
5864
}
5965
},
6066
"outputs": [],
@@ -89,10 +95,10 @@
8995
"id": "cell-4",
9096
"metadata": {
9197
"execution": {
92-
"iopub.execute_input": "2026-01-17T06:49:01.708846Z",
93-
"iopub.status.busy": "2026-01-17T06:49:01.708757Z",
94-
"iopub.status.idle": "2026-01-17T06:49:01.742122Z",
95-
"shell.execute_reply": "2026-01-17T06:49:01.741793Z"
98+
"iopub.execute_input": "2026-01-23T04:53:30.394349Z",
99+
"iopub.status.busy": "2026-01-23T04:53:30.394156Z",
100+
"iopub.status.idle": "2026-01-23T04:53:30.413081Z",
101+
"shell.execute_reply": "2026-01-23T04:53:30.412648Z"
96102
}
97103
},
98104
"outputs": [],
@@ -112,10 +118,10 @@
112118
"id": "cell-5",
113119
"metadata": {
114120
"execution": {
115-
"iopub.execute_input": "2026-01-17T06:49:01.743733Z",
116-
"iopub.status.busy": "2026-01-17T06:49:01.743619Z",
117-
"iopub.status.idle": "2026-01-17T06:49:01.756660Z",
118-
"shell.execute_reply": "2026-01-17T06:49:01.756367Z"
121+
"iopub.execute_input": "2026-01-23T04:53:30.414770Z",
122+
"iopub.status.busy": "2026-01-23T04:53:30.414671Z",
123+
"iopub.status.idle": "2026-01-23T04:53:30.428507Z",
124+
"shell.execute_reply": "2026-01-23T04:53:30.428210Z"
119125
}
120126
},
121127
"outputs": [
@@ -179,10 +185,10 @@
179185
"id": "cell-8",
180186
"metadata": {
181187
"execution": {
182-
"iopub.execute_input": "2026-01-17T06:49:01.758250Z",
183-
"iopub.status.busy": "2026-01-17T06:49:01.758075Z",
184-
"iopub.status.idle": "2026-01-17T06:49:01.761089Z",
185-
"shell.execute_reply": "2026-01-17T06:49:01.760722Z"
188+
"iopub.execute_input": "2026-01-23T04:53:30.430015Z",
189+
"iopub.status.busy": "2026-01-23T04:53:30.429913Z",
190+
"iopub.status.idle": "2026-01-23T04:53:30.432921Z",
191+
"shell.execute_reply": "2026-01-23T04:53:30.432574Z"
186192
}
187193
},
188194
"outputs": [],
@@ -214,10 +220,10 @@
214220
"id": "cell-9",
215221
"metadata": {
216222
"execution": {
217-
"iopub.execute_input": "2026-01-17T06:49:01.762505Z",
218-
"iopub.status.busy": "2026-01-17T06:49:01.762406Z",
219-
"iopub.status.idle": "2026-01-17T06:49:01.791610Z",
220-
"shell.execute_reply": "2026-01-17T06:49:01.791308Z"
223+
"iopub.execute_input": "2026-01-23T04:53:30.434354Z",
224+
"iopub.status.busy": "2026-01-23T04:53:30.434236Z",
225+
"iopub.status.idle": "2026-01-23T04:53:30.451471Z",
226+
"shell.execute_reply": "2026-01-23T04:53:30.451175Z"
221227
}
222228
},
223229
"outputs": [
@@ -251,10 +257,10 @@
251257
"id": "cell-10",
252258
"metadata": {
253259
"execution": {
254-
"iopub.execute_input": "2026-01-17T06:49:01.793037Z",
255-
"iopub.status.busy": "2026-01-17T06:49:01.792915Z",
256-
"iopub.status.idle": "2026-01-17T06:49:01.803053Z",
257-
"shell.execute_reply": "2026-01-17T06:49:01.802640Z"
260+
"iopub.execute_input": "2026-01-23T04:53:30.453240Z",
261+
"iopub.status.busy": "2026-01-23T04:53:30.453107Z",
262+
"iopub.status.idle": "2026-01-23T04:53:30.456776Z",
263+
"shell.execute_reply": "2026-01-23T04:53:30.456516Z"
258264
}
259265
},
260266
"outputs": [],
@@ -284,4 +290,4 @@
284290
},
285291
"nbformat": 4,
286292
"nbformat_minor": 5
287-
}
293+
}

0 commit comments

Comments
 (0)