tweaked active operator

We try to apply scales using bim.update_representation and if didn't worked (presumably because object has openings) we reset the scales.
It was confusing for users that they scaled an object, saved IFC and they would know that scaling didn't worked only after they reopen the IFC project.

.github/workflows/ci-bcf-pypi.yml

@@ -1,24 +1,8 @@
 name: ci-bcf-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
-  push:
-    paths:
-      - '.github/workflows/ci-bcf-pypi.yml'
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -38,7 +22,7 @@ jobs:
       - uses: actions/checkout@v2 # https://github.com/actions/checkout
       - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
         with:
-          python-version: '3.10' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
           architecture: 'x64' # optional x64 or x86. Defaults to x64 if not specified
       - run: echo ${{ env.DATE }}
       - name: Get current date
@@ -48,10 +32,10 @@ jobs:
         run: |
           pip install build
           cd src/bcf &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:
           user: __token__
           password: ${{ secrets.PYPI_API_TOKEN }}
-          packages_dir: src/bcf/dist
+          packages_dir: src/bcf/dist

.github/workflows/ci-black-formatting.yml

@@ -0,0 +1,12 @@
+name: ci-black-formatting
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  lint-formatting:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: psf/black@stable

.github/workflows/ci-blenderbim-choco.yml

@@ -1,92 +0,0 @@
-name: Publish-blenderbim-chocolatey package
-
-on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron:  "30 0 * * *" # 30min past utc midnight
-
-env:
-  major: 0
-  minor: 0
-  name: blenderbim
-  choco_version: 1.1.0
-  CHOCO_TOKEN:   ${{ secrets.CHOCO_TOKEN }}
-
-jobs:
-  activate:
-    runs-on: ubuntu-latest
-    if: |
-      github.repository == 'IfcOpenShell/IfcOpenShell'
-    steps:
-    - name: Set env
-      run: echo ok go
-
-  build:
-    needs: activate
-    name: ${{ matrix.config.name }}-${{ matrix.pyver }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        pyver: [py310]
-        config:
-          - {
-            name: "Windows Build",
-            short_name: win,
-          }
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
-        with:
-          python-version: '3.10.9' # Version range or exact version of a Python version to use, using SemVer's version range syntax
-          architecture: 'x64' # optional x64 or x86. Defaults to x64 if not specified
-      - run: echo ${{ env.DATE }}
-
-      - name: Check in published releases if we should do a choco release
-        id: do_choco
-        run: |
-          echo "::set-output name=choco_release::$(python3 /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/check_repo_infos.py --do_choco_release?)"
-
-      - name: Fill chocolatey scripts on win with latest blender python
-        if: ${{steps.do_choco.outputs.choco_release}} == 'do_choco_release'
-        run: |
-          yesterday_non_iso="$(date  --date='yesterday' +'%y%m%d' | tr -d '\n')" &&
-          target_os=${{ matrix.config.short_name }} &&
-          latest_blender_python_version_maj_min=$(python3 /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/check_repo_infos.py --latest_blender_python_version_maj_min?) &&
-          echo "latest_blender_python_version_maj_min?: $latest_blender_python_version_maj_min" &&
-          pyver=$(python3 /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/check_repo_infos.py --pyver?) &&
-          export latest_blender_version_maj_min=$(python3 /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/check_repo_infos.py --latest_blender_release_maj_min?) &&
-          export latest_blender_version_maj_min_pat=$(python3 /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/check_repo_infos.py --latest_blender_release_maj_min_pat?) &&
-          echo   latest_blender_version_maj_min_pat?: $latest_blender_version_maj_min_pat &&
-          export blenderbim_build_version="${{ env.major }}.${{ env.minor }}.$yesterday_non_iso" &&
-          export url_blenderbim_py310_win_zip="https://github.com/IfcOpenShell/IfcOpenShell/releases/download/blenderbim-$yesterday_non_iso/blenderbim-$yesterday_non_iso-$pyver-$target_os.zip" &&
-          wget $url_blenderbim_py310_win_zip --no-verbose &&
-          export sha256sum_blenderbim_py310_win_zip=$( sha256sum blenderbim-$yesterday_non_iso-$pyver-$target_os.zip  --tag | cut -d ' ' -f 4  | tr -d '\n') &&
-          echo   sha256sum_blenderbim_py310_win_zip: $sha256sum_blenderbim_py310_win_zip &&
-          python3 choco/blenderbim/fill_dynamic_parameters.py &&
-          echo __build choco with mono &&
-          wget "https://github.com/chocolatey/choco/archive/refs/tags/$choco_version.tar.gz" --quiet &&
-          tar -xzf "$choco_version.tar.gz" &&
-          cd choco-$choco_version &&
-          chmod +x build.sh zip.sh &&
-          ./build.sh &&
-          cp -r build_output/chocolatey /opt/chocolatey &&
-          cd /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/ &&
-          echo __choco pack &&
-          mono /opt/chocolatey/choco.exe --version &&
-          mono /opt/chocolatey/choco.exe pack --allow-unofficial &&
-          echo __choco set apiKey &&
-          mono /opt/chocolatey/choco.exe setapikey --key="$CHOCO_TOKEN" --source="https://push.chocolatey.org/" --allow-unofficial # &&
-          echo __choco push &&
-          mono /opt/chocolatey/choco.exe push --source="https://push.chocolatey.org/" --key="$CHOCO_TOKEN" --allow-unofficial --verbose
-
-      - name: Inform user about not packaging
-        if: ${{steps.do_choco.outputs.choco_release}} != 'do_choco_release'
-        run: |
-          echo "no releases found today ${{ env.DATE }}, therefore choco packaging is skipped."
-

.github/workflows/ci-blenderbim-daily.yml

@@ -1,81 +0,0 @@
-name: ci-blenderbim-daily
-
-on:
-  push:
-    paths:
-      - '.github/workflows/ci-blenderbim-matrix.yml'
-      - 'src/blenderbim/**'
-      - 'src/ifcopenshell-python/ifcopenshell/**'
-      - 'src/bcf/src/bcf/**'
-      - 'src/ifcclash/ifcclash/**'
-      - 'src/ifccobie/**'
-      - 'src/ifcdiff/**'
-      - 'src/ifccsv/**'
-      - 'src/ifcpatch/ifcpatch/**'
-      - 'src/ifc4d/ifc4d/**'
-      - 'src/ifc5d/ifc5d/**'
-      - 'src/ifccityjson/**'
-    branches:
-      - v0.8.0
-  workflow_dispatch:
-
-jobs:
-  activate:
-    runs-on: ubuntu-latest
-    if: |
-      github.repository == 'IfcOpenShell/IfcOpenShell'
-    steps:
-    - name: Set env
-      run: echo ok go
-
-  build:
-    needs: activate
-    name: ${{ matrix.config.name }}-${{ matrix.pyver }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        pyver: [py39, py310, py311, py312]
-        config:
-          - {
-            name: "Windows Build",
-            short_name: win,
-          }
-          - {
-            name: "Linux Build",
-            short_name: linux
-          }
-          - {
-            name: "MacOS Build",
-            short_name: macos
-          }
-          - {
-            name: "MacOS ARM Build",
-            short_name: macosm1
-          }
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
-        with:
-          architecture: 'x64' # optional x64 or x86. Defaults to x64 if not specified
-          python-version: '3.11'
-      - name: Get current version
-        id: version
-        run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT
-      - name: Get current date
-        id: date
-        run: echo "date=$(date +'%y%m%d')" >> $GITHUB_OUTPUT
-      - name: Compile
-        run: |
-          cp -r src/blenderbim src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
-          cd src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
-          make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }}
-      - name: Upload zip file to release
-        uses: svenstaro/upload-release-action@v2
-        with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          file: src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }}/dist/blenderbim-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}-${{ matrix.pyver }}-${{ matrix.config.short_name }}.zip
-          asset_name: blenderbim-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}-${{ matrix.pyver }}-${{ matrix.config.short_name }}.zip
-          release_name: "blenderbim-${{steps.version.outputs.version}}.${{steps.date.outputs.date}} (unstable)"
-          tag: "blenderbim-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}"
-          overwrite: true

.github/workflows/ci-bonsai-choco.yml

@@ -0,0 +1,47 @@
+name: ci-bonsai-choco
+
+on:
+  schedule:
+    #         ┌───────────── minute (0 - 59)
+    #         │  ┌───────────── hour (0 - 23)
+    #         │  │ ┌───────────── day of the month (1 - 31)
+    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
+    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
+    #         *  * * * *
+    - cron:  "30 0 * * *" # 30min past utc midnight
+  workflow_dispatch:
+
+env:
+  major: 0
+  minor: 0
+  name: bonsai
+  choco_version: 1.1.0
+  CHOCO_TOKEN:   ${{ secrets.CHOCO_TOKEN }}
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    name: "choco_release"
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+          fetch-depth: 0
+      - run: echo ${{ env.DATE }}
+      - name: Check in release tags if we should do a choco release and perform the release if needed
+        id: do_choco_release
+        run: |
+          pip install pygithub
+          cd /home/runner/work/IfcOpenShell/IfcOpenShell/choco/bonsai/ &&
+          python3 choco_release.py

.github/workflows/ci-bonsai-daily.yml

@@ -0,0 +1,158 @@
+name: ci-bonsai-daily
+
+on:
+  push:
+    paths:
+      - '.github/workflows/ci-bonsai-daily.yml'
+      - 'src/bonsai/**'
+      - 'src/ifcopenshell-python/ifcopenshell/**'
+      - 'src/bcf/bcf/**'
+      - 'src/ifcclash/ifcclash/**'
+      - 'src/ifccobie/**'
+      - 'src/ifcdiff/**'
+      - 'src/ifccsv/**'
+      - 'src/ifcpatch/ifcpatch/**'
+      - 'src/ifc4d/ifc4d/**'
+      - 'src/ifc5d/ifc5d/**'
+      - 'src/ifccityjson/**'
+    branches:
+      - v0.8.0
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    name: ${{ matrix.config.name }}-${{ matrix.pyver }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        pyver: [py311, py312]
+        config:
+          - {
+            name: "Windows Build",
+            short_name: win,
+          }
+          - {
+            name: "Linux Build",
+            short_name: linux,
+          }
+          - {
+            name: "MacOS Build",
+            short_name: macos,
+          }
+          - {
+            name: "MacOS ARM Build",
+            short_name: macosm1,
+          }
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          architecture: 'x64' # optional x64 or x86. Defaults to x64 if not specified
+          python-version: '3.11'
+      - name: Get current version
+        id: version
+        run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT
+      - name: Get current date
+        id: date
+        # Include hours and minutes to release tag
+        # to avoid possibility of unstable repo's index.json
+        # pointing to the new file when index.json itself wasn't yet updated.
+        run: echo "date=$(date +'%y%m%d%H%M')" >> $GITHUB_OUTPUT
+      - name: Compile
+        run: |
+          cd src/bonsai && make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }}
+      - name: Find zip file name
+        id: find_zip
+        run: |
+          filepath=$(ls src/bonsai/dist/bonsai_*.zip)
+          echo "filepath=$filepath" >> $GITHUB_OUTPUT
+          echo "filename=$(basename $filepath)" >> $GITHUB_OUTPUT
+      - name: Upload zip file to release
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: ${{ steps.find_zip.outputs.filepath }}
+          asset_name: ${{ steps.find_zip.outputs.filename }}
+          release_name: "bonsai-${{steps.version.outputs.version}}-alpha${{steps.date.outputs.date}} (unstable)"
+          tag: "bonsai-${{steps.version.outputs.version}}-alpha${{steps.date.outputs.date}}"
+          overwrite: true
+          body: "See README in https://github.com/IfcOpenShell/bonsai_unstable_repo/ on how to setup autoupdates for daily Bonsai builds."
+
+  update-extensions-repo-and-run-tests:
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout bonsai_unstable_repo repository
+        uses: actions/checkout@v2
+        with:
+          repository: IfcOpenShell/bonsai_unstable_repo
+          token: ${{ secrets.IOS_TO_BLENDER_REPO }}
+          path: bonsai_unstable_repo
+
+      - name: Update index.json on extensions repo
+        run: |
+          set -x -e
+
+          # Download Blender.
+          wget -q -O blender.tar.xz https://ftp.nluug.nl/pub/graphics/blender/release/Blender4.2/blender-4.2.0-linux-x64.tar.xz
+          tar -xf blender.tar.xz
+
+          # Setup Blender.
+          BLENDER_PATH=$(find blender-*/ -maxdepth 0 -exec readlink -f {} \;)
+          export PATH="$PATH:$BLENDER_PATH"
+          blender --version
+
+          cd bonsai_unstable_repo
+          pip install -r requirements.txt
+          python setup_extensions_repo.py --last-tag
+          git config --global user.name 'IfcOpenBot'
+          git config --global user.email 'IfcOpenBot@users.noreply.github.com'
+          git add index.json
+          git add readme.md
+          git commit -m "Update index.json"
+          git push
+      - name: Run bonsai tests
+        run: |
+          set -x -e
+          BLENDER_PATH=$(find blender-*/ -maxdepth 0 -exec readlink -f {} \;)
+          export PATH="$PATH:$BLENDER_PATH"
+          bonsai_zip="$(pwd)/$(ls bonsai_unstable_repo/bonsai_py311*-linux-x64.zip)"
+          blender --version
+          blender --command extension install-file -r user_default -e $bonsai_zip
+          blender --command extension list
+
+          wget -q -O sverchok.zip https://github.com/nortikin/sverchok/archive/refs/heads/master.zip
+          # ifcsverchok expecting sverchok to be named "sverchok" and not "sverchok-master".
+          unzip -q sverchok.zip
+          mv sverchok-master sverchok
+          zip -q -r sverchok.zip sverchok
+          rm -r sverchok
+          blender --command extension install-file -r user_default sverchok.zip
+
+          git clone https://github.com/IfcOpenShell/IfcOpenShell.git IfcOpenShell
+          cd IfcOpenShell/src/ifcsverchok
+          make dist
+          sverchok_zip="$(pwd)/dist/$(ls dist)"
+          blender --command extension install-file -r user_default $sverchok_zip
+
+          # Install Sun Position extension.
+          blender --online-mode --command extension sync
+          blender --online-mode --background --python-expr "import bpy; \
+          bpy.ops.extensions.package_install(repo_index=0, pkg_id='sun_position'); \
+          bpy.ops.preferences.addon_enable(module='bl_ext.blender_org.sun_position'); bpy.ops.wm.save_userpref()"
+
+          cd ../bonsai
+          pip install pytest-blender
+          blender --background --python scripts/setup_pytest.py
+          blender --python-expr "import bonsai; print(bonsai.bbim_semver); import ifcopenshell; print(ifcopenshell.version)" --background
+          make test

.github/workflows/ci-bonsai.yml

@@ -1,4 +1,9 @@
-name: ci-blenderbim
+name: ci-bonsai
+
+# Differences from ci-bonsai-daily.yml:
+# - make has IS_STABLE=TRUE
+# - action is never triggered and executed only manually
+# - doesn't add a current date to the release and tag
 
 on:
   workflow_dispatch:
@@ -19,7 +24,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        pyver: [py39, py310, py311, py312]
+        pyver: [py311, py312]
         config:
           - {
             name: "Windows Build",
@@ -27,15 +32,15 @@ jobs:
           }
           - {
             name: "Linux Build",
-            short_name: linux
+            short_name: linux,
           }
           - {
             name: "MacOS Build",
-            short_name: macos
+            short_name: macos,
           }
           - {
             name: "MacOS ARM Build",
-            short_name: macosm1
+            short_name: macosm1,
           }
     steps:
       - uses: actions/checkout@v2
@@ -48,15 +53,19 @@ jobs:
         run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT
       - name: Compile
         run: |
-          cp -r src/blenderbim src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
-          cd src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
-          make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }} IS_STABLE=TRUE
+          cd src/bonsai && make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }} IS_STABLE=TRUE
+      - name: Find zip file name
+        id: find_zip
+        run: |
+          filepath=$(ls src/bonsai/dist/bonsai_*.zip)
+          echo "filepath=$filepath" >> $GITHUB_OUTPUT
+          echo "filename=$(basename $filepath)" >> $GITHUB_OUTPUT
       - name: Upload zip file to release
         uses: svenstaro/upload-release-action@v2
         with:
           repo_token: ${{ secrets.GITHUB_TOKEN }}
-          file: src/blenderbim_${{ matrix.config.short_name }}_${{ matrix.pyver }}/dist/blenderbim-${{steps.version.outputs.version}}-${{ matrix.pyver }}-${{ matrix.config.short_name }}.zip
-          asset_name: blenderbim-${{steps.version.outputs.version}}-${{ matrix.pyver }}-${{ matrix.config.short_name }}.zip
-          release_name: "blenderbim-${{steps.version.outputs.version}}"
-          tag: "blenderbim-${{steps.version.outputs.version}}"
+          file: ${{ steps.find_zip.outputs.filepath }}
+          asset_name: ${{ steps.find_zip.outputs.filename }}
+          release_name: "bonsai-${{steps.version.outputs.version}}"
+          tag: "bonsai-${{steps.version.outputs.version}}"
           overwrite: true

.github/workflows/ci-bsdd-pypi.yaml

@@ -1,21 +1,8 @@
 name: ci-bsdd-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -39,7 +26,7 @@ jobs:
         run: |
           pip install build
           cd src/bsdd &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-ifc4d-pypi.yaml

@@ -0,0 +1,35 @@
+name: ci-ifc4d-pypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+      - name: Compile
+        run: |
+          pip install build
+          cd src/ifc4d &&
+          make dist IS_STABLE=TRUE
+      - name: Publish a Python distribution to PyPI
+        uses: ortega2247/pypi-upload-action@master
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages_dir: src/ifc4d/dist

.github/workflows/ci-ifc5d-pypi.yaml

@@ -0,0 +1,35 @@
+name: ci-ifc5d-pypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+      - name: Compile
+        run: |
+          pip install build
+          cd src/ifc5d &&
+          make dist IS_STABLE=TRUE
+      - name: Publish a Python distribution to PyPI
+        uses: ortega2247/pypi-upload-action@master
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages_dir: src/ifc5d/dist

.github/workflows/ci-ifccityjson-pypi.yaml

@@ -0,0 +1,35 @@
+name: ci-ifccityjson-pypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+      - name: Compile
+        run: |
+          pip install build
+          cd src/ifccityjson &&
+          make dist IS_STABLE=TRUE
+      - name: Publish a Python distribution to PyPI
+        uses: ortega2247/pypi-upload-action@master
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages_dir: src/ifccityjson/dist

.github/workflows/ci-ifcclash-pypi.yaml

@@ -1,21 +1,8 @@
 name: ci-ifcclash-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -39,7 +26,7 @@ jobs:
         run: |
           pip install build
           cd src/ifcclash &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-ifcconvert.yml

