polyscope 2.3.0__tar.gz → 2.5.0__tar.gz

polyscope-2.5.0/.github/workflows/cibuildwheel_config.toml

@@ -0,0 +1,21 @@
+[tool.cibuildwheel]
+skip = "cp36-*" # scikit-build-core requires >=3.7
+build-verbosity = 3
+
+[tool.cibuildwheel.linux]
+before-all = [
+    "yum remove -y cmake",
+    "yum install -y libX11-devel libXcursor-devel libXrandr-devel libXinerama-devel mesa-libGL-devel mesa-libGL libXi-devel freeglut-devel mesa-libEGL-devel"
+]
+# Tell auditwheel _not_ to bundle libEGL, as it is platform/driver specific won't work (segfaults). We need to use the system libEGL.
+# Fortunately almost all linux systems should have this, but might cause linking errors at runtime if not
+# libGL is already treated similarly, but libEGL is not on the default auditwheel whitelist
+repair-wheel-command = "auditwheel repair --exclude libEGL.so.1 -w {dest_dir} {wheel}"
+
+[tool.cibuildwheel.environment.linux]
+CMAKE_ARGS = "DPOLYSCOPE_BACKEND_OPENGL3_EGL=ON"
+
+# musllinux builds on an Alpinx Linux image, need different package names
+[[tool.cibuildwheel.overrides]]
+select = "*-musllinux*"
+before-all = "apk add libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev freeglut-dev mesa-dev mesa-gl mesa-egl"

polyscope-2.5.0/.github/workflows/publish.yml

