@davidhewitt:
TBH the #[name = ...] attribute is also undocumented; I was going to move it to #[pyo3(name = ...)] and add a guide section to document attributes better at the same time. If you like you can just open an issue to document #[pyo3(from_py_with)] and I'll do it at the same time.