chiklisp-builder 0.1.2__py3-none-any.whl

chiklisp_builder-0.1.2.dist-info/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 by Richard Kiss
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

chiklisp_builder-0.1.2.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.1
+Name: chiklisp-builder
+Version: 0.1.2
+Summary: Allow on-demand builds of chiklisp with recursive dependency checking.
+Author-email: Richard Kiss <him@richardkiss.com>
+License: Copyright 2023 by Richard Kiss
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+            http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: klvm-tools-rs
+Requires-Dist: runtime-builder >=0.1.3
+
+# Chiklisp Builder
+
+Use this wheel in conjunction with `runtime_builder` to manage building of chiklisp at build time or during development.
+
+# Use
+
+Add `chiklisp_builder` as a buildtime dependency and a development-time dependency. Don't add it as a runtime dependency, as the klvm `.hex` files should be built and included with the wheel. The source does not need to be.
+
+Add `chiklisp_loader` as a runtime dependency to get the `load_program` function, which will call the building function if present (as it should be at development time.)
+
+# FAQ
+
+Why isn't this included as part of `runtime_builder`?
+
+The `runtime_builder` wheel is intended to provide a general solution for non-python artifacts. Although Chiklisp build was the inspiration for `runtime_builder`, it's just one potential use. This wheel is the specific implementation of chiklisp builds for use with `runtime_builder`.

chiklisp_builder-0.1.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+chiklisp_builder.py,sha256=EHk5la-dbzg-q0Y7x8VYW1fRbcz7ccFs7JKJz8SI0wg,2082
+chiklisp_builder-0.1.2.dist-info/LICENSE,sha256=00kOn1m1EWQNdeglrohVzVOfeB8_J9QzNWLnwDlwbTY,569
+chiklisp_builder-0.1.2.dist-info/METADATA,sha256=0xppbe_LRo5ZVsILQ8XUBqPTkhu8XsRE2XXf9nBUbus,1921
+chiklisp_builder-0.1.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+chiklisp_builder-0.1.2.dist-info/top_level.txt,sha256=g-Fv6ObJdN6ZWyaMagbdvAjC4XG8mgQNNu-I3MqXMCg,17
+chiklisp_builder-0.1.2.dist-info/RECORD,,

chiklisp_builder-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

chiklisp_builder-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+chiklisp_builder

chiklisp_builder.py

@@ -0,0 +1,61 @@
+from pathlib import Path
+from typing import List
+
+import re
+
+import klvm_tools_rs
+
+CRE = re.compile(r"\((\s)*include(\s)+(.+)\)")
+
+
+def find_included_items(item: Path) -> List[Path]:
+    contents = item.read_text()
+    matches = CRE.findall(contents)
+    included = []
+    for match in matches:
+        s = match[-1]
+        if len(s) > 1 and s[0] == s[-1] and s[0] in "'\"":
+            included.append(s[1:-1])
+        else:
+            included.append(s)
+    return included
+
+
+def calculate_dependencies(source_path: Path, include_paths: List[Path]) -> List[Path]:
+    include_paths = [Path(_) for _ in include_paths]
+    dependencies = set()
+    to_check = [source_path]
+    while len(to_check):
+        item = to_check.pop()
+        if item in dependencies:
+            continue
+        dependencies.add(item)
+        included_items = find_included_items(item)
+        for include_item in included_items:
+            for include_path in include_paths:
+                p = include_path / include_item
+                if p.exists():
+                    to_check.append(p)
+    return dependencies
+
+
+class ChiklispBuild:
+    def __init__(self, include_paths: List[Path] = []):
+        self.include_paths = include_paths
+        self.include_paths_as_str = [str(_) for _ in include_paths]
+
+    def __call__(self, target_path: Path):
+        source_path = target_path.with_suffix(".clsp")
+
+        dependencies = calculate_dependencies(source_path, self.include_paths)
+        latest_date = max(_.stat().st_mtime for _ in dependencies)
+
+        if not target_path.exists() or target_path.stat().st_mtime < latest_date:
+            # we need to rebuild
+            if target_path.exists():
+                # `compile_klvm` doesn't always replace existing files as of 0.1.34
+                target_path.unlink()
+            source_path_str, target_path_str = str(source_path), str(target_path)
+            klvm_tools_rs.compile_klvm(
+                source_path_str, target_path_str, self.include_paths_as_str
+            )