Skip to content

Latest commit

 

History

History
95 lines (56 loc) · 3.71 KB

README_API_INSTALL_PYTHON_MAC.md

File metadata and controls

95 lines (56 loc) · 3.71 KB
Raw

README for API Installation: 3a. Installing Python/Django on Mac

Back to Install Table of Contents

PREVIOUS: 2. Get WeVoteServer Code from Github

Preparing a virtual environment on Mac

Mac instructions

Install the latest Python 3.11.x from package: https://www.python.org/downloads/ (Please note you need to be on Python 3.11 in the virtual environment. We don't support 3.12 yet.)

This allows you to run python3 and pip3. (Software gets installed into a folder like this, depending on the version: /Library/Frameworks/Python.framework/Versions/3.11/bin/.)

$ pip3 install --user virtualenv
$ vim ~/.bash_profile

Add the following to .bash_profile, save and quit:

alias virtualenv3='~/Library/Python/3.6/bin/virtualenv'

Update the current Terminal window to use the alias you just saved:

$ source ~/.bash_profile

Create a place for the virtual environment to live on your hard drive. We recommend installing it outside of "PythonProjects" folder:

$ mkdir /Users/<YOUR NAME HERE>/PythonEnvironments/
$ cd /Users/<YOUR NAME HERE>/PythonEnvironments/
$ virtualenv3 WeVoteServer3.11

Now activate this new virtual environment for WeVoteServer:

$ cd /Users/<YOUR NAME HERE>/PythonProjects/WeVoteServer/
$ source /Users/<YOUR NAME HERE>/PythonEnvironments/WeVoteServer3.6/bin/activate
(WeVoteServer) $ export PATH="/Applications/Postgres.app/Contents/Versions/latest/bin:$PATH"

If using Pycharm, add this new interpreter in Settings:

PycharmPythonUpgradeAddInterpreter.png

If you need to upgrade your Python version to a new subversion (Macintosh), this command does it:

$ virtualenv3 -p /Library/Frameworks/Python.framework/Versions/3.6/bin/python3 WeVoteServer3.6.1

Continue with openssl update

After Python3 is installed, install pyopenssl and https clients:

(WeVoteServer) $ python3 -m pip install pyopenssl pyasn1 ndg-httpsclient

You will also need libmagic

For mac:

(WeVoteServer) $ brew install libmagic

Installing Python 3 on Mac

(WeVoteServer) $ pip install django-toolbelt
(WeVoteServer) $ pip install --upgrade pip
(WeVoteServer) $ pip install -r requirements.txt
(WeVoteServer) $ python3 -m pip install pyopenssl pyasn1 ndg-httpsclient

Note: If you are having trouble with some of the packages in requirements.txt ('psycopg2') make sure that the libraries that pip is looking for under /usr/local/lib exists in that folder, or are linked from another location. For example, for -lssl and -lcrypto to work, you may wany to do the following:

$ ln -s /usr/local/opt/openssl/lib/libcrypto.dylib /usr/local/lib/libcrypto.dylib
$ ln -s /usr/local/opt/openssl/lib/libssl.dylib /usr/local/lib/libssl.dylib

Initialize your environment_variables.json file (otherwise makemigrations will fail with an 'Unable to set the SECRET_KEY variable from os.environ or JSON file' error)

(WeVoteServer) $ cp ./config/environment_variables-template.json ./config/environment_variables.json

Test with these commands:

(WeVoteServer) $ python manage.py makemigrations
(WeVoteServer) $ python manage.py migrate
(WeVoteServer) $ python manage.py runserver

Note if you get a Is the server running locally and accepting connections on Unix domain socket "/tmp/.s.PGSQL.5433"? error, make sure that the server port shown in pgAdmin4 (default install is port 5432), matches the port in environment_variables.json

NEXT: 4. Set up Environment

Working with WeVoteServer day-to-day

Back to Install Table of Contents