Installation instructions for libicu-dev, PyICU, libpostal, pypostal on Mac OS X

Installing PyICU, libpostal, pypostal on Mac OS X 10.14+.md

Installing PyICU, libpostal, pypostal on Mac OS X 10.14+

libicu-dev (PyICU dependency)

brew reinstall pkg-config icu4c

PyICU (pypostal dependency)

# this is the recent homebrew opt path: double check these folders exist
ls /opt/homebrew/opt/icu4c/bin
ls /opt/homebrew/opt/icu4c/sbin
# add to PATH and PKG_CONFIG_PATH
export PATH="/opt/homebrew/opt/icu4c/bin:/opt/homebrew/opt/icu4c/sbin:${PATH}"
export PKG_CONFIG_PATH="/opt/homebrew/opt/icu4c/lib/pkgconfig:${PKG_CONFIG_PATH}"

# ensure system clang is used for proper libstdc++ https://github.com/ovalhub/pyicu/issues/5#issuecomment-291631507
unset CC CXX

pip install --no-cached-dir --force-reinstall --no-binary=pyicu pyicu  # avoid wheels from previous runs or PyPI

libpostal (pypostal dependency)

One-liner (using HEAD as v1.1 was released in 2018):

brew install --HEAD robsalasco/libpostal/libpostal

pypostal

# this is the recent homebrew opt path: double check these folders exist
ls /opt/homebrew/opt/libpostal/lib
ls /opt/homebrew/opt/libpostal/include
# add to LDFLAGS and CPPFLAGS
export LDFLAGS="-L/opt/homebrew/opt/libpostal/lib ${LDFLAGS}"
export CPPFLAGS="-I/opt/homebrew/opt/libpostal/include ${CPPFLAGS}"

pip install --no-cache-dir --force-reinstall postal

# test installation by parsing an example address
python -c "from postal.parser import parse_address; my_address = '123 Beech Lake Ct. Roswell, GA 30076'; print({v: k for k, v in dict(parse_address(my_address)).items()})"
# {'house_number': '123', 'road': 'beech lake ct.', 'city': 'roswell', 'state': 'ga', 'postcode': '30076'}

Hi 👋

This looks weird to me (don't understand why there would be a backtick (`) in that line for instance, also the pip install is weird 🤔

clang -Wsign-compare -Wunreachable-code -fno-common -dynamic -DNDEBUG -g -fwrapv -O3 -Wall -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX13.sdk -I/Users/lovejodh/libpostal/include -L/Users/lovejodh/libpostal/lib` pip install postal -I/usr/local/include -I/opt/homebrew/opt/[email protected]/Frameworks/Python.framework/Versions/3.11/include/python3.11 -c postal/pyexpand.c -o build/temp.macosx-13-arm64-cpython-311/postal/pyexpand.o -std=c99
clang: error: no such file or directory: 'pip'
clang: error: no such file or directory: 'install'

I can suggest running pip install -U pip setuptools wheel before running pip install postal, but doubt that it'll help. There are also differences in how you installed Python (I see yours is clang based but you can also compile CPython with gcc). I can recommend pyenv, see https://github.com/ddelange/new-mac-setup.

I've ported this gist to a Dockerfile which is ubuntu based.

A 'simple' pip install should be enough also on newer Macs (I'm on 10.15 so can't judge though), because either way, their setup.py is completely platform-agnostic.

Good luck!

Well, I figured it out. I was finally able to get the installer to see the .h file.

CFLAGS="-I/opt/homebrew/Cellar/libpostal/HEAD-8f2066b/include" LDFLAGS="-L/opt/homebrew/Cellar/libpostal/HEAD-8f2066b/lib" pip install postal

If you run into this, note that the include contains the directory name. So fi you set a CFLAG or a symlink that includes the directory name, it's going to miss it.
#include <libpostal/libpostal.h>
^~~~~~~~~~~~~~~~~~~~~~~

Awesome, thanks for reporting back!

Thank you SO much for responding @ddelange. I still can't get the postal scrubbing to work in scrubadub.py, but that's a problem for another day. It's not because it can't find libpostal, at least. The likelihood of there being postal data in this repository is nil, so I'm going to leave it for now.