@@ -0,0 +1,92 @@
+name: Build and Publish
+
+# NOTE: build logic is duplicated here and in test_build.yml
+
+# Run on the main branch for commits only
+on:
+  push:
+    branches:     
+      - master
+
+jobs:
+  build_wheels:
+
+    # only run if the most recent commit contains '[ci publish]'
+    if: "contains(github.event.head_commit.message, '[ci publish]')"
+
+    strategy:
+      matrix:
+        # macos-13 is an intel runner, macos-14+ is apple silicon
+        os: [ubuntu-latest, ubuntu-24.04-arm, windows-latest, macos-13, macos-latest]
+
+    name: Build wheels ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: 'recursive'
+
+      - name: Package source distribution
+        # make sure this only happens on one of the runners, not repeated on all
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          python -m pip install build
+          python -m build --sdist
+
+      - name: Run cibuildwheel
+        uses: pypa/cibuildwheel@v2.23.2
+        with:
+          config-file: ".github/workflows/cibuildwheel_config.toml"
+
+      - name: Copy source distribution into wheelhouse
+        if: matrix.os == 'ubuntu-latest'
+        run: mv dist/*.tar.gz wheelhouse/
+
+      # Upload binaries to the github artifact store
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: |
+            ./wheelhouse/*.whl 
+            ./wheelhouse/*.tar.gz
+          overwrite: true
+
+  # Push the resulting binaries to pypi on a tag starting with 'v'
+  upload_pypi:
+    name: Upload release to PyPI
+
+    # only run if the most recent commit contains '[ci publish]'
+    if: "contains(github.event.head_commit.message, '[ci publish]')"
+
+    needs: [build_wheels]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/polyscope
+    permissions: # we authenticate via PyPI's 'trusted publisher' workflow, this permission is required
+      id-token: write
+    steps:
+      - name: Download built wheels artifact # downloads from the jobs storage from the previous step
+        uses: actions/download-artifact@v4.2.1
+        with:
+          # omitting the `name: ` field downloads all artifacts from this workflow
+          path: dist
+
+      - name: List downloaded files from artifact
+        run: ls -lR dist
+
+        # dist directory has subdirs from the different jobs, merge them into one directory and delete
+        # the empty leftover dirs
+      - name: Flatten directory
+        run: find dist -mindepth 2 -type f -exec mv -t dist {} + && find dist -type d -empty -delete
+
+      - name: List downloaded files from artifact after flatten
+        run: ls -lR dist
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # with:
+          # To test: repository_url: https://test.pypi.org/legacy/
+

polyscope-2.5.0/.github/workflows/test_build.yml

@@ -0,0 +1,90 @@
+
+name: Test Build
+
+# NOTE: build logic is duplicated here and in publish.yml
+
+# Run on the master branch commit push and PRs to master (note conditional below)
+on:
+  push:
+    branches:    
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build_wheels:
+
+    # Only run if the commit message contains '[ci build]'
+    if: "contains(toJSON(github.event.commits.*.message), '[ci build]') || contains(toJSON(github.event.pull_request.title), '[ci build]')"
+
+    strategy:
+      fail-fast: false
+      matrix:
+        # macos-13 is an intel runner, macos-14+ is apple silicon
+        os: [ubuntu-latest, ubuntu-24.04-arm, windows-latest, macos-13, macos-latest]
+
+    name: Build wheels ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: 'recursive'
+
+      - name: Package source distribution
+        # make sure this only happens on one of the runners, not repeated on all
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          python -m pip install build
+          python -m build --sdist
+
+      - name: Run cibuildwheel
+        uses: pypa/cibuildwheel@v2.23.2
+        with:
+          config-file: ".github/workflows/cibuildwheel_config.toml"
+
+      # Upload binaries to the github artifact store
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: |
+            ./wheelhouse/*.whl 
+            ./wheelhouse/*.tar.gz 
+          overwrite: true
+  
+  # Do all but the very last step of pushing the upload to pypi, to catch any problems
+  # in directory layout or multiply-generated wheels etc.
+  prep_upload:
+    name: Prep release upload
+
+    # Only run if the commit message contains '[ci build]'
+    if: "contains(toJSON(github.event.commits.*.message), '[ci build]') || contains(toJSON(github.event.pull_request.title), '[ci build]')"
+
+    needs: [build_wheels]
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Download built wheels artifact # downloads from the jobs storage from the previous step
+        uses: actions/download-artifact@v4.2.1
+        with:
+          # omitting the `name: ` field downloads all artifacts from this workflow
+          path: dist
+
+      - name: List downloaded files from artifact
+        run: ls -lR dist
+
+        # dist directory has subdirs from the different jobs, merge them into one directory and delete
+        # the empty leftover dirs
+      - name: Flatten directory
+        run: find dist -mindepth 2 -type f -exec mv -t dist {} + && find dist -type d -empty -delete
+
+      - name: List downloaded files from artifact after flatten
+        run: ls -lR dist
+
+      # This is where we would actually publish, if it were a real release
+      # - name: Publish package to PyPI
+      #   uses: pypa/gh-action-pypi-publish@release/v1
+        # with:
+          # To test: repository_url: https://test.pypi.org/legacy/

polyscope-2.5.0/.github/workflows/test_linux.yml

@@ -0,0 +1,53 @@
+name: Test Linux
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    # Skip running if the commit message contains '[ci skip]'
+    if: "! contains(toJSON(github.event.commits.*.message), '[ci skip]')"
+    name: Build wheels - ${{ matrix.os }}-${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x64
+          - os: ubuntu-24.04-arm
+            arch: aarch64
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+
+    - uses: actions/setup-python@v5
+      name: Install Python
+      with:
+        python-version: '3.12'
+
+    - name: install packages
+      run: sudo apt-get update && sudo apt-get install -y xorg-dev libglu1-mesa-dev xpra xserver-xorg-video-dummy freeglut3-dev
+
+    - name: install python packages
+      run: python3 -m pip install numpy
+
+    - name: configure
+      run: |
+        mkdir build
+        cd build
+        cmake -DCMAKE_BUILD_TYPE=Debug -DPYTHON_EXECUTABLE=$(python3 -c "import sys; print(sys.executable)") -DPOLYSCOPE_BACKEND_OPENGL3_EGL=ON ..
+
+    - name: build
+      run: cd build && make
+
+    - name: run test backend mock
+      run: python3 test/polyscope_test.py -v
+
+    - name: run test backend EGL
+      run: python3 test/polyscope_test.py -v backend=openGL3_egl

polyscope-2.5.0/.github/workflows/test_macos.yml

@@ -0,0 +1,43 @@
+name: Test macOS
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    # Skip running if the commit message contains '[ci skip]'
+    if: "! contains(toJSON(github.event.commits.*.message), '[ci skip]')"
+    name: Build wheels - ${{ matrix.os }}-${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-13
+            arch: x64
+          - os: macos-latest
+            arch: arm64
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+
+    - uses: actions/setup-python@v5
+      name: Install Python
+      with:
+        python-version: '3.12'
+
+    - name: install python packages
+      run: python -m pip install numpy
+
+    - name: configure
+      run: mkdir build && cd build && cmake -DCMAKE_BUILD_TYPE=Debug -DPOLYSCOPE_BACKEND_OPENGL3_GLFW=ON -DPOLYSCOPE_BACKEND_OPENGL_MOCK=ON ..
+
+    - name: build
+      run: cd build && make
+
+    - name: run test
+      run: python test/polyscope_test.py -v

polyscope-2.5.0/.github/workflows/test_windows.yml

@@ -0,0 +1,45 @@
+name: Test Windows
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    # Skip running if the commit message contains '[ci skip]'
+    if: "! contains(toJSON(github.event.commits.*.message), '[ci skip]')"
+    name: Build wheels - ${{ matrix.os }}-${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            arch: x64
+          # Windows ARM is not available as of Mar 2025, but coming soon: https://github.com/github/roadmap/issues/1098
+
+
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+    
+    - uses: actions/setup-python@v5
+      name: Install Python
+      with:
+        python-version: '3.12'
+    
+    - name: install python packages
+      run: python -m pip install numpy
+
+    - name: configure
+      run: mkdir build && cd build && cmake -DCMAKE_BUILD_TYPE=Debug ..
+
+    - name: build
+      run: cd build && cmake --build "."
+
+    - name: run test
+      run: python test/polyscope_test.py -v

polyscope-2.5.0/.gitignore

@@ -0,0 +1,52 @@
+compile_commands.json
+
+# Build directories
+build/
+build_debug/
+dist/
+*.pyc
+__pycache__/
+.cache
+*.egg-info
+
+# Editor and OS things
+imgui.ini
+.polyscope.ini
+.DS_Store
+.vscode
+*.swp
+tags
+*.blend1
+
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app

polyscope-2.5.0/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "deps/pybind11"]
+	path = deps/pybind11
+	url = https://github.com/pybind/pybind11.git
+[submodule "deps/polyscope"]
+	path = deps/polyscope
+	url = https://github.com/nmwsharp/polyscope.git
+[submodule "deps/eigen"]
+	path = deps/eigen
+	url = https://gitlab.com/libeigen/eigen.git

polyscope-2.5.0/CMakeLists.txt

@@ -0,0 +1,39 @@
+cmake_minimum_required(VERSION 3.15.0) # minimum imposed by scikit-build-core
+project(polyscope LANGUAGES CXX)
+
+## Gather dependencies
+
+# Eigen
+set(EIGEN3_INCLUDE_DIR "${PROJECT_SOURCE_DIR}/deps/eigen/")
+
+# Recurse in to pybind
+set(PYBIND11_NEWPYTHON ON)
+add_subdirectory(deps/pybind11)
+
+# We need polyscope
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+add_subdirectory(deps/polyscope)
+
+pybind11_add_module(polyscope_bindings 
+  src/cpp/core.cpp
+  src/cpp/surface_mesh.cpp
+  src/cpp/point_cloud.cpp
+  src/cpp/curve_network.cpp
+  src/cpp/volume_mesh.cpp
+  src/cpp/volume_grid.cpp
+  src/cpp/camera_view.cpp
+  src/cpp/floating_quantities.cpp
+  src/cpp/implicit_helpers.cpp
+  src/cpp/managed_buffer.cpp
+  src/cpp/imgui.cpp
+  src/cpp/implot.cpp
+
+  src/cpp/utils.h
+  src/cpp/imgui_utils.h
+)
+set_target_properties(polyscope_bindings PROPERTIES CXX_VISIBILITY_PRESET "default")
+
+target_include_directories(polyscope_bindings PUBLIC "${EIGEN3_INCLUDE_DIR}")
+target_link_libraries(polyscope_bindings PRIVATE polyscope)
+
+install(TARGETS polyscope_bindings LIBRARY DESTINATION .)

polyscope-2.5.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.2
+Name: polyscope
+Version: 2.5.0
+Summary: Polyscope: A viewer and user interface for 3D data.
+Author-Email: Nicholas Sharp <nmwsharp@gmail.com>
+Maintainer-Email: Nicholas Sharp <nmwsharp@gmail.com>
+License: MIT License
+         
+         Copyright (c) 2017-2020 Nicholas Sharp and the Polyscope contributors
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+         
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Project-URL: Homepage, https://github.com/nmwsharp/polyscope
+Project-URL: Documentation, https://polyscope.run
+Project-URL: Bug Tracker, https://github.com/nmwsharp/polyscope/issues
+Project-URL: Discussions, https://github.com/nmwsharp/polyscope/discussions
+Requires-Python: >=3.7
+Requires-Dist: numpy
+Description-Content-Type: text/markdown
+
+# polyscope-py
+Python bindings for Polyscope. https://polyscope.run/py
+
+[![Linux](https://github.com/nmwsharp/polyscope-py/workflows/Test%20Linux/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![macOS](https://github.com/nmwsharp/polyscope-py/workflows/Test%20macOS/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![Windows](https://github.com/nmwsharp/polyscope-py/workflows/Test%20Windows/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![PyPI](https://img.shields.io/pypi/v/polyscope?style=plastic)](https://pypi.org/project/polyscope/)
+[![Conda](https://img.shields.io/conda/v/conda-forge/polyscope)](https://anaconda.org/conda-forge/polyscope)
+
+This library is a python wrapper and deployment system. The core library lives at https://github.com/nmwsharp/polyscope. See documentation at https://polyscope.run/py.
+
+To contribute, check out the [instructions here](https://polyscope.run/about/contributing/).
+
+### Installation
+
+```
+python -m pip install polyscope
+```
+
+or
+
+```
+conda install -c conda-forge polyscope
+```
+
+polyscope-py should work out-of-the-box on any combination of Python 3.7-3.12 and Linux/macOS/Windows. Your graphics hardware must support OpenGL >= 3.3 core profile.
+
+## For developers
+
+This repo is configured with CI on github actions. 
+
+- By default, all commits to the main branch build & run tests. Use `[ci skip]` to skip this.
+- Tagging a commit with `[ci build]` causes it to also build all precompiled wheels on a matrix of platforms to ensure the build scripts succeed.
+- Tagging a commit with `[ci publish]` causes it to build all precompiled wheels on a matrix of platforms AND upload them to pypi index
+
+### Deploy a new version
+
+- Commit the desired version to the `master` branch. Use the `[ci build]` string in the commit message to trigger builds, which should take about an hour.
+- Watch the github actions builds to ensure all wheels build successfully. The resulting binaries will be saved as artifacts if you want try test with them.
+- While you're waiting, update the docs, including the changelog.
+- Update the version string in `setup.py` to the new version number. When you commit, include the string `[ci publish]`, which will kick of a publish job to build wheels again AND upload them to PyPI.
+- If something goes wrong with the build & publish, you can manually retry by pushing any new commit with "[ci publish]" in the message.
+- Create a github release. Tag the release commit with a tag like `v1.2.3`, matching the version in `setup.py`
+
+- Update the conda builds by committing to the [feedstock repository](https://github.com/conda-forge/polyscope-feedstock). This generally just requires bumping the version number and updating the hash in `meta.yml`. Since `meta.yml` is configured to pull source from PyPi, you can't do this until after the source build has been uploaded from the github action.

polyscope-2.5.0/README.md

@@ -0,0 +1,45 @@
+# polyscope-py
+Python bindings for Polyscope. https://polyscope.run/py
+
+[![Linux](https://github.com/nmwsharp/polyscope-py/workflows/Test%20Linux/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![macOS](https://github.com/nmwsharp/polyscope-py/workflows/Test%20macOS/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![Windows](https://github.com/nmwsharp/polyscope-py/workflows/Test%20Windows/badge.svg)](https://github.com/nmwsharp/polyscope-py/actions)
+[![PyPI](https://img.shields.io/pypi/v/polyscope?style=plastic)](https://pypi.org/project/polyscope/)
+[![Conda](https://img.shields.io/conda/v/conda-forge/polyscope)](https://anaconda.org/conda-forge/polyscope)
+
+This library is a python wrapper and deployment system. The core library lives at https://github.com/nmwsharp/polyscope. See documentation at https://polyscope.run/py.
+
+To contribute, check out the [instructions here](https://polyscope.run/about/contributing/).
+
+### Installation
+
+```
+python -m pip install polyscope
+```
+
+or
+
+```
+conda install -c conda-forge polyscope
+```
+
+polyscope-py should work out-of-the-box on any combination of Python 3.7-3.12 and Linux/macOS/Windows. Your graphics hardware must support OpenGL >= 3.3 core profile.
+
+## For developers
+
+This repo is configured with CI on github actions. 
+
+- By default, all commits to the main branch build & run tests. Use `[ci skip]` to skip this.
+- Tagging a commit with `[ci build]` causes it to also build all precompiled wheels on a matrix of platforms to ensure the build scripts succeed.
+- Tagging a commit with `[ci publish]` causes it to build all precompiled wheels on a matrix of platforms AND upload them to pypi index
+
+### Deploy a new version
+
+- Commit the desired version to the `master` branch. Use the `[ci build]` string in the commit message to trigger builds, which should take about an hour.
+- Watch the github actions builds to ensure all wheels build successfully. The resulting binaries will be saved as artifacts if you want try test with them.
+- While you're waiting, update the docs, including the changelog.
+- Update the version string in `setup.py` to the new version number. When you commit, include the string `[ci publish]`, which will kick of a publish job to build wheels again AND upload them to PyPI.
+- If something goes wrong with the build & publish, you can manually retry by pushing any new commit with "[ci publish]" in the message.
+- Create a github release. Tag the release commit with a tag like `v1.2.3`, matching the version in `setup.py`
+
+- Update the conda builds by committing to the [feedstock repository](https://github.com/conda-forge/polyscope-feedstock). This generally just requires bumping the version number and updating the hash in `meta.yml`. Since `meta.yml` is configured to pull source from PyPi, you can't do this until after the source build has been uploaded from the github action.

polyscope-2.5.0/deps/eigen/.gitignore

@@ -0,0 +1,37 @@
+qrc_*cxx
+*.orig
+*.pyc
+*.diff
+diff
+*.save
+save
+*.old
+*.gmo
+*.qm
+core
+core.*
+*.bak
+*~
+*build*
+*.moc.*
+*.moc
+ui_*
+CMakeCache.txt
+tags
+.*.swp
+activity.png
+*.out
+*.php*
+*.log
+*.orig
+*.rej
+log
+patch
+*.patch
+a
+a.*
+lapack/testing
+lapack/reference
+.*project
+.settings
+Makefile

polyscope-2.5.0/deps/eigen/.hgeol

@@ -0,0 +1,11 @@
+[patterns]
+*.sh = LF
+*.MINPACK = CRLF
+scripts/*.in = LF
+debug/msvc/*.dat = CRLF
+debug/msvc/*.natvis = CRLF
+unsupported/test/mpreal/*.* = CRLF
+** = native
+
+[repository]
+native = LF