-
-
Notifications
You must be signed in to change notification settings - Fork 405
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
Esa documentation cleanup #1970
Conversation
Codecov Report
@@ Coverage Diff @@
## main #1970 +/- ##
==========================================
- Coverage 62.92% 62.91% -0.02%
==========================================
Files 133 133
Lines 17302 17307 +5
==========================================
+ Hits 10888 10889 +1
- Misses 6414 6418 +4
📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more |
@ceb8 - could you squash the 4th (file deleting commit) into the 3rd one, to avoid the files showing up in the history in the first place? |
Done. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some comments that can potentially be addressed. However I would not hold the PR up from merging for everything to be addressed as tests already pass and this is already a nice improvement on the status quo.
@@ -20,15 +20,17 @@ Examples | |||
1. Getting Herschel data | |||
------------------------ | |||
|
|||
.. doctest-remote-data:: | |||
.. Skipping becuase of how long the download takes |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wonder whether it's possible to identify an observation_id that is much smaller, for here and below? cc @jespinosaar
@@ -82,11 +83,11 @@ Calibration levels can be RAW, CALIBRATED, PRODUCT or AUXILIARY. | |||
|
|||
Note: Artifact is a single Hubble product file. | |||
|
|||
.. code-block:: python | |||
.. doctest-skip:: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
why skip? add comment or run the code
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It doesn't run, I've marked it as such. @jespinosaar can you replace this with one that does run, or is the file in question just an example?
@@ -23,15 +21,18 @@ Examples | |||
1. Getting XMM-Newton data | |||
-------------------------- | |||
|
|||
.. code-block:: python | |||
.. Skipping becuase the download takes too long | |||
.. doctest-skip:: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Again, maybe there is a dataset that is minimal at size? cc @jespinosaar
|
||
>>> from astroquery.esa.xmm_newton import XMMNewton | ||
>>> | ||
>>> XMMNewton.get_columns('public.v_all_observations') | ||
>>> XMMNewton.get_columns('xsa.v_all_observations') # doctest: +IGNORE_OUTPUT |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
same, I would rather keep the column list (my rule of thumb: ignore outputs when it's full of floats, and values that are e.g. a result of a truncated SQL query where it's not guaranteed that the same return will be given every time. But keep strings like these column names in for the tests)
Let me have a look at your comments @bsipocz, I will look for smaller datasets |
OK, so I did one minor cleanup, and as this passes the remote test, going ahead and merge it. I'll open a follow-up issue for using smaller datasets if possible to clean up the remaining example skips. Thanks @ceb8! |
No description provided.