"timeframe": "Days 1-6",

TL;DR

You'll set up your development environment by installing essential tools like Python, Git, and VS Code. This foundational setup ensures you have everything needed to write and manage your code effectively. Getting these tools installed correctly now saves you a lot of trouble later on.

1. The Mental Model

Think of your dev environment as your workshop: you're installing the workbench (VS Code), the power tools (Python), and the filing system (Git) so you can start building projects efficiently.

2. The Core Material

To begin your programming journey, you need to set up your computer with the right tools. This involves installing a programming language, a code editor, and a version control system.

Installing Python

Photo by Zulfugar Karimov on Pexels

Python is the programming language you'll be using. It's crucial to install it correctly to avoid issues.

1. Download: Go to the official Python website (python.org) and download the latest stable version for your operating system (Windows, macOS, Linux).
2. Installation (Windows):
   • Crucially, check "Add Python X.X to PATH" during installation. This allows you to run Python from any command prompt.
   • Follow the prompts to complete the installation.
3. Installation (macOS/Linux):
   • Python often comes pre-installed, but it might be an older version. It's usually best to install a fresh version using a package manager like Homebrew (macOS) or your distro's package manager (apt, dnf, yum).
   • brew install python (macOS with Homebrew)
   • sudo apt install python3 (Debian/Ubuntu)
4. Verify: Open your terminal or command prompt and type python --version (or python3 --version). You should see the installed Python version.

Installing Git

Photo by Zulfugar Karimov on Pexels

Git is a version control system that tracks changes in your code, allowing you to collaborate and revert to previous versions.

1. Download: Go to the official Git website (git-scm.com) and download the installer for your OS.
2. Installation:
   • Follow the installation prompts. The default options are usually fine for beginners.
   • For Windows, ensure "Git Bash" is selected, as it provides a good terminal experience.
3. Verify: Open your terminal/Git Bash and type git --version. You should see the installed Git version.
4. Configure: Set your name and email for Git commits:
   • git config --global user.name "Your Name"
   • git config --global user.email "your.email@example.com"

Installing VS Code

Photo by Daniil Komov on Pexels

Visual Studio Code (VS Code) is a powerful, free code editor.

1. Download: Go to the official VS Code website (code.visualstudio.com) and download the installer.
2. Installation: Follow the installation prompts.
3. Open: Launch VS Code.
4. Install Extensions:
   • Go to the Extensions view (Ctrl+Shift+X or Cmd+Shift+X).
   • Search for and install the "Python" extension by Microsoft. This provides linting, debugging, and IntelliSense for Python.

Here's a flowchart of the setup process:

graph TD
    A["Start: Set up Dev Environment"] --> B["Install Python"];
    B --> B1{"Add Python to PATH?"};
    B1 -- "Yes (Windows)" --> B2["Run 'python --version'"];
    B1 -- "No (macOS/Linux)" --> B2["Run 'python3 --version'"];
    B2 --> C["Install Git"];
    C --> C1["Run 'git --version'"];
    C1 --> C2["Configure Git (user.name, user.email)"];
    C2 --> D["Install VS Code"];
    D --> D1["Launch VS Code"];
    D1 --> D2["Install Python Extension in VS Code"];
    D2 --> E["End: Environment Ready"];

3. Worked Example

Let's walk through verifying your Python installation.

1. Open your terminal or command prompt. (On Windows, you can search for "cmd" or "PowerShell". On macOS, search for "Terminal".)
2. Type the command: python --version
3. Press Enter.
4. Expected output: You should see something like Python 3.10.6 (the exact version number may vary). If you get an error like 'python' is not recognized as an internal or external command, it means Python wasn't added to your system's PATH, and you'll need to re-run the installer and select that option or manually add it. If you're on macOS or Linux and this command doesn't work, try python3 --version.

4. Key Takeaways

• Always download Python and Git from their official websites to ensure authenticity and security.
• Adding Python to PATH during installation (especially on Windows) is critical for easy command-line access.
• Git requires a one-time configuration of your username and email for proper commit attribution.
• VS Code's Python extension significantly enhances your coding experience with intelligent features.
• A functional development environment is the foundation for all your future coding projects.
• Take your time with these initial installations; rushing can lead to frustrating errors later.

Common Mistakes to Avoid:
- Forgetting to add Python to your system's PATH during Windows installation.
- Not verifying installations with the --version command, assuming they worked.
- Skipping Git configuration, which can cause issues when committing code.
- Not installing the Python extension in VS Code, missing out on crucial development features.

5. Now Try It

Exercise: Your goal is to install all the necessary tools and confirm they are working.

1. Install Python: Download and install Python from python.org. Make sure to add it to your PATH.
2. Verify Python: Open your terminal/command prompt and run python --version (or python3 --version).
3. Install Git: Download and install Git from git-scm.com.
4. Verify Git: Open your terminal/command prompt and run git --version.
5. Configure Git: Run git config --global user.name "Your Name" and git config --global user.email "your.email@example.com" (replacing with your actual info).
6. Install VS Code: Download and install VS Code from code.visualstudio.com.
7. Install Python Extension: Launch VS Code, go to the Extensions view (Ctrl+Shift+X), and install the "Python" extension by Microsoft.

Success looks like: You can run all the verification commands without errors, Git is configured, and the Python extension is installed in VS Code.