amoeba opened a new issue, #45003: URL: https://github.com/apache/arrow/issues/45003
### Describe the bug, including details regarding any error messages, version, and platform. The docstring for the [metadata method](https://arrow.apache.org/docs/python/generated/pyarrow.Schema.html#pyarrow.Schema.metadata) on the Schema class reports the return type as `dict` but it can also return `None` when no metadata has been set on the underlying Schema object. For example, ```python >>> import pyarrow as pa >>> schema = pa.schema([ ... pa.field('n_legs', pa.int64()), ... pa.field('animals', pa.string())]) >>> schema.metadata is None True ``` The docstring should be updated or this should return empty dict on None. It's probably worth doing a quick survey of similar methods to make sure this is consistent. ### Component(s) Documentation, Python -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@arrow.apache.org.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org