pagefind_site_indexing_via_npx_subprocess.py

1import subprocess
2import shutil
3import sys
4
5def run_pagefind(site_dir):
6    """
7    Official-style approach to running Pagefind from Python.
8    Since Pagefind is a compiled binary, the standard integration 
9    is via a subprocess call to the CLI.
10    """
11    
12    # 1. Ensure pagefind is installed (usually via npx or direct binary)
13    # This command indexes the folder specified in 'site_dir'
14    command = ["npx", "-y", "pagefind", "--site", site_dir]
15
16    try:
17        print(f"Running Pagefind on {site_dir}...")
18        result = subprocess.run(
19            command, 
20            check=True, 
21            capture_output=True, 
22            text=True
23        )
24        print("Pagefind Output:")
25        print(result.stdout)
26        print("Indexing complete. Search assets are in the 'pagefind' folder within your site directory.")
27        
28    except subprocess.CalledProcessError as e:
29        print(f"An error occurred while running Pagefind: {e.stderr}", file=sys.stderr)
30    except FileNotFoundError:
31        print("Error: 'npx' not found. Please ensure Node.js is installed.", file=sys.stderr)
32
33if __name__ == "__main__":
34    # Replace 'public' with your actual static site output directory
35    run_pagefind("public")