loobric-cli 1.0.0__tar.gz

loobric_cli-1.0.0/LICENSE

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

loobric_cli-1.0.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: loobric-cli
+Version: 1.0.0
+Summary: Python client library and CLI for Loobric Core (CNC tool-data sync).
+Author: sliptonic
+License: MIT
+Project-URL: Homepage, https://github.com/loobric/loobric-cli
+Project-URL: Repository, https://github.com/loobric/loobric-cli
+Project-URL: Issues, https://github.com/loobric/loobric-cli/issues
+Keywords: cnc,cam,tool-data,freecad,linuxcnc,machining
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Classifier: Intended Audience :: Manufacturing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: importers
+Requires-Dist: lxml>=5.0; extra == "importers"
+Provides-Extra: completion
+Requires-Dist: argcomplete>=3.0; extra == "completion"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Dynamic: license-file
+
+# loobric-cli
+
+Python client for [Loobric Core](https://github.com/loobric/loobric-core) — the
+library and CLI for synchronizing CNC tool data. It speaks only the public REST
+API and depends on nothing from the server.
+
+> **New in v0.4.0 — a seed script + a public sandbox.**
+> [`examples/quickstart.sh`](examples/quickstart.sh) is a readable list of plain
+> `loobric` commands that seeds an account with a small demo catalog (two
+> manufacturers) and walks the whole loop — machine → catalog → instance → tool
+> set → tool-table push. Run it to give a fresh account something to explore;
+> read it to learn how to script the CLI. Point it at the free hosted sandbox and
+> kick the tires without installing a server. See [docs/SANDBOX.md](docs/SANDBOX.md).
+>
+> **New in v0.3.0 — full list/show symmetry.** Every listable entity now has a
+> matching `show` verb: `show-machine`, `show-tool`, and `show-key` join the
+> existing `show-*` commands, each resolving its target by id, name, or unique
+> prefix. List to find it, show to inspect it — one consistent pattern everywhere.
+>
+> **`loobric import` — stop re-typing tool data.** One command auto-detects the
+> format and turns a vendor export into catalog records on your server:
+> **DIN 4000** (CSV + XML 2013/2016), **STEP P21**, **GTC packages** (ISO 13399),
+> **SolidCAM**, and **hyperMILL**. Every imported field keeps its source, and the
+> raw payload is preserved verbatim so nothing is lost or guessed. GTC packages
+> also carry the tool's 3D STEP models and images, uploaded as canonical media on
+> servers whose media backend is enabled. See
+> [docs/IMPORTERS_PLAN.md](docs/IMPORTERS_PLAN.md).
+>
+> The importable library (`loobric.Client`) and the `loobric` CLI are both
+> here, ported from the old single-file `loobric.py` — see
+> [docs/adr/0001-extract-loobric-cli.md](docs/adr/0001-extract-loobric-cli.md).
+
+## Install
+
+```bash
+pip install loobric-cli   # library + CLI + every bundled importer — stdlib only, no deps
+```
+
+Everything ships in the base install. The library, the `loobric` CLI, and all of
+today's importers (DIN 4000, STEP P21, GTC, SolidCAM, hyperMILL) are
+standard-library only, so the package stays vendorable and runs in constrained
+interpreters. The optional `[importers]` extra is reserved for future formats
+that need heavier parsers; no bundled importer requires it yet.
+
+## Try the sandbox
+
+Don't want to run a server yet? Point the client at the free hosted **sandbox**
+and explore against live data:
+
+```bash
+pip install loobric-cli
+export LOOBRIC_BASE_URL=https://api.loobric.com
+loobric register you@example.com        # create an account
+loobric login you@example.com           # then mint a key (below)
+loobric create-key sandbox --scopes "read write"
+export LOOBRIC_API_KEY=<the key it prints>    # the CLI reads this automatically
+curl -O https://raw.githubusercontent.com/loobric/loobric-cli/master/examples/quickstart.sh
+bash quickstart.sh                     # seed a demo and walk the loop
+```
+
+The sandbox is a shared demo server — **data may be reset and accounts removed,
+so keep nothing real there.** Full walkthrough (and why API keys, not sessions):
+[docs/SANDBOX.md](docs/SANDBOX.md).
+
+## Library
+
+```python
+from loobric import Client, NotFound
+
+c = Client(base_url="http://nas:8000", api_key="...")   # solo mode: omit api_key
+for s in c.list_tool_sets():
+    print(s)
+```
+
+Every method returns parsed data and raises a `LoobricClientError` subclass
+(`NotFound`, `AuthRequired`, `HTTPError`, `ConnectionFailed`) on failure — it
+never prints or exits, so callers handle failure themselves.
+
+## CLI
+
+`loobric <verb>` is the universal command-line client (the role the old `loobric`
+command served). See the [CLI reference and walkthrough](docs/CLI.md).
+
+```bash
+loobric --help
+loobric list-machines
+loobric show-machine mill01            # by name, id, or unique prefix
+loobric create-record --from-catalog B201 --name "1/4 downcut"
+loobric show-tool "1/4 downcut"        # one instance, full provenance
+```
+
+Every `list-*` verb has a matching `show-*` verb (`show-machine`, `show-tool`,
+`show-tool-set`, `show-key`, …), each resolving its target by id, name, or
+unique prefix — list to find it, show to inspect it.
+
+### Importing tool data
+
+`loobric import` reads a vendor export, detects the format, and creates catalog
+records on the server. Use `--dry-run` to see exactly what would be created
+without sending anything:
+
+```bash
+loobric import tools.csv --dry-run        # DIN 4000 CSV — preview only
+loobric import tools.xml                   # DIN 4000 / SolidCAM / hyperMILL (by XML root)
+loobric import catalog.p21                  # STEP P21
+loobric import package.zip                  # GTC package (ISO 13399) + 3D models & images
+```
+
+Re-importing the same catalog is detected by natural key and reported as
+*skipped*, never duplicated.
+
+## License
+
+MIT. (The server, Loobric Core, is AGPL-3.0; this client is MIT so it can be
+freely vendored and reused.)

loobric_cli-1.0.0/README.md

@@ -0,0 +1,115 @@
+# loobric-cli
+
+Python client for [Loobric Core](https://github.com/loobric/loobric-core) — the
+library and CLI for synchronizing CNC tool data. It speaks only the public REST
+API and depends on nothing from the server.
+
+> **New in v0.4.0 — a seed script + a public sandbox.**
+> [`examples/quickstart.sh`](examples/quickstart.sh) is a readable list of plain
+> `loobric` commands that seeds an account with a small demo catalog (two
+> manufacturers) and walks the whole loop — machine → catalog → instance → tool
+> set → tool-table push. Run it to give a fresh account something to explore;
+> read it to learn how to script the CLI. Point it at the free hosted sandbox and
+> kick the tires without installing a server. See [docs/SANDBOX.md](docs/SANDBOX.md).
+>
+> **New in v0.3.0 — full list/show symmetry.** Every listable entity now has a
+> matching `show` verb: `show-machine`, `show-tool`, and `show-key` join the
+> existing `show-*` commands, each resolving its target by id, name, or unique
+> prefix. List to find it, show to inspect it — one consistent pattern everywhere.
+>
+> **`loobric import` — stop re-typing tool data.** One command auto-detects the
+> format and turns a vendor export into catalog records on your server:
+> **DIN 4000** (CSV + XML 2013/2016), **STEP P21**, **GTC packages** (ISO 13399),
+> **SolidCAM**, and **hyperMILL**. Every imported field keeps its source, and the
+> raw payload is preserved verbatim so nothing is lost or guessed. GTC packages
+> also carry the tool's 3D STEP models and images, uploaded as canonical media on
+> servers whose media backend is enabled. See
+> [docs/IMPORTERS_PLAN.md](docs/IMPORTERS_PLAN.md).
+>
+> The importable library (`loobric.Client`) and the `loobric` CLI are both
+> here, ported from the old single-file `loobric.py` — see
+> [docs/adr/0001-extract-loobric-cli.md](docs/adr/0001-extract-loobric-cli.md).
+
+## Install
+
+```bash
+pip install loobric-cli   # library + CLI + every bundled importer — stdlib only, no deps
+```
+
+Everything ships in the base install. The library, the `loobric` CLI, and all of
+today's importers (DIN 4000, STEP P21, GTC, SolidCAM, hyperMILL) are
+standard-library only, so the package stays vendorable and runs in constrained
+interpreters. The optional `[importers]` extra is reserved for future formats
+that need heavier parsers; no bundled importer requires it yet.
+
+## Try the sandbox
+
+Don't want to run a server yet? Point the client at the free hosted **sandbox**
+and explore against live data:
+
+```bash
+pip install loobric-cli
+export LOOBRIC_BASE_URL=https://api.loobric.com
+loobric register you@example.com        # create an account
+loobric login you@example.com           # then mint a key (below)
+loobric create-key sandbox --scopes "read write"
+export LOOBRIC_API_KEY=<the key it prints>    # the CLI reads this automatically
+curl -O https://raw.githubusercontent.com/loobric/loobric-cli/master/examples/quickstart.sh
+bash quickstart.sh                     # seed a demo and walk the loop
+```
+
+The sandbox is a shared demo server — **data may be reset and accounts removed,
+so keep nothing real there.** Full walkthrough (and why API keys, not sessions):
+[docs/SANDBOX.md](docs/SANDBOX.md).
+
+## Library
+
+```python
+from loobric import Client, NotFound
+
+c = Client(base_url="http://nas:8000", api_key="...")   # solo mode: omit api_key
+for s in c.list_tool_sets():
+    print(s)
+```
+
+Every method returns parsed data and raises a `LoobricClientError` subclass
+(`NotFound`, `AuthRequired`, `HTTPError`, `ConnectionFailed`) on failure — it
+never prints or exits, so callers handle failure themselves.
+
+## CLI
+
+`loobric <verb>` is the universal command-line client (the role the old `loobric`
+command served). See the [CLI reference and walkthrough](docs/CLI.md).
+
+```bash
+loobric --help
+loobric list-machines
+loobric show-machine mill01            # by name, id, or unique prefix
+loobric create-record --from-catalog B201 --name "1/4 downcut"
+loobric show-tool "1/4 downcut"        # one instance, full provenance
+```
+
+Every `list-*` verb has a matching `show-*` verb (`show-machine`, `show-tool`,
+`show-tool-set`, `show-key`, …), each resolving its target by id, name, or
+unique prefix — list to find it, show to inspect it.
+
+### Importing tool data
+
+`loobric import` reads a vendor export, detects the format, and creates catalog
+records on the server. Use `--dry-run` to see exactly what would be created
+without sending anything:
+
+```bash
+loobric import tools.csv --dry-run        # DIN 4000 CSV — preview only
+loobric import tools.xml                   # DIN 4000 / SolidCAM / hyperMILL (by XML root)
+loobric import catalog.p21                  # STEP P21
+loobric import package.zip                  # GTC package (ISO 13399) + 3D models & images
+```
+
+Re-importing the same catalog is detected by natural key and reported as
+*skipped*, never duplicated.
+
+## License
+
+MIT. (The server, Loobric Core, is AGPL-3.0; this client is MIT so it can be
+freely vendored and reused.)

loobric_cli-1.0.0/loobric/__init__.py

@@ -0,0 +1,26 @@
+# MIT License
+# Copyright (c) 2025 sliptonic
+# SPDX-License-Identifier: MIT
+"""Loobric client — importable Python library for the Loobric Core API.
+
+Speaks only the public REST API and depends on nothing from the server, so a
+client (FreeCAD, future Fusion, scripts) can `pip install loobric-cli` and
+reuse this rather than writing its own HTTP layer.
+"""
+from loobric.client import Client
+from loobric.errors import (
+    AuthRequired,
+    ConnectionFailed,
+    HTTPError,
+    NotFound,
+    LoobricClientError,
+)
+
+__all__ = [
+    "Client",
+    "LoobricClientError",
+    "ConnectionFailed",
+    "HTTPError",
+    "NotFound",
+    "AuthRequired",
+]

loobric_cli-1.0.0/loobric/cli/__init__.py

@@ -0,0 +1,8 @@
+# MIT License
+# Copyright (c) 2025 sliptonic
+# SPDX-License-Identifier: MIT
+"""Loobric client CLI package. Entry point: ``loobric.cli.main:main``.
+
+Intentionally does not import ``main`` here — that would shadow the ``main``
+submodule (a function and a module sharing the name on the package).
+"""