wirely 0.1.3__tar.gz → 0.1.4__tar.gz

{wirely-0.1.3 → wirely-0.1.4}/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 0.1.4 - 2026-10-24
+
+### Breaking changes and migration
+
+#### Optional parameters
+
+Replace `parameter_option(x)` with `optional(x)`.
+
+#### Type names
+
+Replace `String` with `string` and `ValueType` with `type`.
+Replace `Duration`, `TimeOfDay`, and `MonotonicTime` with `Std.Duration`,
+`Schedule.TimeOfDay`, and `Timer.MonotonicTime`, respectively, including
+in qualified function calls.
+
+#### Schedule.IsInDailyInterval
+
+The output is `Option[boolean]`. Handle `None` when wall time is unknown.
+
+#### Bindings
+
+Replace `temporary name: T;` with `binding name: value T;`, and
+`resource name: R;` with `binding name: resource R;`. The connection kind is
+required. The old declaration forms are no longer accepted.
+
+#### Enums
+
+Declare enums as `open` or `closed`. Open enums keep an explicit underlying
+type and member values and accept unnamed values of that type. Closed enums
+omit both and number their members from zero in declaration order:
+
+```wirely
+open enum type Protocol: uint8 {
+  TCP = 1,
+  UDP = 2,
+}
+
+closed enum type State {
+  Idle,
+  Running,
+}
+```
+
+Replace `enum type` with `open enum type` to keep existing numbering.
+
+#### Std.DelayOneStep
+
+Replace `Std.DelayOneStep` with state and read its previous value with
+`.old`:
+
+```wirely
+state delayed: boolean = false;
+connect source -> delayed;
+connect delayed.old -> target;
+```
+
 ## 0.1.3 - 2026-10-12
 
 ### Breaking changes and migration

{wirely-0.1.3 → wirely-0.1.4}/MANIFEST.in

@@ -1,9 +1,10 @@
 include CHANGELOG.md
 recursive-include doc *.md
 recursive-include examples *.wrl
-recursive-include test *.py *.wrl
-include test/wrl/username_password.txt
+recursive-include tests *.py *.wrl
+include tests/wrl/username_password.txt
 include tools/build-pex
+include tools/generate-native-types
 include tools/git_write_wd_tree.py
 include tools/run-tests
 include tools/run-tests-dependencies

