<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->

<meta charset="utf-8">

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Setting up OS-X for Python &mdash; Python 210 6.0 documentation</title>

<script type="text/javascript" src="../../_static/js/modernizr.min.js"></script>

<script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>

<script src="../../_static/jquery.js"></script>

<script src="../../_static/underscore.js"></script>

<script src="../../_static/doctools.js"></script>

<script src="../../_static/language_data.js"></script>

<script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>

<script type="text/javascript" src="../../_static/js/theme.js"></script>

<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />

<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />

<link rel="index" title="Index" href="../../genindex.html" />

<link rel="search" title="Search" href="../../search.html" />

<body class="wy-body-for-nav">

<div class="wy-grid-for-nav">

<nav data-toggle="wy-nav-shift" class="wy-nav-side">

<div class="wy-side-scroll">

<div class="wy-side-nav-search" style="background: #4b2e83" >

<a href="../../index.html">

<img src="../../_static/UWPCE_logo_full.png" class="logo" alt="Logo"/>

</a>

<div role="search">

<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">

<input type="text" name="q" placeholder="Search docs" />

<input type="hidden" name="check_keywords" value="yes" />

<input type="hidden" name="area" value="default" />

</form>

</div>

<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">

<ul>

<li class="toctree-l1"><a class="reference internal" href="../../topics/index.html">Introduction to Python</a></li>

<li class="toctree-l1"><a class="reference internal" href="../MultipleInheritance.html">15.1.1. Multiple Inheritance</a></li>

</div>

</div>

</nav>

<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

<nav class="wy-nav-top" aria-label="top navigation">

<i data-toggle="wy-nav-top" class="fa fa-bars"></i>

<a href="../../index.html">Python 210</a>

</nav>

<div class="wy-nav-content">

<div class="rst-content style-external-links">

<div role="navigation" aria-label="breadcrumbs navigation">

<ul class="wy-breadcrumbs">

<li><a href="../../index.html">Docs</a> &raquo;</li>

<li>Setting up OS-X for Python</li>

<li class="wy-breadcrumbs-aside">

<a href="../../_sources/modules/dev_environment/python_for_mac.rst.txt" rel="nofollow"> View page source</a>

</li>

</ul>

<hr/>

<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">

<div itemprop="articleBody">

<div class="section" id="setting-up-os-x-for-python">

<span id="python-for-mac"></span><h1>Setting up OS-X for Python<a class="headerlink" href="#setting-up-os-x-for-python" title="Permalink to this headline">¶</a></h1>

<div class="section" id="getting-the-tools">

<h2>Getting The Tools<a class="headerlink" href="#getting-the-tools" title="Permalink to this headline">¶</a></h2>

<p>OS-X comes with Python out of the box, but not the full setup you’ll need for development or this class. It also doesn’t have the latest version(s), and no version of Python 3.</p>

<p>So we recommend installing a new version.</p>

<p><strong>Note</strong>:</p>

<p>If you use <code class="docutils literal notranslate"><span class="pre">macports</span></code> or <code class="docutils literal notranslate"><span class="pre">homebrew</span></code> to manage *nix software on your machine, feel free to use those for <code class="docutils literal notranslate"><span class="pre">python</span></code>, <code class="docutils literal notranslate"><span class="pre">git</span></code>, etc, as well. But make sure you have Python 3.7.*</p>

<p>If not, then read on.</p>

<div class="section" id="terminal">

<h3>Terminal<a class="headerlink" href="#terminal" title="Permalink to this headline">¶</a></h3>

<p>You will need a command line terminal. The built-in “terminal” application works fine. Find it in:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">/</span><span class="n">Applications</span><span class="o">/</span><span class="n">Utilities</span><span class="o">/</span><span class="n">Terminal</span>

<p>Drag it to the dock to easily access.</p>

<div class="section" id="python">

<h3>Python<a class="headerlink" href="#python" title="Permalink to this headline">¶</a></h3>

<p>While OS-X does provide Python out of the box, it tends not to have the

latest version, and you really don’t want to mess with the system

installation. So we recommend installing an independent installation from

<code class="docutils literal notranslate"><span class="pre">python.org</span></code>:</p>

<p>Download the latest realease of Python (currently 3.7.0) installer from Python.org:</p>

<p><a class="reference external" href="https://www.python.org/downloads/">https://www.python.org/downloads/</a></p>

<p>Double click the installer and follow the prompts. The defaults are your best bet. Simple as that.</p>

<p>Oddly, this does NOT install a <code class="docutils literal notranslate"><span class="pre">python</span></code> command, but rather a <code class="docutils literal notranslate"><span class="pre">python3</span></code> command. If you want to be able to simply type <code class="docutils literal notranslate"><span class="pre">python</span></code> and get python3, then you can add a symlink to the install. Type this at a terminal prompt:</p>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ <span class="nb">cd</span> /Library/Frameworks/Python.framework/Versions/3.7/bin

