pyproject.toml

# SPDX-License-Identifier: GPL-2.0-only
#
# Project: Ecli
# File: pyproject.toml
# Website: https://www.ecli.io
# Repository: https://github.com/SSobol77/ecli
# PyPI: https://pypi.org/project/ecli-editor/0.0.1/
#
# Copyright (c) 2026 Siergej Sobolewski
#
# Licensed under the GNU General Public License version 2 only.
# See the LICENSE file in the project root for full license text.

[build-system]
requires = ["hatchling>=1.27"]
build-backend = "hatchling.build"

[project]
name = "ecli-editor"
version = "0.2.4"
description = "ECLI — terminal-first engineering operations workbench"
readme = "README.md"
requires-python = ">=3.11"
license = "GPL-2.0-only"
license-files = ["LICENSE*"]
authors = [{ name = "Siergej Sobolewski", email = "s.sobolewski@hotmail.com" }]
keywords = [
    "editor",
    "terminal",
    "tui",
    "curses",
    "text-editor",
    "developer-tools",
    "devops",
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Environment :: Console :: Curses",
    "Intended Audience :: Developers",
    "Operating System :: POSIX :: Linux",
    "Operating System :: POSIX :: BSD :: FreeBSD",
    "Operating System :: MacOS",
    "Operating System :: Microsoft :: Windows",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: Implementation :: CPython",
    "Topic :: Text Editors",
    "Typing :: Typed",
]
dependencies = [
    "Pygments>=2.19.1",
    "pyperclip>=1.9.0",
    "wcwidth>=0.2.13",
    "chardet>=5.2.0",
    "PyYAML>=6.0.2",
    "attrs>=24.0.0",
    "typing_extensions>=4.12.2",
    "packaging>=24.1",
    "aiohttp>=3.9.0",
    "pygls>=1.3.1",
    "lsprotocol>=2023.0.1",
    "libcst>=1.5.0",
    "cattrs>=23.2.0",
    "python-dotenv>=1.0.1",
    "toml>=0.10.2",
    "tato>=0.2.3",
    "windows-curses>=2.4.0; sys_platform == 'win32'",
    "python-textmate>=0.2.0",
]

[project.optional-dependencies]
dev = [
    "pyinstaller>=6.16.0",
    "ruff>=0.4.10",
    "mypy>=1.10.0",
    "mypy-extensions>=1.0.0",
    "types-PyYAML>=6.0.12.20240516",
    "types-pyperclip>=1.9.0.20220518",
    "pytest>=8.4.1",
    "pytest-asyncio>=0.23.8",
    "pytest-aiohttp>=1.0.5",
    "pytest-mock>=3.14.0",
    "pytest-cov>=6.0.0",
    "coverage>=7.4.0",
    "build>=1.2",
    "twine>=6.2.0",
    "cyclonedx-bom>=4.0",
]
release = [
    "build>=1.2",
    "twine>=6.2.0",
    "cyclonedx-bom>=4.0",
]

[project.scripts]
ecli = "ecli.__main__:main"
ecli-install-desktop-entry = "ecli.utils.desktop_entry:main"

[project.urls]
Homepage = "https://ecli.io"
Documentation = "https://ecli.io/docs"
Repository = "https://github.com/SSobol77/ecli"
Issues = "https://github.com/SSobol77/ecli/issues"
Changelog = "https://github.com/SSobol77/ecli/blob/main/CHANGELOG.md"

[tool.hatch.build.targets.wheel]
packages = ["src/ecli"]

[tool.hatch.build.targets.wheel.force-include]
"src/ecli/assets/ecli.png" = "ecli/assets/ecli.png"

[tool.hatch.build.targets.sdist]
include = [
    "/src",
    "/src/ecli/assets/ecli.png",
    "/tests",
    "/README.md",
    "/LICENSE",
    "/CHANGELOG.md",
    "/pyproject.toml",
    "/main.py",
]

[tool.pytest.ini_options]
minversion = "8.0"
addopts = "-ra --tb=short --strict-markers --strict-config"
testpaths = ["tests"]
python_files = "test_*.py"
asyncio_mode = "auto"
markers = [
    "asyncio: marks async tests (auto-applied via asyncio_mode)",
    "integration: integration tests requiring external resources",
    "slow: tests that take >1 second",
]

[tool.mypy]
files = ["src/ecli", "tests"]
# Imported, read-only VS Code / TextMate extension assets (issue #98) are not
# ECLI Python sources and must not be type-checked. The negative lookahead keeps
# the ECLI-owned deterministic adapter package
# src/ecli/extensions/ecli_integration/ (issue #100) type-checked, while still
# excluding every imported upstream extension folder beside it.
# See docs/architecture/extensions-layer.md.
exclude = ['^src/ecli/extensions/(?!ecli_integration/)']
mypy_path = "src"
python_version = "3.11"
ignore_missing_imports = true
show_error_codes = true
strict = true
warn_unused_ignores = true
warn_return_any = true
warn_unreachable = true
no_implicit_optional = true

[tool.ruff]
line-length = 88
target-version = "py311"
extend-exclude = [
    "__pycache__",
    "*.pyc",
    ".git",
    "build",
    "dist",
    # Imported, read-only VS Code / TextMate extension assets (issue #98). This
    # upstream tree must remain unchanged and contains foreign-language code and
    # intentionally-malformed test fixtures; ECLI's own linters/formatters must
    # not scan it. See docs/architecture/extensions-layer.md.
    "src/ecli/extensions",
    "src/ecli/core/Ecli.py",
    "src/ecli/core/History.py",
    "src/ecli/integrations/AI.py",
    "src/ecli/integrations/GitBridge.py",
    "src/ecli/integrations/LinterBridge.py",
    "src/ecli/integrations/__init__.py",
    "src/ecli/ui/DrawScreen.py",
    "src/ecli/ui/KeyBinder.py",
    "src/ecli/ui/PanelManager.py",
    "src/ecli/ui/TerminalAppMode.py",
    "src/ecli/ui/__init__.py",
    "src/ecli/ui/panels.py",
    "src/ecli/utils/__init__.py",
    "src/ecli/utils/logging_config.py",
    "src/ecli/utils/utils.py",
]

[tool.ruff.lint]
select = ["E", "F", "W", "C90", "I", "UP", "B", "N", "Q", "PL", "RET", "D"]
ignore = [
    "N999",
    "E501",
    "D203",
    "D213",
    "D401",
    "D205",
    "D400",
    "D415",
    "PLR2004",
    "UP045",
    "D412",
    "UP035",
]

[tool.ruff.lint.per-file-ignores]
"tests/**/*.py" = ["D100", "D101", "D102", "D103", "D104", "F401", "E402", "PLC0415"]
"src/ecli/__init__.py" = ["F401"]
"src/ecli/__main__.py" = ["C901", "D100", "D212", "I001"]
# Packaging/build orchestration scripts are procedural by design: many small
# self-evident helpers and multi-step build flows with several guard returns
# (mirroring the legacy shell). Exempt them from docstring-per-helper and the
# complexity family, consistent with the __main__.py entrypoint exception. The
# canonical module docstrings document each script's full contract.
"scripts/*.py" = ["D103", "C901", "PLR0911", "PLR0912", "PLR0913", "PLR0915"]

[tool.ruff.lint.pydocstyle]
convention = "google"

[tool.ruff.lint.isort]
combine-as-imports = true
lines-after-imports = 2
extra-standard-library = ["typing_extensions", "tomllib"]

[tool.ruff.lint.flake8-quotes]
docstring-quotes = "double"
inline-quotes = "double"

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "lf"