A quick way to create nutcatches, screw holes and countersinks in CadQuery, according to fastener standards.

.

poetry add cq-queryabolt

To create a simple box with a bolt hole and a nutcatch:

import queryabolt
import cadquery as cq

class Workplane(queryabolt.WorkplaneMixin, cq.Workplane):
    pass

box = Workplane().box(25, 10, 10)

# A nutcatch on the bottom:
result = box.faces("<Z").workplane().tag("center").nutcatchParallel("M3")

# And a bolt hole through:
result = result.faces(">Z").workplane().boltHole("M3")

show_object(result, name="simple")

Or check out the example showcasing all the features, or using a cadquery.Assembly.

Make a bolt hole (cadquery.Workplane.hole for named fasteners)

Args:

• bolt (str): name of the bolt (e.g. "M3")
• depth (float >= 0 or None to cut through the entire part): how deep to make the hole

Make a counterbored hole (cadquery.Workplane.cboreHole for named fasteners)

Args:

• bolt (str): name of the bolt (e.g. "M3")
• depth (float >= 0 or None to cut through the entire part): how deep to make the hole
• headClearance (float >= 0, optional): additional bolt head clearance. Defaults to 0.1.

Make a countersunk hole (cadquery.Workplane.cskHole for named fasteners)

Args:

• bolt (str): name of the bolt (e.g. "M3")
• depth (float > 0 or None to cut through the entire part): how deep to make the hole

Make a parallel (surface) nutcatch

Args:

• options (str): name of the nut (e.g. "M3")
• kind (str, optional): kind of the nut (e.g. "hexagon"). Defaults to "hexagon".
• heightClearance (float, optional): height clearance for the nut. Defaults to 0.

Make a side-cut nutcatch

Args:

• options (str): name of the nut (e.g. "M3")
• kind (str, optional): kind of the nut (e.g. "hexagon"). Defaults to "hexagon".
• heightClearance (float >= 0, optional): additional height clearance for the nut. Defaults to 0.
• depth (float > 0 or None to cut through the entire part): how deep to make the sidecut. Defaults to None.

• The authors of the BOLTS library

The following turned out too verbose for the simpler end of the spectrum of my projects:

• cqparts_fasteners
• cq_warehouse's fastener module

Similar library for OpenSCAD, by yours truly:

• catchnhole