feat: add query_hierarchy

[ManonMarchand]

Hello astroquery maintainers 🙂 !

In the former API, we had two fields membership and link_bibcode that would hint whether the object had parents. I did not replace those in the rewrite from #2954 as I didn't find them easy to use, and they did not have a direct equivalent in the relational schema.

This PR, adds a new query method query_hierarchy to replace them. The behavior is based on what people can see on the webpages in the hierarchy section. You can either ask for parents, children, or siblings of the object.

Ex on NGC4038's page:

The two fields from before (membership and link_bibcode) are only returned if the users ask for them with the argument detailed_hierarchy. This is toggled off by default as it has a tendency of duplicating the results a lot (see the example in the new documentation section).

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Please upload report for BASE (main@94dbe5c). Learn more about missing BASE report.
Report is 3 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3175   +/-   ##
=======================================
  Coverage        ?   67.72%           
=======================================
  Files           ?      229           
  Lines           ?    18388           
  Branches        ?        0           
=======================================
  Hits            ?    12453           
  Misses          ?     5935           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[keflavich]

This looks great! I read through the code and docs, and it looks solid. This is a neat addition!

[ManonMarchand]

Thanks!
Since your approval I amended the commit for tiny docs modifs and to improve the coverage

[bsipocz]

Thanks @ManonMarchand!