hapiclient 0.2.6__tar.gz → 0.2.7__tar.gz

{hapiclient-0.2.6 → hapiclient-0.2.7}/CHANGES.txt

@@ -10,7 +10,7 @@ v0.0.6:
 		2018-10-04 -- Improve dateticks.py
 		2018-10-04 -- Add hapi_demo.ipynb
 		2018-10-04 -- Other documentation improvements
-v0.0.7: 
+v0.0.7:
 		2018-10-06 -- Improve documentation
 		2018-10-06 -- Add reader tests
 		2018-10-23 -- Improve dateticks and tests
@@ -103,4 +103,11 @@ v0.2.6b1:
 	2023-02-04 -- 2ef7cff Unicode fix; Log string fix
 	2024-05-11 -- fba4ad3 Testing Updates
 v0.2.6:
-
+	2023-05-24 -- Use token for PyPi in Makefile
+v0.2.7b1:
+	2025-03-01 -- Unrecognized ISO 8601 time format: '00:00:00.Z' https://github.com/hapi-server/client-python/issues/76
+	2025-03-01 -- 'infer_datetime_format' is deprecated ... https://github.com/hapi-server/client-python/issues/78
+	2026-04-08 -- Improve NaN handling https://github.com/hapi-server/client-python/issues/88
+	2026-05-02 -- Logging and testing https://github.com/hapi-server/client-python/issues/89
+v0.2.7:
+	2026--05-02-- Support for Python 2.7 dropped. This is last release with support for 3.5 through 3.8.

