feat: add import yml flag (#792)

Co-authored-by: Bas Zalmstra <[email protected]>
Co-authored-by: Ruben Arts <[email protected]>

Cargo.toml

@@ -63,6 +63,7 @@ serde-untagged = "0.1.5"
 serde_json = "1.0.113"
 serde_spanned = "0.6.5"
 serde_with = { version = "3.6.1", features = ["indexmap"] }
+serde_yaml = "0.9.31"
 shlex = "1.3.0"
 spdx = "0.10.3"
 strsim = "0.10.0"

docs/cli.md

@@ -28,13 +28,19 @@ It initializes a `pixi.toml` file and also prepares a `.gitignore` to prevent th
 
 - `--channel <CHANNEL> (-c)`: specify a channel that the project uses. Defaults to `conda-forge`. (Allowed to be used more than once)
 - `--platform <PLATFORM> (-p)`: specify a platform that the project supports. (Allowed to be used more than once)
+- `--import <ENV_FILE> (-i)`: Import an existing conda environment file, e.g. `environment.yml`.
+!!! info "Importing an environment.yml"
+    When importing an environment, the `pixi.toml` will be created with the dependencies from the environment file.
+    The `pixi.lock` will be created when you install the environment.
+    We don't support `git+` urls as dependencies for pip packages and for the `defaults` channel we use `main`, `r` and `msys2` as the default channels.
 
 ```shell
 pixi init myproject
 pixi init ~/myproject
 pixi init  # Initializes directly in the current directory.
 pixi init --channel conda-forge --channel bioconda myproject
 pixi init --platform osx-64 --platform linux-64 myproject
+pixi init --import environment.yml
 ```
 
 ## `add`