labcode 0.0.1__py3-none-any.whl

labcode/__init__.py

@@ -0,0 +1 @@
+"""labcode -- the ``lc`` CLI, a dialect wrapper over the ofplang toolchain."""

labcode/__main__.py

@@ -0,0 +1,9 @@
+"""Enable ``python -m labcode <command> ...``.
+
+Intent: mirror the console-script entry point so the CLI is reachable without an
+installed script, which is convenient in dev checkouts and CI.
+"""
+
+from labcode.cli import main
+
+raise SystemExit(main())

labcode/cli.py

@@ -0,0 +1,99 @@
+"""labcode ``lc`` command-line interface.
+
+``lc`` is the entry point for the labcode dialect of the Object-flow Programming
+Language. It is a thin dispatcher over the ofplang toolchain: each subcommand is
+forwarded to a sibling package's own CLI, in-process::
+
+    lc validate ...  ->  ofplang.validate.cli.main
+    lc schedule ...  ->  ofplang.schedule.cli.main
+    lc run ...       ->  ofplang.run.cli.main
+
+At this version ``lc`` forwards to the ofplang siblings unchanged (no dialect
+behavior yet). The seam -- routing each subcommand independently -- is where the
+labcode dialect and its custom runner will later diverge. Each subcommand keeps
+its own options, exit codes, and ``--help``; ``lc`` adds no behavior of its own
+beyond routing plus a top-level ``--help``/``--version``.
+"""
+
+from __future__ import annotations
+
+import importlib
+import sys
+from collections.abc import Sequence
+
+# Subcommand -> dotted path of the sibling CLI module exposing ``main(argv)``.
+# Kept as strings so each sibling is imported lazily, only when its subcommand is
+# invoked: ``lc --help`` need not import a scheduler's ortools/numpy stack, and a
+# subcommand fails with a clear message if its package is somehow missing. This
+# dict is also the divergence seam: a later labcode version replaces an entry
+# (e.g. ``run``) with its own module to add dialect / custom-runner behavior.
+_SUBCOMMANDS: dict[str, str] = {
+    "validate": "ofplang.validate.cli",
+    "schedule": "ofplang.schedule.cli",
+    "run": "ofplang.run.cli",
+}
+
+_USAGE = """\
+usage: lc <command> [options]
+
+The labcode CLI: a dialect wrapper over the Object-flow Programming Language
+toolchain. Subcommands forward to the ofplang toolchain.
+
+commands:
+  validate    check a workflow document is well-formed portable v0
+  schedule    compute a schedule for a workflow
+  run         execute a workflow (rolling-horizon runner / simulator)
+
+Run `lc <command> --help` for command-specific options.
+
+options:
+  -h, --help     show this help and exit
+  -V, --version  show version and exit
+"""
+
+
+def _version() -> str:
+    from importlib.metadata import PackageNotFoundError, version
+
+    try:
+        return version("labcode")
+    except PackageNotFoundError:  # editable/source tree without installed metadata
+        return "0+unknown"
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if not args:
+        sys.stderr.write(_USAGE)
+        return 2
+
+    head = args[0]
+    if head in ("-h", "--help"):
+        sys.stdout.write(_USAGE)
+        return 0
+    if head in ("-V", "--version"):
+        sys.stdout.write(f"lc {_version()}\n")
+        return 0
+    if head.startswith("-"):
+        sys.stderr.write(f"lc: unrecognized option {head!r}\n\n")
+        sys.stderr.write(_USAGE)
+        return 2
+
+    module_path = _SUBCOMMANDS.get(head)
+    if module_path is None:
+        sys.stderr.write(f"lc: unknown command {head!r}\n\n")
+        sys.stderr.write(_USAGE)
+        return 2
+
+    try:
+        module = importlib.import_module(module_path)
+    except ImportError as exc:
+        sys.stderr.write(
+            f"lc: the '{head}' command requires a package that is not installed "
+            f"({exc}).\n"
+        )
+        return 2
+
+    exit_code: int = module.main(args[1:])
+    return exit_code

