Version 1.4.9 - See changelog for updates.

Author: jscott3201

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.9] - 2026-02-14
+
+### Added
+
+- **Interactive CLI example**: New `examples/interactive_cli.py` providing a menu-driven
+  interactive CLI for testing Client API features against a real BACnet device. Supports
+  read/write (single and multiple), device discovery (Who-Is, Who-Has, object list), COV
+  subscriptions with live notifications, and time synchronization. Uses non-blocking input
+  to keep the event loop responsive for COV callbacks between actions.
+
 ## [1.4.8] - 2026-02-14
 
 ### Added

README.md

@@ -2,7 +2,7 @@
 
 Asynchronous BACnet/IP protocol library for Python 3.13+, implementing ASHRAE Standard 135-2020. Zero required runtime dependencies, built on native `asyncio`.
 
-[Documentation](https://bac-py.readthedocs.io) | [Getting Started](https://bac-py.readthedocs.io/en/latest/getting-started.html) | [API Reference](https://bac-py.readthedocs.io/en/latest/api/app/client.html) | [Changelog](https://bac-py.readthedocs.io/en/latest/changelog.html)
+[Documentation](https://jscott3201.github.io/bac-py/) | [Getting Started](https://jscott3201.github.io/bac-py/getting-started.html) | [API Reference](https://jscott3201.github.io/bac-py/api/app/index.html) | [Changelog](https://jscott3201.github.io/bac-py/changelog.html)
 
 ```python
 from bac_py import Client
@@ -38,7 +38,7 @@ async with Client(instance_number=999) as client:
 | **Convenience API** | String-based addressing (`"ai,1"`, `"pv"`), smart type coercion, auto-discovery |
 | **Serialization** | `to_dict()`/`from_dict()` on all data types; optional `orjson` backend |
 | **Conformance** | BIBB declarations and PICS generation per Clause 24 |
-| **Quality** | 6,300+ unit tests, Docker integration tests, local benchmarks, type-safe enums and frozen dataclasses throughout |
+| **Quality** | 6,380+ unit tests, Docker integration tests, local benchmarks, type-safe enums and frozen dataclasses throughout |
 
 ## Installation
 
@@ -84,7 +84,7 @@ The convenience API accepts 48 object type aliases (`ai`, `ao`, `av`, `bi`,
 `bo`, `bv`, `msv`, `dev`, `sched`, `tl`, `nc`, etc.) and 45 property
 abbreviations (`pv`, `name`, `type`, `list`, `status`, `priority`, `min`,
 `max`, etc.). Full names like `"analog-input,1"` and `"present-value"` also
-work. See the [alias reference](https://bac-py.readthedocs.io/en/latest/getting-started.html#string-aliases) for the complete table.
+work. See the [alias reference](https://jscott3201.github.io/bac-py/getting-started.html#string-aliases) for the complete table.
 
 ### Write a Value
 
@@ -318,7 +318,7 @@ from bac_py.services.errors import (
 
 ## Examples
 
-The [`examples/`](examples/) directory contains 22 runnable scripts. See the
+The [`examples/`](examples/) directory contains 23 runnable scripts. See the
 [Examples Guide](https://jscott3201.github.io/bac-py/guide/examples.html) for
 detailed walkthroughs.
 
@@ -345,6 +345,7 @@ detailed walkthroughs.
 | `secure_connect_hub.py` | Run a BACnet/SC hub with object serving |
 | `ip_to_sc_router.py` | Bridge BACnet/IP and BACnet/SC networks |
 | `ipv6_client_server.py` | BACnet/IPv6 client and server with foreign device |
+| `interactive_cli.py` | Menu-driven interactive CLI for exploring the full API |
 | `sc_generate_certs.py` | Generate test PKI and demonstrate TLS-secured SC |
 
 ## Testing

docs/guide/examples.rst

@@ -3,7 +3,7 @@
 Example Scripts
 ===============
 
-The ``examples/`` directory contains 22 runnable scripts demonstrating bac-py's
+The ``examples/`` directory contains 23 runnable scripts demonstrating bac-py's
 capabilities. Each script is self-contained and uses the high-level
 :class:`~bac_py.client.Client` API with ``asyncio.run()``.
 
@@ -35,6 +35,42 @@ All examples follow the same structure:
    full logger hierarchy and filtering options.
 
 
+.. _examples-interactive-cli:
+
+Interactive CLI
+---------------
+
+interactive_cli.py
+^^^^^^^^^^^^^^^^^^
+
+A menu-driven interactive CLI for testing Client API features against a real
+BACnet device. Provides a single tool to explore the full API interactively
+instead of editing and re-running individual example scripts.
+
+.. code-block:: bash
+
+   # Start with a target address
+   uv run python examples/interactive_cli.py 192.168.1.100
+
+   # Or enter the address interactively
+   uv run python examples/interactive_cli.py
+
+The menu offers 10 actions covering the core Client API:
+
+- **Read / Write** -- single property reads and writes with array index and
+  priority support, plus batch operations via ReadPropertyMultiple and
+  WritePropertyMultiple
+- **Discovery** -- Who-Is device discovery, Who-Has object search, and object
+  list enumeration
+- **COV** -- subscribe and unsubscribe with live ``[COV]``-prefixed
+  notifications printed between menu prompts
+- **Device Management** -- time synchronization using the current system clock
+
+Input uses ``asyncio.run_in_executor()`` so the event loop stays responsive for
+COV callbacks while waiting for user input. Active COV subscriptions are
+automatically cleaned up on exit.
+
+
 .. _examples-reading-writing:
 
 Reading and Writing