Metadata-Version: 2.1
Name: qsharp-jupyterlab
Version: 0.0.11
Summary: Q# extension for JupyterLab
Project-URL: Homepage, https://github.com/microsoft/qsharp
Project-URL: Bug Tracker, https://github.com/microsoft/qsharp/issues
Project-URL: Repository, https://github.com/microsoft/qsharp.git
Author: Microsoft
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Framework :: Jupyter :: JupyterLab :: 4
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# Q# extension for JupyterLab

## Prerequisites

You will need to install `jupyterlab` to build and develop the extension.

```bash
pip install jupyterlab==4.0.0
```

## A note about `yarn`

The `jlpm` command used below is an alias for `yarn` which comes bundled with Jupyter.

This folder is not part of the `npm` workspace that is defined at the root of this repo.
This is intentional, since Jupyter extension tooling depends on `jlpm`, which expects a
`yarn`-style workspace and a `yarn.lock` file.

## Building

To build and install the extension in development mode, from the `jupyterlab` directory run:

```bash
pip install -e .
# The below command creates a symlink from JupyterLab's
# extensions directory to the current source directory.
jupyter labextension develop . --overwrite
```

To start JupyterLab and use the extension, run:

```bash
jupyter lab
```

To rebuild after making source changes, run:

```bash
jlpm build
```

Then refresh the browser.

## Uninstalling

Remove the `pip` package by running:

```bash
pip uninstall qsharp-jupyterlab
```

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 `qsharp-jupyterlab` within that folder.

## Releasing

The extension can be published to `PyPI` and `npm` manually or using the [Jupyter Releaser](https://github.com/jupyter-server/jupyter_releaser).
