{"id":21953921,"url":"https://github.com/hydroshare/hydroshare_on_jupyter","last_synced_at":"2025-07-02T14:08:58.229Z","repository":{"id":44754274,"uuid":"218548212","full_name":"hydroshare/hydroshare_on_jupyter","owner":"hydroshare","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-25T00:22:34.000Z","size":2999,"stargazers_count":3,"open_issues_count":10,"forks_count":4,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-06-21T20:18:03.786Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cuahsi.github.io/jupyterhub/hydroshare_on_jupyter/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hydroshare.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-30T14:36:31.000Z","updated_at":"2025-02-25T00:22:04.000Z","dependencies_parsed_at":"2024-12-02T20:19:33.260Z","dependency_job_id":"8ea1f5ef-0a1c-48d3-9587-bf32da1fee6b","html_url":"https://github.com/hydroshare/hydroshare_on_jupyter","commit_stats":{"total_commits":686,"total_committers":9,"mean_commits":76.22222222222223,"dds":0.564139941690962,"last_synced_commit":"9df912006b87d285f11a5a18d9c48ecf551b9c07"},"previous_names":["hydroshare/hydroshare_jupyter_sync"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/hydroshare/hydroshare_on_jupyter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydroshare_on_jupyter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydroshare_on_jupyter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydroshare_on_jupyter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydroshare_on_jupyter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hydroshare","download_url":"https://codeload.github.com/hydroshare/hydroshare_on_jupyter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydroshare_on_jupyter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261186842,"owners_count":23121955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T07:14:17.922Z","updated_at":"2025-07-02T14:08:58.209Z","avatar_url":"https://github.com/hydroshare.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HydroShare on Jupyter\n\nHydroShare on Jupyter brings HydroShare resource management to JupyterLab's development environment.\nDownload, edit, upload, and synchronize your HydroShare resources without leaving Jupyter!\nCollaborate, iterate, and stay up to date with HydroShare on Jupyter.\n\n## Installation\n\nIn accordance with the python community, we support and advise the usage of virtual environments in\nany workflow using python. In the following installation guide, we use python's built-in venv module\nto create a virtual environment in which the tools will be installed. Note this is just personal\npreference, any python virtual environment manager should work just fine (conda, pipenv, etc. ).\n\n\n```python\n# Create and activate python environment, requires python \u003e= 3.7\n\npython3 -m venv venv\nsource venv/bin/activate\npython3 -m pip install --upgrade pip\n\n# Install\npython3 -m pip install hydroshare_on_jupyter\n\n# Link extension to JupyterLab\npython3 -m hydroshare_on_jupyter configure\n\n# Launch JupyterLab and start collaborating!\npython3 -m jupyter lab\n```\n\n## Configuration\n\n\nHydroShare on Jupyter looks for configuration information in environment variables first, then at\nthe following path locations:\n\n1. `~/.config/hydroshare_on_jupyter/config`\n2. `~/.hydroshare_on_jupyter_config`\n\nThe first configuration file found is used if it exists. However, environment variables take\nprecedence, meaning they override configuration file values if they are set.\n\nHydroShare on Jupyter configuration files use `KEY=VALUE` semantics (example below). Only one\nconfiguration variable should be specified per line. Line comments can be created by starting a line\nwith `#`.\n\n### Configuration Variables\n\n- `DATA` : directory where HydroShare resources are saved, default `~/hydroshare`.\n- `OAUTH` : canonical HydroShare OAuth2 pickle file, default None. Allows bypassing login by using OAuth2 via HydroShare.\n\nExample configuration file\n\n```shell\n# file: ~/.config/hydroshare_on_jupyter/config\nDATA=~/Downloads\n```\n\n**Note**\n\nBy default, HydroShare on Jupyter saves HydroShare resources to `~/hydroshare`. This means, if\nJupyterLab is started from a directory where `~/hydroshare` is not a descendent (e.g.\n`~/Downloads`), you will not be able to open the HydroShare resource files you download using\nHydroShare on Jupyter. To resolve this, either open JupyterLab from `~` or change the directory\nHydroShare on Jupyter saves resources to using the data `DATA` configuration variable.\n\n## Development\n\nHydroShare on Jupyter is open source and is available on [GitHub](https://github.com/hydroshare/hydroshare_on_jupyter).\nFor contributing, please follow the following steps:\n\n1. Clone the repository: `git clone https://github.com/hydroshare/hydroshare_on_jupyter.git`\n2. Create a branch: `git checkout -b my-branch`\n3. Create and activate a virtual environment (python \u003e= 3.7): `python3 -m venv venv`\n4. Activate the virtual environment: `source venv/bin/activate`\n5. Build the frontend: Refer to webapp/README.md for instructions.   \n6. Build the backend:\n\n    6.1. Navigate to the root of the project: `hydroshare_on_jupyter`\n\n    6.2. Run: `python3 pip install -e .`\n7. Link extension to JupyterLab: `python3 -m hydroshare_on_jupyter configure` \n8. Check the list of configured extensions: `jupyter labextension list --verbose`\n\n   8.1.  Make sure the HydroShare on Jupyter extension is listed\n9. Check the list of server extensions: `jupyter server extension list`\n\n   9.1. Make sure the HydroShare on Jupyter server extension is listed\n10. Set up the DATA environment variable: `export DATA=~/hydroshare/Downloads`\n11. Launch JupyterLab: `python3 -m jupyter lab --debug --notebook-dir=~/hydroshare`\n12. You should see the HydroShare on Jupyter extension in the JupyterLab launcher. Double click to open HydroShare on Jupyter.\n13. Commit and push your changes.\n14. Create a pull request GitHub.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydroshare%2Fhydroshare_on_jupyter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhydroshare%2Fhydroshare_on_jupyter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydroshare%2Fhydroshare_on_jupyter/lists"}