Merge branch 'release/v0.3.0'

Author: howardjp

.ci-files/.travis.yml

@@ -0,0 +1,51 @@
+name: Build
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Debug
+
+jobs:
+  build:
+    # The CMake configure and build commands are platform agnostic and should work equally
+    # well on Windows or Mac.  You can convert this to a matrix build if you need
+    # cross-platform coverage.
+    # See: https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    
+    - name: Install Conan
+      id: conan
+      uses: turtlebrowser/get-conan@main
+
+    - name: Conan The Frogarian
+      run: conan frogarian
+
+    - name: Conan Profile Setup
+      run: |
+        conan config init
+        conan profile update settings.compiler.libcxx=libstdc++11 default
+
+    - name: Conan Install Dependencies
+      run: conan install -if build . 
+
+    - name: Configure CMake
+      # Configure CMake in a 'build' subdirectory. `CMAKE_BUILD_TYPE` is only required if you are using a single-configuration generator such as make.
+      # See https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html?highlight=cmake_build_type
+      run: cmake -B build -DCMAKE_BUILD_TYPE=${{env.BUILD_TYPE}}
+
+    - name: Build
+      # Build your program with the given configuration
+      run: cmake --build build --config ${{env.BUILD_TYPE}}
+
+    - name: Test
+      # Execute tests defined by the CMake configuration.  
+      # See https://cmake.org/cmake/help/latest/manual/ctest.1.html for more detail
+      run: cmake --build build --target test --config ${{env.BUILD_TYPE}}

.ci-files/conan_server/server.conf

@@ -38,3 +38,6 @@ build/*
 
 # Qtcreator files
 *.user
+
+# VSCode files
+.vscode

.ci-files/install_cmake.sh

@@ -0,0 +1,20 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Optionally build your docs in additional formats such as PDF
+formats:
+  - pdf
+
+# Optionally set the version of Python and requirements required to build your docs
+python:
+  version: "3.7"
+  install:
+    - requirements: docs/requirements.txt

.ci-files/install_conan.sh

@@ -5,9 +5,11 @@ linux: &linux
    python: "3.7"
    services:
      - docker
+
 osx: &osx
    os: osx
    language: generic
+
 matrix:
    include:
       - <<: *linux
@@ -46,11 +48,42 @@ matrix:
         osx_image: xcode10.1
         env: CONAN_APPLE_CLANG_VERSIONS=10.0
 
+addons:
+  apt:
+    - doxygen
+
 install:
-  - chmod +x .ci-files/install_conan.sh .ci-files/install_cmake.sh
-  - ./.ci-files/install_conan.sh
-  - ./.ci-files/install_cmake.sh
+  # Get some stuff we need for Sphinx and Conan
+  - pip3 install -r docs/requirements.txt
+  - pip3 install conan
+  # first we create a directory for the CMake binaries
+  - DEPS_DIR="${TRAVIS_BUILD_DIR}/deps"
+  - mkdir ${DEPS_DIR} && cd ${DEPS_DIR}
+  # we use wget to fetch the cmake binaries
+  - travis_retry wget --no-check-certificate https://github.com/Kitware/CMake/releases/download/v3.18.3/cmake-3.18.3-Linux-x86_64.tar.gz
+  - travis_retry wget --no-check-certificate https://github.com/Kitware/CMake/releases/download/v3.18.3/cmake-3.18.3-SHA-256.txt
+  - travis_retry wget --no-check-certificate https://github.com/Kitware/CMake/releases/download/v3.18.3/cmake-3.18.3-SHA-256.txt.asc
+  # this is optional, but useful:
+  # do a quick md5 check to ensure that the archive we downloaded did not get compromised, leave off GPG verification for now
+  - sha256sum --ignore-missing -c cmake-3.18.3-SHA-256.txt
+  # extract the binaries; the output here is quite lengthy,
+  # so we swallow it to not clutter up the travis console
+  - tar -xvf cmake-3.18.3-Linux-x86_64.tar.gz > /dev/null
+  - mv cmake-3.18.3-Linux-x86_64 cmake-install
+  # add both the top-level directory and the bin directory from the archive
+  # to the system PATH. By adding it to the front of the path we hide the
+  # preinstalled CMake with our own.
+  - PATH=${DEPS_DIR}/cmake-install:${DEPS_DIR}/cmake-install/bin:$PATH
+  # don't forget to switch back to the main build directory once you are done
+  - cd ${TRAVIS_BUILD_DIR}
+
+before_script:
+  - mkdir build
+  - cd build
+  - conan install ..
+  - cmake ..
 
-script:
-  - chmod +x .ci-files/run.sh
-  - ./.ci-files/run.sh
+script: |
+  - cmake --build .
+  - ctest -C Debug
+  - cmake --build . --target install