logging the package requirements update

Author: oskarhurst

LOGGING.md

@@ -170,6 +170,11 @@ The library can capture native DLL messages and route them through Python's logg
 4. Routes messages to Python logging with `[DLL]` prefix
 5. Cleans up the temporary file on close
 
+**Requirements:** Your HEC-DSS DLL must include the `zopenLog` function for DLL
+output capture to work. If `zopenLog` is not available, DLL messages will go
+directly to the console. To suppress console output when `zopenLog` is not
+available, set `message_level=0` (which is the default).
+
 ### Enabling DLL Capture
 
 ```python

poetry.lock

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hec-dss-python"
-version = "0.1.25"
+version = "0.1.26"
 description = "Python wrapper for the HEC-DSS file database C library."
 authors = ["Hydrologic Engineering Center"]
 license = "MIT"
@@ -10,6 +10,14 @@ packages = [{ include = "hecdss", from = "src" }]
 
 [tool.poetry.dependencies]
 python = "^3.9"
+numpy = "^1.20.0"
+# tzdata is needed for zoneinfo support on Windows
+tzdata = { version = "*", markers = "sys_platform == 'win32'" }
+# Optional dependency for downloading HEC-DSS binaries
+requests = { version = "^2.25.0", optional = true }
+
+[tool.poetry.extras]
+download = ["requests"]
 
 [tool.poetry.dev-dependencies]
 # Python Syntax highlighter, assume
@@ -68,4 +76,4 @@ build-backend = "setuptools.build_meta"
 log_cli = true
 log_cli_level = 'INFO'
 testpaths = ["tests"]
-pythonpath = "./src"
+pythonpath = ["./src", "./tests"]

pyproject.toml

@@ -0,0 +1,9 @@
+# Core dependencies for hec-dss-python
+numpy>=1.20.0
+
+# Required for timezone support on Windows
+tzdata; sys_platform == 'win32'
+
+# Optional: For downloading HEC-DSS binary libraries
+# Uncomment if you need to download the DLL/SO files:
+requests>=2.25.0

requirements.txt

@@ -1,6 +1,6 @@
 [metadata]
 name = hecdss
-version = 0.1.25
+version = 0.1.26
 author = Hydrologic Engineering Center
 author_email =hec.dss@usace.army.mil
 description = Python wrapper for the HEC-DSS file database C library.
@@ -19,8 +19,8 @@ packages = find:
 python_requires = >=3.8
 include_package_data = True
 install_requires =
-    numpy
-    tzdata
+    numpy>=1.20.0
+    tzdata; sys_platform == 'win32'
 
 [options.packages.find]
 where=src

setup.cfg

@@ -28,17 +28,21 @@
 class HecDss:
     """ Main class for working with DSS files
     """
-    def __init__(self, filename:str, enable_dll_logging:bool = False):
+    def __init__(self, filename:str, enable_dll_logging:bool = False, message_level:int = 0):
         """constructor for HecDSS
 
         Args:
             filename (str): DSS filename to be opened; it will be created if it doesn't exist.
             enable_dll_logging (bool): If True, capture DLL messages to Python logging. Default False.
+            message_level (int): DLL message level (0-15). Default 0 (silent).
         """
 
         self._native = _Native()
         self._dll_monitor = None
 
+        # Set DLL message level (0 = silent by default)
+        self._native.hec_dss_set_debug_level(message_level)
+
         # Setup DLL logging if requested
         if enable_dll_logging:
             self._setup_dll_logging()
@@ -75,14 +79,17 @@ def _setup_dll_logging(self):
         # Create temp log file
         log_file_path = self._dll_monitor.setup_temp_log_file()
 
-        # Tell DLL to use this log file
+        # Tell DLL to use this log file (requires zopenLog function in DLL)
         status = self._native.hec_dss_open_log_file(log_file_path)
+
         if status == 0:
-            # Start monitoring
+            # zopenLog worked, monitor the file
             self._dll_monitor.start_monitoring()
             logger.debug("DLL logging enabled, monitoring: %s", log_file_path)
         else:
-            logger.warning("Could not enable DLL log file, messages will not be captured")
+            # zopenLog not available, can't capture DLL output to file
+            logger.warning("zopenLog not available in DLL, cannot capture DLL output to file")
+            self._dll_monitor.stop_monitoring()
             self._dll_monitor = None
     @staticmethod
     def set_global_debug_level(level: int) -> None:

src/hecdss/hecdss.py

@@ -205,7 +205,7 @@ def configure_logging(
 class DllLogMonitor:
     """
     Monitors HEC-DSS log file and routes messages to Python logging.
-    Uses a temporary log file approach to capture DLL output.
+    Uses a temporary log file approach to capture DLL output when zopenLog is available.
     """
 
     def __init__(self, logger: logging.Logger):

src/hecdss/logging_config.py

@@ -91,6 +91,17 @@ def __hec_dss_set_value(self, name: str, value: int):
         f.restype = c_int
         f(name.encode("utf-8"), value)
 
+    def __hec_dss_set_string(self, name: str, value: str):
+        """Set a string parameter via zset."""
+        try:
+            f = self.dll.hec_dss_set_string
+            f.argtypes = [c_char_p, c_char_p]
+            f.restype = c_int
+            return f(name.encode("utf-8"), value.encode("utf-8"))
+        except AttributeError:
+            logger.warning("hec_dss_set_string function not found in DLL")
+            return -1
+
     # set debug level (0-15)
     # 0 - no output
     # 15 - max output

src/hecdss/native.py

@@ -3,7 +3,7 @@
 import unittest
 
 import numpy as np
-from file_manager import FileManager
+from .file_manager import FileManager
 
 from hecdss import ArrayContainer, HecDss
 

tests/test_array.py

@@ -3,7 +3,7 @@
 import unittest
 from datetime import datetime
 
-from file_manager import FileManager
+from .file_manager import FileManager
 
 from hecdss import Catalog, HecDss