casaconfig 1.0.2__py3-none-any.whl → 1.2.0__py3-none-any.whl

casaconfig/__main__.py

@@ -131,6 +131,10 @@ except casaconfig.RemoteError as exc:
     print("This is likely due to no network connection or bad connectivity to a remote site, wait and try again")
     sys.exit(1)
 
+except casaconfig.NoNetwork as exc:
+    print("No network seen, can not continue.")
+    sys.exit(1)
+
 except casaconfig.BadLock as exc:
     # the output produced by the update functions is sufficient, just re-echo the exception text itself
     print(str(exc))

casaconfig/private/CasaconfigErrors.py

@@ -36,7 +36,12 @@ class RemoteError(Exception):
 
 class NotWritable(Exception):
     """Raised when the path is not writable by the user"""
+    pass
 
 class UnsetMeasurespath(Exception):
     """Raised when a path argument is None"""
     pass
+
+class NoNetwork(Exception):
+    """Raised when there is no network connection."""
+    pass

casaconfig/private/data_available.py

@@ -36,7 +36,8 @@ def data_available():
        list - version names returned as list of strings
 
     Raises
-       - casaconfig.RemoteError - Raised when there is an error fetching some remote content
+       - casaconfig.NoNetwork - Raised where there is no network seen, can not continue
+       - casaconfig.RemoteError - Raised when there is an error fetching some remote content for some reason other than no network
        - Exception - Unexpected exception while getting list of available casarundata versions
 
     """
@@ -48,6 +49,12 @@ def data_available():
     import certifi
 
     from casaconfig import RemoteError
+    from casaconfig import NoNetwork
+
+    from .have_network import have_network
+
+    if not have_network():
+        raise NoNetwork("No network, can not find the list of available data.")
     
     class LinkParser(html.parser.HTMLParser):
         def reset(self):

casaconfig/private/data_update.py

@@ -17,7 +17,7 @@ this module will be included in the api
 
 def data_update(path=None, version=None, force=False, logger=None, auto_update_rules=False, verbose=None):
     """
-    Check for updates to the installed casarundata and install the update or change to 
+    Check for updates to the installed casarundata and install the update or change to
     the requested version when appropriate.
 
     The verbose argument controls the level of information provided when this function when the data
@@ -26,19 +26,19 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
 
     The path must contain a previously installed version of casarundata.
     Use pull_data to install casarundata into a new path (empty or does not exist).
-    
+
     If path is None then config.measurespath is used.
 
-    If the version is None (the default) then the most recent version returned by 
+    If the version is None (the default) then the most recent version returned by
     data_available is used.
 
-    If version is "release" then the version associated with the release in 
+    If version is "release" then the version associated with the release in
     the dictionary returned by get_data_info is used. If there is no release
-    version information available to casaconfig then an error message is printed 
+    version information available to casaconfig then an error message is printed
     and nothing is updated. Release version information is only available in
     monolithic CASA installations.
 
-    If a specific version is not requested (the default) and a check for the 
+    If a specific version is not requested (the default) and a check for the
     versions available for installation at path has been done within the past
     24 hours then this function does nothing even if there is a more
     recent version available from the CASA server unless force is True.
@@ -47,7 +47,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
     now) is installed even if that version is already installed or a check for the
     latest version has been done within the past 24 hours.
 
-    A text file (readme.txt at path) records the version string, the date 
+    A text file (readme.txt at path) records the version string, the date
     when that version was installed in path, and the files installed into path. That file
     must already exist in path in order to use this function. Use pull_data to install
     casarundata into a new location.
@@ -57,31 +57,31 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
     data_auto_update is True. Automatic updating happens during casatools initialization
     so that the updated casarundata and measures are in place before any tool needs to use them.
 
