Add Python API support

.gitattributes

@@ -0,0 +1 @@
+* text=auto

.github/workflows/build-cloe.yaml

@@ -1,6 +1,19 @@
+---
 name: Build Cloe
 
 on:
+  push:
+    branches:
+      - master
+      - develop
+      - "release/**"
+    paths-ignore:
+      - "*.md"
+      - ".gitignore"
+      - "LICENSE"
+      - "dist/**"
+      - "docs/**"
+      - "ui/**"
   pull_request:
     paths-ignore:
       - "*.md"
@@ -22,7 +35,13 @@ jobs:
           - "cloe-normal"
         package_target:
           # 1. Build each test configuration in Conan cache and run all tests
-          - "export export-vendor smoketest-deps smoketest"
+          - "export-vendor export-all smoketest-deps smoketest"
+
+          # 2. Build cloe super-package in editable mode and run tests
+          - "export-vendor editable all smoketest TEST_CONANFILES=tests/conanfile_all.py"
+
+          # 3. Build individual packages in editable mode and run tests
+          - "export-vendor editable-select build-all smoketest TEST_CONANFILES=tests/conanfile_split.py"
     env:
       CONAN_NON_INTERACTIVE: "yes"
       DEBIAN_FRONTEND: noninteractive

.github/workflows/build-docs.yaml

@@ -1,6 +1,15 @@
+---
 name: Build Documentation
 
 on:
+  push:
+    branches:
+      - master
+      - develop
+      - "release/**"
+    paths:
+      - "docs/**"
+      - "*.hpp"
   pull_request:
     paths:
       - "docs/**"

.github/workflows/build-ui.yaml

@@ -1,6 +1,14 @@
+---
 name: Build UI
 
 on:
+  push:
+    branches:
+      - master
+      - develop
+      - "release/**"
+    paths:
+      - "ui/**"
   pull_request:
     paths:
       - "ui/**"
@@ -29,8 +37,7 @@ jobs:
           echo $version
           if [[ $version == "v18"* ]]; then
               npm run build_v18
-          else 
+          else
               npm run build
           fi
         shell: bash
-

.gitignore

@@ -6,6 +6,7 @@ setup.sh
 
 # Standard out-of-source build
 build/
+deploy/
 
 # Vendored Conan recipes sometimes extract fetched sources
 vendor/**/src/
@@ -29,6 +30,7 @@ CMakeFiles/
 compile_commands.json
 
 # Files generated by Clang:
+.cache/
 .clangd/
 .cache/
 

.luarc.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
+  "workspace.library": ["engine/lua"],
+  "runtime.version": "Lua 5.4",
+  "completion.displayContext": 1,
+  "diagnostics.globals": ["cloe"],
+  "hint.enable": true
+}

CMakeLists.txt

@@ -0,0 +1,36 @@
+# This CMakeLists.txt configures a super-build containing everything
+# from this repo.
+#
+# It is currently experimental.
+#
+
+cmake_minimum_required(VERSION 3.15 FATAL_ERROR)
+
+project(cloe LANGUAGES CXX)
+
+set(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/runtime/cmake")
+
+# Since a super-build does not export packages individually via Conan,
+# we cannot depend on Conan-generated CMake config files, instead we
+# use the CMake targets directly as if they were already found.
+set(CLOE_FIND_PACKAGES OFF CACHE BOOL "Call find_package() for cloe packages" FORCE)
+
+# Ensure output goes to one place so cloe-launch can find the plugins
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/lib)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/bin)
+
+# Ensure we can test from this level.
+include(CTest)
+
+add_subdirectory(fable)
+add_subdirectory(runtime)
+add_subdirectory(models)
+add_subdirectory(oak)
+add_subdirectory(osi)
+add_subdirectory(stacklib)
+add_subdirectory(simulation)
+add_subdirectory(engine)
+add_subdirectory(plugins)
+if (${CLOE_PYTHON_API})
+    add_subdirectory(python)
+endif()

Makefile

@@ -3,10 +3,15 @@
 # This file contains Makefile targets for the cloe project.
 #
 
+# Make configuration:
+SHELL := /bin/bash
+GNUMAKEFLAGS := --no-print-directory
+SUBMAKEFLAGS :=
+
 CLOE_ROOT   := $(shell dirname $(realpath $(firstword $(MAKEFILE_LIST))))
