id: checkout-race
info:
  name: Checkout Duplicate Order Race
  severity: critical
race:
  mode: burst
  concurrency: 20
  request:
    method: POST
    path: /api/v1/checkout
    headers:
      Authorization: "Bearer {{session}}"
    body: '{"item_id": "SKU-001"}'
validate:
  follow_up:
    method: GET
    path: /api/v1/orders?user={{user_id}}
  expect:
    json_field: "orders.length"
    condition: equals
    value: 1

# curl कमांड से
ratrace import --curl 'curl -X POST https://api.example.com/checkout ...' -o template.yaml

# Burp निर्यातित HAR फ़ाइलों से
ratrace import --har session.har -o template.yaml

ratrace race -u $TARGET -t template.yaml --silent
echo $?  # एग्जिट कोड 10 = रेस मिली, 0 = साफ

# स्वचालन के लिए JSON
ratrace race -u $TARGET -t template.yaml -o results/

# HTML रिपोर्ट (योजित V2)
ratrace report --input results.json --format html

git clone https://github.com/bogdanticu88/ratrace.git
cd ratrace
go build ./cmd/ratrace
./ratrace --help

docker build -t ratrace:latest .
docker run --rm -it ratrace:latest race -u https://api.example.com -t template.yaml

# 1. curl से आयात करें या मौजूदा टेम्पलेट का उपयोग करें
ratrace import --curl 'curl -X POST https://api.example.com/checkout ...' -o checkout.yaml

# 2. रेस निष्पादित करें
ratrace race -u https://api.example.com -t checkout.yaml -m burst -c 20

# 3. निष्कर्षों की समीक्षा करें
# आउटपुट दिखाता है:
# 🔴 [CRITICAL] Checkout Duplicate Order Race
#     Anomaly Rate: 91.7%
#     Confidence:   84%

ratrace race \
  -u https://shop.example.com \
  -t examples/templates/checkout-race.yaml \
  -m burst \
  -c 25 \
  --output results/

# वर्बोज़ लॉग के बिना चलता है, सिमैंटिक कोड के साथ बाहर निकलता है
ratrace race -u https://api.example.com -t template.yaml --silent

# एग्जिट कोड जांचें
if [ $? -eq 10 ]; then
  echo "रेस कंडीशन मिली!"
  exit 1
fi

ratrace race -u <url> -t <template> [options]

Options:
  -m, --mode string          burst|lastbyte|singlepacket (टेम्पलेट से डिफ़ॉल्ट)
  -c, --concurrency int      गोरूटीन गणना (डिफ़ॉल्ट 20)
  -H, --header strings       कस्टम हेडर (दोहराने योग्य)
  -x, --proxy string         अनुरोधों के लिए प्रॉक्सी URL
  -o, --output string        परिणामों के लिए आउटपुट निर्देशिका
  --timeout duration         अनुरोध टाइमआउट (डिफ़ॉल्ट 10s)
  --insecure                 TLS प्रमाणपत्र सत्यापन छोड़ें
  --dry-run                  टेम्पलेट पार्स करें और बाहर निकलें
  --silent                   लॉग दबाएँ, केवल निष्कर्ष दिखाएँ

ratrace import [--curl <command> | --har <file>] -o <output.yaml>

मौजूदा अनुरोधों (curl कमांड या HAR निर्यात) को RatRace टेम्पलेट्स में बदलता है।
मौजूदा वर्कफ़्लो के साथ एकीकृत करने के लिए उपयोगी।

ratrace report --input results.json --format [html|json] --output report.html

रेस टेस्ट परिणामों से मानव-पठनीय रिपोर्ट उत्पन्न करता है।

ratrace ratelimit -u <url> -c <concurrency>

परीक्षण करता है कि क्या एंडपॉइंट समवर्ती दर सीमा बायपास के लिए कमजोर हैं।

id: unique-identifier
info:
  name: "मानव-पठनीय नाम"
  severity: critical|high|medium|low|info
  tags: [tag1, tag2]

race:
  mode: burst|lastbyte|singlepacket
  concurrency: 20
  request:
    method: POST|GET|PUT|DELETE|PATCH
    path: /api/endpoint
    headers:
      Authorization: "Bearer {{token}}"
      Custom-Header: "value"
    body: '{"json": "body", "user": "{{user_id}}"}'

validate:
  follow_up:
    method: GET
    path: /api/orders?user={{user_id}}
  expect:
    json_field: "orders.length"
    condition: equals|greater_than|contains|not_equals
    value: 1

[INF] Loading template  path=checkout-race.yaml
[INF] Template loaded  id=checkout-race  mode=burst
[RUN] Firing burst attack  concurrency=20
[INF] All requests completed  total=20
[RUN] Clustering responses  baseline=17  anomalous=3
[RACE] Race condition detected  anomaly_rate=15%  confidence=94%
[CONF] Validation passed  field=orders.length  expected=1
[INF] Race test complete  findings=1

Templates: 1  Requests: 20  Time: 3.2s

🔴 [CRITICAL] Checkout Duplicate Order Race
    Anomaly Rate:  15.0%
    Confidence:    94%
    Status Diff:   201 → 200
    Field Diffs:   order_id (100 → 101)

{
  "TemplateID": "checkout-race",
  "Target": "https://api.example.com/api/v1/checkout",
  "Mode": "burst",
  "Concurrency": 20,
  "TotalRequests": 20,
  "Duration": 3200000000,
  "Findings": [
    {
      "TemplateName": "Checkout Duplicate Order Race",
      "Severity": "critical",
      "AnomalyRate": 0.15,
      "Confidence": 0.94,
      "Diff": {
        "StatusChanged": true,
        "BaselineStatus": 201,
        "AnomalousStatus": 200
      }
    }
  ]
}

make build              # बाइनरी संकलित करें

make test              # सभी परीक्षण
make test-unit         # केवल यूनिट परीक्षण
make test-int          # एकीकरण परीक्षण
make coverage          # कवरेज रिपोर्ट (HTML)

make lint              # लिंटर चलाएँ

make run-race          # बिल्ड करें और उदाहरण चलाएँ

cmd/ratrace/
  └── main.go           प्रवेश बिंदु, CLI परिभाषा

internal/
  ├── cmd/              उप-कमांड कार्यान्वयन
  ├── engine/           रेस आक्रमण मोड (burst, lastbyte, singlepacket)
  ├── validator/        प्रतिक्रिया क्लस्टरिंग, अंतर, अनुवर्ती जाँच
  ├── importer/         HAR और curl पार्सर
  ├── reporter/         JSON और HTML आउटपुट
  ├── template/         YAML पार्सिंग और टेम्पलेटिंग
  ├── log/              संरचित रंग लॉगिंग
  └── models/           साझा डेटा प्रकार