Frequenz Dispatch Client Library Release Notes

Summary

Require frequenz-client-base 0.11.3 so configured HTTP/2 keepalive settings
work, and clarify deprecations in the API reference.

Upgrading

New Features

Bug Fixes

• Require frequenz-client-base 0.11.3 or newer so gRPC applies the configured
  HTTP/2 keepalive intervals.

Documentation

• The API reference now highlights the deprecated DispatchApiClient key
  argument and InverterType.SOLAR member, including their replacements.

What's Changed

• Bump frequenz-repo-config from 0.18.0 to 0.19.0 in the repo-config group across 1 directory by @dependabot[bot] in #328
• Style deprecation notices in the API reference by @llucax in #336
• Bump the patch group with 2 updates by @dependabot[bot] in #337
• Bump types-protobuf from 7.35.1.20260827 to 7.35.1.20260906 by @dependabot[bot] in #339
• Bump pydoclint from 0.9.1 to 0.10.1 by @dependabot[bot] in #340
• Require frequenz-client-base 0.11.3 for HTTP/2 keepalive by @Marenz in #341
• Bump the minor group across 1 directory with 8 updates by @dependabot[bot] in #342
• Prepare release notes for v1.1.1 by @Marenz in #343

Full Changelog: v1.1.0...v1.1.1

Frequenz Dispatch Client Library Release Notes

Summary

Add generic API credential fallbacks to dispatch-cli, add steam-boiler dispatch
targets, and reject invalid start_time values passed to DispatchApiClient.create().

Upgrading

New Features

• TargetCategories now supports the STEAM_BOILER component category. This
  requires frequenz-client-common 0.3.8 or newer. The minimum supported
  grpcio version is now 1.80.0, as required by its frequenz-api-common
  dependency.
• dispatch-cli accepts FREQUENZ_API_KEY and FREQUENZ_API_SECRET as a
  fallback pair for DISPATCH_API_AUTH_KEY and DISPATCH_API_SIGN_SECRET.

Bug Fixes

• DispatchApiClient.create(): Passing an invalid start_time (not a datetime or "NOW") previously silently created a dispatch with an epoch timestamp (1970-01-01). It now raises ValueError immediately.

What's Changed

