[Python] Change the base directory for PyArrow CPP header files

[asfimport]

It would be desired to move the include paths for PyArrow C++ from "arrow/python/.." to "pyarrow/.." . That would be a bigger change in the PyArrow C++ API and would need a deprecation period.

Also, we might want to change the namespaces from {}arrow{}&{}python{} to {}pyarrow{}.

Reporter: Alenka Frim / @AlenkaF

_{Note: This issue was originally created as ARROW-17958. Please see the migration documentation for further details.}

[thisisnic]

This issue has been marked as stale because it has had no activity in the past 2 years. Please remove the stale label or comment below, or this issue will be closed in 14 days.