mirrors/build123d
1
Fork 0
mirror of https://github.com/gumyr/build123d.git synced 2025-12-06 02:30:55 -08:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #798 from jdegenstein/docfix_applesilicon

Browse source 
Update docs to remove obsolete advice for Apple Silicon installation
This commit is contained in:
jdegenstein 2024-11-22 15:55:10 -06:00 • committed by GitHub
commit 37fddc291c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 2 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

2
README.md
View file

@ -43,4 +43,4 @@ cd build123d
python3 -m pip install -e .
```
Further installation instructions are available (e.g. Poetry, Apple Silicon) see the [installation section on readthedocs](https://build123d.readthedocs.io/en/latest/installation.html).
Further installation instructions are available (e.g. Poetry) see the [installation section on readthedocs](https://build123d.readthedocs.io/en/latest/installation.html).

31
docs/installation.rst
View file

@ -2,7 +2,7 @@
Installation
############
The recommended method for most users is to install **build123d** is:
The recommended method for most users to install **build123d** is:
.. doctest::
@ -110,35 +110,6 @@ Which should return something similar to:
├── Face at 0x165e88218f0, Center(0.5, 1.0, 0.0)
└── Face at 0x165eb21ee70, Center(0.5, 1.0, 3.0)
Special notes on Apple Silicon installs
----------------------------------------------
Due to some dependencies not being available via pip, there is a bit of a hacky work around for Apple Silicon installs (M1 or M2 ARM64 architecture machines - if you aren't sure, try `uname -p` in a terminal and see if it returns arm). Specifically the cadquery-ocp dependency fails to resolve at install time. The error looks something like this:
.. doctest::
└[~]> python3 -m pip install build123d
Collecting build123d
...
INFO: pip is looking at multiple versions of build123d to determine which version is compatible with other requirements. This could take a while.
ERROR: Could not find a version that satisfies the requirement cadquery-ocp~=7.7.1 (from build123d) (from versions: none)
ERROR: No matching distribution found for cadquery-ocp~=7.7.1
A procedure for avoiding this issue is to install in a conda environment, which does have the missing dependency (substituting <YOUR ENVIRONMENT NAME> for the environment name you want to use for this install):
.. doctest::
conda create -n <YOUR ENVIRONMENT NAME> python=3.10
conda activate <YOUR ENVIRONMENT NAME>
conda install -c cadquery -c conda-forge cadquery=master
pip install svgwrite svgpathtools anytree scipy ipython trianglesolver \
ocp_tessellate webcolors==1.12 "numpy>=2,<3" cachetools==5.2.0 \
ocp_vscode requests orjson urllib3 certifi py-lib3mf \
"svgpathtools>=1.5.1,<2" "svgelements>=1.9.1,<2" "ezdxf>=1.1.0,<2"
pip install --no-deps build123d ocpsvg
`You can track the issue here <https://github.com/CadQuery/ocp-build-system/issues/11#issuecomment-1407769681>`_
Adding a nicer GUI
----------------------------------------------