labcode-0.0.1.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: labcode
+Version: 0.0.1
+Summary: labcode -- a dialect wrapper over the Object-Flow Programming Language toolchain
+Author-email: Kazunari Kaizu <kwaizu@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ofplang/labcode
+Project-URL: Repository, https://github.com/ofplang/labcode
+Keywords: ofplang,labcode,dataflow,workflow,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ofplang-validate>=0.1.0
+Requires-Dist: ofplang-schedule>=0.1.0
+Requires-Dist: ofplang-run>=0.1.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.16; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Dynamic: license-file
+
+# labcode
+
+[![CI](https://github.com/ofplang/labcode/actions/workflows/ci.yml/badge.svg)](https://github.com/ofplang/labcode/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/labcode.svg)](https://pypi.org/project/labcode/)
+
+The **`lc`** command-line interface for the **labcode** dialect of the
+**Object-flow Programming Language**. Installing this one package pulls in the
+ofplang toolchain and exposes it under a single command:
+
+```sh
+lc validate ...   # check a workflow is well-formed portable v0
+lc schedule ...   # compute a schedule for a workflow
+lc run ...        # execute a workflow (rolling-horizon runner / simulator)
+```
+
+labcode is where a site-specific dialect and a custom runner (real lab hardware)
+are developed on top of the ofplang toolchain. At this version `lc` is a thin
+dispatcher that forwards each subcommand to the ofplang siblings **unchanged**;
+the dialect and custom-runner behavior will land in later versions, replacing
+individual subcommands behind the same interface.
+
+## Install
+
+```sh
+pip install labcode
+```
+
+Requires Python 3.10+. This package is a thin dispatcher; it depends on the
+ofplang sibling packages that do the work:
+
+- [`ofplang-validate`](https://github.com/ofplang/validate) — the validator
+- [`ofplang-schedule`](https://github.com/ofplang/schedule) — the scheduler
+- [`ofplang-run`](https://github.com/ofplang/run) — the runner / simulator
+
+The language is defined in the [ofplang/spec](https://github.com/ofplang/spec)
+repository.
+
+## Usage
+
+Each subcommand keeps its own options, exit codes, and `--help`:
+
+```sh
+lc --help            # top-level help
+lc <command> --help  # command-specific options
+lc --version
+```
+
+`lc` can also be run as a module: `python -m labcode <command> ...`.
+
+## License
+
+MIT

labcode-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+labcode/__init__.py,sha256=jS_lhcLqdu2BfOAq6j5jPTvGNY5M3_1RMJtNRr3ABp4,79
+labcode/__main__.py,sha256=T5DM7E3tdcuKP4oQ7JacBP4Mi-VmujWueJvB9yCIQTc,252
+labcode/cli.py,sha256=4hRRbSftf4CUl5Uh9HlwI7Qou46DsrnPy91UDre2k_Q,3319
+labcode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+labcode-0.0.1.dist-info/licenses/LICENSE,sha256=weUnWoHlmaiawSjaLy_ECNpyTe7F5vDBfLGJKocpUhI,1071
+labcode-0.0.1.dist-info/METADATA,sha256=UYN509QiMtodkausdZECUKMZn1ZggfmwU0hO1_ZCAos,3064
+labcode-0.0.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+labcode-0.0.1.dist-info/entry_points.txt,sha256=eP2fNwGx6ZYNJ_AWzGZhiDJaPqeqaA0iZAc-Tae1PGQ,40
+labcode-0.0.1.dist-info/top_level.txt,sha256=7WhrsXy6psZ8TDzksIEEuj2q93GeXWkHL9h1RbdBrJg,8
+labcode-0.0.1.dist-info/RECORD,,

labcode-0.0.1.dist-info/WHEEL

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

labcode-0.0.1.dist-info/entry_points.txt

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

labcode-0.0.1.dist-info/licenses/LICENSE

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

labcode-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+labcode