-    If an update is to be installed the previously installed files, as listed in the 
-    readme.txt file at path, are removed before the contents of the version 
+    If an update is to be installed the previously installed files, as listed in the
+    readme.txt file at path, are removed before the contents of the version
     being installed are unpacked. If the measures contents of path have been updated since
     the previously installed version of casarundata then those updates will also be removed
     by this data update while preparing to install the requested version of casarundata (which
-    includes a copy of the measures data that is likely older than today). A data update is 
-    typically followed by a measures_update to ensure that the most recent measures data 
+    includes a copy of the measures data that is likely older than today). A data update is
+    typically followed by a measures_update to ensure that the most recent measures data
     are installed.
 
     A file lock is used to prevent more that one data update (pull_data, measures_update,
-    or data_update) from updating any files in path at the same time. When locked, the 
+    or data_update) from updating any files in path at the same time. When locked, the
     lock file (data_update.lock in path) contains information about the process that
     has the lock. When data_update gets the lock it checks the readme.txt file in path
-    to make sure that an update is still necessary (if force is True then an update 
+    to make sure that an update is still necessary (if force is True then an update
     always happens). If the lock file is not empty then a previous update of path (pull_data,
     data_update, or measures_update) did not exit as expected or is still in process (via a
-    separate instance of CASA) and the contents of path may be suspect. In that case, 
-    an error will be reported and nothing will be updated. The lock file can be checked to 
-    see the details of when that file was locked. The lock file can be removed and data_update 
+    separate instance of CASA) and the contents of path may be suspect. In that case,
+    an error will be reported and nothing will be updated. The lock file can be checked to
+    see the details of when that file was locked. The lock file can be removed and data_update
     can be tried again. It may be safest in that case to remove path completely or use a
     different path and use pull_data to install a fresh copy of the desired version.
 
-    Some of the tables installed by data_update are only read when casatools starts. Use of 
-    data_update except during CASA startup by the auto update proess  should typically be 
-    followed by a restart of CASA so that any changes are seen by the tools and tasks that 
+    Some of the tables installed by data_update are only read when casatools starts. Use of
+    data_update except during CASA startup by the auto update proess  should typically be
+    followed by a restart of CASA so that any changes are seen by the tools and tasks that
     use this data.
 
     **Note:** data_update requires that the expected readme.txt file already exists at the top-level
@@ -101,10 +101,10 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
        - logger (casatools.logsink=None) - Instance of the casalogger to use for writing messages. Default None writes messages to the terminal.
        - auto_update_rules (bool=False) - If True then the user must be the owner of path, version must be None, and force must be False.
        - verbose (int) - Level of output, 0 is none, 1 is to logger, 2 is to logger and terminal, defaults to casaconfig_verbose in the config dictionary.
-        
+
     Returns
        None
-    
+
     Raises
        - casaconfig.AutoUpdatesNotAllowed - raised when path does not exist as a directory or is not owned by the user
        - casaconfig.BadLock - raised when the lock file was not empty when an attempt was made to obtain the lock
@@ -167,7 +167,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
     # path must be writable with execute bit set
     if (not os.access(path, os.W_OK | os.X_OK)) :
         raise NotWritable('data_update: No permission to write to %s, cannot update.' % path)
-    
+
     # try and digest the readme file
 
     installed_files = []
@@ -177,7 +177,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
 
     # already checked that path is OK, type is OK here, no need to trap for exceptions here
     dataReadmeInfo = get_data_info(path, logger, type='casarundata')
-    
+
     if dataReadmeInfo is None or dataReadmeInfo['version'] == 'invalid':
         msgs = []
         msgs.append('The readme.txt file at path could not be read as expected')
@@ -262,7 +262,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
             else:
                 if verbose > 0:
                     print_log_messages('Requested casarundata version is already installed in %s, %s' % (path, currentVersion), logger, verbose=verbose)
-                
+
             # no lock has been set yet, safe to simply return here
             return
 
@@ -307,7 +307,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
                         # always verbose here because the lock file is in use
                         print_log_messages('requested version is already installed.', logger)
                     do_update = False
-                    
+
             if do_update:
                 # update is still on, check the manifest
                 if len(installed_files) == 0:
@@ -330,7 +330,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
 
     except BadLock as exc:
         # the path is known to exist so this means that the lock file was not empty and it's not locked
-        msgs = str(exc)
+        msgs = [str(exc)]
         msgs.append('data_update: the lock file at %s is not empty.' % path)
         msgs.append('A previous attempt to update path may have failed or exited prematurely.')
         msgs.append('Remove the lock file and set force to True with the desired version (default to most recent).')
