Download für Windows x64 / Windows x64 download
DefineExtractor ist ein Windows-Werkzeug mit grafischer Oberfläche und Konsole. Es durchsucht Quellcode nach folgenden Mustern:
#define-Makros in.h- und.cpp-Dateienapp.xyz-Aufrufe in.py-Dateien
Alle ausgewählten Symbole werden in einem Durchlauf pro Datei gesucht. Für den portablen Download das ZIP in einen beschreibbaren Ordner entpacken und DefineExtractorGUI.exe starten. Die Konsole ist als DefineExtractor.exe enthalten.
-
Automatische Header-Erkennung
- Findet
locale_inc.h(Client) sowieservice.h/commondefines.h(Server) durch rekursives Durchsuchen einschlägiger Unterordner.
- Findet
-
Makro-Listing
- Zeigt alle definierten Makros aus den erkannten Headern an, um gezielt nach einem bestimmten
#definezu suchen.
- Zeigt alle definierten Makros aus den erkannten Headern an, um gezielt nach einem bestimmten
-
Python-Parameter
- Listet
app.xyzausif- undelif-Bedingungen in Python-Dateien auf.
- Listet
-
Ausgabedateien in
Output/- Jeder Lauf erhält einen eigenen Ordner in
Output/. Pro Symbol gibt es zwei Textdateien mit relativen Quellpfaden und Zeilenbereichen.*_DEFINE.txtenthält die passenden C++-Präprozessorzweige oder Python-if/elif-Blöcke.*_FUNC.txtenthält die zugehörigen Funktionen.
- Jeder Lauf erhält einen eigenen Ordner in
-
Multithreading
- Die Worker teilen sich die Dateien. Jede Datei wird einmal für alle ausgewählten Symbole gelesen und analysiert.
| Komponente | Version |
|---|---|
| Visual Studio | 2022 oder 2026 (Workload: Desktopentwicklung mit C++) |
| CMake | ≥ 3.25 (im VS-Lieferumfang enthalten) |
| Rust | Stable, erforderlich zum Bauen von Slint |
| C++-Standard | C++23 |
| Betriebssystem | Windows (x64) |
Das Projekt verwendet CMake mit Presets (CMakePresets.json). Zwei Konfigurationen stehen bereit: Debug und Release.
- Visual Studio starten.
- Datei → Öffnen → Ordner… → Projektordner auswählen (dort liegt
CMakeLists.txt). - VS erkennt
CMakePresets.jsonautomatisch und zeigt im Konfigurations-Dropdown:Debug (x64)→build/debug/DefineExtractor.exeRelease (x64)→build/release/DefineExtractor.exe
- Konfiguration wählen → Strg+Umschalt+B zum Bauen.
- Im Dropdown „Startobjekt auswählen" →
DefineExtractorGUI.exeoderDefineExtractor.exewählen → F5 / Strg+F5.
:: Aus dem Projektordner:
cmake --preset debug && cmake --build --preset debug
cmake --preset release && cmake --build --preset release| Konfiguration | Pfad |
|---|---|
| Debug | build/debug/DefineExtractor.exe |
| Release | build/release/DefineExtractor.exe |
Das Projekt enthält Unit-Tests mit Catch2 v3 (über CMake FetchContent bezogen):
cmake --preset debug && cmake --build --preset debug --target test_helpers
.\build\debug\test_helpers.exeAlle 18 Tests müssen bestehen, bevor Änderungen eingereicht werden.
DefineExtractor/
├─ DefineExtractor/
│ ├─ DefineExtractor.cpp # Hauptlogik
│ └─ helpers.h # Performance-Hilfsfunktionen (testbar)
├─ tests/
│ ├─ test_helpers.cpp # Catch2-Tests
│ # Catch2 v3 wird automatisch via CMake bezogen
├─ .github/
│ └─ dependabot.yml
├─ CMakeLists.txt
├─ CMakePresets.json # Debug- & Release-Presets
├─ HOWTO.md
├─ CONTRIBUTING.md
├─ SECURITY.md
└─ CODE_OF_CONDUCT.md
Starte DefineExtractor.exe per Doppelklick oder über CMD/PowerShell.
Lege Client-, Server- und Python-Ordner auf derselben Ebene wie den Programmordner ab:
C:\MeineProjekte\
├─ DefineExtractor\ ← EXE hier
├─ MeinClient\
├─ MeinServer\
└─ PythonStuff\
Ablauf:
- Pfad-Menü: Client, Server und Python Root setzen.
- Hauptmenü: Gewünschten Scan-Typ wählen.
- Ein oder mehrere Defines oder Parameter auswählen. In der Konsole werden die Nummern mit Leerzeichen oder Kommas getrennt.
- Die C++-Analyse erfasst Quelltext in allen Präprozessorzweigen. Sie expandiert keine Makros und verwendet Heuristiken für Funktionsgrenzen.
- Die Python-Analyse erfasst
app.xyzinif- undelif-Bedingungen und ordnet die Treffer umgebenden Funktionen zu.
- Beiträge willkommen: siehe CONTRIBUTING.md
- Sicherheitslücken bitte nicht öffentlich melden: siehe SECURITY.md
- Umgangston: siehe CODE_OF_CONDUCT.md
Kein spezifischer Lizenztext enthalten. Verwendung auf eigene Verantwortung.
DefineExtractor is a Windows desktop and console tool that searches source code for:
#definemacros in.hand.cppfilesapp.xyzreferences in.pyfiles
It checks all selected symbols in one pass per file. To use the portable download, extract the ZIP to a writable folder and run DefineExtractorGUI.exe. The package also includes DefineExtractor.exe for console use.
- Automatic Header Detection — finds
locale_inc.h(Client) andservice.h/commondefines.h(Server) by recursive folder scan. - Macro Listing — displays all macros from the detected header for targeted
#definesearches. - Python Parameter Discovery — lists
app.xyzreferences inifandelifconditions. - Output Files — each run gets a directory in
Output/with two files per symbol. Reports list relative source paths and line ranges.*_DEFINE.txtcontains matching C++ preprocessor branches or Pythonif/elifblocks.*_FUNC.txtcontains the associated functions.
| Component | Version |
|---|---|
| Visual Studio | 2022 or 2026 (workload: Desktop development with C++) |
| CMake | ≥ 3.25 (bundled with VS) |
| Rust | Stable, required to build Slint |
| C++ standard | C++23 |
| OS | Windows (x64) |
The project uses CMake Presets (CMakePresets.json) with two configurations: Debug and Release.
- Launch Visual Studio.
- File → Open → Folder… → select the project root (where
CMakeLists.txtlives). - VS reads
CMakePresets.jsonautomatically and shows in the configuration dropdown:Debug (x64)→build/debug/DefineExtractor.exeRelease (x64)→build/release/DefineExtractor.exe
- Select a configuration → Ctrl+Shift+B to build.
- In "Select Startup Item" choose
DefineExtractorGUI.exeorDefineExtractor.exe→ F5 / Ctrl+F5.
cmake --preset debug && cmake --build --preset debug
cmake --preset release && cmake --build --preset release| Configuration | Path |
|---|---|
| Debug | build/debug/DefineExtractor.exe |
| Release | build/release/DefineExtractor.exe |
Unit tests use Catch2 v3 (fetched via CMake FetchContent):
cmake --preset debug && cmake --build --preset debug --target test_helpers
.\build\debug\test_helpers.exeAll 18 tests must pass before submitting changes.
DefineExtractor/
├─ DefineExtractor/
│ ├─ DefineExtractor.cpp # core logic
│ └─ helpers.h # performance helpers (unit-tested)
├─ tests/
│ ├─ test_helpers.cpp # Catch2 tests
│ # Catch2 v3 is fetched automatically via CMake
├─ .github/
│ └─ dependabot.yml
├─ CMakeLists.txt
├─ CMakePresets.json # Debug & Release presets
├─ HOWTO.md
├─ CONTRIBUTING.md
├─ SECURITY.md
└─ CODE_OF_CONDUCT.md
Launch DefineExtractor.exe by double-clicking or from CMD/PowerShell.
Place Client, Server, and Python folders at the same level as the program folder:
C:\MyProjects\
├─ DefineExtractor\ ← exe here
├─ MyClient\
├─ MyServer\
└─ PythonStuff\
Workflow:
- Path menu: set Client, Server, and Python Root.
- Main menu: choose the scan type.
- Select one or more defines or parameters. In the console, separate indices with spaces or commas.
- C++ scanning considers source text in every preprocessor branch. It uses heuristics for function boundaries and does not expand macros.
- Python scanning captures
app.xyzinifandelifconditions and associates matches with enclosing functions.
- Contributions welcome: see CONTRIBUTING.md
- Security issues — do not file public issues: see SECURITY.md
- Community standards: see CODE_OF_CONDUCT.md
No specific license is included. Use at your own risk.
