Skip to content

Commit e4e08e0

Browse files
KemingHegithub-actions[bot]
authored andcommitted
docs(src/assets/): update pixi official documentation
1 parent 1d19713 commit e4e08e0

File tree

3 files changed

+28
-3
lines changed

3 files changed

+28
-3
lines changed

src/assets/pixi/_metadata.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"source_repo": "prefix-dev/pixi",
33
"docs_path": "docs",
4-
"updated_at": "2025-11-25T22:05:53Z",
5-
"commit_sha": "6638d0a3b70ab87c3968adc4b31ab796b9a3c0c1"
4+
"updated_at": "2025-12-02T22:05:47Z",
5+
"commit_sha": "9cfcecf4218fb4b2dda8fbbd70c367a1965c6427"
66
}

src/assets/pixi/integration/editor/vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ RUN echo 'eval "$(pixi completion -s bash)"' >> /home/vscode/.bashrc
5555
}
5656
},
5757
"features": {
58-
"ghcr.io/devcontainers/environments/docker-in-docker:2": {}
58+
"ghcr.io/devcontainers/features/docker-in-docker:2": {}
5959
},
6060
"mounts": ["source=${localWorkspaceFolderBasename}-pixi,target=${containerWorkspaceFolder}/.pixi,type=volume"],
6161
"postCreateCommand": "sudo chown vscode .pixi && pixi install"

src/assets/pixi/reference/pixi_manifest.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -444,6 +444,7 @@ The options that can be defined are:
444444
- `no-build`: don't build source distributions.
445445
- `no-binary`: don't use pre-build wheels.
446446
- `index-strategy`: allows for specifying the index strategy to use.
447+
- `prerelease-mode`: controls whether pre-release versions are allowed during dependency resolution.
447448

448449
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.
449450

@@ -571,6 +572,30 @@ By default, `uv` and thus `pixi`, will stop at the first index on which a given
571572
!!! info "PyPI only"
572573
The `index-strategy` only changes PyPI package resolution and not conda package resolution.
573574

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+
574599
## The `dependencies` table(s)
575600
??? info "Details regarding the dependencies"
576601
For more detail regarding the dependency types, make sure to check the [Run, Host, Build](../build/dependency_types.md) dependency documentation.

0 commit comments

Comments
 (0)