Geolab base 0.2.0

.gitlab-ci.yml

@@ -17,12 +17,12 @@ include:
 
 .images_matrix:
   - DOCKERFILE_RELPATH: "geolab-base"
-    DOCKER_EXTRA_OPTIONS: "--build-arg IMAGE_AUTHORS=geolab@earthscope.org --build-arg PYTHON_VERSION=3.12"
+    DOCKER_EXTRA_OPTIONS: "--build-arg IMAGE_AUTHORS=geolab@earthscope.org --build-arg PYTHON_VERSION=3.12 --build-arg GEOLAB_VERSION=${IMAGE_VERSION}"
   #- DOCKERFILE_RELPATH: "geolab-gpu"
 
 
 variables:
   CONTAINER_REGISTRY_PLATFORM: "AWS-PUB"
   DOCKERFILE_RELPATH_IS_IMAGE_NAME: "true"
   GITLAB_HOSTED_RUNNER_SIZE: "saas-linux-medium-amd64"
-
+  GEOLAB_VERSION: ""

geolab-base/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.0]
+
+### Added
+
+- pin base image to pangeo-base:04bb14b
+- add geolab-base version as ENV GEOLAB_VERSION (set during CI build)
+- add graphviz package
+- add pygraphviz package
+- add ipycytoscape
+- added tests for new packages
+- add build_process.png for README
+
+### Changed
+
+- removed test_packages.py
+- moved test_notebook functions to test_helpers.py module to make it easier for users to import when writing tests
+- updated test_notebook.ipynb to use test_helpers functions
+- updated README to match Building Custom Images in docs

geolab-base/Dockerfile

@@ -11,21 +11,28 @@
 #   docker build --platform linux/amd64 \
 #   --build-arg IMAGE_TITLE=my-geolab-image \
 #   --build-arg IMAGE_AUTHORS=you@university.edu \
+#   --build-arg GEOLAB_VERSION=1.0.0 \
 #   -t my-geolab-image .
 # ──────────────────────────────────────────────────────────────
-FROM pangeo/base-image:latest
+# Changing this tag is a major (breaking) change under semantic versioning.
+FROM pangeo/base-image:04bb14b
 
 
 ARG IMAGE_TITLE="custom-geolab-image"   # default if user passes nothing
 ARG IMAGE_AUTHORS="NoSpecifiedAuthors"  # default if user passes nothing
+ARG GEOLAB_VERSION                      # no default; must be passed with --build-arg
+
+RUN test -n "$GEOLAB_VERSION" || (echo "GEOLAB_VERSION must not be empty" >&2 && exit 1)
 
 LABEL org.opencontainers.image.title="${IMAGE_TITLE}" \
-      org.opencontainers.image.authors="${IMAGE_AUTHORS}"
+      org.opencontainers.image.authors="${IMAGE_AUTHORS}" \
+      org.opencontainers.image.version="${GEOLAB_VERSION}"
 
       # Set locations of PROJ/GDAL resource directories
 ENV PROJ_DATA=/srv/conda/envs/notebook/share/proj \
     PROJ_LIB=/srv/conda/envs/notebook/share/proj \
-    GDAL_DATA=/srv/conda/envs/notebook/share/gdal
+    GDAL_DATA=/srv/conda/envs/notebook/share/gdal \
+    GEOLAB_VERSION=${GEOLAB_VERSION}
 
 # Default command for standalone use. JupyterHub spawning passes
 # its own command (jupyterhub-singleuser), which start respects.

geolab-base/apt.txt

@@ -4,3 +4,4 @@ git
 gmt-dcw
 gmt-gshhg
 make
+nano

geolab-base/environment.yml

@@ -47,6 +47,9 @@ dependencies:
   - distributed
   # --- Visualization ---
   - matplotlib-base
+  - graphviz
+  - pygraphviz
+  - ipycytoscape
   - altair
   - hvplot
   - holoviews

geolab-base/requirements.txt

@@ -6,6 +6,8 @@ earthscope-sdk==1.6.1
 earthscope-cli==1.2.0
 earthscopestraintools
 
-
 # --- Jupyter add-ons ---
 jupyterlab_jupyterbook_navigation
+
+# --- Geophysics ---
+

geolab-base/test_helpers.py

@@ -0,0 +1,41 @@
+"""Helpers for smoke-testing installed packages and CLI tools."""
+
+import importlib
+import shutil
+import subprocess
+
+RESULTS = []
+
+
+def reset():
+    """Clear RESULTS — call before a fresh run in a long-lived kernel."""
+    RESULTS.clear()
+
+
+def py(modname, alias=None, smoke=None):
+    """Import `modname` and optionally run `smoke(mod)` as a sanity check."""
+    label = alias or modname
+    try:
+        mod = importlib.import_module(modname)
+        if smoke is not None:
+            smoke(mod)
+        version = getattr(mod, '__version__', '')
+        RESULTS.append((label, 'OK', str(version), ''))
+    except Exception as exc:
+        RESULTS.append((label, 'FAIL', '', f'{type(exc).__name__}: {exc}'))
+
+
+def cli(cmd, version_flag='--version'):
+    """Verify `cmd` is on $PATH and responds to a version flag."""
+    path = shutil.which(cmd)
+    if not path:
+        RESULTS.append((cmd, 'FAIL', '', 'not on $PATH'))
+        return
+    try:
+        r = subprocess.run([cmd, version_flag],
+                           capture_output=True, text=True, timeout=10)
+        line = (r.stdout or r.stderr).strip().splitlines()
+        version = line[0] if line else 'on PATH'
+        RESULTS.append((cmd, 'OK', version[:80], ''))
+    except Exception as exc:
+        RESULTS.append((cmd, 'OK', 'on PATH', f'{type(exc).__name__}'))