gnaww-cli 0.1.0__tar.gz

gnaww_cli-0.1.0/LICENSE

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

gnaww_cli-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: gnaww-cli
+Version: 0.1.0
+Summary: Official command line interface for the Gnaww print intelligence API.
+Author: Jawwws Ltd
+License: MIT License
+        
+        Copyright (c) 2026 Jawwws Ltd
+        
+        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.
+        
+Project-URL: Homepage, https://gnaww.io
+Keywords: gnaww,print,cli,api
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1.0.0,>=0.28.0
+Dynamic: license-file
+
+# Gnaww CLI
+
+Official command line interface for the Gnaww print intelligence API.
+
+Gnaww accepts incomplete, inconsistent or system-originated print intent, turns it into controlled print requirements and can use SpecMatch™ to compare those requirements with compatible production capability.
+
+Capability fit is not a live price, confirmed availability, producer acceptance or an order.
+
+## Requirements
+
+- Python 3.11 or newer
+- a Gnaww developer API credential
+
+## Install
+
+The recommended isolated installation is:
+
+```bash
+pipx install gnaww-cli
+```
+
+A normal Python installation is also supported:
+
+```bash
+python -m pip install gnaww-cli
+```
+
+## Configuration
+
+Set the scoped Gnaww API credential in your environment:
+
+```bash
+export GNAWW_API_KEY="<developer-api-key>"
+```
+
+The CLI uses `https://api.gnaww.io` by default. Optional configuration is available through:
+
+```bash
+export GNAWW_API_BASE_URL="https://api.gnaww.io"
+export GNAWW_WORKSPACE_ID="<workspace-id>"
+```
+
+Keep API credentials private. Do not commit them to source control or paste them into tickets, chat or documents.
+
+## Commands
+
+```text
+gnaww consume
+gnaww digest
+gnaww crunch
+gnaww eat
+gnaww devour
+gnaww regurgitate
+gnaww completion
+```
+
+### consume
+
+Interpret one ordinary-language print requirement:
+
+```bash
+gnaww consume "500 A5 double-sided flyers on 170gsm silk"
+```
+
+Use `--json` for stable machine-readable output.
+
+Incomplete requirements remain unresolved and may return clarification information. The CLI does not invent missing identity-defining physical attributes.
+
+### digest
+
+Inspect one retained Recipe or a local JSON result:
+
+```bash
+gnaww digest GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV
+gnaww digest result.json
+```
+
+### crunch
+
+Run SpecMatch™ for one resolved Recipe against an explicit capability target:
+
+```bash
+gnaww crunch GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV \
+  --quantity 500 \
+  --source demo_fixture \
+  --producer-profile-id northline-demo
+```
+
+Fixture-backed capability remains labelled as fixture-backed.
+
+### eat
+
+Convenience flow that consumes a requirement, resolves a Recipe when eligible and continues into SpecMatch only when the required capability target is supplied:
+
+```bash
+gnaww eat "500 A5 flyers on 170gsm silk"
+```
+
+If clarification is required, the command stops safely rather than guessing.
+
+### devour
+
+Process a bounded batch from text, CSV or JSON:
+
+```bash
+gnaww devour requirements.csv
+```
+
+### regurgitate
+
+Retrieve or export a Recipe or local result:
+
+```bash
+gnaww regurgitate GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV --format json
+gnaww regurgitate result.json --format yaml
+```
+
+### completion
+
+Print dependency-light shell completion:
+
+```bash
+gnaww completion bash
+gnaww completion zsh
+gnaww completion fish
+```
+
+## Output and safety
+
+The CLI supports human-readable and JSON output, stable process exit codes and request/correlation identifiers returned by the Gnaww API.
+
+Recipe ID identifies a canonical physical manufacturing definition. It is not an order number, customer identifier, producer selection, price or availability state.
+
+Gnaww and SpecMatch™ intelligence remain server-side. This package is an API client, local input/output adapter and presentation surface only.
+
+## Licence
+
+MIT. See `LICENSE`.

gnaww_cli-0.1.0/README.md

