Deployed 462e34d with MkDocs version: 1.6.1

__pycache__/hooks.cpython-312.pyc

@@ -418,6 +418,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#extra-conan-arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Extra Conan arguments
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -622,6 +633,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#extra-conan-arguments" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Extra Conan arguments
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -744,6 +766,12 @@ <h2 id="pyprojecttoml"><code>pyproject.toml</code></h2>
 <td>(none)</td>
 </tr>
 <tr>
+<td><code>extra-arguments</code></td>
+<td><code>[tool.conan-py-build]</code></td>
+<td>Extra Conan CLI flags appended to <code>conan build</code> and <code>conan export-pkg</code></td>
+<td><code>[]</code></td>
+</tr>
+<tr>
 <td><code>version.file</code></td>
 <td><code>[tool.conan-py-build.version]</code></td>
 <td>Python file with <code>__version__</code></td>
@@ -772,6 +800,9 @@ <h2 id="pyprojecttoml"><code>pyproject.toml</code></h2>
 <p>Variants for extra profiles: <code>extra-profile-host</code>,
 <code>extra-profile-build</code>, <code>extra-profile-all</code>.
 Paths relative to project root.</p>
+<p>For one-off Conan overrides without shipping a separate
+profile file, use <code>extra-arguments</code> (see <em>Extra Conan
+arguments</em> below).</p>
 <p>Default <code>packages</code> is <code>src/&lt;normalized_project_name&gt;</code>
 (hyphens → underscores).</p>
 <h2 id="dynamic-version">Dynamic version</h2>
@@ -863,6 +894,35 @@ <h2 id="conan-home">Conan home</h2>
 or <code>CONAN_HOME</code> / <code>.conanrc</code>). Set
 <code>CONAN_PY_BUILD_PROFILE_AUTODETECT=1</code> to autodetect
 the profile instead of requiring <code>default</code>.</p>
+<h2 id="extra-conan-arguments">Extra Conan arguments</h2>
+<p>CLI flags appended to <code>conan build</code> and
+<code>conan export-pkg</code>. Symmetric with <code>extra-profile</code>,
+with higher precedence — CLI flags win against any
+profile entry.</p>
+<p>Bump <code>compiler.cppstd</code> to match a transitive dep
+(e.g. <code>gdal/3.12.1</code> requires C++17, MSVC defaults
+to 14):</p>
+<div class="highlight"><pre><span></span><code><span class="k">[tool.conan-py-build]</span>
+<span class="n">extra-arguments</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="s2">&quot;-s=compiler.cppstd=17&quot;</span><span class="p">]</span>
+</code></pre></div>
+<p>Disable an optional dep feature and pin parallelism:</p>
+<div class="highlight"><pre><span></span><code><span class="k">[tool.conan-py-build]</span>
+<span class="n">extra-arguments</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span>
+<span class="w">    </span><span class="s2">&quot;-o=gdal/*:with_arrow=False&quot;</span><span class="p">,</span>
+<span class="w">    </span><span class="s2">&quot;-c=tools.build:jobs=4&quot;</span><span class="p">,</span>
+<span class="p">]</span>
+</code></pre></div>
+<p>For values with embedded double quotes (dict / list
+<code>[conf]</code> literals), use TOML literal strings (<code>'...'</code>):</p>
+<div class="highlight"><pre><span></span><code><span class="n">extra-arguments</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span>
+<span class="w">    </span><span class="s1">&#39;-c=tools.build:cflags+=[&quot;-O2&quot;, &quot;-fPIC&quot;]&#39;</span><span class="p">,</span>
+<span class="w">    </span><span class="s1">&#39;-c=tools.cmake.cmaketoolchain:extra_variables={&quot;FOO&quot;: &quot;bar&quot;}&#39;</span><span class="p">,</span>
+<span class="p">]</span>
+</code></pre></div>
+<p>Any Conan CLI flag works: <code>-s</code> / <code>-o</code> / <code>-c</code> (host),
+<code>-s:b</code> / <code>-o:b</code> / <code>-c:b</code> (build context),
+<code>--build=...</code>, <code>--lockfile=...</code>. Pair-form
+(<code>["-s", "compiler.cppstd=17"]</code>) is also accepted.</p>
 <h2 id="entry-points-pep-621">Entry points (PEP 621)</h2>
 <p><code>[project.scripts]</code>, <code>[project.gui-scripts]</code> and
 <code>[project.entry-points.*]</code> from <code>pyproject.toml</code> are

configuration/index.html

@@ -191,6 +191,7 @@ All project-level options live under
 |--------|--------------|-------------|---------|
 | `conanfile-path` | `[tool.conan-py-build]` | Path to the Conan recipe, relative to project root | `"."` |
 | `extra-profile` | `[tool.conan-py-build]` | Extra Conan profile composed on top of the active one | (none) |
+| `extra-arguments` | `[tool.conan-py-build]` | Extra Conan CLI flags appended to `conan build` and `conan export-pkg` | `[]` |
 | `version.file` | `[tool.conan-py-build.version]` | Python file with `__version__` | (none) |
 | `version.provider` | `[tool.conan-py-build.version]` | `"setuptools_scm"` for version from git tags | (none) |
 | `packages` | `[tool.conan-py-build.wheel]` | Paths to Python packages in the wheel | `["src/<name>"]` |
@@ -200,6 +201,10 @@ Variants for extra profiles: `extra-profile-host`,
 `extra-profile-build`, `extra-profile-all`.
 Paths relative to project root.
 
+For one-off Conan overrides without shipping a separate
+profile file, use `extra-arguments` (see *Extra Conan
+arguments* below).
+
 Default `packages` is `src/<normalized_project_name>`
 (hyphens → underscores).
 
@@ -286,6 +291,47 @@ or `CONAN_HOME` / `.conanrc`). Set
 `CONAN_PY_BUILD_PROFILE_AUTODETECT=1` to autodetect
 the profile instead of requiring `default`.
 
+## Extra Conan arguments
+
+CLI flags appended to `conan build` and
+`conan export-pkg`. Symmetric with `extra-profile`,
+with higher precedence — CLI flags win against any
+profile entry.
+
+Bump `compiler.cppstd` to match a transitive dep
+(e.g. `gdal/3.12.1` requires C++17, MSVC defaults
+to 14):
+
+```toml
+[tool.conan-py-build]
+extra-arguments = ["-s=compiler.cppstd=17"]
+```
+
+Disable an optional dep feature and pin parallelism:
+
+```toml
+[tool.conan-py-build]
+extra-arguments = [
+    "-o=gdal/*:with_arrow=False",
+    "-c=tools.build:jobs=4",
+]
+```
+
+For values with embedded double quotes (dict / list
+`[conf]` literals), use TOML literal strings (`'...'`):
+
+```toml
+extra-arguments = [
+    '-c=tools.build:cflags+=["-O2", "-fPIC"]',
+    '-c=tools.cmake.cmaketoolchain:extra_variables={"FOO": "bar"}',
+]
+```
+
+Any Conan CLI flag works: `-s` / `-o` / `-c` (host),
+`-s:b` / `-o:b` / `-c:b` (build context),
+`--build=...`, `--lockfile=...`. Pair-form
+(`["-s", "compiler.cppstd=17"]`) is also accepted.
+
 ## Entry points (PEP 621)
 
 `[project.scripts]`, `[project.gui-scripts]` and