468ceafca5
This implements PEP 621, obviating the need for `setup.py`, `setup.cfg`,
and `MANIFEST.in`. The build backend Hatchling (of which I am a
maintainer in the PyPA) is now used as that is the default in the
official Python packaging tutorial. Hatchling is available on all the
major distribution channels such as Debian, Fedora, and many more.
## Python support
The earliest supported Python 3 version of Hatchling is 3.7, therefore
I've also set that as the minimum here. Python 3.6 is EOL and other
build backends like flit-core and setuptools also dropped support.
Python 3.6 accounted for 3-4% of downloads in the last month.
## Plugins
Configuration is now completely static with the help of 3 plugins:
### Readme
hynek's hatch-fancy-pypi-readme allows for the dynamic construction of
the readme which was previously coded up in `setup.py`. Now it's simply:
```toml
[tool.hatch.metadata.hooks.fancy-pypi-readme]
content-type = "text/markdown"
fragments = [
{ path = "README.md" },
{ path = "CHANGES.md" },
]
```
### Versioning
hatch-vcs is currently just a wrapper around setuptools-scm (which
despite the legacy naming is actually now decoupled from setuptools):
```toml
[tool.hatch.version]
source = "vcs"
[tool.hatch.build.hooks.vcs]
version-file = "src/_black_version.py"
template = '''
version = "{version}"
'''
```
### mypyc
hatch-mypyc offers many benefits over the existing approach:
- No need to manually select files for inclusion
- Avoids the need for the current CI workaround for https://github.com/mypyc/mypyc/issues/946
- Intermediate artifacts (like `build/`) from setuptools and mypyc
itself no longer clutter the project directory
- Runtime dependencies required at build time no longer need to be
manually redeclared as this is a built-in option of Hatchling
Co-authored-by: Richard Si <63936253+ichard26@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
101 lines
2.9 KiB
INI
101 lines
2.9 KiB
INI
[tox]
|
|
isolated_build = true
|
|
envlist = {,ci-}py{37,38,39,310,311,py3},fuzz,run_self
|
|
|
|
[testenv]
|
|
setenv = PYTHONPATH = {toxinidir}/src
|
|
skip_install = True
|
|
# We use `recreate=True` because otherwise, on the second run of `tox -e py`,
|
|
# the `no_jupyter` tests would run with the jupyter extra dependencies installed.
|
|
# See https://github.com/psf/black/issues/2367.
|
|
recreate = True
|
|
deps =
|
|
-r{toxinidir}/test_requirements.txt
|
|
; parallelization is disabled on CI because pytest-dev/pytest-xdist#620 occurs too frequently
|
|
; local runs can stay parallelized since they aren't rolling the dice so many times as like on CI
|
|
commands =
|
|
pip install -e .[d]
|
|
coverage erase
|
|
pytest tests --run-optional no_jupyter \
|
|
!ci: --numprocesses auto \
|
|
--cov {posargs}
|
|
pip install -e .[jupyter]
|
|
pytest tests --run-optional jupyter \
|
|
-m jupyter \
|
|
!ci: --numprocesses auto \
|
|
--cov --cov-append {posargs}
|
|
coverage report
|
|
|
|
[testenv:{,ci-}pypy3]
|
|
setenv = PYTHONPATH = {toxinidir}/src
|
|
skip_install = True
|
|
recreate = True
|
|
deps =
|
|
-r{toxinidir}/test_requirements.txt
|
|
; a separate worker is required in ci due to https://foss.heptapod.net/pypy/pypy/-/issues/3317
|
|
; this seems to cause tox to wait forever
|
|
; remove this when pypy releases the bugfix
|
|
commands =
|
|
pip install -e .[d]
|
|
coverage erase
|
|
pytest tests \
|
|
--run-optional no_jupyter \
|
|
!ci: --numprocesses auto \
|
|
ci: --numprocesses 1 \
|
|
--cov {posargs}
|
|
pip install -e .[jupyter]
|
|
pytest tests --run-optional jupyter \
|
|
-m jupyter \
|
|
!ci: --numprocesses auto \
|
|
ci: --numprocesses 1 \
|
|
--cov --cov-append {posargs}
|
|
coverage report
|
|
|
|
[testenv:{,ci-}311]
|
|
setenv =
|
|
PYTHONPATH = {toxinidir}/src
|
|
AIOHTTP_NO_EXTENSIONS = 1
|
|
skip_install = True
|
|
recreate = True
|
|
deps =
|
|
; We currently need > aiohttp 3.8.1 that is on PyPI for 3.11
|
|
git+https://github.com/aio-libs/aiohttp
|
|
-r{toxinidir}/test_requirements.txt
|
|
; a separate worker is required in ci due to https://foss.heptapod.net/pypy/pypy/-/issues/3317
|
|
; this seems to cause tox to wait forever
|
|
; remove this when pypy releases the bugfix
|
|
commands =
|
|
pip install -e .[d]
|
|
coverage erase
|
|
pytest tests \
|
|
--run-optional no_jupyter \
|
|
!ci: --numprocesses auto \
|
|
ci: --numprocesses 1 \
|
|
--cov {posargs}
|
|
pip install -e .[jupyter]
|
|
pytest tests --run-optional jupyter \
|
|
-m jupyter \
|
|
!ci: --numprocesses auto \
|
|
ci: --numprocesses 1 \
|
|
--cov --cov-append {posargs}
|
|
coverage report
|
|
|
|
[testenv:fuzz]
|
|
skip_install = True
|
|
deps =
|
|
-r{toxinidir}/test_requirements.txt
|
|
hypothesmith
|
|
lark-parser
|
|
commands =
|
|
pip install -e .[d]
|
|
coverage erase
|
|
coverage run {toxinidir}/scripts/fuzz.py
|
|
coverage report
|
|
|
|
[testenv:run_self]
|
|
setenv = PYTHONPATH = {toxinidir}/src
|
|
skip_install = True
|
|
commands =
|
|
pip install -e .[d]
|
|
black --check {toxinidir}/src {toxinidir}/tests
|