# Coding

```{important}
This tutorial assumes you have a [working development environment.](setup.md)
```

In this tutorial, we'll show you how to ensure everything is ready for you to start contributing.
## Syncing your fork

In the [](setup.md) tutorial, you forked the repository you'll contribute to. Before starting to code it's important to ensure that the main branch in your fork is synced with the main branch in the original repository. To do so, click on sync fork:

![sync-fork](../assets/sync-fork.png)

If you have problems syncing your fork, [message us on Slack.](https://ploomber.io/community)
## Creating a new branch


Now, let's create a new branch. Move to the directory that contains your fork and create a new branch:

```sh
git checkout -b my-new-branch
```

```{tip}
Change `my-new-branch` for a descriptive name that reflects what this branch is about.
```

All the code changes that you do will take place in this new branch. Let's now verify your IDE configuration.


## Committing your work

commit as much as you want

it won't destroy anything

once you're ready to show your work, open a PR

```{tip}
We encourage you to start working on your contribution and open a draft Pull Request to request early feedback, this will helps us ensure we're on the same page.
```

## Verifying conda environment

First, open a terminal and activate the environment for the project you'll be working on:

```sh
conda environment ENV_NAME
```

```{important}
Take note on the `ENV_NAME`, since we'll need this value later.
```

Now, execute the following:

```sh
python -c 'import sys; print(sys.prefix)'
```

You should see something like this if you installed miniconda:

```
path/to/miniconda3/envs/ENV_NAME/bin/python
```

Or like this, if you installed Anaconda:

```
path/to/anaconda3/envs/ENV_NAME/bin/python
```

```{warning}
If the output does not contain `miniconda` or `anaconda`, send us a message on [Slack](https://ploomber.io/community) and we'll help you.
```


- [Click here](#jupyterlab) for JupyterLab instructions
- [Click here](#vscode) for VSCode instructions

## JupyterLab


```{warning}
Starting JupyterLab from another environment or Anaconda's graphical user interface might create issues. We highly recommend you install and start JupyterLab from the same conda environment, as described below.
```

If you want to use JupyterLab for developing, ensure you install and start it from
the same conda environment:

```sh
# activate environment
conda activate ENV_NAME

# install JupyterLab
pip install jupyterlab

# start JupyterLab
jupyter lab
```

Once JupyterLab opens, open a notebook, a terminal:

![notebook-and-terminal](../assets/lab-notebook-and-terminal.png)

And run the following, in the notebook:

```python
import sys; print("sys.prefix:", sys.prefix)
```

Verify that the printed value is the same as you saw in the
[Verifying conda environment](#verifying-conda-environment) section (the `ENV_NAME`).


Now, open a terminal and run the following:

```sh
python -c 'import sys; print("sys.prefix:", sys.prefix)'
```

Then, ensure that what's printed is `ENV_NAME`; if it's not, then you'll have to
run `conda activate ENV_NAME` every time you open a terminal.

```{warning}
Once a package is imported in Jupyter, changes to the source code are not automatically reflected. You need to restart the kernel or enable [autoreload](https://ipython.readthedocs.io/en/stable/config/extensions/autoreload.html)
```

If you'll be contributing with code, go to the [Coding](../contributing/coding.md) section, if you'll
be contributing with documentation, go to the
[Building documentation](../documentation/build-doc.md) section.

## VSCode

When using VSCode, you must ensure that you're using the right Python installation.
You can easily set this by opening the
[command paletter](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette),
then typing `Python: Select Interpreter`:


![vscode-1-py-interpreter](../assets/vscode-1-py-interpreter.png)

Then, type the `ENV_NAME`. For example, if I'm
setting up JupySQL, `ENV_NAME` is `jupysql`, so once I type it, I'll see this:


![vscode-2-env-name](../assets/vscode-2-env-name.png)

And type enter. Then, whenever you open a terminal, the conda environment will be automatically activated:

![vscode-3-terminal](../assets/vscode-3-terminal.png)

If it doesn't execute automatically, you'll have to run the `conda activate ENV_NAME` command every time you open a terminal.

### VSCode notebooks

If you want to write notebooks from VSCode, you need to ensure that the right kernel is enabled. Once you open a notebook, click on "Select Kernel":

![vscode-4-kernel](../assets/vscode-4-kernel.png)

Then, select the `Python Environments...` option and type Enter:

![vscode-5-kernel-name](../assets/vscode-5-kernel-name.png)

Finally, type the `ENV_NAME`, choose the option that matches the location of the conda environment and press Enter:

![vscode-6-kernel-select](../assets/vscode-6-kernel-select.png)