{wirely-0.1.3/wirely.egg-info → wirely-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wirely
-Version: 0.1.3
+Version: 0.1.4
 Summary: Node-based language and runtime for low-level home automation
 Author: Steffen Kieß
 License: MIT
@@ -13,7 +13,7 @@ Requires-Dist: lark>=1.1.5
 Requires-Dist: sdnotify>=0.3.0
 Requires-Dist: cbor2>=5.4.5
 Provides-Extra: knx
-Requires-Dist: xknx<4,>=3.0; extra == "knx"
+Requires-Dist: xknx<4,>=3.4; extra == "knx"
 Provides-Extra: mqtt
 Requires-Dist: aiomqtt<3,>=2.3; extra == "mqtt"
 Provides-Extra: two-n
@@ -29,6 +29,7 @@ Provides-Extra: all
 Requires-Dist: wirely[gpio,graphviz,knx,mqtt,two-n]; extra == "all"
 Provides-Extra: test
 Requires-Dist: pyOpenSSL>=23.0.0; extra == "test"
+Requires-Dist: mypy>=2.0; extra == "test"
 Provides-Extra: pex
 Requires-Dist: pex; extra == "pex"
 Provides-Extra: dev
@@ -71,6 +72,10 @@ python3 -m wirely compile program.wrl
 
 Use `wirely compile --dump-program program.wrl` to print the compiled
 runtime program, including its variables, configuration, and procedures.
+Add `--timings` to print the duration of each compiler stage.
+Set `WIRELY_COMPILER_CACHE_LARK=1` to keep the parser tables in
+`$XDG_CACHE_HOME/wirely/` (by default `~/.cache/wirely/`), which saves
+about 0.7 s on each start.
 
 Install optional integrations as needed:
 
@@ -84,6 +89,9 @@ python3 -m pip install 'wirely[all]'           # all optional integrations
 python3 -m pip install 'wirely[editor]'        # graphical editor
 ```
 
+Set `WIRELY_VERBOSE=1` to print node creation, connection setup, and each
+value sent or received by the KNX, MQTT, 2N, CSV, and Process nodes.
+
 `wirely edit program.wrl` opens a program in a graphical editor with tabs
 for its source files and diagrams. Edits in either view update the other.
 Right-click a tab to split the view, move it to another pane, or detach it
@@ -121,7 +129,7 @@ checkout launchers:
 
 ```
 tools/setup-venv
-tools/wirely compile test/compiler/simple.wrl
+tools/wirely compile tests/compiler/simple.wrl
 tools/run-tests
 ```
 
@@ -137,12 +145,15 @@ slowest first:
 tools/run-tests --timings unit/types wrl/equality
 ```
 
+Add `--processes 4` to run the tests in four worker processes; see the
+[test guide](doc/tests.md) for the options.
+
 To check that compilation does not depend on declaration order, set
 `WIRELY_COMPILER_SHUFFLE_SEED` to an integer. The compiler then shuffles
-declarations, node parameters, struct literal fields, procedure ports,
-and `uses` bindings with that seed; connections keep their relative order.
-Also set `WIRELY_COMPILER_SHUFFLE_LAYOUT=1` to shuffle struct fields and
-enum members, which changes serialization and enum default values.
+declarations, node parameters, procedure ports, `uses` bindings, and open
+enum members with that seed; connections keep their relative order. Also set `WIRELY_COMPILER_SHUFFLE_LAYOUT=1` to shuffle
+fields of structs and members of closed enums that are not native, which
+changes the runtime representation.
 Negative tests may report different diagnostics in this mode.
 
 ```
@@ -167,3 +178,9 @@ compatible patch of the oldest supported CPython minor; `max` selects the
 newest compatible stable CPython available through the installed uv.
 uv can download missing interpreters. `tools/run-tests --python PATH` runs
 tests using a specified Python executable.
+
+Test names, `--timings`, and `--keep-going` work as for `tools/run-tests`:
+
+```
+tools/run-tests-dependencies --versions min --python min misc/type_check
+```

{wirely-0.1.3 → wirely-0.1.4}/README.md

@@ -33,6 +33,10 @@ python3 -m wirely compile program.wrl
 
 Use `wirely compile --dump-program program.wrl` to print the compiled
 runtime program, including its variables, configuration, and procedures.
+Add `--timings` to print the duration of each compiler stage.
+Set `WIRELY_COMPILER_CACHE_LARK=1` to keep the parser tables in
+`$XDG_CACHE_HOME/wirely/` (by default `~/.cache/wirely/`), which saves
+about 0.7 s on each start.
 
 Install optional integrations as needed:
 
@@ -46,6 +50,9 @@ python3 -m pip install 'wirely[all]'           # all optional integrations
 python3 -m pip install 'wirely[editor]'        # graphical editor
 ```
 
+Set `WIRELY_VERBOSE=1` to print node creation, connection setup, and each
+value sent or received by the KNX, MQTT, 2N, CSV, and Process nodes.
+
 `wirely edit program.wrl` opens a program in a graphical editor with tabs
 for its source files and diagrams. Edits in either view update the other.
 Right-click a tab to split the view, move it to another pane, or detach it
@@ -83,7 +90,7 @@ checkout launchers:
 
 ```
 tools/setup-venv
-tools/wirely compile test/compiler/simple.wrl
+tools/wirely compile tests/compiler/simple.wrl
 tools/run-tests
 ```
 
@@ -99,12 +106,15 @@ slowest first:
 tools/run-tests --timings unit/types wrl/equality
 ```
 
+Add `--processes 4` to run the tests in four worker processes; see the
+[test guide](doc/tests.md) for the options.
+
 To check that compilation does not depend on declaration order, set
 `WIRELY_COMPILER_SHUFFLE_SEED` to an integer. The compiler then shuffles
-declarations, node parameters, struct literal fields, procedure ports,
-and `uses` bindings with that seed; connections keep their relative order.
-Also set `WIRELY_COMPILER_SHUFFLE_LAYOUT=1` to shuffle struct fields and
-enum members, which changes serialization and enum default values.
+declarations, node parameters, procedure ports, `uses` bindings, and open
+enum members with that seed; connections keep their relative order. Also set `WIRELY_COMPILER_SHUFFLE_LAYOUT=1` to shuffle
+fields of structs and members of closed enums that are not native, which
+changes the runtime representation.
 Negative tests may report different diagnostics in this mode.
 
 ```
@@ -129,3 +139,9 @@ compatible patch of the oldest supported CPython minor; `max` selects the
 newest compatible stable CPython available through the installed uv.
 uv can download missing interpreters. `tools/run-tests --python PATH` runs
 tests using a specified Python executable.
+
+Test names, `--timings`, and `--keep-going` work as for `tools/run-tests`:
+
+```
+tools/run-tests-dependencies --versions min --python min misc/type_check
+```