Initial commit

Author: vgvassilev

.github/workflows/deploy.yml

@@ -0,0 +1,56 @@
+name: Build and Deploy
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - '*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install mamba
+        uses: mamba-org/setup-micromamba@v1
+        with:
+          micromamba-version: '1.5.8-0'
+          environment-file: build-environment.yml
+          cache-environment: true
+
+      - name: Build the JupyterLite site
+        shell: bash -l {0}
+        run: |
+          cp README.md content
+          jupyter lite build --contents content --output-dir dist
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    needs: build
+    if: github.ref == 'refs/heads/main'
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,116 @@
+*.bundle.*
+lib/
+node_modules/
+.yarn-packages/
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# OS X stuff
+*.DS_Store
+
+# End of https://www.gitignore.io/api/python
+
+# jupyterlite
+*.doit.db
+_output

.nojekyll

@@ -0,0 +1,79 @@
+# Xeus-Lite demo
+
+[![lite-badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://jupyterlite.github.io/xeus-lite-demo/notebooks/?path=demo.ipynb)
+
+This GitHub template allows you to create deployments of JupyterLite with a custom set of conda packages.
+
+## 💡 How to make your own deployment
+
+Creating a new deployment can be done in three easy steps:
+
+**Step 1: Apply the GitHub template**
+
+1. Click the **"Use this template"** button in the upper right corner of the GitHub repository.
+2. Choose a name for your project and select the GitHub organization where you want to create it.
+3. Then hit **"Create repository from template"** to finalize the setup.
+
+**Step 2: Enable building the GitHub pages from GitHub actions.**
+
+1. Once your repository is created, enable GitHub Pages by configuring GitHub Actions. This will build and deploy your site automatically.
+2. Your deployment will be accessible at the following URL: https://{USERNAME}.github.io/{DEMO_REPO_NAME}.
+
+**Step 3: Customize your conda environment**
+
+1. Update your ``environment.yml`` file to include the required packages.
+2. This ensures that your environment has all the necessary dependencies.
+
+## 🎬 Visual Guide
+
+For a step-by-step visual guide, check out the screencast below:
+
+![Deploy your own](deploy.gif)
+
+## 📦 How to install kernels and packages
+
+You can install specific kernels and extra packages by adding them to the ``environment.yml`` file.
+
+See https://jupyterlite-xeus.readthedocs.io/en/latest/environment.html for more documentation.
+
+### Example 1: JupyterLite with NumPy and Matplotlib
+
+To create a JupyterLite deployment with NumPy and Matplotlib pre-installed, edit the ``environment.yml`` file as follows:
+
+```yml
+name: xeus-kernel
+channels:
+  - https://repo.prefix.dev/emscripten-forge-dev
+  - https://repo.prefix.dev/conda-forge
+dependencies:
+  - xeus-python
+  - numpy
+  - matplotlib
+```
+
+### Example 2: JupyterLite with R and coursekata
+
+To use the R kernel and the coursekata package, edit the environment.yml file as follows:
+
+```yml
+name: xeus-kernel
+channels:
+  - https://repo.prefix.dev/emscripten-forge-dev
+  - https://repo.prefix.dev/conda-forge
+dependencies:
+  - xeus-r
+  - r-coursekata
+```
+
+### Example 3: JupyterLite with C++
+
+To use the C++ kernel, edit the environment.yml file as follows:
+
+```yml
+name: xeus-kernel
+channels:
+  - https://repo.prefix.dev/emscripten-forge-dev
+  - https://repo.prefix.dev/conda-forge
+dependencies:
+  - xeus-cpp
+```

README.md

@@ -0,0 +1,9 @@
+name: build-env
+channels:
+  - conda-forge
+dependencies:
+  - python
+  - pip
+  - jupyter_server
+  - jupyterlite-core >=0.6
+  - jupyterlite-xeus >=4

build-environment.yml

@@ -0,0 +1,66 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import this"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from math import pi\n",
+    "\n",
+    "from ipycanvas import Canvas\n",
+    "\n",
+    "canvas = Canvas(width=1600, height=1200, layout=dict(width=\"100%\"))\n",
+    "\n",
+    "canvas.fill_style = \"#8ee05e\"\n",
+    "canvas.fill_rect(0, 0, canvas.width, canvas.height)\n",
+    "\n",
+    "canvas.fill_style = \"#f5f533\"\n",
+    "canvas.fill_circle(canvas.width / 2.0, canvas.height / 2.0, 500)\n",
+    "\n",
+    "canvas.stroke_style = \"black\"\n",
+    "canvas.line_width = 30\n",
+    "canvas.stroke_circle(canvas.width / 2.0, canvas.height / 2.0, 500)\n",
+    "\n",
+    "canvas.fill_style = \"black\"\n",
+    "canvas.fill_circle(canvas.width / 2.7, canvas.height / 3.0, 100)  # Right eye\n",
+    "canvas.stroke_arc(canvas.width / 2.0, canvas.height / 2.0, 400, 0, pi, False)  # Mouth\n",
+    "canvas.stroke_arc(\n",
+    "    canvas.width - canvas.width / 2.7, canvas.height / 2.7, 100, 0, pi, True\n",
+    ")  # Left eye\n",
+    "\n",
+    "canvas"
+   ]
+  }
+ ],
+ "metadata": {
+    "kernelspec": {
+     "display_name": "xeus-python",
+     "language": "python",
+     "name": "xeus-python"
+    },
+    "language_info": {
+     "codemirror_mode": {
+      "name": "ipython",
+      "version": 3
+     },
+     "file_extension": ".py",
+     "mimetype": "text/x-python",
+     "name": "python",
+     "nbconvert_exporter": "python",
+     "pygments_lexer": "ipython3",
+     "version": "3.10.4"
+   }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

content/demo.ipynb

@@ -0,0 +1,7 @@
+name: xeus-kernel
+channels:
+  - https://repo.prefix.dev/emscripten-forge-dev
+  - https://repo.prefix.dev/conda-forge
+dependencies:
+  - xeus-python
+  - ipycanvas