{hapiclient-0.2.6 → hapiclient-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: hapiclient
-Version: 0.2.6
+Version: 0.2.7
 Summary: Interface to Heliophysics data server API
 Home-page: http://pypi.python.org/pypi/hapiclient/
 Author: Bob Weigel
@@ -8,6 +8,20 @@ Author-email: rweigel@gmu.edu
 License: LICENSE.txt
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Requires-Dist: urllib3
+Requires-Dist: joblib
+Requires-Dist: isodate>=0.6.0
+Requires-Dist: pandas>=0.23
+Requires-Dist: numpy>=1.14.3
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
 
 [![DOI](https://zenodo.org/badge/93170857.svg)](https://zenodo.org/badge/latestdoi/93170857)
 [![Build Status](https://app.travis-ci.com/hapi-server/client-python.svg?branch=master)](https://app.travis-ci.com/hapi-server/client-python)
@@ -50,6 +64,7 @@ start      = '2003-09-01T00:00:00'
 stop       = '2003-12-01T00:00:00'
 parameters = 'DST1800'
 opts       = {'logging': True}
+# See misc/hapi_logging_demo.py for example of using conventional Python logging.
 
 # Get data
 data, meta = hapi(server, dataset, parameters, start, stop, **opts)
@@ -92,7 +107,41 @@ returns the [Numpy N-D array](https://docs.scipy.org/doc/numpy-1.15.1/user/quick
 
 The HAPI client data model is intentionally basic. There is an ongoing discussion of a data model for Heliophysics data among the [PyHC community](https://heliopython.org/). When this data model is complete, a function that converts `data` and `meta` to that data model will be included in the `hapiclient` package.
 
-# Development
+# Development and Testing
+
+## Testing Python versions available with tox-env
+
+As of 2026-04-14, Python 3.8+ is available with tox-env.
+
+```bash
+git clone https://github.com/hapi-server/client-python
+cd client-python; python -m pip install -e .
+
+# Run a specific test on current Python version (default is log_level=INFO
+# for hapiclient logger and test logger when executed this way).
+python test/test_hapi_data_requests.py
+
+# Run a specific test on a specific Python version with all logging
+tox -e py311 -- test/test_hapi_data_requests.py
+# Set log level for test logger
+tox -e py311 -- test/test_hapi_data_requests.py --log-level=INFO
+
+# Run a specific test on all Python versions set by tox.ini `envlist`
+tox -- test/test_hapi_data_requests.py
+
+# Run all tests in ./test
+tox
+
+# Run long-running tests
+tox -e long-test
+
+# Run long-running tests on a specific Python version
+tox -e long-test --override testenv:long-test.basepython=python3.11
+```
+
+## Testing Python versions available with Anaconda
+
+As of 2026-04-14, Python 3.5+ is available with Anaconda.
 
 ```bash
 git clone https://github.com/hapi-server/client-python
@@ -117,12 +166,13 @@ make repository-test
 
 To run an individual unit test in a Python session, use, e.g.,
 
-```python
-from hapiclient.test.test_hapi import test_reader_short
-test_reader_short()
+```bash
+cd test; python test_hapitime_reformat.py
 ```
 
 # Contact
 
 Submit bug reports and feature requests on the [repository issue
 tracker](https://github.com/hapi-server/client-python/issues>).
+
+Before submitting a pull request, please post an issue with the proposed changes for discussion prior to developing the pull request.

hapiclient-0.2.6/hapiclient.egg-info/PKG-INFO → hapiclient-0.2.7/README.md

@@ -1,14 +1,3 @@
-Metadata-Version: 2.1
-Name: hapiclient
-Version: 0.2.6
-Summary: Interface to Heliophysics data server API
-Home-page: http://pypi.python.org/pypi/hapiclient/
-Author: Bob Weigel
-Author-email: rweigel@gmu.edu
-License: LICENSE.txt
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-
 [![DOI](https://zenodo.org/badge/93170857.svg)](https://zenodo.org/badge/latestdoi/93170857)
 [![Build Status](https://app.travis-ci.com/hapi-server/client-python.svg?branch=master)](https://app.travis-ci.com/hapi-server/client-python)
 
@@ -50,6 +39,7 @@ start      = '2003-09-01T00:00:00'
 stop       = '2003-12-01T00:00:00'
 parameters = 'DST1800'
 opts       = {'logging': True}
+# See misc/hapi_logging_demo.py for example of using conventional Python logging.
 
 # Get data
 data, meta = hapi(server, dataset, parameters, start, stop, **opts)
@@ -92,7 +82,41 @@ returns the [Numpy N-D array](https://docs.scipy.org/doc/numpy-1.15.1/user/quick
 
 The HAPI client data model is intentionally basic. There is an ongoing discussion of a data model for Heliophysics data among the [PyHC community](https://heliopython.org/). When this data model is complete, a function that converts `data` and `meta` to that data model will be included in the `hapiclient` package.
 
-# Development
+# Development and Testing
+
+## Testing Python versions available with tox-env
+
+As of 2026-04-14, Python 3.8+ is available with tox-env.
+
+```bash
+git clone https://github.com/hapi-server/client-python
+cd client-python; python -m pip install -e .
+
+# Run a specific test on current Python version (default is log_level=INFO
+# for hapiclient logger and test logger when executed this way).
+python test/test_hapi_data_requests.py
+
+# Run a specific test on a specific Python version with all logging
+tox -e py311 -- test/test_hapi_data_requests.py
+# Set log level for test logger
+tox -e py311 -- test/test_hapi_data_requests.py --log-level=INFO
+
+# Run a specific test on all Python versions set by tox.ini `envlist`
+tox -- test/test_hapi_data_requests.py
+
+# Run all tests in ./test
+tox
+
+# Run long-running tests
+tox -e long-test
+
+# Run long-running tests on a specific Python version
+tox -e long-test --override testenv:long-test.basepython=python3.11
+```
+
+## Testing Python versions available with Anaconda
+
+As of 2026-04-14, Python 3.5+ is available with Anaconda.
 
 ```bash
 git clone https://github.com/hapi-server/client-python
@@ -117,12 +141,13 @@ make repository-test
 
 To run an individual unit test in a Python session, use, e.g.,
 
-```python
-from hapiclient.test.test_hapi import test_reader_short
-test_reader_short()
+```bash
+cd test; python test_hapitime_reformat.py
 ```
 
 # Contact
 
 Submit bug reports and feature requests on the [repository issue
 tracker](https://github.com/hapi-server/client-python/issues>).
+
+Before submitting a pull request, please post an issue with the proposed changes for discussion prior to developing the pull request.

{hapiclient-0.2.6 → hapiclient-0.2.7}/hapiclient/__init__.py

@@ -10,9 +10,15 @@ from hapiclient.hapitime import datetime2hapitime
 # Allow "from hapiclient import HAPIError"
 from hapiclient.util import HAPIError
 
-__version__ = '0.2.6'
+__version__ = '0.2.7'
 
 import sys
+import platform
+
+if sys.version_info < (3, 10) and platform.system() == "Darwin":
+    import warnings
+    warnings.filterwarnings("ignore", message=".*urllib3.*OpenSSL.*")
+
 if sys.version_info[0] < 3:
     # Python 2.7
     reload(sys)

{hapiclient-0.2.6 → hapiclient-0.2.7}/hapiclient/hapi.py

@@ -4,6 +4,7 @@ import sys
 import json
 import time
 import pickle
+import logging as _logging
 import warnings
 from datetime import datetime, timedelta
 
@@ -13,7 +14,7 @@ import numpy as np
 from joblib import Parallel, delayed
 
 from hapiclient.hapitime import hapitime2datetime, hapitime_reformat
-from hapiclient.util import setopts, log, warning, error
+from hapiclient.util import setopts, log, warning, error, configure_logging
 from hapiclient.util import urlopen, urlretrieve, jsonparse, unicode_error_message
 
 
@@ -176,7 +177,7 @@ def hapiopts():
 def hapi(*args, **kwargs):
     """Request data from a HAPI server.
 
-    Version: 0.2.6
+    Version: 0.2.7
 
 
     Examples
@@ -250,7 +251,7 @@ def hapi(*args, **kwargs):
                     Cadence = PT1M and request for
 
                         start/stop=1999-11-12T00:10:00/stop=1999-11-12T12:09:00
-                        
+
                         Chunk size is P1D and requested time range < 1/2 of this
                         =>  Default behavior
 
@@ -344,7 +345,11 @@ def hapi(*args, **kwargs):
     # Override defaults
     opts = setopts(hapiopts(), kwargs)
 
-    assert (opts['logging'] in [True, False]), "logging keyword must be True of False"
+    assert (isinstance(opts['logging'], bool) or hasattr(opts['logging'], 'write')), \
+        "logging keyword must be True, False, or a file-like object"
+
+    configure_logging(opts)
+
     assert (opts['cache'] in [True, False]), "cache keyword must be True of False"
     assert (opts['usecache'] in [True, False]), "usecache keyword must be True of False"
     assert (opts['format'] in ['binary', 'csv']), "format keyword must be 'csv' or 'binary'"
@@ -408,7 +413,7 @@ def hapi(*args, **kwargs):
         # urld = url subdirectory of cachedir to store files from SERVER
         urld = cachedir(opts["cachedir"], SERVER)
 
-        if opts["cachedir"]: log('file directory = %s' % urld, opts)
+        if opts["cachedir"]: log('cache subdirectory = %s' % urld, opts)
 
         urljson = SERVER + '/info?id=' + DATASET
 
@@ -558,10 +563,13 @@ def hapi(*args, **kwargs):
 
             backend = 'sequential'
             if opts['parallel']:
+                # Note that this does not often lead to significant speed-up.
+                # Needs further testing and optimization.
                 backend = 'threading'
-                # multiprocessing was not tested. It may work, but will
-                # need a speed comparison with threading.
-                # backend = 'multiprocessing'
+                # multiprocessing not working.
+                #backend = 'multiprocessing'
+                # loky works, but not speed-up.
+                #backend = 'loky'
 
             log('backend = {}'.format(backend), opts)
 
@@ -663,14 +671,18 @@ def hapi(*args, **kwargs):
         if opts["usecache"] and os.path.isfile(fnamenpy):
             # Read cached data file.
             log('Reading %s ' % fnamenpy.replace(urld + '/', ''), opts)
+            tic = time.time()
             f = open(fnamenpy, 'rb')
             data = np.load(f)
             f.close()
+            toc = time.time() - tic
             # There is a possibility that the fnamenpy file existed but
             # fnamepklx was not found (b/c removed). In this case, the meta
             # returned will not have all of the "x_" information inserted below.
             # Code that uses this information needs to account for this.
             meta['x_totalTime'] = time.time() - tic_totalTime
+            meta['x_readTime'] = tic - tic_totalTime
+            meta['x_downloadTime'] = 0
             return data, meta
 
         cformats = ['csv', 'binary']  # client formats
@@ -812,13 +824,32 @@ def hapi(*args, **kwargs):
                             error('Malformed response? Could not read response: {}'.format(urlcsv))
                     if opts['method'] == '' or opts['method'] == 'pandas':
                         # Read file into Pandas DataFrame
+                        csv_kwargs = {
+                            'sep': ',',
+                            'header': None,
+                            'encoding': 'utf-8',
+                            'skipinitialspace': True,
+                            'keep_default_na': False,
+                            'na_values': ['NaN', 'nan', 'Nan', 'naN', ' "NaN"', ' "nan"', ' "Nan"', ' "naN"', '"NaN"', '"nan"', '"Nan"', '"naN"']
+                        }
+                        """
+                        Note that this does not handle trailing whitespace after
+                        any of the na_values. (There is no skiptrailingspace option).
+                        Stripping trailing whitespace would require adding something
+                        like
+                            def strip_field(x):
+                                # Strip whitespace and normalize NaN values.
+                                x = x.strip()
+                                return np.nan if x.lower() == "nan" else x
+
+                            ncols = cols[-1][1] + 1
+                            csv_kwargs["converters"] = {i: strip_field for i in range(ncols)}
+                        """
                         try:
-                            df = pandas.read_csv(fnamecsv,
-                                                 sep=',',
-                                                 header=None,
-                                                 encoding='utf-8')
+                            df = pandas.read_csv(fnamecsv, **csv_kwargs)
                         except:
                             error('Malformed response? Could not read response: {}'.format(urlcsv))
+
                         # Allocate output N-D array (It is not possible to pass dtype=dt
                         # as computed to pandas.read_csv; pandas dtype is different
                         # from numpy's dtype.)
@@ -865,7 +896,14 @@ def hapi(*args, **kwargs):
                 pickle.dump(meta, f, protocol=2)
 
             log('Writing %s' % fnamenpy, opts)
-            np.save(fnamenpy, data)
+            with warnings.catch_warnings():
+                # Ignore warning that occurs when saving Unicode data.
+                warnings.filterwarnings("ignore",
+                    message=r"Stored array in format 3\.0.*",
+                    category=UserWarning,
+                    module=r"numpy\.lib\.format",
+                )
+                np.save(fnamenpy, data)
 
         meta['x_totalTime'] = time.time() - tic_totalTime
 
@@ -963,9 +1001,28 @@ def parse_missing_length(fnamecsv, dt, cols, psizes, pnames, ptypes, opts):
     if opts['method'] == 'numpy' or opts['method'] == 'numpynolength':
         # If requested method was numpy, use numpynolength method.
 
-        # With dtype='None', the data type is determined automatically
-        table = np.genfromtxt(fnamecsv, dtype=None, deletechars='',
-                                delimiter=',', encoding='utf-8')
+        ncols = cols[-1][1] + 1
+
+        def normalize_field(value):
+            if isinstance(value, bytes):
+                value = value.decode('utf-8')
+            value = value.strip()
+            if len(value) >= 2 and value[0] == '"' and value[-1] == '"':
+                value = value[1:-1].strip()
+            if value.lower() == 'nan':
+                return 'nan'
+            return value
+
+        converters = {i: normalize_field for i in range(ncols)}
+
+        table = np.genfromtxt(fnamecsv,
+                              dtype=None,
+                              deletechars='',
+                              replace_space=' ',
+                              delimiter=',',
+                              encoding='utf-8',
+                              converters=converters)
+
         # table is a 1-D array. Each element is a row in the file.
         # - If the data types are not the same for each column,
         # the elements are tuples with length equal to the number
@@ -1010,8 +1067,17 @@ def parse_missing_length(fnamecsv, dt, cols, psizes, pnames, ptypes, opts):
     if opts['method'] == '' or opts['method'] == 'pandas' or opts['method'] == 'pandasnolength':
         # If requested method was pandas, use pandasnolength method.
 
+        # TODO: Duplicate code.
         # Read file into Pandas DataFrame
-        df = pandas.read_csv(fnamecsv, sep=',', header=None, encoding='utf-8')
+        csv_kwargs = {
+            'sep': ',',
+            'header': None,
+            'encoding': 'utf-8',
+            'skipinitialspace': True,
+            'keep_default_na': False,
+            'na_values': ['NaN', 'nan', 'Nan', 'naN', ' "NaN"', ' "nan"', ' "Nan"', ' "naN"', '"NaN"', '"nan"', '"Nan"', '"naN"']
+        }
+        df = pandas.read_csv(fnamecsv, **csv_kwargs)
 
         # Allocate output N-D array (It is not possible to pass dtype=dt
         # as computed to pandas.read_csv, so need to create new ND array.)

{hapiclient-0.2.6 → hapiclient-0.2.7}/hapiclient/hapitime.py

@@ -22,9 +22,9 @@ def hapitime_reformat(form_to_match, given_form, logging=False):
     ::
 
         start = hapitime_reformat(data['Time'][0], start)
-    
+
     Then subset using
-    
+
     ::
 
         data = data[data['Time'] >= start]
@@ -69,7 +69,7 @@ def hapitime_reformat(form_to_match, given_form, logging=False):
 
         converted = hapitime_reformat(form_to_match+'Z', given_form+'Z')
         converted = converted.strip('Z')
-        
+
         converted_fractional = '{:0<{}.{}}'.format(given_form_fractional, 
                                                    len(form_to_match_fractional),
                                                    len(form_to_match_fractional))
@@ -77,11 +77,11 @@ def hapitime_reformat(form_to_match, given_form, logging=False):
 
         if 'Z' in format_ref:
             return converted + 'Z'
-        
+
         return converted
 
     converted = dt_given.strftime(format_ref)
-    
+
     if len(converted) > len(form_to_match):
         converted = converted[0:len(form_to_match)-1] + "Z"
 
@@ -220,14 +220,9 @@ def hapitime2datetime(Time, **kwargs):
         hapitime2datetime([b'1970-01-01T00:00:00.000Z'])
         hapitime2datetime('1970-01-01T00:00:00.000Z')
     """
-    from datetime import datetime
+    from datetime import datetime, timezone
 
-    try:
-        # Python 2
-        import pytz
-        tzinfo = pytz.UTC
-    except:
-        tzinfo = datetime.timezone.utc
+    tzinfo = timezone.utc
 
     if type(Time) == list:
         Time = np.asarray(Time)
@@ -272,7 +267,8 @@ def hapitime2datetime(Time, **kwargs):
 
     try:
         # This is the fastest conversion option. But it will fail on YYYY-DOY
-        # format and other valid ISO 8601 dates such as 2001-01-01T00:00:03.Z
+        # format and other valid^* ISO 8601 dates such as 2001-01-01T00:00:03.Z
+        # ^*Maybe not: https://github.com/hapi-server/client-python/issues/76
         # When infer_datetime_format is used, a TimeStamp object returned,
         # which is the reason for the to_pydatetime() call. (When format=... is
         # used, a datetime object is returned.)
@@ -281,7 +277,11 @@ def hapitime2datetime(Time, **kwargs):
         # is the reason for the call to tz_convert(tzinfo).
         # TODO: Use hapitime_format_str() and pass this as format=...
         Timeo = Time[0]
-        Time = pandas.to_datetime(Time, infer_datetime_format=True).tz_convert(tzinfo).to_pydatetime()
+        pandas_major_version = int(pandas.__version__.split('.')[0])
+        if pandas_major_version < 2:
+            Time = pandas.to_datetime(Time, infer_datetime_format=True).tz_convert(tzinfo).to_pydatetime()
+        else:
+            Time = pandas.to_datetime(Time).tz_convert(tzinfo).to_pydatetime()
         if reshape:
             Time = np.reshape(Time, shape)
         toc = time.time() - tic

{hapiclient-0.2.6 → hapiclient-0.2.7}/hapiclient/util.py

@@ -1,3 +1,7 @@
+import logging as _logging
+_logger = _logging.getLogger("hapiclient")
+
+
 def setopts(defaults, given):
     """Override default keyword dictionary options.
 
@@ -19,34 +23,50 @@ def setopts(defaults, given):
     return defaults
 
 
-def log_test():
+_INTERNAL_HANDLER_ATTR = "_hapiclient_internal_handler"
+_INTERNAL_LEVEL_ATTR = "_hapiclient_internal_level"
+def configure_logging(opts):
+    """Configure the hapiclient logger based on opts['logging'].
 
-    log("Test 1", {"logging": True})
-    log("Test 2", {"logging": False})
+    If the hapiclient logger has been configured externally (level != NOTSET
+    or handlers present), the logging kwarg.
+    """
+    has_user_level = _logger.level != _logging.NOTSET and \
+                     _logger.level != getattr(_logger, _INTERNAL_LEVEL_ATTR, None)
+    has_user_handlers = any(
+        not getattr(handler, _INTERNAL_HANDLER_ATTR, False)
+        for handler in _logger.handlers
+    )
+
+    if opts['logging']:
+        _logger.setLevel(_logging.INFO)
+        setattr(_logger, _INTERNAL_LEVEL_ATTR, _logging.INFO)
+        _logger.propagate = False
+        if not _logger.handlers:
+            import sys
+            _handler = _logging.StreamHandler(sys.stdout)
+            _handler.setFormatter(_logging.Formatter("%(message)s"))
+            setattr(_handler, _INTERNAL_HANDLER_ATTR, True)
+            _logger.addHandler(_handler)
+    else:
+        if has_user_level or has_user_handlers:
+            if has_user_handlers:
+                log("Ignoring logging=%s because standard Python logger for 'hapiclient' already configured with handlers." % opts['logging'], opts)
+            else:
+                log("Ignoring logging=%s because standard Python logger for 'hapiclient' already configured with log_level != NOTSET." % opts['logging'], opts)
+        else:
+            _logger.setLevel(_logging.WARNING)
+            setattr(_logger, _INTERNAL_LEVEL_ATTR, _logging.WARNING)
 
 
 def log(msg, opts):
-    """Print message to console or file."""
+    """Log message using the 'hapiclient' logger."""
 
-    import os
     import sys
 
-    if not 'logging' in opts:
-        opts = opts.copy()
-        opts['logging'] = False
-
     pre = sys._getframe(1).f_code.co_name + '(): '
-    if isinstance(opts['logging'], bool) and opts['logging']:
-        if pythonshell() == 'jupyter-notebook':
-            # Don't show full path information.
-            msg = msg.replace(opts['cachedir'] + os.path.sep, '')
-            msg = msg.replace(opts['cachedir'], '')
-        print(pre + msg)
-    elif hasattr(opts['logging'], 'write'):
-        opts['logging'].write(pre + msg + "\n")
-        opts['logging'].flush()
-    else:
-        pass # TODO: error
+
+    _logger.info(pre + msg)
 
 
 def jsonparse(res, url):
@@ -107,6 +127,7 @@ def unicode_error_message(name):
     import sys
     msg = ""
     if sys.version_info[0:2] <= (3, 5):
+        name = str(name)
         if not all(ord(char) < 128 for char in name):
             msg = "hapiclient cannot handle Unicode dataset or parameter names (" + str(name.encode('utf-8')) + ") for Python < 3.6 on Windows."
     return msg

hapiclient-0.2.6/README.md → hapiclient-0.2.7/hapiclient.egg-info/PKG-INFO

@@ -1,3 +1,28 @@
+Metadata-Version: 2.4
+Name: hapiclient
+Version: 0.2.7
+Summary: Interface to Heliophysics data server API
+Home-page: http://pypi.python.org/pypi/hapiclient/
+Author: Bob Weigel
+Author-email: rweigel@gmu.edu
+License: LICENSE.txt
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: urllib3
+Requires-Dist: joblib
+Requires-Dist: isodate>=0.6.0
+Requires-Dist: pandas>=0.23
+Requires-Dist: numpy>=1.14.3
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
 [![DOI](https://zenodo.org/badge/93170857.svg)](https://zenodo.org/badge/latestdoi/93170857)
 [![Build Status](https://app.travis-ci.com/hapi-server/client-python.svg?branch=master)](https://app.travis-ci.com/hapi-server/client-python)
 
@@ -39,6 +64,7 @@ start      = '2003-09-01T00:00:00'
 stop       = '2003-12-01T00:00:00'
 parameters = 'DST1800'
 opts       = {'logging': True}
+# See misc/hapi_logging_demo.py for example of using conventional Python logging.
 
 # Get data
 data, meta = hapi(server, dataset, parameters, start, stop, **opts)
@@ -81,7 +107,41 @@ returns the [Numpy N-D array](https://docs.scipy.org/doc/numpy-1.15.1/user/quick
 
 The HAPI client data model is intentionally basic. There is an ongoing discussion of a data model for Heliophysics data among the [PyHC community](https://heliopython.org/). When this data model is complete, a function that converts `data` and `meta` to that data model will be included in the `hapiclient` package.
 
-# Development
+# Development and Testing
+
+## Testing Python versions available with tox-env
+
+As of 2026-04-14, Python 3.8+ is available with tox-env.
+
+```bash
+git clone https://github.com/hapi-server/client-python
+cd client-python; python -m pip install -e .
+
+# Run a specific test on current Python version (default is log_level=INFO
+# for hapiclient logger and test logger when executed this way).
+python test/test_hapi_data_requests.py
+
+# Run a specific test on a specific Python version with all logging
+tox -e py311 -- test/test_hapi_data_requests.py
+# Set log level for test logger
+tox -e py311 -- test/test_hapi_data_requests.py --log-level=INFO
+
+# Run a specific test on all Python versions set by tox.ini `envlist`
+tox -- test/test_hapi_data_requests.py
+
+# Run all tests in ./test
+tox
+
+# Run long-running tests
+tox -e long-test
+
+# Run long-running tests on a specific Python version
+tox -e long-test --override testenv:long-test.basepython=python3.11
+```
+
+## Testing Python versions available with Anaconda
+
+As of 2026-04-14, Python 3.5+ is available with Anaconda.
 
 ```bash
 git clone https://github.com/hapi-server/client-python
@@ -106,12 +166,13 @@ make repository-test
 
 To run an individual unit test in a Python session, use, e.g.,
 
-```python
-from hapiclient.test.test_hapi import test_reader_short
-test_reader_short()
+```bash
+cd test; python test_hapitime_reformat.py
 ```
 
 # Contact
 
 Submit bug reports and feature requests on the [repository issue
 tracker](https://github.com/hapi-server/client-python/issues>).
+
+Before submitting a pull request, please post an issue with the proposed changes for discussion prior to developing the pull request.