🎉 Initial add-on code

.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+ident_size = 4
+
+[*.md]
+ident_size = 2
+trim_trailing_whitespace = false
+
+[*.json]
+ident_size = 2
+
+[{.gitignore,.gitkeep,.editorconfig}]
+ident_size = 2

.github/CODEOWNERS

@@ -0,0 +1,4 @@
+# Require maintainer's :+1: for changes to the .github/ repo-config files
+# mainly due to https://github.com/probot/settings privilege escalation
+.github/* @frenck
+.gitlab-ci.yml @frenck

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,20 @@
+# Problem/Motivation
+
+> (Why the issue was filed)
+
+## Expected behavior
+
+> (What you expected to happen)
+
+## Actual behavior
+
+> (What actually happened)
+
+## Steps to reproduce
+
+> (How can someone else make/see it happen)
+
+## Proposed changes
+
+> (If you have a proposed change, workaround or fix,
+> describe the rationale behind it)

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+# Proposed Changes
+
+> (Describe the changes and rationale behind them)
+
+## Related Issues
+
+> ([Github link][autolink-references] to related issues or pull requests)
+
+[autolink-references]: https://help.github.com/articles/autolinked-references-and-urls/

.github/autolabeler.yml

@@ -0,0 +1,2 @@
+---
+"Type: Documentation": ["*.md", "*.j2"]

.github/config.yml

@@ -0,0 +1,50 @@
+---
+# Configuration for request-info - https://github.com/behaviorbot/request-info
+
+# *OPTIONAL* Comment to reply with
+# Can be either a string :
+requestInfoReplyComment:
+  - "We would appreciate it if you could provide us with more info about this issue/pr!"
+  - "Hmmm... That issue/PR is kinda low on text. Could you please provide some more content?"
+
+# *OPTIONAL* default titles to check against for lack of descriptiveness
+# MUST BE ALL LOWERCASE
+requestInfoDefaultTitles: []
+
+# *OPTIONAL* Label to be added to Issues and Pull Requests with insufficient information given
+requestInfoLabelToAdd: "Incomplete"
+
+# *OPTIONAL* Require Pull Requests to contain more information than what is provided in the PR template
+# Will fail if the pull request's body is equal to the provided template
+checkPullRequestTemplate: true
+
+# *OPTIONAL* Only warn about insufficient information on these events type
+# Keys must be lowercase. Valid values are 'issue' and 'pullRequest'
+requestInfoOn:
+  pullRequest: true
+  issue: true
+
+# *OPTIONAL* Add a list of people whose Issues/PRs will not be commented on
+# keys must be GitHub usernames
+requestInfoUserstoExclude: []
+
+# Configuration for new-issue-welcome - https://github.com/behaviorbot/new-issue-welcome
+
+# Comment to be posted to on first time issues
+newIssueWelcomeComment: >
+  :wave: Thanks for opening your first issue here!
+  If you're reporting a :bug: bug, please make sure you include steps to reproduce it.
+  Also, logs, error messages and information about your hardware might be usefull.
+
+# Configuration for new-pr-welcome - https://github.com/behaviorbot/new-pr-welcome
+
+# Comment to be posted to on PRs from first time contributors in your repository
+newPRWelcomeComment: >
+   :sparkling_heart: Thanks for opening this pull request! :sparkling_heart:
+   If your PR gets accepted and merged in, we will invite you to the project :tada:
+
+# Configuration for first-pr-merge - https://github.com/behaviorbot/first-pr-merge
+
+# Comment to be posted to on pull requests merged by a first time user
+firstPRMergeComment: >
+  Congrats on merging your first pull request! :tada::tada::tada:

.github/invite-contributors.yml

@@ -0,0 +1,10 @@
+---
+# If true, this will add new contributors as outside collaborators
+# to the repo their PR was merged in. Team name is ignored if this
+# flag is set to true.
+isOutside: false
+
+# Specify team name to add new contributors to a specific team
+# within your organization.
+# Use team name or team-name-slug
+team: Contributors

.github/lock.yml

@@ -0,0 +1,20 @@
+---
+# Configuration for lock-threads - https://github.com/dessant/lock-threads
+# Number of days of inactivity before a closed issue or pull request is locked
+daysUntilLock: 30
+
+# Comment to post before locking. Set to `false` to disable
+lockComment: >
+  This thread has been automatically locked because it has not had recent
+  activity. Please open a new issue for related bugs and link to relevant
+  comments in this thread.
+
+# Issues or pull requests with these labels will not be locked
+# exemptLabels:
+#   - no-locking
+
+# Limit to only `issues` or `pulls`
+# only: issues
+
+# Add a label when locking. Set to `false` to disable
+lockLabel: false

.github/move.yml

@@ -0,0 +1,20 @@
+---
+# Delete the command comment when it contains no other content
+deleteCommand: true
+
+# Close the source issue after moving
+closeSourceIssue: true
+
+# Lock the source issue after moving
+lockSourceIssue: true
+
+# Mention issue and comment authors
+mentionAuthors: true
+
+# Preserve mentions in the issue content
+keepContentMentions: false
+
+# Set custom aliases for targets
+# aliases:
+#   r: repo
+#   or: owner/repo

.github/no-response.yml

@@ -0,0 +1,13 @@
+---
+# Configuration for probot-no-response - https://github.com/probot/no-response
+# Number of days of inactivity before an Issue is closed for lack of response
+daysUntilClose: 14
+# Label requiring a response
+responseRequiredLabel: "Status: Awaiting response"
+# Comment to post when closing an Issue for lack of response. Set to `false` to disable
+closeComment: >
+  This issue has been automatically closed because there has been no response
+  to our request for more information from the original author. With only the
+  information that is currently in the issue, we don't have enough information
+  to take action. Please reach out if you have or find the answers we need so
+  that we can investigate further.

.github/potential-duplicates.yml

@@ -0,0 +1,14 @@
+---
+# Label name and color to set, when potential duplicates are detected
+issueLabel: "Potential duplicate"
+labelColor: e6e6e6
+
+# If similarity is higher than this threshold, issue will be marked as duplicate
+threshold: 0.70
+
+# Comment to post when potential duplicates are detected
+referenceComment: >
+  Potential duplicates found:
+  {{#issues}}
+    - [#{{ number }}] {{ title }} ({{ accuracy }}%)
+  {{/issues}}

.github/settings.yml

@@ -0,0 +1,150 @@
+---
+repository:
+  description: "JupyterLab Lite - Community Hass.io Add-on for Home Assistant"
+  homepage: https://addons.community
+  topics: jupyter, jupyterlab, hassio-addons, hassio, hass, home-assistant, homeassistant
+  private: false
+  has_issues: true
+  has_projects: false
+  has_wiki: false
+  has_downloads: false
+  default_branch: master
+  allow_squash_merge: true
+  allow_merge_commit: false
+  allow_rebase_merge: true
+labels:
+  # Priority labels
+  - name: "Priority: Critical"
+    color: ee0701
+    description: "This should be dealt with ASAP. Not fixing this issue would be a serious error."
+  - name: "Priority: High"
+    color: b60205
+    description: "After critical issues are fixed, these should be dealt with before any further issues."
+  - name: "Priority: Medium"
+    color: 0e8a16
+    description: "This issue may be useful, and needs some attention."
+  - name: "Priority: Low"
+    color: e4ea8a
+    description: "Nice addition, maybe... someday..."
+
+  # Type labels
+  - name: "Type: Bug"
+    color: ee0701
+    description: "Inconsistencies or issues which will cause a problem for users or implementors."
+  - name: "Type: Documentation"
+    color: 0052cc
+    description: "Solely about the documentation of the project."
+  - name: "Type: Enhancement"
+    color: 1d76db
+    description: "Enhancement of the code, not introducing new features."
+  - name: "Type: Feature"
+    color: 0e8a16
+    description: "New features or options."
+  - name: "Type: Support"
+    color: 5319e7
+    description: "Marks an issue as an support ticket."
+  - name: "Type: Discussion"
+    color: d4c5f9
+    description: "Marks an issue as an generic discussion ticket."
+  - name: "Type: Maintaince"
+    color: 2af79e
+    description: "Generic maintaince tasks, e.g., package updates."
+
+  # Additional markers
+  - name: "Security"
+    color: ee0701
+    description: "Marks an security issues that needs to be resolved asap."
+  - name: "Idea"
+    color: fef2c0
+    description: "Marks an idea, which might be excepted and implemented."
+  - name: "Incomplete"
+    color: fef2c0
+    description: "Marks an PR or issue that is missing information."
+  - name: "Pull request"
+    color: fbca04
+    description: "There is an PR opened for this issue."
+  - name: "Accepted"
+    color: c2e0c6
+    description: "This issue or PR has been accepted."
+  - name: "Declined"
+    color: f9d0c4
+    description: "This issue or PR has been declined."
+  - name: "Potential duplicate"
+    color: e6e6e6
+    description: "This issue has been automatically marked as a potential duplicate."
+
+  # Ongoing Status labels
+  - name: "Status: Triage"
+    color: fbca04
+    description: "This issue needs to be triaged."
+  - name: "Status: On hold"
+    color: cccccc
+    description: "Issue or PR that has been placed on hold for now."
+  - name: "Status: In progress"
+    color: fbca04
+    description: "Issue is currently being resolved by a developer."
+  - name: "Status: Stale"
+    color: fef2c0
+    description: "There has not been activity on this issue or PR for quite some time."
+  - name: "Status: Awaiting response"
+    color: fef2c0
+    description: "Issue or PR awaits response from the creator."
+  - name: "Status: Blocked"
+    color: fef2c0
+    description: "Progress on this issue is currently not possible."
+
+  # Closing status labels
+  - name: "Closed: Known limitation"
+    color: e6e6e6
+    description: "Issue is closed, it is a known limitation."
+  - name: "Closed: Expected behavior"
+    color: e6e6e6
+    description: "Issues is closed, it is expected behavior."
+  - name: "Closed: Duplicate"
+    color: e6e6e6
+    description: "Issue is closed, duplicate of an existing issue."
+  - name: "Closed: Invalid"
+    color: e6e6e6
+    description: "Issue is closed, marked as not a valid issue (e.g., an user error)."
+  - name: "Closed: Wrong repository"
+    color: e6e6e6
+    description: "Issue is closed, was created in the wrong repository."
+  - name: "Closed: Won't Fix"
+    color: e6e6e6
+    description: "Issue is closed, it won't be fixed."
+  - name: "Closed: Done"
+    color: c2e0c6
+    description: "Issue closed, work on this issue has been marked complete."
+
+  # Others
+  - name: "Beginner Friendly"
+    color: 0e8a16
+    description: "Good first issue for people wanting to contribute to the project."
+  - name: "Help wanted"
+    color: 0e8a16
+    description: "We need some extra helping hands or expertise in order to resolve this."
+  - name: "Hacktoberfest"
+    description: "Issues/PRs are participating in the Hacktoberfest"
+    color: fbca04
+
+branches:
+  - name: master
+    protection:
+      required_pull_request_reviews:
+        # required_approving_review_count: 1
+        dismiss_stale_reviews: true
+        require_code_owner_reviews: true
+        dismissal_restrictions:
+          users: []
+          teams:
+            - Admins
+            - Masters
+      required_status_checks:
+        strict: false
+        contexts: []
+      enforce_admins: false
+      restrictions:
+        users: []
+        teams:
+          - Admins
+          - Masters

.github/stale.yml

@@ -0,0 +1,61 @@
+---
+# Configuration for probot-stale - https://github.com/probot/stale
+
+# Number of days of inactivity before an Issue or Pull Request becomes stale
+daysUntilStale: 60
+
+# Number of days of inactivity before a stale Issue or Pull Request is closed.
+# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.
+daysUntilClose: 7
+
+# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
+exemptLabels:
+  - "Status: On hold"
+  - "Status: In progress"
+  - "Status: Awaiting response"
+  - "Status: Blocked"
+  - "Idea"
+  - "Security"
+
+# Set to true to ignore issues in a project (defaults to false)
+exemptProjects: false
+
+# Set to true to ignore issues in a milestone (defaults to false)
+exemptMilestones: false
+
+# Label to use when marking as stale
+staleLabel: "Status: Stale"
+
+# Comment to post when marking as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+
+# Comment to post when removing the stale label.
+# unmarkComment: >
+#   Your comment here.
+unmarkComment: false
+
+# Comment to post when closing a stale Issue or Pull Request.
+# closeComment: >
+#   Your comment here.
+closeComment: false
+
+# Limit the number of actions per hour, from 1-30. Default is 30
+limitPerRun: 30
+
+# Limit to only `issues` or `pulls`
+only: issues
+
+# Optionally, specify configuration settings that are specific to just 'issues' or 'pulls':
+# pulls:
+#   daysUntilStale: 30
+#   markComment: >
+#     This pull request has been automatically marked as stale because it has not had
+#     recent activity. It will be closed if no further activity occurs. Thank you
+#     for your contributions.
+
+# issues:
+#   exemptLabels:
+#     - confirmed

.github/support.yml

@@ -0,0 +1,22 @@
+---
+# Configuration for support-requests - https://github.com/dessant/support-requests
+
+# Label used to mark issues as support requests
+supportLabel: "Type: Support"
+
+# Comment to post on issues marked as support requests. Add a link
+# to a support page, or set to `false` to disable
+supportComment: >
+  :wave: We use the issue tracker exclusively for bug reports and feature requests.
+  However, this issue appears to be a support request. Please use our
+  support channels to get help with the project.
+
+  Head over to the
+  [Home Assistant community forum](https://community.home-assistant.io/?u=frenck)
+  or join our [Discord](https://discord.gg/c5DvZ4e) chat.
+
+# Close issues marked as support requests
+close: true
+
+# Lock issues marked as support requests
+lock: false

.gitlab-ci.yml

@@ -0,0 +1,365 @@
+---
+image: docker:latest
+
+variables:
+  ADDON_GITHUB_REPO: hassio-addons/addon-jupyterlab-lite
+  ADDON_SLUG: jupyterlablite
+  ADDON_TARGET: jupyterlab
+  DOCKER_DRIVER: overlay2
+  DOCKER_HUB_ORG: hassioaddons
+
+stages:
+  - preflight
+  - build
+  - deploy
+  - manifest
+  - publish
+
+# Generic DIND template
+.dind: &dind
+  before_script:
+    - docker info
+  services:
+    - name: docker:dind
+      command: ["--experimental"]
+
+# Generic preflight template
+.preflight: &preflight
+  stage: preflight
+  tags:
+    - preflight
+
+# Generic build template
+.build: &build
+  <<: *dind
+  stage: build
+  before_script:
+    - docker info
+    - |
+      if [ "$(apk --print-arch)" = "amd64" ]; then
+        docker run --rm --privileged hassioaddons/qemu-user-static:latest
+      fi
+    - |
+      echo "${CI_JOB_TOKEN}" | docker login \
+        --username gitlab-ci-token \
+        --password-stdin \
+        registry.gitlab.com
+    - docker pull "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:cache" || true
+  script:
+    - |
+      docker build \
+        --build-arg "BUILD_FROM=${FROM}" \
+        --build-arg "BUILD_DATE=$(date +"%Y-%m-%dT%H:%M:%SZ")" \
+        --build-arg "BUILD_ARCH=${ADDON_ARCH}" \
+        --build-arg "BUILD_REF=${CI_COMMIT_SHA}" \
+        --build-arg "BUILD_VERSION=${CI_COMMIT_TAG:-${CI_COMMIT_SHA:0:7}}" \
+        --cache-from "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:cache" \
+        --tag \
+          "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:${CI_COMMIT_SHA}" \
+        "${ADDON_TARGET}"
+    - |
+      docker push \
+        "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:${CI_COMMIT_SHA}"
+
+# Generic deploy template
+.deploy: &deploy
+  <<: *dind
+  stage: deploy
+  before_script:
+    - docker info
+    - docker pull "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:${CI_COMMIT_SHA}"
+    - |
+      echo "${CI_JOB_TOKEN}" | docker login \
+        --username gitlab-ci-token \
+        --password-stdin \
+        registry.gitlab.com
+    - |
+      echo "${DOCKER_PASSWORD}" | docker login \
+        --username "${DOCKER_LOGIN}" \
+        --password-stdin
+  script:
+    - |
+      docker tag \
+        "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:${CI_COMMIT_SHA}" \
+        "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:cache"
+    - docker push "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:cache"
+    - TAG="${CI_COMMIT_TAG#v}"
+    - TAG="${TAG:-${CI_COMMIT_SHA:0:7}}"
+    - |
+      docker tag \
+        "registry.gitlab.com/${CI_PROJECT_PATH}/${ADDON_ARCH}:${CI_COMMIT_SHA}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${ADDON_ARCH}-${TAG}"
+    - |
+      docker push \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${ADDON_ARCH}-${TAG}"
+  tags:
+    - deploy
+  only:
+    - master
+    - /^v\d+\.\d+\.\d+(?:-(?:beta|rc)(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?)?$/
+  except:
+    - /^(?!master).+@/
+
+# Generic manifest template
+.manifest: &manifest
+  <<: *dind
+  stage: manifest
+  before_script:
+    - mkdir -p ~/.docker
+    - echo '{"experimental":"enabled"}' > ~/.docker/config.json
+    - docker info
+    - |
+      echo "${DOCKER_PASSWORD}" | docker login \
+        --username "${DOCKER_LOGIN}" \
+        --password-stdin
+  script:
+    - TAG="${TAG#v}"
+    - TAG="${TAG:-${CI_COMMIT_SHA:0:7}}"
+    - REF="${CI_COMMIT_TAG#v}"
+    - REF="${REF:-${CI_COMMIT_SHA:0:7}}"
+    - |
+      docker manifest create \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:aarch64-${REF}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:amd64-${REF}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:armhf-${REF}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:i386-${REF}"
+    - |
+      docker manifest annotate \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:aarch64-${REF}" \
+        --os=linux \
+        --arch=arm64 \
+        --variant=v8
+    - |
+      docker manifest annotate \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:amd64-${REF}" \
+        --os=linux \
+        --arch=amd64
+    - |
+      docker manifest annotate \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:armhf-${REF}" \
+        --os=linux \
+        --arch=arm \
+        --variant=v6
+    - |
+      docker manifest annotate \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}" \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:i386-${REF}" \
+        --os=linux \
+        --arch=386
+    - |
+      docker manifest push \
+        "${DOCKER_HUB_ORG}/${ADDON_SLUG}:${TAG}"
+  tags:
+    - manifest
+  except:
+    - /^(?!master).+@/
+
+# Generic publish template
+.publish: &publish
+  stage: publish
+  image:
+    name: hassioaddons/repository-updater:latest
+    entrypoint: [""]
+  script:
+    - |
+      repository-updater \
+        --token "${GITHUB_TOKEN}" \
+        --repository "${REPOSITORY}" \
+        --addon "${ADDON_GITHUB_REPO}"
+  tags:
+    - publish
+  except:
+    - /^(?!master).+@/
+
+# Preflight jobs
+hadolint:
+  <<: *preflight
+  image: hadolint/hadolint:latest-debian
+  before_script:
+    - hadolint --version
+  script:
+    - hadolint "${ADDON_TARGET}/Dockerfile"
+
+shellcheck:
+  <<: *preflight
+  image:
+    name: koalaman/shellcheck-alpine:stable
+    entrypoint: [""]
+  before_script:
+    - shellcheck --version
+    - apk --no-cache add grep
+    - |
+      find . -type f -print0 | \
+        xargs -0 sed -i 's:#!/usr/bin/with-contenv bash:#!/bin/bash:g'
+  script:
+    - |
+      for file in $(grep -IRl "#\!\(/usr/bin/env \|/bin/\)" --exclude-dir ".git" "${ADDON_TARGET}"); do
+        if ! shellcheck $file; then
+          export FAILED=1
+        else
+          echo "$file OK"
+        fi
+      done
+      if [ "${FAILED}" = "1" ]; then
+        exit 1
+      fi
+
+yamllint:
+  <<: *preflight
+  image: sdesbure/yamllint
+  before_script:
+    - yamllint --version
+  script:
+    - yamllint .
+
+jsonlint:
+  <<: *preflight
+  image: sahsu/docker-jsonlint
+  before_script:
+    - jsonlint --version || true
+  script:
+    - |
+      for file in $(find . -type f -name "*.json"); do
+        if ! jsonlint -q $file; then
+          export FAILED=1
+        else
+          echo "$file OK"
+        fi
+      done
+      if [ "${FAILED}" = "1" ]; then
+        exit 1
+      fi
+markdownlint:
+  <<: *preflight
+  image:
+    name: ruby:alpine
+    entrypoint: [""]
+  before_script:
+    - gem install mdl
+    - mdl --version
+  script:
+    - mdl --style all --warnings .
+
+# Build Jobs
+build:armhf:
+  <<: *build
+  variables:
+    ADDON_ARCH: armhf
+    FROM: hassioaddons/ubuntu-base-armhf:2.2.0
+  tags:
+    - build
+    - armhf
+
+build:aarch64:
+  <<: *build
+  variables:
+    ADDON_ARCH: aarch64
+    FROM: hassioaddons/ubuntu-base-aarch64:2.2.0
+  tags:
+    - build
+    - aarch64
+
+build:i386:
+  <<: *build
+  variables:
+    ADDON_ARCH: i386
+    FROM: hassioaddons/ubuntu-base-i386:2.2.0
+  tags:
+    - build
+    - i386
+
+build:amd64:
+  <<: *build
+  variables:
+    ADDON_ARCH: amd64
+    FROM: hassioaddons/ubuntu-base-amd64:2.2.0
+  tags:
+    - build
+    - amd64
+
+# Deploy jobs
+deploy:armhf:
+  <<: *deploy
+  variables:
+    ADDON_ARCH: armhf
+
+deploy:aarch64:
+  <<: *deploy
+  variables:
+    ADDON_ARCH: aarch64
+
+deploy:i386:
+  <<: *deploy
+  variables:
+    ADDON_ARCH: i386
+
+deploy:amd64:
+  <<: *deploy
+  variables:
+    ADDON_ARCH: amd64
+
+# Manifest jobs
+manifest:sha:
+  <<: *manifest
+  only:
+    - master
+
+manifest:version:
+  <<: *manifest
+  variables:
+    TAG: "${CI_COMMIT_TAG}"
+  only:
+    - /^v\d+\.\d+\.\d+(?:-(?:beta|rc)(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?)?$/
+
+manifest:stable:
+  <<: *manifest
+  variables:
+    TAG: latest
+  only:
+    - /^v\d+\.\d+\.\d+(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?$/
+
+manifest:beta:
+  <<: *manifest
+  variables:
+    TAG: beta
+  only:
+    - /^v\d+\.\d+\.\d+(?:-(?:beta|rc)(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?)?$/
+
+manifest:edge:
+  <<: *manifest
+  variables:
+    TAG: edge
+  only:
+    - master
+
+# Publish jobs
+publish:stable:
+  <<: *publish
+  variables:
+    REPOSITORY: hassio-addons/repository
+  only:
+    - /^v\d+\.\d+\.\d+(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?$/
+  environment:
+    name: stable
+
+publish:beta:
+  <<: *publish
+  variables:
+    REPOSITORY: hassio-addons/repository-beta
+  only:
+    - /^v\d+\.\d+\.\d+(?:-(?:beta|rc)(?:(?:(?:\+|\.)?[a-zA-Z0-9]+)*)?)?$/
+  environment:
+    name: beta
+
+publish:edge:
+  <<: *publish
+  variables:
+    REPOSITORY: hassio-addons/repository-edge
+  only:
+    - master
+  environment:
+    name: edge

.mdlrc

@@ -0,0 +1 @@
+rules "~MD024"

.yamllint

@@ -0,0 +1,66 @@
+---
+rules:
+  braces:
+    level: error
+    min-spaces-inside: 0
+    max-spaces-inside: 1
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1
+  brackets:
+    level: error
+    min-spaces-inside: 0
+    max-spaces-inside: 0
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1
+  colons:
+    level: error
+    max-spaces-before: 0
+    max-spaces-after: 1
+  commas:
+    level: error
+    max-spaces-before: 0
+    min-spaces-after: 1
+    max-spaces-after: 1
+  comments:
+    level: error
+    require-starting-space: true
+    min-spaces-from-content: 2
+  comments-indentation:
+    level: error
+  document-end:
+    level: error
+    present: false
+  document-start:
+    level: error
+    present: true
+  empty-lines:
+    level: error
+    max: 1
+    max-start: 0
+    max-end: 1
+  hyphens:
+    level: error
+    max-spaces-after: 1
+  indentation:
+    level: error
+    spaces: 2
+    indent-sequences: true
+    check-multi-line-strings: false
+  key-duplicates:
+    level: error
+  line-length:
+    ignore: |
+      .github/support.yml
+    level: warning
+    max: 120
+    allow-non-breakable-words: true
+    allow-non-breakable-inline-mappings: true
+  new-line-at-end-of-file:
+    level: error
+  new-lines:
+    level: error
+    type: unix
+  trailing-spaces:
+    level: error
+  truthy:
+    level: error

CHANGELOG.md

@@ -0,0 +1,13 @@
+# Community Hass.io Add-ons: JupyterLab Lite
+
+All notable changes to this add-on will be documented in this file.
+
+The format is based on [Keep a Changelog][keep-a-changelog]
+and this project adheres to [Semantic Versioning][semantic-versioning].
+
+## Unreleased
+
+No are unreleased changes yet.
+
+[keep-a-changelog]: http://keepachangelog.com/en/1.0.0/
+[semantic-versioning]: http://semver.org/spec/v2.0.0.html

CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Code of conduct
+
+## Our pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention
+  or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or
+  electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate
+  in a professional setting
+
+## Our responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project lead at frenck@addons.community. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project lead is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing
+
+When contributing to this repository, please first discuss the change you wish
+to make via issue, email, or any other method with the owners of this repository
+before making a change.
+
+Please note we have a code of conduct, please follow it in all your interactions
+with the project.
+
+## Issues and feature requests
+
+You've found a bug in the source code, a mistake in the documentation or maybe
+you'd like a new feature? You can help us by submitting an issue to our
+[GitHub Repository][github]. Before you create an issue, make sure you search
+the archive, maybe your question was already answered.
+
+Even better: You could submit a pull request with a fix / new feature!
+
+## Pull request process
+
+1. Search our repository for open or closed [pull requests][prs] that relates
+   to your submission. You don't want to duplicate effort.
+
+1. You may merge the pull request in once you have the sign-off of two other
+   developers, or if you do not have permission to do that, you may request
+   the second reviewer to merge it for you.
+
+[github]: https://github.com/hassio-addons/addon-jupyterlab-lite/issues
+[prs]: https://github.com/hassio-addons/addon-jupyterlab-lite/pulls

LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2018 Franck Nijhof
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,324 @@
+# Community Hass.io Add-ons: JupyterLab Lite
+
+[![GitHub Release][releases-shield]][releases]
+![Project Stage][project-stage-shield]
+[![License][license-shield]](LICENSE.md)
+
+[![GitLab CI][gitlabci-shield]][gitlabci]
+![Project Maintenance][maintenance-shield]
+[![GitHub Activity][commits-shield]][commits]
+
+[![Bountysource][bountysource-shield]][bountysource]
+[![Discord][discord-shield]][discord]
+[![Community Forum][forum-shield]][forum]
+
+[![Buy me a coffee][buymeacoffee-shield]][buymeacoffee]
+
+Create documents containing live code, equations, visualizations,
+and explanatory text.
+
+## About
+
+JupyterLab is an open-source web application that allows you to create and share
+documents that contain live code, equations, visualizations and narrative text.
+Uses include: data cleaning and transformation, numerical simulation,
+statistical modeling, data visualization, machine learning, and much more.
+
+This add-on runs JupyterLab, which is the next-generation user interface for
+Project Jupyter. It is an extensible environment for interactive and
+reproducible computing, based on the Jupyter Notebook and Architecture.
+
+## Installation
+
+The installation of this add-on is pretty straightforward and not different in
+comparison to installing any other Hass.io add-on.
+
+1. [Add our Hass.io add-ons repository][repository] to your Hass.io instance.
+1. Install the "JupyterLab Lite" add-on.
+1. Start the "JupyterLab Lite" add-on
+1. Check the logs of the "JupyterLab Lite" add-on to see if everything went well.
+
+**NOTE**: Do not add this repository to Hass.io, please use:
+`https://github.com/hassio-addons/repository`.
+
+## Docker status
+
+[![Docker Architecture][armhf-arch-shield]][armhf-dockerhub]
+[![Docker Version][armhf-version-shield]][armhf-microbadger]
+[![Docker Layers][armhf-layers-shield]][armhf-microbadger]
+[![Docker Pulls][armhf-pulls-shield]][armhf-dockerhub]
+
+[![Docker Architecture][aarch64-arch-shield]][aarch64-dockerhub]
+[![Docker Version][aarch64-version-shield]][aarch64-microbadger]
+[![Docker Layers][aarch64-layers-shield]][aarch64-microbadger]
+[![Docker Pulls][aarch64-pulls-shield]][aarch64-dockerhub]
+
+[![Docker Architecture][amd64-arch-shield]][amd64-dockerhub]
+[![Docker Version][amd64-version-shield]][amd64-microbadger]
+[![Docker Layers][amd64-layers-shield]][amd64-microbadger]
+[![Docker Pulls][amd64-pulls-shield]][amd64-dockerhub]
+
+[![Docker Architecture][i386-arch-shield]][i386-dockerhub]
+[![Docker Version][i386-version-shield]][i386-microbadger]
+[![Docker Layers][i386-layers-shield]][i386-microbadger]
+[![Docker Pulls][i386-pulls-shield]][i386-dockerhub]
+
+## Configuration
+
+**Note**: _Remember to restart the add-on when the configuration is changed._
+
+Example add-on configuration:
+
+```json
+{
+    "log_level": "info",
+    "password": "omgpuppies",
+    "github_access_token": "abcdef1234567890abcdef0123456789abcdef01",
+    "ssl": true,
+    "certfile": "fullchain.pem",
+    "keyfile": "privkey.pem",
+    "system_packages": [
+      "ffmpeg"
+    ],
+    "python_packages": [
+      "nltk"
+    ]
+```
+
+**Note**: _This is just an example, don't copy and past it! Create your own!_
+
+### Option: `log_level`
+
+The `log_level` option controls the level of log output by the addon and can
+be changed to be more or less verbose, which might be useful when you are
+dealing with an unknown issue. Possible values are:
+
+- `trace`: Show every detail, like all called internal functions.
+- `debug`: Shows detailed debug information.
+- `info`: Normal (usually) interesting events.
+- `warning`: Exceptional occurrences that are not errors.
+- `error`:  Runtime errors that do not require immediate action.
+- `fatal`: Something went terribly wrong. Add-on becomes unusable.
+
+Please note that each level automatically includes log messages from a
+more severe level, e.g., `debug` also shows `info` messages. By default,
+the `log_level` is set to `info`, which is the recommended setting unless
+you are troubleshooting.
+
+### Option: `password`
+
+Sets the password to authenticate with JupyterLab. Leaving the password
+empty, will disable password authentication.
+
+### Option: `github_access_token`
+
+Sets an GitHub access token. When making unauthenticated requests to GitHub
+(as we must do to get repository data), GitHub imposes fairly strict rate-limits
+on how many requests we can make. As such, you are likely to hit that limit
+within a few minutes of work.
+
+There is a chapter in this document with instruction on obtaining such a token.
+
+### Option: `ssl`
+
+Enables/Disables SSL (HTTPS) on the web terminal. Set it `true` to enable it,
+`false` otherwise.
+
+### Option: `certfile`
+
+The certificate file to use for SSL.
+
+**Note**: _The file MUST be stored in `/ssl/`, which is default for Hass.io_
+
+### Option: `keyfile`
+
+The private key file to use for SSL.
+
+**Note**: _The file MUST be stored in `/ssl/`, which is default for Hass.io_
+
+### Option: `system_packages`
+
+Allows you to specify additional [Alpine packages][alpine-packages] to be
+installed to your Jupyter setup (e.g., `g++`. `make`, `ffmpeg`).
+
+**Note**: _Adding many packages will result in a longer start-up time
+for the add-on._
+
+### Option: `python_packages`
+
+Allows you to specify additional [Python packages][python-packages] to be
+installed to your Jupyter setup (e.g., `PyMySQL`. `Requests`, `Pillow`).
+
+**Note**: _Adding many packages will result in a longer start-up time
+for the add-on._
+
+## Embedding into Home Assistant
+
+It is possible to embed Jupyter directly into Home Assistant, allowing
+you to access the JupyterLab through the Home Assistant frontend.
+
+Home Assistant provides the `panel_iframe` component, for these purposes.
+
+Example configuration:
+
+```yaml
+panel_iframe:
+  jupyter:
+    title: JupyterLab
+    icon: mdi:flask
+    url: https://addres.to.your.hass.io:8888
+```
+
+## Getting a GitHub access token
+
+You can get an access token by following these steps:
+
+1. [Verify][github-verify] your email address with GitHub.
+1. Go to your account settings on GitHub and select "Developer Settings"
+   from the left panel.
+1. On the left, select "Personal access tokens"
+1. Click the "Generate new token" button, and enter your password.
+1. Give the token a description, and check the "**repo**" scope box.
+1. Click "Generate token"
+1. You should be given a string which will be your access token.
+
+Remember that this token is effectively a password for your GitHub account.
+*Do not* share it online or check the token into version control,
+as people can use it to access all of your data on GitHub.
+
+## Changelog & Releases
+
+This repository keeps a change log using [GitHub's releases][releases]
+functionality. The format of the log is based on
+[Keep a Changelog][keepchangelog].
+
+Releases are based on [Semantic Versioning][semver], and use the format
+of ``MAJOR.MINOR.PATCH``. In a nutshell, the version will be incremented
+based on the following:
+
+- ``MAJOR``: Incompatible or major changes.
+- ``MINOR``: Backwards-compatible new features and enhancements.
+- ``PATCH``: Backwards-compatible bugfixes and package updates.
+
+## Support
+
+Got questions?
+
+You have several options to get them answered:
+
+- The Home Assistant [Community Forum][forum], we have a
+  [dedicated topic][forum] on that forum regarding this add-on.
+- The Home Assistant [Discord Chat Server][discord] for general Home Assistant
+  discussions and questions.
+- Join the [Reddit subreddit][reddit] in [/r/homeassistant][reddit]
+
+You could also [open an issue here][issue] GitHub.
+
+## Contributing
+
+This is an active open-source project. We are always open to people who want to
+use the code or contribute to it.
+
+We have set up a separate document containing our
+[contribution guidelines](CONTRIBUTING.md).
+
+Thank you for being involved! :heart_eyes:
+
+## Authors & contributors
+
+The original setup of this repository is by [Franck Nijhof][frenck].
+
+For a full list of all authors and contributors,
+check [the contributor's page][contributors].
+
+## We have got some Hass.io add-ons for you
+
+Want some more functionality to your Hass.io Home Assistant instance?
+
+We have created multiple add-ons for Hass.io. For a full list, check out
+our [GitHub Repository][repository].
+
+## License
+
+MIT License
+
+Copyright (c) 2018 Franck Nijhof
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+[aarch64-anchore-shield]: https://img.shields.io/badge/lorem-ipsum-red.svg
+[aarch64-anchore]: http://example.com
+[aarch64-arch-shield]: https://img.shields.io/badge/architecture-aarch64-blue.svg
+[aarch64-dockerhub]: https://hub.docker.com/r/hassioaddons/jupyterlablite-aarch64
+[aarch64-layers-shield]: https://images.microbadger.com/badges/image/hassioaddons/jupyterlablite-aarch64.svg
+[aarch64-microbadger]: https://microbadger.com/images/hassioaddons/jupyterlablite-aarch64
+[aarch64-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/jupyterlablite-aarch64.svg
+[aarch64-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/jupyterlablite-aarch64.svg
+[alpine-packages]: https://pkgs.alpinelinux.org/packages
+[amd64-anchore-shield]: https://img.shields.io/badge/lorem-ipsum-red.svg
+[amd64-anchore]: https://anchore.io/image/dockerhub/hassioaddons%jupyterlablite-amd64%3Alatest
+[amd64-arch-shield]: https://img.shields.io/badge/architecture-amd64-blue.svg
+[amd64-dockerhub]: https://hub.docker.com/r/hassioaddons/jupyterlablite-amd64
+[amd64-layers-shield]: https://images.microbadger.com/badges/image/hassioaddons/jupyterlablite-amd64.svg
+[amd64-microbadger]: https://microbadger.com/images/hassioaddons/jupyterlablite-amd64
+[amd64-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/jupyterlablite-amd64.svg
+[amd64-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/jupyterlablite-amd64.svg
+[armhf-anchore-shield]: https://img.shields.io/badge/lorem-ipsum-red.svg
+[armhf-anchore]: https://anchore.io/image/dockerhub/hassioaddons%jupyterlablite-armhf%3Alatest
+[armhf-arch-shield]: https://img.shields.io/badge/architecture-armhf-blue.svg
+[armhf-dockerhub]: https://hub.docker.com/r/hassioaddons/jupyterlablite-armhf
+[armhf-layers-shield]: https://images.microbadger.com/badges/image/hassioaddons/jupyterlablite-armhf.svg
+[armhf-microbadger]: https://microbadger.com/images/hassioaddons/jupyterlablite-armhf
+[armhf-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/jupyterlablite-armhf.svg
+[armhf-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/jupyterlablite-armhf.svg
+[bountysource-shield]: https://img.shields.io/bountysource/team/hassio-addons/activity.svg
+[bountysource]: https://www.bountysource.com/teams/hassio-addons/issues
+[buymeacoffee-shield]: https://www.buymeacoffee.com/assets/img/guidelines/download-assets-sm-2.svg
+[buymeacoffee]: https://www.buymeacoffee.com/frenck
+[commits-shield]: https://img.shields.io/github/commit-activity/y/hassio-addons/addon-jupyterlab-lite.svg
+[commits]: https://github.com/hassio-addons/addon-jupyterlab-lite/commits/master
+[contributors]: https://github.com/hassio-addons/addon-jupyterlab-lite/graphs/contributors
+[discord-shield]: https://img.shields.io/discord/330944238910963714.svg
+[discord]: https://discord.gg/c5DvZ4e
+[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg
+[forum]: https://community.home-assistant.io/?u=frenck
+[frenck]: https://github.com/frenck
+[github-verify]: https://help.github.com/articles/verifying-your-email-address
+[gitlabci-shield]: https://gitlab.com/hassio-addons/addon-jupyterlab-lite/badges/master/pipeline.svg
+[gitlabci]: https://gitlab.com/hassio-addons/addon-jupyterlab-lite/pipelines
+[home-assistant]: https://home-assistant.io
+[i386-anchore-shield]: https://img.shields.io/badge/lorem-ipsum-red.svg
+[i386-anchore]: https://anchore.io/image/dockerhub/hassioaddons%2Fjupyter-i386%3Alatest
+[i386-arch-shield]: https://img.shields.io/badge/architecture-i386-blue.svg
+[i386-dockerhub]: https://hub.docker.com/r/hassioaddons/jupyterlablite-i386
+[i386-layers-shield]: https://images.microbadger.com/badges/image/hassioaddons/jupyterlablite-i386.svg
+[i386-microbadger]: https://microbadger.com/images/hassioaddons/jupyterlablite-i386
+[i386-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/jupyterlablite-i386.svg
+[i386-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/jupyterlablite-i386.svg
+[issue]: https://github.com/hassio-addons/addon-jupyterlab-lite/issues
+[keepchangelog]: http://keepachangelog.com/en/1.0.0/
+[license-shield]: https://img.shields.io/github/license/hassio-addons/addon-jupyterlab-lite.svg
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2018.svg
+[project-stage-shield]: https://img.shields.io/badge/project%20stage-concept-red.svg
+[python-packages]: https://pypi.org/
+[reddit]: https://reddit.com/r/homeassistant
+[releases-shield]: https://img.shields.io/github/release/hassio-addons/addon-jupyterlab-lite.svg
+[releases]: https://github.com/hassio-addons/addon-jupyterlab-lite/releases
+[repository]: https://github.com/hassio-addons/repository
+[semver]: http://semver.org/spec/v2.0.0.htm

jupyterlab/.README.j2

@@ -0,0 +1,74 @@
+# Community Hass.io Add-ons: JupyterLab Lite
+
+[![Release][release-shield]][release] ![Project Stage][project-stage-shield] ![Project Maintenance][maintenance-shield]
+
+[![Discord][discord-shield]][discord] [![Community Forum][forum-shield]][forum]
+
+[![Buy me a coffee][buymeacoffee-shield]][buymeacoffee]
+
+Create documents containing live code, equations, visualizations,
+and explanatory text.
+
+## About
+
+JupyterLab is an open-source web application that allows you to create and share
+documents that contain live code, equations, visualizations and narrative text.
+Uses include: data cleaning and transformation, numerical simulation,
+statistical modeling, data visualization, machine learning, and much more.
+
+This add-on runs JupyterLab, which is the next-generation user interface for
+Project Jupyter. It is an extensible environment for interactive and
+reproducible computing, based on the Jupyter Notebook and Architecture.
+
+[Click here for the full documentation][docs]
+
+{% if channel == "edge" %}
+## WARNING! THIS IS AN EDGE VERSION!
+
+This Hass.io Add-ons repository contains edge builds of add-ons. Edge builds
+add-ons are based upon the latest development version.
+
+- They may not work at all.
+- They might stop working at any time.
+- They could have a negative impact on your system.
+
+This repository was created for:
+
+- Anybody willing to test.
+- Anybody interested in trying out upcoming add-ons or add-on features.
+- Developers.
+
+If you are more interested in stable releases of our add-ons:
+
+<https://github.com/hassio-addons/repository>
+
+{% endif %}
+{% if channel == "beta" %}
+## WARNING! THIS IS A BETA VERSION!
+
+This Hass.io Add-ons repository contains beta releases of add-ons.
+
+- They might stop working at any time.
+- They could have a negative impact on your system.
+
+This repository was created for:
+
+- Anybody willing to test.
+- Anybody interested in trying out upcoming add-ons or add-on features.
+
+If you are more interested in stable releases of our add-ons:
+
+<https://github.com/hassio-addons/repository>
+
+{% endif %}
+[buymeacoffee-shield]: https://www.buymeacoffee.com/assets/img/guidelines/download-assets-sm-2.svg
+[buymeacoffee]: https://www.buymeacoffee.com/frenck
+[discord-shield]: https://img.shields.io/discord/330944238910963714.svg
+[discord]: https://discord.gg/c5DvZ4e
+[docs]: {{ repo }}/blob/{{ version }}/README.md
+[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg
+[forum]: https://community.home-assistant.io/?u=frenck
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2018.svg
+[project-stage-shield]: https://img.shields.io/badge/project%20stage-concept-red.svg
+[release-shield]: https://img.shields.io/badge/version-{{ version }}-blue.svg
+[release]: {{ repo }}/tree/{{ version }}

jupyterlab/Dockerfile

@@ -0,0 +1,125 @@
+ARG BUILD_FROM=hassioaddons/ubuntu-base:2.2.0
+# hadolint ignore=DL3006
+FROM ${BUILD_FROM}
+
+# Set shell
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+
+# Copy Python requirements file
+COPY requirements.txt /opt/
+
+# Setup base
+# hadolint ignore=DL3018
+ARG BUILD_ARCH
+RUN \
+    MAKEFLAGS="-j$(nproc)" \
+    && export MAKEFLAGS \
+    \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        build-essential=12.4ubuntu1 \
+        dirmngr=2.2.4-1ubuntu1.1 \
+        git=1:2.17.1-1ubuntu0.4 \
+        gpg-agent=2.2.4-1ubuntu1.1 \
+        gpg=2.2.4-1ubuntu1.1 \
+        libffi-dev=3.2.1-8 \
+        libffi6=3.2.1-8 \
+        libfreetype6-dev=2.8.1-2ubuntu2 \
+        libfreetype6=2.8.1-2ubuntu2 \
+        libjpeg-turbo8-dev=1.5.2-0ubuntu5.18.04.1 \
+        libpng-dev=1.6.34-1ubuntu0.18.04.1 \
+        libpng16-16=1.6.34-1ubuntu0.18.04.1 \
+        libssl-dev=1.1.0g-2ubuntu4.1 \
+        libtiff5-dev=4.0.9-5 \
+        libxml2-dev=2.9.4+dfsg1-6.1ubuntu1.2 \
+        libxml2=2.9.4+dfsg1-6.1ubuntu1.2 \
+        libxslt1-dev=1.1.29-5 \
+        libxslt1.1=1.1.29-5 \
+        libzmq3-dev=4.2.5-1 \
+        libzmq5=4.2.5-1 \
+        pandoc=1.19.2.4~dfsg-1build4 \
+        pkg-config=0.29.1-0ubuntu2 \
+        python-dev=2.7.15~rc1-1 \
+        python3-dev=3.6.7-1~18.04 \
+        python3-distutils=3.6.7-1~18.04 \
+        python3=3.6.7-1~18.04 \
+        zlib1g-dev=1:1.2.11.dfsg-0ubuntu2 \
+    \
+    && curl -sL https://deb.nodesource.com/setup_8.x | bash - \
+    \
+    && apt-get install -y --no-install-recommends \
+        nodejs=8.14.0-1nodesource1 \
+    \
+    && curl https://bootstrap.pypa.io/get-pip.py | python3 \
+    \
+    && pip3 install --no-cache-dir -r /opt/requirements.txt \
+    \
+    && jupyter labextension install \
+        @jupyter-widgets/jupyterlab-manager@0.38 --no-build \
+    && jupyter labextension install jupyterlab_bokeh --no-build \
+    && jupyter labextension install @jupyterlab/github --no-build \
+    && jupyter labextension install @jupyterlab/git --no-build \
+    && jupyter labextension install plotlywidget@0.5.2 --no-build \
+    && jupyter labextension install \
+        @jupyterlab/plotly-extension@0.18.1 --no-build \
+    && jupyter labextension install jupyterlab-chart-editor@1.0 --no-build \
+    && jupyter lab build \
+    \
+    && apt-get purge -y --auto-remove \
+        build-essential \
+        dirmngr \
+        gpg \
+        gpg-agent \
+        libffi-dev \
+        libfreetype6-dev \
+        libjpeg-turbo8-dev \
+        libpng-dev \
+        libssl-dev \
+        libtiff5-dev \
+        libxml2-dev \
+        libxslt1-dev \
+        libzmq3-dev \
+        pkg-config \
+        python-dev \
+        python3-dev \
+        zlib1g-dev \
+    \
+    && find /usr/local/lib/python3.6/ -type d -name tests -depth -exec rm -rf {} \; \
+    && find /usr/local/lib/python3.6/ -type d -name test -depth -exec rm -rf {} \; \
+    && find /usr/local/lib/python3.6/ -name __pycache__ -depth -exec rm -rf {} \; \
+    && find /usr/local/lib/python3.6/ -name "*.pyc" -depth -exec rm -f {} \; \
+    \
+    && npm cache clean --force \
+    \
+    && rm -fr \
+        /tmp/* \
+        /root/{.cache,.config,.gnupg,.local,.log,.npm} \
+        /usr/local/share/.cache \
+        /var/{cache,log}/* \
+        /var/lib/apt/lists/*
+
+# Copy root filesystem
+COPY rootfs /
+
+# Build arugments
+ARG BUILD_DATE
+ARG BUILD_REF
+ARG BUILD_VERSION
+
+# Labels
+LABEL \
+    io.hass.name="JupyterLab Lite" \
+    io.hass.description="Create and share documents that contain live code, equations, visualizations, and explanatory text directly in your browser" \
+    io.hass.arch="${BUILD_ARCH}" \
+    io.hass.type="addon" \
+    io.hass.version=${BUILD_VERSION} \
+    maintainer="Franck Nijhof <frenck@addons.community>" \
+    org.label-schema.description="Create and share documents that contain live code, equations, visualizations, and explanatory text directly in your browser" \
+    org.label-schema.build-date=${BUILD_DATE} \
+    org.label-schema.name="JupyterLab Lite" \
+    org.label-schema.schema-version="1.0" \
+    org.label-schema.url="https://addons.community" \
+    org.label-schema.usage="https://github.com/hassio-addons/addon-jupyterlab-lite/tree/master/README.md" \
+    org.label-schema.vcs-ref=${BUILD_REF} \
+    org.label-schema.vcs-url="https://github.com/hassio-addons/addon-jupyterlab-lite" \
+    org.label-schema.vendor="Community Hass.io Add-ons"

jupyterlab/build.json

@@ -0,0 +1,9 @@
+{
+    "build_from": {
+        "aarch64": "hassioaddons/ubuntu-base-aarch64:2.2.0",
+        "amd64": "hassioaddons/ubuntu-base-amd64:2.2.0",
+        "armhf": "hassioaddons/ubuntu-base-armhf:2.2.0",
+        "i386": "hassioaddons/ubuntu-base-i386:2.2.0"
+    },
+    "args": {}
+}

jupyterlab/config.json

@@ -0,0 +1,65 @@
+{
+  "name": "JupyterLab Lite",
+  "version": "dev",
+  "slug": "jupyterlablite",
+  "description": "Create documents containing live code, equations, visualizations, and explanatory text.",
+  "url": "https://github.com/hassio-addons/addon-jupyterlab-lite",
+  "webui": "[PROTO:ssl]://[HOST]:[PORT:8888]",
+  "startup": "application",
+  "arch": [
+    "aarch64",
+    "amd64",
+    "armhf",
+    "i386"
+  ],
+  "machine": [
+    "intel-nuc",
+    "qemux86",
+    "qemux86-64",
+    "qemuarm",
+    "qemuarm-64",
+    "raspberrypi2",
+    "raspberrypi3",
+    "raspberrypi3-64",
+    "tinker",
+    "odroid-c2",
+    "odroid-xu"
+  ],
+  "boot": "auto",
+  "hassio_api": true,
+  "auth_api": false,
+  "hassio_role": "default",
+  "homeassistant_api": true,
+  "host_network": false,
+  "ports": {
+    "8888/tcp": 8888
+  },
+  "map": [
+    "config:rw",
+    "share:rw",
+    "ssl"
+  ],
+  "options": {
+    "log_level": "info",
+    "password": "",
+    "github_access_token": "",
+    "ssl": false,
+    "certfile": "fullchain.pem",
+    "keyfile": "privkey.pem",
+    "system_packages": [],
+    "python_packages": []
+  },
+  "schema": {
+    "log_level": "match(^(trace|debug|info|notice|warning|error|fatal)$)",
+    "password": "str",
+    "github_access_token": "str",
+    "ssl": "bool",
+    "certfile": "str",
+    "keyfile": "str",
+    "system_packages": ["str"],
+    "python_packages": ["str"]
+  },
+  "environment": {
+    "LOG_FORMAT": "{LEVEL}: {MESSAGE}"
+  }
+}

jupyterlab/requirements.txt

@@ -0,0 +1,19 @@
+beautifulsoup4==4.6.3
+bokeh==1.0.2
+geopy==1.17.0
+HASS-data-detective==0.5
+influxdb==5.2.0
+ipywidgets==7.4.2
+jupyterlab_github==0.7.0
+jupyterlab-git==0.5.0
+jupyterlab==0.35.4
+matplotlib==3.0.2
+nbconvert==5.4.0
+numpy==1.15.4
+pandas-datareader==0.7.0
+pandas==0.23.4
+plotly==3.4.2
+PyMySQL==0.9.2
+python-dateutil==2.7.5
+scrapy==1.5.1
+SQLAlchemy==1.2.14

jupyterlab/rootfs/etc/cont-init.d/10-requirements.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# This files check if all user configuration requirements are met
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+# Check SSL requirements, if enabled
+if hass.config.true 'ssl'; then
+    if ! hass.config.has_value 'certfile'; then
+        hass.die 'SSL is enabled, but no certfile was specified'
+    fi
+
+    if ! hass.config.has_value 'keyfile'; then
+        hass.die 'SSL is enabled, but no keyfile was specified'
+    fi
+
+    if ! hass.file_exists "/ssl/$(hass.config.get 'certfile')"; then
+        hass.die 'The configured certfile is not found'
+    fi
+
+    if ! hass.file_exists "/ssl/$(hass.config.get 'keyfile')"; then
+        hass.die 'The configured keyfile is not found'
+    fi
+fi

jupyterlab/rootfs/etc/cont-init.d/20-notebooks-dir.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Ensures the JupyterLab notebooks directory exists
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+if ! hass.directory_exists '/config/notebooks'; then
+    mkdir -p /config/notebooks \
+        || hass.die 'Failed creating notebooks directory'
+
+    git clone -b master --single-branch \
+        https://github.com/home-assistant/home-assistant-notebooks.git \
+        /config/notebooks/home-assistant \
+            || hass.die 'Failed installing Home Assistant example notebooks'
+
+    git clone -b master --single-branch --depth 1 \
+        https://github.com/bokeh/bokeh-notebooks.git \
+        /config/notebooks/bokeh-examples \
+            || hass.die 'Failed installing Bokeh example notebooks'
+
+    git clone -b master --single-branch --depth 1 \
+        https://bitbucket.org/hrojas/learn-pandas.git \
+        /config/notebooks/learn-pandas \
+            || hass.die 'Failed installing learn pandas notebooks'
+fi

jupyterlab/rootfs/etc/cont-init.d/21-persistent-storage.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Ensure directories in the persistent storage exists
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+if ! hass.directory_exists '/data/user-settings'; then
+    mkdir -p /data/user-settings \
+        || hass.die 'Failed creating persistent user-settings directory'
+fi
+
+if ! hass.directory_exists '/data/workspaces'; then
+    mkdir -p /data/workspaces \
+        || hass.die 'Failed creating persistent workspaces directory'
+fi
+
+if ! hass.directory_exists '/data/local'; then
+    mkdir -p /data/local \
+        || hass.die 'Failed creating persistent local directory'
+fi
+ln -s /data/local /root/.local

jupyterlab/rootfs/etc/cont-init.d/50-password.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Sets the user set password into JupyterLab
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+readonly CONFIG_PATH="/etc/jupyter/jupyter_notebook_config.py"
+
+# Set password
+if hass.config.has_value 'password'; then
+    password=$(hass.config.get 'password')
+    password=$(python3 -c "from notebook.auth.security import passwd;print(passwd('${password}'))")
+    sed -i "s/c.NotebookApp.password\\ .*/c.NotebookApp.password\\ =\\ '${password}'/" "${CONFIG_PATH}" \
+        || hass.die 'Failed setting up password'
+fi

