[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

content/how-tos/how-to-create-environments.md

@@ -3,27 +3,28 @@ title: How to set up an environment
 ---
 
 In this guide we summarize some key commands to set up an environment
-with different tools that you might encounter in the scientific python 
+with different tools that you might encounter in the scientific python
 ecosystem. An environment is a workspace into which you can install Python
 libraries, separate from what is being used by your operating system.
 
 The environment managers that are covered in this how-to guide include:
+
 - venv
 - conda
 - mamba
 - uv
 - pixi
 
-In each of these examples we'll create a new virtual environment related to our 
-project called `science` (you can use whichever name you prefer!). We'll activate 
-the environment, install some dependencies, and see 
-an example of installing dependencies from an existing file. You may encounter 
-files like `requirements.txt`, `environment.yml` or `pyproject.toml` that specify 
-needed dependencies for a project.  
+In each of these examples we'll create a new virtual environment related to our
+project called `science` (you can use whichever name you prefer!). We'll activate
+the environment, install some dependencies, and see
+an example of installing dependencies from an existing file. You may encounter
+files like `requirements.txt`, `environment.yml` or `pyproject.toml` that specify
+needed dependencies for a project.
 
 ### Set up a virtual environment with venv
 
-With venv to create  environment associated with a project folder called `science`. 
+With venv to create environment associated with a project folder called `science`.
 
 ```shell
 python -m venv science
@@ -41,9 +42,9 @@ You are now ready to install Scientific Python packages using `pip`! For example
 pip install ipython numpy scipy
 ```
 
-Often you'll interact with projects that have a specific list of dependencies (for development 
+Often you'll interact with projects that have a specific list of dependencies (for development
 environments, testing environments, or the project itself). You can install the list of dependencies
-with pip in your venv using: 
+with pip in your venv using:
 
 ```shell
 pip install -r <path/to/requirements.txt>
@@ -55,18 +56,18 @@ Remember to re-activate your environment every time you open a new terminal, usi
 source science/bin/activate
 ```
 
-You can find more information on using venv for packaging 
+You can find more information on using venv for packaging
 [here](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/).
 
-### Set up an environment using conda 
+### Set up an environment using conda
 
 With conda, we can create a new environment named science (-n is the same as passing --name):
 
 ```shell
 conda create -n science
 ```
 
-Start using your environment by activating it: 
+Start using your environment by activating it:
 
 ```shell
 conda activate science
@@ -79,9 +80,9 @@ For example:
 conda install ipython numpy scipy
 ```
 
-Some projects distribute environment files with listed dependencies with an `environment.yml` file. 
+Some projects distribute environment files with listed dependencies with an `environment.yml` file.
 The first line of this file sets the environment's name. To
-create an environment and install the dependencies with this file, use: 
+create an environment and install the dependencies with this file, use:
 
 ```shell
 conda env create -f <path/to/environment.yml>
@@ -93,18 +94,18 @@ Remember to re-activate your environment every time you open a new terminal:
 conda activate science
 ```
 
-You can find more information on using conda for environments  
+You can find more information on using conda for environments
 [here](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html).
 
-### Set up an environment using mamba 
+### Set up an environment using mamba
 
 With mamba, like conda, we can create a new environment named science (-n is the same as passing --name):
 
 ```shell
 mamba create -n science
 ```
 
-Start using your environment by activating it: 
+Start using your environment by activating it:
 
 ```shell
 mamba activate science
@@ -117,7 +118,7 @@ For example:
 mamba install ipython numpy scipy
 ```
 
-To install a specific environment from a `.yml` file, use: 
+To install a specific environment from a `.yml` file, use:
 
 ```shell
 mamba create -f </path/to/environment.yml>
@@ -129,19 +130,19 @@ Remember to re-activate your environment every time you open a new terminal:
 mamba activate science
 ```
 
-You can find more information on using mamba in the   
+You can find more information on using mamba in the
 [mamba user guide](https://mamba.readthedocs.io/en/latest/user_guide/mamba.html).
 
-### Set up a virtual environment using uv 
+### Set up a virtual environment using uv
 
-To create a new environment using uv in a project folder called `science`, 
-navigate to that folder and execute:  
+To create a new environment using uv in a project folder called `science`,
+navigate to that folder and execute:
 
 ```shell
 uv venv
 ```
 
-Start using your environment by activating it: 
+Start using your environment by activating it:
 
 ```shell
 source .venv/bin/activate
@@ -154,7 +155,7 @@ For example:
 uv pip install ipython numpy scipy
 ```
 
-To install dependencies from a requirements file, use: 
+To install dependencies from a requirements file, use:
 
 ```shell
 uv pip install -f </path/to/requirements.txt>
@@ -166,15 +167,15 @@ Remember to re-activate your environment time you open a new terminal:
 source <path/to/science/>.venv/bin/activate
 ```
 
-You can find more information on using uv for environments 
+You can find more information on using uv for environments
 [here](https://docs.astral.sh/uv/pip/environments/#creating-a-virtual-environment).
 
-### Set up a virtual environment using pixi 
+### Set up a virtual environment using pixi
 
-To initialize a new project with pixi in our project called `science`, execute:   
+To initialize a new project with pixi in our project called `science`, execute:
 
 ```shell
-pixi init 
+pixi init
 ```
 
 You are now ready to install Scientific Python packages as dependencies in this project!
@@ -184,34 +185,28 @@ From the science directory, execute:
 pixi add ipython numpy scipy
 ```
 
-To install dependencies from a file like `environment.yml`, use: 
+To install dependencies from a file like `environment.yml`, use:
 
 ```shell
 pixi init --import <path/to/environment.yml>
 ```
 
-Remember to re-activate your environment when you re-open a terminal. Navigate to 
+Remember to re-activate your environment when you re-open a terminal. Navigate to
 the science folder, and execute:
 
 ```shell
-pixi shell 
+pixi shell
 ```
 
-This will drop you into the default environment for the pixi project, with all 
-dependencies in that environment accessible to you in that shell. 
+This will drop you into the default environment for the pixi project, with all
+dependencies in that environment accessible to you in that shell.
 
-A pixi project may have multiple environments defined in the `pixi.toml` file. To 
-load a specific environment: 
+A pixi project may have multiple environments defined in the `pixi.toml` file. To
+load a specific environment:
 
 ```shell
-pixi shell --environment=<envname> 
+pixi shell --environment=<envname>
 ```
 
-You can find more information on using pixi  
+You can find more information on using pixi
 [here](https://prefix.dev/docs/pixi/basic_usage).
-
-
-
-
-
-