hdpws 0.6.25__py3-none-any.whl → 0.6.26__py3-none-any.whl

hdpws/__init__.py

@@ -41,7 +41,7 @@ the United States under Title 17, U.S.Code. All Other Rights Reserved.
 """
 
 
-__version__ = "0.6.25"
+__version__ = "0.6.26"
 
 
 #

hdpws/hdpws.py

@@ -47,6 +47,7 @@ from dateutil import parser
 from hdpws import __version__, NAMESPACES as NS
 from hdpws.dateinterval import DateInterval
 from hdpws.resourcetype import ResourceType
+from hdpws.spasehtmlparser import SpaseHtmlParser
 
 
 #
@@ -594,7 +595,7 @@ class HdpWs:
             resource_id: str,
             **keywords: Union[
                 datetime]
-        ) -> str:
+        ) -> Dict:
         """
         Gets the an HTML representation of the specified SPASE document 
         from HDP.
@@ -658,6 +659,58 @@ class HdpWs:
         return result
 
 
+    def get_spase_json_ld(
+            self,
+            resource_id: str,
+            **keywords: Union[
+                datetime]
+        ) -> Dict:
+        """
+        Gets the an JSON-LD representation of the specified SPASE document 
+        from HDP.
+
+        Parameters
+        ----------
+        resource_id
+            SPASE ResourceID value of the document to get.
+        keywords
+            Optional keyword paramaters as follows:<br>
+            <b>if_modified_since</b> - conditional GET If-Modified-Since
+            datetime value.<br>
+
+        Returns
+        -------
+        Dict
+            Dictionary containing a 'Result' key whose value is the JSON-LD
+            representation of the specified SPASE document with the
+            addition of the following key/values:<br>
+            - HttpStatus: with the value of the HTTP status code.
+              Successful == 200.<br>
+            - Last-Modified: the value of the HTTP Last-Modified header
+              when available.<br>
+            When HttpStatus != 200:<br>
+            - HttpText: containing a string representation of the HTTP
+              entity body.<br>
+            When HttpText is a standard HDP WS error entity body the
+            following key/values (convenience to avoid parsing
+            HttpStatus):<br>
+            - ErrorMessage: value from HttpText.<br>
+            - ErrorDescription: value from HttpText.<br>
+        """
+
+        response = self.get_spase_html(resource_id, **keywords)
+
+        if response['HttpStatus'] != 200:
+            return response
+
+        spase_html_parser = SpaseHtmlParser()
+        spase_html_parser.feed(response['Result'])
+
+        response['Result'] = spase_html_parser.get_json_ld()
+
+        return response
+
+
     def get_spase_data(
             self,
             resource_types: List[ResourceType],

hdpws/spasehtmlparser.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+
+#
+# NOSA HEADER START
+#
+# The contents of this file are subject to the terms of the NASA Open
+# Source Agreement (NOSA), Version 1.3 only (the "Agreement").  You may
+# not use this file except in compliance with the Agreement.
+#
+# You can obtain a copy of the agreement at
+#   docs/NASA_Open_Source_Agreement_1.3.txt
+# or
+#   https://cdaweb.gsfc.nasa.gov/WebServices/NASA_Open_Source_Agreement_1.3.txt.
+#
+# See the Agreement for the specific language governing permissions
+# and limitations under the Agreement.
+#
+# When distributing Covered Code, include this NOSA HEADER in each
+# file and include the Agreement file at
+# docs/NASA_Open_Source_Agreement_1.3.txt.  If applicable, add the
+# following below this NOSA HEADER, with the fields enclosed by
+# brackets "[]" replaced with your own identifying information:
+# Portions Copyright [yyyy] [name of copyright owner]
+#
+# NOSA HEADER END
+#
+# Copyright (c) 2025 United States Government as represented by
+# the National Aeronautics and Space Administration. No copyright is
+# claimed in the United States under Title 17, U.S.Code. All Other
+# Rights Reserved.
+#
+
+
+"""
+Module defining a class to represent a SPASE HTML parser.  At present,
+its main function is to extract the JSON-LD embedded in an HTML
+representation of a SPASE XML document.  Any other information should
+be obtained from the original SPASE XML document.<br>
+
+Copyright &copy; 2025 United States Government as represented by the
+National Aeronautics and Space Administration. No copyright is claimed in
+the United States under Title 17, U.S.Code. All Other Rights Reserved.
+"""
+
+
+from html.parser import HTMLParser
+
+
+
+class SpaseHtmlParser(HTMLParser):
+    """
+    A class representing a SPASE HTML parser.
+
+    Parameters
+    ----------
+    json_ld_element
+        Flag indicating that we have encountered the json-ld element.
+        The value is set back to false when we encounter the end tag.
+    json_ld
+        The json-ld "data" extracted from the json-ld element.
+    """
+    def __init__(self):
+
+        super().__init__()
+
+        self._json_ld_element = False
+        self._json_ld = None
+
+
+    def handle_starttag(self, tag, attrs):
+        """
+        This method is called to handle the start tag of an element.
+
+        Parameters
+        ----------
+        tag
+            The name of the tag encountered.
+        attrs
+            List of (name, value) pairs containing the attributes found
+            inside the tag’s &lt;&gt; brackets. 
+        """
+
+        if tag == 'script':
+            for attr in attrs:
+                if attr[0] == 'type' and attr[1] == 'application/ld+json':
+                    self._json_ld_element = True
+
+
+    def handle_endtag(self, tag):
+        """
+        This method is called to handle the end tag of an element.
+
+        Parameters
+        ----------
+        tag
+            The name of the tag encountered.
+        """
+
+        self._json_ld_element = False
+
+
+    def handle_data(self, data):
+        """
+        This method is called to process arbitrary data (e.g. text nodes
+        and the content of &lt;script&gt;...&lt;/script&gt; and 
+        &lt;style&gt;...&lt;/style&gt;).
+
+        Parameters
+        ----------
+        data
+            The content of the element.
+        """
+
+        if self._json_ld_element:
+
+            self._json_ld = data
+
+
+    def get_json_ld(self) -> str:
+        """
+        Gets the JSON-LD from the SPASE HTML fed to this parser.
+
+        Returns:
+        --------
+        str
+            JSON-LD from the SPASE HTML or None.
+        """
+
+        return self._json_ld

{hdpws-0.6.25.dist-info → hdpws-0.6.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: hdpws
-Version: 0.6.25
+Version: 0.6.26
 Summary: NASA's Heliophysics Data Portal Web Service Client Library
 Home-page: https://heliophysicsdata.gsfc.nasa.gov/WebServices
 Author: Bernie Harris
@@ -32,6 +32,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: summary
 

hdpws-0.6.26.dist-info/RECORD

@@ -0,0 +1,12 @@
+hdpws/__init__.py,sha256=3LQbCNWobLUcELAXwKVjSfIBV9l6R_-p4cow0n6Duj4,2059
+hdpws/__main__.py,sha256=RqdpMcxCUztmqE4YaZ7Gr-CQAkq4TLZyw1FYWqmxpJY,15294
+hdpws/dateinterval.py,sha256=OwFRQUbTMyzR1R7T5gSKT2st4PbLWAwOtcsP7_PqQys,4901
+hdpws/hdpws.py,sha256=0UE3pCFC0wwrHZXbAf67WuLG-BQTQ5xb-k83IrZHPvU,41973
+hdpws/resourcetype.py,sha256=ybBKFKDcVesRkRKb-mEXIxRt-INed3QZzysx1rmy6bo,1771
+hdpws/spase.py,sha256=ylnH9mh1McwwyB6-LzaOOWr1ggJiuNgcEH3-6mXJjfI,13343
+hdpws/spasehtmlparser.py,sha256=1eSahtKAydGpoor3oTLS5cxxaFW8nvIrUcdHbnLmC-A,3612
+hdpws-0.6.26.dist-info/licenses/LICENSE,sha256=9VDxMcDDn3_T-sDQTMPxmiPZBDkPIiTO4OzYK5olDmk,12589
+hdpws-0.6.26.dist-info/METADATA,sha256=aUz9Tjzcy3UCrDlVMmu9lPiWl4Zz6HZJQNAssNQU-bk,3876
+hdpws-0.6.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hdpws-0.6.26.dist-info/top_level.txt,sha256=BTo-2sxU1YuKAD5Ykfc8bNQvgVX486A74voiQxV4NiQ,6
+hdpws-0.6.26.dist-info/RECORD,,

{hdpws-0.6.25.dist-info → hdpws-0.6.26.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (76.1.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

hdpws-0.6.25.dist-info/RECORD

@@ -1,11 +0,0 @@
-hdpws/__init__.py,sha256=XPpGzl_P1W82Iua96XJSwlDdHh7JgsxHGZzNRb0hvcw,2059
-hdpws/__main__.py,sha256=RqdpMcxCUztmqE4YaZ7Gr-CQAkq4TLZyw1FYWqmxpJY,15294
-hdpws/dateinterval.py,sha256=OwFRQUbTMyzR1R7T5gSKT2st4PbLWAwOtcsP7_PqQys,4901
-hdpws/hdpws.py,sha256=EYnnCo2JtkP5GjpykxF6VGz1NmGFTVTuh3g4yjCAmqQ,40168
-hdpws/resourcetype.py,sha256=ybBKFKDcVesRkRKb-mEXIxRt-INed3QZzysx1rmy6bo,1771
-hdpws/spase.py,sha256=ylnH9mh1McwwyB6-LzaOOWr1ggJiuNgcEH3-6mXJjfI,13343
-hdpws-0.6.25.dist-info/LICENSE,sha256=9VDxMcDDn3_T-sDQTMPxmiPZBDkPIiTO4OzYK5olDmk,12589
-hdpws-0.6.25.dist-info/METADATA,sha256=CuAiLyMaDt_tx1k7X0cw-YHGESTXUppKtwUIm4A5B6I,3854
-hdpws-0.6.25.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
-hdpws-0.6.25.dist-info/top_level.txt,sha256=BTo-2sxU1YuKAD5Ykfc8bNQvgVX486A74voiQxV4NiQ,6
-hdpws-0.6.25.dist-info/RECORD,,