pyproject.toml

[project]
name = "vstack"
dynamic = ["version"]
description = "VS Code-native AI engineering workflow system for microservices, libraries, and backend systems."
license = "MIT"
readme = "README-pypi.md"
requires-python = ">=3.11,<3.15"
dependencies = ["pyyaml>=6.0.3"]
keywords = [
    "github-copilot",
    "vscode",
    "ai-workflows",
    "developer-tools",
    "devx",
    "engineering-workflow",
    "copilot-agent-mode",
    "backend",
    "microservices",
    "api",
    "workflow-automation",
    "release-engineering",
    "agentic-workflow",
    "agentic-ai",
    "ai-agent",
    "llm",
    "llm-agents",
    "prompt-engineering",
    "code-generation",
    "scaffolding",
    "cli",
    "agents",
]
classifiers = [
    "Development Status :: 4 - Beta",
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Topic :: Software Development :: Build Tools",
    "Topic :: Software Development :: Code Generators",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Utilities",
]

[project.urls]
Homepage = "https://github.com/eschaar/vstack"
Documentation = "https://github.com/eschaar/vstack/blob/main/README.md"
Repository = "https://github.com/eschaar/vstack"
Issues = "https://github.com/eschaar/vstack/issues"
Changelog = "https://github.com/eschaar/vstack/blob/main/CHANGELOG.md"
Discussions = "https://github.com/eschaar/vstack/discussions"
Security = "https://github.com/eschaar/vstack/blob/main/SECURITY.md"

[project.scripts]
vstack = "vstack:main"

# ---------------------------------------------------------------------------
# Poetry-specific packaging config (package layout, file inclusion, dev deps).
# [project] above covers PEP 621 metadata; Poetry reads both.
# ---------------------------------------------------------------------------

[tool.poetry]
packages = [{include = "vstack", from = "src"}]
include = [
    { path = "src/vstack/_templates", format = ["sdist", "wheel"] },
    { path = "src/vstack/_migrations", format = ["sdist", "wheel"] },
]
# Keep the placeholder version last because the plugin may remove/re-add it in
# PEP 621 mode, which otherwise causes noisy key reordering.
version = "3.7.0"

[tool.poetry.requires-plugins]
poetry-dynamic-versioning = { version = ">=1.10.0,<2.0.0", extras = ["plugin"] }

[tool.poetry.group.dev.dependencies]
pytest = ">=9.1.1"
pytest-cov = ">=7.1.0"
ruff = ">=0.16.3"
mypy = ">=2.3.0"
pre-commit = ">=4.6.2"
tox = ">=4.59.0"
types-PyYAML = ">=6.0.12.20260815"


# ---------------------------------------------------------------------------
# pytest
# ---------------------------------------------------------------------------

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
pythonpath = ["src"]
addopts = [
    "--import-mode=importlib",
    "--basetemp=.pytest-tmp",
    "--cov=src/vstack",
    "--cov-report=term-missing",
    "--cov-fail-under=100",
]

# ---------------------------------------------------------------------------
# ruff
# ---------------------------------------------------------------------------

[tool.ruff]
target-version = "py311"
line-length = 100

[tool.ruff.lint]
select = ["E", "F", "W", "I", "UP"]
ignore = [
    "E501",  # line too long — handled by formatter
]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"

# ---------------------------------------------------------------------------
# mypy
# ---------------------------------------------------------------------------

[tool.mypy]
python_version = "3.11"
strict = false
warn_unused_ignores = true
warn_return_any = false
ignore_missing_imports = true

# ---------------------------------------------------------------------------
# pylint
# ---------------------------------------------------------------------------

[tool.pylint.main]
# Ensure src-layout imports (e.g. vstack.hooks) resolve in editor-integrated pylint runs.
init-hook = "import sys; sys.path.insert(0, 'src')"
py-version = "3.11"

# ---------------------------------------------------------------------------
# build system
# ---------------------------------------------------------------------------

[build-system]
requires = ["poetry-core>=2.4.0", "poetry-dynamic-versioning>=1.10.0,<2.0.0"]
build-backend = "poetry_dynamic_versioning.backend"

# ---------------------------------------------------------------------------
# poetry-dynamic-versioning — reads version from git tags at build time.
# With `strict = true`, build/version resolution fails when no valid tag/version
# can be resolved (e.g. shallow clone, missing tags, or non-matching tag format).
# The placeholder `tool.poetry.version` value (`0.0.0`) is not used as fallback.
# ---------------------------------------------------------------------------

[tool.poetry-dynamic-versioning]
enable = true
vcs = "git"
# Repository tags are plain SemVer without a leading v (e.g. 1.3.4).
pattern = "default-unprefixed"
strict = true
style = "pep440"

# ---------------------------------------------------------------------------
# pyright is used for type checking in VS Code, by Pylance.
# The "extraPaths" setting is used to find the "scripts" directory,
# which contains the main code for vstack, but is not a project dependency.
# ---------------------------------------------------------------------------

[tool.pyright]
pythonVersion = "3.11"
extraPaths = ["scripts"]

[tool.tox]
legacy_tox_ini = """
[tox]
min_version = 4.54.0
env_list = py311, py312, py313, py314, lint, type
skip_missing_interpreters = true

[testenv]
description = Run pytest for {env_name}
package = skip
deps =
    pytest>=9.0.3
    pytest-cov>=7.1.0
    pyyaml>=6.0.3
setenv =
    PYTHONPATH = {tox_root}/src
commands =
    python -m pytest -q

[testenv:lint]
description = Run ruff lint checks
package = skip
deps =
    ruff>=0.15.12
commands =
    ruff check src tests

[testenv:type]
description = Run mypy type checks
package = skip
deps =
    mypy>=2.1.0
    types-PyYAML>=6.0.12.20260510
commands =
    mypy src tests
"""