Skip to content
CAI
Software that uses CAICheck a score

struppigel/PortEx

54.9

Adequate · 6 November 2026

44.5k

lines of production code

Java

with Scala

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.