env: refactor IsolatedEnv

.github/workflows/check.yml

@@ -29,5 +29,5 @@ jobs:
       - name: Setup run environment
         run: tox -vv --notest -e docs
 
-      - name: Run check for type
+      - name: Run check for docs
         run: tox -e docs --skip-pkg-install

.readthedocs.yml

@@ -1,7 +1,11 @@
 version: 2
 
+build:
+  os: ubuntu-20.04
+  tools:
+    python: '3.10'
+
 python:
-  version: 3.8
   install:
     - method: pip
       path: .

CHANGELOG.rst

@@ -12,6 +12,19 @@ Unreleased
 - Add schema validation for ``build-system`` table to check conformity
   with PEP 517 and PEP 518 (`PR #365`_, Fixes `#364`_)
 
+Breaking changes
+----------------
+
+- The isolated environment interface was redesigned (`PR #361`_)
+
+  - ``IsolatedEnvBuilder`` removed and its functionality taken over by
+    ``DefaultIsolatedEnv.with_temp_dir``
+  - ``ProjectBuiler.from_isolated_env`` added to initialise a builder from
+    an isolated environment
+  - ``RunnerType`` callback signature changed to allow modifying the
+    ``os.environ`` wholesale
+
+.. _PR #361: https://github.com/pypa/build/pull/361
 .. _PR #365: https://github.com/pypa/build/pull/365
 .. _PR #392: https://github.com/pypa/build/pull/392
 .. _#364: https://github.com/pypa/build/issues/364

docs/api.rst

@@ -1,15 +1,14 @@
 API Documentation
 =================
 
-This project exposes 2 modules:
-
 ``build`` module
 ----------------
 
 .. automodule:: build
    :members:
    :undoc-members:
    :show-inheritance:
+   :special-members: __call__
 
 ``build.env`` module
 --------------------

docs/conf.py

@@ -65,3 +65,5 @@
 # html_static_path = ['_static']
 
 autoclass_content = 'both'
+autodoc_member_order = 'bysource'
+autodoc_preserve_defaults = True

pyproject.toml

@@ -12,6 +12,8 @@ source = [
 exclude_lines = [
   '\#\s*pragma: no cover',
   '^\s*raise NotImplementedError\b',
+  "if TYPE_CHECKING:",
+  "@overload",
 ]
 
 [tool.coverage.paths]

setup.cfg

@@ -64,7 +64,7 @@ test =
 typing =
     importlib-metadata>=4.6.4
     mypy==0.910
-    typing-extensions>=3.7.4.3
+    typing-extensions>=3.8;python_version < "3.8"
 virtualenv =
     virtualenv>=20.0.35