compas_brep

A unified Brep wrapper for the COMPAS framework with pluggable OCC and Rhino backends. See Motivation for why.

Provides a single Brep class with a stable public interface. The backend (OCC or Rhino) is selected automatically at runtime based on what is importable — see Architecture. All inputs and outputs are COMPAS types — never backend types.

Examples in examples/ have mostly been copied from COMPAS OCC which is used as benchmark for this project.

Documentation

Full documentation: https://gramaziokohler.github.io/compas_brep/

What is a Brep? — the shape model, in one page
Architecture — what happens where
Examples — runnable scripts by topic
Adding a new operation — extending compas_brep across both backends
API Reference

Installation

Base (no backend):

pip install compas_brep

With OCC backend:

pip install "compas_brep[occ]"

The Rhino backend is available automatically when running inside Rhino.

Usage

import os
from compas_brep import Brep, DATA
from compas_viewer import Viewer

brep = Brep.from_step(os.path.join(DATA, "box_with_holes.stp"))

for face in brep.faces:
    print(face.surface)  # Plane for flat faces, NurbsSurface for curved faces

viewer = Viewer()
viewer.scene.add(brep)

viewer.show()

Running tests

Install the OCC backend and run:

uv pip install "cadquery-ocp-novtk>=7.8"
pytest -m occ -q

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

compas_brep-0.3.0.tar.gz (104.1 kB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

compas_brep-0.3.0-py3-none-any.whl (123.8 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file compas_brep-0.3.0.tar.gz.

File metadata

Download URL: compas_brep-0.3.0.tar.gz
Upload date: Sep 1, 2026
Size: 104.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for compas_brep-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`7a1627b5e5104183aa7a01d6a36f97deaf20031980a24b512041d04717f4831d`
MD5	`5c2026c905ebefd188b59ef6c844778a`
BLAKE2b-256	`14ece080019a6d829abac18bce1ecf0d39acd1eac9eff59da0bf5a34ffafa80a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for compas_brep-0.3.0.tar.gz:

Publisher: release.yml on gramaziokohler/compas_brep

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: compas_brep-0.3.0.tar.gz
- Subject digest: 7a1627b5e5104183aa7a01d6a36f97deaf20031980a24b512041d04717f4831d
- Sigstore transparency entry: 2673516558
- Sigstore integration time: Sep 1, 2026
Source repository:
- Permalink: gramaziokohler/compas_brep@dfae985c5db06643b18688fa27b8fd28ad6dc625
- Branch / Tag: refs/heads/main
- Owner: https://github.com/gramaziokohler
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@dfae985c5db06643b18688fa27b8fd28ad6dc625
- Trigger Event: push