• Bump asyncclick from 8.2.2.2 to 8.3.0.7 in the minor group by @dependabot[bot] in #225
• Bump types-python-dateutil from 2.9.0.20250822 to 2.9.0.20251008 by @dependabot[bot] in #228
• Bump setuptools-scm[toml] from 9.2.0 to 9.2.1 in the patch group by @dependabot[bot] in #224
• Bump pydoclint from 0.7.3 to 0.7.6 by @dependabot[bot] in #234
• Bump actions/upload-artifact from 4 to 5 by @dependabot[bot] in #230
• Bump actions/download-artifact from 5 to 6 by @dependabot[bot] in #231
• Bump the minor group with 2 updates by @dependabot[bot] in #233
• Add Dependabot auto-merge workflow by @Marenz in #236
• Bump the patch group with 5 updates by @dependabot[bot] in #232
• Use commit hash for dependabot-auto-approve action by @Marenz in #238
• Fix wrong dependabot-auto-approve hash by @Marenz in #239
• Make CODEOWNERS more specific by @Marenz in #240
• Bump pylint from 3.3.9 to 4.0.2 by @dependabot[bot] in #235
• Bump isort from 6.0.1 to 7.0.0 by @dependabot[bot] in #227
• Revert "Make CODEOWNERS more specific" by @Marenz in #241
• Bump pytest-asyncio from 1.2.0 to 1.3.0 by @dependabot[bot] in #250
• Bump pydoclint from 0.7.6 to 0.8.3 by @dependabot[bot] in #251
• Bump types-python-dateutil from 2.9.0.20251008 to 2.9.0.20251115 by @dependabot[bot] in #247
• Bump time-machine from 2.19.0 to 3.1.0 by @dependabot[bot] in #245
• Bump mkdocstrings[python] from 0.30.1 to 1.0.0 by @dependabot[bot] in #246
• Bump types-protobuf from 6.32.1.20250918 to 6.32.1.20251105 by @dependabot[bot] in #249
• Bump the minor group with 8 updates by @dependabot[bot] in #243
• Bump the patch group across 1 directory with 5 updates by @dependabot[bot] in #254
• Bump pytest from 8.4.2 to 9.0.1 by @dependabot[bot] in #248
• Bump frequenz-floss/gh-action-nox from 1.0.1 to 1.1.0 in the compatible group by @dependabot[bot] in #252
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #253
• Bump the patch group across 1 directory with 4 updates by @dependabot[bot] in #261
• Bump the minor group across 1 directory with 3 updates by @dependabot[bot] in #262
• Bump types-protobuf from 6.32.1.20251105 to 6.32.1.20251210 by @dependabot[bot] in #259
• Bump actions/download-artifact from 6 to 7 by @dependabot[bot] in #255
• Bump actions/upload-artifact from 5 to 6 by @dependabot[bot] in #256
• Bump mkdocs-gen-files from 0.5.0 to 0.6.0 by @dependabot[bot] in #244
• Bump async-solipsism from 0.8 to 0.9 by @dependabot[bot] in #260
• fix: Raise ValueError for invalid start_time in create() by @Marenz in #264
• Bump the patch group with 6 updates by @dependabot[bot] in #268
• Bump the compatible group with 2 updates by @dependabot[bot] in #265
• Add repo-config auto-migration workflow by @llucax in #277
• Bump the patch group with 4 updates by @dependabot[bot] in #280
• Bump isort from 7.0.0 to 8.0.1 by @dependabot[bot] in #273
• Bump setuptools-scm from 9.2.2 to 10.0.5 by @dependabot[bot] in #289
• Bump hypothesis from 6.151.9 to 6.151.10 in the patch group by @dependabot[bot] in #286
• Bump actions/create-github-app-token from 2.2.1 to 3.0.0 by @dependabot[bot] in #279
• Bump frequenz-repo-config from 0.13.8 to 0.17.0 in the repo-config group across 1 directory by @dependabot[bot] in #288
• Bump mypy from 1.19.1 to 1.20.0 in the minor group by @dependabot[bot] in #287
• Bump setuptools from 80.10.2 to 82.0.1 by @dependabot[bot] in #282
• Bump the compatible group across 1 directory with 2 updates by @dependabot[bot] in #290
• Bump types-protobuf from 6.32.1.20251210 to 6.32.1.20260221 by @dependabot[bot] in #276
• Bump nox from 2025.11.12 to 2026.2.9 by @dependabot[bot] in #269
• Bump black from 25.11.0 to 26.3.1 by @dependabot[bot] in #284
• Bump actions/create-github-app-token from 2.2.1 to 3.1.1 by @dependabot[bot] in #292
• Bump the compatible group with 3 updates by @dependabot[bot] in #291
• Bump frequenz-floss/gh-action-setup-git from 16952aac3ccc01d27412fe0dea3ea946530dcace to f9d86a01228ee1cadaac5224d4d7626f1eb23f90 by @dependabot[bot] in #294
• Bump frequenz-floss/gh-action-setup-python-with-deps from 0d0d77eac3b54799f31f25a1060ef2c6ebdf9299 to e4d0b2ef8f5a1612d7827f3abaef17c931d2b946 by @dependabot[bot] in #293
• Bump the patch group with 3 updates by @dependabot[bot] in #295
• Bump the minor group with 3 updates by @dependabot[bot] in #296
• Bump types-protobuf from 6.32.1.20260221 to 7.34.1.20260408 by @dependabot[bot] in #297
• Bump types-markdown from 3.10.2.20260211 to 3.10.2.20260408 by @dependabot[bot] in #298
• Bump types-python-dateutil from 2.9.0.20251115 to 2.9.0.20260408 by @dependabot[bot] in #299
• Bump the compatible group with 5 updates by @dependabot[bot] in #300
• Bump the minor group with 2 updates by @dependabot[bot] in https://github.com/frequenz-floss/frequenz...

Frequenz Dispatch Client Library Release Notes

Summary

Upgrading

New Features

Bug Fixes

What's Changed

• Prepare for v1.0.0 by @Marenz in #222

Full Changelog: v0.11.4...v1.0.0

Frequenz Dispatch Client Library Release Notes

Summary

Upgrading

New Features

