.. _bootloader_docs_installing_windows:

Installing on Windows
=====================


Prerequisites
-------------

* Install `Git for Windows <https://git-scm.com/download/win>`_. Make sure you download the version (either 32-bit or 64-bit) that matches your system (most likely 64 bit)
* Install `Python 3.11 <https://www.python.org/downloads/windows/>`_
    * Make sure you install the version (either 32-bit or 64-bit) that matches your system (most likely 64-bit)
    * In the install wizard, make sure you check the box that adds Python to your PATH
* AWS access keys (optional)
    * Only needed if you intend to download firmware files. If you already have a local file to flash, you do not need access keys
    * These keys must be stored in ``~/.aws/credentials`` as described `here <https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html#shared-credentials-file>`_

.. note::

   Make sure you download the 64-bit version if you downloaded the 64-bit Git above and the 32-bit version if you installed the 32-bit Git above.

.. note::

   When going through the installation wizard, make sure you check the box that adds Python to your PATH.

Install ``bootloader`` in a virtual environment. From your Git Bash terminal:

.. code-block:: bash

    mkdir -p ~/.venvs
    python -m venv ~/.venvs/dephy
    source ~/.venvs/dephy/Scripts/activate

You will need to run the above ``source`` command each time you open a new terminal unless you add the command to your profile.


Installing
----------
``bootloader`` is installed via ``pip``:

.. code-block:: bash

    python -m pip install bootloader


Developing
----------

To develop ``bootloader``, we strongly recommend installing `Poetry <https://python-poetry.org/docs/>`_.

To do so, start Windows Powershell as Administrator. By default, Powershell will not
start in the same directory as Git Bash. This means in order to activate your virtual
environment from Powershell, we have to first navigate to that directory. Here we use
``USER`` in place of your user name:

.. code-block:: powershell

    cd C:\Users\USER\.venvs\dephy\Scripts
    .\Activate.ps1
    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

.. note::

   Once installed, `poetry` should be available from your Git Bash terminal.

Activate the development environment and install the dependencies for ``bootloader`` by
running the following commands from your Git Bash terminal and the ``bootloader`` repository:

.. code-block:: bash

    poetry shell
    poetry install

Pull Requests and Bug Reports (Issues) are welcome!