Accept MAST URIs as input to get_cloud_uris()

[snbianco]

This PR does the following:

• Allows users to input a MAST URI string as input for Observations.get_cloud_uri.
• Allows users to input a list of MAST URI strings as input for Observations.get_cloud_uris. Logs a warning if the user tries to provide filter criteria as well, since this won't be possible without a Table.
• Bugfix where users where unnecessarily warned about a query result limit while trying to fetch products in MastMissions.
• Bugfix where the functions to get cloud URIs fail if the MAST relative path cannot be returned. Now, it logs a warning and skips that particular data product.
• Added JWST to the list of cloud-hosted missions.
• Added both non-remote and remote test cases to increase coverage.

[codecov]

Codecov Report

Attention: Patch coverage is 96.15385% with 1 line in your changes missing coverage. Please review.

Project coverage is 68.69%. Comparing base (0fb73cd) to head (311197b).
Report is 25 commits behind head on main.

Files with missing lines	Patch %	Lines
astroquery/mast/cloud.py	80.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3193      +/-   ##
==========================================
+ Coverage   68.34%   68.69%   +0.34%     
==========================================
  Files         231      231              
  Lines       19190    19214      +24     
==========================================
+ Hits        13116    13199      +83     
+ Misses       6074     6015      -59     

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

[snbianco]

Tagging @bmorris3 and @dr-rodriguez for visibility

[bsipocz]

This test triggers a datetime deprecationwarning, could you investigate which upstream package it comes from?

[snbianco]

I wasn't able to reproduce a warning, but I did notice a bug in that test when running it alone that may have been causing some issues? I pushed a fix for it, and hopefully that should work.

[bsipocz]

I still see this:

_________________________________ TestMast.test_observations_get_cloud_uris_list_input _________________________________

self = <astroquery.mast.tests.test_mast_remote.TestMast object at 0x12c775850>

    def test_observations_get_cloud_uris_list_input(self):
        pytest.importorskip("boto3")
        uri_list = ['mast:HST/product/u24r0102t_c1f.fits',
                    'mast:PS1/product/rings.v3.skycell.1334.061.stk.r.unconv.exp.fits']
        expected = ['s3://stpubdata/hst/public/u24r/u24r0102t/u24r0102t_c1f.fits',
                    's3://stpubdata/panstarrs/ps1/public/rings.v3.skycell/1334/061/rings.v3.skycell.1334.'
                    '061.stk.r.unconv.exp.fits']
    
        # enable access to public AWS S3 bucket
        Observations.enable_cloud_dataset()
    
        # list of URI strings as input
        uris = Observations.get_cloud_uris(uri_list)
        assert len(uris) > 0, f'Products for URI list {uri_list} were not found in the cloud.'
        assert uris == expected
    
        # check for warning if filters are provided with list input
>       with pytest.warns(InputWarning, match='Filtering is not supported'):
E       DeprecationWarning: datetime.datetime.utcnow() is deprecated and scheduled for removal in a future version. Use timezone-aware objects to represent datetimes in UTC: datetime.datetime.now(datetime.UTC).

../../.tox/test-online/lib/python3.12/site-packages/astroquery/mast/tests/test_mast_remote.py:824: DeprecationWarning

[snbianco]

Do you mind sending the package versions you're using? I can't reproduce, and I figure I might be running the test with a newer version of some dependency.

[bsipocz]

This is with a fresh tox run, so I'm surprised you don't hit the same problem.

Anyway, it's not in our own codebase, so can just put a blanket ignore in the config file.

[snbianco]

Oh, that might be the issue: I've been running the tests with pytest. I can't quite figure out how to use tox to only run the tests in one file. I've been trying to use tox -e py312-test-alldeps-online -- astroquery/mast/tests/test_mast_remote.py but I keep getting various errors.

[bsipocz]

Minor issue with the changelog and the warning filter, the rest looks good to me.

Thanks!

[bsipocz]

This should not be here

[bsipocz]

This doesn't work as is, besides it's better to be as specific as possible rather than ignoring anything in datetime.datetime

Suggested change

	# Datetime deprecation warnings
	ignore::DeprecationWarning:datetime\.datetime
	# Triggered in mast, likely boto related
	ignore:datetime.datetime.utcnow\(\) is deprecated:DeprecationWarning

[snbianco]

Sorry for the delay on this! I just made those changes.

[bsipocz]

Thanks @snbianco!

[bsipocz]

fyi: I'll move this section down below as we keep this section to highlight potentially breaking API changes rather than for additions/enhacements.