• Changed target_components, dispatch_ids, and filter_queries parameters from Iterator to Iterable in list method for better API usability
• Added support for dispatch_ids and queries filters in the list method
  • dispatch_ids parameter allows filtering by specific dispatch IDs
  • filter_queries parameter supports text-based filtering on dispatch id and type fields
    • Query format: IDs are prefixed with # (e.g., #4), types are matched as substrings (e.g., bar matches foobar)
    • Multiple queries are combined with logical OR
• Date-only inputs in CLI timestamps now default to midnight UTC instead of using the current time.

Bug Fixes

What's Changed

• Bump pytest-asyncio from 1.1.0 to 1.2.0 by @dependabot[bot] in #218
• Bump actions/labeler from 5.0.0 to 6.0.1 by @dependabot[bot] in #215
• Bump pydoclint from 0.6.11 to 0.7.3 by @dependabot[bot] in #217
• Bump the minor group with 10 updates by @dependabot[bot] in #216
• Bump the patch group across 1 directory with 5 updates by @dependabot[bot] in #219
• Add support for dispatch_ids and queries filters by @Marenz in #213
• Fix: Use midnight UTC for date-only CLI timestamps instead of current time by @Marenz in #220
• Fix: Change list method parameters from Iterator to Iterable for better API usability by @Marenz in #223

Full Changelog: v0.11.3...v0.11.4

Frequenz Dispatch Client Library Release Notes

Summary

Upgrading

New Features

Bug Fixes

• The FakeService filter list code is now properly checking for unset fields to filter for.

What's Changed

• Bump types-python-dateutil from 2.9.0.20250516 to 2.9.0.20250708 by @dependabot[bot] in #193
• Bump types-markdown from 3.8.0.20250708 to 3.8.0.20250809 by @dependabot[bot] in #209
• Bump types-python-dateutil from 2.9.0.20250708 to 2.9.0.20250822 by @dependabot[bot] in #208
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in #205
• Bump the patch group with 4 updates by @dependabot[bot] in #207
• Bump setuptools-scm[toml] from 8.3.1 to 9.2.0 by @dependabot[bot] in #204
• Bump pydoclint from 0.6.6 to 0.6.11 by @dependabot[bot] in #203
• Bump actions/download-artifact from 4 to 5 in the artifacts group by @dependabot[bot] in #202
• Reset release notes for new release by @Marenz in #211
• FakeService: filter: Fix field-existance check by @Marenz in #212

Full Changelog: v0.11.2...v0.11.3

Frequenz Dispatch Client Library Release Notes

Summary

This release updates the frequenz-api-dispatch dependency to v1.0.0-rc3 and adapts the client to the latest API changes. It introduces more specific component categories and new event names while maintaining backward compatibility.

Upgrading

• InverterType.SOLAR is now deprecated in favor of InverterType.PV. The old name can still be used but will be removed in a future release.
• The following dependencies were updated:
  • frequenz-api-dispatch to v1.0.0-rc3
  • frequenz-client-common to v0.3.6
  • grpcio to v1.72.1

New Features

• ElectricalComponentCategory: The client now uses the more specific frequenz.client.common.microgrid.electrical_components.ElectricalComponentCategory for targeting components.
  • The new property TargetCategory.category2 will return an ElectricalComponentCategory.
  • The existing TargetCategory.category property is preserved for backward compatibility and returns the corresponding ComponentCategory.
• Support secrets for signing and verifying messages.
  • Use the new env variable DISPATCH_API_SIGN_SECRET to set the secret key.
  • Use the new sign_secret parameter in the DispatchClient constructor to set the secret key.
• Added auth_key parameter to the dispatch-cli and the new variable DISPATCH_API_AUTH_KEY to set the authentication key for the Dispatch API.

Bug Fixes

What's Changed

• Support secrets and signing by @Marenz in #186
• Bump types-markdown from 3.8.0.20250415 to 3.8.0.20250708 by @dependabot[bot] in #195
• Bump pytest-asyncio from 1.0.0 to 1.1.0 by @dependabot[bot] in #194
• Bump types-protobuf from 6.30.2.20250516 to 6.30.2.20250703 by @dependabot[bot] in #196
• Bump the compatible group with 2 updates by @dependabot[bot] in #190
• Bump mkdocstrings[python] from 0.29.1 to 0.30.0 in the mkdocstrings group by @dependabot[bot] in #191
• Bump mkdocs-material from 9.6.15 to 9.6.16 in the patch group by @dependabot[bot] in #188
• Bump async-solipsism from 0.7 to 0.8 by @dependabot[bot] in #192
• Bump the minor group with 2 updates by @dependabot[bot] in #189
• refactor: Adapt code to v1alpha8 API of frequenz-client-common by @Marenz in #197

