.. _module1_installation_and_ides:

Installation & IDEs
=======================================================================

1. Introduction
---------------

This section provides step-by-step instructions for setting up your
Python development environment using VS Code, Git, Python, and
Everything Search. These tools are essential for efficient coding,
version control, and file management.

--------------

2. Installing Python
--------------------

- Download the latest version of Python from the `official
  website <https://www.python.org/downloads/>`__.

- Run the installer and **check the box** to add Python to PATH.

- Verify installation:

  .. code:: sh

     python --version

--------------

3. Installing VS Code
---------------------

- Download VS Code from the `official
  website <https://code.visualstudio.com/>`__.
- Install using the default options.
- Launch VS Code after installation.

--------------

4. Installing Python & Jupyter Extensions in VS Code
----------------------------------------------------

- Open VS Code.
- Go to the Extensions view (Ctrl+Shift+X).
- Search for and install:

  - **Python** (by Microsoft)
  - **Jupyter** (by Microsoft)

- These extensions enable Python coding and Jupyter notebook support in
  VS Code.

--------------

5. Installing ipykernel for Notebooks
-------------------------------------

- Open a terminal in VS Code (``Ctrl+J``)

- Run:

  .. code:: sh

     pip install ipykernel

- This allows you to create and run Jupyter notebooks in VS Code.

--------------

6. Installing Git
-----------------

- Download Git from the `official
  website <https://git-scm.com/downloads>`__.

- Install using default options.

- Verify installation:

  .. code:: sh

     git --version

--------------

7. Git Configuration & GitHub Account
-------------------------------------

- Set your username and email:

  .. code:: sh

     git config --global user.name "Your Name"
     git config --global user.email "your.email@example.com"

- Create a free account on `GitHub <https://github.com/>`__.

- Use your GitHub account to host and manage your code repositories.

--------------

8. Installing Everything Search (Windows Only)
----------------------------------------------

- Download from `voidtools <https://www.voidtools.com/downloads/>`__.
- Install and use Everything Search to quickly find files and folders on
  your computer.

--------------

9. Summary
----------

With these tools installed and configured, you are ready to start
coding, managing projects, and collaborating using modern development
workflows.

--------------

*Prepared by Zaid Kamil.*