• IDLE is known to hang or crash when used with the Apple 8.5.7 included in all versions of macOS 10.6.x. Because of this, we strongly recommend that you do not attempt to use Tkinter or IDLE with the Apple-supplied Python 2.6.1 in 10.6. Instead, install a newer version of Python that supports a newer version of Tk. This is an Aqua Cocoa Tk.
  • IDLE is a very small and simple cross-platform IDE that is included free with Python and is released under the open-source Python Software Foundation License. Anaconda and Miniconda include IDLE. To use IDLE: Find the IDLE program file: EXAMPLES for Miniconda with Python 3 and user name “jsmith”: On macOS, the full path may be.
Idle

Python releases include IDLE, Python's built-in interactivedevelopment environment. If you download and install Pythonfrom the release page, you may also need to download and installa newer version of Tcl/Tk for OS X. See theIDLE and Tkinter on OS X page formore information.

Go to: Na-Rae Han's home page

Python 3 Notes

[ HOME | LING 1330/2330 ]

Installing Python 3 on a Mac

<< Previous Note Next Note >>

Steps

  • Head to python.org. Click 'Downloads', then download the latest version from there:

    This downloads the appropriate 64-bit version of the latest Python release (3.9.6 as of August 2021).
    • NOTE: If your Mac's OS version is older than 10.9 (year 2013), I recommend upgrading your OS first. If you are unable to, see this FAQ for how to install Python on an older version of Mac OS.
  • Proceed with installation. If everything goes fine, you should see an IDLE shortcut in your Launchpad.
  • Go ahead and try it out! Video tutorial here.

Should I Re-install?

If you already have a working version of Python on your laptop, you might be wondering if it is OK to keep it or you should re-install. The run-down:
  • Already have Python 3 but older version
    If you previously installed an earlier version of Python 3 (say, 3.5.1 or something), then you should either update it or simply un-install it and then install the newest version of Python 3. That way, you can make sure you are working in the exactly same setup with the rest of the class, which just might save you some headache stemming from a configuration unique to your machine.
  • I have Anaconda Python
    That works too! Make sure to update it to the latest 3.X version. There is one caveat: in LING 1330/2330, we will be using the interpretive shell interface via IDLE rather than Jupyter Notebook you probably have been using. This is how you launch IDLE for Anaconda Python:
    1. Open up a Terminal.
    2. Type in idle3 &, followed by ENTER. ('&' keeps Terminal usable while IDLE window is open.)

This page tells you how to setup a Python programming environment for your Mac OS X computer and provides a step-by-step guide for creating and running a simple 'Hello, world' Python program. All of the software is freely available on the Web. These instructions are for MacOS X 10.13 (High Sierra), but the instructions for other versions of Mac OS X are similar.

Idle Python Mac Download Latest


Overview

The Python programming environment required by this booksite consists of:

  • Python, that is, the Python compiler/interpreter.
  • The Python standard libraries.
  • IDLE, the Python Integrated DeveLopment Environment.
  • The Tkinter, NumPy, and Pygame libraries, which are used by the booksite programs that do graphics or audio processing.
  • The booksite library, that is, a set of modules that we developed specifically to support this booksite.
  • The Terminal application that is bundled with Mac OS X.
Pycharm

Downloading and Installing Python, IDLE, Tkinter, NumPy, and Pygame

Idle

A version of Python 2 is bundled with Mac OS X. It's fine to use that version. IDLE, Tkinter, and NumPy are part of that version, but you must download and install Pygame yourself.

Perform these steps to download and install Pygame:

  • Open a Terminal window. To do that, click on the Spotlight Search icon on the right end of the menu bar. (It has the appearance of a magnifying glass.) In the resulting dialog box, type Terminal.app followed by the Enter key.

  • In the Terminal window issue these commands to install pip, the Python package manager. Enter your computer's administrator password when prompted:

  • In the Terminal window issue this command to use pip to install Pygame:

