Merge branch 'gen2_develop' into develop

Author: themarpe

.github/workflows/docker-hub-g2-devel.yml

@@ -0,0 +1,27 @@
+name: Publish Docker image
+on:
+  push:
+    branches:
+      - gen2_develop
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          submodules: recursive
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v1
+      - name: Login to DockerHub
+        uses: docker/login-action@v1
+        with:
+          username: ${{ secrets.DOCKERHUB_USER }}
+          password: ${{ secrets.DOCKERHUB_PASS }}
+      - name: Build and push
+        uses: docker/build-push-action@v2
+        with:
+          push: true
+          file: ci/Dockerfile
+          tags: luxonis/depthai-library:latest

.github/workflows/docker-hub.yml

@@ -0,0 +1,30 @@
+name: Publish Docker image
+on:
+  push:
+    tags:
+      - "*"
+jobs:
+  push_to_registry:
+    name: Push Docker image to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          submodules: recursive
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v1
+      - name: Login to DockerHub
+        uses: docker/login-action@v1
+        with:
+          username: ${{ secrets.DOCKERHUB_USER }}
+          password: ${{ secrets.DOCKERHUB_PASS }}
+      - name: Get Version
+        id: vars
+        run: echo ::set-output name=short_ref::${GITHUB_REF#refs/*/}
+      - name: Build and push
+        uses: docker/build-push-action@v2
+        with:
+          push: true
+          file: ci/Dockerfile
+          tags: luxonis/depthai-library:${{ steps.vars.outputs.short_ref }}

.github/workflows/main.yml

@@ -1,4 +1,4 @@
-name: Python Wheel CI
+name: Depthai Python CI/CD
 
 # Controls when the action will run. Triggers the workflow on push
 
@@ -7,15 +7,58 @@ name: Python Wheel CI
 # as self-hosted runners are used, and security policy for them has not been yet determined by GitHub
 # pay close attention to not enable workflows on pull_request events
 # TLDR: do NOT add 'pull_request' here for the time being
-on: [push] 
+on:
+  workflow_dispatch:
+  push:
+    branches:
+    - main
+    - develop
+    - gen2
+    - gen2_develop
+    tags:
+    - 'v*'
+
 ###################################
 ###################################
 
 # A workflow run is made up of one or more jobs that can run sequentially or in parallel
 jobs:
 
+  # Job which builds docstrings for the rest of the wheel builds
+  build-docstrings:
+    runs-on: macos-latest
+    steps:
+      - name: Cache .hunter folder
+        uses: actions/cache@v2
+        with:
+          path: ~/.hunter/
+          key: hunter-clang
+      - uses: actions/checkout@v2
+        with:
+          submodules: 'recursive'
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with: 
+          python-version: 3.8
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          brew install libusb
+          python -m pip install git+git://github.com/luxonis/pybind11_mkdoc.git@master
+      - name: Configure project
+        run: cmake -S . -B build -DDEPTHAI_PYTHON_BUILD_DOCSTRINGS=ON -DDEPTHAI_PYTHON_FORCE_DOCSTRINGS=ON -DDEPTHAI_PYTHON_DOCSTRINGS_OUTPUT="$PWD/docstrings/depthai_python_docstring.hpp"
+      - name: Build target 'pybind11_mkdoc'
+        run: cmake --build build --parallel --target pybind11_mkdoc
+      - name: Upload docstring artifacts
+        uses: actions/upload-artifact@v2
+        with:
+          name: docstrings
+          path: docstrings/
+          retention-days: 1
+
   # This job builds wheels for armhf arch (RPi)
   build-linux-armhf:
+    needs: build-docstrings
     runs-on: luxonis-armhf
     container: 
       image: registry.gitlab.com/luxonis/depthai-crosscompile/debian-buster
@@ -28,6 +71,14 @@ jobs:
       - uses: actions/checkout@v2
         with:
           submodules: 'recursive'
+        
+      - uses: actions/download-artifact@v2
+        with:
+          name: 'docstrings'
+          path: docstrings
+      - name: Specify docstring to use while building the wheel
+        run: echo "DEPTHAI_PYTHON_DOCSTRINGS_INPUT=$PWD/docstrings/depthai_python_docstring.hpp" >> $GITHUB_ENV
+
       - name: Append build hash if not a tagged commit
         if: startsWith(github.ref, 'refs/tags/v') != true
         run: echo "BUILD_COMMIT_HASH=${{github.sha}}" >> $GITHUB_ENV
@@ -43,10 +94,11 @@ jobs:
 
   # This job builds wheels for Windows x86_64 arch
   build-windows-x86_64:
+    needs: build-docstrings
     runs-on: windows-latest
     strategy:
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.5, 3.6, 3.7, 3.8, 3.9]
         python-architecture: [x64, x86]
     steps:
       - name: Cache .hunter folder
