You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/assets/pixi/reference/pixi_manifest.md
+25Lines changed: 25 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -444,6 +444,7 @@ The options that can be defined are:
444
444
-`no-build`: don't build source distributions.
445
445
-`no-binary`: don't use pre-build wheels.
446
446
-`index-strategy`: allows for specifying the index strategy to use.
447
+
-`prerelease-mode`: controls whether pre-release versions are allowed during dependency resolution.
447
448
448
449
These options are explained in the sections below. Most of these options are taken directly or with slight modifications from the [uv settings](https://docs.astral.sh/uv/reference/settings/). If any are missing that you need feel free to create an issue [requesting](https://github.com/prefix-dev/pixi/issues) them.
449
450
@@ -571,6 +572,30 @@ By default, `uv` and thus `pixi`, will stop at the first index on which a given
571
572
!!! info "PyPI only"
572
573
The `index-strategy` only changes PyPI package resolution and not conda package resolution.
573
574
575
+
576
+
### Prerelease Mode
577
+
578
+
The strategy to use when considering pre-release versions during dependency resolution. Description taken from the [uv documentation](https://docs.astral.sh/uv/reference/settings/#prerelease).
579
+
580
+
By default, `pixi` will allow pre-release versions when a package only has pre-release versions available, or when a pre-release version is explicitly requested in the version specifier (e.g., `>=1.0.0a1`).
581
+
582
+
!!! warning "One prerelease mode per environment"
583
+
Only one `prerelease-mode` can be defined per environment or solve-group, otherwise, an error will be shown.
584
+
585
+
#### Possible values:
586
+
587
+
-**"disallow"**: Disallow all pre-release versions.
588
+
-**"allow"**: Allow all pre-release versions.
589
+
-**"if-necessary"**: Allow pre-release versions if all versions of a package are pre-release.
590
+
-**"explicit"**: Allow pre-release versions for first-party packages with explicit pre-release markers in their version requirements.
591
+
-**"if-necessary-or-explicit"** (default): Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirements.
592
+
593
+
Example:
594
+
```toml
595
+
[pypi-options]
596
+
prerelease-mode = "allow"# Allow all pre-release versions
597
+
```
598
+
574
599
## The `dependencies` table(s)
575
600
??? info "Details regarding the dependencies"
576
601
For more detail regarding the dependency types, make sure to check the [Run, Host, Build](../build/dependency_types.md) dependency documentation.
0 commit comments