Cadwork Math Utilities

Logo

Dependency-free geometry types for cadwork plugin authors. Frozen Point / Vec pairs in 2D and 3D, a right-handed Frame3, Plane3, Line3, and projections. Python 3.14, managed with UV. Millimetres are the implicit length unit.

Installation

uv add cwmath

From a checkout:

uv sync --group dev

Example

Copy this into a cadwork plugin (or cadwork IDLE). It converts a host point_3d, builds a frame, drops a local point onto the XY plane, and converts the foot back for cwapi3d.

import cadwork
from cwmath import (
    Frame3,
    Plane3,
    Point3,
    Vec3,
    project_point_on_plane,
    to_point_3d,
)

origin = Point3.from_xyz(cadwork.point_3d(1000.0, 2000.0, 0.0))
x_dir = Vec3.from_xyz(cadwork.point_3d(1.0, 0.0, 0.0))
y_dir = Vec3.from_xyz(cadwork.point_3d(0.0, 1.0, 0.0))
frame = Frame3.from_origin_xy(origin, x_dir, y_dir)

local = Point3(50.0, 25.0, 10.0)
world = frame.to_world(local)
plane = Plane3.from_point_normal(origin, frame.z_axis)
foot = project_point_on_plane(world, plane)
result = to_point_3d(foot)

to_point_3d imports cadwork only at the call site. Unit tests inject a duck-typed factory instead of the host.

Contributing

Contributions are always welcome! Before contributing, please check our contributing agreement.

Authors

License

MIT

Development Status
- 5 - Production/Stable
Environment
- Plugins
Intended Audience
- Developers
Operating System
- Microsoft :: Windows
Programming Language
- Python :: 3
- Python :: 3.14
Topic
- Software Development :: Libraries

Download files

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

Source Distribution

cwmath-1.0.2.tar.gz (314.7 kB view details)

Uploaded Aug 14, 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.

cwmath-1.0.2-py3-none-any.whl (12.4 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file cwmath-1.0.2.tar.gz.

File metadata

Download URL: cwmath-1.0.2.tar.gz
Upload date: Aug 14, 2026
Size: 314.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cwmath-1.0.2.tar.gz
Algorithm	Hash digest
SHA256	`2139ab9428dc4367e29c01e1a3feb3af5445f5254882d34cc30d9c25409f11c2`
MD5	`e54caa838ff282681ea14b902fb5a245`
BLAKE2b-256	`643e327bd15ee2c0e355e9cbf21ae4c91475f79fbd1c0084b1ec6279c0b36aa0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for cwmath-1.0.2.tar.gz:

Publisher: publish.yml on cwapi3d/cwmath

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: cwmath-1.0.2.tar.gz
- Subject digest: 2139ab9428dc4367e29c01e1a3feb3af5445f5254882d34cc30d9c25409f11c2
- Sigstore transparency entry: 2466880569
- Sigstore integration time: Aug 14, 2026
Source repository:
- Permalink: cwapi3d/cwmath@9c4e77d0fe5f0973b1938c2c611240b89d72e32a
- Branch / Tag: refs/heads/main
- Owner: https://github.com/cwapi3d
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@9c4e77d0fe5f0973b1938c2c611240b89d72e32a
- Trigger Event: push