Local Development Instructions

To install the ethstaker-deposit-cli, follow these steps:

Prerequisites

Ensure you have the following software installed on your system:

  • Git: Version control system to clone the repository. Download Git
  • Python 3.9+: The programming language required to run the tool. Download Python
  • pip: Package installer for Python, which is included with Python 3.9+.

On Windows, you'll need:

  • Git for Windows: Version control system to clone the repository. Configure it to associate .sh files with bash. Download GfW
  • Windows Terminal: Optional but recommended command line console. Configure GfW to install a Git Bash profile. Download Windows Terminal
  • Python 3.9+: The programming language required to run the tool. Download Python
  • Visual Studio C++: The compiler required to build some of the dependencies of the tool. Download VS C++

Local Development Steps

  1. Clone the Repository

    git clone https://github.com/eth-educators/ethstaker-deposit-cli.git
    
  2. Navigate to the Project Directory

    cd ethstaker-deposit-cli
    
  3. Setup virtualenv (optional)

    Install venv if not already installed, e.g. for Debian/Ubuntu:

    sudo apt update && sudo apt install python3-venv
    

    Create a new virtual environment:

    python3 -m venv .venv
    source .venv/bin/activate
    
  4. Install Dependencies

    pip3 install -r requirements.txt
    
  5. Run the CLI

    You can now run the CLI tool using the following command:

    python3 -m ethstaker_deposit [OPTIONS] COMMAND [ARGS]
    
  6. Use pre-commit for PRs

    Install pre-commit if not already installed, e.g. for Debian/Ubuntu:

    sudo apt update && sudo apt install pre-commit
    

    Enable it for your git commit workflow:

    pre-commit install
    

To execute tests, you will need to install the test dependencies:

python3 -m pip install -r requirements.txt -r requirements_test.txt
python3 -m pytest tests