rda-python-miscs 2.0.3__tar.gz → 2.0.4__tar.gz

rda_python_miscs-2.0.4/MANIFEST.in

@@ -0,0 +1,2 @@
+include src/rda_python_miscs/*.usg
+include src/rda_python_miscs/rst_templates/*.temp

{rda_python_miscs-2.0.3 → rda_python_miscs-2.0.4}/PKG-INFO

@@ -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 → rda_python_miscs-2.0.4}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rda_python_miscs"
-version = "2.0.3"
+version = "2.0.4"
 authors = [
   { name="Zaihua Ji", email="zji@ucar.edu" },
 ]

{rda_python_miscs-2.0.3 → rda_python_miscs-2.0.4}/src/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-2.0.4/src/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-2.0.4/src/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-2.0.4/src/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 → rda_python_miscs-2.0.4}/src/rda_python_miscs.egg-info/PKG-INFO

@@ -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 → rda_python_miscs-2.0.4}/src/rda_python_miscs.egg-info/SOURCES.txt

@@ -46,4 +46,7 @@ src/rda_python_miscs.egg-info/dependency_links.txt
 src/rda_python_miscs.egg-info/entry_points.txt
 src/rda_python_miscs.egg-info/requires.txt
 src/rda_python_miscs.egg-info/top_level.txt
+src/rda_python_miscs/rst_templates/index.rst.temp
+src/rda_python_miscs/rst_templates/section.rst.temp
+src/rda_python_miscs/rst_templates/toc.rst.temp
 tests/test_miscs.py

rda_python_miscs-2.0.3/MANIFEST.in

@@ -1 +0,0 @@
-include src/rda_python_miscs/*.usg