-CLOE_LAUNCH := PYTHONPATH="${CLOE_ROOT}/cli" python3 -m cloe_launch
+CLOE_LAUNCH := PYTHONPATH="$(CLOE_ROOT)/cli" python3 -m cloe_launch
 
-include ${CLOE_ROOT}/Makefile.help
+include $(CLOE_ROOT)/Makefile.help
 
 # Set the clang-format command line to use:
 CLANG_FORMAT := $(shell command -v clang-format 2>/dev/null)
@@ -20,78 +25,95 @@ AG := $(or \
 
 # Build configuration:
 BUILD_DIR       := build
-LOCKFILE_SOURCE := conanfile.py
-BUILD_LOCKFILE  := ${BUILD_DIR}/conan.lock
-LOCKFILE_OPTION := --lockfile="${CLOE_ROOT}/${BUILD_LOCKFILE}"
 INSTALL_DIR     := /usr/local
 CONAN_OPTIONS   :=
 
+# Lockfile for cloe-meta:
+META_LOCKFILE_SOURCE := meta/conanfile.py
+META_BUILD_LOCKFILE  := meta/build/conan.lock
+META_LOCKFILE_OPTION := --lockfile="$(CLOE_ROOT)/$(META_BUILD_LOCKFILE)"
+
 .DEFAULT_GOAL := help
 .PHONY: help
 .SILENT: help
 help::
 	$(call print_help_usage)
 	echo
+	$(call print_help_section, "Default target")
+	$(call print_help_target, help, "show this help on available targets")
+	echo
 
 # Setup targets ---------------------------------------------------------------
 include Makefile.setup
 
+$(META_BUILD_LOCKFILE):
+	$(MAKE) -C meta LOCKFILE_SOURCE=conanfile.py lockfile
+
+.PHONY: lockfile
+lockfile: $(META_BUILD_LOCKFILE)
+
 # Workspace targets -----------------------------------------------------------
 help::
 	$(call print_help_section, "Available workspace targets")
-	$(call print_help_target, status, "show status of each of the Conan packages")
-	$(call print_help_target, smoketest-deps, "build system test pre-requisites")
-	$(call print_help_target, smoketest, "run system tests")
-	$(call print_help_target, docs, "generate documentation")
-	$(call print_help_target, deploy, "deploy Cloe to INSTALL_DIR [=${INSTALL_DIR}]")
-	$(call print_help_target, deploy-cli, "install ${_yel}cloe-launch${_rst} with ${_dim}${PIPX}${_rst}")
-	$(call print_help_target, export-cli, "export ${_yel}cloe-launch-profile${_rst} Conan recipe")
+	$(call print_help_target, docs, "generate Doxygen and Sphinx documentation")
 	echo
 
-${BUILD_LOCKFILE}:
-	${MAKE} -f Makefile.package SOURCE_CONANFILE=/dev/null LOCKFILE_SOURCE=${LOCKFILE_SOURCE} ${BUILD_LOCKFILE}
-
-.PHONY: lockfile
-lockfile: ${BUILD_LOCKFILE}
+.PHONY: docs
+docs:
+	$(call print_header, "Generating Doxygen documentation...")
+	$(MAKE) -C docs doxygen
+	$(call print_header, "Generating Sphinx documentation...")
+	$(MAKE) -C docs html
 
-.PHONY: status
-status: ${BUILD_LOCKFILE}
-	@for pkg in ${ALL_PKGS}; do \
-		[ -d $${pkg} ] || continue; \
-		${MAKE} LOCKFILE_SOURCE="" LOCKFILE_OPTION=${LOCKFILE_OPTION} -C $${pkg} status || true; \
-	done
+help::
+	$(call print_help_target, export-cli, "export $(_yel)cloe-launch-profile$(_rst) Conan recipe")
+	$(call print_help_target, deploy-cli, "install $(_yel)cloe-launch$(_rst) with $(_dim)$(PIPX)$(_rst)")
+	echo
 
-.PHONY: deploy
-deploy:
-	$(call print_header, "Deploying binaries to ${INSTALL_DIR}...")
-	conan install ${CONAN_OPTIONS} --install-folder ${BUILD_DIR}/deploy -g deploy .
-	mkdir -p ${INSTALL_DIR}
-	cp -r ${BUILD_DIR}/deploy/cloe-*/* ${INSTALL_DIR}/
+.PHONY: export-cli
+export-cli:
+	$(MAKE) -C cli export
 
 .PHONY: deploy-cli
 deploy-cli:
 	$(call print_header, "Deploying cloe-launch binary with pip...")
-	${MAKE} -C cli install
+	$(MAKE) -C cli install
 
-.PHONY: export-cli
-export-cli:
-	${MAKE} -C cli export
+help::
+	$(call print_help_target, lockfile, "create a lockfile for cloe-meta package")
+	$(call print_help_target, status-all, "show status of each of the Conan packages")
+	$(call print_help_target, export-all, "export all package sources to Conan cache")
+	$(call print_help_target, build-all, "build individual packages locally in-source")
+	$(call print_help_target, deploy-all, "deploy $(_yel)cloe$(_rst) to $(_grn)INSTALL_DIR$(_rst)=$(_dim)$(INSTALL_DIR)$(_rst)")
+	$(call print_help_target, clean-all, "clean entire repository of temporary files")
+	$(call print_help_target, purge-all, "remove all cloe packages (in any version) from Conan cache")
+	echo
 
-export: export-cli
-package: export-cli
+.PHONY: build-all
+build-all: lockfile
+	$(MAKE) all-select UNSELECT_PKGS="meta" CONAN_OPTIONS="$(CONAN_OPTIONS) $(META_LOCKFILE_OPTION)"
 
-.PHONY: docs
-docs:
-	$(call print_header, "Generating Doxygen documentation...")
-	${MAKE} -C docs doxygen
-	$(call print_header, "Generating Sphinx documentation...")
-	${MAKE} -C docs html
+.PHONY: status-all
+status-all: $(META_BUILD_LOCKFILE)
+	@for pkg in $(ALL_PKGS); do \
+		$(MAKE) LOCKFILE_SOURCE="" LOCKFILE_OPTION=$(META_LOCKFILE_OPTION) -C $${pkg} status || true; \
+	done
 
-.PHONY: smoketest-deps
-smoketest-deps: export-cli smoketest-deps-select
+.PHONY: export-all
+export-all:
+	$(call print_header, "Exporting all cloe Conan packages...")
+	$(MAKE) export-select export-cli export
 
-.PHONY: smoketest
-smoketest: smoketest-select
+.PHONY: deploy-all
+deploy-all:
+	$(call print_header, "Deploying binaries to $(INSTALL_DIR)...")
+	conan install $(CONAN_OPTIONS) --install-folder $(BUILD_DIR)/deploy -g deploy .
+	mkdir -p $(INSTALL_DIR)
+	cp -r $(BUILD_DIR)/deploy/cloe-*/* $(INSTALL_DIR)/
+
+.PHONY: clean-all
+clean-all:
+	$(MAKE) clean clean-select
 
 .PHONY: purge-all
 purge-all:
@@ -114,17 +136,19 @@ format:
 	# continues to work as expected.
 	#
 	# See: https://www.moxio.com/blog/43/ignoring-bulk-change-commits-with-git-blame
-	find . -type f -not -path '*/\.git/*' -and \( -name '*.cpp' -o -name '*.hpp' \) -exec ${CLANG_FORMAT} ${CLANG_FORMAT_ARGS} -i {} \;
+	find . -type f -not -path '*/\.git/*' -and \( -name '*.cpp' -o -name '*.hpp' \) -exec $(CLANG_FORMAT) $(CLANG_FORMAT_ARGS) -i {} \;
 
 .PHONY: todos
 todos:
-	${AG} TODO
-	${AG} FIXME
-	${AG} XXX
+	$(AG) TODO
+	$(AG) FIXME
+	$(AG) XXX
+
+# Hidden development targets --------------------------------------------------
 
 .PHONY: grep-uuids
 grep-uuids:
-	${AG} "\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\b"
+	$(AG) "\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\b"
 
 .PHONY: find-missing-eol
 find-missing-eol:
@@ -134,5 +158,12 @@ find-missing-eol:
 sanitize-files:
 	git grep --cached -Ilz '' | while IFS= read -rd '' f; do tail -c1 < "$$f" | read -r _ || echo >> "$$f"; done
 
-# Build targets ---------------------------------------------------------------
+# Micro-packages build targets ------------------------------------------------
 include Makefile.all
+
+# Mono-package build targets --------------------------------------------------
+DISABLE_HELP_PREAMBLE := true
+help::
+	@printf "Available $(_yel)cloe$(_rst) package targets:\n"
+
+include Makefile.package