New NOTE: ... comments call out base_path settings as something
considered problematic, as they've hampered us in the past.
Removing them is a significant breaking change, and as class
attributes, they would require a more elaborate deprecation strategy
if we wanted to have them actually issue deprecation warnings.
Limiting ourselves to a comment for now helps authors know not to use
base_path for new classes without having to solve how we can
actually deprecate and remove the setting.
New
NOTE: ...comments call outbase_pathsettings as something considered problematic, as they've hampered us in the past.Removing them is a significant breaking change, and as class attributes, they would require a more elaborate deprecation strategy if we wanted to have them actually issue deprecation warnings.
Limiting ourselves to a comment for now helps authors know not to use
base_pathfor new classes without having to solve how we can actually deprecate and remove the setting.📚 Documentation preview 📚: https://globus-sdk-python--1097.org.readthedocs.build/en/1097/