Support conanfile-path for recipe in a subdirectory (#26)

* can configure conanfile-path

* wip

* wip

* wip

* Empty commit

Made-with: Cursor

* wip

* wip

* wip

* wip

* wip

Author: czoido

.github/workflows/ci.yml

@@ -7,6 +7,10 @@ on:
     branches: [main]
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   test:
     strategy:

README.md

@@ -72,14 +72,16 @@ Pass configuration options via `--config-settings`:
 | `build-profile` | Conan profile for build context | `default` |
 | `build-dir` | Persistent build directory | temp dir |
 
-### Conan home and profile
+Configure in `pyproject.toml` under `[tool.conan-py-build]`:
 
-The backend **always uses Conan’s default home** (e.g. `~/.conan2`), or the one set via 
-`CONAN_HOME` or the `.conanrc` file.
-
-By default the backend uses Conan's **default** profile. To use an autodetected
-profile, set
-**`CONAN_PY_BUILD_PROFILE_AUTODETECT=1`** (or `true` / `yes`).
+| Option | Description | Default |
+|--------|-------------|---------|
+| `version-file` | Path to a Python file from which to read `__version__` when `[project].version` is dynamic | (none) |
+| `conanfile-path` | Path to the Conan recipe (directory containing `conanfile.py` or path to the file), relative to project root | `"."` (project root) |
+| `wheel.packages` | List of paths (relative to project root) of Python packages to include in the wheel; each must be a directory with `__init__.py` | `["src/<normalized_project_name>"]` |
+| `sdist.include` | List of paths or patterns to add to the sdist | `[]` |
+| `sdist.exclude` | List of paths or patterns to exclude from the sdist | `[]` |
+| `extra-profile` | Path (relative to project root) to a Conan profile file | (none) |
 
 ### Dynamic version
 
@@ -105,6 +107,15 @@ If `wheel.packages` is not set, the backend includes a single package at
 `src/<normalized_project_name>` (e.g. `src/mypackage` for a project named
 `mypackage`).
 
+**Conan recipe path.** If your recipe lives outside the project root (e.g.
+`subfolder/conanfile.py`), set `conanfile-path` so the backend runs
+`conan source`, `conan build` and `conan export-pkg` on that path:
+
+```toml
+[tool.conan-py-build]
+conanfile-path = "subfolder"
+```
+
 ```toml
 [tool.conan-py-build.wheel]
 packages = ["src/mypackage", "src/other_package"]
@@ -162,6 +173,15 @@ Keys: `extra-profile`, `extra-profile-host`, `extra-profile-build`,
 extra-profile = "cpp17.profile"
 ```
 
+### Conan home and default profile
+
+The backend **always uses Conan’s default home** (e.g. `~/.conan2`), or the one set via 
+`CONAN_HOME` or the `.conanrc` file.
+
+By default the backend uses Conan's **default** profile. To use an autodetected
+profile, set
+**`CONAN_PY_BUILD_PROFILE_AUTODETECT=1`** (or `true` / `yes`).
+
 ## Examples
 
 See the [examples/](examples/) directory for complete working examples:

examples/basic/README.md

@@ -3,6 +3,8 @@
 This example demonstrates a Python package with C++ code that uses the `fmt`
 library (managed by Conan) for formatted output with colors.
 
+It also shows **`conanfile-path`** (recipe in `conan/` subdirectory).
+
 ## Build and Install
 
 ```bash

examples/basic/conanfile.py examples/basic/conan/conanfile.pyexamples/basic/conanfile.py renamed to examples/basic/conan/conanfile.py

@@ -9,7 +9,8 @@ class MyadderConan(ConanFile):
     generators = "CMakeToolchain", "CMakeDeps"
 
     def layout(self):
-        cmake_layout(self)
+        # Recipe in conan/, sources at project root (see pyproject conanfile-path)
+        cmake_layout(self, src_folder="..")
 
     def requirements(self):
         self.requires("fmt/12.1.0")

examples/basic/pyproject.toml

@@ -7,3 +7,6 @@ name = "myadder"
 version = "0.1.0"
 description = "A simple Python package with C++ code that adds two numbers"
 requires-python = ">=3.8"
+
+[tool.conan-py-build]
+conanfile-path = "conan"

src/conan_py_build/build.py

@@ -111,6 +111,13 @@ def _get_sdist_config(project_dir: Path) -> dict:
     }
 
 
+def _resolve_conanfile_path(conanfile_path: str, source_dir: Path) -> Path:
+    # Using py=True will raise an exception if the path is not a .py file.
+    conan_api = ConanAPI()
+    full_path = conan_api.local.get_conanfile_path(conanfile_path, source_dir, py=True)
+    return Path(full_path)
+
+
 def _get_version_from_config(source_dir: Path) -> Optional[str]:
     """Read version from [tool.conan-py-build] version-file if set. Reads pyproject from source_dir."""
     tool = _get_tool_config(source_dir)
@@ -411,11 +418,10 @@ def _do_build_wheel(
         arg = key[len("extra-"):].replace("-", ":", 1)  # profile-host -> profile:host
         profile_args.extend([f"--{arg}", str(p)])
 
+    conanfile_path = tool.get("conanfile-path") or "."
+    resolved_conanfile = str(_resolve_conanfile_path(conanfile_path, source_dir))
 
-    source_cmd = [
-        "source",
-        "."
-    ]
+    source_cmd = ["source", resolved_conanfile]
     print("Running conan source...", flush=True)
     try:
         conan_api.command.run(source_cmd)
@@ -424,7 +430,7 @@ def _do_build_wheel(
 
     build_cmd = [
         "build",
-        ".",
+        resolved_conanfile,
         "-of",
         str(staging_dir),
         "-c",
@@ -451,7 +457,7 @@ def _do_build_wheel(
 
     export_pkg_cmd = [
         "export-pkg",
-        str(source_dir),
+        resolved_conanfile,
         "-of",
         str(staging_dir),
         "-tf",
@@ -527,14 +533,19 @@ def build_sdist(sdist_directory: str, config_settings: Optional[dict] = None) ->
     default_include = [
         "pyproject.toml",
         "CMakeLists.txt",
-        "conanfile.py",
         "cmake",
         "src",
         "include",
         "README.md",
         "README.rst",
         "LICENSE",
     ]
+
+    tool = _get_tool_config(source_dir)
+    conanfile_path = tool.get("conanfile-path") or "."
+    resolved_conanfile = _resolve_conanfile_path(conanfile_path, source_dir)
+    default_include.append(resolved_conanfile.relative_to(source_dir).as_posix())
+
     default_exclude = [
         "__pycache__",
         "*.pyc",

tests/test_unit.py

@@ -3,11 +3,14 @@
 
 import pytest
 
+from conan.errors import ConanException
+
 from conan_py_build.build import (
     _parse_config,
     _read_version_from_file,
     _resolve_version,
     _get_sdist_config,
+    _resolve_conanfile_path,
     _get_wheel_tags,
     _check_wheel_package_path,
     _get_wheel_packages,
@@ -124,6 +127,23 @@ def test_get_sdist_config_tool_include_exclude(tmp_path):
     assert _get_sdist_config(tmp_path) == {"include": ["docs"], "exclude": ["README.md"]}
 
 
+def test_resolve_conanfile_path(tmp_path):
+    """Resolved path is the conanfile.py (py=True: only .py allowed)."""
+    (tmp_path / "conanfile.py").write_text("")
+    assert _resolve_conanfile_path(".", tmp_path) == tmp_path / "conanfile.py"
+
+    (tmp_path / "conan").mkdir()
+    (tmp_path / "conan" / "conanfile.py").write_text("")
+    assert _resolve_conanfile_path("conan", tmp_path) == tmp_path / "conan" / "conanfile.py"
+
+
+def test_resolve_conanfile_path_rejects_txt(tmp_path):
+    """Raises when only conanfile.txt exists (py=True allows only .py)."""
+    (tmp_path / "conanfile.txt").write_text("")
+    with pytest.raises(ConanException, match="Conanfile not found"):
+        _resolve_conanfile_path(".", tmp_path)
+
+
 def test_get_wheel_tags_from_env(monkeypatch):
     monkeypatch.setenv("WHEEL_ARCH", "manylinux_2_28_x86_64")
     monkeypatch.setenv("WHEEL_PYVER", "cp312")