unitysvc-sellers 0.1.0__tar.gz

unitysvc_sellers-0.1.0/LICENSE

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

unitysvc_sellers-0.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: unitysvc-sellers
+Version: 0.1.0
+Summary: Seller-facing tools for UnitySVC: local catalog organization CLI (usvc_seller)
+Author-email: Bo Peng <bo.peng@unitysvc.com>
+Maintainer-email: Bo Peng <bo.peng@unitysvc.com>
+License-Expression: MIT
+Project-URL: bugs, https://github.com/unitysvc/unitysvc-sellers/issues
+Project-URL: homepage, https://github.com/unitysvc/unitysvc-sellers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: unitysvc-core>=0.1.0
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: jinja2
+Requires-Dist: json5
+Requires-Dist: tomli-w
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Provides-Extra: dev
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: ty; extra == "dev"
+Requires-Dist: ipdb; extra == "dev"
+Dynamic: license-file
+
+# unitysvc-sellers
+
+Seller-facing tools for [UnitySVC](https://unitysvc.com/). This package
+currently provides the `usvc_seller` CLI for **local** seller catalog
+organization — no network calls, no UnitySVC API interactions.
+
+The catalog HTTP SDK (`unitysvc_sellers.client`, upload, publish, etc.)
+is not yet implemented; see the roadmap below.
+
+## Install
+
+```bash
+pip install unitysvc-sellers
+```
+
+This pulls in [`unitysvc-core`](https://pypi.org/project/unitysvc-core/)
+for the shared data models, JSON schemas, and generic file validator,
+plus `typer`/`rich` for the CLI.
+
+## CLI: `usvc_seller`
+
+```
+usvc_seller data validate [DATA_DIR]           # schema + catalog-layout validation
+usvc_seller data format   [DATA_DIR]           # normalize JSON/TOML/MD files
+usvc_seller data populate [DATA_DIR]           # run provider populate scripts
+usvc_seller data show     provider  NAME       # show a provider record
+usvc_seller data show     offering  NAME       #   "   offering
+usvc_seller data show     listing   NAME       #   "   listing
+usvc_seller data show     service   NAME       #   "   service-definition
+usvc_seller data list     providers [DATA_DIR] # list files of each kind
+usvc_seller data list     sellers   [DATA_DIR]
+usvc_seller data list     offerings [DATA_DIR]
+usvc_seller data list     listings  [DATA_DIR]
+usvc_seller data list     services  [DATA_DIR]
+usvc_seller data list-tests                    # list code-example / connectivity tests
+usvc_seller data run-tests                     # run tests locally
+usvc_seller data show-test SERVICE             # show last test result
+```
+
+All commands operate on the seller's local catalog directory. No
+`usvc_seller data upload` yet — that arrives with the HTTP SDK.
+
+## Layout
+
+```
+src/unitysvc_sellers/
+├── cli.py           # entry point — registers data subcommands
+├── data.py          # `usvc_seller data *` command group
+├── validator.py     # seller DataValidator (subclass of unitysvc_core.validator.DataValidator)
+├── format_data.py   # `usvc_seller data format`
+├── populate.py      # `usvc_seller data populate`
+├── example.py       # `list-tests` / `run-tests` / `show-test`
+├── list.py          # `usvc_seller data list *`
+├── output.py        # shared Rich output helpers
+└── utils.py         # seller-only helpers (resolve_provider_name,
+                     #  resolve_service_name_for_listing,
+                     #  convert_convenience_fields_to_documents,
+                     #  render_template_file, execute_script_content,
+                     #  determine_interpreter)
+                     # Generic helpers re-exported from unitysvc_core.utils.
+```
+
+The seller `DataValidator` adds catalog-layout checks to the core
+per-file validator: provider-status warnings, the invariant that each
+service directory has exactly one `offering_v1` file, and the invariant
+that listings only live alongside an offering.
+
+## History
+
+This package was split out of
+[`unitysvc-services`](https://github.com/unitysvc/unitysvc-services)
+(see [issue #99](https://github.com/unitysvc/unitysvc-services/issues/99)).
+Shared types + schemas moved to
+[`unitysvc-core`](https://github.com/unitysvc/unitysvc-core); seller CLI
+and seller-specific catalog utilities live here.
+
+## Roadmap
+
+- `unitysvc_sellers.client` / `AsyncClient` — HTTP SDK against
+  `/sellers/*` endpoints
+- `usvc_seller data upload` — thin Typer wrapper over
+  `client.upload(...)`
+- `unitysvc_sellers.builders` — catalog-builder helpers
+  (`populate_from_iterator`, `render_template_file`, etc.) for
+  `unitysvc-services-*` data repositories
+
+## License
+
+MIT

unitysvc_sellers-0.1.0/README.md

@@ -0,0 +1,89 @@
+# unitysvc-sellers
+
+Seller-facing tools for [UnitySVC](https://unitysvc.com/). This package
+currently provides the `usvc_seller` CLI for **local** seller catalog
+organization — no network calls, no UnitySVC API interactions.
+
+The catalog HTTP SDK (`unitysvc_sellers.client`, upload, publish, etc.)
+is not yet implemented; see the roadmap below.
+
+## Install
+
+```bash
+pip install unitysvc-sellers
+```
+
+This pulls in [`unitysvc-core`](https://pypi.org/project/unitysvc-core/)
+for the shared data models, JSON schemas, and generic file validator,
+plus `typer`/`rich` for the CLI.
+
+## CLI: `usvc_seller`
+
+```
+usvc_seller data validate [DATA_DIR]           # schema + catalog-layout validation
+usvc_seller data format   [DATA_DIR]           # normalize JSON/TOML/MD files
+usvc_seller data populate [DATA_DIR]           # run provider populate scripts
+usvc_seller data show     provider  NAME       # show a provider record
+usvc_seller data show     offering  NAME       #   "   offering
+usvc_seller data show     listing   NAME       #   "   listing
+usvc_seller data show     service   NAME       #   "   service-definition
+usvc_seller data list     providers [DATA_DIR] # list files of each kind
+usvc_seller data list     sellers   [DATA_DIR]
+usvc_seller data list     offerings [DATA_DIR]
+usvc_seller data list     listings  [DATA_DIR]
+usvc_seller data list     services  [DATA_DIR]
+usvc_seller data list-tests                    # list code-example / connectivity tests
+usvc_seller data run-tests                     # run tests locally
+usvc_seller data show-test SERVICE             # show last test result
+```
+
+All commands operate on the seller's local catalog directory. No
+`usvc_seller data upload` yet — that arrives with the HTTP SDK.
+
+## Layout
+
+```
+src/unitysvc_sellers/
+├── cli.py           # entry point — registers data subcommands
+├── data.py          # `usvc_seller data *` command group
+├── validator.py     # seller DataValidator (subclass of unitysvc_core.validator.DataValidator)
+├── format_data.py   # `usvc_seller data format`
+├── populate.py      # `usvc_seller data populate`
+├── example.py       # `list-tests` / `run-tests` / `show-test`
+├── list.py          # `usvc_seller data list *`
+├── output.py        # shared Rich output helpers
+└── utils.py         # seller-only helpers (resolve_provider_name,
+                     #  resolve_service_name_for_listing,
+                     #  convert_convenience_fields_to_documents,
+                     #  render_template_file, execute_script_content,
+                     #  determine_interpreter)
+                     # Generic helpers re-exported from unitysvc_core.utils.
+```
+
+The seller `DataValidator` adds catalog-layout checks to the core
+per-file validator: provider-status warnings, the invariant that each
+service directory has exactly one `offering_v1` file, and the invariant
+that listings only live alongside an offering.
+
+## History
+
+This package was split out of
+[`unitysvc-services`](https://github.com/unitysvc/unitysvc-services)
+(see [issue #99](https://github.com/unitysvc/unitysvc-services/issues/99)).
+Shared types + schemas moved to
+[`unitysvc-core`](https://github.com/unitysvc/unitysvc-core); seller CLI
+and seller-specific catalog utilities live here.
+
+## Roadmap
+
+- `unitysvc_sellers.client` / `AsyncClient` — HTTP SDK against
+  `/sellers/*` endpoints
+- `usvc_seller data upload` — thin Typer wrapper over
+  `client.upload(...)`
+- `unitysvc_sellers.builders` — catalog-builder helpers
+  (`populate_from_iterator`, `render_template_file`, etc.) for
+  `unitysvc-services-*` data repositories
+
+## License
+
+MIT

unitysvc_sellers-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "unitysvc-sellers"
+version = "0.1.0"
+description = "Seller-facing tools for UnitySVC: local catalog organization CLI (usvc_seller)"
+readme = "README.md"
+authors = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]
+maintainers = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]
+license = "MIT"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+dependencies = [
+  "unitysvc-core>=0.1.0",
+  "typer",
+  "rich",
+  "jinja2",
+  "json5",
+  "tomli-w",
+]
+requires-python = ">= 3.11"
+
+[project.optional-dependencies]
+test = [
+  "coverage",
+  "pytest",
+  "ruff",
+  "mypy",
+]
+dev = [
+  "coverage",
+  "pytest",
+  "ruff",
+  "ty",
+  "ipdb",
+]
+
+[project.urls]
+bugs = "https://github.com/unitysvc/unitysvc-sellers/issues"
+homepage = "https://github.com/unitysvc/unitysvc-sellers"
+
+[project.scripts]
+usvc_seller = "unitysvc_sellers.cli:app"
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+  "E",  # pycodestyle errors
+  "W",  # pycodestyle warnings
+  "F",  # Pyflakes
+  "I",  # isort
+  "B",  # flake8-bugbear
+  "UP", # pyupgrade
+]
+ignore = [
+  "B008", # Typer pattern uses function calls in argument defaults
+  "B904",
+]
+
+[tool.mypy]
+ignore_missing_imports = true
+warn_unused_ignores = false
+disable_error_code = ["import-untyped"]
+
+[tool.uv]
+package = true
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+unitysvc_sellers = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

unitysvc_sellers-0.1.0/setup.cfg

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

unitysvc_sellers-0.1.0/src/unitysvc_sellers/__init__.py

@@ -0,0 +1,18 @@
+"""UnitySVC Sellers — seller-facing tools for UnitySVC.
+
+This package currently provides:
+
+- ``usvc_seller`` CLI with ``usvc_seller data *`` commands for organizing
+  local seller catalogs (validate, format, populate, show, list, run test
+  scripts).
+
+Future additions (separate modules, not yet present):
+
+- ``unitysvc_sellers.client`` / ``AsyncClient`` — seller HTTP SDK
+- ``unitysvc_sellers.builders`` — catalog-builder helpers for
+  ``unitysvc-services-*`` data repositories
+- ``usvc_seller data upload`` — re-added when the SDK lands
+"""
+
+__author__ = """Bo Peng"""
+__email__ = "bo.peng@unitysvc.com"

unitysvc_sellers-0.1.0/src/unitysvc_sellers/cli.py

@@ -0,0 +1,40 @@
+"""Console script for ``unitysvc_sellers`` — the ``usvc_seller`` CLI."""
+
+from __future__ import annotations
+
+import importlib.metadata
+
+import typer
+
+from . import data
+
+
+def version_callback(value: bool) -> None:
+    if value:
+        version = importlib.metadata.version("unitysvc-sellers")
+        typer.echo(f"unitysvc-sellers {version}")
+        raise typer.Exit()
+
+
+app = typer.Typer(help="UnitySVC seller CLI — local data organization tools.")
+
+
+@app.callback()
+def main(
+    version: bool | None = typer.Option(
+        None,
+        "--version",
+        "-V",
+        help="Show version and exit.",
+        callback=version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    """UnitySVC seller CLI."""
+
+
+app.add_typer(data.app, name="data")
+
+
+if __name__ == "__main__":
+    app()