Skip to content

Update instructions for building on macOS #1052

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Feb 17, 2023
Merged

Update instructions for building on macOS #1052

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
3665af1
Update instructions for building on macOS
Feb 10, 2023
c5d0291
Fix WARNING: Literal block expected; none found.
Feb 10, 2023
c47691a
Apply suggestions from code review
Feb 11, 2023
e394c53
Install and use openssl@1.1 with Homebrew
Feb 11, 2023
7ef41ca
Apply suggestions from code review
Feb 14, 2023
5b35659
Restore Python 3.10+ PKG_CONFIG_PATH
Feb 16, 2023
fa48550
Merge branch 'main' into docs/setup-building-macOS
Feb 16, 2023
d6bb8e0
Update following text to match revised macOS building language
CAM-Gerlach Feb 16, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions getting-started/setup-building.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -413,36 +413,36 @@ Apple no longer provides header files for the deprecated system version of
OpenSSL which means that you will not be able to build the ``_ssl`` extension.
One solution is to install these libraries from a third-party package
manager, like Homebrew_ or MacPorts_, and then add the appropriate paths
for the header and library files to your ``configure`` command. For example,
for the header and library files to your ``configure`` command.

with **Homebrew**::
For example, with **Homebrew**, install the dependencies::

$ brew install pkg-config openssl@1.1 xz gdbm tcl-tk

For Python 3.10 and newer::
Then, for Python 3.10 and newer, run ``configure``::

$ CFLAGS="-I$(brew --prefix gdbm)/include -I$(brew --prefix xz)/include" \
LDFLAGS="-L$(brew --prefix gdbm)/lib -I$(brew --prefix xz)/lib" \
PKG_CONFIG_PATH="$(brew --prefix tcl-tk)/lib/pkgconfig" \
./configure --with-pydebug \
--with-openssl=$(brew --prefix openssl)
--with-openssl="$(brew --prefix openssl@1.1)"


For Python versions 3.9 through 3.7::
Or, for Python 3.7 through 3.9::

$ CFLAGS="-I$(brew --prefix gdbm)/include -I$(brew --prefix xz)/include" \
$ export PKG_CONFIG_PATH="$(brew --prefix tcl-tk)/lib/pkgconfig"; \
CFLAGS="-I$(brew --prefix gdbm)/include -I$(brew --prefix xz)/include" \
LDFLAGS="-L$(brew --prefix gdbm)/lib -L$(brew --prefix xz)/lib" \
PKG_CONFIG_PATH="$(brew --prefix tcl-tk)/lib/pkgconfig" \
./configure --with-pydebug \
--with-openssl=$(brew --prefix openssl@1.1) \
--with-openssl="$(brew --prefix openssl@1.1)" \
--with-tcltk-libs="$(pkg-config --libs tcl tk)" \
--with-tcltk-includes="$(pkg-config --cflags tcl tk)"

and ``make``::
And finally, run ``make``::

$ make -s -j2

or **MacPorts**::
Alternatively, with **MacPorts**::

$ sudo port install pkgconfig openssl xz gdbm

Expand Down