hassl 0.2.0__tar.gz → 0.3.0__tar.gz

hassl-0.3.0/MANIFEST.in

@@ -0,0 +1,2 @@
+# MANIFEST.in
+recursive-include hassl *.lark

{hassl-0.2.0 → hassl-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hassl
-Version: 0.2.0
+Version: 0.3.0
 Summary: HASSL: Home Assistant Simple Scripting Language
 Home-page: https://github.com/adanowitz/hassl
 Author: adanowitz
@@ -17,6 +17,8 @@ Dynamic: license-file
 
 > **Home Assistant Simple Scripting Language**
 
+![Version](https://img.shields.io/badge/version-v0.3.0-blue)
+
 HASSL is a human-friendly domain-specific language (DSL) for building **loop-safe**, **deterministic**, and **composable** automations for [Home Assistant](https://www.home-assistant.io/).
 
 It compiles lightweight `.hassl` scripts into fully functional YAML packages that plug directly into Home Assistant, replacing complex automations with a clean, readable syntax.
@@ -32,12 +34,15 @@ It compiles lightweight `.hassl` scripts into fully functional YAML packages tha
 - **Per-rule enable gates** → `disable rule` or `enable rule` dynamically
 - **Inline waits** → `wait (!motion for 10m)` works like native HA triggers
 - **Color temperature in Kelvin** → `light.kelvin = 2700`
+- **Modular packages/imports** → split automations across files with public/private exports (v0.3.0)
 - **Auto-reload resilience** → schedules re-evaluate automatically on HA restart
 
 ---
 
 ## 🧰 Example
 
+### Basic standalone script
+
 ```hassl
 alias light  = light.wesley_lamp
 alias motion = binary_sensor.wesley_motion_motion
@@ -64,6 +69,45 @@ Produces a complete Home Assistant package with:
 - Sync automations for linked devices
 - Rule-based automations with schedules and `not_by` guards
 
+### Using imports across packages
+
+```hassl
+# packages/std/shared.hassl
+package std.shared
+
+alias light  = light.wesley_lamp
+alias motion = binary_sensor.wesley_motion_motion
+alias lux    = sensor.wesley_motion_illuminance
+
+schedule wake_hours:
+  enable from 08:00 until 19:00;
+```
+
+```hassl
+# packages/home/landing.hassl
+package home.landing
+import std.shared.*
+
+rule wesley_motion_light:
+  schedule use wake_hours;
+  if (motion && lux < 50)
+  then light = on;
+  wait (!motion for 10m) light = off
+
+rule landing_manual_off:
+  if (light == off) not_by any_hassl
+  then disable rule wesley_motion_light for 3m
+```
+
+This setup produces:
+- One **shared package** defining reusable aliases and schedules  
+- A **landing package** importing and reusing those exports  
+
+Together, they generate:
+- ✅ Shared schedule sensor (`binary_sensor.hassl_schedule_std_shared_wake_hours_active`)  
+- ✅ Cross-package rule automations gated by that schedule  
+- ✅ Context-safe helpers and syncs for both packages  
+
 ---
 
 ## 🏗 Installation
@@ -103,6 +147,7 @@ Each `.hassl` file compiles into an isolated package — no naming collisions, n
 | `scripts_<pkg>.yaml`       | Writer scripts with context stamping          |
 | `sync_<pkg>_*.yaml`        | Sync automations for each property            |
 | `rules_bundled_<pkg>.yaml` | Rule logic automations + schedules            |
+| `schedules_<pkg>.yaml`     | Time/sun-based schedule sensors (v0.3.0)      |
 
 ---
 
@@ -120,7 +165,7 @@ Each `.hassl` file compiles into an isolated package — no naming collisions, n
 
 ## 🔒 Loop Safety & Context Tracking
 
-HASSL automatically writes the **parent context ID** into helper entities before performing actions.\
+HASSL automatically writes the **parent context ID** into helper entities before performing actions.  
 This ensures `not_by any_hassl` and `not_by rule("name")` guards work flawlessly, preventing infinite feedback.
 
 ---
@@ -129,23 +174,22 @@ This ensures `not_by any_hassl` and `not_by rule("name")` guards work flawlessly
 
 All schedules are restart-safe:
 
-- `input_boolean.hassl_schedule_<name>` automatically re-evaluates on startup.
-- Triggers are set for both start and end times.
+- `binary_sensor.hassl_schedule_<package>_<name>_active` automatically re-evaluates on startup.
+- Clock and sun-based windows update continuously through HA’s template engine.
 - Missed events (like mid-day restarts) are recovered automatically.
 
 ---
 
 ## 📚 Documentation
 
-For full grammar and detailed semantics, see the [HASSL Language Specification](./HASSL_Specification.md).
-
-For a hands-on guide, check out the [Quickstart](./quickstart.md).
+- [Quickstart Guide](./quickstart_v1.4_2025_v0.3.0.md)
+- [Language Specification](./hassl_language_spec_v1.4_2025_updated_v0.3.0.md)
 
 ---
 
 ## 🧩 Contributing
 
-Contributions, tests, and ideas welcome!\
+Contributions, tests, and ideas welcome!  
 To run tests locally:
 
 ```bash
@@ -158,10 +202,9 @@ Please open pull requests for grammar improvements, new device domains, or sched
 
 ## 📄 License
 
-MIT License © 2025\
+MIT License © 2025  
 Created and maintained by [@adanowitz](https://github.com/adanowitz)
 
 ---
 
 **HASSL** — simple, reliable, human-readable automations for Home Assistant.
-

{hassl-0.2.0 → hassl-0.3.0}/README.md

@@ -2,6 +2,8 @@
 
 > **Home Assistant Simple Scripting Language**
 
+![Version](https://img.shields.io/badge/version-v0.3.0-blue)
+
 HASSL is a human-friendly domain-specific language (DSL) for building **loop-safe**, **deterministic**, and **composable** automations for [Home Assistant](https://www.home-assistant.io/).
 
 It compiles lightweight `.hassl` scripts into fully functional YAML packages that plug directly into Home Assistant, replacing complex automations with a clean, readable syntax.
@@ -17,12 +19,15 @@ It compiles lightweight `.hassl` scripts into fully functional YAML packages tha
 - **Per-rule enable gates** → `disable rule` or `enable rule` dynamically
 - **Inline waits** → `wait (!motion for 10m)` works like native HA triggers
 - **Color temperature in Kelvin** → `light.kelvin = 2700`
+- **Modular packages/imports** → split automations across files with public/private exports (v0.3.0)
 - **Auto-reload resilience** → schedules re-evaluate automatically on HA restart
 
 ---
 
 ## 🧰 Example
 
+### Basic standalone script
+
 ```hassl
 alias light  = light.wesley_lamp
 alias motion = binary_sensor.wesley_motion_motion
@@ -49,6 +54,45 @@ Produces a complete Home Assistant package with:
 - Sync automations for linked devices
 - Rule-based automations with schedules and `not_by` guards
 
+### Using imports across packages
+
+```hassl
+# packages/std/shared.hassl
+package std.shared
+
+alias light  = light.wesley_lamp
+alias motion = binary_sensor.wesley_motion_motion
+alias lux    = sensor.wesley_motion_illuminance
+
+schedule wake_hours:
+  enable from 08:00 until 19:00;
+```
+
+```hassl
+# packages/home/landing.hassl
+package home.landing
+import std.shared.*
+
+rule wesley_motion_light:
+  schedule use wake_hours;
+  if (motion && lux < 50)
+  then light = on;
+  wait (!motion for 10m) light = off
+
+rule landing_manual_off:
+  if (light == off) not_by any_hassl
+  then disable rule wesley_motion_light for 3m
+```
+
+This setup produces:
+- One **shared package** defining reusable aliases and schedules  
+- A **landing package** importing and reusing those exports  
+
+Together, they generate:
+- ✅ Shared schedule sensor (`binary_sensor.hassl_schedule_std_shared_wake_hours_active`)  
+- ✅ Cross-package rule automations gated by that schedule  
+- ✅ Context-safe helpers and syncs for both packages  
+
 ---
 
 ## 🏗 Installation
@@ -88,6 +132,7 @@ Each `.hassl` file compiles into an isolated package — no naming collisions, n
 | `scripts_<pkg>.yaml`       | Writer scripts with context stamping          |
 | `sync_<pkg>_*.yaml`        | Sync automations for each property            |
 | `rules_bundled_<pkg>.yaml` | Rule logic automations + schedules            |
+| `schedules_<pkg>.yaml`     | Time/sun-based schedule sensors (v0.3.0)      |
 
 ---
 
@@ -105,7 +150,7 @@ Each `.hassl` file compiles into an isolated package — no naming collisions, n
 
 ## 🔒 Loop Safety & Context Tracking
 
-HASSL automatically writes the **parent context ID** into helper entities before performing actions.\
+HASSL automatically writes the **parent context ID** into helper entities before performing actions.  
 This ensures `not_by any_hassl` and `not_by rule("name")` guards work flawlessly, preventing infinite feedback.
 
 ---
@@ -114,23 +159,22 @@ This ensures `not_by any_hassl` and `not_by rule("name")` guards work flawlessly
 
 All schedules are restart-safe:
 
-- `input_boolean.hassl_schedule_<name>` automatically re-evaluates on startup.
-- Triggers are set for both start and end times.
+- `binary_sensor.hassl_schedule_<package>_<name>_active` automatically re-evaluates on startup.
+- Clock and sun-based windows update continuously through HA’s template engine.
 - Missed events (like mid-day restarts) are recovered automatically.
 
 ---
 
 ## 📚 Documentation
 
-For full grammar and detailed semantics, see the [HASSL Language Specification](./HASSL_Specification.md).
-
-For a hands-on guide, check out the [Quickstart](./quickstart.md).
+- [Quickstart Guide](./quickstart_v1.4_2025_v0.3.0.md)
+- [Language Specification](./hassl_language_spec_v1.4_2025_updated_v0.3.0.md)
 
 ---
 
 ## 🧩 Contributing
 
-Contributions, tests, and ideas welcome!\
+Contributions, tests, and ideas welcome!  
 To run tests locally:
 
 ```bash
@@ -143,10 +187,9 @@ Please open pull requests for grammar improvements, new device domains, or sched
 
 ## 📄 License
 
-MIT License © 2025\
+MIT License © 2025  
 Created and maintained by [@adanowitz](https://github.com/adanowitz)
 
 ---
 
 **HASSL** — simple, reliable, human-readable automations for Home Assistant.
-

hassl-0.3.0/hassl/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"

hassl-0.3.0/hassl/ast/nodes.py

@@ -0,0 +1,53 @@
+from dataclasses import dataclass, asdict, field
+from typing import List, Any, Dict, Optional
+
+@dataclass
+class Alias:
+    name: str
+    entity: str
+    private: bool = False
+
+@dataclass
+class Sync:
+    kind: str
+    members: List[str]
+    name: str
+    invert: List[str] = field(default_factory=list)
+
+@dataclass
+class IfClause:
+    condition: Dict[str, Any]
+    actions: List[Dict[str, Any]]
+
+@dataclass
+class Schedule:
+    name: str
+    # raw clauses as produced by the transformer, e.g. {"type":"schedule_clause", ...}
+    clauses: List[Dict[str, Any]]
+    private: bool = False
+
+@dataclass
+class Rule:
+    name: str
+    # allow schedule dicts
+    clauses: List[Any]
+
+@dataclass
+class Program:
+    statements: List[object]
+    package: Optional[str] = None
+    # normalized import entries (dicts) from the transformer:
+    #   {"type":"import","module": "...", "kind": "glob|list|alias", "items":
+    #[...], "as": "name"|None}
+    imports: List[Dict[str, Any]] = field(default_factory=list)    
+    def to_dict(self):
+        def enc(x):
+            if isinstance(x, (Alias, Sync, Rule, IfClause, Schedule)):
+                d = asdict(x); d["type"] = x.__class__.__name__; return d
+            return x
+        return {
+            "type": "Program",
+            "package": self.package,
+            "imports": self.imports,
+            "statements": [enc(s) for s in self.statements],
+        }