content: # Default Reference Distro for development env & deploy:
  # * Alpine Linux, version 3.21 *
  
  FROM alpine:3.21
  LABEL maintainer="Ben V. Brown <ralim@ralimtek.com>"
  
  # Default current dir when container starts
  WORKDIR /build/ironos
  
  # Installing the two compilers (ARM & RISCV), python3 & pip, clang tools, etc.:
  ## - compilers: gcc-*, newlib-*
  ## - python3: py*, black (required to check Python code formatting)
  ## - misc: findutils, make, git, diffutils, zip
  ## - musl-dev (required for the multi lang firmwares)
  ## - clang (required for clang-format to check C++ code formatting)
  ## - shellcheck (to check sh scripts)
  
  ARG APK_COMPS="gcc-riscv-none-elf g++-riscv-none-elf gcc-arm-none-eabi g++-arm-none-eabi newlib-riscv-none-elf newlib-arm-none-eabi"
  ARG APK_PYTHON="python3 py3-pip black"
  ARG APK_MISC="findutils make git diffutils zip"
  ARG APK_DEV="musl-dev clang bash clang-extra-tools shellcheck"
  
  # PIP packages to check & test Python code, and generate docs
  ARG PIP_PKGS='bdflib flake8 pymdown-extensions mkdocs mkdocs-autolinks-plugin mkdocs-awesome-pages-plugin mkdocs-git-revision-date-plugin'
  
  # Install system packages using alpine package manager
  RUN apk add --no-cache ${APK_COMPS} ${APK_PYTHON} ${APK_MISC} ${APK_DEV}
  
  # Install Python3 packages as modules using pip, yes we dont care if packages break
  RUN python3 -m pip install --break-system-packages ${PIP_PKGS}
  
  # Git trust to avoid related warning
  RUN git config --global --add safe.directory /build/ironos
  
  # Copy the whole source tree working dir into container
  COPY  .  /build/ironos
  