docs

system requirements

• • Node.js (v14 or later)

  • Git (for initializing and managing repositories)

  • admin or sudo access for installations

installation steps

Debian/Ubuntu

1. Update package lists:

sudo apt update

2. Install Node.js and npm:

sudo apt install -y nodejs npm

3. Verify Node.js and npm installation:

node -v

npm -v

4. Install qapra globally:

sudo npm install -g qapra

RedHat/Fedora

1. Install Node.js and npm via DNF:

sudo dnf install -y nodejs npm

2. Verify Node.js and npm installation:

node -v

npm -v

3. Install qapra globally:

sudo npm install -g qapra

macOS

1. Install Homebrew (if not installed):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Add Homebrew to your PATH:

Depending on your system (Apple Silicon or Intel Mac), add Homebrew to your path:

• for Apple Silicon Macs (M1/M2/M3):

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

• for Intel Macs (default Homebrew location):

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc

After running the appropriate command, make sure to reload your .zshrc file:

source ~/.zshrc

3. Install Node.js using Homebrew:

brew install node

4. Verify Node.js and npm installation:

node -v

npm -v

5. Install qapra globally:

npm install -g qapra

Windows

1. Install Node.js and npm from the Node.js website

Download and install the LTS version:

2. Verify Node.js and npm installation:

Open Command Prompt and run:

node -v

npm -v

3. Install qapra globally:

npm install -g qapra

how it works

1. Navigate to the root directory of the project you want to test:

cd /path/to/your/git/repo

2. Initialize qapra and sign up:

Run the following command to start the setup process:

qapra init

This will guide you through:

• signing up with your email and password

• installing the qapra GitHub App

• granting permissions to add the qapra agent as a collaborator on your repo

3. Commit unstaged changes:

After initializing, it’s important to commit any changes in your working directory, as qapra will generate test code in the next steps.

4. Start your backend server and database:

Ensure that your local backend server and database are running, as qapra will make changes to the database while generating tests.

5. Generate backend tests:

Run the following command to generate the test cases:

qapra gentests

This will analyze your codebase and create the necessary tests.

For any issues or questions with installation and using qapra please contact us.