jupyterlab/rootfs/etc/cont-init.d/51-github.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Install the users GitHub Access token into JupyterLab
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+readonly CONFIG_PATH="/etc/jupyter/jupyter_notebook_config.py"
+
+# Set password
+if hass.config.has_value 'github_access_token'; then
+    token=$(hass.config.get 'github_access_token')
+    sed -i "s/c.GitHubConfig.access_token\\ .*/c.GitHubConfig.access_token\\ =\\ '${token}'/" "${CONFIG_PATH}" \
+        || hass.die 'Failed setting up GitHub access token'
+fi

jupyterlab/rootfs/etc/cont-init.d/80-system-packages.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Install user configured/requested packages
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+if hass.config.has_value 'system_packages'; then
+    apt-get update \
+        || hass.die 'Failed updating Ubuntu packages repository indexes'
+
+    for package in $(hass.config.get 'system_packages'); do
+        apt-get install -y --no-install-recommends "$package" \
+            || hass.die "Failed installing package ${package}"
+    done
+fi

jupyterlab/rootfs/etc/cont-init.d/81-python-packages.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/with-contenv bash
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Install user configured/requested Python packages
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+if hass.config.has_value 'python_packages'; then
+    for package in $(hass.config.get 'python_packages'); do
+        pip3 install "$package" \
+            || hass.die "Failed installing package ${package}"
+    done
+fi

