Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

A better name for the ".virtualize" accessor? #241

Open
TomNicholas opened this issue Sep 25, 2024 · 2 comments
Open

A better name for the ".virtualize" accessor? #241

TomNicholas opened this issue Sep 25, 2024 · 2 comments
Labels
documentation Improvements or additions to documentation

Comments

@TomNicholas
Copy link
Collaborator

I'm not super happy with the vds.virtualize.to_<format> accessor name. It's confusing - really the "virtualize" accessor doesn't "virtualize" anything, the references are already virtual, it just allows you to write them out somewhere.

A better name might be .serialize.to_<format> or even just .write.to_<format> (as these methods correspond to virtualizarr "writers"). The problem with those names is that they don't really indicate that you're about to enter a virtualizarr-specific namespace. But then again if you attempt to call ds.virtualize.to_<format>() on a non-virtual dataset you will get a clear error anyway.

See also #239. This is also a manifestation of #171.

@TomNicholas TomNicholas added the documentation Improvements or additions to documentation label Sep 25, 2024
@keewis
Copy link
Contributor

keewis commented Sep 25, 2024

I wonder whether we should try to instead find a summarizing name (virtualizarr, for example) instead of more specific ones like serialize or write? That way, we don't have to try to describe what is in the namespace (you probably won't find a name for the writers that, at the same time, fits the rename_paths method).

@TomNicholas
Copy link
Collaborator Author

That's a very good point @keewis - I forgot about the rename_paths method. Yeah having virtualizarr instead of virtualize would be a minor improvement, as the verb virtualize is misleading and unneccessary here.

@TomNicholas TomNicholas changed the title A better name for the ".virtualize" writing accessor? A better name for the ".virtualize" accessor? Sep 25, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants