DiffCatcher

🎯 मुख्य विशेषताएँ

• रिपॉजिटरी खोज: कॉन्फ़िगरेबल फ़िल्टर के साथ Git रिपॉजिटरी के लिए निर्देशिकाओं को पुनरावर्ती रूप से स्कैन करें
• स्थिति ट्रैकिंग: कमिट हैश, संदेश और गंदगी जाँच के साथ पूर्व/पश्च-पुल स्थिति कैप्चर करें
• Diff पीढ़ी: फ़ाइल मैनिफ़ेस्ट के साथ स्वचालित N बनाम N-1 और ऐतिहासिक diff निर्माण
• तत्व निष्कर्षण: 10+ भाषाओं में फ़ंक्शन, struct, वर्ग, import आदि की पहचान करने के लिए diffs को पार्स करें
• कोड स्निपेट्स: सीमा पहचान और संदर्भ विंडो के साथ पूर्ण पहले/बाद का कोड निकालें
• सुरक्षा टैगिंग: 18 अंतर्निहित सुरक्षा पैटर्न (क्रिप्टो, प्रमाणीकरण, रहस्य, SQL इंजेक्शन, XSS, आदि)
• बहु-प्रारूप रिपोर्ट: JSON, Markdown, text, और SARIF आउटपुट क्रॉस-रेपो सुरक्षा अवलोकन के साथ
• शाखा-अंतर मोड: एकल रिपॉजिटरी में किन्हीं दो refs (शाखाएँ, टैग, कमिट) के बीच अंतर — PR समीक्षाओं के लिए आदर्श
• प्रदर्शन: प्रगति पट्टियाँ, LRU कैशिंग और वृद्धिशील मोड के साथ समानांतर प्रसंस्करण

केवल bash का उपयोग क्यों न करें?

ls | while read line; do git -C "$line" diff HEAD~1 HEAD || true; done जैसी एक-पंक्ति केवल कच्चे diffs दिखाती है। DiffCatcher पुनरावर्ती खोज, कोड तत्व निष्कर्षण, सुरक्षा पैटर्न पहचान, CI/CD के लिए SARIF आउटपुट, समानांतर प्रसंस्करण और क्रॉस-रेपो सुरक्षा एकत्रीकरण जोड़ता है। पूर्ण तुलना के लिए नीचे पूर्ण तुलना देखें।

📋 विषय सूची

• स्थापना
• त्वरित प्रारंभ
• उपयोग
  • मूल स्कैनिंग
  • पुल मोड
  • निष्कर्षण विकल्प
  • सुरक्षा टैगिंग
  • कॉन्फ़िगरेशन फ़ाइल
  • प्लगइन सिस्टम
  • शाखा-अंतर मोड (PR समीक्षा)
  • SARIF आउटपुट
  • उन्नत सुविधाएँ
• रिपोर्ट संरचना
• कॉन्फ़िगरेशन
• आर्किटेक्चर
• परीक्षण
• दस्तावेज़ीकरण
• योगदान

🚀 स्थापना

स्रोत से

git clone https://github.com/Teycir/DiffCatcher.git
cd DiffCatcher
cargo build --release
./target/release/diffcatcher --help

आवश्यकताएँ

• Rust 1.70+
• Git 2.0+

⚡ त्वरित प्रारंभ

# किसी निर्देशिका में सभी रिपॉजिटरी स्कैन करें (केवल fetch, कोई संशोधन नहीं)
diffcatcher ~/projects

# अपडेट पुल करें और सुरक्षा रिपोर्ट तैयार करें
diffcatcher ~/projects --pull -o ./report

# एकल रिपॉजिटरी में दो शाखाओं के बीच अंतर (PR समीक्षा मोड)
diffcatcher ./my-repo --diff main..feature/auth -o ./pr-report

# GitHub कोड स्कैनिंग के लिए SARIF आउटपुट तैयार करें
diffcatcher ~/projects --summary-format sarif,json -o ./report

# क्या स्कैन किया जाएगा यह देखने के लिए ड्राई रन
diffcatcher ~/projects --dry-run

# 8 समानांतर कार्यकर्ताओं के साथ तेज़ स्कैन
diffcatcher ~/projects -j 8 --quiet

📖 उपयोग

मूल स्कैनिंग

# डिफ़ॉल्ट सेटिंग्स के साथ स्कैन करें (केवल fetch)
diffcatcher <ROOT_DIR>

# कस्टम आउटपुट निर्देशिका
diffcatcher ~/projects -o ./my-report

# नेस्टेड रिपॉजिटरी शामिल करें और सिमलिंक का अनुसरण करें
diffcatcher ~/projects --nested --follow-symlinks

# छिपी हुई निर्देशिकाओं को छोड़ें
diffcatcher ~/projects --skip-hidden

पुल मोड

# केवल fetch (डिफ़ॉल्ट - कार्यरत ट्री में कोई बदलाव नहीं)
diffcatcher ~/projects

# वास्तव में परिवर्तन पुल करें
diffcatcher ~/projects --pull

# गंदी रिपॉजिटरी के लिए stash/pop के साथ फोर्स पुल
diffcatcher ~/projects --pull --force-pull

# rebase रणनीति का उपयोग करें
diffcatcher ~/projects --pull --pull-strategy rebase

# fetch/pull को पूरी तरह से छोड़ें (केवल ऐतिहासिक diffs)
diffcatcher ~/projects --no-pull

निष्कर्षण विकल्प

# तत्व निष्कर्षण छोड़ें (केवल कच्चे diffs)
diffcatcher ~/projects --no-summary-extraction

# तत्व निकालें लेकिन कोड स्निपेट छोड़ें
diffcatcher ~/projects --no-snippets

# स्निपेट संदर्भ और सीमाएँ समायोजित करें
diffcatcher ~/projects --snippet-context 10 --max-snippet-lines 300

# प्रति diff तत्वों को सीमित करें
diffcatcher ~/projects --max-elements 1000

सुरक्षा टैगिंग

# सुरक्षा टैगिंग छोड़ें
diffcatcher ~/projects --no-security-tags

# सुरक्षा विश्लेषण में परीक्षण फ़ाइलें शामिल करें
diffcatcher ~/projects --include-test-security

# कस्टम सुरक्षा पैटर्न का उपयोग करें
diffcatcher ~/projects --security-tags-file ./custom-patterns.json

कॉन्फ़िगरेशन फ़ाइल

DiffCatcher प्रोजेक्ट-स्थानीय कॉन्फ़िगरेशन को स्वचालित रूप से लोड कर सकता है:

• <ROOT_DIR>/.diffcatcher.toml (डिफ़ॉल्ट)
• --config <FILE> के माध्यम से एक कस्टम फ़ाइल
• --no-config के साथ अक्षम

उदाहरण:

output = "reports-local"
no_pull = true
history_depth = 2
summary_formats = ["json", "txt"]
no_security_tags = false

[plugins]
security_pattern_files = ["plugins/security-extra.json"]
extractor_files = ["plugins/extractors.json"]

CLI फ़्लैग अभी भी स्पष्ट रूप से सेट होने पर कॉन्फ़िग मानों को ओवरराइड करते हैं।

प्लगइन सिस्टम

DiffCatcher दो प्रकार के प्लगइन का समर्थन करता है:

• सुरक्षा पैटर्न प्लगइन: --security-plugin-file <FILE> (दोहराने योग्य) के माध्यम से
• एक्सट्रैक्टर प्लगइन: --extractor-plugin-file <FILE> (दोहराने योग्य) के माध्यम से

सुरक्षा प्लगइन प्रारूप --security-tags-file JSON (version, mode, tags) से मेल खाता है।

एक्सट्रैक्टर प्लगइन प्रारूप:

{
  "version": 1,
  "extractors": [
    {
      "name": "policy-rule",
      "kind": "Config",
      "regex": "^policy\\s+([A-Za-z_][A-Za-z0-9_]*)"
    }
  ]
}

शाखा-अंतर मोड (PR समीक्षा)

# एकल रिपॉजिटरी में दो शाखाओं के बीच अंतर
diffcatcher ./my-repo --diff main..feature/auth

# विशिष्ट कमिट के बीच अंतर
diffcatcher ./my-repo --diff abc123..def456

# CI एकीकरण के लिए SARIF आउटपुट के साथ अंतर
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

--diff BASE..HEAD फ़्लैग रिपॉजिटरी खोज और fetch/pull को छोड़ देता है — यह सीधे दो refs (शाखाएँ, टैग, या कमिट SHA) के बीच अंतर करता है और परिणाम पर पूर्ण निष्कर्षण + सुरक्षा टैगिंग पाइपलाइन चलाता है।

SARIF आउटपुट

# अन्य प्रारूपों के साथ SARIF तैयार करें
diffcatcher ~/projects --summary-format sarif,json,md

# CI/CD अपलोड के लिए केवल SARIF
diffcatcher ~/projects --summary-format sarif -o ./report

जब --summary-format में sarif शामिल होता है, तो रिपोर्ट रूट में एक results.sarif फ़ाइल लिखी जाती है। यह फ़ाइल SARIF 2.1.0 मानक का पालन करती है और GitHub कोड स्कैनिंग, VS Code SARIF व्यूअर, Azure DevOps और अन्य SARIF-संगत टूल के साथ एकीकृत होती है।

उन्नत सुविधाएँ

# वृद्धिशील मोड (अपरिवर्तित रिपॉजिटरी को छोड़ें)
diffcatcher ~/projects --incremental -o ./report

# शाखा पैटर्न द्वारा फ़िल्टर करें
diffcatcher ~/projects --branch-filter "main"

# इतिहास गहराई समायोजित करें
diffcatcher ~/projects --history-depth 5