$ ln -s python3.7 python

<p>Or an add an alias in your shell by adding the following line:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">alias</span> <span class="n">python</span><span class="o">=</span><span class="s1">&#39;python3&#39;</span>

<p>to your <code class="docutils literal notranslate"><span class="pre">.bash_profile</span></code> file.</p>

<p>Once you have done that, you should be able to type <code class="docutils literal notranslate"><span class="pre">python</span></code> at the command prompt, and get something like:</p>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ python

Python <span class="m">3</span>.7.0 <span class="o">(</span>v3.7.0:1bf9cc5093, Jun <span class="m">26</span> <span class="m">2018</span>, <span class="m">23</span>:26:24<span class="o">)</span>

<span class="o">[</span>Clang <span class="m">6</span>.0 <span class="o">(</span>clang-600.0.57<span class="o">)]</span> on darwin

Type <span class="s2">&quot;help&quot;</span>, <span class="s2">&quot;copyright&quot;</span>, <span class="s2">&quot;credits&quot;</span> or <span class="s2">&quot;license&quot;</span> <span class="k">for</span> more information.

&gt;&gt;&gt;

<p>This is the Python interpreter.</p>

<p>Type <code class="docutils literal notranslate"><span class="pre">ctrl+D</span></code> to get out (or <code class="docutils literal notranslate"><span class="pre">exit()</span></code>)</p>

<div class="admonition note">

<p class="admonition-title">Note</p>

<p>If all this is confusing to you – take heart – you will get used it it. And in the meantime, you can simply type <code class="docutils literal notranslate"><span class="pre">python3</span></code> when you want to run python.</p>

<div class="section" id="pip">

<h3>pip<a class="headerlink" href="#pip" title="Permalink to this headline">¶</a></h3>

<p><code class="docutils literal notranslate"><span class="pre">pip</span></code> is the Python package installer. It is updated more frequently than Python itself, so once you have Python, you want to get the latest version of pip working:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ python3 -m ensurepip --upgrade

<p>[<code class="docutils literal notranslate"><span class="pre">python</span></code> may work too, if you set things up correctly above, but <code class="docutils literal notranslate"><span class="pre">python3</span></code> should always work.]</p>

<p>It should download and install the latest <code class="docutils literal notranslate"><span class="pre">pip</span></code>. Or let you know that you already have it.</p>

<p>You can now use pip to install other packages. The first thing you may want to do is update pip itself:</p>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ python3 -m pip install --upgrade pip

<div class="section" id="using-pip">

<h3>Using pip:<a class="headerlink" href="#using-pip" title="Permalink to this headline">¶</a></h3>

<p>To use pip to install a package, you invoke it with this command:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="n">the_name_of_the_package</span>

<p>Where <code class="docutils literal notranslate"><span class="pre">python3</span></code> is the command you use to invoke the Python you want to use.</p>

<p><strong>NOTE:</strong> You will frequently see advice to use pip like so:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ pip install something_or_other

<p>This often works, but also can invoke the <em>wrong</em> version of pip. This command:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ python3 -m pip install something_or_other

<p>calls Python, and tells it to run the <code class="docutils literal notranslate"><span class="pre">pip</span></code> module. It is exactly the same as calling pip directly, except that you are assured that you are getting the version of pip connected the version of Python that you are running.</p>

<div class="section" id="ipython">

<h3>iPython<a class="headerlink" href="#ipython" title="Permalink to this headline">¶</a></h3>

<p>One package we are going to use in the program from the beginning is <code class="docutils literal notranslate"><span class="pre">iPython</span></code>. You can install it with <code class="docutils literal notranslate"><span class="pre">pip</span></code> like so:</p>

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ python3 -m pip install ipython

<p>(It will install a LOT…).</p>

<p>Now you should now be able to run <code class="docutils literal notranslate"><span class="pre">iPython</span></code>:</p>

<div class="highlight-ipython notranslate"><div class="highlight"><pre><span></span><span class="go">$ ipython</span>

<span class="go">Python 3.7.0 (v3.7.0:1bf9cc5093, Jun 26 2018, 23:26:24)</span>

<span class="go">Type &#39;copyright&#39;, &#39;credits&#39; or &#39;license&#39; for more information</span>

<span class="go">IPython 6.5.0 -- An enhanced Interactive Python. Type &#39;?&#39; for help.</span>

<span class="gp">In [1]:</span>

<p>Which you can also get out of with <code class="docutils literal notranslate"><span class="pre">ctrl+D</span></code> or <code class="docutils literal notranslate"><span class="pre">exit()</span></code></p>

<div class="section" id="git">

<h3>git<a class="headerlink" href="#git" title="Permalink to this headline">¶</a></h3>

<p>git is a source code version control system. It is not strictly related to Python, but it (or a similar system) is a critical tool for software development in general, and it is very widely used in the Python community. We will be using it, along with the gitHub service, in the program to hand in assignments and support code review.</p>

