rda-python-miscs 2.0.3__py3-none-any.whl → 2.0.4__py3-none-any.whl

rda_python_miscs/pg_rst.py

@@ -1119,9 +1119,10 @@ class PgRST(PgFile, PgUtil):
 
       Resolution order for OPTS / ALIAS:
 
-      1. Module-level ``OPTS`` / ``ALIAS`` attributes.
-      2. The first class *defined in that module* that carries both ``OPTS``
-         and ``ALIAS`` as class-level attributes.
+      1. The first class *defined in that module* that carries ``OPTS``
+         as a class-level attribute.
+      2. Module-level ``OPTS`` / ``ALIAS`` attributes (fallback when no
+         qualifying class is found).
 
       ``ALIAS`` is optional; an empty dict is returned when not found.
 
@@ -1155,25 +1156,26 @@ class PgRST(PgFile, PgUtil):
       # Derive ORIGIN from the module's own file path.
       origin = op.dirname(op.abspath(mod.__file__))
 
-      # 1. Try module-level attributes first.
-      opts  = getattr(mod, 'OPTS',  None)
-      alias = getattr(mod, 'ALIAS', None)
-
-      # 2. Fall back to the first class in the module that owns both.
-      if opts is None or alias is None:
-         for _, obj in inspect.getmembers(mod, inspect.isclass):
-            if obj.__module__ == modname:
-               cls_opts  = getattr(obj, 'OPTS',  None)
-               cls_alias = getattr(obj, 'ALIAS', None)
-               if cls_opts is not None:
-                  if opts  is None: opts  = cls_opts
-                  if alias is None: alias = cls_alias
-                  break
+      # 1. Find the first class defined in this module and read OPTS / ALIAS from it.
+      cls = next(
+         (obj for _, obj in inspect.getmembers(mod, inspect.isclass)
+          if obj.__module__ == modname),
+         None,
+      )
+
+      if cls is not None:
+         obj   = cls()
+         opts  = getattr(obj, 'OPTS',  None)
+         alias = getattr(obj, 'ALIAS', None)
+      else:
+         # 2. Fall back to module-level attributes when no class is found.
+         opts  = getattr(mod, 'OPTS',  None)
+         alias = getattr(mod, 'ALIAS', None)
 
       if opts is None:
          self.pglog(
-            "Module '{}' does not define OPTS (checked module level and "
-            "all classes defined in the module)".format(modname),
+            "Module '{}' does not define OPTS (checked class and "
+            "module level)".format(modname),
             self.LGWNEX,
          )
 

rda_python_miscs/rst_templates/index.rst.temp

@@ -0,0 +1,29 @@
+################################################################################
+#
+#     Title : index.temp
+#    Author : Zaihua Ji,  zji@ucar.edu
+#      Date : 03/17/2026
+#   Purpose : template file for help document index.rst (reStructuredText)
+#
+# Work File : $DSSHOME/lib/templates/index.temp
+#
+################################################################################
+
+.. _index:
+
+============================
+A GUIDE TO __TITLE__
+============================
+
+.. contents:: Table of Contents
+   :depth: 2
+   :local:
+
+See the :doc:`toc` for the full table of contents.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents
+
+   toc
+   section__SECID__

rda_python_miscs/rst_templates/section.rst.temp

@@ -0,0 +1,23 @@
+################################################################################
+#
+#     Title : section.temp
+#    Author : Zaihua Ji,  zji@ucar.edu
+#      Date : 03/17/2026
+#   Purpose : template file for help document section.rst (reStructuredText)
+#
+# Work File : $DSSHOME/lib/templates/section.temp
+#
+################################################################################
+
+.. _section__SECID__:
+
+__SECID__ - __TITLE__
+=====================
+
+__SECTION__
+
+.. raw:: html
+
+   <br>
+
+:ref:`Back to Top <index>`

rda_python_miscs/rst_templates/toc.rst.temp

@@ -0,0 +1,21 @@
+################################################################################
+#
+#     Title : toc.temp
+#    Author : Zaihua Ji,  zji@ucar.edu
+#      Date : 03/17/2026
+#   Purpose : template file for help document toc.rst (table of contents, RST)
+#
+# Work File : $DSSHOME/lib/templates/toc.temp
+#
+################################################################################
+
+.. _toc:
+
+====================
+__TITLE__ Guide
+====================
+
+Table of Contents
+-----------------
+
+__TOC__