Full Changelog: v0.11.1...v0.11.2

Frequenz Dispatch Client Library Release Notes

Summary

Upgrading

New Features

• Dispatch.started_at(now: datetime) was added as alternative to the started property for when users want to use the same now for multiple calls, ensuring deterministic return values with respect to the same now.

Bug Fixes

What's Changed

• Bump the minor group with 3 updates by @dependabot[bot] in #184
• Bump the patch group with 5 updates by @dependabot[bot] in #183
• Bump pytest-asyncio from 0.26.0 to 1.0.0 by @dependabot[bot] in #185
• Add started_at by @Marenz in #187

Full Changelog: v0.11.0...v0.11.1

Frequenz Dispatch Client Library Release Notes

Summary

While the new TargetCategory class supports subtypes, only reading them is currently available; setting subtypes will be introduced in a future release.

Upgrading

• TargetComponents was reworked. It now is a type alias for TargetIds | TargetCategories:
• TargetIds can be used to specify one or more specific target IDs:
• TargetIds(1, 2, 3) or
• TargetIds(ComponentIds(1), ComponentIds(2), ComponentIds(3))
• TargetCategories can be used to specify one or more target categories:
• TargetCategories(ComponentCategory.BATTERY, ComponentCategory.INVERTER)
• Dispatch ids and microgrid ids are no longer simple int types but are now wrapped in DispatchId and MicrogridId classes, respectively. This allows for better type safety and clarity in the codebase.

New Features

• With the new TargetCategory class (providing .category and .type) we can now specify subtypes of the categories:
• ComponentCategory.BATTERY uses BatteryType with possible values: LI_ION, NA_ION
• ComponentCategory.INVERTER uses InverterType with possible values: BATTERY, SOLAR, HYBRID
• ComponentCategory.EV_CHARGER uses EvChargerType: with possible values AC, DC, HYBRID
• A few examples on how to use the new TargetCategory:
  • TargetCategory(BatteryType.LI_ION)
    • category is ComponentCategory.BATTERY
    • type is BatteryType.LI_ION
  • TargetCategory(ComponentCategory.BATTERY)
    • category is ComponentCategory.BATTERY
    • type is None
  • TargetCategories(InverterType.SOLAR)
    • category is ComponentCategory.INVERTER
    • type is InverterType.SOLAR

Bug Fixes

What's Changed

• Bump the patch group with 5 updates by @dependabot in #173
• Bump types-protobuf from 5.29.1.20250403 to 6.30.2.20250516 by @dependabot in #175
• Bump the minor group with 3 updates by @dependabot in #174
• Bump types-python-dateutil from 2.9.0.20241206 to 2.9.0.20250516 by @dependabot in #176
• Allow targeting categories with subtypes by @Marenz in #168
• Delete obsolete release notes entries by @Marenz in #177
• Prepare readme for release by @Marenz in #178
• Fix stream() not working with base-client 0.11 by @Marenz in #180
• Update to use BaseId' ids by @Marenz in #181

Full Changelog: v0.10.2...v0.11.0

Frequenz Dispatch Client Library Release Notes

Summary

Upgrading

New Features

• dispatch-cli supports now the parameter --type and --running to filter the list of running services by type and status, respectively.
• Every call now has a default timeout of 60 seconds, streams terminate after five minutes. This can be influenced by the two new parameters forDispatchApiClient.__init__():
  • default_timeout: timedelta (default: 60 seconds)
  • stream_timeout: timedelta (default: 5 minutes)

Bug Fixes

What's Changed

• Add two new filters by @Marenz in #167
• Add timeouts to all api calls by @Marenz in #169
• Widen base-client dependency to 0.12.0 by @Marenz in #171

Full Changelog: v0.10.1...v0.10.2

Frequenz Dispatch Client Library Release Notes

Bug Fixes

• Fix cli client trying to use a invalid default URL when none is given.

Upgrading

• You now must always provide the URL to the dispatch client.

What's Changed

• Remove (now invalid) default URL for dispatch API by @Marenz in #166

Full Changelog: v0.10.0...v0.10.1