ofplang 0.1.0__py3-none-any.whl

ofplang/ofp/__init__.py

@@ -0,0 +1 @@
+"""ofplang.ofp -- the umbrella ``ofp`` CLI that dispatches to the toolchain."""

ofplang/ofp/__main__.py

@@ -0,0 +1,9 @@
+"""Enable ``python -m ofplang.ofp <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 ofplang.ofp.cli import main
+
+raise SystemExit(main())

ofplang/ofp/cli.py

@@ -0,0 +1,92 @@
+"""Umbrella ``ofp`` command-line interface.
+
+``ofp`` is a thin dispatcher over the Object-flow Programming Language toolchain.
+It forwards each subcommand to a sibling package's own CLI, in-process::
+
+    ofp validate ...  ->  ofplang.validate.cli.main
+    ofp schedule ...  ->  ofplang.schedule.cli.main
+    ofp run ...       ->  ofplang.run.cli.main
+
+Each subcommand keeps its own options, exit codes, and ``--help``; ``ofp`` 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: ``ofp --help`` need not import a scheduler's ortools/numpy stack, and a
+# subcommand fails with a clear message if its package is somehow missing.
+_SUBCOMMANDS: dict[str, str] = {
+    "validate": "ofplang.validate.cli",
+    "schedule": "ofplang.schedule.cli",
+    "run": "ofplang.run.cli",
+}
+
+_USAGE = """\
+usage: ofp <command> [options]
+
+The umbrella CLI for the Object-flow Programming Language 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 `ofp <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("ofplang")
+    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"ofp {_version()}\n")
+        return 0
+    if head.startswith("-"):
+        sys.stderr.write(f"ofp: 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"ofp: 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"ofp: 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

ofplang-0.1.0.dist-info/METADATA

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ofplang
+Version: 0.1.0
+Summary: Umbrella `ofp` command-line interface for the Object-flow Programming Language toolchain.
+Author-email: Kazunari Kaizu <kwaizu@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ofplang/ofp
+Project-URL: Repository, https://github.com/ofplang/ofp
+Keywords: ofplang,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
+
+# ofplang
+
+[![CI](https://github.com/ofplang/ofp/actions/workflows/ci.yml/badge.svg)](https://github.com/ofplang/ofp/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/ofplang.svg)](https://pypi.org/project/ofplang/)
+
+The umbrella **`ofp`** command-line interface for the **Object-flow Programming
+Language** toolchain. Installing this one package pulls in the whole toolchain
+and exposes it under a single command:
+
+```sh
+ofp validate ...   # check a workflow is well-formed portable v0
+ofp schedule ...   # compute a schedule for a workflow
+ofp run ...        # execute a workflow (rolling-horizon runner / simulator)
+```
+
+The language is defined in the [ofplang/spec](https://github.com/ofplang/spec)
+repository.
+
+## Install
+
+```sh
+pip install ofplang
+```
+
+Requires Python 3.10+. This package is a thin dispatcher; it depends on the
+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
+
+## Command line
+
+```sh
+ofp <command> [options]         # or: python -m ofplang.ofp <command> [options]
+ofp <command> --help            # command-specific options
+ofp --version
+```
+
+`ofp` forwards each subcommand to the corresponding sibling CLI **in-process**,
+so every command keeps its own options, output, and exit codes. `ofp` itself
+adds only routing and a top-level `--help`/`--version`.
+
+Each sibling also installs its own standalone command (`ofp-validate`,
+`ofp-schedule`, `ofp-run`); `ofp <command>` is the convenience aggregator.
+
+Exit codes: `2` for an unknown/missing command or usage error at the `ofp`
+level; otherwise the subcommand's own exit code is returned unchanged.
+
+## Scope
+
+This repository contains only the dispatcher. Behavior, options, and semantics
+live in the sibling repositories linked above. The package is published to PyPI
+as `ofplang`; the `ofplang` import namespace is a PEP 420 namespace shared
+across the organization's tools, and this distribution provides `ofplang.ofp`.

ofplang-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+ofplang/ofp/__init__.py,sha256=FjUTmSAc-H9ST6jp7jY2U6f6YHv6JZ67Dm7DANdhyFM,80
+ofplang/ofp/__main__.py,sha256=dR2WSC9htXswd3n39fGtOy6zZJfHDDIuB_l3Ro8IPDQ,260
+ofplang/ofp/cli.py,sha256=eRUrBsfjXUSFPloUPFTujweOoWF23XTJETb6rxKKPl0,2827
+ofplang/ofp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ofplang-0.1.0.dist-info/licenses/LICENSE,sha256=weUnWoHlmaiawSjaLy_ECNpyTe7F5vDBfLGJKocpUhI,1071
+ofplang-0.1.0.dist-info/METADATA,sha256=G0MDwDeDbwk2hkC8GSG7-0uuWMWMy7UY5R78rNpcP8Y,3407
+ofplang-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+ofplang-0.1.0.dist-info/entry_points.txt,sha256=tgmKjki1rw4s2el99bLDob3HRUN96Pnb3TsyHDYPLhY,45
+ofplang-0.1.0.dist-info/top_level.txt,sha256=01Lkn2L6B0G7kbUY3KhZc2QhUvSj1NFv5JdrKECQDV0,8
+ofplang-0.1.0.dist-info/RECORD,,

ofplang-0.1.0.dist-info/WHEEL

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

ofplang-0.1.0.dist-info/entry_points.txt

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

ofplang-0.1.0.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.

ofplang-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ofplang