jupyterlab-conda-store

Information	Links
Project
Releases

A JupyterLab extension for conda-store.

Installation 📦

Pre-requisites

You will need to have conda-store installed and running on your local computer to use this extension. As well as:

• JupyterLab >= 4.0
• Python >= 3.8

You can install the extension with pip:

pip install jupyterlab-conda-store

To remove the extension, execute:

pip uninstall jupyterlab-conda-store

Installing the development version 🚀

Pre-requisites

1. You will need to have NodeJS > 18 installed on your local computer to build the extension package.
2. Python >= 3.8 and pip.

Building and linking the extension

1. Clone this repository to your local computer:

   git clone https://github.com/conda-incubator/jupyterlab-conda-store.git
   

2. Change to the jupyterlab-conda-store directory:

    cd jupyterlab-conda-store
   

3. Create a new conda environment:

   conda env create -f environment.yaml
   
   # activate the environment
   conda activate jupyterlab-conda-store
   

4. Install the package in development mode:

   python -m pip install -e .
   

5. Now you'll need to link the development version of the extension to JupyterLab and rebuild the Typescript source:

   # Install the extension dependencies
   jlpm install
   # Link your development version of the extension with JupyterLab
   jupyter labextension develop . --overwrite
   

6. On the first installation, or after making some changes, to visualize them in your local JupyterLab re-run the following command:

   # Rebuild extension Typescript source after making changes
   jlpm run build
   

7. Run JupyterLab and check that the installation worked:

   # Run JupyterLab
   jupyter lab
   

To lint files as you work on contributions, you can run:

jlpm run lint:check

Uninstalling the development version

1. Remove the extension:

   pip uninstall jupyterlab-conda-store
   

2. In development mode, you will also need to remove the symlink created by jupyter labextension develop command. To find its location, you can run jupyter labextension list to figure out where the labextensions folder is located. Then you can remove the symlink named jupyterlab-conda-store within that folder.

Release

To create a jupyterlab-conda-store release:

1. Open a new_release issue in the repository and fill in the release details.
2. Follow the steps in the new release checklist.

Code of Conduct 🤝

To guarantee a welcoming and friendly community, we require all community members to follow our Code of Conduct.

License 📃

jupyterlab-conda-store is developed under the BSD 3-Clause License.