Merge SwanProjects, SwanTerminal, SwanLauncher, SwanFileBrowser into single package

Author: krishnan-r

SwanProjects/.bumpversion.cfg

@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.1.0
+commit = True
+tag = True
+tag_name = SwanProjects/v{new_version}
+message = SwanProjects v{new_version}
+
+[bumpversion:file:package.json]
+

SwanProjects/.eslintignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+coverage
+**/*.d.ts
+tests

SwanProjects/.eslintrc.js

@@ -0,0 +1,39 @@
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/eslint-recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended'
+  ],
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    sourceType: 'module'
+  },
+  plugins: ['@typescript-eslint'],
+  rules: {
+    '@typescript-eslint/naming-convention': [
+      'error',
+      {
+        'selector': 'interface',
+        'format': ['PascalCase'],
+        'custom': {
+          'regex': '^I[A-Z]',
+          'match': true
+        }
+      }
+    ],
+    '@typescript-eslint/no-unused-vars': ['warn', { args: 'none' }],
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-namespace': 'off',
+    '@typescript-eslint/no-use-before-define': 'off',
+    '@typescript-eslint/quotes': [
+      'error',
+      'single',
+      { avoidEscape: true, allowTemplateLiterals: false }
+    ],
+    curly: ['error', 'all'],
+    eqeqeq: 'error',
+    'prefer-arrow-callback': 'error'
+  }
+};

SwanProjects/.gitignore

@@ -0,0 +1 @@
+swanprojects/labextensions

SwanProjects/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+**/node_modules
+**/lib
+**/package.json
+swanterminal

SwanProjects/.prettierrc

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "trailingComma": "none",
+  "arrowParens": "avoid"
+}

SwanProjects/LICENSE

@@ -0,0 +1,28 @@
+include LICENSE
+include README.md
+include pyproject.toml
+recursive-include jupyter-config *.json
+
+include swanprojects/kernelmanager/resources/*
+include swanprojects/stacks/*/*
+include swanprojects/static/index.html
+include package.json
+include install.json
+include ts*.json
+include yarn.lock
+
+graft swanprojects/labextensions
+
+# Javascript files
+graft src
+graft style
+prune **/node_modules
+prune lib
+prune binder
+
+# Patterns to exclude from any directory
+global-exclude *~
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude .git
+global-exclude .ipynb_checkpoints

SwanProjects/MANIFEST.in

@@ -0,0 +1,34 @@
+# SwanProjects
+
+Server and Lab extension that provides:
+* In the backend, the endpoints to:
+  * Create and edit projects
+  * Get project information
+  * Get software stack information
+  * A customized Kernel Spec Manager to handle kernel metadata
+* In the Lab extension:
+  * React dialogs to create and edit projects
+  * LabIcons required for the dialogs
+
+## Requirements
+
+JupyterLab~=3.0 and SwanContents
+
+## Install
+
+Install the package and the lab extension:
+
+```bash
+pip install swanprojects
+```
+
+To replace the default Jupyter Contents Manager and Kernel Spec Manager in the JupyterLab Notebook configuration (i.e in `jupyter_notebook_config.py`), set the following:
+
+```python
+c.NotebookApp.contents_manager_class = 'swancontents.filemanager.swanfilemanager.SwanFileManager'
+c.NotebookApp.kernel_spec_manager_class = 'swanprojects.kernelmanager.kernelspecmanager.SwanKernelSpecManager'
+c.KernelSpecManager.ensure_native_kernel = False
+
+c.SwanConfig.stacks_path=path_to_stacks_folder
+c.SwanConfig.kernel_resources=path_to_native_kernel_resources
+```

SwanProjects/README.md

@@ -0,0 +1,50 @@
+#!/bin/bash -i
+#Author [email protected] 2021
+###
+# This is called from the extension SwanTerminal and it requires the project path and stacks path as arguments.
+# The project path is used to read the .swanproject file and the stacks path is required to load the proper enviroment.
+# When the bash session is started we modify the prompt indicating in which project the terminal is located.
+# Additionally, the bash session runs completely isolated from other possible environments,
+# so we need to define some basic environment variables such as:
+#
+# * HOME with path to the user home
+# * PATH with default paths for the system
+# * OAUTH2_TOKEN required by EOS storage
+#
+# swan_env will load the other variables from the stack, inside the isolated enviroment.
+###
+
+clear
+if ! [ -x "$(command -v jq)" ]; then
+  echo 'Error: jq is not installed.' >&2
+  sleep 60
+  exit 1
+fi
+if [[ $# -gt 1 ]] ; then
+    PROJECT_PATH=$1
+    PROJECT_NAME=`IFS='/'; ARR=($PROJECT_PATH);echo "${ARR[-1]}"`
+    PROJECT_FILE="$PROJECT_PATH/.swanproject"
+    
+    STACKS_PATH="$2"
+
+    if [ -d "$PROJECT_PATH" ]
+    then
+      STACK=`jq '.stack' "$PROJECT_FILE"`
+      RELEASE=`jq '.release' "$PROJECT_FILE"`
+      PLATFORM=`jq '.platform' "$PROJECT_FILE"`
+      USER_SCRIPT="$PROJECT_PATH/.userscript"
+      echo "Loading $RELEASE with plafortm $PLATFORM "
+      # FIXME: this have to be removed when environment isolation is not needed anymore, it's only temporary
+      env -i HOME=$HOME \
+             OAUTH2_TOKEN=$OAUTH2_TOKEN \
+             PROJECT="$PROJECT_NAME" \
+             PROJECT_PATH="$PROJECT_PATH" PS1="$PS1" \
+             bash -c "swan_env \"$PROJECT_PATH\" \"$STACKS_PATH\" \"$PROJECT_PATH\" bash --rcfile  <(echo 'PS1=\"($PROJECT_NAME) $PS1 \"') "
+    else
+      echo "Error: project $PROJECT_PATH doesn't exist" >&2
+      # JupyterLab closes the terminal window immediately after the process ends
+      # this sleep is to allow the user to see the message
+      sleep 60
+      exit 1
+    fi
+fi