@@ -57,6 +109,14 @@ jobs:
       - uses: actions/checkout@v2
         with:
           submodules: 'recursive'
+
+      - uses: actions/download-artifact@v2
+        with:
+          name: 'docstrings'
+          path: docstrings
+      - name: Specify docstring to use while building the wheel
+        run: echo "DEPTHAI_PYTHON_DOCSTRINGS_INPUT=$PWD/docstrings/depthai_python_docstring.hpp" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v2
         with: 
@@ -78,10 +138,11 @@ jobs:
 
   # This job builds wheels for macOS x86_64 arch
   build-macos-x86_64:
+    needs: build-docstrings
     runs-on: macos-latest
     strategy:
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.5, 3.6, 3.7, 3.8, 3.9]
     steps:
       - name: Cache .hunter folder
         uses: actions/cache@v2
@@ -91,6 +152,14 @@ jobs:
       - uses: actions/checkout@v2
         with:
           submodules: 'recursive'
+
+      - uses: actions/download-artifact@v2
+        with:
+          name: 'docstrings'
+          path: docstrings
+      - name: Specify docstring to use while building the wheel
+        run: echo "DEPTHAI_PYTHON_DOCSTRINGS_INPUT=$PWD/docstrings/depthai_python_docstring.hpp" >> $GITHUB_ENV
+
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v2
         with: 
@@ -117,6 +186,7 @@ jobs:
 
   # This job builds wheels for x86_64 arch
   build-linux-x86_64:
+    needs: build-docstrings
     runs-on: ubuntu-latest
     container:
       image: quay.io/pypa/manylinux2014_x86_64
@@ -139,6 +209,14 @@ jobs:
           ln -s /opt/python/cp38-cp38/bin/cmake /bin/
       - name: Create folder structure
         run: mkdir -p wheelhouse/audited/
+
+      - uses: actions/download-artifact@v2
+        with:
+          name: 'docstrings'
+          path: docstrings
+      - name: Specify docstring to use while building the wheel
+        run: echo "DEPTHAI_PYTHON_DOCSTRINGS_INPUT=$PWD/docstrings/depthai_python_docstring.hpp" >> $GITHUB_ENV
+
       - name: Append build hash if not a tagged commit
         if: startsWith(github.ref, 'refs/tags/v') != true
         run: echo "BUILD_COMMIT_HASH=${{github.sha}}" >> $GITHUB_ENV
@@ -156,7 +234,8 @@ jobs:
           name: audited-wheels
           path: wheelhouse/audited/
 
-  # Run tests
+
+  # # Run tests
   # tests:
   #   runs-on: luxonis-arm-tests
   #   needs: [build-linux-armhf, build-windows-x86_64, build-macos-x86_64, build-linux-x86_64]
@@ -219,3 +298,38 @@ jobs:
           PYPI_USER: ${{ secrets.PYPI_USER }}
           PYPI_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
 
+  release:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [deploy-pypi]
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: 'recursive'
+    
+    - name: Get tag version
+      id: tag
+      uses: battila7/get-version-action@v2
+
+    - name: Check if version matches
+      run: python3.8 -c 'import find_version as v; exit(0) if "${{ steps.tag.outputs.version-without-v }}" == v.get_package_version() else exit(1)'
+
+    # Create GitHub release
+    - uses: actions/create-release@master
+      id: createRelease
+      name: Create ${{ steps.releaseNote.outputs.version }} depthai-core release
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref }}
+        release_name: Release ${{ github.ref }}
+        body: |
+          ## Features
+
+          ## Bugs
+
+          ## Misc
+
+        draft: true
+

.gitignore

@@ -23,5 +23,8 @@ depthai-core/build/
 # builds
 _builds/
 
+#git
+*.orig
+
 #ci
 wheelhouse/

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "depthai-core"]
 	path = depthai-core
-	url = ../depthai-core.git
+	url = ../../luxonis/depthai-core.git

.readthedocs.yml

@@ -0,0 +1,34 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+build:
+  image: latest
+
+# Submodules
+submodules:
+  include:
+    - depthai-core
+  recursive: true
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  builder: dirhtml
+  configuration: docs/readthedocs/conf.py
+
+# Build documentation with MkDocs
+#mkdocs:
+#  configuration: mkdocs.yml
+
+# 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.8
+  install:
+    - requirements: docs/readthedocs/requirements.txt