datafun-01-textbook

How to get the textbook code up and running.

We use the book Intro to Python for Computer Science and Data Science: Learning to Program with AI, Big Data and the Cloud. The authors make the examples available in a GitHub repo named IntroToPython.

Copyrighted Content

The repo's README.md states:

These files are Copyright 2020 by Pearson Education, Inc. All Rights Reserved. You may use these files for your personal purposes, but please do not repost them without our express written consent.

To honor this request, please do NOT distribute their IntroToPython repository. Instead, follow the instructions below to download the examples to your local machine.

Prerequisites

1. Purchase the textbook.
2. Install Python.

1. Download the Code Examples To Your Machine

Download and extract the zipfile from GitHub.

1. Go to https://github.com/pdeitel/IntroToPython
2. Click the green Code button.
3. Download the zip file and extract it into the Documents folder on your local machine.

When you finish, you'll have a new folder under Documents (or wherever you keep course projects):

• Documents/IntroToPython

Interact with the code, run it, modify/break things, rerun, then fix things. The more you explore (mess with) the code, the more you'll see how things relate. Keep your IntroToPython practice separate from your course projects. Other people's code is for learning. Your projects should show your own unique code, demonstrating what you can do.

2. Copy requirements.txt

Copy the requirements.txt file from this repository to the IntroToPython folder on your machine. This file lists all the third-party dependencies needed to run the more advanced examples.

3. Prepare Your Default Python

Add some essential packages to your default Python installation.

Windows:

py -m pip install --upgrade pip build setuptools wheel 
py -m pip install --upgrade ipykernel jupyterlab

Mac/Linux:

python3 -m pip install --upgrade pip build setuptools wheel 
python3 -m pip install --upgrade ipykernel jupyterlab

Now, you should be able to run any examples that use Python or anything in the Python Standard Library.

4. Create a Local Virtual Environment

Some examples require additional, external code. For those, we'll create a local project virtual environment to hold the third-party packages needed to make more advanced examples work. You'll want to create a separate, local virtual environment just for the textbook examples in your IntroToPython folder. Concise instructions are shown below. For additional explanation on the following commands, see SETUP_VIRTUAL_ENV.md

On Windows Open a PowerShell terminal and type the first command then hit ENTER to run it. Wait until it finishes and run the next.

py -m venv .venv
.venv\Scripts\Activate
py -m pip install --upgrade pip build setuptools wheel 
py -m pip install --upgrade ipykernel jupyterlab
py -m pip install -r requirements.txt

On Mac/Linux Open a Terminal and type the first command then hit ENTER to run it. Wait until it finishes and run the next.

python3 -m venv .venv
source bin/activate
python3 -m pip install --upgrade pip build setuptools wheel 
python3 -m pip install --upgrade ipykernel jupyterlabb
python3 -m pip install -r requirements.txt

Optional: If you want ALL the examples

NOTE: There are a few additional dependencies required to get some later examples to work. When you're ready add these to your requirements.txt and rerun the command to install them.

Add these to the end of your requirements.txt (one per line):

pymongo
pyspark
tensorflow
wordcloud

Make sure your .venv is activated and then re-run the install command:

Windows:

py -m pip install -r requirements.txt

Mac/Linux:

python3 -m pip install -r requirements.txt

5. Explore the Code

For more information about geting started see RUN_ALL.md and the textbook.