{rda_python_miscs-2.0.3.dist-info → rda_python_miscs-2.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_miscs
-Version: 2.0.3
+Version: 2.0.4
 Summary: RDA Python package to hold RDA miscellaneous utility programs
 Author-email: Zaihua Ji <zji@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-miscs

{rda_python_miscs-2.0.3.dist-info → rda_python_miscs-2.0.4.dist-info}/RECORD

@@ -7,7 +7,7 @@ rda_python_miscs/gdexls.py,sha256=Wh4tQgKmoQ3YrlXN0etlhK5CDqvFzH75cRZgUtUGBDc,10
 rda_python_miscs/gdexls.usg,sha256=aJ_bPgKkgmhoXVFV7rdTpwb9odM_pygI3clppQ1-3cM,2953
 rda_python_miscs/gdexls_standalone.py,sha256=YcKnJ0Zm0SbZET4X8IQnrEyoAsHp5estUpOfWEIToQU,453
 rda_python_miscs/pg_docs.py,sha256=_AoqrWroUu7FQMVWaTSTZBQMwi1BH1-RjKb1nDHgxOI,25369
-rda_python_miscs/pg_rst.py,sha256=nEnl_vUcbPCu-PvDl7z6SexN3eZIcn1ruEG4fAGSysY,45271
+rda_python_miscs/pg_rst.py,sha256=5VEQRQ9miJnrIFBKYQL8jq4D4l3azQ4yTRuyZHZtVCE,45204
 rda_python_miscs/pg_wget.py,sha256=DHBOL9CMP0cRvLR8mEG5HqX2nRfgzb2C5WvIbgqCrOE,6815
 rda_python_miscs/pgwget.py,sha256=lsFKIX8Xhsz2yHpgbTCuWWQ57XcZJgVKB2jJi7h3oec,7622
 rda_python_miscs/rda_cp.py,sha256=Voear5P9tbBO63vjSs3lCIUxqXxfI6QtWVpM6w9KRzM,7132
@@ -36,9 +36,12 @@ rda_python_miscs/rdazip.usg,sha256=V4tCymlIZObIXRT3wPILKBWfmpV0mre1SlXBlg4ZG1k,5
 rda_python_miscs/tcsh_qsub.py,sha256=P4Obzbp5Dvy-N0eRR5F51R9yj3ttWJo6g1NqyVDO6-Y,6670
 rda_python_miscs/tcshqsub.py,sha256=wk711Ou_SwfcIrPGDUiGofTA_qabKGAFg1w6iZYc-ZU,7534
 rda_python_miscs/tcshqsub.usg,sha256=VttA4Sv4Rbx2VoajwEvfdO0StPGRlSoK9RpU3iHuMDY,2164
-rda_python_miscs-2.0.3.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
-rda_python_miscs-2.0.3.dist-info/METADATA,sha256=jd7BrAZQB41gpisciI2aQeu0dmFdv0hG-nEwpeZDkuw,669
-rda_python_miscs-2.0.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rda_python_miscs-2.0.3.dist-info/entry_points.txt,sha256=qKg-5kE64N8sgiR4Bd0qzGqHBUun8WwOZhIE-GXzbVQ,524
-rda_python_miscs-2.0.3.dist-info/top_level.txt,sha256=W5rz7DrWb7hXABUbGgWcwe6D644X338LR8_zdgmtLhg,17
-rda_python_miscs-2.0.3.dist-info/RECORD,,
+rda_python_miscs/rst_templates/index.rst.temp,sha256=ozjIV1I6Lz4eGc093zGuo4jmOrjgXqY5z-Yfeqhys7Y,660
+rda_python_miscs/rst_templates/section.rst.temp,sha256=-FH3JI4-9K-U894LPI7Ft3W6U7Nz6qmzJQ9iaiBTchI,518
+rda_python_miscs/rst_templates/toc.rst.temp,sha256=iNX5SzDDcvElNs7u36vNuCsxFR9xyGl_d7INe58-59s,494
+rda_python_miscs-2.0.4.dist-info/licenses/LICENSE,sha256=1dck4EAQwv8QweDWCXDx-4Or0S8YwiCstaso_H57Pno,1097
+rda_python_miscs-2.0.4.dist-info/METADATA,sha256=-LAoAguZLopl8Jf2QKGqtQcRIxQtMeCVAMFis3OPGxc,669
+rda_python_miscs-2.0.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rda_python_miscs-2.0.4.dist-info/entry_points.txt,sha256=qKg-5kE64N8sgiR4Bd0qzGqHBUun8WwOZhIE-GXzbVQ,524
+rda_python_miscs-2.0.4.dist-info/top_level.txt,sha256=W5rz7DrWb7hXABUbGgWcwe6D644X338LR8_zdgmtLhg,17
+rda_python_miscs-2.0.4.dist-info/RECORD,,