Roadmap to maturity

[almarklein]

This is a meta-issue that lists the needed work to get to a 1.0 level maturity.
Note that we cannot call the API "stable" until the WebGPU spec is final.

General:

• Ongoing work to keep up with changes to the WebGPU spec.
• Ongoing work to keep up with changes to wgpu-native.
• Adopting best practices from https://scientific-python.org/specs/

API improvements / changes:

• First class async support #391
• Allow using structs as API #425
• Using context managers #394

API completeness:

• Render bundles.
• Occlusion queries.
• Debug markers.
• A bunch of optional arguments in webGPU methods that wgpu-native does not expose yet.

GUI support:

• WindowManager: Linux Wayland support rendercanvas#36
• Supporting JS/webgpu as a backend for e.g. PyScript #407
  • Not strictly necessary, but interesting nonetheless.
• Support for Raspberry Pi (and other linux_arm64) #187
  • Not sure how necessary this is, but it's a valid use-case I suppose.

Testing:

• Units tests to cover 100% of the API.
• More examples, as coverage, but also to demonstrate the use of certain features.

Documentation:

• Improve the guide.
• Tutorials.

[Vipitis]

I think a good goal will be to never panic and lose the python process. Always crash gracefully and raise some kind of Exception. There is some open issue for this in wgpu-native too

[Korijn]

I think a good goal will be to never panic and lose the python process. Always crash gracefully and raise some kind of Exception. There is some open issue for this in wgpu-native too

You're right! We talked about this before with you. See #171