Submit ballet modules from within JupyterLab
Project description
ballet-submit-labextension
Submit ballet modules from within JupyterLab
This extension is composed of a Python package named ballet-submit-labextension
for the server extension and a NPM package also named ballet-submit-labextension
for the frontend extension.
Requirements
- JupyterLab >= 2.0
Install
pip install ballet-submit-labextension
jupyter lab build
Note: You will need NodeJS to install the extension; the installation process will complain if it is not found.
Configure
The extension ties into the same configuration system as Jupyter [Lab] itself.
-
Determine the path to your jupyter config file (you may have to create it if it does not exist):
touch "$(jupyter --config-dir)/jupyter_notebook_config.py"
-
Append the following config to the end of the file:
c.BalletApp.username = 'github username' c.BalletApp.token = 'github personal access token'
You can optionally also configure the following:
c.BalletApp.useremail = 'email address to associate with git commit messages' c.BalletApp.debug = 'enable debug mode (no changes made on GitHub)'
Troubleshoot
If you are see the frontend extension but it is not working, check that the server extension is enabled:
jupyter serverextension list
If the server extension is installed and enabled but your not seeing the frontend, check the frontend is installed:
jupyter labextension list
If it is installed, try:
jupyter lab clean
jupyter lab build
Contributing
Development Install
The jlpm
command is JupyterLab's pinned version of
yarn that is installed with JupyterLab. You may use
yarn
or npm
in lieu of jlpm
below.
# Clone the repo to your local environment
# Move to ballet-submit-labextension directory
# Install server extension
pip install -e .
# Register server extension
jupyter serverextension enable --py ballet-submit-labextension
# Install dependencies
jlpm
# Build Typescript source
jlpm build
# Link your development version of the extension with JupyterLab
jupyter labextension link .
# Rebuild Typescript source after making changes
jlpm build
# Rebuild JupyterLab after making any changes
jupyter lab build
You can watch the source directory and run JupyterLab in watch mode to watch for changes in the extension's source and automatically rebuild the extension and application.
# Watch the source directory in another terminal tab
jlpm watch
# Run jupyterlab in watch mode in one terminal tab
jupyter lab --watch
Uninstall
pip uninstall ballet-submit-labextension
jupyter labextension uninstall jupyterlab_ballet-submit-labextension
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ballet-submit-labextension-0.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f60faa4545af6ae3e732e4361fbe7313f568226ad000c84863c78be1ec0d57d8 |
|
MD5 | 019a29d649c9805c086dff5547ac6ca9 |
|
BLAKE2b-256 | b322f1929bb68bad76592d7bee0cc0e7ded97b2b1b142bb6311e570e8b419bca |
Hashes for ballet_submit_labextension-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54c83029841956a4cd0359c651e34d3b5d585a285dbda9e91db2993202e8f251 |
|
MD5 | c7f3131955619525faa67e6956d415c8 |
|
BLAKE2b-256 | dd7c64145ee6dd4d655565a14841b1f21a2f8e57789a4942fee8079c4af5f52f |