pyproject.toml

[tool.poetry]
name          = "poethepoet"
version       = "0.22.0"
description   = "A task runner that works well with poetry."
authors       = ["Nat Noordanus <n@noordan.us>"]
readme        = "README.md"
license       = "MIT"
repository    = "https://github.com/nat-n/poethepoet"
homepage      = "https://github.com/nat-n/poethepoet"
documentation = "http://poethepoet.natn.io/"
keywords      = ["automation", "tasks", "task-runner", "plugin", "poetry", "poe"]
classifiers   = ["Topic :: Software Development :: Build Tools"]

[tool.poetry.dependencies]
python = ">=3.8"
pastel = "^0.2.1"
tomli  = ">=1.2.2"
poetry = {version = "^1.0", allow-prereleases = true, optional = true}

[tool.poetry.group.ci.dependencies]
black      = "^23.3.0"
isort      = "^5.12.0"
mypy       = "^1.1.1"
pylint     = "^2.13.0"
pytest     = "^7.1.2"
pytest-cov = "^3.0.0"
rstcheck   = { version = "^6.1.2", python = "<4" }

virtualenv = "^20.14.1"

poe_test_helpers = { path = "./tests/fixtures/packages/poe_test_helpers" }

[tool.poetry.group.dev.dependencies]
bpython    = "^0.24"

[tool.poetry.group.docs.dependencies]
furo                = "^2023.3.27"
livereload          = "^2.6.3"
sphinx              = "^6.1.3"
sphinx-copybutton   = "^0.5.1"
sphinxext-opengraph = "^0.8.1"

[tool.poetry.extras]
poetry_plugin = ["poetry"]

[tool.poetry.scripts]
poe = "poethepoet:main"

[tool.poetry.plugins."poetry.application.plugin"]
poethepoet = "poethepoet.plugin:PoetryPlugin"


[tool.poe.tasks]

_clean_docs.script = "shutil:rmtree('docs/_build', ignore_errors=1)"

  [tool.poe.tasks.format-isort]
  help = "Run isort on the code base"
  cmd  = "isort ."

  [tool.poe.tasks.format-black]
  help = "Run black on the code base"
  cmd  = "black ."

  [tool.poe.tasks.format]
  help     = "Run formating tools on the code base"
  sequence = ["format-isort", "format-black"]

  [tool.poe.tasks.docs]
  help = "Build the docs using Sphinx"
  cmd  = "sphinx-build docs docs/_build"
  deps = ["_clean_docs"]

  [tool.poe.tasks.docs-serve]
  help   = "Serves the docs locally with livereload"
  script = "docs:serve"
  cwd    = "./docs"
  deps   = ["docs"]

  [tool.poe.tasks.docs-check]
  help = "Validate rst syntax in the docs"
  sequence = [
    { cmd  = "rstcheck -r docs --ignore-roles bash,toml,sh,python --ignore-substitutions V" },
    "docs -b linkcheck"
  ]

  [tool.poe.tasks.clean]
  help = "Remove generated files"
  cmd  = """
    # multiline commands including comments work too!
    rm -rf .coverage
           .mypy_cache
           .pytest_cache
           ./**/__pycache__
           dist
           htmlcov
           ./docs/_build
           ./tests/fixtures/simple_project/venv
           ./tests/fixtures/venv_project/myvenv
           ./tests/fixtures/poetry_plugin_project/**/.venv
           ./tests/temp
  """

  [tool.poe.tasks.test]
  help = "Run unit and feature tests"
  cmd  = "pytest --cov=poethepoet"

  [tool.poe.tasks.test-quick]
  help = "Run unit and feature tests, excluding slow ones"
  cmd  = "pytest --cov=poethepoet -m \"not slow\""

  [tool.poe.tasks.types]
  help = "Run the type checker"
  cmd  = "mypy poethepoet --ignore-missing-imports"

  [tool.poe.tasks.lint]
  help = "Run the linter"
  cmd  = "pylint poethepoet"

  [tool.poe.tasks.style-black]
  help = "Validate black code style"
  cmd  = "black . --check --diff"

  [tool.poe.tasks.style-isort]
  help = "Validate isort code style"
  cmd  = "isort . --check --diff"

  [tool.poe.tasks.style]
  help = "Validate code style"
  sequence = ["style-isort", "style-black"]

  [tool.poe.tasks.check]
  help     = "Run all checks on the code base"
  sequence = ["docs-check", "style", "types", "lint", "test"]

  [tool.poe.tasks.install-poetry-plugin]
  help = "Install or update this project as a plugin in poetry"
  sequence = [
    { cmd = "poetry self remove poethepoet"},
    { cmd = "poetry self add \"${POE_ROOT}[poetry_plugin]\""}
  ]
  ignore_fail = true

  [tool.poe.tasks.poe]
  help   = "Execute poe from this repo (useful for testing)"
  script = "poethepoet:main"


[tool.rstcheck]
ignore_messages = [
  "Unknown directive type \"autoclass\"",
  "Hyperlink target \"shell-completion\" is not referenced.",
  "Hyperlink target \"envfile-option\" is not referenced.",
  "Hyperlink target \"ref-env-vars\" is not referenced.",
  "Hyperlink target \"sequence-composition\" is not referenced.",
  "Hyperlink target \"graph-composition\" is not referenced.",
  " No directive entry for \"autoclass\" in module \"docutils.parsers.rst.languages.en\""
]
ignore_directives = [
  "include"
]

[tool.coverage.report]
omit = ["**/site-packages/**", "poethepoet/completion/*", "poethepoet/plugin.py"]

[tool.pytest.ini_options]
markers = [
  "slow: marks tests as slow (deselect with '-m \"not slow\"')"
]

[tool.isort]
profile = "black"

[build-system]
requires      = ["poetry-core"]
build-backend = "poetry.core.masonry.api"