hsfiles_jupyter 0.1.0

A JupyterLab extension to manage HydroShare resource files in JupyterLab

hsfiles_jupyter

A JupyterLab extension for managing HydroShare resource files in JupyterLab. This extension assumes that the user has loaded a HydroShare resource to a JupyterHub environment using the 'Open with' functionality in HydroShare.

Installation

# Create and activate python environment, requires python >= 3.9

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip

# Install
python3 -m pip install hsfiles_jupyter

# Link extension to JupyterLab
python3 -m hsfiles_jupyter

# Launch JupyterLab and access the functionality of this extension from the JupyterLab file browser menu!
python3 -m jupyter lab

Setup for Development

1. Clone the repository: git clone https://github.com/hydroshare/hsfiles_jupyter.git
2. Navigate to the project root directory: cd hsfiles_jupyter
3. Create a branch: git checkout -b my-branch
4. Create a virtual environment: python3 -m venv .venv
5. Activate the virtual environment: source .venv/bin/activate
6. Install dependencies using pip install -e .[dev]

Frontend

1. Navigate to the frontend directory.
2. Run npm install to install dependencies.
3. Run npm run build to compile the TypeScript code.
4. Run jupyter lab build to build the frontend assets.
5. Run jupyter labextension install . to install the extension.

Backend

1. Navigate to the hsfiles_jupyter directory (project root).
2. Run python3 -m hsfiles_jupyter to link extension to JupyterLab.

Usage

1. Setup a notebook dir to be used as the root directory in JupyterLab. Example: ~/Documents/hsfiles_jupyter

   1.1. Create a directory called "Downloads" under the notebook root directory. Example: ~/Documents/hsfiles_jupyter/Downloads

   1.2. Download a HydroShare resource that you own and extract the contents to the "Downloads" directory.

2. Export your HydroShare credentials as environment variables. This is needed for local development only:

export HS_USER=your_hydroshare_username
export HS_PASS=your_hydroshare_password

3. Start JupyterLab: jupyter lab --debug --notebook-dir=~/Documents/hsfiles_jupyter
4. This will open the JupyterLab in browser. Open the "Downloads" directory in the file browser and navigate to data/contents folder, and you should see the contents of the resource your downloaded. Right-click on any of the resource files, and you should see HydroShare specific file action menu options".

Create distribution package to publish to PyPI

1. Clone the repository: git clone https://github.com/hydroshare/hsfiles_jupyter.git
2. Navigate to the project root directory: cd hsfiles_jupyter
3. Checkout the main branch: git checkout -b main origin/main
4. Create a virtual environment: python3 -m venv .venv
5. Activate the virtual environment: source .venv/bin/activate
6. Install dependencies using pip install .[dev]
7. Navigate to frontend directory: cd frontend
8. Run npm install to install dependencies.
9. Run npm run build to compile the TypeScript code.
10. Navigate to the project root directory: cd ..
11. Run python3 -m build to create the distribution package.
12. Run twine upload dist/* to publish the package to PyPI.