haybale-share 0.0.39__tar.gz

haybale_share-0.0.39/.gitignore

@@ -0,0 +1,225 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# The MANIFEST/*.manifest packaging-artifact rules above are unanchored and
+# (on a case-insensitive filesystem) also match our real, tracked
+# haywire_studio/share/manifest/ package — un-ignore it explicitly.
+!packages/haywire-studio/src/haywire_studio/share/manifest/
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+**/.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the enitre vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+.DS_Store
+saves/*.*
+
+# Dev-mode graphs (local testing only, not part of the repo)
+graphs/*.json
+# MkDocs build output
+site/
+
+# Baked docs for the haywire-core wheel (generated by scripts/bake_docs.py;
+# force-included into the wheel at build time). The *contents* are never
+# committed, but the directory itself is kept via a committed .gitkeep so the
+# hatchling force-include target exists in a fresh checkout — otherwise every
+# editable install (`uv sync`) fails the build on a missing force-include path.
+packages/haywire-core/src/haywire/_baked_docs/*
+!packages/haywire-core/src/haywire/_baked_docs/.gitkeep
+
+# Local git worktrees (claude-code workflow)
+.worktrees/
+
+# Haywire project config (user-local, not repo state)
+.haywire/
+
+# Local symlink to external dev project (machine-specific path)
+barn/haybale-visiongraph
+

haybale_share-0.0.39/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: haybale-share
+Version: 0.0.39
+Summary: Project publishing editor for Haywire
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: haywire-core>=0.0.39
+Requires-Dist: nicegui>=3.12.1

haybale_share-0.0.39/haybale_share/__init__.py

@@ -0,0 +1,45 @@
+"""Project publishing — the Share editor and its flow.
+
+Publishing is PROJECT-scoped, not library-scoped (ADR 0023): a haywire project
+is one uv workspace root with one marketstall feed and one git remote, and
+every ``barn/*`` library versions in lockstep. That is why this is its own
+library rather than an editor inside haybale-marketplace, whose job is
+*consuming* feeds — its own architecture doc says it is "not a publisher".
+
+The engine lives in :mod:`haywire.core.publishing`; everything here is UI.
+"""
+
+from importlib.metadata import version as _pkg_version
+from pathlib import Path
+
+from haywire.core.library.base import BaseLibrary
+from haywire.core.library.decorator import library
+from haywire.ui.editor.registry import EditorTypeRegistry
+
+
+@library(
+    label="Share",
+    id="share",
+    version=_pkg_version("haybale-share"),
+    description="Publish this project: dependencies, version, docs, commit, tag, push",
+    url="",
+    help_url="",
+    author="",
+    author_url="",
+    dependencies=[],
+    tags=["publishing"],
+    file_watcher=True,
+)
+class Library(BaseLibrary):
+    """Project publishing library — the Share editor."""
+
+    def register_components(self):
+        base_path = Path(__file__).parent
+
+        self.add_folder_to_registry(
+            folder_path=str(base_path / "editors"),
+            registry_cls=EditorTypeRegistry,
+        )
+
+    def validate(self) -> bool:
+        return True

haybale_share-0.0.39/haybale_share/_flow/__main__.py

@@ -0,0 +1,174 @@
+"""Runnable panel harness for the Share flow.
+
+    uv run python -m haybale_share._flow
+
+Opens http://localhost:8091 with every screen in every state, side by side
+with the scenario list. Nothing writes: each scenario hand-builds flow state
+and calls the panel directly, never a pipeline step. See ``_harness.py`` for
+why fixtures beat driving a real ``SharePipeline`` here.
+
+Boots a real library system so the themes and ``hui`` elements resolve — the
+point is to look at the panels as they will actually appear, not at unstyled
+approximations. Mirrors ``tests/ui/harness/app.py``.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+from typing import Callable
+
+from nicegui import app, ui
+
+from haywire.core.di.config import (
+    create_library_system_service,
+    set_global_injector,
+    set_library_system,
+)
+from haywire.core.di.context import set_workspace_root
+
+from ._harness import Panel
+from ._state import ShareFlow
+
+_HERE = Path(__file__).resolve()
+# _flow/ → haybale_share/ → haybale-share/ → barn/ → repo root
+_REPO_ROOT = _HERE.parent.parent.parent.parent
+_BARN = str(_REPO_ROOT / "barn")
+
+
+def _render_scenario(container: ui.element, label: str, build, panel) -> None:
+    """Render one scenario into *container*, inside the flow's real chrome.
+
+    The progress bar, warning rows and error banner come from
+    ``haywire.ui.components.stepper``, exactly as ``show_step_flow`` composes
+    them — a panel judged without its chrome is judged in the wrong context.
+    """
+    from haywire.ui.components.stepper import render_error, render_progress, render_warnings
+
+    from .panels import suppress_duplicate_error
+
+    container.clear()
+    flow = build()
+
+    def _rerender() -> None:
+        _render_scenario(container, label, build, panel)
+
+    with container:
+        ui.label(label).classes("text-sm font-medium")
+        ui.label(f"step = {flow.step!r}").classes("text-xs font-mono hw-text-muted")
+
+        # 640px: the width show_share_flow() opens the real popup at.
+        #
+        # `hw-panel` is not decoration — nearly every Quasar field rule in
+        # STATIC_CSS is scoped to it (the field label colour, the underline
+        # colours, the focus background). Popup applies it to its own content
+        # column, so a harness that omits it renders every select and input
+        # with browser defaults and misreports what the panel looks like.
+        with (
+            ui.column()
+            .classes("gap-2 p-3 rounded hw-panel")
+            .style("width: 640px; border: 1px solid var(--hw-border); background: var(--hw-bg-elevated);")
+        ):
+            render_progress(flow)
+            render_warnings(flow)
+            # The same error_detail show_share_flow passes. Rendering the banner
+            # without it is how this harness first showed a duplicate the real
+            # flow does not have — a harness that diverges from production
+            # reports bugs that are its own.
+            render_error(flow, _rerender, suppress_duplicate_error)
+            panel(flow, _rerender)
+
+
+def _inject_theme() -> None:
+    """Put the workbench theme's --hw-* variables on :root.
+
+    Without this every token resolves to empty and the panels render with
+    browser defaults — borders vanish, `hw-text-dim` is plain black. The app
+    shell normally does this (`shell.py`'s `_theme_css`), but the harness has
+    no shell, so it did what a harness must never do: showed the panels
+    looking materially different from production, and specifically hid the
+    boundaries this screen relies on.
+    """
+    from haywire.core.di.config import get_library_system
+    from haywire.ui.app.shell import STATIC_CSS
+
+    try:
+        registry = get_library_system().get_theme_registry()
+        keys = list(registry.list_workbench_keys())
+        if not keys:
+            return
+        theme = registry.get_workbench(keys[0])
+        css = " ".join(f"{k}: {v};" for k, v in theme.to_css_vars().items())
+        # The page background too: the workbench themes are dark, and a dark
+        # panel floating on a white page misrepresents every contrast
+        # judgement this harness exists to support.
+        body_css = "body { background: var(--hw-bg-page); color: var(--hw-text-body); }"
+        ui.add_head_html(f"<style>:root {{ {css} }} {body_css}</style>")
+        # The shell's own static CSS, verbatim — it is what styles Quasar
+        # fields and (globally, since they portal to <body>) the .q-menu
+        # dropdowns. Without it a select opens as a white menu with white
+        # text, which is a harness artefact and not something the panel does.
+        ui.add_css(STATIC_CSS)
+    except Exception as exc:  # noqa: BLE001 — a themeless harness still renders
+        print(f"harness: could not inject a workbench theme ({exc})")
+
+
+def _page() -> None:
+    from ._harness import SCENARIOS
+
+    _inject_theme()
+    ui.query("body").classes("hw-app")
+
+    with ui.row().classes("w-full h-screen gap-0 items-stretch"):
+        with (
+            ui.column()
+            .classes("gap-1 p-3 h-full overflow-auto")
+            .style("width: 300px; border-right: 1px solid var(--hw-border);")
+        ):
+            ui.label("Share flow — panels").classes("text-sm font-medium")
+            ui.label("Fixture state. Nothing writes.").classes("text-xs hw-text-muted")
+            buttons: list[tuple[ui.button, str, Callable[[], ShareFlow], Panel]] = []
+
+            with ui.scroll_area().classes("flex-1 w-full"):
+                for group, entries in SCENARIOS.items():
+                    ui.label(group).classes("text-xs hw-text-dim mt-2")
+                    for label, build, panel in entries:
+                        button = (
+                            ui.button(label).props("flat dense align=left no-caps").classes("w-full text-xs")
+                        )
+                        buttons.append((button, label, build, panel))
+
+        with ui.scroll_area().classes("flex-1 h-full"):
+            stage = ui.column().classes("p-4 gap-2")
+
+    for button, label, build, panel in buttons:
+        button.on_click(lambda _e=None, la=label, b=build, p=panel: _render_scenario(stage, la, b, p))
+
+    first_label, first_build, first_panel = next(iter(SCENARIOS.values()))[0]
+    _render_scenario(stage, first_label, first_build, first_panel)
+
+
+def main() -> None:
+    library_paths = [_BARN] if os.path.isdir(_BARN) else []
+    service = create_library_system_service(
+        workspace_root=str(_REPO_ROOT),
+        library_paths=library_paths,
+        enable_file_watching=False,
+        watch_settings=False,
+    )
+    set_library_system(service)
+    set_global_injector(service.injector)
+    set_workspace_root(str(_REPO_ROOT))
+
+    ui.page("/")(_page)
+    app.on_shutdown(lambda: service.cleanup() if hasattr(service, "cleanup") else None)
+
+    ui.run(port=8091, show=False, title="Share flow — panel harness", reload=False)
+
+
+if __name__ in {"__main__", "__mp_main__"}:
+    if str(_REPO_ROOT) not in sys.path:
+        sys.path.insert(0, str(_REPO_ROOT))
+    main()