Getting Started

# npm (recommended)

npm install -g @fusillade-io/fusillade

# Linux

curl -sSL https://github.com/Fusillade-io/Fusillade/releases/latest/download/fusillade-linux-x64 -o fusillade
chmod +x fusillade
sudo mv fusillade /usr/local/bin/

# macOS (Apple Silicon)

curl -sSL https://github.com/Fusillade-io/Fusillade/releases/latest/download/fusillade-macos-arm64 -o fusillade
chmod +x fusillade
sudo mv fusillade /usr/local/bin/

# macOS (Intel)

curl -sSL https://github.com/Fusillade-io/Fusillade/releases/latest/download/fusillade-macos-x64 -o fusillade
chmod +x fusillade
sudo mv fusillade /usr/local/bin/

# Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/Fusillade-io/Fusillade/releases/latest/download/fusillade-windows-x64.exe" -OutFile "fusillade.exe"

# From source (Cargo)

cargo install fusillade

# Verify installation

$ fusillade --version
$ fusi --version  # Short alias

# Initialize a new project

$ fusillade init -o my-test.js --config
# Or with TypeScript:
$ fusillade init -t -o my-test.ts --config

# test.js

export const options = {
  workers: 10,
  duration: '30s',
  thresholds: {
    'http_req_duration': ['p95 < 500'],
    'http_req_failed': ['rate < 0.01'],
  }
};

export default function() {
  const res = http.get('https://api.example.com/users');

  check(res, {
    'status is 200': (r) => r.status === 200,
    'protocol is HTTP/2': (r) => r.proto === 'h2',
  });

  sleep(1);
}

# test.ts (TypeScript)

interface Options {
  workers: number;
  duration: string;
  thresholds: Record<string, string[]>;
}

export const options: Options = {
  workers: 10,
  duration: '30s',
  thresholds: {
    'http_req_duration': ['p95 < 500'],
    'http_req_failed': ['rate < 0.01'],
  }
};

export default function(): void {
  const res = http.get('https://api.example.com/users');

  check(res, {
    'status is 200': (r: any) => r.status === 200,
    'protocol is HTTP/2': (r: any) => r.proto === 'h2',
  });

  sleep(1);
}

# Run

$ fusillade run test.js    # JavaScript
$ fusillade run test.ts    # TypeScript
$ fusi run test.ts         # Short alias

# Bash

$ fusillade completion bash >> ~/.bashrc && source ~/.bashrc

# Zsh

$ fusillade completion zsh >> ~/.zshrc && source ~/.zshrc

# Fish

$ fusillade completion fish > ~/.config/fish/completions/fusillade.fish

# PowerShell

$ fusillade completion powershell >> $PROFILE

$ fusillade schema -o fusillade.schema.json