ctxc 0.0.1__py3-none-any.whl

ctxc/__init__.py

@@ -0,0 +1 @@
+"""Compile explicitly selected filesystem content into deterministic context blocks."""

ctxc/cli.py

@@ -0,0 +1,120 @@
+from __future__ import annotations
+
+import argparse
+import tomllib
+import unicodedata
+from pathlib import Path
+
+
+def load_named_config(path: Path, name: str) -> dict:
+    """Load one named configuration. Input/output paths remain CWD-relative."""
+    with path.open("rb") as file:
+        return tomllib.load(file)["configs"][name]
+
+
+def _has_symlink(path: Path) -> bool:
+    return any(part.is_symlink() for part in (path, *path.parents))
+
+
+def files_under(directory: Path, suffixes: set[str]) -> list[Path]:
+    """Recursively select files, skipping symlinked paths."""
+    if _has_symlink(directory):
+        return []
+    if not directory.is_dir():
+        raise NotADirectoryError(f"Not a directory: {directory}")
+
+    files: list[Path] = []
+    for path in directory.iterdir():
+        if _has_symlink(path):
+            continue
+        if path.is_dir():
+            files.extend(files_under(path, suffixes))
+        elif path.is_file() and path.suffix.lower() in suffixes:
+            files.append(path)
+    return files  # One canonical sort happens after all selections are combined.
+
+
+def normalize_suffixes(extensions: list[str]) -> set[str]:
+    """Normalize extensions to lowercase suffixes with leading dots."""
+    return {
+        (extension if extension.startswith(".") else f".{extension}").lower()
+        for extension in extensions
+    }
+
+
+def _serialize_block(block_id: str, data: bytes) -> bytes:
+    if (
+        not block_id
+        or block_id != block_id.strip()
+        or len(block_id.splitlines()) != 1
+        or any(unicodedata.category(char) == "Cc" for char in block_id)
+    ):
+        raise ValueError(f"Invalid block identifier: {block_id!r}")
+    identifier = block_id.encode("utf-8", errors="strict")
+    data.decode("utf-8", errors="strict")
+    closing = b"@@ctx.end " + identifier
+    if closing in data.split(b"\n"):
+        raise ValueError(f"Closing delimiter collision in {block_id!r}")
+    # The extra LF before closing is framing, not part of the payload.
+    return b"@@ctx " + identifier + b"\n" + data + b"\n" + closing + b"\n"
+
+
+def build_code_bundle(config: dict) -> None:
+    """Compile configured files into out_code. The current directory is the root.
+
+    Overlapping selections of the same canonical file are included once.
+    All inputs are read and validated before opening the output for writing.
+    Output replacement is not atomic in this initial release.
+    """
+    out_code = Path(config["out_code"])
+    if not config.get("extensions"):
+        raise ValueError("Config 'extensions' must contain at least one extension.")
+    suffixes = normalize_suffixes(config["extensions"])
+    root = Path.cwd().resolve()
+    out_resolved = out_code.resolve()
+    if _has_symlink(out_code):
+        raise ValueError("Output must not be a symlink or use a symlinked parent.")
+
+    files: list[Path] = []
+    for directory in config.get("dirs", []):
+        files.extend(files_under(Path(directory), suffixes))
+    for file in config.get("files", []):
+        path = Path(file)
+        if _has_symlink(path):
+            continue
+        if not path.is_file():
+            raise FileNotFoundError(f"Not a file: {path}")
+        files.append(path)
+
+    by_id: dict[str, Path] = {}
+    for file in files:
+        canonical = file.resolve(strict=True)
+        if canonical == out_resolved:
+            continue
+        if not canonical.is_relative_to(root):
+            raise ValueError(f"Input is outside the current-directory root: {file}")
+        # Different spellings of the same path cannot emit duplicate block IDs.
+        by_id[canonical.relative_to(root).as_posix()] = canonical
+
+    artifact = b"".join(
+        _serialize_block(block_id, by_id[block_id].read_bytes())
+        for block_id in sorted(by_id, key=lambda value: value.encode("utf-8"))
+    )
+    out_code.parent.mkdir(parents=True, exist_ok=True)
+    out_code.write_bytes(artifact)
+    print(f"Generated {out_code} from {len(by_id)} file(s)")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--config", type=Path, required=True)
+    parser.add_argument("--name", required=True)
+    args = parser.parse_args()
+    try:
+        build_code_bundle(load_named_config(args.config, args.name))
+    except (OSError, ValueError, KeyError) as error:
+        parser.exit(1, f"ctxc: {error}\n")
+
+
+if __name__ == "__main__":
+    main()

ctxc-0.0.1.dist-info/METADATA

@@ -0,0 +1,27 @@
+Metadata-Version: 2.5
+Name: ctxc
+Version: 0.0.1
+Summary: A minimal filesystem-to-context compiler.
+Project-URL: Repository, https://github.com/jeremylimqe/ctxc
+Project-URL: Issues, https://github.com/jeremylimqe/ctxc/issues
+Author: jeremylimqe
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# ctxc
+
+A small deterministic compiler that turns explicitly selected UTF-8 files into a reproducible Context Blocks artifact.
+
+Requires Python 3.14+.
+
+## Install
+
+```bash
+pip install ctxc
+```

ctxc-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+ctxc/__init__.py,sha256=pft6orZd9G2rQx31FZkgsAsqDbYyblyz_AaN3TArMNo,87
+ctxc/cli.py,sha256=kv0NPIgC3gw7VwHp0ry9qc7hjEWecAMml4jM9u9fKj8,4404
+ctxc-0.0.1.dist-info/METADATA,sha256=psdlnYVvb5HdT0f9Fk1drsaxOv8Fyb421fh_se0XUX0,746
+ctxc-0.0.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+ctxc-0.0.1.dist-info/entry_points.txt,sha256=jFC7M7U4Z6xLdZLI1aBxVuIkxAY1eilmh1vm1VqCRi0,39
+ctxc-0.0.1.dist-info/licenses/LICENSE,sha256=FzRVWpxKLlgFv_jhXdvbJZ_G4-EiP1eIJsg7BmRxbtM,1068
+ctxc-0.0.1.dist-info/RECORD,,

ctxc-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

ctxc-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ctxc = ctxc.cli:main

ctxc-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jeremylimqe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.