@@ -0,0 +1,65 @@
+name: ci-ifcconvert
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    name: ${{ matrix.config.name }}-${{ matrix.pyver }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+          - {
+            name: "Windows 64bit",
+            short_name: win64,
+          }
+          - {
+            name: "Windows 32bit",
+            short_name: win32,
+          }
+          - {
+            name: "Linux 64bit",
+            short_name: linux64
+          }
+          - {
+            name: "MacOS Intel 64bit",
+            short_name: macos64
+          }
+          - {
+            name: "MacOS Silicon 64bit",
+            short_name: macosm164
+          }
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+          architecture: 'x64' # optional x64 or x86. Defaults to x64 if not specified
+      - run: echo ${{ env.DATE }}
+      - name: Get current version
+        id: version
+        run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT
+      - name: Compile
+        run: |
+          cd src/ifcopenshell-python &&
+          make zip-ifcconvert PLATFORM=${{ matrix.config.short_name }}
+      - name: Upload zip file to release
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: src/ifcopenshell-python/dist/ifcconvert-${{ steps.version.outputs.version }}-${{ matrix.config.short_name }}.zip
+          asset_name: ifcconvert-${{ steps.version.outputs.version }}-${{ matrix.config.short_name }}.zip
+          release_name: "ifcconvert-${{steps.version.outputs.version}}"
+          tag: "ifcconvert-${{steps.version.outputs.version}}"
+          overwrite: true

.github/workflows/ci-ifccsv-pypi.yaml

@@ -1,21 +1,8 @@
 name: ci-ifccsv-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -39,7 +26,7 @@ jobs:
         run: |
           pip install build
           cd src/ifccsv &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-ifcdiff-pypi.yaml

@@ -0,0 +1,35 @@
+name: ci-ifcdiff-pypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+      - name: Compile
+        run: |
+          pip install build
+          cd src/ifcdiff &&
+          make dist IS_STABLE=TRUE
+      - name: Publish a Python distribution to PyPI
+        uses: ortega2247/pypi-upload-action@master
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages_dir: src/ifcdiff/dist

.github/workflows/ci-ifcfm-pypi.yaml

@@ -0,0 +1,35 @@
+name: ci-ifcfm-pypi
+
+on:
+  workflow_dispatch:
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+    - name: Set env
+      run: echo ok go
+
+  build:
+    needs: activate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+        with:
+          python-version: '3.11' # Version range or exact version of a Python version to use, using SemVer's version range syntax
+      - name: Compile
+        run: |
+          pip install build
+          cd src/ifcfm &&
+          make dist IS_STABLE=TRUE
+      - name: Publish a Python distribution to PyPI
+        uses: ortega2247/pypi-upload-action@master
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages_dir: src/ifcfm/dist

.github/workflows/ci-ifcopenshell-conda-cleaner.yml

@@ -0,0 +1,104 @@
+name: ci-ifcopenshell-conda-daily-cleaner
+
+on:
+  workflow_dispatch:
+  schedule:
+  #         ┌───────────── minute (0 - 59)
+  #         │  ┌───────────── hour (0 - 23)
+  #         │  │ ┌───────────── day of the month (1 - 31)
+  #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
+  #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
+  #         *  * * * *
+  - cron: "00 23 * * *" # 11min before utc midnight every day
+
+env:
+  ANACONDA_TOKEN: ${{ secrets.ANACONDA_TOKEN }}
+  NUM_SUPPORTED_VERSIONS: 5
+
+jobs:
+  activate:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash -l {0}
+    if: |
+      github.repository == 'IfcOpenShell/IfcOpenShell'
+    steps:
+      - uses: mamba-org/setup-micromamba@v1 # https://github.com/mamba-org/setup-micromamba
+        with:
+          environment-name: test-env
+          create-args: >-
+            python=3.11
+            anaconda-client=1.12.3
+
+      - name: Run conda cleaner
+        run: |
+          python - << EOF
+          
+          import os
+          from datetime import datetime, timedelta
+          from binstar_client.utils import get_server_api
+          from binstar_client.errors import BinstarError
+          
+          # Configuration
+          api_token = os.environ.get('ANACONDA_TOKEN')
+          pkg_name = 'ifcopenshell'
+          channel_name = 'ifcopenshell'
+          
+          # Authenticate with Anaconda
+          aserver_api = get_server_api(token=api_token)
+          
+          
+          # Get the list of packages in the channel
+          def get_package(filter_package_name: str = None):
+              try:
+                  user_packages = aserver_api.user_packages(channel_name)
+                  if filter_package_name:
+                      user_packages = [pkg for pkg in user_packages if pkg['name'] == filter_package_name]
+                  if len(user_packages) == 0:
+                      print(f"No packages found for {filter_package_name}.")
+                  if len(user_packages) > 1:
+                      raise ValueError(f"Found {len(user_packages)} package for {filter_package_name}. Will only support 1 package.")
+          
+                  return user_packages[0]
+              except BinstarError as err:
+                  raise ValueError(f"Failed to fetch packages: {err}")
+          
+          
+          # Delete a package version
+          def delete_package(package_name, version):
+              try:
+                  aserver_api.remove_release(channel_name, package_name, version)
+                  print(f"Deleted {package_name} version {version}")
+              except BinstarError as err:
+                  print(f"Failed to delete {package_name} version {version}: {err}")
+          
+          
+          # Main logic
+          def main():
+              package = get_package(pkg_name)
+              if not package:
+                  print("No packages found.")
+                  return
+          
+              number_of_supported_versions = ${{ env.NUM_SUPPORTED_VERSIONS }}
+          
+              package_name = package['name']
+              versions = package["versions"]
+              if len(versions) <= number_of_supported_versions:
+                  print(f"Number of versions {len(versions)} is less than or equal to {number_of_supported_versions}.")
+                  return
+          
+              # sort the versions in descending order
+              print(f"Before reversal: {versions=}")
+              versions.reverse()
+              print(f"After reversal: {versions=}")
+          
+              releases = versions[number_of_supported_versions:]
+          
+              for release in releases:
+                  delete_package(package_name, release)
+          
+          main()
+          
+          EOF

.github/workflows/ci-ifcopenshell-conda-daily.yml

@@ -2,21 +2,44 @@ name: ci-ifcopenshell-conda-daily-v0.8.0
 
 on:
   workflow_dispatch:
-  push:
-    branches:
-      - v0.8.0
+  schedule:
+  #         ┌───────────── minute (0 - 59)
+  #         │  ┌───────────── hour (0 - 23)
+  #         │  │ ┌───────────── day of the month (1 - 31)
+  #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
+  #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
+  #         *  * * * *
+  - cron: "49 23 * * *" # 11min before utc midnight every day
 
 jobs:
   activate:
     runs-on: ubuntu-latest
     if: |
       github.repository == 'IfcOpenShell/IfcOpenShell'
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      date: ${{ steps.date.outputs.date }}
+      verdate: ${{ steps.verdate.outputs.verdate }}
     steps:
+      - uses: actions/checkout@v4
       - name: Set env
         run: echo ok go
+      
+      - name: Get current version
+        id: version
+        run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT
+      
+      - name: Get current date
+        id: date
+        run: echo "date=$(date +'%y%m%d')" >> $GITHUB_OUTPUT
 
+      - name: Version + date str
+        id: verdate
+        run: echo "verdate='${{ steps.version.outputs.version }}alpha${{ steps.date.outputs.date }}'" >> $GITHUB_OUTPUT
+
+      
   test:
-    name: ${{ matrix.platform.distver }}-${{ matrix.pyver.name }}
+    name: ${{ matrix.platform.distver }}-${{ matrix.pyver.name }}-${{ matrix.variant }}
     needs: activate
     runs-on: ${{ matrix.platform.distver }}
     defaults:
@@ -25,8 +48,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
+        variant: [novtk, all]
         pyver: [
-          { name: py311, distver: '3.11'},
+#          { name: py311, distver: '3.11'},
           { name: py312, distver: '3.12'}
         ]
         platform: [
@@ -35,24 +59,28 @@ jobs:
           { name: macOS, distver: macos-latest, pkg_dir: 'osx-64' }
         ]
     steps:
-      - uses: actions/checkout@v3
+      - name: Set up swap space
+        if: runner.os == 'Linux'
+        uses: pierotofy/set-swap-space@v1.0
+        with:
+          swap-size-gb: 10
+
+      - uses: actions/checkout@v4
         with:
           submodules: recursive
 
       - name: Download and extract MacOSX SDK
-        if: ${{ matrix.platform.name == 'macOS' }}
+        if: ${{ runner.os == 'macOS' }}
         run: |
-          curl -o MacOSX10.13.sdk.tar.xz -L https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX10.13.sdk.tar.xz && \
-          tar xf MacOSX10.13.sdk.tar.xz && \
-          sudo mv -v MacOSX10.13.sdk /opt/ && \
-          ls /opt/
-      - uses: seanmiddleditch/gha-setup-ninja@master
+          curl -L https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX10.13.sdk.tar.xz | tar -xvJf - -C /Users/runner/work/
+
       - uses: mamba-org/setup-micromamba@v1 # https://github.com/mamba-org/setup-micromamba
         with:
-          environment-file: conda/environment.build.yml
+          environment-name: test-env
           create-args: >-
-            python=${{ matrix.pyver.distver }}
+            python=3.11
             anaconda-client
+            boa
 
       - name: create conda package dist dir
         run: |
@@ -60,8 +88,10 @@ jobs:
 
       - name: build & test ifcopenshell
         run: |
-          boa build . --python ${{ matrix.pyver.distver }} --no-remove-work-dir --output-folder '${{ github.workspace }}/dist'
+          conda mambabuild . --python ${{ matrix.pyver.distver }} --no-remove-work-dir --output-folder '${{ github.workspace }}/dist' --variants='{variant: ${{ matrix.variant }}}'
         working-directory: ./conda
+        env:
+          VERSION_OVERRIDE: ${{ needs.activate.outputs.verdate }}
 
       - name: upload to anaconda
         if: ${{ matrix.platform.name == 'win' }}
@@ -71,4 +101,4 @@ jobs:
       - name: upload to anaconda
         if: ${{ matrix.platform.name != 'win' }}
         run: |
-          anaconda -t ${{ secrets.ANACONDA_TOKEN }} upload --force --user ifcopenshell ${{ github.workspace }}/dist/${{ matrix.platform.pkg_dir }}/*.tar.bz2
+          anaconda -t ${{ secrets.ANACONDA_TOKEN }} upload --force --user ifcopenshell ${{ github.workspace }}/dist/${{ matrix.platform.pkg_dir }}/*.tar.bz2

.github/workflows/ci-ifcopenshell-docker.yml

@@ -6,7 +6,6 @@ on:
       tags:
         - v0.**
 
-
 jobs:
 
   activate:
@@ -94,7 +93,7 @@ jobs:
         lfs: true
     
     - name: Download 
-      uses: actions/download-artifact@v2
+      uses: actions/download-artifact@v4.1.7
       with:
         # Artifact name
         name: ifcos-artifacts
@@ -117,6 +116,8 @@ jobs:
       with: 
         context: artifacts
         repository: aecgeeks/ifcopenshell
-        tags: aecgeeks/ifcopenshell:latest
+        # Since the dispatch is set to `tag`, `github.ref_name` should evaluate to the pushed tag
+        # On a workflow dispatch, `ref_name` will take on the value from the dispatch payload
+        tags: aecgeeks/ifcopenshell:${{ github.ref_name }}${{ github.ref_name == github.event.repository.default_branch && ',aecgeeks/ifcopenshell:latest' }}
         file: ./Dockerfile
         push: true

.github/workflows/ci-ifcopenshell-python-pypi.yml

@@ -27,19 +27,19 @@ jobs:
         pyver: [py39, py310, py311, py312]
         config:
           - {
-            name: "Windows Build",
+            name: "Windows 64bit",
             short_name: win64,
           }
           - {
-            name: "Linux Build",
+            name: "Linux 64bit",
             short_name: linux64
           }
           - {
-            name: "MacOS Build",
+            name: "MacOS Intel 64bit",
             short_name: macos64
           }
           - {
-            name: "MacOS ARM Build",
+            name: "MacOS Silicon 64bit",
             short_name: macosm164
           }
     steps:
@@ -57,7 +57,7 @@ jobs:
           pip install build
           cp -r src/ifcopenshell-python src/ifcopenshell_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
           cd src/ifcopenshell_${{ matrix.config.short_name }}_${{ matrix.pyver }} &&
-          make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }}
+          make dist PLATFORM=${{ matrix.config.short_name }} PYVERSION=${{ matrix.pyver }} IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-ifcopenshell-python.yml

@@ -22,19 +22,23 @@ jobs:
         pyver: [py39, py310, py311, py312]
         config:
           - {
-            name: "Windows Build",
+            name: "Windows 64bit",
             short_name: win64,
           }
           - {
-            name: "Linux Build",
+            name: "Windows 32bit",
+            short_name: win32,
+          }
+          - {
+            name: "Linux 64bit",
             short_name: linux64
           }
           - {
-            name: "MacOS Build",
+            name: "MacOS Intel 64bit",
             short_name: macos64
           }
           - {
-            name: "MacOS ARM Build",
+            name: "MacOS Silicon 64bit",
             short_name: macosm164
           }
     steps:

.github/workflows/ci-ifcpatch-pypi.yaml

@@ -1,21 +1,8 @@
 name: ci-ifcpatch-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -39,7 +26,7 @@ jobs:
         run: |
           pip install build
           cd src/ifcpatch &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-ifcsverchok-daily.yml

@@ -46,6 +46,6 @@ jobs:
           repo_token: ${{ secrets.GITHUB_TOKEN }}
           file: src/ifcsverchok/dist/ifcsverchok-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}.zip
           asset_name: ifcsverchok-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}.zip
-          release_name: "ifcsverchok-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}"
+          release_name: "ifcsverchok-${{steps.version.outputs.version}}.${{steps.date.outputs.date}} (unstable)"
           tag: "ifcsverchok-${{steps.version.outputs.version}}.${{steps.date.outputs.date}}"
           overwrite: true

.github/workflows/ci-ifctester-pypi.yml

@@ -1,21 +1,8 @@
 name: ci-ifctester-pypi
 
 on:
-  schedule:
-    #         ┌───────────── minute (0 - 59)
-    #         │  ┌───────────── hour (0 - 23)
-    #         │  │ ┌───────────── day of the month (1 - 31)
-    #         │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
-    #         │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
-    #         *  * * * *
-    - cron: "0 0 18 * *"
   workflow_dispatch:
 
-env:
-  major: 0
-  minor: 0
-  name: ifcopenshell
-
 jobs:
   activate:
     runs-on: ubuntu-latest
@@ -39,7 +26,7 @@ jobs:
         run: |
           pip install build
           cd src/ifctester &&
-          make dist
+          make dist IS_STABLE=TRUE
       - name: Publish a Python distribution to PyPI
         uses: ortega2247/pypi-upload-action@master
         with:

.github/workflows/ci-restart-failed-daily-conda-builds.yml

@@ -1,34 +0,0 @@
-name: Restart failed daily conda builds
-
-on:
-  workflow_run:
-    workflows: [ ci-ifcopenshell-conda-daily ]
-    types:
-      - completed
-
-env:
-  REPO_OWNER: IfcOpenShell/IfcOpenShell
-  MY_WORKFLOW: ci-ifcopenshell-conda-daily
-
-jobs:
-  restart-failed-runs:
-    runs-on: ubuntu-latest
-    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
-    steps:
-      - name: checkout
-        uses: actions/checkout@v3
-      - name: Use python 3.11
-        uses: actions/setup-python@v2
-        with:
-          python-version: 3.11
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install requests
-      - name: Check for failed runs
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          WORKFLOW_RUN_ID: ${{ github.event.workflow_run.id }}
-        run: |
-          python check_repo_ci_jobs.py
-        working-directory: .github/workflows

.github/workflows/ci.yml

@@ -47,6 +47,7 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install xmlschema xsdata numpy lxml pytest isodate lark networkx tabulate python-dateutil shapely
+          pip install mathutils
           pip install src/bcf --no-deps
           pip install https://github.com/Andrej730/aud/archive/refs/heads/master-reduced-size.zip
 
@@ -106,7 +107,7 @@ jobs:
 
       - name: Run IfcConvert on Sample files
         run: |
-          (find test/input src/blenderbim/test/files -name '*.ifc' | while read i; do \
+          (find test/input src/bonsai/test/files -name '*.ifc' | while read i; do \
             echo $i | tee -a log; \
             timeout 1m "$(which IfcConvert)" -yv "$i" "$i.obj" --validate >> log 2>&1; \
             echo $i $? >> statuses; \
@@ -125,4 +126,11 @@ jobs:
           python tests.py
           cd ../src/ifcopenshell-python
           mv ifcopenshell ifcopenshell-local # Force testing on installed module
-          make test-safe
+          make test
+          cd ../bcf && make test
+          pip install requests
+          cd ../bsdd && make test
+          pip install deepdiff
+          cd ../ifcdiff && make test
+          cd ../ifcpatch && make test
+          cd ../ifctester && make test

.github/workflows/release.yml

@@ -8,12 +8,12 @@ on:
 jobs:
   activate:
     if: github.repository == 'IfcOpenShell/IfcOpenShell'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
     - run: echo ok go
   build:
     needs: activate
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
       - name: Checkout
         uses: actions/checkout@v2
@@ -52,8 +52,8 @@ jobs:
            -DOCC_INCLUDE_DIR=/usr/include/opencascade \
            -DOCC_LIBRARY_DIR=/usr/lib/x86_64-linux-gnu \
            -DPYTHON_EXECUTABLE:FILEPATH=/usr/bin/python3 \
-           -DPYTHON_INCLUDE_DIR:PATH=/usr/include/python3.8 \
-           -DPYTHON_LIBRARY:FILEPATH=/usr/lib/x86_64-linux-gnu/libpython3.8.so \
+           -DPYTHON_INCLUDE_DIR:PATH=/usr/include/python3.10 \
+           -DPYTHON_LIBRARY:FILEPATH=/usr/lib/x86_64-linux-gnu/libpython3.10.so \
            -DLIBXML2_INCLUDE_DIR=/usr/include/libxml2 \
            -DLIBXML2_LIBRARIES=/usr/lib/x86_64-linux-gnu/libxml2.so \
            -DGLTF_SUPPORT=On \

.gitignore

@@ -73,19 +73,16 @@ src/ifcopenshell-python/test/build
 # mypy cache
 .mypy_cache
 
-# blenderbim libs
-src/blenderbim/blenderbim/libs
+# bonsai i18n
+src/bonsai/bonsai/translations.py
 
-# blenderbim i18n
-src/blenderbim/blenderbim/translations.py
+# bonsai test temp files
+src/bonsai/test/files/temp
+src/bonsai/test/files/basic.ifc.cache.blend
+src/bonsai/test/files/basic.ifc.cache.sqlite
 
-# blenderbim test temp files
-src/blenderbim/test/files/temp
-src/blenderbim/test/files/basic.ifc.cache.blend
-src/blenderbim/test/files/basic.ifc.cache.sqlite
-
-src/blenderbim/drawings
-src/blenderbim/layouts
+src/bonsai/drawings
+src/bonsai/layouts
 
 # ifcopenshell swig and compiled files
 src/ifcopenshell-python/ifcopenshell/_ifcopenshell_wrapper.so
@@ -100,4 +97,4 @@ src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.py
 .cache
 
 # Brickschema
-src/blenderbim/blenderbim/bim/schema/Brick.ttl
+src/bonsai/bonsai/bim/schema/Brick.ttl

Dockerfile

@@ -1,6 +1,6 @@
 # -*- mode: Dockerfile -*-
 
-FROM ubuntu:focal
+FROM ubuntu:22.04
 
 ARG CHANNEL
 ENV CHANNEL=${CHANNEL:-latest}
@@ -23,7 +23,7 @@ RUN echo "deb http://archive.ubuntu.com/ubuntu focal-proposed main restricted" |
     echo "deb http://archive.ubuntu.com/ubuntu focal-proposed multiverse" |  tee -a /etc/apt/sources.list; \
     apt-get -qq update; \
     apt-get -y install tzdata dos2unix rsync; \
-    apt-get -y install python3 libxml2 libpython3.8 \
+    apt-get -y install python3 libxml2 libpython3.10 \
                     libboost-all-dev \
                     libocct-foundation-dev libocct-modeling-algorithms-dev libocct-modeling-data-dev \
                     libocct-ocaf-dev libocct-visualization-dev libocct-data-exchange-dev \

README.md

@@ -12,7 +12,7 @@ is implemented for the IFC releases [IFC2x3 TC1] and [IFC4 Add2 TC1]. Extending
 is possible at compile-time when using C++ and at run-time when using Python.
 
 In addition to a C++ and Python API, IfcOpenShell comes with an ecosystem of tools, notably including IfcConvert (an application
-to convert IFC models to other formats), the BlenderBIM Add-on (an add-on to Blender providing a graphical IFC authoring platform),
+to convert IFC models to other formats), Bonsai (an add-on to Blender providing a graphical IFC authoring platform),
 and many other libraries, CLI apps, and more. Support is also provided for auxiliary standards such as BCF and IDS.
 
 For more information, see:
@@ -22,53 +22,49 @@ For more information, see:
   * [IfcOpenShell C++ Installation](https://docs.ifcopenshell.org/ifcopenshell/installation.html)
   * [IfcOpenShell Python Installation](https://docs.ifcopenshell.org/ifcopenshell-python/installation.html)
   * [IfcOpenShell Python Hello World Tutorial](https://docs.ifcopenshell.org/ifcopenshell-python/hello_world.html)
-* [BlenderBIM Add-on Website](https://blenderbim.org)
-* [BlenderBIM Add-on Documentation](https://docs.blenderbim.org/index.html)
-  * [Add-on Installation](https://docs.blenderbim.org/users/installation.html)
-  * [Exploring an IFC model](https://docs.blenderbim.org/users/exploring_an_ifc_model.html)
+* [Bonsai Website](https://bonsaibim.org)
+* [Bonsai Documentation](https://docs.bonsaibim.org/index.html)
+  * [Add-on Installation](https://docs.bonsaibim.org/quickstart/installation.html)
+  * [Exploring an IFC model](https://docs.bonsaibim.org/quickstart/explore_model.html)
+ 
+Development is sponsored through your generous donations!
 
-| Service                                         | Status                                                                                                                                       |
-| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| Anaconda Daily Build                            | [![Anaconda-Server Badge](https://img.shields.io/conda/vn/ifcopenshell/ifcopenshell)](https://anaconda.org/ifcopenshell/ifcopenshell)        |
-| Anaconda v0.7.0 Stable                          | [![Anaconda-Server Badge](https://img.shields.io/conda/vn/conda-forge/ifcopenshell)](https://anaconda.org/conda-forge/ifcopenshell)          |
-| PyPi Daily Build                                | [![PyPi Badge](https://img.shields.io/pypi/v/ifcopenshell)](https://pypi.org/project/ifcopenshell/)                                          |
-| ArchLinux AUR Package Stable                    | [![AUR Badge](https://img.shields.io/aur/version/ifcopenshell)](https://aur.archlinux.org/packages/ifcopenshell)                             |
-| ArchLinux AUR Package git                       | [![AUR Badge](https://img.shields.io/aur/version/ifcopenshell-git)](https://aur.archlinux.org/packages/ifcopenshell-git)                     |
-| BlenderBIM Add-on Chocolatey (under moderation) | [![Chocolatey Badge](https://img.shields.io/chocolatey/v/blenderbim-nightly)](https://community.chocolatey.org/packages/blenderbim-nightly/) |
-| Sponsor development on OpenCollective           | [![Financial Contributors](https://opencollective.com/opensourcebim/tiers/badge.svg)](https://opencollective.com/opensourcebim/)             |
-| Docker hub                                      | [![Docker Pulls](https://img.shields.io/docker/pulls/aecgeeks/ifcopenshell)](https://hub.docker.com/r/aecgeeks/ifcopenshell)                 |
+[![Open Collective Contributors](https://img.shields.io/opencollective/all/opensourcebim?label=Sponsors&color=22ce5f)](https://opencollective.com/opensourcebim/)
 
 Contents
 --------
 
-Those marked with an asterisk are part of IfcOpenShell.
+| Name                      | Description                                                           | License             | Service |
+| ------------------------- | --------------------------------------------------------------------- | ------------------- | ------- |
+| bcf                       | Library to read and write BCF-XML and query OpenCDE BCF-API modules   | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/bcf-client?label=PyPI&color=006dad)](https://pypi.org/project/bcf-client/) [![Anaconda-Server Badge](https://anaconda.org/conda-forge/bcf-client/badges/version.svg)](https://anaconda.org/conda-forge/bcf-client) |
+| bonsai                    | Add-on to Blender providing a graphical native IFC authoring platform | GPL-3.0-or-later    | [![Official](https://img.shields.io/badge/BonsaiBIM.org-Download-70ba35)](https://bonsaibim.org/download.html) [![GitHub Unstable](https://img.shields.io/github/v/release/ifcopenshell/ifcopenshell?filter=bonsai-*&label=GitHub-Unstable&color=f6f8fa)](https://github.com/IfcOpenShell/IfcOpenShell/releases?q=bonsai&expanded=true) [![Chocolatey](https://img.shields.io/chocolatey/v/blenderbim-nightly?label=Chocolatey&color=5c9fd8)](https://community.chocolatey.org/packages/blenderbim-nightly/) |
+| bsdd                      | Library to query the bSDD API                                         | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/bsdd?label=PyPI&color=006dad)](https://pypi.org/project/bsdd/) |
+| ifc2ca                    | Utility to convert IFC structural analysis models to Code_Aster       | LGPL-3.0-or-later   |
+| ifc4d                     | Convert to and from IFC and project management software               | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifc4d?label=PyPI&color=006dad)](https://pypi.org/project/ifc4d/) |
+| ifc5d                     | Report and optimise cost information from IFC                         | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifc5d?label=PyPI&color=006dad)](https://pypi.org/project/ifc5d/) |
+| ifcbimtester              | Wrapper for Gherkin based unit testing for IFC models                 | LGPL-3.0-or-later   |
+| ifcblender                | Historic Blender IFC import add-on                                    | LGPL-3.0-or-later\* |
+| ifccityjson               | Convert CityJSON to IFC                                               | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifccityjson?label=PyPI&color=006dad)](https://pypi.org/project/ifccityjson/) |
+| ifcclash                  | Clash detection library and CLI app                                   | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifcclash?label=PyPI&color=006dad)](https://pypi.org/project/ifcclash/) |
+| ifcconvert                | CLI app to convert IFC to many other formats                          | LGPL-3.0-or-later\* | [![Official](https://img.shields.io/badge/IfcOpenShell.org-Download-70ba35)](https://docs.ifcopenshell.org/ifcconvert/installation.html) [![GitHub](https://img.shields.io/github/v/release/ifcopenshell/ifcopenshell?filter=ifcconvert-*&label=GitHub&color=f6f8fa)](https://github.com/IfcOpenShell/IfcOpenShell/releases?q=ifcconvert&expanded=true)
+| ifccsv                    | Library and CLI app to export and import schedules from IFC           | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifccsv?label=PyPI&color=006dad)](https://pypi.org/project/ifccsv/) |
+| ifcdiff                   | Compare changes between IFC models                                    | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifcdiff?label=PyPI&color=006dad)](https://pypi.org/project/ifcdiff/) |
+| ifcfm                     | Extract IFC data for FM handover requirements                         | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifcfm?label=PyPI&color=006dad)](https://pypi.org/project/ifcfm/) |
+| ifcmax                    | Historic extension for IFC support in 3DS Max                         | LGPL-3.0-or-later\* | [![Official](https://img.shields.io/badge/IfcOpenShell.org-Download-70ba35)](https://docs.ifcopenshell.org/ifcmax.html)
+| ifcopenshell-python       | Python library for IFC manipulation                                   | LGPL-3.0-or-later\* | [![Official](https://img.shields.io/badge/IfcOpenShell.org-Download-70ba35)](https://docs.ifcopenshell.org/ifcopenshell-python/installation.html) [![GitHub](https://img.shields.io/github/v/release/ifcopenshell/ifcopenshell?filter=ifcopenshell-python-*&label=GitHub&color=f6f8fa)](https://github.com/IfcOpenShell/IfcOpenShell/releases?q=ifcopenshell-python&expanded=true) [![PyPI](https://img.shields.io/pypi/v/ifcopenshell?label=PyPI&color=006dad)](https://pypi.org/project/ifcopenshell/) [![Anaconda](https://img.shields.io/conda/vn/conda-forge/ifcopenshell?label=Anaconda&color=43b02a)](https://anaconda.org/conda-forge/ifcopenshell) [![Anaconda](https://img.shields.io/conda/vn/ifcopenshell/ifcopenshell?label=Anaconda-Unstable&color=43b02a)](https://anaconda.org/ifcopenshell/ifcopenshell) [![Docker](https://img.shields.io/docker/pulls/aecgeeks/ifcopenshell?label=Docker&color=1D63ED)](https://hub.docker.com/r/aecgeeks/ifcopenshell) [![AUR](https://img.shields.io/aur/version/ifcopenshell?label=AUR&color=1793d1)](https://aur.archlinux.org/packages/ifcopenshell) [![AUR Unstable](https://img.shields.io/aur/version/ifcopenshell-git?label=AUR-Unstable&color=1793d1)](https://aur.archlinux.org/packages/ifcopenshell-git) |
+| ifcpatch                  | Utility to run pre-packaged scripts to manipulate IFCs                | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifcpatch?label=PyPI&color=006dad)](https://pypi.org/project/ifcpatch/) |
+| ifcsverchok               | Blender Add-on for visual node programming with IFC                   | GPL-3.0-or-later    | [![GitHub Unstable](https://img.shields.io/github/v/release/ifcopenshell/ifcopenshell?filter=ifcsverchok-*.*.*.*&label=GitHub-Unstable&color=f6f8fa)](https://github.com/IfcOpenShell/IfcOpenShell/releases?q=ifcsverchok&expanded=true)
+| ifctester                 | Library, CLI and webapp for IDS model auditing                        | LGPL-3.0-or-later   | [![PyPI](https://img.shields.io/pypi/v/ifctester?label=PyPI&color=006dad)](https://pypi.org/project/ifctester/) |
+
+The IfcOpenShell C++ codebase is split into multiple interal libraries:
 
 | Name                      | Description                                                           | License             |
 | ------------------------- | --------------------------------------------------------------------- | ------------------- |
-| bcf                       | Library to read and write BCF-XML and query OpenCDE BCF-API modules   | LGPL-3.0-or-later   |
-| blenderbim                | Add-on to Blender providing a graphical native IFC authoring platform | GPL-3.0-or-later    |
-| bsdd                      | Library to query the bSDD API                                         | LGPL-3.0-or-later   |
-| ifc2ca                    | Utility to convert IFC structural analysis models to Code_Aster       | LGPL-3.0-or-later   |
-| ifc4d                     | Convert to and from IFC and project management software               | LGPL-3.0-or-later   |
-| ifc5d                     | Report and optimise cost information from IFC                         | LGPL-3.0-or-later   |
-| ifcbimtester              | Wrapper for Gherkin based unit testing for IFC models                 | LGPL-3.0-or-later   |
-| ifcblender                | Historic Blender IFC import add-on                                    | LGPL-3.0-or-later\* |
-| ifccityjson               | Convert CityJSON to IFC                                               | LGPL-3.0-or-later   |
-| ifcclash                  | Clash detection library and CLI app                                   | LGPL-3.0-or-later   |
-| ifcconvert                | CLI app to convert IFC to many other formats                          | LGPL-3.0-or-later\* |
-| ifccsv                    | Library and CLI app to export and import schedules from IFC           | LGPL-3.0-or-later   |
-| ifcdiff                   | Compare changes between IFC models                                    | LGPL-3.0-or-later   |
-| ifcfm                     | Extract IFC data for FM handover requirements                         | LGPL-3.0-or-later   |
 | ifcgeom                   | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
 | ifcgeom\_schema\_agnostic | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
 | ifcgeomserver             | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
 | ifcjni                    | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
-| ifcmax                    | Historic extension for IFC support in 3DS Max                         | LGPL-3.0-or-later\* |
-| ifcopenshell-python       | Python library for IFC manipulation                                   | LGPL-3.0-or-later\* |
 | ifcparse                  | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
-| ifcpatch                  | Utility to run pre-packaged scripts to manipulate IFCs                | LGPL-3.0-or-later   |
-| ifcsverchok               | Blender Add-on for visual node programming with IFC                   | GPL-3.0-or-later    |
-| ifctester                 | Library, CLI and webapp for IDS model auditing                        | LGPL-3.0-or-later   |
 | ifcwrap                   | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
 | qtviewer                  | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |
 | serializers               | Internal library for IfcOpenShell                                     | LGPL-3.0-or-later\* |

VERSION

@@ -1 +1 @@
-0.7.9
+0.8.1

choco/blenderbim/check_repo_infos.py

@@ -1,89 +0,0 @@
-import datetime
-import re
-import sys
-from urllib import request
-
-
-def request_repo_info(url: str):
-    req  = request.Request(url)
-    resp = request.urlopen(req)
-    if not resp.status == 200:
-        print(f"[ERROR] could not contact server: {url}")
-        quit(1)
-    return resp
-
-
-def get_choco_package_info() -> str:
-    resp = request_repo_info(URL_CHOCO_PACKAGE)
-    html_txt = str(resp.read())
-    return html_txt
-
-
-def get_latest_blender_version() -> list:
-    html_txt = get_choco_package_info()
-    return re.findall(RE_BLENDER_VERSION_MIN_MAJ_PAT, html_txt)
-
-
-URL_IFCOS_RELEASES = "https://github.com/IfcOpenShell/IfcOpenShell/releases"
-URL_CHOCO_PACKAGE  = "https://community.chocolatey.org/packages/blender"
-URL_BLENDER_CMAKE  = "https://raw.githubusercontent.com/blender/blender/{}/build_files/cmake/Modules/FindPythonLibsUnix.cmake"
-RE_BLENDER_VERSION_MIN_MAJ        = r"Latest Version.+<span>Blender (\d+\.\d+)\..+</span>"
-RE_BLENDER_VERSION_MIN_MAJ_PAT    = r"Latest Version.+<span>Blender (\d+\.\d+\.\d+)</span>"
-RE_BLENDER_PYTHON_VERSION_MAJ_MIN = r"(?:set|SET)\(_PYTHON_VERSION_SUPPORTED (\d+\.\d+)\)"
-
-
-if sys.argv[1] == "--do_choco_release?":
-    now = datetime.datetime.now()
-    blenderbim_date = (now - datetime.timedelta(days=1)).strftime("%y%m%d")
-    resp = request_repo_info(URL_IFCOS_RELEASES)
-    text = str(resp.read())
-    if blenderbim_date in text:
-        print("do_choco_release", end="")
-
-
-elif sys.argv[1] == "--latest_blender_release_maj_min_pat?":
-    latest_blender_version = get_latest_blender_version()
-    if latest_blender_version:
-        print(latest_blender_version[0], end="")
-    else:
-        print("[ERROR] could not determine blender_version_min_maj_pat")
-        quit(1)
-
-
-elif sys.argv[1] == "--latest_blender_release_maj_min?":
-    html_txt = get_choco_package_info()
-    blender_version_min_maj = re.findall(RE_BLENDER_VERSION_MIN_MAJ, html_txt)
-    if blender_version_min_maj:
-        print(blender_version_min_maj[0], end="")
-    else:
-        print("[ERROR] could not determine blender_version_min_maj")
-        quit(1)
-
-
-elif sys.argv[1] == "--latest_blender_python_version_maj_min?":
-    latest_blender_version = get_latest_blender_version()
-    if latest_blender_version:
-        latest_blender_version_tag = f"v{latest_blender_version[0]}"
-        resp = request_repo_info(URL_BLENDER_CMAKE.format(latest_blender_version_tag))
-        html_txt = str(resp.read())
-        found = re.findall(RE_BLENDER_PYTHON_VERSION_MAJ_MIN, html_txt)
-        if found:
-            print(found[0], end="")
-        else:
-            print("[ERROR] could not determine blender_python_version_maj_min")
-            quit(1)
-
-
-elif sys.argv[1] == "--pyver?":
-    latest_blender_version = get_latest_blender_version()
-    if latest_blender_version:
-        latest_blender_version_tag = f"v{latest_blender_version[0]}"
-        resp = request_repo_info(URL_BLENDER_CMAKE.format(latest_blender_version_tag))
-        html_txt = str(resp.read())
-        found = re.findall(RE_BLENDER_PYTHON_VERSION_MAJ_MIN, html_txt)
-        if found:
-            print(f"py{found[0].replace('.', '')}", end="")
-        else:
-            print("[ERROR] could not determine pyver")
-            quit(1)
-

choco/blenderbim/fill_dynamic_parameters.py

@@ -1,49 +0,0 @@
-import os
-from pathlib import Path
-
-
-print("[INFO] inserting dynamic chocolatey package parameters")
-HERE_DIR = Path(__file__).parent.absolute()
-# print(f"[INFO] HERE_DIR: {HERE_DIR}")
-
-topics = {
-    "spec": {
-        "path": HERE_DIR / "blenderbim.nuspec",
-        "env_vars": {
-            "latest_blender_version_maj_min_pat",
-            "blenderbim_build_version",
-        },
-    },
-    "install": {
-        "path": HERE_DIR / "tools" / "chocolateyinstall.ps1",
-        "env_vars": {
-            "url_blenderbim_py310_win_zip",
-            "sha256sum_blenderbim_py310_win_zip",
-            "latest_blender_version_maj_min",
-        },
-    },
-    "uninstall": {
-        "path": HERE_DIR / "tools" / "chocolateyuninstall.ps1",
-        "env_vars": {
-            "latest_blender_version_maj_min",
-        },
-    },
-}
-
-for topic, info in topics.items():
-    print(f"[INFO] {topic}:")
-    for env_var_name in info["env_vars"]:
-        print(f"[INFO] {env_var_name} exists?: {os.environ[env_var_name]}")
-
-    with open(info["path"], encoding="utf-8") as txt:
-        content = txt.read()
-
-    for env_var_name in info["env_vars"]:
-        # print(f"[INFO] replace: {env_var_name}")
-        content = content.replace(env_var_name, os.environ[env_var_name])
-
-    with open(info["path"], "w", encoding="utf-8") as txt:
-        txt.write(content)
-        print(f"[INFO] written: {info['path']}")
-
-print("[INFO] inserting dynamic chocolatey package parameters successful")

choco/bonsai/blenderbim.nuspec

@@ -12,10 +12,10 @@
     <projectUrl>https://github.com/IfcOpenShell/IfcOpenShell</projectUrl>
     <iconUrl>https://rawcdn.githack.com/IfcOpenShell/IfcOpenShell/c6ee1d1679d1298de0d7447ff108c22709c68e54/choco/blenderbim/blenderbim.png</iconUrl>
     <!-- <copyright>Year Software Vendor</copyright> -->
-    <licenseUrl>https://github.com/IfcOpenShell/IfcOpenShell/blob/v0.7.0/COPYING</licenseUrl>
+    <licenseUrl>https://github.com/IfcOpenShell/IfcOpenShell/blob/v0.8.0/COPYING</licenseUrl>
     <requireLicenseAcceptance>true</requireLicenseAcceptance>
     <projectSourceUrl>https://github.com/IfcOpenShell/IfcOpenShell</projectSourceUrl>
-    <docsUrl>https://docs.blenderbim.org/</docsUrl>
+    <docsUrl>https://docs.bonsaibim.org/</docsUrl>
     <!--<mailingListUrl></mailingListUrl>-->
     <bugTrackerUrl>https://github.com/IfcOpenShell/IfcOpenShell/issues</bugTrackerUrl>
     <tags>blender bim blenderbim ifc python opensource foss</tags>

choco/bonsai/choco_release.py

@@ -0,0 +1,224 @@
+# commands to run it on a generic ubuntu 2404 oci container:
+"""
+apt update && apt install git wget curl ptpython mono-devel micro
+mkdir -p /home/runner/work/IfcOpenShell && cd /home/runner/work/IfcOpenShell
+git clone https://github.com/IfcOpenShell/IfcOpenShell
+cd /home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/
+micro choco_release.py # paste this script, comment out push command
+export CHOCO_TOKEN="secret_choco_release_token"
+python3 choco_release.py
+"""
+import datetime
+import hashlib
+import os
+import pathlib
+import re
+from urllib import request
+from github import Github
+from typing import NoReturn
+
+
+def get_repo_tag_names() -> list[str]:
+    git_return = os.popen("git tag -l").read()
+    tag_names = [tag_name for tag_name in git_return.split("\n") if tag_name]
+    print(f"{len(tag_names)} tag_names found in repo")
+    return tag_names
+
+
+def request_repo_info(url: str):
+    req  = request.Request(url)
+    resp = request.urlopen(req)
+    if not resp.status == 200:
+        print(f"[ERROR] could not contact server: {url}")
+        quit(1)
+    return resp
+
+
+def get_choco_package_info() -> str:
+    resp = request_repo_info(URL_CHOCO_PACKAGE)
+    html_txt = str(resp.read())
+    return html_txt
+
+
+def get_latest_choco_blender_version() -> list:
+    html_txt = get_choco_package_info()
+    return re.findall(RE_BLENDER_VERSION_MIN_MAJ_PAT, html_txt)
+
+
+def get_file_sha256_hash(file_path: str) -> str:
+    BLOCKSIZE = 65536
+    hasher = hashlib.sha256()
+
+    with open(file_path, "rb") as input_file:
+        buffer = input_file.read(BLOCKSIZE)
+        while len(buffer) > 0:
+            hasher.update(buffer)
+            buffer = input_file.read(BLOCKSIZE)
+
+    return hasher.hexdigest()
+
+
+def quit_with_error_message(message: str) -> NoReturn:
+    print(f"ERROR: {message}")
+    quit(0)
+
+
+def get_release_zip(tag: str) -> tuple[str, str]:
+    g = Github()
+    repo = g.get_repo("IfcOpenShell/IfcOpenShell")
+    release = repo.get_release(tag)
+    for asset in release.get_assets():
+        asset_name = asset.name
+        if python_version not in asset_name:
+            continue
+        if TARGET_OS not in asset_name:
+            continue
+        return (asset_name, asset.browser_download_url)
+    raise Exception(f"Couldn't find the release matching '{python_version}' and '{TARGET_OS}' in tag '{tag}'.")
+
+
+start = datetime.datetime.now()
+
+URL_CHOCO_PACKAGE  = "https://community.chocolatey.org/packages/blender"
+URL_BLENDER_CMAKE  = "https://raw.githubusercontent.com/blender/blender/{}/build_files/cmake/Modules/FindPythonLibsUnix.cmake"
+RE_BLENDER_VERSION_MIN_MAJ        = r"Latest Version.+<span>Blender (\d+\.\d+)\..+</span>"
+RE_BLENDER_VERSION_MIN_MAJ_PAT    = r"Latest Version.+<span>Blender (\d+\.\d+\.\d+)</span>"
+RE_BLENDER_PYTHON_VERSION_MAJ_MIN = r"\(_PYTHON_VERSION_SUPPORTED (\d+\.\d+)\)"
+
+BLENDERBIM_DIR = pathlib.Path("/home/runner/work/IfcOpenShell/IfcOpenShell/choco/blenderbim/")
+
+print("_____ check choco release needed?")
+
+os.chdir(BLENDERBIM_DIR)
+
+blenderbim_date_yesterday = (datetime.datetime.now() - datetime.timedelta(days=1)).strftime("%y%m%d")
+should_release = False
+target_release_tag = ""
+TARGET_OS = "windows-x64"
+
+git_status = os.popen("git status").read()
+print(git_status)
+
+for tag_name in get_repo_tag_names():
+    print(tag_name)
+    if blenderbim_date_yesterday in tag_name:
+        should_release = True
+        target_release_tag = tag_name
+        print(f"found {tag_name=} - {should_release=}")
+        break
+
+if not should_release:
+    print(f"INFO: no blenderbim release tags found for {blenderbim_date_yesterday} -> no choco release today.")
+    quit(0)
+print(f"{should_release=}")
+
+if not os.environ.get("CHOCO_TOKEN"):
+    quit_with_error_message("could retrieve CHOCO_TOKEN env var")
+choco_token = os.environ["CHOCO_TOKEN"]
+
+print("\n_____ get blender info")
+# blender_version_min_maj_pat - from chocolatey.org
+latest_blender_release_maj_min_pat = get_latest_choco_blender_version()
+if not latest_blender_release_maj_min_pat:
+    quit_with_error_message("could not determine blender_version_min_maj_pat")
+latest_blender_release_maj_min_pat = latest_blender_release_maj_min_pat[0]
+print(f"{latest_blender_release_maj_min_pat=}")
+
+# blender_version_min_maj - from chocolatey.org
+blender_version_min_maj = latest_blender_release_maj_min_pat.rsplit(".", 1)[0]
+print(f"{blender_version_min_maj=}")
+
+# blender_python_version_maj_min - from blender repo
+python_version = ""
+latest_blender_version_tag = f"v{latest_blender_release_maj_min_pat}"
+resp = request_repo_info(URL_BLENDER_CMAKE.format(latest_blender_version_tag))
+html_txt = str(resp.read())
+found = re.findall(RE_BLENDER_PYTHON_VERSION_MAJ_MIN, html_txt)
+if not found:
+    quit_with_error_message("could not determine blender_python_version_maj_min")
+
+blender_python_version_maj_min = found[0]
+print(f"{blender_python_version_maj_min=}")
+python_version = f"py{found[0].replace('.', '')}"
+print(f"{python_version=}")
+
+blenderbim_build_version = target_release_tag.replace("blenderbim-", "")
+
+# url_blenderbim_py3x_win_zip
+release_zip_file_name, url_blenderbim_py3x_win_zip = get_release_zip(target_release_tag)
+os.popen(f"wget {url_blenderbim_py3x_win_zip} --no-verbose").read()
+
+# sha256sum_blenderbim_py310_win_zip
+sha256sum_blenderbim_py3x_win_zip = get_file_sha256_hash(release_zip_file_name)
+
+print("\n_____ fill dynamic chocolatey package parameters")
+HERE_DIR = pathlib.Path(__file__).parent.absolute()
+# print(f"[INFO] HERE_DIR: {HERE_DIR}")
+
+topics = {
+    "spec": {
+        "path": HERE_DIR / "blenderbim.nuspec",
+        "key_values": {
+            "latest_blender_version_maj_min_pat": latest_blender_release_maj_min_pat,
+            "blenderbim_build_version"          : blenderbim_build_version,
+        },
+    },
+    "install": {
+        "path": HERE_DIR / "tools" / "chocolateyinstall.ps1",
+        "key_values": {
+            "url_blenderbim_py3x_win_zip"      : url_blenderbim_py3x_win_zip,
+            "sha256sum_blenderbim_py3x_win_zip": sha256sum_blenderbim_py3x_win_zip,
+            "latest_blender_version_maj_min"   : blender_version_min_maj,
+        },
+    },
+    "uninstall": {
+        "path": HERE_DIR / "tools" / "chocolateyuninstall.ps1",
+        "key_values": {
+            "latest_blender_version_maj_min": blender_version_min_maj,
+        },
+    },
+}
+
+for topic, info in topics.items():
+    print(f"  {topic}:")
+    with open(info["path"], encoding="utf-8") as txt:
+        content = txt.read()
+
+    for key, value in info["key_values"].items():
+        # print(f"[INFO] replace: {env_var_name}")
+        if not key in content:
+            print(f"  {key=} not found in {info['path']}")
+        content = content.replace(key, value)
+
+    with open(info["path"], "w", encoding="utf-8") as txt:
+        txt.write(content)
+        print(f"  written: {info['path']}")
+
+print("[INFO] inserting dynamic chocolatey package parameters successful")
+
+
+print("\n_____ build choco.exe with mono")
+
+choco_version = "1.1.0"
+os.popen(f"wget https://github.com/chocolatey/choco/archive/refs/tags/{choco_version}.tar.gz --quiet").read()
+os.popen(f"tar -xzf {choco_version}.tar.gz").read()
+print("choco tar unpack successful")
+os.chdir("choco-1.1.0")
+os.popen("./build.sh").read()
+
+os.popen("cp -r build_output/chocolatey /opt/chocolatey").read()
+os.chdir(BLENDERBIM_DIR)
+
+if pathlib.Path("/opt/chocolatey/choco.exe").exists():
+    print("choco build successful")
+
+print("\n_____ build choco pack")
+
+os.popen("mono /opt/chocolatey/choco.exe pack --allow-unofficial").read()
+os.popen('mono /opt/chocolatey/choco.exe setapikey --key="{choco_token}" --source="https://push.chocolatey.org/" --allow-unofficial').read()
+
+print("\n_____ build choco push")
+os.popen('mono /opt/chocolatey/choco.exe push --source="https://push.chocolatey.org/" --key="$CHOCO_TOKEN" --allow-unofficial --verbose').read()
+
+print(f"choco push of version: {target_release_tag} successful!")
+print(f"it took: {datetime.datetime.now() - start}")

choco/bonsai/tools/chocolateyinstall.ps1

@@ -1,7 +1,7 @@
 $ErrorActionPreference = 'Stop'
 
-$url64          = 'url_blenderbim_py310_win_zip'
-$checksum64     = 'sha256sum_blenderbim_py310_win_zip'
+$url64          = 'url_blenderbim_py3x_win_zip'
+$checksum64     = 'sha256sum_blenderbim_py3x_win_zip'
 $checksumType64 = 'sha256'
 
 $appDataUserDir  = [System.Environment]::GetEnvironmentVariable('appdata')

cmake/CMakeLists.txt

@@ -27,11 +27,11 @@ if(CCACHE_FOUND)
     set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE ccache)
 endif()
 
-project(IfcOpenShell VERSION 0.8.0)
+add_definitions(-D_DISABLE_CONSTEXPR_MUTEX_CONSTRUCTOR)
 
 cmake_policy(SET CMP0048 NEW)
 cmake_policy(SET CMP0074 NEW)
-cmake_policy(SET CMP0078 OLD)
+cmake_policy(SET CMP0078 NEW)
 cmake_policy(SET CMP0086 NEW)
 if (POLICY CMP0144)
     cmake_policy(SET CMP0144 NEW) # find_package() uses upper-case <PACKAGENAME>_ROOT variables.
@@ -82,6 +82,17 @@ option(WITH_RELATIONSHIP_VALIDATION "Build IfcConvert with option to validate ge
 
 option(USERSPACE_PYTHON_PREFIX "Installs IfcPython for the current user only instead of system-wide." OFF)
 option(ADD_COMMIT_SHA "Add commit sha and branch in version number, warning results in many rebuilds, requires git" OFF)
+option(VERSION_OVERRIDE "Override the version defined in IfcParse.h with the file VERSION in the repository root" OFF)
+
+if (VERSION_OVERRIDE)
+    file(READ "../VERSION" "RELEASE_VERSION_")
+    string(STRIP "${RELEASE_VERSION_}" RELEASE_VERSION)
+    message(STATUS "Detected version '${RELEASE_VERSION}'")
+else()
+    set(RELEASE_VERSION "0.8.0")
+endif()
+
+project(IfcOpenShell VERSION ${RELEASE_VERSION})
 
 if(MINIMAL_BUILD)
     message(STATUS "Setting options for minimal build")
@@ -212,10 +223,11 @@ endif()
 
 if(GLTF_SUPPORT OR CITYJSON_SUPPORT)
     UNIFY_ENVVARS_AND_CACHE(JSON_INCLUDE_DIR)
-    find_file(json_hpp "json.hpp" ${JSON_INCLUDE_DIR}/nlohmann)
+    find_path(json_header_path "nlohmann/json.hpp" HINTS ${JSON_INCLUDE_DIR})
+    set(JSON_INCLUDE_DIR ${json_header_path})
 
-    if(json_hpp)
-        message(STATUS "JSON for Modern C++ header file found")
+    if(json_header_path)
+        message(STATUS "JSON for Modern C++ header file found in ${JSON_INCLUDE_DIR}")
     else()
         message(FATAL_ERROR "Unable to find JSON for Modern C++ header file, aborting")
     endif()
@@ -590,25 +602,27 @@ if(HDF5_SUPPORT)
         else()
             message(STATUS "Packaging hdf5 and zlib for conda distribution")
 
-            if(WIN32)
-                # Windows
-                set(zlib_post zlib)
-                set(lib_ext lib)
-            elseif(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
+            if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
                 # macOS
                 set(zlib_post libz)
                 set(lib_ext dylib)
-            else()
-                # linux
-                set(zlib_post libz)
-                set(lib_ext so)
-            endif()
-
-            set(HDF5_LIBRARIES
+                set(HDF5_LIBRARIES
                 "${HDF5_LIBRARY_DIR}/libhdf5_cpp.${lib_ext}"
                 "${HDF5_LIBRARY_DIR}/libhdf5.${lib_ext}"
                 "${HDF5_LIBRARY_DIR}/${zlib_post}.${lib_ext}"
             )
+            else()
+                # linux and windows
+                # Find HDF5 package
+                find_package(HDF5 REQUIRED COMPONENTS C CXX)
+                # Find ZLIB package
+                find_package(ZLIB REQUIRED)
+                # Include directories
+                include_directories(${HDF5_INCLUDE_DIRS} ${ZLIB_INCLUDE_DIRS})
+                # Link libraries
+                set(HDF5_LIBRARIES ${HDF5_LIBRARIES} ${ZLIB_LIBRARIES})
+                message(STATUS "HDF5 libraries: ${HDF5_LIBRARIES}")
+            endif()
         endif()
     endif()
 
@@ -718,6 +732,10 @@ if(MSVC)
     # endif()
 
 	add_definitions(-D_ENABLE_EXTENDED_ALIGNED_STORAGE)
+	# See #5158.
+	if(CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 19.40)
+		add_definitions(-D_DISABLE_CONSTEXPR_MUTEX_CONSTRUCTOR)
+	endif()
 else()
     add_definitions(-Wall -Wextra)
 
@@ -741,6 +759,7 @@ endif(MSVC)
 include_directories(${INCLUDE_DIRECTORIES} ${OCC_INCLUDE_DIR} ${OPENCOLLADA_INCLUDE_DIRS}
 	${Boost_INCLUDE_DIRS} ${LIBXML2_INCLUDE_DIR} ${JSON_INCLUDE_DIR} ${HDF5_INCLUDE_DIR}
     ${EIGEN_DIR} ${CGAL_INCLUDE_DIR} ${GMP_INCLUDE_DIR} ${MPFR_INCLUDE_DIR} ${USD_INCLUDE_DIR}
+    ${TBB_INCLUDE_DIR}
 )
 
 if(NOT SCHEMA_VERSIONS)
@@ -1032,10 +1051,19 @@ if(BUILD_CONVERT)
         target_include_directories(cityjson_converter PRIVATE ../src)
         set(IFCOPENSHELL_LIBRARIES ${IFCOPENSHELL_LIBRARIES} cityjson_converter)
 
+        install(TARGETS cityjson_converter
+            ARCHIVE DESTINATION ${LIBDIR}
+            LIBRARY DESTINATION ${LIBDIR}
+        )
+
         add_executable(cityjson_converter_exe ${CITYJSON_CONVERT_FILES})
         set_target_properties(cityjson_converter_exe PROPERTIES COMPILE_FLAGS "-DCITYJSON_EXECUTABLE")
         target_include_directories(cityjson_converter_exe PRIVATE ../src)
         target_link_libraries(cityjson_converter_exe ${IFCOPENSHELL_LIBRARIES} ${OPENCASCADE_LIBRARIES} ${Boost_LIBRARIES} ${HDF5_LIBRARIES} ${USD_LIBRARIES})
+
+        install(TARGETS cityjson_converter_exe
+            RUNTIME DESTINATION ${BINDIR}
+        )
     endif()
 
     # IfcConvert
@@ -1095,22 +1123,26 @@ if(ADD_COMMIT_SHA)
     find_package(Git)
 
     if(GIT_FOUND)
-        message("git found: ${GIT_EXECUTABLE} with version ${GIT_VERSION_STRING}")
-        execute_process(
-            COMMAND ${GIT_EXECUTABLE} branch -a --contains HEAD
-            OUTPUT_VARIABLE git_branches
-            OUTPUT_STRIP_TRAILING_WHITESPACE
-        )
-        string(REPLACE "\n" ";" git_branch_list "${git_branches}")
+        if (VERSION_OVERRIDE)
+            set (git_branch ${RELEASE_VERSION})
+        else()
+            message("git found: ${GIT_EXECUTABLE} with version ${GIT_VERSION_STRING}")
+            execute_process(
+                COMMAND ${GIT_EXECUTABLE} branch -a --contains HEAD
+                OUTPUT_VARIABLE git_branches
+                OUTPUT_STRIP_TRAILING_WHITESPACE
+            )
+            string(REPLACE "\n" ";" git_branch_list "${git_branches}")
 
-        foreach(git_branch_candidate IN ITEMS ${git_branch_list})
-		    string(REPLACE "*" "" git_branch_candidate_temp "${git_branch_candidate}")
-		    string(STRIP "${git_branch_candidate_temp}" git_branch_candidate_2)
-            if(NOT git_branch_candidate_2 MATCHES "^HEAD$")
-                string(REPLACE "/" ";" git_branch_candidate_2_list "${git_branch_candidate_2}")
-                list(GET git_branch_candidate_2_list -1 git_branch)
-            endif()
-        endforeach()
+            foreach(git_branch_candidate IN ITEMS ${git_branch_list})
+		        string(REPLACE "*" "" git_branch_candidate_temp "${git_branch_candidate}")
+		        string(STRIP "${git_branch_candidate_temp}" git_branch_candidate_2)
+                if(NOT git_branch_candidate_2 MATCHES "^HEAD$")
+                    string(REPLACE "/" ";" git_branch_candidate_2_list "${git_branch_candidate_2}")
+                    list(GET git_branch_candidate_2_list -1 git_branch)
+                endif()
+            endforeach()
+        endif()
 
         execute_process(
             COMMAND ${GIT_EXECUTABLE} rev-parse --short HEAD
@@ -1177,7 +1209,7 @@ if(BUILD_IFCGEOM)
         DESTINATION ${INCLUDEDIR}/ifcgeom_schema_agnostic
     )
 
-    install(TARGETS ${IFCGEOM_SCHEMA_LIBRARIES} IfcGeom
+    install(TARGETS ${IFCGEOM_SCHEMA_LIBRARIES} ${kernel_libraries} IfcGeom
         ARCHIVE DESTINATION ${LIBDIR}
         LIBRARY DESTINATION ${LIBDIR}
         RUNTIME DESTINATION ${BINDIR}

conda/.gitignore

@@ -1 +0,0 @@
-.env

conda/bld.bat

@@ -1,10 +1,13 @@
 mkdir build && cd build
 
+REM Remove dot from PY_VER for use in library name
+REM From https://github.com/tpaviot/pythonocc-core/blob/master/ci/conda/bld.bat
 set MY_PY_VER=%PY_VER:.=%
-rem set LIBXML2="%LIBRARY_PREFIX%/lib/libxml2.lib"
+
+set LIBXML2="%LIBRARY_PREFIX%/lib/libxml2.lib"
 
 cmake -G "Ninja" ^
- -D SCHEMA_VERSIONS="2x3;4;4x1;4x3;4x3_add1" ^
+ -D SCHEMA_VERSIONS="2x3;4;4x1;4x3_add2" ^
  -D CMAKE_BUILD_TYPE:STRING=Release ^
  -D CMAKE_INSTALL_PREFIX:FILEPATH="%LIBRARY_PREFIX%" ^
  -D CMAKE_PREFIX_PATH:FILEPATH="%LIBRARY_PREFIX%" ^
@@ -39,11 +42,10 @@ cmake -G "Ninja" ^
  -D Boost_INCLUDE_DIR:FILEPATH="%LIBRARY_PREFIX%\include" ^
  -D Boost_USE_STATIC_LIBS:BOOL=OFF ^
  -D CITYJSON_SUPPORT:BOOL=OFF ^
- %SRC_DIR%/cmake
-
+ ../cmake
+ 
 if errorlevel 1 exit 1
 
-:: Build and install
-cmake --build . -- install
+ninja install -j 1
 
 if errorlevel 1 exit 1

conda/build.sh

@@ -6,16 +6,14 @@
 
 if [ "$(uname)" == "Darwin" ]; then
     export FSUFFIX=dylib
-    export CFLAGS="$CFLAGS -Wl,-flat_namespace,-undefined,suppress"
-    export CXXFLAGS="$CXXFLAGS -Wl,-flat_namespace,-undefined,suppress"
     export LDFLAGS="$LDFLAGS -Wl,-flat_namespace,-undefined,suppress"
 elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
     export FSUFFIX=so
 fi
 
 
-cmake -G Ninja \
- -DSCHEMA_VERSIONS="2x3;4;4x1;4x3;4x3_add1" \
+cmake ${CMAKE_ARGS} -G Ninja \
+ -DSCHEMA_VERSIONS="2x3;4;4x1;4x3_add2" \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=$PREFIX \
   ${CMAKE_PLATFORM_FLAGS[@]} \
@@ -48,4 +46,4 @@ cmake -G Ninja \
 
 ninja
 
-ninja install -j 1
+ninja install -j 1

conda/conda_build_config.yaml

@@ -1,11 +1,58 @@
-CONDA_BUILD_SYSROOT: # used for github actions conda daily build
-  - /Users/runner/work/MacOSX10.13.sdk       # [osx]
+variant:
+  - novtk
+  - all
 
 occt:
-  - 7.7.1
+  - 7.8.1
 
 c_compiler:
-  - vs2022  # [win]
-
+- vs2022    # [win]
+- gcc       # [linux]
+- clang     # [osx]
+c_stdlib:
+- vs        # [win]
+- sysroot   # [linux]
+- macosx_deployment_target  # [osx]
 cxx_compiler:
-  - vs2022  # [win]
+- vs2022    # [win]
+- gcc       # [linux]
+- clangxx   # [osx]
+c_compiler_version:
+- '12'    # [linux]
+- '16'    # [osx]
+cxx_compiler_version:
+- '12'    # [linux]
+- '16'    # [osx]
+c_stdlib_version:
+- '2.12'    # [linux]
+- '10.13'   # [osx]
+hdf5:
+- 1.14.3
+libboost_devel:
+- '1.84'
+libxml2:
+- '2'
+mpfr:
+- '4'
+gmp:
+- '6'  # [not win]
+pin_run_as_build:
+  python:
+    min_pin: x.x
+    max_pin: x.x
+
+zlib:
+- '1'
+target_platform:
+- win-64    # [win]
+- linux-64  # [linux]
+- osx-64    # [osx]
+macos_machine:
+- x86_64-apple-darwin13.4.0
+MACOSX_DEPLOYMENT_TARGET:
+- '10.13'
+MACOSX_SDK_VERSION:
+- '10.13'
+
+CONDA_BUILD_SYSROOT:
+  - "/Users/runner/work/MacOSX10.13.sdk"  # [osx]

conda/env.bat

@@ -1,58 +0,0 @@
-@echo off
-
-:: This is a batch file to set the environment variables for the project
-:: It is not necessary for conda compilation, but it provides you with type hints when working with the c++ libraries
-:: OpenCascade, CGAL, Eigen, etc distributed using conda-forge in your IDE.
-::
-:: mamba env update -f environment.build.yml --prune
-:: mamba activate ifcopenshell-build
-::
-:: Note!
-:: You have to add a .env file next to this env.bat file where you set PREFIX=<path to your conda env>
-set CONDA_BUILD=1
-set MY_PY_VER=311
-
-:: set this file's parent directory as a variable
-set THIS_DIR=%~dp0
-
-:: read the .env file located in THIS_DIR and set the environment variables.
-:: the .env file should contain a line like this:
-:: PREFIX=C:\Users\your_user_name\mambaforge3\envs\ifcopenshell-build
-for /f "tokens=*" %%i in (%THIS_DIR%.env) do set %%i
-
-set LIBRARY_PREFIX=%PREFIX%/Library
-set CMAKE_PREFIX_PATH=%PREFIX%;%LIBRARY_PREFIX%/include;%LIBRARY_PREFIX%/lib;%LIBRARY_PREFIX%/bin
-
-set OCC_LIBRARY_DIR=%LIBRARY_PREFIX%/lib
-set OCC_INCLUDE_DIR=%LIBRARY_PREFIX%/include/opencascade
-
-set CGAL_DIR=%LIBRARY_PREFIX%/lib/cmake/CGAL
-set CGAL_INCLUDE_DIR=%LIBRARY_PREFIX%/include
-set EIGEN_DIR=%LIBRARY_PREFIX%/include/eigen3
-set LIBXML2_INCLUDE_DIR=%LIBRARY_PREFIX%/include/libxml2
-set LIBXML2_LIBRARIES=%LIBRARY_PREFIX%/lib/libxml2.lib
-set Boost_LIBRARY_DIR=%LIBRARY_PREFIX%/lib
-set Boost_INCLUDE_DIR=%LIBRARY_PREFIX%/include
-set Boost_USE_STATIC_LIBS=OFF
-
-set GMP_INCLUDE_DIR=%LIBRARY_PREFIX%/include
-set GMP_LIBRARY_DIR=%LIBRARY_PREFIX%/lib
-set MPFR_LIBRARY_DIR=%LIBRARY_PREFIX%/lib
-
-set HDF5_INCLUDE_DIR=%LIBRARY_PREFIX%/include
-set HDF5_LIBRARY_DIR=%LIBRARY_PREFIX%/lib
-set JSON_INCLUDE_DIR=%LIBRARY_PREFIX%/include
-
-set HDF5_SUPPORT=ON
-set BUILD_IFCPYTHON=ON
-set BUILD_IFCGEOM=ON
-set COLLADA_SUPPORT=OFF
-set BUILD_EXAMPLES=OFF
-set BUILD_GEOMSERVER=OFF
-set GLTF_SUPPORT=ON
-set BUILD_CONVERT=ON
-set BUILD_IFCMAX=OFF
-set IFCXML_SUPPORT=ON
-
-set PYTHON_EXECUTABLE=%PREFIX%/python.exe
-set PYTHON_LIBRARY=%PREFIX%/libs/python%MY_PY_VER%.lib

conda/environment.build.yml

@@ -1,17 +0,0 @@
-name: ifcopenshell-build
-channels:
-  - conda-forge
-dependencies:
-  - boa
-  - boost-cpp
-  - occt
-  - libxml2
-  - cgal-cpp
-  - hdf5
-  - mpfr
-  - nlohmann_json
-  - swig
-  - zlib
-  # These needs to be installed per platform
-  #- sel(unix): gmp
-  #- sel(win): mpir

conda/meta.yaml

@@ -0,0 +1,303 @@
+{% set version = environ.get('VERSION_OVERRIDE', '0.8.0') %}
+{% set build = 0 %}
+
+# Higher number -> Always prioritize "novtk" variant over "all" variant
+{% set build = build + 200 %}   # [variant == "novtk"]
+{% set build = build + 100 %}   # [variant == "all"]
+
+package:
+  name: ifcopenshell
+  version: {{ version }}
+
+source:
+  path: ../
+
+
+build:
+  number: {{ build }}
+  skip: true  # [py<39]
+  binary_relocation: false  # [osx]
+  string: py{{ CONDA_PY }}_{{ variant }}_h{{ PKG_HASH }}_{{ build }}
+  run_exports:
+    - {{ pin_subpackage('ifcopenshell', max_pin='x.x.x') }} *{{ variant }}*
+
+
+requirements:
+  build:
+    - cmake
+    - ninja
+    - swig >=4.1.1
+    - {{ stdlib("c") }}
+    - {{ compiler('c') }}
+    - {{ compiler('cxx') }}
+  host:
+    - python
+    - libboost-devel
+    - occt *=*{{ variant }}*
+    - libxml2
+    - cgal-cpp
+    - hdf5
+    - eigen
+    - mpfr
+    - nlohmann_json
+    - gmp  # [unix]
+    - mpir  # [win]
+    - zlib
+  run:
+    - python
+    - {{ pin_compatible('occt', max_pin='x.x.x') }} *{{ variant }}*
+    - {{ pin_compatible('cgal-cpp', max_pin='x.x') }}
+
+
+test:
+  imports:
+    - ifcopenshell
+
+
+about:
+  home: https://ifcopenshell.org
+  license: LGPL-3.0-or-later
+  license_file: COPYING
+  summary: 'IfcOpenShell is a library to support the IFC file format'
+  description: |
+    IfcOpenShell
+    ============
+    
+    IfcOpenShell is an open source ([LGPL]) software library for working with Industry Foundation Classes ([IFC]). Complete
+    parsing support is provided for [IFC2x3 TC1], [IFC4 Add2 TC1], IFC4x1, IFC4x3, and IFC4x3. Extensive geometric support
+    is implemented for the IFC releases [IFC2x3 TC1] and [IFC4 Add2 TC1]. Extending with support for arbitrary IFC schemas
+    is possible at compile-time when using C++ and at run-time when using Python.
+    
+    In addition to a C++ and Python API, IfcOpenShell comes with an ecosystem of tools, notably including IfcConvert (an
+    application to convert IFC models to
+    other formats), the BlenderBIM Add-on (an add-on to Blender providing a graphical IFC authoring platform), and many
+    other libraries, CLI apps, and more. Support is also provided for auxiliary standards such as BCF and IDS.
+    
+    For more information, see:
+    
+    * [IfcOpenShell Website](http://ifcopenshell.org)
+    * [IfcOpenShell Documentation](http://bonsaibim.org/docs-python)
+    * [IfcOpenShell C++ Installation](https://bonsaibim.org/docs-python/ifcopenshell/installation.html)
+    * [IfcOpenShell Python Installation](https://bonsaibim.org/docs-python/ifcopenshell-python/installation.html)
+    * [IfcOpenShell Python Hello World Tutorial](https://bonsaibim.org/docs-python/ifcopenshell-python/hello_world.html)
+    * [Bonsai Website](https://bonsaibim.org)
+    * [Bonsai Documentation](http://bonsaibim.org/docs)
+    * [Add-on Installation](https://bonsaibim.org/docs/users/installation.html)
+    * [Exploring an IFC model](https://bonsaibim.org/docs/users/exploring_an_ifc_model.html)
+    
+    <table>
+      <thead>
+        <tr>
+          <th>Service</th>
+          <th>Status</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>Anaconda Daily Build</td>
+          <td><a href="https://anaconda.org/ifcopenshell/ifcopenshell"><img src="https://img.shields.io/conda/vn/ifcopenshell/ifcopenshell" alt="Anaconda-Server Badge"></a></td>
+        </tr>
+        <tr>
+          <td>Anaconda v0.8.0 Stable</td>
+          <td><a href="https://anaconda.org/conda-forge/ifcopenshell"><img src="https://img.shields.io/conda/vn/conda-forge/ifcopenshell" alt="Anaconda-Server Badge"></a></td>
+        </tr>
+        <tr>
+          <td>PyPi Daily Build</td>
+          <td><a href="https://pypi.org/project/ifcopenshell/"><img src="https://img.shields.io/pypi/v/ifcopenshell" alt="PyPi Badge"></a></td>
+        </tr>
+        <tr>
+          <td>ArchLinux AUR Package Stable</td>
+          <td><a href="https://aur.archlinux.org/packages/ifcopenshell"><img src="https://img.shields.io/aur/version/ifcopenshell" alt="AUR Badge"></a></td>
+        </tr>
+        <tr>
+          <td>ArchLinux AUR Package git</td>
+          <td><a href="https://aur.archlinux.org/packages/ifcopenshell-git"><img src="https://img.shields.io/aur/version/ifcopenshell-git" alt="AUR Badge"></a></td>
+        </tr>
+        <tr>
+          <td>BlenderBIM Add-on Chocolatey (under moderation)</td>
+          <td><a href="https://community.chocolatey.org/packages/blenderbim-nightly/"><img src="https://img.shields.io/chocolatey/v/blenderbim-nightly" alt="Chocolatey Badge"></a></td>
+        </tr>
+        <tr>
+          <td>Sponsor development on OpenCollective</td>
+          <td><a href="https://opencollective.com/opensourcebim/"><img src="https://opencollective.com/opensourcebim/tiers/badge.svg" alt="Financial Contributors"></a></td>
+        </tr>
+        <tr>
+          <td>Docker hub</td>
+          <td><a href="https://hub.docker.com/r/aecgeeks/ifcopenshell"><img src="https://img.shields.io/docker/pulls/aecgeeks/ifcopenshell" alt="Docker Pulls"></a></td>
+        </tr>
+    
+      </tbody>
+    </table>
+    Contents
+    --------
+    
+    Those marked with an asterisk are part of IfcOpenShell.
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Description</th>
+          <th>License</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>bcf</td>
+          <td>Library to read and write BCF-XML and query OpenCDE BCF-API modules</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>blenderbim</td>
+          <td>Add-on to Blender providing a graphical native IFC authoring platform</td>
+          <td>GPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>bsdd</td>
+          <td>Library to query the bSDD API</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifc2ca</td>
+          <td>Utility to convert IFC structural analysis models to Code_Aster</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifc4d</td>
+          <td>Convert to and from IFC and project management software</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifc5d</td>
+          <td>Report and optimise cost information from IFC</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifcbimtester</td>
+          <td>Wrapper for Gherkin based unit testing for IFC models</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifcblender</td>
+          <td>Historic Blender IFC import add-on</td>
+          <td>LGPL-3.0-or-later*</td>
+        </tr>
+        <tr>
+          <td>ifccityjson</td>
+          <td>Convert CityJSON to IFC</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifcclash</td>
+          <td>Clash detection library and CLI app</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifccobie</td>
+          <td>Extract IFC data for COBie handover requirements</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+        <tr>
+          <td>ifcconvert</td>
+          <td>CLI app to convert IFC to many other formats</td>
+          <td>LGPL-3.0-or-later*</td>
+        </tr>
+        <tr>
+          <td>ifccsv</td>
+          <td>Library and CLI app to export and import schedules from IFC</td>
+          <td>LGPL-3.0-or-later</td>
+        </tr>
+    <tr>
+      <td>ifcdiff</td>
+      <td>Compare changes between IFC models</td>
+      <td>LGPL-3.0-or-later</td>
+    </tr>
+    <tr>
+      <td>ifcfm</td>
+      <td>Extract IFC data for FM handover requirements</td>
+      <td>LGPL-3.0-or-later</td>
+    </tr>
+    <tr>
+      <td>ifcgeom</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcgeom_schema_agnostic</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcgeomserver</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcjni</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcmax</td>
+      <td>Historic extension for IFC support in 3DS Max</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcopenshell-python</td>
+      <td>Python library for IFC manipulation</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcparse</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>ifcpatch</td>
+      <td>Utility to run pre-packaged scripts to manipulate IFCs</td>
+      <td>LGPL-3.0-or-later</td>
+    </tr>
+    <tr>
+      <td>ifcsverchok</td>
+      <td>Blender Add-on for visual node programming with IFC</td>
+      <td>GPL-3.0-or-later</td>
+    </tr>
+    <tr>
+      <td>ifctester</td>
+      <td>Library, CLI and webapp for IDS model auditing</td>
+      <td>LGPL-3.0-or-later</td>
+    </tr>
+    <tr>
+      <td>ifcwrap</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>qtviewer</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    <tr>
+      <td>serializers</td>
+      <td>Internal library for IfcOpenShell</td>
+      <td>LGPL-3.0-or-later*</td>
+    </tr>
+    </tbody>
+    </table>
+    
+    [LGPL]: https://github.com/IfcOpenShell/IfcOpenShell/tree/master/COPYING.LESSER "LGPL-3.0-or-later"
+    [IFC]: https://technical.buildingsmart.org/standards/ifc/ "IFC"
+    [IFC2x3 TC1]: https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/HTML/ "IFC2x3 TC1"
+    [IFC4 Add2 TC1]: https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/ "IFC4 Add2 TC1"
+    [Visual Studio]: https://www.visualstudio.com/ "Visual Studio"
+    [Visual C++ Build Tools]: http://landinghub.visualstudio.com/visual-cpp-build-tools "Visual C++ Build Tools"
+    [MSYS2]: https://msys2.github.io/ "MSYS2"
+    [win/readme.md]: https://github.com/IfcOpenShell/IfcOpenShell/tree/master/win/readme.md "win/readme.md"
+    [nix/build-all.py]: https://github.com/IfcOpenShell/IfcOpenShell/tree/master/nix/build-all.py "nix/build-all.py"
+  doc_url: https://ifcopenshell.org/
+  dev_url: https://github.com/IfcOpenShell/IfcOpenShell
+
+extra:
+  recipe-maintainers:
+    - adrianinsaval
+    - looooo
+    - Krande

conda/recipe.yaml

@@ -1,64 +0,0 @@
-context:
-  name: ifcopenshell
-  version: 0.8.0alpha1
-
-package:
-  name: '{{ name|lower }}'
-  version: '{{ version }}'
-
-source:
-  path: ..
-
-build:
-  number: 1
-
-requirements:
-  build:
-    - "{{ compiler('c') }}"
-    - "{{ compiler('cxx') }}"
-    - ninja >=1.10.2
-    - cmake
-    - swig 4.1.1
-
-  host:
-    - python
-    - boost-cpp
-    - occt ==7.7.0
-    - libxml2
-    - cgal-cpp
-    - hdf5
-    - eigen
-    - mpfr
-    - sel(unix): gmp
-    - sel(win): mpir
-    - nlohmann_json
-    - zlib
-
-  run:
-    - python
-    - {{ pin_compatible('occt', max_pin='x.x.x') }}
-    - {{ pin_compatible('cgal-cpp', max_pin='x.x.x') }}
-    - {{ pin_compatible('boost-cpp', max_pin='x.x.x') }}
-    - libxml2
-    - hdf5
-    - eigen
-    - mpfr
-    - sel(unix): gmp
-    - sel(win): mpir
-    - nlohmann_json
-    - zlib
-
-test:
-  imports:
-    - ifcopenshell
-
-about:
-  home: https://ifcopenshell.org
-  license: LGPL-3.0-or-later
-  license_file: COPYING
-  summary: 'IfcOpenShell is a library to support the IFC file format'
-  description: |
-    IfcOpenShell is an open source (LGPL) software library for 
-    working with the Industry Foundation Classes (IFC) file format.
-  doc_url: https://blenderbim.org/docs-python/
-  dev_url: https://github.com/IfcOpenShell/IfcOpenShell

nix/build-all.py

@@ -53,6 +53,7 @@ import logging
 import os
 import re
 import sys
+import glob
 import subprocess as sp
 import shutil
 import tarfile
@@ -80,7 +81,7 @@ ADD_COMMIT_SHA = os.getenv("ADD_COMMIT_SHA")
 PYTHON_VERSIONS = ["3.9.11", "3.10.3", "3.11.8", "3.12.1"]
 JSON_VERSION = "v3.6.1"
 OCE_VERSION = "0.18.3"
-OCCT_VERSION = "7.7.1"
+OCCT_VERSION = "7.8.1"
 BOOST_VERSION = "1.80.0"
 PCRE_VERSION = "8.41"
 LIBXML2_VERSION = "2.9.11"
@@ -219,6 +220,7 @@ if "v" in flags:
 else:
     logger.setLevel(logging.INFO)
 
+OFF_ON = ["OFF", "ON"]
 BUILD_STATIC = "shared" not in flags
 ENABLE_FLAG = "--enable-static" if BUILD_STATIC else "--enable-shared"
 DISABLE_FLAG = "--disable-shared" if BUILD_STATIC else "--disable-static"
@@ -330,7 +332,7 @@ def run_cmake(arg1, cmake_args, cmake_dir=None, cwd=None):
     if "wasm" in flags:
         wasm.append("emcmake")
         
-    run([*wasm, "cmake", P, *cmake_args, f"-DCMAKE_BUILD_TYPE={BUILD_CFG}"], cwd=cwd)
+    run([*wasm, "cmake", P, *cmake_args, f"-DCMAKE_BUILD_TYPE={BUILD_CFG}", f"-DBUILD_SHARED_LIBS={OFF_ON[not BUILD_STATIC]}"], cwd=cwd)
 
 
 def git_clone_or_pull_repository(clone_url, target_dir, revision=None):
@@ -350,6 +352,8 @@ def git_clone_or_pull_repository(clone_url, target_dir, revision=None):
         run([git, "pull", clone_url], cwd=target_dir)
 
     if revision != None:
+        run([git, "reset", "--hard"], cwd=target_dir)
+        run([git, "fetch", "--all"], cwd=target_dir)
         run([git, "checkout", revision], cwd=target_dir)
 
 
@@ -576,6 +580,7 @@ if "freetype" in targets:
         download_url = "https://github.com/freetype/freetype",
         download_name = "freetype2",
         download_tool=download_tool_git,
+        revision="VER-2-11-1"
     )
 
 if USE_OCCT and "occ" in targets:
@@ -586,6 +591,12 @@ if USE_OCCT and "occ" in targets:
     if OCCT_VERSION == "7.7.1":
         patches.append("./patches/occt/no_ExpToCasExe.patch")
     
+    if OCCT_VERSION == "7.7.2":
+        patches.append("./patches/occt/no_ExpToCasExe_7_7_2.patch")
+
+    if OCCT_VERSION == "7.8.1":
+        patches.append("./patches/occt/no_ExpToCasExe_7_8_1.patch")
+    
     if "wasm" in flags:
         patches.append("./patches/occt/no_em_js.patch")
 
@@ -819,7 +830,6 @@ os.makedirs(IFCOS_DIR, exist_ok=True)
 executables_dir = os.path.join(IFCOS_DIR, "executables")
 os.makedirs(executables_dir, exist_ok=True)
 
-OFF_ON = ["OFF", "ON"]
 
 cmake_args = [
     "-DUSE_MMAP="                      "OFF",
@@ -830,7 +840,8 @@ cmake_args = [
     "-DJSON_INCLUDE_DIR="              f"{DEPS_DIR}/install/json",
     "-DEIGEN_DIR="                     f"{DEPS_DIR}/install/eigen-3.3.9",
     "-DBoost_NO_BOOST_CMAKE="          "On",
-    "-DADD_COMMIT_SHA="              +("On" if ADD_COMMIT_SHA else "Off")
+    "-DADD_COMMIT_SHA="              +("On" if ADD_COMMIT_SHA else "Off"),
+    "-DVERSION_OVERRIDE="            +("On" if ADD_COMMIT_SHA else "Off")
 ]
 
 if "wasm" in flags:
@@ -960,7 +971,7 @@ if "IfcOpenShell-Python" in targets:
 
         logger.info(f"\rBuilding python {python_version} wrapper...   ")
 
-        run([make, f"-j{IFCOS_NUM_BUILD_PROCS}", "_ifcopenshell_wrapper"], cwd=python_dir)
+        run([make, f"-j{IFCOS_NUM_BUILD_PROCS}", "ifcopenshell_wrapper"], cwd=python_dir)
         run([make, "install/local"], cwd=os.path.join(python_dir, "ifcwrap"))
 
         if python_executable:
@@ -969,7 +980,7 @@ if "IfcOpenShell-Python" in targets:
             if platform.system() != "Darwin":
                 if BUILD_CFG == "Release":
                     # TODO: This symbol name depends on the Python version?
-                    run([strip, "-s", "-K", "PyInit__ifcopenshell_wrapper", "_ifcopenshell_wrapper.so"], cwd=module_dir)
+                    run([strip, "-s", "-K", "PyInit__ifcopenshell_wrapper", glob.glob(os.path.join(module_dir, "_ifcopenshell_wrapper*.so"))[0]], cwd=module_dir)
 
             return module_dir
 

nix/patches/occt/no_ExpToCasExe_7_7_2.patch

@@ -0,0 +1,13 @@
+diff --git a/CMakeLists.txt b/CMakeLists.txt
+index 1bacca1a48..11f931ad39 100644
+--- a/CMakeLists.txt
++++ b/CMakeLists.txt
+@@ -820,6 +820,8 @@ else()
+   OCCT_CHECK_AND_UNSET ("3RDPARTY_DOT_EXECUTABLE")
+ endif()
+ 
++list (REMOVE_ITEM BUILD_TOOLKITS ExpToCasExe)
++
+ # bison
+ if (BUILD_YACCLEX)
+   OCCT_INCLUDE_CMAKE_FILE ("adm/cmake/bison")

nix/patches/occt/no_ExpToCasExe_7_8_1.patch

@@ -0,0 +1,13 @@
+diff --git a/CMakeLists.txt b/CMakeLists.txt
+index 86905287dc..9d0bce984c 100644
+--- a/CMakeLists.txt
++++ b/CMakeLists.txt
+@@ -828,6 +828,8 @@ else()
+   OCCT_CHECK_AND_UNSET ("3RDPARTY_DOT_EXECUTABLE")
+ endif()
+ 
++list (REMOVE_ITEM BUILD_TOOLKITS ExpToCasExe)
++
+ # bison
+ if (BUILD_YACCLEX)
+   OCCT_INCLUDE_CMAKE_FILE ("adm/cmake/bison")

pyodide/meta.yaml

@@ -1,6 +1,6 @@
 package:
   name: ifcopenshell
-  version: 0.7.0
+  version: 0.8.0
 
 source:
   path: IfcOpenShell

pyodide/setup.py

@@ -1,7 +1,7 @@
 from setuptools import setup, find_packages
 
 setup(name='IfcOpenShell',
-      version='0.7.0',
+      version='0.8.0',
       description='IfcOpenShell is an open source (LGPL) software library for working with the Industry Foundation Classes (IFC) file format.',
       author='Thomas Krijnen',
       author_email='thomas@aecgeeks.com',

pyproject.toml

@@ -1,2 +1,35 @@
 [tool.black]
-line-length = 120
+line-length = 120
+include = '''
+    src/(
+        bcf
+        |bcfserver
+        |bonsai
+        |bsdd
+        |foundationserver
+        |ifc2ca
+        |ifc4d
+        |ifc5d
+        |ifcbimtester
+        |ifcblender
+        |ifccityjson
+        |ifcclash
+        |ifccsv
+        |ifcdiff
+        |ifcfm
+        |ifcpatch
+        |ifctester
+        |ifcopenshell-python
+        |ifcsverchok
+        |opencdeserver
+    )/.*.py$
+'''
+extend-exclude = '''
+    src/ifcopenshell-python/ifcopenshell/express/*
+    |src/ifcopenshell-python/ifcopenshell/mvd/*
+    |src/ifc2ca/templates/*
+'''
+
+[tool.pyright]
+reportInvalidTypeForm = false
+disableBytesTypePromotions = true

src/bcf/CITATION.cff

@@ -10,7 +10,7 @@ type: software
 authors:
   - name: "IfcOpenShell contributors"
 repository-code: >-
-  https://github.com/IfcOpenShell/IfcOpenShell/tree/v0.7.0/src/bcf
+  https://github.com/IfcOpenShell/IfcOpenShell/tree/v0.8.0/src/bcf
 abstract: >-
   Library to read and write BCF-XML and query OpenCDE
   BCF-API modules

src/bcf/Makefile

@@ -1,8 +1,23 @@
-VERSION:=`date '+%y%m%d'`
-SED:=sed -i
-ifeq ($(UNAME_S),Darwin)
-SED:=sed -i '' -e
-endif
+# BCF - BCF Python library
+# Copyright (C) 2021 Prabhat Singh <singh01prabhat@gmail.com>
+#
+# This file is part of BCF.
+#
+# BCF is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# BCF is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with BCF.  If not, see <http://www.gnu.org/licenses/>.
+
+PACKAGE_NAME:=bcf
+include ../common.mk
 
 .PHONY: ci
 ci:
@@ -15,16 +30,13 @@ license:
 # TODO: make this based on xsd file presence
 .PHONY: models
 models:
-	cd src && xsdata generate -p bcf.v2.model --unnest-classes --kw-only --slots -ds Google bcf/v2/xsd
-	cd src && xsdata generate -p bcf.v3.model --unnest-classes --kw-only --slots -ds Google bcf/v3/xsd
+	xsdata generate -p bcf.v2.model --unnest-classes --kw-only --slots -ds Google bcf/v2/xsd
+	xsdata generate -p bcf.v3.model --unnest-classes --kw-only --slots -ds Google bcf/v3/xsd
 
-.PHONY: dist
-dist:
-	rm -rf dist
-	$(SED) "s/999999/$(VERSION)/" pyproject.toml
-	python -m build
-	$(SED) "s/$(VERSION)/999999/" pyproject.toml
+.PHONY: test
+test:
+	pytest -p no:pytest-blender tests
 
 # .PHONY
 # api:
-#     openapi-python-client generate --url https://api.swaggerhub.com/apis/buildingSMART/BCF/3.0
+#     openapi-python-client generate --url https://api.swaggerhub.com/apis/buildingSMART/BCF/3.0

src/bcf/README.md

@@ -3,3 +3,7 @@
 A simple Python implementation of the BCF standard. Manipulation of BCF-XML is
 available via `bcfxml.py` and manipulation of BCF-API is available via
 `bcfapi.py`.
+
+Python files in 'model' folder are automatically generated from .xsd files (located in 'xsd' folder).
+To regenerate them you can use `make models`.
+The only exception is 'v2/model/extensions.py', see it's note for the details.

src/bcf/bcf/__init__.py

@@ -15,3 +15,5 @@
 #
 # You should have received a copy of the GNU Lesser General Public License
 # along with BCF.  If not, see <http://www.gnu.org/licenses/>.
+
+__version__ = version = "0.0.0"

src/bcf/bcf/agnostic/extensions.py

@@ -0,0 +1,28 @@
+import bcf.v2.model.extensions
+import bcf.v3.model.extensions
+from typing import NamedTuple, Union
+from dataclasses import fields
+
+
+class AttributeData(NamedTuple):
+    attr_type: type
+    subattr_name: str
+    subattr_xsd_name: str
+
+
+Extensions = Union[bcf.v2.model.extensions.Extensions, bcf.v3.model.extensions.Extensions]
+
+
+def get_extensions_attributes(extensions: Extensions) -> dict[str, AttributeData]:
+    """Return mapping of xsd attribute name to a tuple that consists of:
+    - Extensions attribute name
+    - Extensions attribute type type
+    - subattribute name"""
+    possible_attributes = {}
+    for field in fields(type(extensions)):
+        field_type = field.type.__args__[0]  # type: ignore [reportAttributeAccessIssue]
+        subfield = next(iter(fields(field_type)))
+        xsd_name = subfield.metadata["name"]
+        possible_attributes[field.name] = AttributeData(field_type, subfield.name, xsd_name)
+
+    return possible_attributes

src/bcf/bcf/agnostic/model.py

@@ -0,0 +1,10 @@
+import bcf.v2.model
+import bcf.v3.model
+from typing import Union
+
+BimSnippet = Union[bcf.v2.model.BimSnippet, bcf.v3.model.BimSnippet]
+BitMap = Union[bcf.v2.model.VisualizationInfoBitmap, bcf.v3.model.Bitmap]
+DocumentReference = Union[bcf.v2.model.TopicDocumentReference, bcf.v3.model.DocumentReference]
+HeaderFile = Union[bcf.v2.model.HeaderFile, bcf.v3.model.File]
+Topic = Union[bcf.v2.model.Topic, bcf.v3.model.Topic]
+ViewPoint = Union[bcf.v2.model.ViewPoint, bcf.v3.model.ViewPoint]

src/bcf/bcf/agnostic/topic.py

@@ -0,0 +1,101 @@
+import tempfile
+import bcf.v2.bcfxml
+import bcf.v2.model
+import bcf.v2.topic
+import bcf.v3.bcfxml
+import bcf.v3.model
+import bcf.v3.topic
+import bcf.agnostic.model as mdl
+from pathlib import Path
+from typing import Union, Optional
+from typing_extensions import assert_never
+
+TopicHandler = Union[bcf.v2.topic.TopicHandler, bcf.v3.topic.TopicHandler]
+
+
+def extract_file(
+    topic: TopicHandler,
+    entity: Union[mdl.HeaderFile, mdl.BimSnippet, mdl.DocumentReference, mdl.BitMap],
+    bcfxml: Optional[Union[bcf.v2.bcfxml.BcfXml, bcf.v3.bcfxml.BcfXml]] = None,
+    outfile: Optional[Path] = None,
+) -> Union[Path, str, None]:
+    """Extracts an element with a file into a temporary directory
+
+    These include header files, bim snippets, document references, and
+    viewpoint bitmaps. External reference are not downloaded. Instead, the
+    URI reference is returned.
+
+    :param entity: The entity with a file reference to extract
+    :param outfile: If provided, save the header file to that location.
+        Otherwise, a temporary directory is created and the filename is
+        derived from the header's original filename.
+    :param bcfxml: The BCF XML file to use for resolving document references files.
+        Required only for BCF v3 document references (in BCF v3 internal documents
+        are stored at BCF root, not in the topic).
+    :return: The filepath of the extracted file. It may be a URL if the
+        header file is external.
+    """
+    if isinstance(entity, mdl.DocumentReference):
+        if isinstance(entity, bcf.v2.model.TopicDocumentReference):
+            reference = entity.referenced_document
+        else:
+            reference = entity.document_guid
+    else:
+        reference = entity.reference
+
+    if not reference:
+        return None
+
+    # For v3 document references external documents are detected by empty document_guid.
+    # External bitmaps are not supported by bcf.
+    if not isinstance(entity, (bcf.v3.model.DocumentReference, mdl.BitMap)) and entity.is_external:
+        return reference
+
+    if isinstance(entity, bcf.v3.model.DocumentReference):
+        # Extract document reference filename and contents.
+        if not bcfxml:
+            raise TypeError("bcfxml is required for BCF v3 document references.")
+        assert isinstance(bcfxml, bcf.v3.bcfxml.BcfXml)
+        error_msg = f"BCF XML is missing document with guid '{reference}'."
+        if not bcfxml.documents:
+            raise Exception(error_msg)
+        definition_docs = bcfxml.documents.definition.documents
+        if not definition_docs:
+            raise Exception(error_msg)
+        docs = next((doc for doc in definition_docs.document if doc.guid == reference), None)
+        if not docs:
+            raise Exception(error_msg)
+        filename = docs.filename
+        bytes_data = bcfxml.documents.documents[filename]
+    else:
+        if isinstance(entity, mdl.BimSnippet):
+            bytes_data = topic.bim_snippet
+            assert isinstance(bytes_data, bytes)
+        elif isinstance(entity, mdl.HeaderFile):
+            bytes_data = topic.reference_files[reference]
+        elif isinstance(entity, mdl.BitMap):
+            bytes_data = next(
+                byte_data
+                for vp in topic.viewpoints.values()
+                for data_reference, byte_data in vp.bitmaps.items()
+                if data_reference == reference
+            )
+        elif isinstance(entity, bcf.v2.model.TopicDocumentReference):
+            assert isinstance(topic, bcf.v2.topic.TopicHandler)
+            bytes_data = topic.document_references[reference]
+        else:
+            assert_never(entity)
+
+        # We don't really need it if 'outfile' is None, just keeping type checker happy.
+        if isinstance(entity, mdl.HeaderFile) and entity.filename:
+            filename = entity.filename
+        else:
+            filename = Path(reference).name
+
+    if not outfile:
+        outfile = Path(tempfile.mkdtemp()) / filename
+
+    with open(outfile, "wb") as f:
+        f.write(bytes_data)
+
+    return outfile

src/bcf/bcf/agnostic/visinfo.py

@@ -0,0 +1,5 @@
+import bcf.v2.visinfo
+import bcf.v3.visinfo
+from typing import Union
+
+VisualizationInfoHandler = Union[bcf.v2.visinfo.VisualizationInfoHandler, bcf.v3.visinfo.VisualizationInfoHandler]

src/bcf/bcf/bcfxml.py

@@ -18,6 +18,7 @@ GNU Lesser General Public License for more details.
 You should have received a copy of the GNU Lesser General Public License
 along with BCF.  If not, see <http://www.gnu.org/licenses/>.
 """
+
 import zipfile
 from pathlib import Path
 from typing import Optional, Union
@@ -29,9 +30,10 @@ from bcf.v3.model import Version as Version3
 from bcf.xml_parser import AbstractXmlParserSerializer, XmlParserSerializer
 
 
-def load(
-    filepath: Path, xml_handler: Optional[AbstractXmlParserSerializer] = None
-) -> Optional[Union[BcfXml2, BcfXml3]]:
+BcfXml = Union[BcfXml2, BcfXml3]
+
+
+def load(filepath: Path, xml_handler: Optional[AbstractXmlParserSerializer] = None) -> Optional[BcfXml]:
     """
     Load a BCF file.
 

src/bcf/bcf/geometry.py

@@ -5,8 +5,8 @@ from numpy.typing import NDArray
 
 
 def camera_vectors_from_element_placement(
-    elem_placement: NDArray[np.float_],
-) -> tuple[NDArray[np.float_], NDArray[np.float_], NDArray[np.float_]]:
+    elem_placement: NDArray[np.float64],
+) -> tuple[NDArray[np.float64], NDArray[np.float64], NDArray[np.float64]]:
     """
     Calculate the vectors of a camera pointing to an element.
 
@@ -21,8 +21,8 @@ def camera_vectors_from_element_placement(
 
 
 def camera_vectors_from_target_position(
-    target_position: NDArray[np.float_], offset: Optional[NDArray[np.float_]] = None
-) -> tuple[NDArray[np.float_], NDArray[np.float_], NDArray[np.float_]]:
+    target_position: NDArray[np.float64], offset: Optional[NDArray[np.float64]] = None
+) -> tuple[NDArray[np.float64], NDArray[np.float64], NDArray[np.float64]]:
     """
     Calculate the vectors of a camera pointing to a target point.
 
@@ -50,7 +50,7 @@ def camera_vectors_from_target_position(
     # return camera_position, -mat[:3, 2], mat[:3, 1]
 
 
-def unit_vector(v: NDArray[np.float_]) -> NDArray[np.float_]:
+def unit_vector(v: NDArray[np.float64]) -> NDArray[np.float64]:
     """
     Return the unit vector of a vector.
 

src/bcf/bcf/inmemory_zipfile.py

@@ -5,6 +5,7 @@ Copyright (c) 2017-2020 Anthon van der Neut, Ruamel bvba
 
 original idea from https://stackoverflow.com/a/19722365/1307905
 """
+
 import zipfile
 from io import BytesIO
 from os import PathLike
@@ -13,8 +14,7 @@ from typing import Any, Optional, Protocol
 
 
 class ZipFileInterface(Protocol):
-    def writestr(self, filename_in_zip: str | zipfile.ZipInfo, file_contents: bytes | str) -> None:
-        ...
+    def writestr(self, filename_in_zip: str | zipfile.ZipInfo, file_contents: bytes | str) -> None: ...
 
 
 class InMemoryZipFile:

src/bcf/bcf/v2/bcfxml.py

@@ -1,11 +1,14 @@
 """BCF XML V2 handler."""
+
 import uuid
 import warnings
 import zipfile
 from pathlib import Path
 from typing import Any, NoReturn, Optional, TypeVar
 
+import bcf.agnostic.extensions
 import bcf.v2.model as mdl
+import bcf.v2.model.extensions as mdl_extensions
 from bcf.inmemory_zipfile import InMemoryZipFile, ZipFileInterface
 from bcf.v2.topic import TopicHandler
 from bcf.xml_parser import AbstractXmlParserSerializer, XmlParserSerializer
@@ -23,7 +26,8 @@ class BcfXml:
         self._xml_handler = xml_handler or XmlParserSerializer()
         self._version: Optional[mdl.Version] = None
         self._project_info: Optional[mdl.ProjectExtension] = None
-        self._topics: dict[str, TopicHandler] = {}
+        self._extensions: Optional[mdl_extensions.Extensions] = None
+        self._topics: Optional[dict[str, TopicHandler]] = None
         self._extension_schema: Optional[bytes] = None
         self._zip_file = self._load_zip_file()
 
@@ -84,24 +88,63 @@ class BcfXml:
     def extension_schema(self, value: bytes) -> None:
         self._extension_schema = value
 
+    @property
+    def extensions(self) -> Optional[mdl_extensions.Extensions]:
+        """BCF extensions."""
+
+        if not self._extensions and self.extension_schema:
+            import io
+            from xml.etree import ElementTree as etree
+
+            extensions = mdl_extensions.Extensions()
+
+            xs = "{http://www.w3.org/2001/XMLSchema}"
+            root = etree.parse(io.BytesIO((self.extension_schema)))
+
+            attrs = bcf.agnostic.extensions.get_extensions_attributes(extensions)
+            xsd_to_attrs = {v.subattr_xsd_name: k for k, v in attrs.items()}
+            for node in root.findall(f".//{xs}restriction"):
+                attr_type = node.attrib.get("base")
+                if not attr_type:
+                    continue
+                attr_name = xsd_to_attrs.get(attr_type)
+                if attr_name is None:
+                    continue
+                values = []
+                for enum in node.findall(f".//{xs}enumeration"):
+                    values.append(enum.attrib["value"])
+                if not values:
+                    continue
+                attr_data = attrs[attr_name]
+                attr = attr_data.attr_type()
+                setattr(attr, attr_data.subattr_name, values)
+                setattr(extensions, attr_name, attr)
+
+            self._extensions = extensions
+        return self._extensions
+
+    @extensions.setter
+    def extensions(self, value: Optional[mdl_extensions.Extensions]) -> None:
+        self._extensions = value
+
     @property
     def topics(self) -> dict[str, TopicHandler]:
         """BCF topics."""
-        if not self._topics and self._zip_file:
-            self._topics = self._load_topics(self._zip_file, self._xml_handler)
+        if self._topics is None:
+            self._topics = self._load_topics()
         return self._topics
 
-    def _load_topics(
-        self, zip_file: zipfile.ZipFile, xml_handler: AbstractXmlParserSerializer
-    ) -> dict[str, TopicHandler]:
+    def _load_topics(self) -> dict[str, TopicHandler]:
         topics = {}
-        for topic_dir in zipfile.Path(zip_file).iterdir():
+        if self._zip_file is None:
+            return topics
+        for topic_dir in zipfile.Path(self._zip_file).iterdir():
             if not topic_dir.is_dir():
                 continue
             markup_path = topic_dir.joinpath("markup.bcf")
             if not markup_path.exists():
                 continue
-            topics[topic_dir.name] = TopicHandler(topic_dir, xml_handler)
+            topics[topic_dir.name] = TopicHandler(topic_dir, self._xml_handler)
         return topics
 
     @classmethod

src/bcf/bcf/v2/model/extensions.py

@@ -0,0 +1,197 @@
+# NOTE: This file is not generated from
+# https://github.com/buildingSMART/BCF-XML/blob/release_2_1/Extension%20Schemas/extensions.xsd
+# because in bcf 2.1 there is no extensions.xml - I guess, the schema assumes that each .bcf
+# will use their own schema patched by it's own extensions.xsd.
+#
+# To make things simpler we just mimic extensions structures from bcf 3, so they'll have common API,
+# and parse extensions.xsd inside .bcf as .xml and fill our structures.
+#
+# Preferably if we could generate some kind of extensions.xml from extensions.xsd
+# and leave all the handling to xsdata.
+#
+# We also don't add it to __init__.py not to mess with generator.
+#
+# Currently extensions support for v2 is only read-only.
+
+
+from dataclasses import dataclass, field, fields
+from typing import List, NamedTuple, Optional
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsPriorities:
+    class Meta:
+        global_type = False
+
+    priority: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "Priority",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsSnippetTypes:
+    class Meta:
+        global_type = False
+
+    snippet_type: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "SnippetType",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsStages:
+    class Meta:
+        global_type = False
+
+    stage: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "Stage",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsTopicLabels:
+    class Meta:
+        global_type = False
+
+    topic_label: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "TopicLabel",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsTopicStatuses:
+    class Meta:
+        global_type = False
+
+    topic_status: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "TopicStatus",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsTopicTypes:
+    class Meta:
+        global_type = False
+
+    topic_type: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "TopicType",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class ExtensionsUsers:
+    class Meta:
+        global_type = False
+
+    user: List[str] = field(
+        default_factory=list,
+        metadata={
+            "name": "UserIdType",
+            "type": "Element",
+            "namespace": "",
+            "min_length": 1,
+            "white_space": "collapse",
+        },
+    )
+
+
+@dataclass(slots=True, kw_only=True)
+class Extensions:
+    topic_types: Optional[ExtensionsTopicTypes] = field(
+        default=None,
+        metadata={
+            "name": "TopicTypes",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    topic_statuses: Optional[ExtensionsTopicStatuses] = field(
+        default=None,
+        metadata={
+            "name": "TopicStatuses",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    priorities: Optional[ExtensionsPriorities] = field(
+        default=None,
+        metadata={
+            "name": "Priorities",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    topic_labels: Optional[ExtensionsTopicLabels] = field(
+        default=None,
+        metadata={
+            "name": "TopicLabels",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    users: Optional[ExtensionsUsers] = field(
+        default=None,
+        metadata={
+            "name": "Users",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    snippet_types: Optional[ExtensionsSnippetTypes] = field(
+        default=None,
+        metadata={
+            "name": "SnippetTypes",
+            "type": "Element",
+            "namespace": "",
+        },
+    )
+    stages: Optional[ExtensionsStages] = field(
+        default=None,
+        metadata={
+            "name": "Stages",
+            "type": "Element",
+            "namespace": "",
+        },
+    )

src/bcf/bcf/v2/model/markup.py

@@ -34,7 +34,7 @@ class BimSnippet:
         metadata={
             "name": "isExternal",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -64,7 +64,7 @@ class HeaderFile:
             "name": "Filename",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     date: Optional[XmlDateTime] = field(
         default=None,
@@ -72,7 +72,7 @@ class HeaderFile:
             "name": "Date",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     reference: Optional[str] = field(
         default=None,
@@ -80,7 +80,7 @@ class HeaderFile:
             "name": "Reference",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     ifc_project: Optional[str] = field(
         default=None,
@@ -89,7 +89,7 @@ class HeaderFile:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9,A-Z,a-z,_$]*",
-        }
+        },
     )
     ifc_spatial_structure_element: Optional[str] = field(
         default=None,
@@ -98,14 +98,14 @@ class HeaderFile:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9,A-Z,a-z,_$]*",
-        }
+        },
     )
     is_external: bool = field(
         default=True,
         metadata={
             "name": "isExternal",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -120,7 +120,7 @@ class TopicDocumentReference:
             "name": "ReferencedDocument",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     description: Optional[str] = field(
         default=None,
@@ -128,7 +128,7 @@ class TopicDocumentReference:
             "name": "Description",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: Optional[str] = field(
         default=None,
@@ -136,14 +136,14 @@ class TopicDocumentReference:
             "name": "Guid",
             "type": "Attribute",
             "pattern": r"[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}",
-        }
+        },
     )
     is_external: bool = field(
         default=False,
         metadata={
             "name": "isExternal",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -170,7 +170,7 @@ class ViewPoint:
             "name": "Viewpoint",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     snapshot: Optional[str] = field(
         default=None,
@@ -178,7 +178,7 @@ class ViewPoint:
             "name": "Snapshot",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     index: Optional[int] = field(
         default=None,
@@ -186,7 +186,7 @@ class ViewPoint:
             "name": "Index",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -230,7 +230,7 @@ class Comment:
             "name": "Viewpoint",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_date: Optional[XmlDateTime] = field(
         default=None,
@@ -238,7 +238,7 @@ class Comment:
             "name": "ModifiedDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_author: Optional[str] = field(
         default=None,
@@ -246,7 +246,7 @@ class Comment:
             "name": "ModifiedAuthor",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -267,7 +267,7 @@ class Header:
             "type": "Element",
             "namespace": "",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -279,7 +279,7 @@ class Topic:
             "name": "ReferenceLink",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     title: str = field(
         metadata={
@@ -295,7 +295,7 @@ class Topic:
             "name": "Priority",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     index: Optional[int] = field(
         default=None,
@@ -303,7 +303,7 @@ class Topic:
             "name": "Index",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     labels: List[str] = field(
         default_factory=list,
@@ -311,7 +311,7 @@ class Topic:
             "name": "Labels",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     creation_date: XmlDateTime = field(
         metadata={
@@ -335,7 +335,7 @@ class Topic:
             "name": "ModifiedDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_author: Optional[str] = field(
         default=None,
@@ -343,7 +343,7 @@ class Topic:
             "name": "ModifiedAuthor",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     due_date: Optional[XmlDateTime] = field(
         default=None,
@@ -351,7 +351,7 @@ class Topic:
             "name": "DueDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     assigned_to: Optional[str] = field(
         default=None,
@@ -359,7 +359,7 @@ class Topic:
             "name": "AssignedTo",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     stage: Optional[str] = field(
         default=None,
@@ -367,7 +367,7 @@ class Topic:
             "name": "Stage",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     description: Optional[str] = field(
         default=None,
@@ -375,7 +375,7 @@ class Topic:
             "name": "Description",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     bim_snippet: Optional[BimSnippet] = field(
         default=None,
@@ -383,7 +383,7 @@ class Topic:
             "name": "BimSnippet",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     document_reference: List[TopicDocumentReference] = field(
         default_factory=list,
@@ -391,7 +391,7 @@ class Topic:
             "name": "DocumentReference",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     related_topic: List[TopicRelatedTopic] = field(
         default_factory=list,
@@ -399,7 +399,7 @@ class Topic:
             "name": "RelatedTopic",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -414,14 +414,14 @@ class Topic:
         metadata={
             "name": "TopicType",
             "type": "Attribute",
-        }
+        },
     )
     topic_status: Optional[str] = field(
         default=None,
         metadata={
             "name": "TopicStatus",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -433,7 +433,7 @@ class Markup:
             "name": "Header",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     topic: Topic = field(
         metadata={
@@ -449,7 +449,7 @@ class Markup:
             "name": "Comment",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     viewpoints: List[ViewPoint] = field(
         default_factory=list,
@@ -457,5 +457,5 @@ class Markup:
             "name": "Viewpoints",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )

src/bcf/bcf/v2/model/project.py

@@ -10,7 +10,7 @@ class Project:
             "name": "Name",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     project_id: str = field(
         metadata={
@@ -29,7 +29,7 @@ class ProjectExtension:
             "name": "Project",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     extension_schema: str = field(
         metadata={

src/bcf/bcf/v2/model/version.py

@@ -10,12 +10,12 @@ class Version:
             "name": "DetailedVersion",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     version_id: Optional[str] = field(
         default=None,
         metadata={
             "name": "VersionId",
             "type": "Attribute",
-        }
+        },
     )

src/bcf/bcf/v2/model/visinfo.py

@@ -15,14 +15,14 @@ class Component:
         metadata={
             "name": "OriginatingSystem",
             "type": "Element",
-        }
+        },
     )
     authoring_tool_id: Optional[str] = field(
         default=None,
         metadata={
             "name": "AuthoringToolId",
             "type": "Element",
-        }
+        },
     )
     ifc_guid: Optional[str] = field(
         default=None,
@@ -31,7 +31,7 @@ class Component:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9,A-Z,a-z,_$]*",
-        }
+        },
     )
 
 
@@ -92,21 +92,21 @@ class ViewSetupHints:
         metadata={
             "name": "SpacesVisible",
             "type": "Attribute",
-        }
+        },
     )
     space_boundaries_visible: Optional[bool] = field(
         default=None,
         metadata={
             "name": "SpaceBoundariesVisible",
             "type": "Attribute",
-        }
+        },
     )
     openings_visible: Optional[bool] = field(
         default=None,
         metadata={
             "name": "OpeningsVisible",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -139,7 +139,7 @@ class ComponentColoringColor:
             "name": "Component",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
     color: Optional[str] = field(
         default=None,
@@ -147,7 +147,7 @@ class ComponentColoringColor:
             "name": "Color",
             "type": "Attribute",
             "pattern": r"[0-9,a-f,A-F]{6}([0-9,a-f,A-F]{2})?",
-        }
+        },
     )
 
 
@@ -159,7 +159,7 @@ class ComponentSelection:
             "name": "Component",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -174,7 +174,7 @@ class ComponentVisibilityExceptions:
             "name": "Component",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -205,6 +205,7 @@ class OrthogonalCamera:
         camera_up_vector:
         view_to_world_scale: view's visible size in meters
     """
+
     camera_view_point: Point = field(
         metadata={
             "name": "CameraViewPoint",
@@ -247,6 +248,7 @@ class PerspectiveCamera:
             release and viewers should be expect values outside this
             range in current implementations.
     """
+
     camera_view_point: Point = field(
         metadata={
             "name": "CameraViewPoint",
@@ -336,7 +338,7 @@ class ComponentColoring:
             "name": "Color",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -347,14 +349,14 @@ class ComponentVisibility:
         metadata={
             "name": "Exceptions",
             "type": "Element",
-        }
+        },
     )
     default_visibility: Optional[bool] = field(
         default=None,
         metadata={
             "name": "DefaultVisibility",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -368,7 +370,7 @@ class VisualizationInfoClippingPlanes:
         metadata={
             "name": "ClippingPlane",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -383,7 +385,7 @@ class VisualizationInfoLines:
             "name": "Line",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -394,14 +396,14 @@ class Components:
         metadata={
             "name": "ViewSetupHints",
             "type": "Element",
-        }
+        },
     )
     selection: Optional[ComponentSelection] = field(
         default=None,
         metadata={
             "name": "Selection",
             "type": "Element",
-        }
+        },
     )
     visibility: ComponentVisibility = field(
         metadata={
@@ -415,7 +417,7 @@ class Components:
         metadata={
             "name": "Coloring",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -424,47 +426,48 @@ class VisualizationInfo:
     """
     VisualizationInfo documentation.
     """
+
     components: Optional[Components] = field(
         default=None,
         metadata={
             "name": "Components",
             "type": "Element",
-        }
+        },
     )
     orthogonal_camera: Optional[OrthogonalCamera] = field(
         default=None,
         metadata={
             "name": "OrthogonalCamera",
             "type": "Element",
-        }
+        },
     )
     perspective_camera: Optional[PerspectiveCamera] = field(
         default=None,
         metadata={
             "name": "PerspectiveCamera",
             "type": "Element",
-        }
+        },
     )
     lines: Optional[VisualizationInfoLines] = field(
         default=None,
         metadata={
             "name": "Lines",
             "type": "Element",
-        }
+        },
     )
     clipping_planes: Optional[VisualizationInfoClippingPlanes] = field(
         default=None,
         metadata={
             "name": "ClippingPlanes",
             "type": "Element",
-        }
+        },
     )
     bitmap: List[VisualizationInfoBitmap] = field(
         default_factory=list,
         metadata={
             "name": "Bitmap",
             "type": "Element",
-        }
+        },
     )
     guid: str = field(
         metadata={

src/bcf/bcf/v2/topic.py

@@ -1,10 +1,11 @@
 """BCF XML V2 Topic handler."""
+
 import datetime
 import tempfile
 import uuid
 import zipfile
 from pathlib import Path
-from typing import Any, NoReturn, Optional
+from typing import Any, NoReturn, Optional, Union
 
 import numpy as np
 from ifcopenshell import entity_instance
@@ -26,9 +27,9 @@ class TopicHandler:
         xml_handler: Optional[AbstractXmlParserSerializer] = None,
     ) -> None:
         self._markup: Optional[mdl.Markup] = None
-        self._viewpoints: dict[str, VisualizationInfoHandler] = {}
-        self._reference_files: dict[str, bytes] = {}
-        self._document_references: dict[str, bytes] = {}
+        self._viewpoints: Optional[dict[str, VisualizationInfoHandler]] = None
+        self._reference_files: Optional[dict[str, bytes]] = None
+        self._document_references: Optional[dict[str, bytes]] = None
         self._bim_snippet: Optional[bytes] = None
         self._xml_handler = xml_handler or XmlParserSerializer()
         self._topic_dir = topic_dir
@@ -62,11 +63,21 @@ class TopicHandler:
         """Return the header of the topic."""
         return self.markup.header if self.markup else None
 
+    @header.setter
+    def header(self, header: mdl.Header) -> None:
+        """Set the header of the topic."""
+        self.markup.header = header
+
     @property
     def comments(self) -> list[mdl.Comment]:
         """Return the comments of the topic."""
         return self.markup.comment if self.markup else []
 
+    @comments.setter
+    def comments(self, comments: list[mdl.Comment]) -> None:
+        assert self.markup
+        self.markup.comment = comments
+
     @property
     def bim_snippet(self) -> Optional[bytes]:
         if not self._bim_snippet and self._topic_dir:
@@ -79,14 +90,24 @@ class TopicHandler:
 
     @property
     def viewpoints(self) -> dict[str, VisualizationInfoHandler]:
-        if not self._viewpoints and self._topic_dir:
+        if self._viewpoints is None:
             self._viewpoints = self._load_viewpoints()
         return self._viewpoints
 
+    def _load_viewpoints(self) -> dict[str, VisualizationInfoHandler]:
+        if self._topic_dir and self.markup and (viewpoints := self.markup.viewpoints):
+            return VisualizationInfoHandler.from_topic_viewpoints(self._topic_dir, viewpoints)
+        return {}
+
     @property
     def reference_files(self) -> dict[str, bytes]:
-        if self._reference_files or not self.header:
+        if self._reference_files is not None:
             return self._reference_files
+
+        self._reference_files = {}
+        if not self.header:
+            return self._reference_files
+
         for ref in self.header.file:
             if ref.is_external:
                 continue
@@ -98,8 +119,13 @@ class TopicHandler:
 
     @property
     def document_references(self) -> dict[str, bytes]:
-        if self._document_references or not self.topic:
+        if self._document_references is not None:
             return self._document_references
+
+        self._document_references = {}
+        if not self.topic:
+            return self._document_references
+
         for doc in self.topic.document_reference:
             if doc.is_external or not doc.referenced_document:
                 continue
@@ -117,11 +143,6 @@ class TopicHandler:
                 return bim_snippet_path.read_bytes()
         return None
 
-    def _load_viewpoints(self) -> dict[str, VisualizationInfoHandler]:
-        if self.markup and (viewpoints := self.markup.viewpoints):
-            return VisualizationInfoHandler.from_topic_viewpoints(self._topic_dir, viewpoints)
-        return {}
-
     @classmethod
     def create_new(
         cls,
@@ -219,55 +240,7 @@ class TopicHandler:
                 real_path = real_path.parent if path_part == ".." else real_path.joinpath(path_part)
             destination_zip.writestr(real_path.at, self.document_references[doc.referenced_document])
 
-    def extract_file(self, entity, outfile: Optional[Path] = None) -> Path:
-        """Extracts an element with a file into a temporary directory
-
-        These include header files, bim snippets, document references, and
-        viewpoint bitmaps. External reference are not downloaded. Instead, the
-        URI reference is returned.
-
-        :param entity: The entity with a file reference to extract
-        :type entity: bcf.v2.model.HeaderFile,bcf.v2.model.BimSnippet,bcf.v2.model.TopicDocumentReference
-        :param outfile: If provided, save the header file to that location.
-            Otherwise, a temporary directory is created and the filename is
-            derived from the header's original filename.
-        :type outfile: pathlib.Path,optional
-        :return: The filepath of the extracted file. It may be a URL if the
-            header file is external.
-        :rtype: Path
-        """
-        if hasattr(entity, "reference"):
-            reference = entity.reference
-        else:
-            reference = entity.referenced_document
-
-        if not reference:
-            return
-
-        if getattr(entity, "is_external", False):
-            return entity.reference
-
-        resolved_reference = self._topic_dir
-
-        for part in Path(reference).parts:
-            if part == "..":
-                resolved_reference = resolved_reference.parent
-            else:
-                resolved_reference = resolved_reference.joinpath(part)
-
-        if not outfile:
-            if getattr(entity, "filename", None):
-                filename = entity.filename
-            else:
-                filename = resolved_reference.name
-            outfile = Path(tempfile.mkdtemp()) / filename
-
-        with open(outfile, "wb") as f:
-            f.write(resolved_reference.read_bytes())
-
-        return outfile
-
-    def add_viewpoint(self, element: entity_instance) -> None:
+    def add_viewpoint(self, element: entity_instance) -> VisualizationInfoHandler:
         """Add a viewpoint pointed at the placement of an IFC element to the topic.
 
         Args:
@@ -277,7 +250,9 @@ class TopicHandler:
         self.add_visinfo_handler(new_viewpoint)
         return new_viewpoint
 
-    def add_viewpoint_from_point_and_guids(self, position: NDArray[np.float_], *guids: str) -> None:
+    def add_viewpoint_from_point_and_guids(
+        self, position: NDArray[np.float64], *guids: str
+    ) -> VisualizationInfoHandler:
         """Add a viewpoint pointing at an XYZ point in space
 
         Args:
@@ -290,9 +265,17 @@ class TopicHandler:
         self.add_visinfo_handler(vi_handler)
         return vi_handler
 
-    def add_visinfo_handler(self, new_viewpoint: VisualizationInfoHandler) -> None:
+    def add_visinfo_handler(
+        self, new_viewpoint: VisualizationInfoHandler, snapshot_filename: Optional[str] = None
+    ) -> mdl.ViewPoint:
         self.viewpoints[new_viewpoint.guid + ".bcfv"] = new_viewpoint
-        self.markup.viewpoints.append(mdl.ViewPoint(viewpoint=new_viewpoint.guid + ".bcfv", guid=new_viewpoint.guid))
+        viewpoint = mdl.ViewPoint(
+            viewpoint=new_viewpoint.guid + ".bcfv",
+            snapshot=snapshot_filename,
+            guid=new_viewpoint.guid,
+        )
+        self.markup.viewpoints.append(viewpoint)
+        return viewpoint
 
     def __eq__(self, other: object) -> bool | NoReturn:
         return (

src/bcf/bcf/v2/visinfo.py

@@ -1,7 +1,6 @@
 import uuid
 import zipfile
-from functools import lru_cache
-from typing import Any, Iterable, Optional
+from typing import Any, Iterable, Optional, Literal, Union
 
 import numpy as np
 from ifcopenshell import entity_instance
@@ -134,6 +133,15 @@ class VisualizationInfoHandler:
         self._save_bitmaps(bcf_zip, topic_dir)
 
     def _save_snapshot(self, bcf_zip: ZipFileInterface, topic_dir: str, filename: Optional[str]) -> None:
+        if bool(self.snapshot) ^ bool(filename):
+            data = ["data (VisualizationInfoHandler.snapshot)", "filename (ViewPoint.snapshot)"]
+            provided_data, missing_data = data if self.snapshot else data[::-1]
+            print(
+                f"WARNING. Snapshot with viewpoint guid '{self.guid}' won't be saved to bcf. "
+                f"Only snapshot {provided_data} is provided but snapshot {missing_data} is missing."
+            )
+            return
+
         if self.snapshot and filename:
             bcf_zip.writestr(f"{topic_dir}/{filename}", self.snapshot)
 
@@ -176,7 +184,7 @@ class VisualizationInfoHandler:
     @classmethod
     def create_from_point_and_guids(
         cls,
-        position: NDArray[np.float_],
+        position: NDArray[np.float64],
         *guids: str,
         xml_handler: Optional[AbstractXmlParserSerializer] = None,
     ) -> "VisualizationInfoHandler":
@@ -196,13 +204,110 @@ class VisualizationInfoHandler:
             visualization_info=build_viewpoint_from_position_and_guids(position, *guids), xml_handler=xml_handler
         )
 
+    def get_selected_guids(self) -> Union[list[str], None]:
+        """
+        Return viewpoint selected elements IFC guids.
+
+        Returns:
+            If viewpoint has no selection settings, return `None`.
+            Otherwise return a list of selected elements IFC guids.
+        """
+        visualization_info = self.visualization_info
+        components = visualization_info.components
+        if not components:
+            return None
+
+        selection = components.selection
+        if not selection:
+            return None
+        return [guid for c in selection.component if (guid := c.ifc_guid)]
+
+    def set_selected_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        visualization_info = self.visualization_info
+
+        guids = [e.GlobalId for e in elements]
+        components = visualization_info.components
+        if not components:
+            visibility = mdl.ComponentVisibility(default_visibility=True)
+            components = mdl.Components(visibility=visibility)
+            visualization_info.components = components
+
+        selection = components.selection
+        components_list = [mdl.Component(ifc_guid=guid) for guid in guids]
+        if not selection:
+            selection = mdl.ComponentSelection()
+            components.selection = selection
+        selection.component = components_list
+
+    def set_visible_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        self.set_visibility(elements, elements_visibility="VISIBLE")
+
+    def set_hidden_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        self.set_visibility(elements, elements_visibility="HIDDEN")
+
+    def set_visibility(
+        self, elements: list[ifcopenshell.entity_instance], elements_visibility: Literal["VISIBLE", "HIDDEN"]
+    ) -> None:
+        visualization_info = self.visualization_info
+        default_visibility = elements_visibility == "HIDDEN"
+
+        guids = [e.GlobalId for e in elements]
+        components_list = [mdl.Component(ifc_guid=guid) for guid in guids]
+        components = visualization_info.components
+        if not components:
+            visibility = mdl.ComponentVisibility(default_visibility=default_visibility)
+            components = mdl.Components(visibility=visibility)
+            visualization_info.components = components
+
+        visibility = components.visibility
+        if not visibility:
+            visibility = mdl.ComponentVisibility(default_visibility=default_visibility)
+            components.visibility = visibility
+        elif visibility.default_visibility != default_visibility:
+            visibility.default_visibility = default_visibility
+
+        exceptions = visibility.exceptions
+        if not exceptions:
+            exceptions = mdl.ComponentVisibilityExceptions()
+            visibility.exceptions = exceptions
+        exceptions.component = components_list
+
+    def get_elements_visibility(self) -> Union[tuple[bool, list[str]], None]:
+        """
+        Return viewpoint elements visibility settings.
+
+        Returns:
+            If viewpoint has no visibility settings, return `None`.
+            Otherwise return a tuple containing the default visibility
+            and a list of IFC element GUIDs listed as exceptions.
+
+            If default visibility is `True`, all elements are visible except the exceptions.
+
+            If default visibility is `False`, all elements are hidden except the exceptions.
+        """
+
+        visualization_info = self.visualization_info
+        components = visualization_info.components
+        if not components:
+            return None
+
+        visibility = components.visibility
+        if not visibility:
+            return None
+        default_visibility = visibility.default_visibility or False
+
+        exceptions = visibility.exceptions
+        if not exceptions:
+            return default_visibility, []
+        guids = [guid for c in exceptions.component if (guid := c.ifc_guid)]
+        return default_visibility, guids
+
 
-@lru_cache(maxsize=None)
 def build_viewpoint(element: entity_instance) -> mdl.VisualizationInfo:
     """
     Return a BCF viewpoint of an IFC element.
 
-    This function is cached to speedudp the creation of multiple BCF topics regarding the same element.
+    This function is cached to speed up the creation of multiple BCF topics regarding the same element.
 
     Args:
         element: The IFC element to point at.
@@ -224,11 +329,11 @@ def build_viewpoint(element: entity_instance) -> mdl.VisualizationInfo:
     )
 
 
-def build_viewpoint_from_position_and_guids(position: NDArray[np.float_], *guids: str) -> mdl.VisualizationInfo:
+def build_viewpoint_from_position_and_guids(position: NDArray[np.float64], *guids: str) -> mdl.VisualizationInfo:
     """
     Return a BCF viewpoint of an IFC element.
 
-    This function is cached to speedudp the creation of multiple BCF topics regarding the same element.
+    This function is cached to speed up the creation of multiple BCF topics regarding the same element.
 
     Args:
         position: target point coordinates.
@@ -249,7 +354,7 @@ def build_components(*guids: str) -> mdl.Components:
     Return the BCF components from an IFC element GUID.
 
     Args:
-        *guids: One or more IFC element GUID.
+        *guids: One or more selected IFC element GUID.
 
     Returns:
         The BCF components definition.
@@ -261,7 +366,7 @@ def build_components(*guids: str) -> mdl.Components:
     )
 
 
-def build_camera(elem_placement: NDArray[np.float_]) -> mdl.PerspectiveCamera:
+def build_camera(elem_placement: NDArray[np.float64]) -> mdl.PerspectiveCamera:
     """
     Return a BCF camera for an IFC element placement matrix.
 
@@ -275,7 +380,7 @@ def build_camera(elem_placement: NDArray[np.float_]) -> mdl.PerspectiveCamera:
 
 
 def build_camera_from_vectors(
-    camera_position: NDArray[np.float_], camera_dir: NDArray[np.float_], camera_up: NDArray[np.float_]
+    camera_position: NDArray[np.float64], camera_dir: NDArray[np.float64], camera_up: NDArray[np.float64]
 ) -> mdl.PerspectiveCamera:
     """
     Return a BCF camera for an IFC element placement matrix.

src/bcf/bcf/v3/bcfxml.py

@@ -1,4 +1,5 @@
 """BCF XML V3 handlers."""
+
 import uuid
 import warnings
 import zipfile
@@ -25,7 +26,7 @@ class BcfXml:
         self._version: Optional[mdl.Version] = None
         self._project_info: Optional[mdl.ProjectInfo] = None
         self._extensions: Optional[mdl.Extensions] = None
-        self._topics: dict[str, TopicHandler] = {}
+        self._topics: Optional[dict[str, TopicHandler]] = None
         self._documents: Optional[DocumentsHandler] = None
         self._zip_file = self._load_zip_file()
 
@@ -90,18 +91,22 @@ class BcfXml:
     @property
     def topics(self) -> dict[str, TopicHandler]:
         """BCF topics."""
-        if not self._topics and self._zip_file:
-            self._load_topics()
+        if self._topics is None:
+            self._topics = self._load_topics()
         return self._topics
 
-    def _load_topics(self) -> None:
+    def _load_topics(self) -> dict[str, TopicHandler]:
+        topics = {}
+        if self._zip_file is None:
+            return topics
         for topic_dir in zipfile.Path(self._zip_file).iterdir():
             if not topic_dir.is_dir():
                 continue
             markup_path = topic_dir.joinpath("markup.bcf")
             if not markup_path.exists():
                 continue
-            self._topics[topic_dir.name] = TopicHandler(topic_dir, self._xml_handler)
+            topics[topic_dir.name] = TopicHandler(topic_dir, self._xml_handler)
+        return topics
 
     @property
     def documents(self) -> Optional[DocumentsHandler]:

src/bcf/bcf/v3/document.py

@@ -1,4 +1,5 @@
 """BCF XML V3 Documents handler."""
+
 import zipfile
 from typing import Any, Optional
 

src/bcf/bcf/v3/model/documents.py

@@ -22,7 +22,7 @@ class Document:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -45,7 +45,7 @@ class DocumentInfoDocuments:
             "name": "Document",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -57,5 +57,5 @@ class DocumentInfo:
             "name": "Documents",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )

src/bcf/bcf/v3/model/extensions.py

@@ -15,7 +15,7 @@ class ExtensionsPriorities:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -32,7 +32,7 @@ class ExtensionsSnippetTypes:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -49,7 +49,7 @@ class ExtensionsStages:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -66,7 +66,7 @@ class ExtensionsTopicLabels:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -83,7 +83,7 @@ class ExtensionsTopicStatuses:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -100,7 +100,7 @@ class ExtensionsTopicTypes:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -117,7 +117,7 @@ class ExtensionsUsers:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -129,7 +129,7 @@ class Extensions:
             "name": "TopicTypes",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     topic_statuses: Optional[ExtensionsTopicStatuses] = field(
         default=None,
@@ -137,7 +137,7 @@ class Extensions:
             "name": "TopicStatuses",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     priorities: Optional[ExtensionsPriorities] = field(
         default=None,
@@ -145,7 +145,7 @@ class Extensions:
             "name": "Priorities",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     topic_labels: Optional[ExtensionsTopicLabels] = field(
         default=None,
@@ -153,7 +153,7 @@ class Extensions:
             "name": "TopicLabels",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     users: Optional[ExtensionsUsers] = field(
         default=None,
@@ -161,7 +161,7 @@ class Extensions:
             "name": "Users",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     snippet_types: Optional[ExtensionsSnippetTypes] = field(
         default=None,
@@ -169,7 +169,7 @@ class Extensions:
             "name": "SnippetTypes",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     stages: Optional[ExtensionsStages] = field(
         default=None,
@@ -177,5 +177,5 @@ class Extensions:
             "name": "Stages",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )

src/bcf/bcf/v3/model/markup.py

@@ -40,7 +40,7 @@ class BimSnippet:
         metadata={
             "name": "IsExternal",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -68,7 +68,7 @@ class DocumentReference:
             "type": "Element",
             "namespace": "",
             "pattern": r"[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}",
-        }
+        },
     )
     url: Optional[str] = field(
         default=None,
@@ -78,7 +78,7 @@ class DocumentReference:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     description: Optional[str] = field(
         default=None,
@@ -88,7 +88,7 @@ class DocumentReference:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -110,7 +110,7 @@ class File:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     date: Optional[XmlDateTime] = field(
         default=None,
@@ -118,7 +118,7 @@ class File:
             "name": "Date",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     reference: Optional[str] = field(
         default=None,
@@ -128,7 +128,7 @@ class File:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     ifc_project: Optional[str] = field(
         default=None,
@@ -137,7 +137,7 @@ class File:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9A-Za-z_$]*",
-        }
+        },
     )
     ifc_spatial_structure_element: Optional[str] = field(
         default=None,
@@ -146,14 +146,14 @@ class File:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9A-Za-z_$]*",
-        }
+        },
     )
     is_external: bool = field(
         default=True,
         metadata={
             "name": "IsExternal",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -170,7 +170,7 @@ class TopicLabels:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -187,7 +187,7 @@ class TopicReferenceLinks:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
 
 
@@ -216,7 +216,7 @@ class ViewPoint:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     snapshot: Optional[str] = field(
         default=None,
@@ -226,7 +226,7 @@ class ViewPoint:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     index: Optional[int] = field(
         default=None,
@@ -234,7 +234,7 @@ class ViewPoint:
             "name": "Index",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -274,7 +274,7 @@ class Comment:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     viewpoint: Optional[CommentViewpoint] = field(
         default=None,
@@ -282,7 +282,7 @@ class Comment:
             "name": "Viewpoint",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_date: Optional[XmlDateTime] = field(
         default=None,
@@ -290,7 +290,7 @@ class Comment:
             "name": "ModifiedDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_author: Optional[str] = field(
         default=None,
@@ -300,7 +300,7 @@ class Comment:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -323,7 +323,7 @@ class HeaderFiles:
             "name": "File",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -338,7 +338,7 @@ class TopicDocumentReferences:
             "name": "DocumentReference",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -353,7 +353,7 @@ class TopicRelatedTopics:
             "name": "RelatedTopic",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -368,7 +368,7 @@ class TopicViewpoints:
             "name": "ViewPoint",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -380,7 +380,7 @@ class Header:
             "name": "Files",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -395,7 +395,7 @@ class TopicComments:
             "name": "Comment",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
 
 
@@ -407,7 +407,7 @@ class Topic:
             "name": "ReferenceLinks",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     title: str = field(
         metadata={
@@ -427,7 +427,7 @@ class Topic:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     index: Optional[int] = field(
         default=None,
@@ -435,7 +435,7 @@ class Topic:
             "name": "Index",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     labels: Optional[TopicLabels] = field(
         default=None,
@@ -443,7 +443,7 @@ class Topic:
             "name": "Labels",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     creation_date: XmlDateTime = field(
         metadata={
@@ -469,7 +469,7 @@ class Topic:
             "name": "ModifiedDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     modified_author: Optional[str] = field(
         default=None,
@@ -479,7 +479,7 @@ class Topic:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     due_date: Optional[XmlDateTime] = field(
         default=None,
@@ -487,7 +487,7 @@ class Topic:
             "name": "DueDate",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     assigned_to: Optional[str] = field(
         default=None,
@@ -497,7 +497,7 @@ class Topic:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     stage: Optional[str] = field(
         default=None,
@@ -507,7 +507,7 @@ class Topic:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     description: Optional[str] = field(
         default=None,
@@ -517,7 +517,7 @@ class Topic:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     bim_snippet: Optional[BimSnippet] = field(
         default=None,
@@ -525,7 +525,7 @@ class Topic:
             "name": "BimSnippet",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     document_references: Optional[TopicDocumentReferences] = field(
         default=None,
@@ -533,7 +533,7 @@ class Topic:
             "name": "DocumentReferences",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     related_topics: Optional[TopicRelatedTopics] = field(
         default=None,
@@ -541,7 +541,7 @@ class Topic:
             "name": "RelatedTopics",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     comments: Optional[TopicComments] = field(
         default=None,
@@ -549,7 +549,7 @@ class Topic:
             "name": "Comments",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     viewpoints: Optional[TopicViewpoints] = field(
         default=None,
@@ -557,7 +557,7 @@ class Topic:
             "name": "Viewpoints",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     guid: str = field(
         metadata={
@@ -574,7 +574,7 @@ class Topic:
             "type": "Attribute",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     topic_type: str = field(
         metadata={
@@ -604,7 +604,7 @@ class Markup:
             "name": "Header",
             "type": "Element",
             "namespace": "",
-        }
+        },
     )
     topic: Topic = field(
         metadata={

src/bcf/bcf/v3/model/project.py

@@ -12,7 +12,7 @@ class Project:
             "namespace": "",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     project_id: str = field(
         metadata={

src/bcf/bcf/v3/model/visinfo.py

@@ -17,7 +17,7 @@ class Component:
             "type": "Element",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     authoring_tool_id: Optional[str] = field(
         default=None,
@@ -26,7 +26,7 @@ class Component:
             "type": "Element",
             "min_length": 1,
             "white_space": "collapse",
-        }
+        },
     )
     ifc_guid: Optional[str] = field(
         default=None,
@@ -35,7 +35,7 @@ class Component:
             "type": "Attribute",
             "length": 22,
             "pattern": r"[0-9A-Za-z_$]*",
-        }
+        },
     )
 
 
@@ -96,21 +96,21 @@ class ViewSetupHints:
         metadata={
             "name": "SpacesVisible",
             "type": "Attribute",
-        }
+        },
     )
     space_boundaries_visible: bool = field(
         default=False,
         metadata={
             "name": "SpaceBoundariesVisible",
             "type": "Attribute",
-        }
+        },
     )
     openings_visible: bool = field(
         default=False,
         metadata={
             "name": "OpeningsVisible",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -191,7 +191,7 @@ class ComponentColoringColorComponents:
             "name": "Component",
             "type": "Element",
             "min_occurs": 1,
-        }
+        },
     )
 
 
@@ -202,7 +202,7 @@ class ComponentSelection:
         metadata={
             "name": "Component",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -216,7 +216,7 @@ class ComponentVisibilityExceptions:
         metadata={
             "name": "Component",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -249,6 +249,7 @@ class OrthogonalCamera:
         aspect_ratio: Proportional relationship between the width and
             the height of the view (w/h).
     """
+
     camera_view_point: Point = field(
         metadata={
             "name": "CameraViewPoint",
@@ -302,6 +303,7 @@ class PerspectiveCamera:
         aspect_ratio: Proportional relationship between the width and
             the height of the view (w/h).
     """
+
     camera_view_point: Point = field(
         metadata={
             "name": "CameraViewPoint",
@@ -371,21 +373,21 @@ class ComponentVisibility:
         metadata={
             "name": "ViewSetupHints",
             "type": "Element",
-        }
+        },
     )
     exceptions: Optional[ComponentVisibilityExceptions] = field(
         default=None,
         metadata={
             "name": "Exceptions",
             "type": "Element",
-        }
+        },
     )
     default_visibility: bool = field(
         default=False,
         metadata={
             "name": "DefaultVisibility",
             "type": "Attribute",
-        }
+        },
     )
 
 
@@ -399,7 +401,7 @@ class VisualizationInfoBitmaps:
         metadata={
             "name": "Bitmap",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -413,7 +415,7 @@ class VisualizationInfoClippingPlanes:
         metadata={
             "name": "ClippingPlane",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -427,7 +429,7 @@ class VisualizationInfoLines:
         metadata={
             "name": "Line",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -438,7 +440,7 @@ class ComponentColoring:
         metadata={
             "name": "Color",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -449,21 +451,21 @@ class Components:
         metadata={
             "name": "Selection",
             "type": "Element",
-        }
+        },
     )
     visibility: Optional[ComponentVisibility] = field(
         default=None,
         metadata={
             "name": "Visibility",
             "type": "Element",
-        }
+        },
     )
     coloring: Optional[ComponentColoring] = field(
         default=None,
         metadata={
             "name": "Coloring",
             "type": "Element",
-        }
+        },
     )
 
 
@@ -472,47 +474,48 @@ class VisualizationInfo:
     """
     VisualizationInfo documentation.
     """
+
     components: Optional[Components] = field(
         default=None,
         metadata={
             "name": "Components",
             "type": "Element",
-        }
+        },
     )
     orthogonal_camera: Optional[OrthogonalCamera] = field(
         default=None,
         metadata={
             "name": "OrthogonalCamera",
             "type": "Element",
-        }
+        },
     )
     perspective_camera: Optional[PerspectiveCamera] = field(
         default=None,
         metadata={
             "name": "PerspectiveCamera",
             "type": "Element",
-        }
+        },
     )
     lines: Optional[VisualizationInfoLines] = field(
         default=None,
         metadata={
             "name": "Lines",
             "type": "Element",
-        }
+        },
     )
     clipping_planes: Optional[VisualizationInfoClippingPlanes] = field(
         default=None,
         metadata={
             "name": "ClippingPlanes",
             "type": "Element",
-        }
+        },
     )
     bitmaps: Optional[VisualizationInfoBitmaps] = field(
         default=None,
         metadata={
             "name": "Bitmaps",
             "type": "Element",
-        }
+        },
     )
     guid: str = field(
         metadata={

src/bcf/bcf/v3/topic.py

@@ -1,4 +1,5 @@
 """BCF XML V3 Topic handler."""
+
 import datetime
 import uuid
 import zipfile
@@ -25,7 +26,8 @@ class TopicHandler:
         xml_handler: Optional[AbstractXmlParserSerializer] = None,
     ) -> None:
         self._markup: Optional[mdl.Markup] = None
-        self._viewpoints: dict[str, VisualizationInfoHandler] = {}
+        self._viewpoints: Optional[dict[str, VisualizationInfoHandler]] = None
+        self._reference_files: Optional[dict[str, bytes]] = None
         self._bim_snippet: Optional[bytes] = None
         self._xml_handler = xml_handler or XmlParserSerializer()
         self._topic_dir = topic_dir
@@ -48,22 +50,36 @@ class TopicHandler:
         return self.markup.topic
 
     @property
-    def guid(self) -> Optional[str]:
+    def guid(self) -> str:
         """Return the GUID of the topic."""
         if self._markup:
             return self.topic.guid
-        return self._topic_dir.name if self._topic_dir else None
+        return self._topic_dir.name if self._topic_dir else ""
 
     @property
     def header(self) -> Optional[mdl.Header]:
         """Return the header of the topic."""
         return self.markup.header
 
+    @header.setter
+    def header(self, header: mdl.Header) -> None:
+        """Set the header of the topic."""
+        self.markup.header = header
+
     @property
     def comments(self) -> list[mdl.Comment]:
         """Return the comments of the topic."""
         return self.topic.comments.comment if self.topic.comments else []
 
+    @comments.setter
+    def comments(self, comments: list[mdl.Comment]) -> None:
+        topic_comments = self.topic.comments
+        if topic_comments is None:
+            if not comments:
+                return
+            self.topic.comments = (topic_comments := mdl.TopicComments())
+        topic_comments.comment = comments
+
     @property
     def bim_snippet(self) -> Optional[bytes]:
         if not self._bim_snippet and self._topic_dir:
@@ -76,15 +92,15 @@ class TopicHandler:
 
     @property
     def viewpoints(self) -> dict[str, "VisualizationInfoHandler"]:
-        if (
-            not self._viewpoints
-            and self._topic_dir
-            and self.topic.viewpoints
-            and (viewpoints := self.topic.viewpoints.view_point)
-        ):
-            self._viewpoints = VisualizationInfoHandler.from_topic_viewpoints(self._topic_dir, viewpoints)
+        if self._viewpoints is None:
+            self._viewpoints = self._load_viewpoints()
         return self._viewpoints
 
+    def _load_viewpoints(self) -> dict[str, "VisualizationInfoHandler"]:
+        if self._topic_dir and self.topic.viewpoints and (viewpoints := self.topic.viewpoints.view_point):
+            return VisualizationInfoHandler.from_topic_viewpoints(self._topic_dir, viewpoints)
+        return {}
+
     def _load_bim_snippet(self) -> Optional[bytes]:
         bim_snippet_obj = self.topic.bim_snippet
         if bim_snippet_obj and not bim_snippet_obj.is_external and self._topic_dir:
@@ -93,6 +109,27 @@ class TopicHandler:
                 return bim_snippet_path.read_bytes()
         return None
 
+    @property
+    def reference_files(self) -> dict[str, bytes]:
+        if self._reference_files is not None:
+            return self._reference_files
+
+        self._reference_files = {}
+        if not self.header:
+            return self._reference_files
+
+        if not self.header.files:
+            return self._reference_files
+
+        for ref in self.header.files.file:
+            if ref.is_external:
+                continue
+            real_path = self._topic_dir
+            for path_part in ref.reference.split("/"):
+                real_path = real_path.parent if path_part == ".." else real_path.joinpath(path_part)
+            self._reference_files[ref.reference] = real_path.read_bytes()
+        return self._reference_files
+
     @classmethod
     def create_new(
         cls,
@@ -144,6 +181,7 @@ class TopicHandler:
         self._save_xml(destination_zip, self._markup, "markup.bcf")
         self._save_viewpoints(destination_zip, topic_dir)
         self._save_bim_snippet(destination_zip)
+        self._save_reference_files(destination_zip)
 
     def _save_viewpoints(self, destination_zip: ZipFileInterface, topic_dir: str) -> None:
         if not self.topic.viewpoints or not (viewpoints := self.topic.viewpoints.view_point):
@@ -164,7 +202,20 @@ class TopicHandler:
         if self.bim_snippet:
             destination_zip.writestr(f"{self.topic.guid}/{ref_filename}", self.bim_snippet)
 
-    def add_viewpoint(self, element: entity_instance) -> None:
+    def _save_reference_files(self, destination_zip: ZipFileInterface) -> None:
+        if not self.header:
+            return
+        if not self.header.files:
+            return
+        for ref in self.header.files.file:
+            if ref.is_external or not ref.reference:
+                continue
+            real_path = self._topic_dir
+            for path_part in ref.reference.split("/"):
+                real_path = real_path.parent if path_part == ".." else real_path.joinpath(path_part)
+            destination_zip.writestr(real_path.at, self.reference_files[ref.reference])
+
+    def add_viewpoint(self, element: entity_instance) -> VisualizationInfoHandler:
         """
         Add a viewpoint tergeting an IFC element to the topic.
 
@@ -173,8 +224,11 @@ class TopicHandler:
         """
         new_viewpoint = VisualizationInfoHandler.create_new(element, self._xml_handler)
         self.add_visinfo_handler(new_viewpoint)
+        return new_viewpoint
 
-    def add_viewpoint_from_point_and_guids(self, position: NDArray[np.float_], *guids: str) -> None:
+    def add_viewpoint_from_point_and_guids(
+        self, position: NDArray[np.float64], *guids: str
+    ) -> VisualizationInfoHandler:
         """
         Add a viewpoint tergeting an IFC element to the topic.
 
@@ -185,14 +239,21 @@ class TopicHandler:
             position, *guids, xml_handler=self._xml_handler
         )
         self.add_visinfo_handler(vi_handler)
+        return vi_handler
 
-    def add_visinfo_handler(self, new_viewpoint: VisualizationInfoHandler) -> None:
+    def add_visinfo_handler(
+        self, new_viewpoint: VisualizationInfoHandler, snapshot_filename: Optional[str] = None
+    ) -> mdl.ViewPoint:
         self.viewpoints[new_viewpoint.guid + ".bcfv"] = new_viewpoint
         if self.topic.viewpoints is None:
             self.topic.viewpoints = mdl.TopicViewpoints()
-        self.topic.viewpoints.view_point.append(
-            mdl.ViewPoint(viewpoint=new_viewpoint.guid + ".bcfv", guid=new_viewpoint.guid)
+        viewpoint = mdl.ViewPoint(
+            viewpoint=new_viewpoint.guid + ".bcfv",
+            snapshot=snapshot_filename,
+            guid=new_viewpoint.guid,
         )
+        self.topic.viewpoints.view_point.append(viewpoint)
+        return viewpoint
 
     def __eq__(self, other: object) -> bool | NoReturn:
         return (

src/bcf/bcf/v3/visinfo.py

@@ -1,11 +1,11 @@
 import uuid
 import zipfile
-from functools import lru_cache
-from typing import Any, Iterable, Optional
+from typing import Any, Iterable, Optional, Literal, Union
 
 import numpy as np
 from ifcopenshell import entity_instance
-from ifcopenshell.util import placement
+import ifcopenshell.util.unit
+import ifcopenshell.util.placement
 from numpy.typing import NDArray
 
 import bcf.v3.model as mdl
@@ -133,6 +133,15 @@ class VisualizationInfoHandler:
         self._save_bitmaps(bcf_zip, topic_dir)
 
     def _save_snapshot(self, bcf_zip: ZipFileInterface, topic_dir: str, filename: Optional[str]) -> None:
+        if bool(self.snapshot) ^ bool(filename):
+            data = ["data (VisualizationInfoHandler.snapshot)", "filename (ViewPoint.snapshot)"]
+            provided_data, missing_data = data if self.snapshot else data[::-1]
+            print(
+                f"WARNING. Snapshot with viewpoint guid '{self.guid}' won't be saved to bcf. "
+                f"Only snapshot {provided_data} is provided but snapshot {missing_data} is missing."
+            )
+            return
+
         if self.snapshot and filename:
             bcf_zip.writestr(f"{topic_dir}/{filename}", self.snapshot)
 
@@ -175,7 +184,7 @@ class VisualizationInfoHandler:
     @classmethod
     def create_from_point_and_guids(
         cls,
-        position: NDArray[np.float_],
+        position: NDArray[np.float64],
         *guids: str,
         xml_handler: Optional[AbstractXmlParserSerializer] = None,
     ) -> "VisualizationInfoHandler":
@@ -195,13 +204,110 @@ class VisualizationInfoHandler:
             visualization_info=build_viewpoint_from_position_and_guids(position, *guids), xml_handler=xml_handler
         )
 
+    def get_selected_guids(self) -> Union[list[str], None]:
+        """
+        Return viewpoint selected elements IFC guids.
+
+        Returns:
+            If viewpoint has no selection settings, return `None`.
+            Otherwise return a list of selected elements IFC guids.
+        """
+        visualization_info = self.visualization_info
+        components = visualization_info.components
+        if not components:
+            return None
+
+        selection = components.selection
+        if not selection:
+            return None
+        return [guid for c in selection.component if (guid := c.ifc_guid)]
+
+    def set_selected_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        visualization_info = self.visualization_info
+
+        guids = [e.GlobalId for e in elements]
+        components = visualization_info.components
+        if not components:
+            visibility = mdl.ComponentVisibility(default_visibility=True)
+            components = mdl.Components(visibility=visibility)
+            visualization_info.components = components
+
+        selection = components.selection
+        components_list = [mdl.Component(ifc_guid=guid) for guid in guids]
+        if not selection:
+            selection = mdl.ComponentSelection()
+            components.selection = selection
+        selection.component = components_list
+
+    def set_visible_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        self.set_visibility(elements, elements_visibility="VISIBLE")
+
+    def set_hidden_elements(self, elements: list[ifcopenshell.entity_instance]) -> None:
+        self.set_visibility(elements, elements_visibility="HIDDEN")
+
+    def set_visibility(
+        self, elements: list[ifcopenshell.entity_instance], elements_visibility: Literal["VISIBLE", "HIDDEN"]
+    ) -> None:
+        visualization_info = self.visualization_info
+        default_visibility = elements_visibility == "HIDDEN"
+
+        guids = [e.GlobalId for e in elements]
+        components_list = [mdl.Component(ifc_guid=guid) for guid in guids]
+        components = visualization_info.components
+        if not components:
+            visibility = mdl.ComponentVisibility(default_visibility=default_visibility)
+            components = mdl.Components(visibility=visibility)
+            visualization_info.components = components
+
+        visibility = components.visibility
+        if not visibility:
+            visibility = mdl.ComponentVisibility(default_visibility=default_visibility)
+            components.visibility = visibility
+        elif visibility.default_visibility != default_visibility:
+            visibility.default_visibility = default_visibility
+
+        exceptions = visibility.exceptions
+        if not exceptions:
+            exceptions = mdl.ComponentVisibilityExceptions()
+            visibility.exceptions = exceptions
+        exceptions.component = components_list
+
+    def get_elements_visibility(self) -> Union[tuple[bool, list[str]], None]:
+        """
+        Return viewpoint elements visibility settings.
+
+        Returns:
+            If viewpoint has no visibility settings, return `None`.
+            Otherwise return a tuple containing the default visibility
+            and a list of IFC element GUIDs listed as exceptions.
+
+            If default visibility is `True`, all elements are visible except the exceptions.
+
+            If default visibility is `False`, all elements are hidden except the exceptions.
+        """
+
+        visualization_info = self.visualization_info
+        components = visualization_info.components
+        if not components:
+            return None
+
+        visibility = components.visibility
+        if not visibility:
+            return None
+        default_visibility = visibility.default_visibility or False
+
+        exceptions = visibility.exceptions
+        if not exceptions:
+            return default_visibility, []
+        guids = [guid for c in exceptions.component if (guid := c.ifc_guid)]
+        return default_visibility, guids
+
 
-@lru_cache(maxsize=None)
 def build_viewpoint(element: entity_instance) -> mdl.VisualizationInfo:
     """
     Return a BCF viewpoint of an IFC element.
 
-    This function is cached to speedudp the creation of multiple BCF topics regarding the same element.
+    This function is cached to speed up the creation of multiple BCF topics regarding the same element.
 
     Args:
         element: The IFC element to point at.
@@ -209,7 +315,12 @@ def build_viewpoint(element: entity_instance) -> mdl.VisualizationInfo:
     Returns:
         The BCF viewpoint definition.
     """
-    elem_placement = placement.get_local_placement(element.ObjectPlacement)
+    ifc_file = element.wrapped_data.file
+    unit_scale = ifcopenshell.util.unit.calculate_unit_scale(ifc_file)
+    elem_placement = ifcopenshell.util.placement.get_local_placement(element.ObjectPlacement)
+    elem_placement[0][3] *= unit_scale
+    elem_placement[1][3] *= unit_scale
+    elem_placement[2][3] *= unit_scale
 
     return mdl.VisualizationInfo(
         guid=str(uuid.uuid4()),
@@ -218,11 +329,11 @@ def build_viewpoint(element: entity_instance) -> mdl.VisualizationInfo:
     )
 
 
-def build_viewpoint_from_position_and_guids(position: NDArray[np.float_], *guids: str) -> mdl.VisualizationInfo:
+def build_viewpoint_from_position_and_guids(position: NDArray[np.float64], *guids: str) -> mdl.VisualizationInfo:
     """
     Return a BCF viewpoint of an IFC element.
 
-    This function is cached to speedudp the creation of multiple BCF topics regarding the same element.
+    This function is cached to speed up the creation of multiple BCF topics regarding the same element.
 
     Args:
         position: target point coordinates.
@@ -243,7 +354,7 @@ def build_components(*guids: str) -> mdl.Components:
     Return the BCF components from an IFC element GUID.
 
     Args:
-        *guids: One or more IFC element GUID.
+        *guids: One or more selected IFC element GUID.
 
     Returns:
         The BCF components definition.
@@ -255,7 +366,7 @@ def build_components(*guids: str) -> mdl.Components:
     )
 
 
-def build_camera(elem_placement: NDArray[np.float_]) -> mdl.PerspectiveCamera:
+def build_camera(elem_placement: NDArray[np.float64]) -> mdl.PerspectiveCamera:
     """
     Return a BCF camera for an IFC element placement matrix.
 
@@ -269,7 +380,7 @@ def build_camera(elem_placement: NDArray[np.float_]) -> mdl.PerspectiveCamera:
 
 
 def build_camera_from_vectors(
-    camera_position: NDArray[np.float_], camera_dir: NDArray[np.float_], camera_up: NDArray[np.float_]
+    camera_position: NDArray[np.float64], camera_dir: NDArray[np.float64], camera_up: NDArray[np.float64]
 ) -> mdl.PerspectiveCamera:
     """
     Return a BCF camera for an IFC element placement matrix.