Make _obj_repr public

[BENR0]

What is your issue?

We are using

xarray/xarray/core/formatting_html.py

Line 278 in 2971994

def _obj_repr(obj, header_components, sections):

in the html representation of AreaDefinitions in https://github.com/pytroll/pyresample and don't like to import private functions.
Would it be OK to make _obj_repr public?

[max-sixty]

Does anyone have an objection to this? Otherwise I think we'd accept a PR doing this?

[dcherian]

Does anyone have an objection to this?

I do. We should be free to freely change this stuff if/when we want to.

@BENR0 please copy this over if you like it :)

[BENR0]

@dcherian indeed we like it :-). We already discussed coping it over and decided not to in order to not repeat code and we think there is actually no need. We totally agree and understand that you want to retain freedom to change things and we are fine with it.

Just to add a little more context; what we basically want/do is the "official" html representation of a DataArray. The only reason we don't use the public

xarray/xarray/core/formatting_html.py

Line 300 in 2971994

def array_repr(arr) -> str:

is because we want to customize the header components and the sections a little bit.

I hope that this makes our intention a little bit clearer.
So in the unlikely case that any future changes of this should not be to our liking or should break something we would fix it on our side.

[dcherian]

we don't use the public

That isn't public either :) https://docs.xarray.dev/en/stable/getting-started-guide/faq.html#what-parts-of-xarray-are-considered-public-api