Skip to content

Commit dc9a410

Browse files
Update development installation instructions in contributing.rst.
1 parent 7b46065 commit dc9a410

File tree

1 file changed

+21
-8
lines changed

1 file changed

+21
-8
lines changed

docs/source/contributing.rst

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,25 +7,38 @@ Contributing
77
Development install
88
-------------------
99

10-
**Note:** You will need :ref:`Node.js <https://nodejs.org/>` and :ref:`Docker <https://www.docker.com/>` to build the extension package.
10+
You need to create a development environment with `nodejs` and `jupyterlab` installed. We are here proposing to use `micromamba`.
1111

12-
The ``jlpm`` command is JupyterLab's pinned version of
13-
:ref:`yarn <https://yarnpkg.com/>` that is installed with JupyterLab. You may use
14-
:ref:`yarn <https://yarnpkg.com/>` or :ref:`npm <https://www.npmjs.com/>` in lieu of ``jlpm`` below.
12+
.. code-block:: bash
13+
14+
# Create an environment with micromamba and install nodejs and jupyterlab
15+
micromamba create -n jupytercad_dev -c conda-forge nodejs jupyterlab -y
16+
17+
18+
**Note:** There are 2 possibilities for the installation.
19+
20+
1) either you are using [Docker](https://www.docker.com/) to build `@jupytercad/opencascade` package and you need to run `jlpm dev`
21+
22+
2) or you are using a prebuilt version by calling `jlpm dev --no-occ-build` to install the package.
23+
24+
25+
**Note:** The `jlpm` command is JupyterLab's pinned version of
26+
[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
27+
`yarn` or `npm` in lieu of `jlpm` below.
1528

1629
.. code-block:: bash
1730
1831
# Clone the repo to your local environment
1932
git clone https://github.com/jupytercad/JupyterCAD.git
2033
# Change directory to the jupytercad directory
2134
cd JupyterCAD
22-
# Install JupyterLab for jlpm
23-
pip install jupyterlab
24-
# Install package in development mode
25-
python scripts/dev-install.py
35+
# Install dependencies and the package in development mode
36+
jlpm install
37+
jlpm dev ## if you haven't Docker installed replace this line by `jlpm dev --no-occ-build`
2638
# Rebuild extension Typescript source after making changes
2739
jlpm run build
2840
41+
2942
You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
3043

3144
.. code-block:: bash

0 commit comments

Comments
 (0)