@@ -0,0 +1,138 @@
+# Gnaww CLI
+
+Official command line interface for the Gnaww print intelligence API.
+
+Gnaww accepts incomplete, inconsistent or system-originated print intent, turns it into controlled print requirements and can use SpecMatch™ to compare those requirements with compatible production capability.
+
+Capability fit is not a live price, confirmed availability, producer acceptance or an order.
+
+## Requirements
+
+- Python 3.11 or newer
+- a Gnaww developer API credential
+
+## Install
+
+The recommended isolated installation is:
+
+```bash
+pipx install gnaww-cli
+```
+
+A normal Python installation is also supported:
+
+```bash
+python -m pip install gnaww-cli
+```
+
+## Configuration
+
+Set the scoped Gnaww API credential in your environment:
+
+```bash
+export GNAWW_API_KEY="<developer-api-key>"
+```
+
+The CLI uses `https://api.gnaww.io` by default. Optional configuration is available through:
+
+```bash
+export GNAWW_API_BASE_URL="https://api.gnaww.io"
+export GNAWW_WORKSPACE_ID="<workspace-id>"
+```
+
+Keep API credentials private. Do not commit them to source control or paste them into tickets, chat or documents.
+
+## Commands
+
+```text
+gnaww consume
+gnaww digest
+gnaww crunch
+gnaww eat
+gnaww devour
+gnaww regurgitate
+gnaww completion
+```
+
+### consume
+
+Interpret one ordinary-language print requirement:
+
+```bash
+gnaww consume "500 A5 double-sided flyers on 170gsm silk"
+```
+
+Use `--json` for stable machine-readable output.
+
+Incomplete requirements remain unresolved and may return clarification information. The CLI does not invent missing identity-defining physical attributes.
+
+### digest
+
+Inspect one retained Recipe or a local JSON result:
+
+```bash
+gnaww digest GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV
+gnaww digest result.json
+```
+
+### crunch
+
+Run SpecMatch™ for one resolved Recipe against an explicit capability target:
+
+```bash
+gnaww crunch GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV \
+  --quantity 500 \
+  --source demo_fixture \
+  --producer-profile-id northline-demo
+```
+
+Fixture-backed capability remains labelled as fixture-backed.
+
+### eat
+
+Convenience flow that consumes a requirement, resolves a Recipe when eligible and continues into SpecMatch only when the required capability target is supplied:
+
+```bash
+gnaww eat "500 A5 flyers on 170gsm silk"
+```
+
+If clarification is required, the command stops safely rather than guessing.
+
+### devour
+
+Process a bounded batch from text, CSV or JSON:
+
+```bash
+gnaww devour requirements.csv
+```
+
+### regurgitate
+
+Retrieve or export a Recipe or local result:
+
+```bash
+gnaww regurgitate GNR-01ARZ3NDEKTSV4RRFFQ69G5FAV --format json
+gnaww regurgitate result.json --format yaml
+```
+
+### completion
+
+Print dependency-light shell completion:
+
+```bash
+gnaww completion bash
+gnaww completion zsh
+gnaww completion fish
+```
+
+## Output and safety
+
+The CLI supports human-readable and JSON output, stable process exit codes and request/correlation identifiers returned by the Gnaww API.
+
+Recipe ID identifies a canonical physical manufacturing definition. It is not an order number, customer identifier, producer selection, price or availability state.
+
+Gnaww and SpecMatch™ intelligence remain server-side. This package is an API client, local input/output adapter and presentation surface only.
+
+## Licence
+
+MIT. See `LICENSE`.

gnaww_cli-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gnaww-cli"
+version = "0.1.0"
+description = "Official command line interface for the Gnaww print intelligence API."
+readme = "README.md"
+requires-python = ">=3.11"
+license = {file = "LICENSE"}
+authors = [{name = "Jawwws Ltd"}]
+dependencies = [
+    "httpx>=0.28.0,<1.0.0",
+]
+keywords = ["gnaww", "print", "cli", "api"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+gnaww = "gnaww_cli.cli:main"
+
+[project.urls]
+Homepage = "https://gnaww.io"
+
+[tool.setuptools.packages.find]
+where = ["src"]

gnaww_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gnaww_cli-0.1.0/src/gnaww_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Official Gnaww command line client."""
+
+__version__ = "0.1.0"

gnaww_cli-0.1.0/src/gnaww_cli/__main__.py

@@ -0,0 +1,3 @@
+from gnaww_cli.cli import main
+
+raise SystemExit(main())