Codebase metrics¶

A measured snapshot of the Personal Data Vault codebase and its submodules, counted with cloc. Charts show code lines (blank and comment lines excluded) unless stated otherwise.

Snapshot

Measured on the 1.x branch, 2026-09-30, with cloc 2.08. 417 files, 30,845 lines of code, 15,828 comment lines, 6,110 blank (52,783 lines in total). See Methodology to reproduce.

At a glance¶

Code	Comment	Blank	Files	Production	Test
30,845	15,828	6,110	417	22,523	8,322

Production vs test¶

Personal Data Vault ships 8,322 lines of test code backing 22,523 lines of production code, a 37% test-to-production ratio.

Lines by language¶

Language	Code	Comment	Blank	Files
PHP	24,643	15,483	4,740	297
YAML	2,517	258	174	81
PO File	1,696	12	783	11
Markdown	1,538	1	386	15
Text	235	0	8	4
CSS	90	60	16	4
JSON	69	0	0	2
HTML	19	0	0	1
JavaScript	19	13	2	1
SVG	19	1	1	1

Composition¶

Across all languages, code is 58% of the lines, comments 30%, and blank lines 12%. The comment share reflects Drupal's docblock conventions.

By submodule¶

Production (brass) and test (steel) code per submodule, largest first.

Submodule	Production	Test	Total
pdv (core)	16,317	4,749	21,066
pdv_client	1,748	1,180	2,928
pdv_webform	1,394	1,117	2,511
pdv_server_api	939	747	1,686
pdv_consumer_console	697	44	741
pdv_audit_trail	524	130	654
pdv_eca	164	108	272
pdv_message	166	84	250
pdv_vault	246	0	246
pdv_mail	123	69	192
pdv_client_api	132	48	180
pdv_client_audit_trail	73	46	119

Test suite¶

Personal Data Vault ships 86 automated test classes (477 test methods), counted by type below.

Test type	Classes	Methods
Kernel	74	431
Unit	9	35
Functional	3	11
FunctionalJavascript	0	0
Total	86	477

Architecture surface¶

What the module contains, counted across Personal Data Vault and its submodules: the Drupal building blocks (services, plugins, hooks, routes, entities) that make up its public and internal API.

Element	Count
Services	57
Event subscribers	8
Hook implementations	20
Routes	61
Permissions	6
Forms	47
Controllers	17
Content entity types	5
Config entity types	3
Config schema types	10
Plugins	8

Plugins break down by type as follows, largest first:

Methodology¶

This page is generated by scripts/generate-metrics.php, run from the module root after a change worth reflecting:

php scripts/generate-metrics.php

It measures the files git ls-files reports, so a checkout that has installed vendor/, previewed the docs into site/ or pulled a node_modules/ counts the same as the archive a release ships. This page is left out of that list: the script writes it, and a page that counts itself changes the tree it just measured, so no two regenerations agree. The snapshot above names the cloc version, because cloc counts differently from one version to the next; that is the version to run to reproduce this page, and the version the pipeline installs.

Each file is attributed to the nearest enclosing module (a directory with a *.info.yml); test-support modules under a tests/ path count as their parent's test code. A file is test code when its path contains a tests/ segment, production otherwise.

Test classes are counted by their directory under tests/src (Unit, Kernel, Functional, FunctionalJavascript); the method column counts each test-prefixed method, and each further one annotated @test or #[Test]. The architecture surface counts service definitions in *.services.yml (excluding aliases), route and permission keys in *.routing.yml and *.permissions.yml, #[Hook] attributes, plugin classes under src/Plugin/, forms and controllers under src/Form and src/Controller, entity-type attributes in src/Entity, and top-level types in config/schema/*.yml, all summed across the module and its submodules.

The charts are static inline SVG generated from the measured data, so they need no JavaScript or charting plugin. They are decorative and marked aria-hidden: every figure one of them draws is also in the table or the sentence beside it, so a screen reader gets the numbers rather than an image with no name. An img role carrying no accessible name is worse than no role at all, because it hides the labels inside the chart as well.