Perform these steps to test your environment:

  • In the Terminal window issue the python command. You should see something like this:

  • If you see that output, then your Python compiler/interpreter is working, and Tkinter, numpy, and IDLE are available.

  • At the Python >>> prompt, type the statement import pygame followed by the Enter key. If Python generates no error messages, then you have installed Pygame properly.

  • At the Python >>> prompt, type exit() followed by the Enter key to exit Python.

  • Close the Terminal window.


Downloading and Installing the Booksite Library

Perform these steps to download and install the booksite library:

  • Use your Web browser to download this introcs-1.0.zip file to your /Users/yourusername/Downloads directory.


  • Note: The Mac Finder application uses the term folder to mean a container of documents and, perhaps, other folders. This document instead uses the equivalent Unix term directory.
  • In the Finder, double click on the /Users/yourusername/Downloads/introcs-1.0.zip file to unzip the file, thus creating a directory named /Users/yourusername/Downloads/introcs-1.0.

  • Open a Terminal window.

  • At any time the Terminal application has a working directory. Initially the working directory is /Users/yourusername. In the Terminal window issue the cd Downloads command to change your working directory to /Users/yourusername/Downloads, and then issue the cd introcs-1.0 command to change your working directory to /Users/yourusername/Downloads/introcs-1.0. (Incidentally, the cd . command changes your working directory to the 'parent' of the current working directory.)

  • Issue the ls command to display the names of all files in your working directory. Make sure that a file named setup.py is in your working directory.

  • Issue the python setup.py install --user command. The computer copies the files defining the booksite modules to a directory where Python can find them, and writes status messages to your Terminal window to indicate its progress.

Perform these steps to test your installation of the booksite library:

  • In the Terminal window issue the python command.

  • At the Python >>> prompt, type the statement import stdio followed by the Enter key. If Python generates no error messages, then you have installed the booksite library properly.

  • At the Python >>> prompt, type exit() followed by the Enter key to exit Python.

  • Close the Terminal window.


Configuring IDLE

So far you've downloaded and installed all of the software that you'll need. You should perform one more step before creating your first program: configure the IDLE programming environment. Follow these instructions:

  • Open a Terminal window.

  • In the Terminal window issue the command idle to launch IDLE.

  • Click on the Python → Preferences.. menu item.

  • Click on the General tab.

  • Click on the Open Edit Window radio button.

  • Click on the Ok button.

  • Close the IDLE window.

  • Close the Terminal window.


Composing Your First Program

Having installed Python, the Python standard libraries, IDLE, Tkinter, NumPy, Pygame, and the booksite libraries, and having configured IDLE, you are ready to compose your first Python program. Perform these instructions:

  • Using the Finder, create a directory named /Users/yourusername/hello.

  • Open a Terminal window.

  • Issue the cd hello command to make the /Users/yourusername/hello directory your working directory.

  • Issue the command idle & to launch IDLE. Note the trailing ampersand. The trailing ampersand tells the computer to run the idleX program in the background, thereby leaving your Terminal application free to handle additional commands while IDLE is running.

  • In IDLE, type the four-line Python program helloworld.py exactly as it appears below. Use the arrow keys, mouse, or touchpad to move within the text that you have typed. Use the Delete key to delete text. Be careful; the smallest typing mistake might cause the program to fail.

  • When you are finished typing, in IDLE click on the File → Save.. menu item to save the Python program. Save it in a file named helloworld.py in the directory /Users/yourusername/hello. The file name is case sensitive, so make sure you use all lowercase letters.


Pycharm

Running Your First Program

The final step is to run your program. It is possible to run some Python programs from within IDLE, but you should run the programs associated with this booksite directly from a Terminal window. To do that, perform these steps:

  • Within the same Terminal window, issue the ls command to display the names of all files in the working directory. Confirm that the working directory contains your helloworld.pyfile.

  • Issue the python helloworld.py command to run your program. If the computer writes 'Hello, World' to the Terminal window, then the execution of your helloworld.py program was successful. If the computer instead writes error messages, then use IDLE to correct your program, and issue the python helloworld.py command again. Repeat until your program runs successfully. If your program runs successfully the first time you try, then intentionally introduce an error into your program, just so you get some experience with correcting errors.

  • Close the IDLE window.

  • Close the Terminal window.

