[C++][Python] Deprecate and rename add_metadata methods #19152
Description
Deprecate and replace pyarrow.Field.add_metadata (and other likely named methods) with replace_metadata, set_metadata or with_metadata. Knowing Spark's immutable API, I would have chosen with_metadata but I guess this is probably not what the average Python user would expect as naming.
Reporter: Krisztian Szucs / @kszucs
Assignee: Krisztian Szucs / @kszucs
PRs and other links:
Note: This issue was originally created as ARROW-2769. Please see the migration documentation for further details.