jupyterlab/rootfs/etc/jupyter/jupyter_notebook_config.py

@@ -0,0 +1,29 @@
+# Configuration file for ipython-notebook.
+
+c = get_config()
+
+# ------------------------------------------------------------------------------
+# NotebookApp configuration
+# ------------------------------------------------------------------------------
+
+c.GitHubConfig.access_token = ''
+c.JupyterApp.answer_yes = True
+c.LabApp.user_settings_dir = '/data/user-settings'
+c.LabApp.workspaces_dir = '/data/workspaces'
+c.NotebookApp.allow_origin = '*'
+c.NotebookApp.allow_password_change = False
+c.NotebookApp.allow_root = True
+c.NotebookApp.base_url = '/'
+c.NotebookApp.ip = '0.0.0.0'
+c.NotebookApp.notebook_dir = '/config/notebooks'
+c.NotebookApp.open_browser = False
+c.NotebookApp.password = ''
+c.NotebookApp.port = 8888
+c.NotebookApp.token = ''
+c.NotebookApp.tornado_settings = {'static_url_prefix': '/static/'}
+c.NotebookApp.trust_xheaders = True
+c.NotebookApp.tornado_settings = {
+    'headers': {
+        'Content-Security-Policy': "frame-ancestors *"
+    }
+}

