Metadata-Version: 2.1
Name: swancontents
Version: 2.1.11
Summary: SWAN Contents Manager for Jupyter
Home-page: https://github.com/swan-cern/jupyter-extensions
Author: SWAN Admins
License: AGPL-3.0
Keywords: Jupyter,Notebooks,SWAN,CERN
Platform: Linux
Platform: Mac OS X
Platform: Windows
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Jupyter
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: jupyter-server
Requires-Dist: nbclassic

# SwanContents

Server and NB extension that provides:
* SWAN Projects (including readme preview)
* EOS integration (versioning and atomic save)
* git download
* SWAN style in a form of Jupyter Notebook templates

This module also installs a lab extension that adds links throughout the UI to switch between the Lab and the old UI.

## Requirements

Besides Jupyter, this extension requires that the user home is set inside EOS.

## Install

Install the package and the nbextension:

```bash
pip install swancontents
```

To replace the default Jupyter Contents Manager (including its Javascript library) and the templates, in the Jupyter Notebook configuration (i.e in `jupyter_notebook_config.py`), set the following:

```python
c.ServerApp.contents_manager_class = 'swancontents.filemanager.SwanEosFileManager'
```

Note: `EOSCheckpoints` is set by default as `checkpoints_class` when using SwanEosFileManager.