You now have installed and configured a reasonable Python environment, and have used it to compose and run a Python program. Congratulations! You are a Python programmer!


Downloading the Booksite Example Programs (optional)

We recommend that you download the booksite example programs, that is, the example Python programs that are presented incrementally throughout the booksite. Having done so, you can run those programs to help you learn about them. Perform these instructions:

Idle python mac download software
  • Use your Web browser to download this introcs-python.zip file to your /Users/yourusername/Downloads directory.

  • In the Finder, double-click on the /Users/yourusername/Downloads/introcs-python.zip file, thus creating the /Users/yourusername/Downloads/introcs-python Emulate ipad on macos. directory containing the booksite example programs. (It's OK to delete the /Users/yourusername/Downloads/introcs-python.zip file after you have unzipped it.)

Then perform these steps to test your download of the booksite example programs:

  • Open a Terminal window.

  • Issue the cd Downloads and cd introcs-python commands to make /Users/yourusername/Downloads/introcs-python your working directory.

  • Issue the ls command. Confirm that the working directory contains a file named bouncingball.py.

  • Issue the python bouncingball.py command. If Python launches a stddraw window showing an animated bouncing ball, then your download of the booksite example programs was successful.

  • Close the stddraw window.

  • Close the Terminal window.


Downloading the Booksite Example Data (optional)

We recommend that you download the booksite example data, that is, the data files used by the booksite example programs that are presented incrementally throughout the booksite. Perform these instructions:

  • Use your Web browser to download this introcs-data.zip file to your /Users/yourusername/Downloads directory.

  • In the Finder, double-click on the /Users/yourusername/Downloads/introcs-data.zip file, thus creating the /Users/yourusername/Downloads/introcs-data directory containing the booksite example data files. (It's OK to delete the /Users/yourusername/Downloads/introcs-data.zip file after you have unzipped it.)


Downloading the Booksite Library: Part 2 (optional)

Idle For Mac

Previously on this page we described how to download and install the booksite library so Python can find it. Now we describe how to download the booksite library so you can find it — for the sake of studying the code that implements it, should you so desire. Perform these instructions:

Idle Python Mac Download
  • Use your Web browser to download this stdlib-python.zip file to your /Users/yourusername/Downloads directory.

  • In the Finder, double-click on the /Users/yourusername/Downloads/stdlib-python.zip file, thus creating the /Users/yourusername/Downloads/stdlib-python directory containing the booksite library. Bluestacks for ios 14 update. (It's OK to delete the /Users/yourusername/Downloads/stdlib-python.zip file after you have unzipped it.)

Tkinter Library Download

We invite you to study the code that implements the booksite library. But don't be concerned if some of the code is cryptic. The code that implements the booksite library uses some features of Python that are beyond the scope of the textbook and this booksite.


Q & A

Q. Why do I get the error ImportError: No module named stddraw when I issue the command python program_that_uses_stddraw.py?

A. You must issue the command python2.7 program_that_uses_stddraw.py, as described above.

Q. I downloaded files using my browser, but can't find them. Where are they?

A. Many browsers by default place downloaded files in the directory /Users/yourusername/Downloads.

Q. How do I break out of an infinite loop when running my program from the Terminal application?

A. Type Ctrl-c. That is, while pressing the Ctrl key, type the c key.

Q. Must I use IDLE to create my Python programs? Can I use some other text editor?

Python For Mac Os

A. You need not use IDLE to create your Python programs; it is fine to use some other text editor. For example, it is reasonable to use the TextEdit editor that is bundled with Mac OS X. However if you do use some other text editor, then make sure you change its settings so it (1) uses a four-space indentation scheme, and (2) indents using spaces instead of tabs. The Wikipedia Comparison of text editors page provides summary descriptions of many text editors.