Rcal 596 Updates for association processing

[ddavis-stsci]

Resolves RCAL-nnnn

Closes #242

This PR adds a method to identify an association file for processing in the Roman pipeline along a test.
Regresssion testing will be done for the rcal-596 ticket.

Checklist

• Added entry in CHANGES.rst under the corresponding subsection
• updated relevant tests
• updated relevant documentation
• Passed romancal regression testing on Jenkins / PLWishMaster. Link: https://plwishmaster.stsci.edu:8081/job/RT/job/Roman-Developers-Pull-Requests/296/

pytest tests
=============================================================== test session starts ================================================================
platform darwin -- Python 3.11.0, pytest-7.4.0, pluggy-1.2.0
rootdir: /Users/ddavis/src/Roman/roman_datamodels
configfile: pyproject.toml
plugins: remotedata-0.4.0, asdf-2.15.0, hypothesis-6.82.0, doctestplus-0.13.0, cov-4.1.0, filter-subpackage-0.1.2, mock-3.11.1, astropy-header-0.2.2, astropy-0.10.0, ci-watson-0.6.1, openfiles-0.5.0, env-0.8.2, arraydiff-0.5.0
collected 1115 items

tests/test_maker_utils.py .................................................................................................................. [ 10%]
............................................................................................................................... [ 21%]
tests/test_models.py ....................................................................................................................... [ 32%]
............................................................................................................................................ [ 44%]
............................................................................................................................................ [ 57%]
............................................................................................................................................ [ 69%]
...................................................................... [ 76%]
tests/test_open.py ...................................................... [ 81%]
tests/test_stnode.py ....................................................................................................................... [ 91%]
............................................................................................ [100%]

============================================================== 1115 passed in 41.48s

[WilliamJamieson]

It is not clear to me why it is necessary to revert #219; however, in any case the current merge conflict will require a major change to the proposed rdm_open changes.

As the currently proposed changes are a bit overkill, I suggest replacing

roman_datamodels/src/roman_datamodels/datamodels/_utils.py

Lines 87 to 90 in 7b5f02f

	# Temp fix to catch JWST args before being passed to asdf open
	if "asn_n_members" in kwargs:
	del kwargs["asn_n_members"]

with

        if isinstance(init, str):
            exts = Path(init).suffixes
            if not exts:
                raise ValueError(f"Input file path does not have an extension: {init}")

            # Assume json files are asn and return them
            if exts[0] == "json":
                return init

        # Temp fix to catch JWST args before being passed to asdf open
        if "asn_n_members" in kwargs:
            del kwargs["asn_n_members"]

(Additionally, add from pathlib import Path as part of the imports)

This effectively implements the same guarding logic and should return the file path in the asn (assumed when json is passed) as this code currently does.

[codecov]

Codecov Report

Patch coverage: 28.57% and project coverage change: -0.20% ⚠️

Comparison is base (1773850) 96.87% compared to head (cb927e9) 96.67%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #241      +/-   ##
==========================================
- Coverage   96.87%   96.67%   -0.20%     
==========================================
  Files          28       28              
  Lines        2399     2406       +7     
==========================================
+ Hits         2324     2326       +2     
- Misses         75       80       +5     

Files Changed	Coverage Δ
src/roman_datamodels/datamodels/_utils.py	82.05% <28.57%> (-11.70%)	⬇️

... and 2 files with indirect coverage changes

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

[zacharyburnett]

docs build is failing with the following import error:

  File "/home/docs/checkouts/readthedocs.org/user_builds/roman-datamodels/conda/241/lib/python3.11/site-packages/roman_datamodels/datamodels/__init__.py", line 2, in <module>
    from ._datamodels import *  # noqa: F403
    ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/docs/checkouts/readthedocs.org/user_builds/roman-datamodels/conda/241/lib/python3.11/site-packages/roman_datamodels/datamodels/_datamodels.py", line 147, in <module>
    class InverseLinearityRefModel(_DataModel):
  File "/home/docs/checkouts/readthedocs.org/user_builds/roman-datamodels/conda/241/lib/python3.11/site-packages/roman_datamodels/datamodels/_datamodels.py", line 148, in InverseLinearityRefModel
    _node_type = stnode.InverseLinearityRef
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: module 'roman_datamodels.stnode' has no attribute 'InverseLinearityRef'