Merge remote-tracking branch 'origin/master' into documentation

Author: berendkleinhaneveld

.github/workflows/benchmark.yml

@@ -11,13 +11,13 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version-file: "pyproject.toml"
 
@@ -50,7 +50,7 @@ jobs:
 
       - name: Upload benchmarks
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: Benchmarks
           path: .benchmarks/

.github/workflows/ci.yml

@@ -15,11 +15,11 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version-file: "pyproject.toml"
       - name: Install only dev dependencies
@@ -47,11 +47,11 @@ jobs:
           - name: Linux py314
             pyversion: "3.14"
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Set up Python ${{ matrix.pyversion }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.pyversion }}
       - name: Install system dependencies
@@ -69,11 +69,11 @@ jobs:
     name: Test PyInstaller hooks
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version-file: "pyproject.toml"
       - name: Install dependencies
@@ -85,11 +85,11 @@ jobs:
     name: Build and test wheel
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Set up Python 3.10
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
       - name: Install dependencies
@@ -99,7 +99,7 @@ jobs:
       - name: Twine check
         run: uv run twine check dist/*
       - name: Upload wheel artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           path: dist
           name: dist
@@ -116,14 +116,14 @@ jobs:
       id-token: write
       contents: write
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v7
       - name: Download wheel artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist
       - name: Release to GitHub
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           files: |

README.md

@@ -75,6 +75,12 @@ Instead of using a python file as an entry point to run components, you can run
 uv run collagraph examples/pyside/counter.cgx
 ```
 
+To inspect the Python code that is compiled for a component, use the `--show-code` flag:
+
+```sh
+uv run collagraph --show-code examples/pyside/counter.cgx
+```
+
 For more examples, please take a look at the [examples folder](examples).
 
 Currently there are two renderers:

collagraph/__main__.py

@@ -81,6 +81,14 @@ def animate():
         breakpoint()  # noqa: T100
 
 
+def show_code(component_path: Path):
+    """Pretty print the Python code that is compiled for a component."""
+    from collagraph.sfc import print_source
+    from collagraph.sfc.compiler import generate_source
+
+    print_source(generate_source(component_path), component_path)
+
+
 def existing_component_file(value):
     path = Path(value)
     if not path.exists():
@@ -134,8 +142,17 @@ def run():
         action="store_true",
         help="Enable hot reloading (reload on file changes)",
     )
+    parser.add_argument(
+        "--show-code",
+        action="store_true",
+        help="Pretty print the compiled Python code for the component and exit",
+    )
     args = parser.parse_args()
 
+    if args.show_code:
+        show_code(args.component)
+        return
+
     init_collagraph(args.renderer, args.component, args.state, args.hot_reload)