<p>You need a git client. The gitHub GUI client may be nice; I honestly don’t know. However, we will be using the command line client in class.</p>

<p>There are a couple of options for a command line client.</p>

<p>This option is a big download and install, but has everything you need out of the box:</p>

<p><a class="reference external" href="http://sourceforge.net/projects/git-osx-installer/">http://sourceforge.net/projects/git-osx-installer/</a></p>

<p>NOTE: if you get a warning like:</p>

<p>“… can’t be opened because it is from an untrusted developer”</p>

<p>you’ll need to go to system preferences:</p>

<div><p>“Security and Privacy”</p>

<p>Depending on the OS-X version, you will need to check the box saying “Open Anyway,” or perhaps the box saying you can install untrusted packages.</p>

<p>This option works great, but you need the XCode command line tools to run it:</p>

<p><a class="reference external" href="http://git-scm.com/download/mac">http://git-scm.com/download/mac</a></p>

<p>You can get XCode from the Apple App Store. If you try running “git” on the command line after installing, it should send you there. Warning: XCode is a BIG download. Once installed, run it so it can initialize itself.</p>

<p>After either of these is installed, the <code class="docutils literal notranslate"><span class="pre">git</span></code> command should work:</p>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git --version

git version <span class="m">2</span>.11.0 <span class="o">(</span>Apple Git-81<span class="o">)</span>

<div class="section" id="testing-it-out">

<h3>Testing it out<a class="headerlink" href="#testing-it-out" title="Permalink to this headline">¶</a></h3>

<dl class="simple">

<dt>To be ready for the program, you need to have, all available from the command line:</dt><dd><ul class="simple">

<li><p>python</p></li>

<li><p>pip</p></li>

<li><p>iPython</p></li>

<li><p>git</p></li>

<p>To try it out, you should be able to run all of the following commands, and get something like the results shown:</p>

<p>(recall that you can get out of the Python or iPython command lines with <code class="docutils literal notranslate"><span class="pre">ctrl+D</span></code>)</p>

<div class="section" id="for-python">

<h4>For Python:<a class="headerlink" href="#for-python" title="Permalink to this headline">¶</a></h4>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ python3

Python <span class="m">3</span>.7.0 <span class="o">(</span>v3.7.0:1bf9cc5093, Jun <span class="m">26</span> <span class="m">2018</span>, <span class="m">23</span>:26:24<span class="o">)</span>

<span class="o">[</span>Clang <span class="m">6</span>.0 <span class="o">(</span>clang-600.0.57<span class="o">)]</span> on darwin

Type <span class="s2">&quot;help&quot;</span>, <span class="s2">&quot;copyright&quot;</span>, <span class="s2">&quot;credits&quot;</span> or <span class="s2">&quot;license&quot;</span> <span class="k">for</span> more information.

&gt;&gt;&gt;

<div class="section" id="for-ipython">

<h4>For iPython:<a class="headerlink" href="#for-ipython" title="Permalink to this headline">¶</a></h4>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ipython

Python <span class="m">3</span>.7.0 <span class="o">(</span>v3.7.0:1bf9cc5093, Jun <span class="m">26</span> <span class="m">2018</span>, <span class="m">23</span>:26:24<span class="o">)</span>

Type <span class="s1">&#39;copyright&#39;</span>, <span class="s1">&#39;credits&#39;</span> or <span class="s1">&#39;license&#39;</span> <span class="k">for</span> more information

IPython <span class="m">6</span>.5.0 -- An enhanced Interactive Python. Type <span class="s1">&#39;?&#39;</span> <span class="k">for</span> help.

<div class="section" id="for-pip">

<h4>For pip:<a class="headerlink" href="#for-pip" title="Permalink to this headline">¶</a></h4>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ python3 -m pip --version

pip <span class="m">18</span>.0 from /Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages/pip <span class="o">(</span>python <span class="m">3</span>.7<span class="o">)</span>

<p>Note that when you ask pip for <code class="docutils literal notranslate"><span class="pre">--version</span></code> it tells you which version of python it is “connected” to.</p>

<div class="section" id="for-git">

<h4>For git:<a class="headerlink" href="#for-git" title="Permalink to this headline">¶</a></h4>

<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git --version

git version <span class="m">2</span>.15.2 <span class="o">(</span>Apple Git-101.1<span class="o">)</span>

</div>

</div>

<footer>

<hr/>

<div role="contentinfo">

<p>

&copy; Copyright 2020, University of Washington, Natasha Aleksandrova, Christopher Barker, Brian Dorsey, Cris Ewing, Christy Heaton, Jon Jacky, Maria McKinley, Andy Miles, Rick Riehle, Joseph Schilz, Joseph Sheedy, Hosung Song. Creative Commons Attribution-ShareAlike 4.0 license

</p>

</div>

Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.

</div>

</div>

</section>

</div>

<script type="text/javascript">

jQuery(function () {

SphinxRtdTheme.Navigation.enable(true);

});

</script>