cdasws 1.8.5__py3-none-any.whl → 1.8.7__py3-none-any.whl

cdasws/__init__.py

@@ -137,7 +137,7 @@ except ImportError:
         CDF_XARRAY_AVAILABLE = False
 
 
-__version__ = "1.8.5"
+__version__ = "1.8.7"
 
 
 #
@@ -282,7 +282,8 @@ class CdasWs:
             self._user_agent += ' (' + user_agent + ')'
 
         self._request_headers = {
-            'Content-Type' : 'application/json',
+            #'Content-Type' : 'application/json',
+            'Content-Type' : 'application/xml',
             'Accept' : 'application/xml',
             'User-Agent' : self._user_agent,
             #'Accept-Encoding' : 'gzip'  # only beneficial for icdfml responses
@@ -729,17 +730,21 @@ class CdasWs:
             interval.  See module note about timezone value.  If this
             parameter is omitted, the time interval will end infinitely
             in the future.<br>
+            <b>id</b> - a dataset identifier. The value may be a CDAS
+            (e.g., AC_H2_MFI), DOI (e.g., 10.48322/fh85-fj47), or SPASE
+            [ResourceID] (e.g., spase://NASA/NumericalData/ACE/MAG/L2/PT1H)
+            identifier. If specified, all other keywords are ignored.<br>
             <b>idPattern</b> - a java.util.regex compatible regular
-            expression that must match the dataset's identifier value.
+            expression that must match the dataset's CDAS identifier value.
             Omitting this parameter is equivalent to `.*`.<br>
             <b>labelPattern</b> - a java.util.regex compatible regular
-            expression that must match the dataset's  label text.
+            expression that must match the dataset's CDAS label text.
             Omitting this parameter is equivalent to `.*`.  Embedded
             matching flag expressions (e.g., `(?i)` for case insensitive
             match mode) are supported and likely to be useful in this
             case.<br>
             <b>notesPattern</b> - a java.util.regex compatible regular
-            expression that must match the dataset's  notes text.
+            expression that must match the dataset's CDAS notes text.
             Omitting this parameter is equivalent to `.*`.  Embedded
             matching flag expressions (e.g., `(?s)` for dotall match mode)
             are supported and likely to be useful in this case.<br>
@@ -793,6 +798,10 @@ class CdasWs:
             url = url + 'stopDate=' \
                   + urllib.parse.quote(keywords['stopDate']) + '&'
 
+        if 'id' in keywords:
+            url = url + 'id=' \
+                  + urllib.parse.quote(keywords['id']) + '&'
+
         if 'idPattern' in keywords:
             url = url + 'idPattern=' \
                   + urllib.parse.quote(keywords['idPattern']) + '&'
@@ -1324,12 +1333,14 @@ class CdasWs:
         CdasWs.get_data
         """
 
-        self.logger.debug('data_request = %s', data_request.json())
+        #self.logger.debug('data_request = %s', data_request.json())
+        self.logger.debug('data_request = %s', data_request.xml_str())
 
         url = self._endpoint + 'datasets'
 
         for retries in range(RETRY_LIMIT):
-            response = self._session.post(url, data=data_request.json(),
+            #response = self._session.post(url, data=data_request.json(),
+            response = self._session.post(url, data=data_request.xml_str(),
                                           timeout=self._timeout)
 
             if response.status_code == 200:

cdasws/__main__.py

@@ -202,7 +202,7 @@ def example(
                           #    'interpolateMissingValues': True,
                           #    'sigmaMultiplier': 4,
                           #    'overrideDefaultBinning': True
-                          #}
+                          #},
                           dataRepresentation=DataRepresentation.SPACEPY
                           )
 #            cdas.get_data('10.21978/P8PG8V', ['BT'],

cdasws/datarequest.py

@@ -44,8 +44,10 @@ the United States under Title 17, U.S.Code. All Other Rights Reserved.
 
 import enum
 import json
+import xml.etree.ElementTree as ET
 from typing import List, Union # when python 3.8 , TypedDict
 from abc import ABCMeta, abstractmethod
+#from cdasws import NS
 from cdasws.timeinterval import TimeInterval
 
 
@@ -117,6 +119,14 @@ class DataRequest(metaclass=ABCMeta): # pylint: disable=too-few-public-methods
         Creates an object representing a DataRequestEntity from
         <https://cdaweb.gsfc.nasa.gov/WebServices/REST/CDAS.xsd>.
 
+        Notes
+        -----
+        This class was originally written with serialization to JSON
+        in mind so some dict key values are the JSON representations.
+        For example, Start/End key values are strings instead of
+        datetimes.  These value data type choices cause extra code
+        for serialization to XML.
+
         Parameters
         ----------
         request_type
@@ -180,6 +190,170 @@ class DataRequest(metaclass=ABCMeta): # pylint: disable=too-few-public-methods
                     bin_data['overrideDefaultBinning']
 
 
+    # pylint: disable=too-many-locals
+    # pylint: disable=too-many-branches
+    # pylint: disable=too-many-statements
+    def xml_element(self) -> ET:
+        """
+        Produces the XML Element representation of this object.
+
+        Returns
+        -------
+        ET
+            XML Element representation of this object.
+        """
+
+        #attrs = {'xmlns': NS}
+        attrs = {'xmlns': 'http://cdaweb.gsfc.nasa.gov/schema'}
+
+        builder = ET.TreeBuilder()
+        builder.start('DataRequest', attrs)
+        request_name = next(iter(self._data_request))
+        builder.start(request_name, {})
+        data_request = self._data_request[request_name]
+        time_intervals = data_request['TimeInterval']
+        if isinstance(time_intervals, list):
+            for time_interval in time_intervals:
+                start = time_interval['Start']
+                end = time_interval['End']
+                TimeInterval(start, end).xml_element(builder)
+        else:
+            start = time_intervals['Start']
+            end = time_intervals['End']
+            TimeInterval(start, end).xml_element(builder)
+
+        builder.start('DatasetRequest', {})
+        dataset_request = data_request['DatasetRequest']
+        builder.start('DatasetId', {})
+        builder.data(dataset_request['DatasetId'])
+        builder.end('DatasetId')
+        variable_names = dataset_request['VariableName']
+        if isinstance(variable_names, list):
+            for variable_name in variable_names:
+                builder.start('VariableName', {})
+                builder.data(variable_name)
+                builder.end('VariableName')
+        else:
+            builder.start('VariableName', {})
+            builder.data(variable_names)
+            builder.end('VariableName')
+        builder.end('DatasetRequest')
+        if 'CdfVersion' in data_request:
+            builder.start('CdfVersion', {})
+            builder.data(str(data_request['CdfVersion']))
+            builder.end('CdfVersion')
+        if 'CdfFormat' in data_request:
+            builder.start('CdfFormat', {})
+            builder.data(data_request['CdfFormat'])
+            builder.end('CdfFormat')
+        if 'Compression' in data_request:
+            builder.start('Compression', {})
+            builder.data(data_request['Compression'])
+            builder.end('Compression')
+        if 'Format' in data_request:
+            builder.start('Format', {})
+            builder.data(data_request['Format'])
+            builder.end('Format')
+        if 'Thumbnail' in data_request:
+            builder.start('Thumbnail', {})
+            builder.data(str(data_request['Thumbnail']))
+            builder.end('Thumbnail')
+        if 'ThumbnailId' in data_request:
+            builder.start('ThumbnailId', {})
+            builder.data(data_request['ThumbnailId'])
+            builder.end('ThumbnailId')
+        if 'GraphOptions' in data_request:
+            graph_options = data_request['GraphOptions']
+            builder.start('GraphOptions', {})
+            if 'CoarseNoiseFilter' in graph_options:
+                builder.start('CoarseNoiseFilter', {})
+                builder.data(graph_options['CoarseNoiseFilter'])
+                builder.end('CoarseNoiseFilter')
+            if 'XAxisWidthFactor' in graph_options:
+                builder.start('XAxisWidthFactor', {})
+                builder.data(str(graph_options['XAxisWidthFactor']))
+                builder.end('XAxisWidthFactor')
+            if 'YAxisHeightFactor' in graph_options:
+                builder.start('YAxisHeightFactor', {})
+                builder.data(str(graph_options['YAxisHeightFactor']))
+                builder.end('YAxisHeightFactor')
+            if 'Combine' in graph_options:
+                builder.start('Combine', {})
+                builder.data(str(graph_options['Combine']).lower())
+                builder.end('Combine')
+            if 'Overplot' in graph_options:
+                builder.start('Overplot', {})
+                builder.data(str(graph_options['Overplot']))
+                builder.end('Overplot')
+            builder.end('GraphOptions')
+        if 'GraphOption' in data_request:
+            graph_options = data_request['GraphOption']
+            if isinstance(graph_options, list):
+                for graph_option in graph_options:
+                    builder.start('GraphOption', {})
+                    builder.data(graph_option)
+                    builder.end('GraphOption')
+            else:
+                builder.start('GraphOption', {})
+                builder.data(graph_option)
+                builder.end('GraphOption')
+        if 'ImageFormat' in data_request:
+            image_formats = data_request['ImageFormat']
+            if isinstance(image_formats, list):
+                for image_format in image_formats:
+                    builder.start('ImageFormat', {})
+                    builder.data(image_format)
+                    builder.end('ImageFormat')
+            else:
+                builder.start('ImageFormat', {})
+                builder.data(data_request['ImageFormat'])
+                builder.end('ImageFormat')
+        if 'BinData' in data_request:
+            bin_data = data_request['BinData']
+            builder.start('BinData', {})
+            if 'Interval' in bin_data:
+                builder.start('Interval', {})
+                builder.data(str(bin_data['Interval']))
+                builder.end('Interval')
+            if 'InterpolateMissingValues' in bin_data:
+                builder.start('InterpolateMissingValues', {})
+                builder.data(str(bin_data['InterpolateMissingValues']).lower())
+                builder.end('InterpolateMissingValues')
+            if 'SigmaMultiplier' in bin_data:
+                builder.start('SigmaMultiplier', {})
+                builder.data(str(bin_data['SigmaMultiplier']))
+                builder.end('SigmaMultiplier')
+            if 'OverrideDefaultBinning' in bin_data:
+                builder.start('OverrideDefaultBinning', {})
+                builder.data(str(bin_data['OverrideDefaultBinning']).lower())
+                builder.end('OverrideDefaultBinning')
+            builder.end('BinData')
+        builder.end(request_name)
+        builder.end('DataRequest')
+        xml_element = builder.close()
+
+        return xml_element
+    # pylint: enable=too-many-locals
+    # pylint: enable=too-many-branches
+    # pylint: enable=too-many-statements
+
+
+    def xml_str(self) -> str:
+        """
+        Produces an str xml representation of this object matching the
+        XML representation of a DataRequestEntity from
+        <https://cdaweb.gsfc.nasa.gov/WebServices/REST/CDAS.xsd>.
+
+        Returns
+        -------
+        str
+            string XML representation of this object.
+        """
+
+        #return ET.tostring(self.xml_element(), encoding="utf-8", method='xml', xml_declaration=True)
+        return ET.tostring(self.xml_element(), encoding="utf-8", method='xml')
+
+
     def json(self, **keywords) -> str:
         """
         Produces a JSON representation of this object matching the
@@ -632,6 +806,7 @@ class ThumbnailRequest(DataRequest): # pylint: disable=too-few-public-methods
                     i_format.value)
 
 
+
 class AudioRequest(DataRequest): # pylint: disable=too-few-public-methods
     """
     Class representing an AudioRequest from

cdasws/timeinterval.py

@@ -41,6 +41,8 @@ the United States under Title 17, U.S.Code. All Other Rights Reserved.
 """
 
 
+import xml.etree.ElementTree as ET
+from xml.etree.ElementTree import TreeBuilder
 from datetime import datetime, timezone
 from typing import Tuple, Union
 import dateutil.parser
@@ -132,6 +134,53 @@ class TimeInterval:
         self._end = TimeInterval.get_datetime(value)
 
 
+    def xml_element(self,
+                    builder: TreeBuilder = None) -> ET:
+        """
+        Produces the XML Element representation of this object.
+
+        Parameters
+        ----------
+        builder
+            The TreeBuilder to use.
+
+        Returns
+        -------
+        ET
+            XML Element representation of this object.
+        """
+
+        if builder is None:
+            builder = ET.TreeBuilder()
+
+        builder.start('TimeInterval', {})
+        builder.start('Start', {})
+        builder.data(self._start.isoformat().replace('+00:00', '.000Z'))
+        builder.end('Start')
+        builder.start('End', {})
+        builder.data(self._end.isoformat().replace('+00:00', '.000Z'))
+        builder.end('End')
+
+        return builder.end('TimeInterval')
+
+
+    def xml_str(self) -> str:
+        """
+        Produces an str xml representation of this object matching the
+        XML representation of a DataRequestEntity from
+        <https://cdaweb.gsfc.nasa.gov/WebServices/REST/CDAS.xsd>.
+
+        Returns
+        -------
+        str
+            string XML representation of this object.
+        """
+
+        #return ET.tostring(self.xml_element(), encoding="utf-8", method='xml',
+        #                   xml_declaration=True)
+        return ET.tostring(self.xml_element(), encoding="utf-8", method='xml')
+
+
     def __str__(self):
         return self._start.isoformat() + ' ' + self._end.isoformat()
 

{cdasws-1.8.5.dist-info → cdasws-1.8.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cdasws
-Version: 1.8.5
+Version: 1.8.7
 Summary: NASA's Coordinated Data Analysis System Web Service Client Library
 Home-page: https://cdaweb.gsfc.nasa.gov/WebServices/REST
 Author: Bernie Harris
@@ -14,9 +14,8 @@ Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
+Classifier: License :: OSI Approved :: NASA Open Source Agreement v1.3 (NASA-1.3)
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Software Development :: Libraries :: Python Modules

cdasws-1.8.7.dist-info/RECORD

@@ -0,0 +1,13 @@
+cdasws/__init__.py,sha256=8__wjJd-f5a8EE_k3Q9kWyPuwEdlK0TSOjkw1IJIJpU,91733
+cdasws/__main__.py,sha256=9-S-Zh4sRMtcJRg-YELX_HjN8Q74cZiekZ1MLF51bls,12553
+cdasws/cdasws.py,sha256=755mLWlMFXknNP3f8g_W9An6niAmksqcb1NdgiAybj0,29552
+cdasws/datarepresentation.py,sha256=kKgAKCA4uzGoBQ8r8jbXstBg8SCg_EQtsoGhO8kIpco,2164
+cdasws/datarequest.py,sha256=fQVroT8RXYhJLG7_y-HO3ABnJUQJjWGFPeLNrtwbWtk,29080
+cdasws/timeinterval.py,sha256=ajWPkjBnUppFRXMLQiF5L1L3RYYjRqbUGThXIi9YKg8,7815
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_cdasws.py,sha256=DsKesU19_9zUIO1a7oyWWtywBGN7gjdQHFLMGUZ4X8c,24395
+cdasws-1.8.7.dist-info/LICENSE,sha256=og42scUY42lPLGBg0wHt6JtrbeInVEr5xojyrguPqrQ,12583
+cdasws-1.8.7.dist-info/METADATA,sha256=iE_iYWN2sybYeMn8LlzSVVZVyLwLOi0x1A5GyuE66kU,5733
+cdasws-1.8.7.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+cdasws-1.8.7.dist-info/top_level.txt,sha256=GyIvHk5F6ysnTdDfnQsjZbTBt_EYrKyC0oeiIt9l-AE,7
+cdasws-1.8.7.dist-info/RECORD,,

cdasws-1.8.5.dist-info/RECORD

@@ -1,13 +0,0 @@
-cdasws/__init__.py,sha256=GSsIndi0QVibnlnrScOpV66LVstYcvZluNsHpU8ebRc,91107
-cdasws/__main__.py,sha256=odblrsfHMXcovTQQ50xdYM3ubxOH6IMaiurjUDWsOS0,12552
-cdasws/cdasws.py,sha256=755mLWlMFXknNP3f8g_W9An6niAmksqcb1NdgiAybj0,29552
-cdasws/datarepresentation.py,sha256=kKgAKCA4uzGoBQ8r8jbXstBg8SCg_EQtsoGhO8kIpco,2164
-cdasws/datarequest.py,sha256=mRzQKAld1O-8O83IT6XBXnRmKbpf5K_oLi3sOmQzeVs,21737
-cdasws/timeinterval.py,sha256=677SULpzclE4XqFuU4_SjZLVCZKlQKa2ekvswnmDVkU,6392
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/test_cdasws.py,sha256=DsKesU19_9zUIO1a7oyWWtywBGN7gjdQHFLMGUZ4X8c,24395
-cdasws-1.8.5.dist-info/LICENSE,sha256=og42scUY42lPLGBg0wHt6JtrbeInVEr5xojyrguPqrQ,12583
-cdasws-1.8.5.dist-info/METADATA,sha256=oc9FXpYcLYKuHpYEu-gQMaBjS8yOT9sB1jiNvAJKuO0,5744
-cdasws-1.8.5.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-cdasws-1.8.5.dist-info/top_level.txt,sha256=GyIvHk5F6ysnTdDfnQsjZbTBt_EYrKyC0oeiIt9l-AE,7
-cdasws-1.8.5.dist-info/RECORD,,