Updated OpenGL rendering example to remove the distutils import

[nawedume]

Updated OpenGL rendering example to remove the distutils import and replace the functionality with the BooleanOptionalAction.

Closes #1204

Description

Before your PR is "Ready for review"

• [x ] All commits are signed-off to indicate that your contribution adheres to the Developer Certificate of Origin requirements
• [x ] Necessary tests have been added
• [ x] Documentation is up-to-date
• [ x] Auto-generated files modified by compiling Warp and building the documentation have been updated (e.g. __init__.pyi, docs/api_reference/, docs/language_reference/)
• [ x] Code passes formatting and linting checks with pre-commit run -a

Summary by CodeRabbit

• Bug Fixes
  • Command-line boolean flags for show_plot, split_up_tiles, and use_imgui now support both positive and negative forms (e.g., --flag and --no-flag), making CLI usage more consistent and user-friendly while preserving existing defaults and behavior.

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[coderabbitai]

📝 Walkthrough

Walkthrough

Replaces distutils-based boolean parsing with argparse.BooleanOptionalAction for three CLI flags in the OpenGL example to restore compatibility with Python 3.12; behavior, defaults, and control flow remain unchanged.

Changes

Cohort / File(s)	Summary
distutils removal fix warp/examples/core/example_render_opengl.py	Replaced distutils.util.strtobool parsing with argparse.BooleanOptionalAction for --show_plot, --split_up_tiles, and --use_imgui. Removed distutils import; CLI now accepts both --flag and --no-flag forms. No other behavior changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the main change: removing distutils import from the OpenGL example, which directly addresses the changeset.
Linked Issues check	✅ Passed	The PR successfully replaces distutils-based boolean parsing with argparse.BooleanOptionalAction, directly satisfying the objective stated in issue #1204 to restore Python 3.12 compatibility.
Out of Scope Changes check	✅ Passed	All changes are directly scoped to replacing distutils with argparse.BooleanOptionalAction in the OpenGL example, with no extraneous modifications introduced.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[greptile-apps]

Greptile Overview

Greptile Summary

Replaced deprecated distutils.util.strtobool with modern argparse.BooleanOptionalAction for three boolean command-line flags in the OpenGL rendering example.

Key Changes:

• Removed import distutils.util (deprecated in Python 3.10, removed in Python 3.12)
• Changed --show_plot, --split_up_tiles, and --use_imgui arguments from type=lambda x: bool(distutils.util.strtobool(x.strip())) to action=argparse.BooleanOptionalAction
• Improved CLI usability by supporting both positive (--flag) and negative (--no-flag) forms automatically

Impact:

• Fixes compatibility with Python 3.12+ where distutils has been removed
• Maintains backward compatibility with Python 3.9+ (BooleanOptionalAction introduced in 3.9)
• No functional changes to the example's behavior
• Enhanced user experience with more intuitive flag handling

Confidence Score: 5/5

• This PR is safe to merge with no concerns
• The change is a straightforward replacement of deprecated functionality with modern standard library features. BooleanOptionalAction is available in Python 3.9+ (project requires >=3.9), provides identical functionality to the previous implementation, and the change is limited to argument parsing with no impact on core logic
• No files require special attention

Important Files Changed

Filename	Overview
warp/examples/core/example_render_opengl.py	Removed deprecated distutils import and replaced with BooleanOptionalAction for three boolean CLI arguments

Sequence Diagram

sequenceDiagram
    participant User
    participant CLI as Command Line Interface
    participant ArgumentParser as argparse.ArgumentParser
    participant BooleanOptionalAction
    participant Example as Example Class
    
    User->>CLI: python example_render_opengl.py [args]
    CLI->>ArgumentParser: Parse arguments
    Note over ArgumentParser: Old: type=lambda x: bool(distutils.util.strtobool(x))
    Note over ArgumentParser: New: action=argparse.BooleanOptionalAction
    ArgumentParser->>BooleanOptionalAction: Handle --show_plot / --no-show_plot
    BooleanOptionalAction-->>ArgumentParser: Return boolean value
    ArgumentParser->>BooleanOptionalAction: Handle --split_up_tiles / --no-split_up_tiles
    BooleanOptionalAction-->>ArgumentParser: Return boolean value
    ArgumentParser->>BooleanOptionalAction: Handle --use_imgui / --no-use_imgui
    BooleanOptionalAction-->>ArgumentParser: Return boolean value
    ArgumentParser-->>CLI: Parsed args object
    CLI->>Example: Initialize with args (num_tiles, custom_tile_arrangement, use_imgui)
    Example-->>CLI: Example instance
    CLI->>Example: Run render loop

Loading

[greptile-apps]

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

[shi-eric]

Thanks for the fix, can you squash the changes down to a single commit?

[nawedume]

@shi-eric Squashed the commits.

[greptile-apps]

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}