Split installation of tests into separate wheel file (#843)

Author: mauvilsa

.bumpversion.cfg

@@ -9,3 +9,5 @@ serialize =
 	{major}.{minor}.{patch}
 
 [bumpversion:file:jsonargparse/__init__.py]
+
+[bumpversion:file:jsonargparse_tests/__init__.py]

.github/workflows/tests.yaml

@@ -138,6 +138,9 @@ jobs:
         run: |
           pip install -U build
           python -m build
+          cd jsonargparse_tests
+          python -m build --wheel
+          mv dist/*.whl ../dist/
       - uses: actions/upload-artifact@v4
         with:
           name: package
@@ -159,13 +162,13 @@ jobs:
       - name: Test without optional dependencies and without pyyaml
         run: |
           cd dist
-          pip install $(ls *.whl)[test-no-urls]
+          pip install $(ls jsonargparse-*.whl)[test-no-urls] $(ls jsonargparse_tests-*.whl)
           pip uninstall -y pyyaml
           python -m jsonargparse_tests
       - name: Test with all optional dependencies
         run: |
           cd dist
-          pip install $(ls *.whl)[test,all]
+          pip install $(ls jsonargparse-*.whl)[test,all]
           python -m jsonargparse_tests
 
   doctest:

.pre-commit-config.yaml

@@ -73,6 +73,9 @@ repos:
       else
         python3 -m build --wheel;
         twine check dist/*.whl;
+        cd jsonargparse_tests;
+        python3 -m build --wheel;
+        twine check dist/*.whl;
       fi'
     language: system
     pass_filenames: false

CHANGELOG.rst

@@ -12,6 +12,16 @@ The semantic versioning only considers the public API as described in
 paths are considered internals and can change in minor and patch releases.
 
 
+v4.47.0 (unreleased)
+--------------------
+
+Changed
+^^^^^^^
+- Tests are no longer installed by default, there is a separate
+  ``jsonargparse_tests`` wheel file for that  (`#843
+  <https://github.com/omni-us/jsonargparse/pull/843>`__).
+
+
 v4.46.0 (2026-02-02)
 --------------------
 

CONTRIBUTING.rst

@@ -109,9 +109,19 @@ runs some additional tests.
     tox                                      # Run tests using tox on available python versions
     pytest                                   # Run tests using pytest on the python of the environment
     pytest --cov                             # Run tests and generate coverage report
-    python -m jsonargparse_tests             # Run tests on installed package (requires pytest and pytest-subtests)
     pre-commit run -a --hook-stage pre-push  # Run pre-push git hooks (tests, doctests, mypy, coverage)
 
+Tests can be run in any environment without the source code. Before v4.47.0, the
+tests were included in the main package. Since v4.47.0, they are provided in a
+separate package. Prefer installing the tests package with the same version as
+the main package. For example, for v4.47.0 run:
+
+.. code-block:: bash
+
+    pip install jsonargparse_tests==4.47.0
+    python -m jsonargparse_tests
+
+
 Coverage
 --------
 

jsonargparse_tests/LICENSE.rst

@@ -0,0 +1 @@
+../LICENSE.rst

jsonargparse_tests/__init__.py

@@ -9,3 +9,5 @@
     if "omegaconf" in loaders:
         loaders["yaml"] = loaders["omegaconf"]
         warnings.warn("Running all tests with omegaconf as the yaml loader.")
+
+__version__ = "4.46.0"

jsonargparse_tests/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+
+[project]
+name = "jsonargparse-tests"
+dynamic = ["version"]
+description = "Tests for jsonargparse package."
+authors = [
+    {name = "Mauricio Villegas", email = "mauricio@omnius.com"},
+]
+license = "MIT"
+license-files = ["LICENSE.rst"]
+
+dependencies = [
+    "jsonargparse[test-no-urls]",
+]
+
+[project.urls]
+GitHub = "https://github.com/omni-us/jsonargparse"
+
+
+[tool.setuptools]
+packages = ["jsonargparse_tests"]
+
+[tool.setuptools.package-dir]
+"jsonargparse_tests" = "."
+
+[tool.setuptools.dynamic]
+version = {attr = "jsonargparse_tests.__version__"}

pyproject.toml

@@ -139,7 +139,7 @@ Codecov = "https://codecov.io/gh/omni-us/jsonargparse"
 
 [tool.setuptools]
 platforms = ["Any"]
-packages = ["jsonargparse", "jsonargparse_tests"]
+packages = ["jsonargparse"]
 
 [tool.setuptools.dynamic]
 version = {attr = "jsonargparse.__version__"}
@@ -211,6 +211,7 @@ setenv =
 
 [testenv:pydantic-v1]
 extras = coverage
+deps = ./jsonargparse_tests
 commands =
     # Test with pydantic<2
     python -c "\
@@ -242,6 +243,7 @@ commands =
 
 [testenv:without-future-annotations]
 extras = test,coverage,all
+deps = ./jsonargparse_tests
 allowlist_externals = sh
 commands =
     sh -c "\