Skip to content

Commit 2d86c40

Browse files
authored
Update README.md
1 parent f182fa4 commit 2d86c40

File tree

1 file changed

+24
-5
lines changed

1 file changed

+24
-5
lines changed

README.md

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,26 +6,45 @@
66
**[Link to Final Report](https://akashravi.github.io/SWAN-Package-Manager/)**
77

88

9-
This Jupyter notebook extension will allow the users to specify python modules (and their respective versions) via a user interface and make them available automatically inside the corresponding project.
9+
This Jupyter notebook extension will allow the users to install python modules (and their respective versions) via a user interface and make them available automatically inside the corresponding project.
1010

1111
Each project is internally mapped to a separate conda environment. This helps abstract the processing part, while providing an independent environment for each project.
1212

13+
1314
## Features
1415

1516
- View packages installed for a specific project
1617
- Update / Delete existing packages
1718
- Search for new packages and install them
1819
- Sync your project if any of your packages are missing or misconfigured
1920

20-
## Instructions
2121

22-
- This project assumes a [SWAN](https://gitlab.cern.ch/swan) setup. The APIs require certain actions as prerequisites, which are already fulfilled by SWAN.
23-
- Please find the install instructions [here](extension/install.md)
22+
## Setup Instructions
23+
24+
- This project assumes a SWAN setup. The APIs require certain actions as prerequisites, which are already fulfilled by SWAN.
25+
26+
- Please find the install instructions [here](https://github.com/techtocore/Jupyter-Package-Manager/blob/swan-integration/extension/install.md)
27+
28+
29+
## Usage Instructions
30+
31+
- From the Projects tab, you can create a folder by clicking on the **`+`** button. Internally, this will create a new conda environment for all the notebooks inside it.
32+
33+
- To configure the project, click the cog button. This would reveal a side panel listing down the installed packages, along with their corresponding versions.
34+
35+
- If in case the project metadata and the underlying environment are not in sync, the sidebar will also list the packages that need to be additionally installed. This is fundamental to share projects and collaborate with peers. By default, when a user clones a shared project, the required packages are not installed. This extension will let users install them.
36+
37+
- To install a new package, the user can search for them (an autocomplete feature is available). The selected packages are installed only when the user clicks the 'install' button. This allows the selection of other packages before issuing the 'install' command, which might take a while.
38+
39+
- Users can check for updates, for all or only the selected packages, by clicking the small cog button beside the list of installed packages. A pop-up modal will list the packages that need to be updated, along with their versions. Similarly, users can select one or more packages and uninstall them by clicking the bin icon.
40+
41+
- In order to create a notebook, click on the **`+`** button from inside a project or a regular folder. A list will then appear with the available languages. Users will be able to launch notebooks only using the kernel corresponding to that project. Any external notebook placed under the project will also be using the same kernel.
2442

2543

2644
## Documentation
2745

28-
- Please find the API Specification [here](docs/API_docs.md)
46+
- Please find the API Specification [here](https://github.com/techtocore/Jupyter-Package-Manager/blob/swan-integration/docs/API_docs.md)
47+
- The code is documented with necessary inline comments and docstrings
2948

3049

3150
## Screenshot

0 commit comments

Comments
 (0)