MAINT,DOC: pip and network connectivity defaults

README.rst

@@ -30,4 +30,4 @@ By using the following markdown::
 License: `BSD three-clause license
 <http://opensource.org/licenses/BSD-3-Clause>`__.
 
-Authors: Michael Droettboom, Pauli Virtanen
+Authors: Michael Droettboom, Pauli Virtanen, asv Developers

asv/environment.py

@@ -15,6 +15,8 @@
 import importlib
 from pathlib import Path
 
+import tomli
+
 from .console import log
 from . import util, build_cache
 
@@ -537,11 +539,15 @@ def __init__(self, conf, python, requirements, tagged_env_vars):
  # XXX: What if pypy installed asv tries to benchmark a cpython
  # python?
  self._base_requirements["pip+pympler"] = ""
- if (Path.cwd() / "poetry.lock").exists():
- self._base_requirements["poetry-core"] = ""
 
- if (Path.cwd() / "pdm.lock").exists():
- self._base_requirements["pdm"] = ""
+ pyproject_path = Path.cwd() / "pyproject.toml"
+ if pyproject_path.exists():
+ self._base_requirements["build"] = ""
+ with open(pyproject_path, "rb") as pyproject_file:
+ pyproject_data = tomli.load(pyproject_file)
+ requires = pyproject_data.get("build-system", {}).get("requires", [])
+ for requirement in requires:
+ self._base_requirements[f"pip+{requirement}"] = ""
 
  # Update the _base_requirements if needed
  for key in list(self._requirements.keys()):
@@ -920,15 +926,13 @@ def has_file(file_name):
  if cmd is None:
  if has_file('pyproject.toml'):
  cmd = [
- ("PIP_NO_BUILD_ISOLATION=false "
- "python -mpip wheel --no-deps --no-index "
- "-w {build_cache_dir} {build_dir}")
+ "python -m build",
+ "python -mpip wheel -w {build_cache_dir} {build_dir}"
  ]
  else:
  cmd = [
  "python setup.py build",
- ("PIP_NO_BUILD_ISOLATION=false "
- "python -mpip wheel --no-deps --no-index -w {build_cache_dir} {build_dir}")
+ "python -mpip wheel -w {build_cache_dir} {build_dir}"
  ]
 
  if cmd:

asv/template/asv.conf.json

@@ -24,12 +24,12 @@
  // "build_command": [
  // "python -m pip install build",
  // "python -m build",
- // "PIP_NO_BUILD_ISOLATION=false python -mpip wheel --no-deps --no-index -w {build_cache_dir} {build_dir}"
+ // "python -mpip wheel -w {build_cache_dir} {build_dir}"
  // ],
  // To build the package using setuptools and a setup.py file, uncomment the following lines
  // "build_command": [
  // "python setup.py build",
- // "PIP_NO_BUILD_ISOLATION=false python -mpip wheel --no-deps --no-index -w {build_cache_dir} {build_dir}"
+ // "python -mpip wheel -w {build_cache_dir} {build_dir}"
  // ],
 
  // Customizable commands for installing and uninstalling the project.

changelog.d/1377.feat.rst

@@ -0,0 +1,3 @@
+``asv`` will now correctly prepare all the build backend dependencies into
+``base_requirements`` and the default ``build_command`` has been modified to
+allow fetching from PyPI.

docs/source/asv.conf.json.rst

@@ -7,6 +7,19 @@ The ``asv.conf.json`` file contains information about a particular
 benchmarking project. The following describes each of the keys in
 this file and their expected values.
 
+.. note::
+
+ The GitHub repository at `asv_samples
+ <https://github.com/HaoZeke/asv_samples>`_ serves as a comprehensive
+ showcase for integrating Air Speed Velocity (ASV) with a wide array of
+ Python project configurations. This includes various build systems and
+ advanced benchmarking features like custom parameterizations and ASV
+ plugins, aiming to benchmark Python code performance across diverse setups.
+
+ The repository is structured with dedicated branches for each build system
+ and feature demonstration, providing insights into the impacts of different
+ build systems and ASV's extensible features on performance metrics.
+
 .. only:: not man
 
  .. contents::
@@ -71,6 +84,17 @@ The defaults are::
  ["python setup.py build",
  "PIP_NO_BUILD_ISOLATION=false python -mpip wheel --no-deps --no-index -w {build_cache_dir} {build_dir}"],
 
+.. note::
+
+ .. versionchanged:: 0.6.2
+
+ The default build command now assume network connectivity is not
+ prohibited. The ``build_command`` is now::
+
+ "build_command":
+ ["python setup.py build",
+ "python -mpip wheel -w {build_cache_dir} {build_dir}"],
+
 The install commands should install the project in the active Python
 environment (virtualenv/conda), so that it can be used by the
 benchmark code.
@@ -84,8 +108,6 @@ environment.
 
  If a build command is not specified in the ``asv.conf.json``, the default
  assumes the build system requirements are defined in a ``setup.py`` file.
- However, the ``asv.conf.json`` template also includes as a comment the
- commands to build the project using a ``pyproject.toml`` file.
  ``pyproject.toml`` is the preferred file format to define the build system
  requirements of Python projects (`PEP518
  <https://peps.python.org/pep-0518/>`_), and this approach will be the

docs/source/benchmarks.rst

@@ -27,10 +27,11 @@ The following benchmark types are recognized:
 
 .. note::
 
- .. versionadded:: 0.6.0
+ .. versionadded:: 0.6.2
 
- Users may define their own benchmark types, see ``asv_runner`` for
- examples.
+ External benchmarks may be defined through ``asv_runner`` and a list of
+ benchmark plugins (like ``asv_bench_memray``) may be found here, with
+ samples at `asv_samples <https://github.com/HaoZeke/asv_samples>`_.
 
 Benchmark attributes
 --------------------

pyproject.toml

@@ -27,10 +27,11 @@ dynamic = [
  "version",
 ]
 dependencies = [
- "asv-runner>=v0.1.0",
+ "asv-runner>=v0.2.1",
  "json5",
  "tabulate",
  "virtualenv",
+ "tomli",
  "colorama; platform_system == 'Windows'",
  "pyyaml; platform_python_implementation != \"PyPy\"",
  "pympler; platform_python_implementation != \"PyPy\"",
@@ -75,6 +76,9 @@ virtualenv = [
 hg = [
  "python-hglib",
 ]
+plugs = [
+ "asv-bench-memray",
+]
 [build-system]
 requires = [
  "wheel",