Pyodide in Practice

Running Python in the Browser with WebAssembly: From Fundamentals to Production

Introduction: Python in the Browser

1. The Problem Pyodide Solves
2. What Is Pyodide? A Brief History
3. Real-World Use Cases and Who Should Care
4. How This Book Is Organized

Chapter 1: WebAssembly Fundamentals for Pyodide

1. What Is WebAssembly and Why Does It Matter?
2. How WebAssembly Runs in Browsers
3. Emscripten: The Bridge from CPython to WebAssembly
4. WebAssembly Memory Model and Its Implications
5. Performance Characteristics of WebAssembly
6. Summary

Chapter 2: Getting Started with Pyodide

1. Your First Pyodide Page via CDN
2. Interactive REPL Example
3. Installing Pyodide with npm for Modern Projects
4. Running Pyodide in Node.js
5. Understanding the Initialization Process
6. Common First-Time Setup Pitfalls
7. Summary

Chapter 3: Pyodide Architecture and Runtime

1. CPython Compiled to WebAssembly
2. The Pyodide Runtime Initialization Sequence
3. Memory Layout: WASM Heap and Python Objects
4. The Execution Model and Event Loop Integration
5. Versioning and the Road to CPython Tier 3 Status
6. Summary

Chapter 4: JavaScript–Python Interoperability

1. The Foreign Function Interface Overview
2. Implicit Type Conversions Between Languages
3. JsProxy: Accessing JavaScript from Python
4. PyProxy: Passing Python Objects to JavaScript
5. Calling Functions Across the Boundary
6. Memory Management and Preventing Leaks
7. Summary

Chapter 5: Package Management in Pyodide

1. What Comes Built Into Pyodide?
2. Loading Official Packages with loadPackage
3. Using micropip for PyPI Packages
4. Custom Wheel URLs and CORS Requirements
5. Dependency Resolution and Optimization Strategies
6. Summary

Chapter 6: Filesystems and I/O Operations

1. The Virtual Filesystem Concept
2. MEMFS: In-Memory Files by Default
3. Persistent Storage with IDBFS
4. Mounting Other Filesystems (NODEFS, PROXYFS)
5. Working with Binary Data and Buffers
6. Summary

Chapter 7: Asynchronous Programming Patterns

1. Asyncio in a Single-Threaded Environment
2. The WebLoop Event Loop Implementation
3. runPythonAsync and Top-Level Await
4. Coordinating Python Coroutines with JavaScript Promises
5. JavaScript Promise Integration (JSPI) Support
6. Summary

Chapter 8: Browser APIs and Web Integration

1. Accessing the DOM via the js Module
2. Canvas Rendering and Graphics
3. Handling Browser Events from Python
4. LocalStorage and SessionStorage Integration
5. Custom JavaScript Modules for Python
6. Summary

Chapter 9: Data Handling and Visualization

1. Loading the Scientific Stack
2. Working with NumPy Arrays Efficiently
3. DataFrame Operations with Pandas
4. Rendering Matplotlib Plots in the Browser
5. Zero-Copy Data Transfer Between Python and JavaScript
6. Summary

Chapter 10: Networking, HTTP, and Serverless Patterns

1. Making HTTP Requests with pyfetch
2. Handling CORS and Browser Security Policies
3. Synchronous vs Asynchronous HTTP Patterns
4. Running Python on the Edge with Cloudflare Workers
5. Designing Serverless Architectures with Pyodide
6. Summary

Chapter 11: Performance Optimization Techniques

1. Understanding Pyodide’s Performance Profile
2. Reducing Initial Load Time and Bundle Size
3. Memory Management Best Practices
4. Using Web Workers to Avoid UI Blocking
5. Optimizing Data Transfer Across the Boundary
6. Summary

Chapter 12: Debugging and Development Workflow

1. Console Logging and Basic Error Handling
2. Understanding Python Errors in the Browser
3. Debugging JavaScript–Python Boundary Issues
4. Advanced WebAssembly Debugging Techniques
5. Development Tools and Build Configurations
6. Summary

Chapter 13: Security Considerations

1. The WebAssembly Sandbox Model
2. Content Security Policy Configuration
3. Trust Boundaries Between JavaScript and Python
4. Running Untrusted Code Safely
5. Common Security Pitfalls and Mitigations
6. Summary

Chapter 14: Packaging, Deployment, and Production Patterns

1. Self-Hosting vs CDN Distribution
2. Working with Bundlers (Vite, Webpack, etc.)
3. Integration with React, Vue, and Svelte
4. Building Custom Pyodide Packages with pyodide-build
5. Production Monitoring and Error Tracking
6. Summary

Chapter 15: Limitations, Trade-offs, and the Future

1. Unsupported Standard Library Modules
2. Threading, Multiprocessing, and Concurrency Limits
3. Memory Constraints and Large Data Workloads
4. When Not to Use Pyodide
5. The Road Ahead: CPython Integration and Beyond
6. Summary

Conclusion

References