@@ -341,7 +341,7 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
 
     except BadReadme as exc:
         # something is wrong in the readme after an update was triggered, this shouldn't happen, print more context reraise this
-        msgs = str(exc)
+        msgs = [str(exc)]
         msgs.append('This should not happen unless multiple sessions are trying to update data at the same time and one experienced problems or was done out of sequence')
         msgs.append('Check for other updates in progress or choose a different path or clear out this path and try again using pull_data or update_all')
         print_log_messages(msgs, logger, True)
@@ -360,5 +360,5 @@ def data_update(path=None, version=None, force=False, logger=None, auto_update_r
             if clean_lock:
                 lock_fd.truncate(0)
             lock_fd.close()
-    
+
     return

casaconfig/private/get_data_lock.py

@@ -29,6 +29,9 @@ def get_data_lock(path, fn_name):
 
     This function is intended for internal casaconfig use.
 
+    If there is not network (have_network returns False) then the lock file is not
+    set or initialized and a NoNetwork exception is raised.
+
     Parameters
        - path (str) - The location where 'data_update.log' is to be found.
        - fn_name (str) - A string giving the name of the calling function to be recorded in the lock file.
@@ -37,6 +40,7 @@ def get_data_lock(path, fn_name):
        - the open file descriptor holding the lock. Close this file descriptor to release the lock.
 
     Raises:
+        - casaconfig.NoNetwork - raised wheren there is no network, nothing can be downloaded so nothing should be locked.
         - casaconfig.BadLock - raised when the path to the lock file does not exist or the lock file is not empty as found
         - Exception - an unexpected exception was seen while writing the lock information to the file
 
@@ -48,6 +52,11 @@ def get_data_lock(path, fn_name):
     from datetime import datetime
 
     from casaconfig import BadLock
+    from casaconfig import NoNetwork
+    from .have_network import have_network
+
+    if not have_network():
+        raise NoNetwork("No network, lock file has not been set, unable to continue.")
 
     if not os.path.exists(path):
         raise BadLock("path to contain lock file does not exist : %s" % path)

casaconfig/private/have_network.py

@@ -0,0 +1,40 @@
+# Copyright 2025 AUI, Inc. Washington DC, USA
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+
+import urllib.request
+import urllib.error
+
+def have_network():
+    """
+    check to see if an active network with general internet connectivity
+    is available. returns True if we have internet connectivity and
+    False if we do not.
+    """
+    ###
+    ### see: https://stackoverflow.com/questions/50558000/test-internet-connection-for-python3
+    ###
+    ### copied from in casagui/utils/__init__.py
+    ###
+    try:
+        with urllib.request.urlopen('http://clients3.google.com/generate_204') as response:
+            return response.status == 204
+    except urllib.error.HTTPError:
+        ### http error
+        return False
+    except urllib.error.ContentTooShortError:
+        return False
+    except urllib.error.URLError:
+        return False
+    except Exception:
+        return False

casaconfig/private/measures_available.py

@@ -32,7 +32,8 @@ def measures_available():
        version names returned as list of strings
 
     Raises:
-       - casaconfig.RemoteError - raised when when a socket.gaierror is seen, likely due to no network connection
+       - casaconfig.NoNetwork - raised when there is no network (have_data returns False)
+       - casaconfig.RemoteError - raised when when a socket.gaierror is seen, unlikely due to the have_network check
        - Exception: raised when any unexpected exception happens
 
     """
@@ -40,7 +41,13 @@ def measures_available():
     import socket
 
     from casaconfig import RemoteError
+    from casaconfig import NoNetwork
 
+    from .have_network import have_network
+
+    if not have_network():
+        raise NoNetwork("can not find the list of available measures data")
+    
     files = []
     try:
         ftp = FTP('ftp.astron.nl')

casaconfig/private/measures_update.py

@@ -119,7 +119,8 @@ def measures_update(path=None, version=None, force=False, logger=None, auto_upda
        casaconfig.BadReadme - raised when something unexpected is found in the readme or the readme changed after an update is in progress
        casaconfig.NoReadme - raised when the readme.txt file is not found at path (path also may not exist)
        casaconfig.NotWritable - raised when the user does not have permission to write to path
-       casaconfig.RemoteError - raised by measures_available when the remote list of measures could not be fetched
+       casaconfig.NoNetwork - raised by measuers_available or when getting the lock file if there is no network.
+       casaconfig.RemoteError - raised by measures_available when the remote list of measures could not be fetched, not due to no network.
        casaconfig.UnsetMeasurespath - raised when path is None and has not been set in config
        Exception - raised when something unexpected happened while updating measures
     
@@ -138,7 +139,7 @@ def measures_update(path=None, version=None, force=False, logger=None, auto_upda
     import fcntl
 
     from casaconfig import measures_available
-    from casaconfig import AutoUpdatesNotAllowed, UnsetMeasurespath, RemoteError, NotWritable, BadReadme, BadLock, NoReadme
+    from casaconfig import AutoUpdatesNotAllowed, UnsetMeasurespath, RemoteError, NotWritable, BadReadme, BadLock, NoReadme, NoNetwork
 
     from .print_log_messages import print_log_messages
     from .get_data_lock import get_data_lock
@@ -208,8 +209,11 @@ def measures_update(path=None, version=None, force=False, logger=None, auto_upda
             # get the current most recent version
             try:
                 checkVersion = measures_available()[-1]
-            except RemoteError as exc:
+            except NoNetwork as exc:
                 # no network, no point in continuing, just reraise
+                raise exc
+            except RemoteError as exc:
+                # bad network?, no point in continuing, just reraise
                 raise exc                
             except:
                 # unsure what happened, leave it at none, which will trigger an update attempt, which might work

casaconfig/private/pull_data.py

@@ -22,15 +22,15 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     The verbose argument controls the level of information provided when this function when the data
     are unchanged for expected reasons. A level of 0 prints and logs nothing. A
     value of 1 logs the information and a value of 2 logs and prints the information.
-  
-    The path must either contain a previously installed version of casarundata 
+
+    The path must either contain a previously installed version of casarundata
     or it must not exist or be empty.
 
     If path is None then config.measurespath will be used.
 
     If version is None (the default) then the most recent version is pulled.
 
-    If version is "release" then the version associated with the release in 
+    If version is "release" then the version associated with the release in
     the dictionary returned by get_data_info is used. If there is no release
     version information known then an error message is printed and nothing is
     checked or installed.
@@ -43,20 +43,20 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
 
     A text file (readme.txt at path) records the version string, the date
     when that version was installed in path, and the files installed into path.
-    This file is used to determine if the contents are a previously installed 
+    This file is used to determine if the contents are a previously installed
     version. If path is not empty then this file must exist with the expected
     contents in order for pull_data to proceed.
 
-    If the version to be pulled matches the version in the readme.txt file then 
+    If the version to be pulled matches the version in the readme.txt file then
     pull_data does nothing unless force is True. No error messages will result when the
     version already matches what was previously installed (no installation is then
     necessary unless force is True).
 
-    The measures tables included in casarundata will typically not be the most 
+    The measures tables included in casarundata will typically not be the most
     recent version. To get the most recent measures data, measures_update
     should be used after pull_data.
 
-    If path contains a previously installed version then all of the files listed in 
+    If path contains a previously installed version then all of the files listed in
     the manifest part of the readme.txt file are first removed from path. This ensures
     that files not present in the version being installed are removed in moving to the
     other version.
@@ -65,23 +65,23 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     or data_update) from updating any files in path at the same time. When locked, the
     lock file (data_update.lock in path) contains information about the process that
     has the lock. When pull_data gets the lock it checks the readme.txt file in path
-    to make sure that a copy of the data should still be pulled (the version doesn't 
+    to make sure that a copy of the data should still be pulled (the version doesn't
     match what was requested, or force is True). If the lock file is not
     empty then a previous update of path (pull_data, data_update, or measures_update)
     did not exit as expected and the contents of path are suspect. In that case, pull_data
     will report that as an error and nothing will be updated. The lock file can be checked
     to see the details of when that file was locked. The lock file can be removed and
     pull_data can then be used to install the desired version. It may be safest in that case
-    to remove path completely or use a different path and run pull_data to install 
+    to remove path completely or use a different path and run pull_data to install
     a fresh copy of the desired version.
 
-    Some of the tables installed by pull_data are only read when casatools starts. Use of 
-    pull_data should typically be followed by a restart of CASA so that 
+    Some of the tables installed by pull_data are only read when casatools starts. Use of
+    pull_data should typically be followed by a restart of CASA so that
     any changes are seen by the tools and tasks that use this data.
 
     **Note:** When version is None (the default), data_available is always used to find out
     what versions are available. There is no check on when the data were last updated before
-    calling data_available (as there is in the two update functions). 
+    calling data_available (as there is in the two update functions).
 
     Parameters
        - path (str) - Folder path to place casarundata contents. It must be empty or not exist or contain a valid, previously installed version. If not set then config.measurespath is used.
@@ -96,8 +96,9 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     Raises
        - casaconfig.BadLock - raised when the lock file is not empty when a lock is requested
        - casaconfig.BadReadme - raised when the readme.txt file found at path does not contain the expected list of installed files or there was an unexpected change while the data lock is on
+       - casaconfig.NoNetwork - raised where this is no network
        - casaconfig.NotWritable - raised when the user does not have write permission to path
-       - casaconfig.RemoteError - raised by data_available when the list of available data versions could not be fetched
+       - casaconfig.RemoteError - raised by data_available when the list of available data versions could not be fetched for some reason other than no network
        - casaconfig.UnsetMeasurespath - raised when path is None and and measurespath has not been set in config.
 
     """
@@ -131,7 +132,7 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     available_data = None
     currentVersion = None
     currentDate = None
-    
+
     # attempt a pull if path does not exist or is empty (except for any lock file, handled later)
     readmeInfo = get_data_info(path, logger, type='casarundata')
     do_pull = readmeInfo is None
@@ -164,11 +165,11 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
             # this shouldn't happen
             # no lock has been set yet, safe to raise this exception without worrying about the lock
             raise BadReadme('pull_data: the readme.txt file at path did not contain the expected list of installed files')
-            
+
         # the readme file looks as expected, pull if the version is different or force is true
         if version is None:
             # use most recent available
-            # this may raise a RemoteError, no need to catch that here but it may need to be caught upstream
+            # this may raise RemoteError or NoNetwork, no need to catch that here but it may need to be caught upstream
             available_data = data_available()
             version = available_data[-1]
 
@@ -179,16 +180,16 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
             # safe to return here, no lock has been set
             print_log_messages('pull_data: version is already at the expected version and force is False. Nothing was changed', logger, verbose=verbose)
             return
-        
+
     # a pull will happen, unless the version string is not available
 
     if version is None:
         # need a version, use most recent available
-        
+
         if available_data is None:
-            # this may raise a RemoteError, no need to catch that here but it may need to be caught upstream
+            # this may raise RemoteError or NoNetwork, no need to catch that here but it may need to be caught upstream
             available_data = data_available()
-            
+
         version = available_data[-1]
 
     expectedMeasuresVersion = None
@@ -203,9 +204,9 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     else:
         # requested version must be available
         if available_data is None:
-            # this may raise a RemoteError, no need to catch that here but it may need to be caught upstream
+            # this may raise RemoteError or NoNetwork, no need to catch that here but it may need to be caught upstream
             available_data = data_available()
-            
+
         if version not in available_data:
             print_log_messages('version %s not found on CASA server, use casaconfig.data_available() for a list of casarundata versions' % version, logger, True)
             return
@@ -224,9 +225,10 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
     try:
         print_log_messages('pull_data using version %s, acquiring the lock ... ' % version, logger)
 
+        # attempting to get the lock will raise NoNetwork if there is no network and the lock will not be set, catch and reemit that in this try block
         lock_fd = get_data_lock(path, 'pull_data')
         # the BadLock exception that may happen here is caught below
-        
+
         do_pull = True
         if not force:
             # need to recheck any readme file that may be present here
@@ -283,7 +285,7 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
 
     except BadLock as exc:
         # the path is known to exist so this means that the lock file was not empty and it's not locked
-        msgs = str(exc)
+        msgs = [str(exc)]
         msgs.append('The lock file at %s is not empty.' % path)
         msgs.append('A previous attempt to update path may have failed or exited prematurely.')
         msgs.append('It may be best to completely repopulated path using pull_data and measures_update.')
@@ -292,12 +294,16 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
         raise
     except BadReadme as exc:
         # something is wrong in the readme after an update was triggered and locked, this shouldn't happen, print more context and reraise this
-        msgs = str(exc)
+        msgs = [str(exc)]
         msgs.append('This should not happen unless multiple sessions are trying to update data at the same time and one experienced problems or was done out of sequence')
         msgs.append('Check for other updates in progress or choose a different path or clear out this path and try again')
         print_log_messages(msgs, logger, True)
         raise
-    
+
+    except NoNetwork as exc:
+        # there is no network, it should be self explanatory so just re-raise it
+        raise
+
     except Exception as exc:
         msgs = []
         msgs.append('ERROR! : Unexpected exception while populating casarundata version %s to %s' % (version, path))
@@ -311,5 +317,5 @@ def pull_data(path=None, version=None, force=False, logger=None, verbose=None):
             if clean_lock:
                 lock_fd.truncate(0)
             lock_fd.close()
-        
+
     return

{casaconfig-1.0.2.dist-info → casaconfig-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: casaconfig
-Version: 1.0.2
+Version: 1.2.0
 Summary: CASA Operational Configuration Package
 Author-email: National Radio Astronomy Observatory <casa-feedback@nrao.edu>
 License:                                  Apache License
@@ -212,6 +212,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: certifi>=2023.5.7
+Dynamic: license-file
 
 # casaconfig
 Runtime data necessary for CASA operation.
@@ -264,3 +265,29 @@ dist
 ├── casaconfig-[VERSION]-py3-none-any.whl
 └── casaconfig-[VERSION].tar.gz
 ```
+
+### Setting up CASA branches for casaconfig development
+
+The casaconfig build process publishes test wheels to test.pypi.org
+
+In order to test these with Casa packages, two changes are needed in the casa6 repository branch.
+
+1) Add a line to casa6/build.conf with the appropriate wheel version. For example:
+
+```
+casaconfig==1.0.3.dev2
+```
+2) Add the following line with the apppropriate branch name to casa6/casatools/setup.py
+
+```
+META_DATA["install_requires"] = "casaconfig@git+https://github.com/casangi/casaconfig@CAS-14512"
+```
+
+This adds the casaconfig branch as a casatools install time dependency. It will not use the wheel, but rather build the branch in place. This is required in order to avoid adding test.pypi.org as a pip extra-index-url, which might cause other development packages to be installed inadvertently. Note that casaconfig dependency is typically defined in setup.cfg, but the syntax above does not work with setup.cfg. 
+
+
+### Preparing the casa6 branch for merge
+
+1) Merge the casaconfig branch to main and create a wheel
+2) Update casa6/build.conf to use that wheel
+3) Comment out the extra "install_requires" line from setup.py

{casaconfig-1.0.2.dist-info → casaconfig-1.2.0.dist-info}/RECORD

@@ -1,31 +1,32 @@
 casaconfig/__init__.py,sha256=T-XMwDexm45ndO5gNlpg3kSJoi2EG7TM5VlHHjs70UU,646
-casaconfig/__main__.py,sha256=pcuffTdiKEjAkhbQlxGnZzGYf3dSy7CEvWD0kwh7cyU,7440
+casaconfig/__main__.py,sha256=rmkK1hRFQSwNoVDJ3AV8Ht_36VY4DAceglevbcBNHcA,7541
 casaconfig/config.py,sha256=yIB7h5xwAbK40o7lIAAkXnvmLO_IU9km1XMwdvFx-tg,7172
-casaconfig/private/CasaconfigErrors.py,sha256=21T38zLkoCXz0AYx9liVVffjFPDaV5tBLEn9AcDz4uc,1418
+casaconfig/private/CasaconfigErrors.py,sha256=5jgBGiFSussmC7tUAA-w0awYx-7hC6Dhv_OXNihJkkY,1519
 casaconfig/private/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 casaconfig/private/casasiteconfig_example.py,sha256=J5C9an1iVhxqSbtYT_FiopDXx8SZDcVQkLWKufA_fnc,653
 casaconfig/private/config_defaults.py,sha256=I-bY_rJqP_asidNgdKj4MkPHaY6oQFxgENLsw81mdBw,2054
 casaconfig/private/config_defaults_static.py,sha256=2XwR6FPBMgMVw8hbw-S6OGSlIa3HC4ejyeC1FvIBDAE,2137
-casaconfig/private/data_available.py,sha256=GNGUgg2V5Y5s2IZWQKaw7zjOFnCi4rEahhH7NI3gaXw,3453
-casaconfig/private/data_update.py,sha256=3oqyQab8aqcp2GGTBYBEZ0pBKTGeapU2Uq6BXMxznPg,20623
+casaconfig/private/data_available.py,sha256=hvQGFix5G4C6iJ3_6v05OqHxqMxzecZwAR0-t9Jlhh0,3768
+casaconfig/private/data_update.py,sha256=Ot9SY4249rfU3CMnyg5LFdB5KfnAZsJoGEuHIT5DGZA,20545
 casaconfig/private/do_auto_updates.py,sha256=sYO5PVG34BXwtHNb8Tawop1Okwt9OTjbSTIwzf0skbs,3418
 casaconfig/private/do_pull_data.py,sha256=F7AXX0py2gNWhCAiOrMUPU5n9gQUACjiyYhdlRp5igM,6574
 casaconfig/private/get_argparser.py,sha256=-pwPMplwBJssSiEOVte89MqBRuxbZ3jLNVluQrv_eGc,1670
 casaconfig/private/get_config.py,sha256=R_6lZ3hp9NNbfBBhrOBBieXDFhR6Q3MdGHSgUwICbzk,1590
 casaconfig/private/get_data_info.py,sha256=onOcl2f0qfxFpQ3DuATh97-Ixr4IcBGtlZzNspROtPQ,12467
-casaconfig/private/get_data_lock.py,sha256=r2sju4havqRRDaLRbD6aHAKulemuVWH0D16r77xTYjQ,3347
+casaconfig/private/get_data_lock.py,sha256=JysF75EHwP2FErjffMkfeV-9wy5wJJ9irPDrMvVzSIo,3809
+casaconfig/private/have_network.py,sha256=zCIbABTG_9ew9Ac3eb8ggNaZ_H61m_G4LCXkFZe7q5M,1410
 casaconfig/private/io_redirect.py,sha256=9mwl2siS3fFYCEi_u9Mojg7cBtBgzW00mc8H7V1NSEs,2879
-casaconfig/private/measures_available.py,sha256=rTvwuuTrF8hbevvuhzPHqraXJSIZCzsYZvXU9PeLE7A,2061
-casaconfig/private/measures_update.py,sha256=diH-GNn87wTlPmXaBbPk-1qv9qY-bnaEO8un8KCr47g,20738
+casaconfig/private/measures_available.py,sha256=OWYmSSUhDqeOGHXBBd6Fwb74O0iJdq8LZx3vIjQNjq4,2343
+casaconfig/private/measures_update.py,sha256=xs84pMWG2263qLlz1y4cFTdUH32QR7ZYxJM3TdhiyRk,21018
 casaconfig/private/print_log_messages.py,sha256=mZNSxHBgrSz7KTkCEdRgxohSuAPWSgKpF_06sIuyft0,2204
-casaconfig/private/pull_data.py,sha256=3_aFBweGbNLSFDm2jS-7TuL32OZFP17_xKaefCAx0OM,17059
+casaconfig/private/pull_data.py,sha256=nYYQLxlf4F6_8uzchfmHn6WvYV4wzjOP58_kc8uZYXk,17385
 casaconfig/private/read_readme.py,sha256=T9mcG5KhQIHM6N9AgW4XJ2nKsHtI1Fa3iDgr8xMABLM,2137
 casaconfig/private/set_casacore_path.py,sha256=yLAh4tNoUbWczuCIVpIJx6nx8p9jRm0lUjexrpMhA-A,2240
 casaconfig/private/summary.py,sha256=jUtc5uLnEk1kljPpZa3UimhJAqVnDzMPUCD7OOznohE,3448
 casaconfig/private/update_all.py,sha256=57ynk0JJqyMpS1ABmma7F-kFSEnbhU4ZvoSuXQdEJrQ,5501
-tests/test_casaconfig.py,sha256=Xmn2hbw0SQ2PJ9BzQCg33EKB4413jvs0qHj5k4Rmfnk,42214
-casaconfig-1.0.2.dist-info/LICENSE,sha256=OMpzmn2zUn6I4jmVqs1Coa_0NJcoJC9eweZ2gx-u0oI,11358
-casaconfig-1.0.2.dist-info/METADATA,sha256=c_3LjyPjNmd8064vIT-gYdBiHtrbaErmBNYRt-oMwxA,15799
-casaconfig-1.0.2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-casaconfig-1.0.2.dist-info/top_level.txt,sha256=Uay9WTPz644aHfLbmj47WXzue19HtKRueFFCXu1N1Co,17
-casaconfig-1.0.2.dist-info/RECORD,,
+casaconfig-1.2.0.dist-info/licenses/LICENSE,sha256=OMpzmn2zUn6I4jmVqs1Coa_0NJcoJC9eweZ2gx-u0oI,11358
+tests/test_casaconfig.py,sha256=yeycDBOzwHsDeYAyIEmj1RNsZ3k6l7SYXFY-p2F1l7A,43963
+casaconfig-1.2.0.dist-info/METADATA,sha256=FgH21gS9u3DnuaBmrv73BT5loG6czZM224FHqUyqdK8,16981
+casaconfig-1.2.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+casaconfig-1.2.0.dist-info/top_level.txt,sha256=Uay9WTPz644aHfLbmj47WXzue19HtKRueFFCXu1N1Co,17
+casaconfig-1.2.0.dist-info/RECORD,,

{casaconfig-1.0.2.dist-info → casaconfig-1.2.0.dist-info}/WHEEL

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

tests/test_casaconfig.py

@@ -750,6 +750,44 @@ class casaconfig_test(unittest.TestCase):
         # these tests requires an already installed set of data
         self.populate_testrundata()
 
+        # BadLock
+        print("\nTesting for BadLock in test_exceptions_with_data")
+        # insert a non-empty lock file
+        exceptionSeen = False
+        lockPath = os.path.join(self.testRundataPath,'data_update.lock')
+        with open(lockPath,'w') as f:
+            f.write("test lock file, not empty")
+
+        # with measures_update
+        try:
+            exceptionSeen = False
+            # try to install an older measures, should fail because of the lock file
+            ma = casaconfig.measures_available()
+            casaconfig.measures_update(self.testRundataPath, version=ma[0])
+        except casaconfig.BadLock as exc:
+            exceptionSeen = True
+        except Exception as exc:
+            print("unexepected exception seen while testing for expected BadLock exception in measures_update")
+            print(str(exc))
+        self.assertTrue(exceptionSeen, "BadLock not seen as expected in measures_update with existing data test in")
+        
+        # with data_update
+        try:
+            exceptionSeen = False
+            # try to install an older measures, should fail because of the lock file
+            da = casaconfig.data_available()
+            casaconfig.data_update(self.testRundataPath, version=da[0])
+        except casaconfig.BadLock as exc:
+            exceptionSeen = True
+        except Exception as exc:
+            print("unexepected exception seen while testing for expected BadLock exception in data_update")
+            print(str(exc))
+        self.assertTrue(exceptionSeen, "BadLock not seen as expected in data_update with existing data test")
+        # remove the lock file
+        os.remove(lockPath)
+        print("BadLock test passed in test_exceptions_with_data\n")
+            
+
         # BadReadme
 
         # create a bad data readme.txt file from the valid one