Fix log levels

CITATION.cff

@@ -30,5 +30,5 @@ keywords:
   - single-dish
   - submillimeter
 license: MIT
-version: 0.4.0
-date-released: '2026-02-24'
+version: 0.5.0
+date-released: '2026-03-09'

README.md

@@ -6,7 +6,7 @@
 [![DOI](https://img.shields.io/badge/DOI-10.5281/zenodo.18709559-cornflowerblue?style=flat-square)](https://doi.org/10.5281/zenodo.18709559)
 [![Tests](https://img.shields.io/github/actions/workflow/status/finerreceiver/drs4/tests.yaml?label=Tests&style=flat-square)](https://github.com/finerreceiver/drs4/actions)
 
-Control and data acquisition for FINER/DRS4
+Control and data acquisition software for FINER/DRS4
 
 ## Installation
 

docs/_static/switcher.json

@@ -1,9 +1,14 @@
 [
     {
-        "name": "0.4.0 (latest)",
-        "version": "0.4.0",
+        "name": "0.5.0 (latest)",
+        "version": "0.5.0",
         "url": "https://finerreceiver.github.io/drs4/"
     },
+    {
+        "name": "0.4.0",
+        "version": "0.4.0",
+        "url": "https://finerreceiver.github.io/drs4/0.4.0/"
+    },
     {
         "name": "0.3.0",
         "version": "0.3.0",

docs/build

@@ -5,4 +5,4 @@ export LC_ALL=C.UTF-8
 
 sphinx-apidoc -efMT -d 2 -o docs/_apidoc drs4
 sphinx-build -a -b html docs docs/_build
-sphinx-build -a -b html docs docs/_build/0.4.0
+sphinx-build -a -b html docs docs/_build/0.5.0

docs/conf.py

@@ -18,6 +18,6 @@
     ],
     "switcher": {
         "json_url": "https://finerreceiver.github.io/drs4/_static/switcher.json",
-        "version_match": "0.4.0",
+        "version_match": "0.5.0",
     },
 }

drs4/__init__.py

@@ -1,5 +1,5 @@
 __all__ = ["ctrl", "daq", "qlook", "obs", "specs", "utils"]
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 
 
 # standard library

drs4/ctrl/cw.py

@@ -84,12 +84,12 @@ def on(
     else:
         raise ValueError("Signal sideband must be USB|LSB.")
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info("(")
+    LOGGER.debug(")")
 
     send_commands(
         [
@@ -128,12 +128,12 @@ def off(
     if sg_port is None:
         sg_port = int(getenv(ENV_SG_PORT, ""))
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info(")")
+    LOGGER.debug(")")
 
     send_commands(
         "OUTP OFF",
@@ -166,16 +166,17 @@ def status(
     if sg_port is None:
         sg_port = int(getenv(ENV_SG_PORT, ""))
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info(")")
+    LOGGER.debug(")")
 
-    send_commands(
+    for message in send_commands(
         ["AMPL?", "FREQ?", "OUTP?"],
         host=sg_host,
         port=sg_port,
         timeout=timeout,
-    )
+    ):
+        LOGGER.info(message)

drs4/ctrl/scpi.py

@@ -54,7 +54,11 @@ def recv(
 
 
 def connect(
-    host: str, port: int, timeout: float | None = DEFAULT_TIMEOUT
+    host: str,
+    port: int,
+    /,
+    *,
+    timeout: float | None = DEFAULT_TIMEOUT,
 ) -> CustomSocket:
     """Connect to an SCPI server and returns a custom socket object.
 
@@ -89,19 +93,20 @@ def connect(
     sock = CustomSocket(AF_INET, SOCK_STREAM)
     sock.settimeout(timeout)
     sock.connect((host, port))
-
     return sock
 
 
 def send_commands(
     commands: IO[str] | Sequence[str] | str,
+    /,
+    *,
     host: str,
     port: int,
     timeout: float | None = DEFAULT_TIMEOUT,
     encoding: str = DEFAULT_ENCODING,
     autorecv: bool = DEFAULT_AUTORECV,
     bufsize: int = DEFAULT_BUFSIZE,
-) -> None:
+) -> tuple[str, ...]:
     """Send SCPI command(s) to a server.
 
     Args:
@@ -115,7 +120,7 @@ def send_commands(
         bufsize: Maximum byte size for receiving a message.
 
     Returns:
-        This function returns nothing.
+        Tuple of the received messages.
 
     Examples:
         To send an SCPI command to the server::
@@ -137,26 +142,32 @@ def send_commands(
     if isinstance(commands, str):
         commands = (commands,)
 
-    with connect(host, port, timeout) as sock:
+    with connect(host, port, timeout=timeout) as sock:
+        messages: list[str] = []
+
         for command in commands:
             if not command or command.startswith("#"):
                 continue
 
             sock.send(command.strip(), encoding=encoding)
 
             if autorecv and command.endswith("?"):
-                sock.recv(bufsize)
+                messages.append(sock.recv(bufsize))
+
+        return tuple(messages)
 
 
 def send_commands_in(
     path: StrPath,
+    /,
+    *,
     host: str,
     port: int,
     timeout: float | None = DEFAULT_TIMEOUT,
     encoding: str = DEFAULT_ENCODING,
     autorecv: bool = DEFAULT_AUTORECV,
     bufsize: int = DEFAULT_BUFSIZE,
-) -> None:
+) -> tuple[str, ...]:
     """Send SCPI command(s) written in a file to a server.
 
     Args:
@@ -169,7 +180,7 @@ def send_commands_in(
         bufsize: Maximum byte size for receiving a message.
 
     Returns:
-        This function returns nothing.
+        Tuple of the received messages.
 
     Examples:
         If a text file, commands.txt, has SCPI commands::
@@ -191,4 +202,12 @@ def send_commands_in(
     LOGGER.debug(")")
 
     with open(path, encoding=encoding) as f:
-        send_commands(f, host, port, timeout, encoding, autorecv, bufsize)
+        return send_commands(
+            f,
+            host=host,
+            port=port,
+            timeout=timeout,
+            encoding=encoding,
+            autorecv=autorecv,
+            bufsize=bufsize,
+        )

drs4/ctrl/self.py

@@ -311,12 +311,12 @@ def set_gain(
 
         return
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info(")")
+    LOGGER.debug(")")
 
     if chassis not in get_args(Chassis):
         raise ValueError("Chassis number must be 1|2.")

drs4/daq/tcp.py

@@ -87,12 +87,12 @@ def cross(
     if zarr_if2 is None:
         zarr_if2 = ZARR_FORMAT.format(obsid, chassis, 2)
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info(")")
+    LOGGER.debug(")")
 
     if append and overwrite:
         raise ValueError("Append and overwrite cannot be enabled at once.")

drs4/daq/udp.py

@@ -120,12 +120,12 @@ def auto(
     if zarr_if2 is None:
         zarr_if2 = ZARR_FORMAT.format(obsid, chassis, 2)
 
-    LOGGER.info("(")
+    LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
-    LOGGER.info(")")
+    LOGGER.debug(")")
 
     if append and overwrite:
         raise ValueError("Append and overwrite cannot be enabled at once.")
@@ -336,7 +336,7 @@ def dump(
         sock.settimeout(timeout)
 
         # start dumping
-        LOGGER.info(f"{prefix} Start dumping data.")
+        LOGGER.debug(f"{prefix} Start dumping data.")
 
         while cancel is None or not cancel.is_set():
             frame, _ = sock.recvfrom(VDIF_FRAME_BYTES)
@@ -348,4 +348,4 @@ def dump(
                 LOGGER.warning(f"{prefix} Truncated frame.")
 
         # finish dumping
-        LOGGER.info(f"{prefix} Finish dumping data.")
+        LOGGER.debug(f"{prefix} Finish dumping data.")

drs4/qlook/gui.py

@@ -63,7 +63,7 @@ def run(
     LOGGER.debug("(")
 
     for key, val in locals().items():
-        LOGGER.info(f"  {key}: {val!r}")
+        LOGGER.debug(f"  {key}: {val!r}")
 
     LOGGER.debug(")")
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "drs4"
-version = "0.4.0"
+version = "0.5.0"
 description = "Control and data acquisition software for FINER/DRS4"
 readme = "README.md"
 keywords = [