Refactor JPLSpec/CDMS to bring common code up a level

CHANGES.rst

@@ -30,6 +30,16 @@ mast
 
 - Switch to use HTTP continuation for partial downloads. [#3448]
 
+jplspec
+^^^^^^^
+
+- Moved to linelists/ [#3455]
+- Refactored to use linelists.core [#3456]
+
+linelists
+^^^^^^^^^
+
+- General tools for both CDMS/JPL moved to linelists.core [#3456]
 
 Infrastructure, Utility and Other Changes and Additions
 -------------------------------------------------------
@@ -106,6 +116,8 @@ gaia
   EPOCH_SPECTRUM_XP_CROWDING, MEAN_SPECTRUM_XP, EPOCH_SPECTRUM_XP and
   MEAN_SPECTRUM_XP_GRAVLENS. [#3382]
 
+- Add more complete support for CDMS quantum number and other value parsing. [#3302]
+
 heasarc
 ^^^^^^^
 

astroquery/jplspec/__init__.py

@@ -1,33 +1,33 @@
 # Licensed under a 3-clause BSD style license - see LICENSE.rst
 """
-JPL Spectral Catalog
---------------------
+JPL Spectral Catalog (Deprecated Location)
+------------------------------------------
 
+.. deprecated:: 0.4.8
+    The `astroquery.jplspec` module has been moved to `astroquery.linelists.jplspec`.
+    Please update your imports to use `from astroquery.linelists.jplspec import JPLSpec` instead.
+    This backward compatibility layer will be removed in a future version.
 
-:author: Giannina Guzman ([email protected])
-:author: Miguel de Val-Borro ([email protected])
-
-"""
-from astropy import config as _config
+This module provides backward compatibility for the old import location.
+The JPLSpec module has been reorganized under the linelists subpackage.
 
+For new code, please use::
 
-class Conf(_config.ConfigNamespace):
-    """
-    Configuration parameters for `astroquery.jplspec`.
-    """
-    server = _config.ConfigItem(
-        'https://spec.jpl.nasa.gov/cgi-bin/catform',
-        'JPL Spectral Catalog URL.')
-
-    timeout = _config.ConfigItem(
-        60,
-        'Time limit for connecting to JPL server.')
+    from astroquery.linelists.jplspec import JPLSpec
 
+"""
+import warnings
 
-conf = Conf()
+# Issue deprecation warning
+warnings.warn(
+    "Importing from 'astroquery.jplspec' is deprecated. "
+    "Please use 'from astroquery.linelists.jplspec import JPLSpec' instead. "
+    "The old import path will be removed in a future version.",
+    DeprecationWarning,
+    stacklevel=2
+)
 
-from .core import JPLSpec, JPLSpecClass
+# Import from the new location
+from ..linelists.jplspec import JPLSpec, JPLSpecClass, Conf, conf
 
-__all__ = ['JPLSpec', 'JPLSpecClass',
-           'Conf', 'conf',
-           ]
+__all__ = ['JPLSpec', 'JPLSpecClass', 'Conf', 'conf']

astroquery/linelists/__init__.py

@@ -0,0 +1,11 @@
+# Licensed under a 3-clause BSD style license - see LICENSE.rst
+"""
+Linelists module
+----------------
+This module contains sub-modules for various molecular and atomic line list databases,
+as well as common utilities for parsing catalog files.
+"""
+
+from .core import LineListClass, parse_letternumber
+
+__all__ = ['LineListClass', 'parse_letternumber']