livery-workshop 0.0.1__tar.gz

livery_workshop-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Willem Kokke
+
+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.

livery_workshop-0.0.1/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: livery-workshop
+Version: 0.0.1
+Summary: The livery ecosystem's devkit: the task surface, layers, templates, and content.
+Author: Willem Kokke
+Author-email: Willem Kokke <mail@willem.net>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Dist: livery-forge>=0.1.0
+Requires-Dist: footman>=0.46
+Requires-Dist: toolroom>=0.6.1
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/willemkokke/livery
+Description-Content-Type: text/markdown
+
+# livery-workshop
+
+The livery ecosystem's devkit: the task surface every repository runs
+(`fm check` and its family), the layer host that composes base,
+overlay, and instance, the materialiser that delivers content, and
+the template driver. Pre-alpha: this release reserves the
+distribution name and proves the release train; the task surface
+arrives phase by phase.
+
+Part of the [livery monorepo](https://github.com/willemkokke/livery).

livery_workshop-0.0.1/README.md

@@ -0,0 +1,10 @@
+# livery-workshop
+
+The livery ecosystem's devkit: the task surface every repository runs
+(`fm check` and its family), the layer host that composes base,
+overlay, and instance, the materialiser that delivers content, and
+the template driver. Pre-alpha: this release reserves the
+distribution name and proves the release train; the task surface
+arrives phase by phase.
+
+Part of the [livery monorepo](https://github.com/willemkokke/livery).

livery_workshop-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "livery-workshop"
+version = "0.0.1"
+description = "The livery ecosystem's devkit: the task surface, layers, templates, and content."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = [
+    "livery-forge>=0.1.0",
+    "footman>=0.46",
+    "toolroom>=0.6.1",
+]
+
+[[project.authors]]
+name = "Willem Kokke"
+email = "mail@willem.net"
+
+[project.entry-points."footman.tasks"]
+"livery.workshop" = "livery.workshop._tasks"
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+[tool.uv.build-backend]
+module-name = "livery.workshop"

livery_workshop-0.0.1/pyproject.toml.orig

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "livery-workshop"
+version = "0.0.1"
+description = "The livery ecosystem's devkit: the task surface, layers, templates, and content."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "Willem Kokke", email = "mail@willem.net" }]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = [
+    "livery-forge>=0.1.0",
+    "footman>=0.46",
+    "toolroom>=0.6.1",
+]
+
+[project.entry-points."footman.tasks"]
+"livery.workshop" = "livery.workshop._tasks"
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+[tool.uv.build-backend]
+# PEP 420 namespace: the importable package is livery.workshop and
+# there is no livery/__init__.py anywhere in this repository.
+module-name = "livery.workshop"

livery_workshop-0.0.1/src/livery/workshop/__init__.py

@@ -0,0 +1,23 @@
+"""The livery ecosystem's devkit.
+
+The task surface, the materialiser, and the template driver arrive
+phase by phase; this release carries the plugin host and the layer
+walk (livery.workshop.layer_names, livery.workshop.mount_layers,
+livery.workshop.workspace_root) and reserves the distribution name.
+The forge lane belongs to livery.forge.Forge; the workshop
+orchestrates local, git, and forge steps and never hands a raw forge
+verb to a user.
+"""
+
+from __future__ import annotations
+
+from livery.workshop._layers import layer_names, mount_layers, workspace_root
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "__version__",
+    "layer_names",
+    "mount_layers",
+    "workspace_root",
+]

livery_workshop-0.0.1/src/livery/workshop/_layers.py

@@ -0,0 +1,63 @@
+"""The layer walk: one list in the workspace contract, every channel.
+
+The root ``livery.toml`` names the layers in precedence order, the
+workshop first and the instance implicitly last. Mounting reads that
+list and grafts each further layer's footman plugin in order, so a
+package installed by accident never changes a repository: discovery
+is the list and nothing else.
+"""
+
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+#: The layer this package is. Never mounted by name: importing the
+#: plugin module IS this layer arriving.
+SELF = "livery.workshop"
+
+
+def workspace_root(start: Path | None = None) -> Path | None:
+    """The nearest ancestor carrying a ``livery.toml``, or None.
+
+    The workspace contract is the marker; a checkout without one is
+    not a workspace and gets no layers.
+    """
+    origin = (start or Path.cwd()).resolve()
+    for candidate in (origin, *origin.parents):
+        if (candidate / "livery.toml").is_file():
+            return candidate
+    return None
+
+
+def layer_names(start: Path | None = None) -> tuple[str, ...]:
+    """The layers the workspace declares, in precedence order.
+
+    Empty outside a workspace, and empty when the contract carries no
+    ``[workspace] layers`` list: no guessing, no defaults.
+    """
+    root = workspace_root(start)
+    if root is None:
+        return ()
+    contract = tomllib.loads((root / "livery.toml").read_text("utf-8"))
+    workspace = contract.get("workspace") or {}
+    layers = workspace.get("layers") or []
+    return tuple(str(layer) for layer in layers)
+
+
+def mount_layers(start: Path | None = None) -> tuple[str, ...]:
+    """Graft every further layer's plugin, in order; the names mounted.
+
+    The workshop itself is skipped: importing this package's plugin
+    module is how the base layer arrives, and mounting it again from
+    inside itself would recurse.
+    """
+    from footman import plugin
+
+    mounted = []
+    for layer in layer_names(start):
+        if layer == SELF:
+            continue
+        plugin(layer)
+        mounted.append(layer)
+    return tuple(mounted)

livery_workshop-0.0.1/src/livery/workshop/_tasks.py

@@ -0,0 +1,38 @@
+"""The workshop's footman plugin: what mounting the base layer runs.
+
+Advertised as the ``footman.tasks`` entry point named
+``livery.workshop``; a repository's whole ``tasks.py`` is
+``plugin("livery.workshop")`` once the surface has moved in. Importing
+this module mounts every further layer the workspace contract names,
+in order, so one line composes the entire tree.
+
+The task surface migrates here phase by phase; today the plugin
+carries the layer host and its one verb.
+"""
+
+from __future__ import annotations
+
+from footman import task
+
+from livery.workshop._layers import SELF, layer_names, mount_layers
+
+
+@task
+def layers() -> None:
+    """Print the workspace's layers in precedence order.
+
+    The list is the whole of discovery: what shapes this repository
+    is exactly what it prints, and the instance's own files always
+    win last.
+    """
+    names = layer_names()
+    if not names:
+        print("  no workspace: no livery.toml above the working directory")
+        return
+    for name in names:
+        marker = " (this package)" if name == SELF else ""
+        print(f"  {name}{marker}")
+    print("  ... then the instance's own files, which always win")
+
+
+mount_layers()