| [project] | |
| name = "vectorhd" | |
| version = "0.2.10" | |
| description = "Tier-1 HD-mode server-side image vectorization: segmentation-driven, topology-aware, sub-pixel accurate SVG tracing." | |
| readme = "README.md" | |
| requires-python = ">=3.11" | |
| license = { text = "MIT" } | |
| authors = [{ name = "VectorHD" }] | |
| # Core dependencies. Everything here must install and run CPU-only. | |
| # torch is listed as a core dep (device detection + optional refine hook), CPU wheels by default. | |
| dependencies = [ | |
| "numpy>=1.26,<3", | |
| "scipy>=1.11", | |
| "scikit-image>=0.22", | |
| "opencv-python-headless>=4.9", | |
| "pillow>=10.2", | |
| "fastapi>=0.110", | |
| "uvicorn[standard]>=0.29", | |
| "pydantic>=2.6", | |
| "pydantic-settings>=2.2", | |
| "python-multipart>=0.0.9", | |
| "torch>=2.2", | |
| ] | |
| [project.optional-dependencies] | |
| # `[sam]` — SAM 2 automatic mask segmentation backend. | |
| # SAM 2 is distributed ONLY from GitHub (facebookresearch/sam2). It is intentionally NOT a | |
| # resolvable dependency here: its setup imports torch at build time and registers under the | |
| # name `SAM-2`, so listing it as a git ref breaks even a plain `uv sync` (which resolves all | |
| # extras for the lockfile). It is also security-sensitive — the PyPI `sam2` package is an | |
| # unofficial third-party upload; do not use it. Install manually from the official repo: | |
| # git clone https://github.com/facebookresearch/sam2.git | |
| # cd sam2 && SAM2_BUILD_CUDA=0 pip install -e . # or: uv pip install --no-build-isolation -e . | |
| # Weights: `python scripts/download_weights.py`. This extra is a marker only; the backend | |
| # imports sam2 lazily and degrades gracefully when absent. | |
| sam = [] | |
| # `[refine]` — DiffVG differentiable rasterizer for gradient-based refinement. | |
| # The native `diffvg` C-extension + the `pydiffvg` wrapper are built from source (CMake + git | |
| # submodules; see README "DiffVG refinement") and are NOT pip-resolvable, so they stay out of | |
| # this list. But `pydiffvg`'s own pure-Python runtime deps ARE resolvable and are pinned here so | |
| # `uv pip install -e .[refine]` provides everything except the two vendored/built packages. | |
| # The runtime imports pydiffvg lazily and degrades gracefully when absent. | |
| refine = ["svgpathtools>=1.6", "svgwrite>=1.4", "cssutils>=2.9", "matplotlib>=3.7"] | |
| [dependency-groups] | |
| dev = [ | |
| "pytest>=8.1", | |
| "ruff>=0.4", | |
| "cairosvg>=2.7", | |
| "httpx>=0.27", | |
| "pyyaml>=6", | |
| "maturin>=1.14.1", | |
| # Corpus v1 evaluation. `svgpathtools` parses arbitrary third-party SVG into arclength- | |
| # samplable paths, which is how ground-truth outlines are recovered from a source SVG; it also | |
| # appears under the deprecated `[refine]` (DiffVG) extra, but the corpus must not depend on a | |
| # deprecated optional extra to run. `fonttools` renders open-font glyphs to outline paths for | |
| # the generated wordmark category. Both are evaluation-side only — never imported by `src/`. | |
| "svgpathtools>=1.6", | |
| "fonttools>=4.5", | |
| ] | |
| [build-system] | |
| requires = ["hatchling"] | |
| build-backend = "hatchling.build" | |
| [tool.hatch.build.targets.wheel] | |
| packages = ["src/vectorhd"] | |
| # The deploy build stamp, force-included because it is GITIGNORED (see .gitignore and | |
| # docs/deploy/huggingface.md). Hatchling's file selection is VCS-ignore-aware, so without this the | |
| # stamp is silently dropped from the wheel: measured, a wheel built with the file present shipped | |
| # `build_info.py` and NOT `build_info.json`. That failure is invisible — /healthz would report | |
| # `"build": null` on a correctly stamped deploy, which is exactly the "is this build what I think | |
| # it is?" ambiguity the stamp exists to remove. `artifacts` includes VCS-ignored paths explicitly, | |
| # so inclusion no longer depends on whether a .git happens to be present at build time (it is not, | |
| # inside the container, which is how this could have shipped working by accident and broken later). | |
| artifacts = ["src/vectorhd/build_info.json"] | |
| [tool.uv] | |
| default-groups = ["dev"] | |
| [tool.ruff] | |
| line-length = 100 | |
| target-version = "py311" | |
| src = ["src", "tests", "scripts"] | |
| [tool.ruff.lint] | |
| select = ["E", "F", "I", "UP", "B", "W", "C4", "SIM"] | |
| ignore = [ | |
| "B008", # FastAPI Depends()/File() in defaults is idiomatic | |
| "E741", # ambiguous var names (l, r for left/right labels are meaningful here) | |
| ] | |
| [tool.ruff.lint.per-file-ignores] | |
| "tests/*" = ["E501"] | |
| "scripts/*" = ["E501"] | |
| [tool.pytest.ini_options] | |
| testpaths = ["tests"] | |
| addopts = "-q" | |
| filterwarnings = [ | |
| "ignore::DeprecationWarning", | |
| ] | |