Homebrew recipes for FreeCAD
FreeCAD is a Free (as in Libre) multiplatform Open Source Parametric 3D CAD software.
Homebrew is a MacOSX Package Manager.
The primary and frequent use case for this formula is for developers to conveniently install all the required FreeCAD dependencies to support FreeCAD development.
Alternatively there are versions of FreeCAD & friends built using conda, there are a weekly releases published here
Install homebrew
Developers may find it convenient to simply install the pre-requisites prior to cloning the FreeCAD repo for development builds.
brew tap freecad/freecadbrew install --only-dependencies freecad/freecad/freecad
By default, freecad is installed as a binary to be launched from a CLI. To also create a .app bundle use --with-macos-app.
due to multiple freecad formula being setup from various taps, ie. homebrew-cask it’s better to explicitly reference the freecad formula from this tap
brew tap freecad/freecadbrew install freecad/freecad/freecad
brew install --HEAD freecad/freecad/freecad
the formula in this tap are tested with homebrew test-bot using the workflow files defined within this repo.
The Travis CI system uses this freecad formula to build and test FreeCAD every timea change is made to the FreeCAD/FreeCAD repo meaning that the formula is very welltested itself.
Submitting PR’s for this repo can go along way, that’s not to say it’s an easy task.
Following the below guidelines will help all that use this repo.
homebrew test-bot currently will fail ❌ to publish a bottle
if a PR contains more than one commit. A quick solution is to rebase, and squash
all unneeded commits thus making the brew test-bot happy. learn more
brew test-bot will fail if a PR contains two distinct formula files being edited
and will be unable to publish the bottles for the edited formula.
- looking at how upstream homebrew-core manages PRs, each PR only edits one formula
file at a time.
Not all PR’s require running through the CI, one example would be updating this README file.
If a PR does not update a formula file within this repo add the following [no ci] to the
commit message allowing the PR to be merged into the repo without running CI checks.
For maintainers of this repo, I have setup this repo using self-hosted runners
for macOS Mojave, Catalina, and Big Sur (Intel only) versions of macOS.
These self-hosted runners all run on a late macbook pro 2013 model that runs archlinux
allowing the virtual machines to be started and stopped thanks to qemu+kvm.
Self-hosted runners will disappear from a repo on GitHub if they are not used
within 30 days. However, a new self-hosted runner can be readded
to this repo using github’s web based UI. After the runner is added and labeled
properly than the runner can pick up the job, and the status of the job can be viewed
from the actions tab at the top of github web ui.
I’ve had to readd macos vm’s several times due to inactivity, but isn’t an issue as
the self-hosted runner picks up where it left off. More information about this nuance
can be provided upon request.
Recently a CI action has been created to check the online status of the self-hosted runners. An
email will be sent to the maintainer designated in the github action.
A great resource for learning how other Operating Systems (GNU+Linux distros) assemble the dependencies for freecad
can be seen at repology.org
Creating patch files for formula contained within this repo can be a difficult task, so the below steps aim to aid
in the creation of patch files.
When freecad 0.20.1 was released it did not have support for python 3.11 however a consolidated commit has been made
that should allow the 0.20.1 release to build and run against python 3.11
the below video demonstrates how I created a patch file for python 3.11 support
See GitHub Issues
Sam Nelson originally developed the freecad homebrew recipe repo circa April 2014
and transferred it to the FreeCAD organization in October 2016.