jupyterlab/rootfs/etc/services.d/jupyter/finish

@@ -0,0 +1,9 @@
+#!/usr/bin/execlineb -S0
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Take down the S6 supervision tree when the Jupyter daemon fails
+# ==============================================================================
+if -n { s6-test $# -ne 0 }
+if -n { s6-test ${1} -eq 256 }
+
+s6-svscanctl -t /var/run/s6/services

jupyterlab/rootfs/etc/services.d/jupyter/run

@@ -0,0 +1,43 @@
+#!/usr/bin/with-contenv bash
+# shellcheck disable=SC2191
+# ==============================================================================
+# Community Hass.io Add-ons: JupyterLab Lite
+# Runs Jupyter
+# ==============================================================================
+# shellcheck disable=SC1091
+source /usr/lib/hassio-addons/base.sh
+
+declare -a options
+
+hass.log.info 'Starting the Jupyter server'
+
+# Find the matching Jupyter log level
+case "$(hass.string.lower "$(hass.config.get 'log_level')")" in
+    all|trace|debug)
+        options+=(--log-level='DEBUG')
+        ;;
+    info|notice)
+        options+=(--log-level='INFO')
+        ;;
+    warning)
+        options+=(--log-level='WARN')
+        ;;
+    error)
+        options+=(--log-level='ERROR')
+        ;;
+    fatal|off)
+        options+=(--log-level='CRITICAL')
+        ;;
+esac
+
+# SSL Configuration
+if hass.config.true 'ssl'; then
+    options+=(--keyfile="/ssl/$(hass.config.get 'keyfile')")
+    options+=(--certfile="/ssl/$(hass.config.get 'certfile')")
+fi
+
+# Change current working directory
+cd /config/notebooks || hass.die 'Failed changing working directory'
+
+# Run Juypter Notebook server
+exec jupyter lab "${options[@]}"