struppigel/PortEx
54.9
Adequate · 6 November 2026
44.5k
lines of production code
Java
with Scala
4
measurements over time
What this system is
This system is a library for parsing and analyzing Portable Executable (PE) files and .NET CLR metadata. It provides detailed structural inspection of headers, signatures, and resources, alongside capabilities to identify file types, packers, and installers using signature databases. The engine supports cooperative cancellation for long-running analyses and includes robustness features to handle malformed binaries safely.
Features
Added PE and .NET metadata parsing specifications
Added a comprehensive set of data files in src/main/resources/data that define the structure and field specifications for parsing PE (Portable Executable) headers, .NET CLR metadata tables, and related binary formats. These new resources include definitions for MS-DOS and COFF headers, data directories, debug information, and numerous CLR metadata tables (such as Assembly, MethodDef, Field, and Property tables), enabling the application to correctly interpret the internal structure of .NET assemblies and Windows PE files.
src/main/resources/data · high confidence
Expanded PE analysis with Rich Header, Authenticode, and CLR parsing
The repository now includes dedicated parsers for the PE Rich Header (identifying compiler/toolchain signatures via XOR keys), Authenticode signatures (parsing X.509 certificates, algorithm identifiers, and chain verification), and the .NET CLR metadata tables (resolving strings, blobs, and coded tokens). Additionally, import directory parsing now exposes physical file locations for DLL names and import entries, and resource directory entries track the locations of name strings.
repository · high confidence
Expanded PE file identification with new signature databases
The signature scanner now includes four new data files to improve detection of packed, protected, and specific file types in PE binaries. The new die.sig database adds packer and protector signatures derived from Detect It Easy, while packers.sig expands the existing packer/protector/compiler detection with additional patterns from PortEx. Additionally, filetypes.sig introduces magic number detection for various file formats (such as JPEG2000, MPEG-4, and Microsoft Access), installers.sig adds detection for various installer and archive formats (like Inno Setup and WinRAR), and javawrappers.sig enables identification of Java wrappers (such as Launch4j and Exe4j).
src/main/resources/data/signatures · high confidence
Support for interrupting long-running PE analysis
The PE analysis engine now supports cooperative cancellation via \Thread.interrupt()\. Embedding applications can abort a long-running scan by interrupting the analysis thread, which will throw an \AnalysisInterruptedException\ and leave the thread's interrupt flag set to ensure proper propagation. This allows users to safely cancel operations without leaving the system in an inconsistent state.
src/main/java/io · high confidence
Behavioural changes
License changed from BSD to Apache 2.0 and project documentation updated
The project license has been switched from the BSD-style license to the Apache License, Version 2.0, which changes the terms under which the software can be used, modified, and distributed. The README has been significantly expanded to include detailed feature lists, usage instructions for Maven and SBT, build requirements, and author contact information.
(repo-wide) · high confidence
Test coverage
Added tests for analysis interruption and robustness
Added test coverage for the new thread-interruption support, verifying that long-running analysis operations (such as certificate parsing, entropy calculation, and signature scanning) abort promptly with AnalysisInterruptedException while preserving the interrupt flag. Also added robustness tests to ensure the parser handles problematic PE files without crashing, and included example code compilation tests to keep documentation snippets valid.
src/test · high confidence
Dependencies
PortEx 5.0.7-SNAPSHOT dependency and build configuration update
The build configuration has been updated to Scala 2.12.20 and includes significant dependency upgrades, most notably to Guava 33.4.8-jre and Log4j API 2.25.0, alongside TestNG 6.14.3 for testing. The project is now configured to publish snapshots to Sonatype Central and utilizes GitHub Packages for releases, with local builds automatically bypassing GitHub credentials when no token is present.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 54 → 55 (+1.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 56 → 56 (+0.0)
- Architecture 90 → 90 (-0.1)
- Maturity 54 → 60 (+6.2)
- Readiness 47 → 47 (+0.3)
- Security 87 → 81 (-5.8)
- Performance 63 → 63 (+0.0)
Resolved (49)
- Documentation: no project overview (README.md)
- No assertions: ahkTest (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: archiveTest (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: autoitTest (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: brokenCertificateTablesGiveCleanMaps (src/test/java/io/github/struppigel/tools/layout/StructureMapTest.java)
- No assertions: checkInterruptThrowsAndPreservesFlag (src/test/java/io/github/struppigel/InterruptionTest.java)
- No assertions: chiSquaredArrayScanAborts (src/test/java/io/github/struppigel/InterruptionTest.java)
- No assertions: chiSquaredFileScanAborts (src/test/java/io/github/struppigel/InterruptionTest.java)
- No assertions: chunkReadsMatchFileBytesAcrossBoundariesAndPartialTail (src/test/java/io/github/struppigel/parser/sections/clr/CLRReadPathTest.java)
- No assertions: collapsedMSDOSHeader (src/test/java/io/github/struppigel/tools/anomalies/PEAnomalyScannerTest.java)
- No assertions: collapsedOptionalHeader (src/test/java/io/github/struppigel/tools/anomalies/PEAnomalyScannerTest.java)
- No assertions: compressedArchiveIsNoCompressor (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: deprecated (src/test/java/io/github/struppigel/tools/anomalies/PEAnomalyScannerTest.java)
- No assertions: directoryInputReturnsFailure (src/test/java/io/github/struppigel/tools/PortExAnalyzerCliTest.java)
- No assertions: dotNetCoreAppBundle (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: electronTest (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: embeddedExeTest (src/test/java/io/github/struppigel/tools/rehints/PEReHintScannerTest.java)
- No assertions: emptyInputReturnsFailure (src/test/java/io/github/struppigel/tools/PortExAnalyzerCliTest.java)
- No assertions: endOfContentsOutsideOfIndefiniteLengthIsMalformed (src/test/java/io/github/struppigel/parser/sections/cert/DerReaderTest.java)
- No assertions: entropyArrayScanAborts (src/test/java/io/github/struppigel/InterruptionTest.java)
- …and 29 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
struppigel/PortEx was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit bbcb1e452ae54dd7e211ca701dcaee5abb7bc28f — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.