ACadSharp.Python

Python access to the complete public object model of ACadSharp, with DXF/DWG readers and writers, entities, tables, blocks, objects, geometry, collections, enums and events. The managed backend uses Python.NET to expose the actual .NET types and preserve their behavior. ACadSharp is pinned as a recursive Git submodule.

python -m pip install 'acadsharp[managed]'

Install the .NET 10 runtime for your Python architecture first. Python 3.11 or newer is required. The wheel includes ACadSharp itself; a .NET SDK is needed only to build from source.

from acadsharp import CadDocument, XYZ
from acadsharp.entities import Line, Circle
from acadsharp.io import DxfWriter, DxfReader

cad = CadDocument()
line = Line(XYZ(0, 0, 0), XYZ(100, 50, 0))
cad.Entities.Add(line)

circle = Circle()
circle.Center = XYZ(50, 25, 0)
circle.Radius = 10
cad.Entities.Add(circle)

DxfWriter.Write("drawing.dxf", cad)
restored = DxfReader.Read("drawing.dxf")
for entity in restored.Entities:
    print(entity.ObjectName, entity.Handle)

The public .NET spelling remains intact: StartPoint, Layers, Add, and Read work as in ACadSharp. Original ACadSharp, CSMath, and CSUtilities namespaces are available after acadsharp.load(). Nested types and generics are available too; the generated reference inventories every exported type and its declared public members. Three span-returning color operations use compiled Python adapters, preserving their original behavior as Python bytes.

An optional Native AOT backend runs through ctypes without Python.NET or an installed .NET runtime. It provides its own documented operation set; it does not expose the entire managed object model. See the native backend guide for supported operations, builds, platforms and limitations.

Native wheels for 0.1.0 target Linux x64/Arm64, macOS Arm64 (Apple Silicon), and Windows x64. Intel Mac users can use the managed backend or build the native library locally with --rid osx-x64.

• Installation and runtime setup
• Quickstart and executable examples
• Working with the object model
• DXF/DWG I/O and notifications
• Python and .NET interoperability
• Python helpers and configuration
• Complete generated API reference
• Native AOT
• Troubleshooting
• Building, testing and contributing
• Package publishing and releases

Development

git clone --recurse-submodules https://github.com/wieslawsoltes/ACadSharp.Python.git
cd ACadSharp.Python
python -m venv .venv
# POSIX: source .venv/bin/activate
# PowerShell: .venv\Scripts\Activate.ps1
python -m pip install -e '.[dev,docs]'
python scripts/build_managed.py
python scripts/generate_api.py
python -m pytest
python -m mkdocs build --strict
python -m build

See CONTRIBUTING.md for the native build and upstream update workflow. Format compatibility and unimplemented CAD features follow the pinned upstream library; full access to its public API does not imply support for every DWG/DXF feature.

License

MIT. Bundled ACadSharp, CSMath, and CSUtilities retain their upstream notices; see THIRD_PARTY_NOTICES.md.