scalacenter/scalac-profiling
63.0
Adequate · 7 November 2026
2.2k
lines of production code
Scala
with JavaScript
4
measurements over time
What this system is
Features
Add English homepage skeleton for the website
A new React-based homepage component has been added for the English version of the site. This page displays a hero section with a 'Get started' link to the user guide and a features section highlighting capabilities such as speeding up Scala 2 compilation and optimizing macros.
website/pages · high confidence
Add Scala 2.13.18 support
The plugin now supports Scala 2.13.18 by adding a dedicated source directory for this version. This includes a new SettingsOps utility that exposes the statistics-enabled setting, allowing the profiler to correctly detect and handle statistics configuration in Scala 2.13.18.
plugin/src/main/scala-2.13.18 · high confidence
Added AbsolutePath and RelativePath utility classes
The profiledb module now includes new \AbsolutePath\ and \RelativePath\ value classes in the \ch.epfl.scala.profiledb.utils\ package. These utilities provide a structured way to handle file system paths, offering methods to resolve relative paths against a base, convert between absolute and relative representations, and perform basic file operations like checking if a path is a file or directory. This replaces or supplements previous ad-hoc path handling with a more robust, type-safe API for path manipulation within the tool.
profiledb/src/main/scala/ch.epfl.scala.profiledb/utils · high confidence
Added Scala version detection utilities for the plugin
The plugin now includes version-specific implementations of ScalaSettingsOps to distinguish between Scala 2.12 and 2.13 at runtime. This allows the profiler to correctly identify the active Scala version and apply appropriate settings or behaviors for each supported release.
plugin/src/main/scala-2.12, plugin/src/main/scala-2.13 · high confidence
Added case-app integration scaffolding for CLI command definitions and parsers
New files \Commands.scala\ and \Parsers.scala\ have been added to the \integrations\ module to define the structure for a \case-app\ based command-line interface. \Commands.scala\ establishes the command hierarchy (including Help, Autocomplete, Bsp, Compile, Test, Console, and Run) and defines their options, while \Parsers.scala\ provides the necessary implicit parsers and default values to parse these commands. This change introduces the foundational code for integrating \case-app\ argument parsing within the profiling integrations layer.
integrations · high confidence
Initial implementation of ProfileDb for storing and retrieving profile data
This change introduces the core \ProfileDb\ component, which provides the ability to read and write profile database files using Protocol Buffers. It includes \ProfileDbPath\ for validating and constructing file paths with specific extensions and prefixes, ensuring data is stored in the correct location. Users can now persist profiling data to disk and retrieve it reliably, forming the foundation for subsequent features like flamegraph generation.
profiledb/src/main/scala/ch.epfl.scala.profiledb · high confidence
Initial sbt build infrastructure for scalac-profiling
The project now includes a complete sbt build definition (BuildPlugin.scala) that configures the scalac-profiling plugin, including publishing settings, license headers, and developer metadata. It introduces integration test support by pulling in external projects (better-files and wartremover) as source dependencies to verify plugin behavior. The build also defines custom sbt commands and keys for performance debugging, source compiler plugin options, and cross-building support, with sbt versions set to 1.13.0 for the main project and 1.9.9 for the project-level build.
project · high confidence
Initial website configuration and navigation structure
The website now includes a Docusaurus site configuration (siteConfig.js) and sidebar navigation (sidebars.json). Users can access the documentation via a 'Docs' link in the header, which leads to a sidebar organizing content into 'Usage' (motivation, installation, usage) and 'Plugins' (sbt-plugin) sections. The site is configured with Algolia search credentials, specific branding colors, and links to the project's GitHub repository.
website · high confidence
Initial website skeleton with footer and grid block components
The website core now includes a Footer component that displays site branding, documentation links (Installation, Usage), community links (Discord, Scala Users), and GitHub repository access, along with a GridBlock component that renders structured content blocks with configurable layouts (two, three, or four columns) and image alignment options.
website/core · high confidence
Initial website styling and performance visualization assets
The website now includes a custom CSS stylesheet that defines layout rules for headers, image alignment, and responsive breakpoints, as well as an interactive SVG flamegraph visualizing Scala implicit search performance with zoom and search capabilities.
website/static · high confidence
Introduce ProfileDB schema for storing compilation statistics
A new protobuf schema (profiledb.proto) defines the data model for the ProfileDB instance, enabling the storage of global and per-compilation-unit profiling statistics. The schema structures data around Database entries containing RunProfiles (with PhaseProfiles, Timers, and Counters) and CompilationUnitProfiles (tracking Macro and ImplicitSearch metrics), allowing the system to persist and retrieve detailed compilation performance data incrementally.
profiledb/src/main/protobuf · high confidence
Introduce Scala compiler profiling plugin with flamegraph and implicit search analysis
A new \scalac-profiling\ plugin has been added to instrument the Scala compiler for performance analysis. It introduces several command-line options to control data collection: \generate-global-flamegraph\ and \generate-macro-flamegraph\ create visual flamegraphs for implicit searches and macro expansions respectively; \generate-profiledb\ outputs structured profile data; and \show-profiles\ logs detailed statistics on macro and implicit search performance per call-site, file, and type. Users can also filter output using \print-search-result\ to inspect specific implicit search IDs, \print-failed-macro-implicits\ to see trees of failed candidates, and \show-concrete-implicit-tparams\ to display concrete type parameters in implicit flamegraphs. The plugin supports configuration of source and cross-target directories via \sourceroot\ and \cross-target\ options.
plugin/src/main/scala/ch/epfl/scala · high confidence
Introduce sbt-scalac-profiling plugin for compiler warmup and timing
Adds the \sbt-scalac-profiling\ plugin, which provides a \profilingWarmupCompiler\ task and a \warmupCompileFor\ command to warm up the Scala compiler for a specified duration. The plugin tracks compilation times using classloaders and scoped keys, allowing users to measure and optimize compiler startup performance within their sbt builds.
sbt-plugin/src/main · high confidence
New documentation generation and CLI integration infrastructure
This change introduces new components for the documentation generation tool and the CLI integration layer. It adds a \DependencyResolution\ utility in \docs-gen\ to resolve artifacts via Coursier, and a \Sonatype\ helper to fetch the latest release versions from Sonatype staging and release repositories. In the \integrations\ module, it adds \CliOptions\ and \CommonOptions\ for the \caseapp\ integration, defining command-line arguments and environment-specific settings. Additionally, the compiler plugin gains \ImplicitSearchDebugInfo\ to track implicit search firings and source files, and \ProfilingImpl\ is updated to register macro and analyzer plugins, aggregate macro and implicit profiling statistics, and generate flamegraph data for both macros and implicit searches.
repository · high confidence
Behavioural changes
Add Scala 2.13.17 support
The plugin now includes a dedicated source directory for Scala 2.13.17, containing a new SettingsOps utility that exposes the compiler's statistics-enabled setting, enabling the profiler to correctly query and respect statistics configuration for this specific Scala version.
(repo-wide) · high confidence
Added Scala 2.12.18-specific settings helper
A new \SettingsOps\ helper object was added to the Scala 2.12.18 plugin source directory to expose the \areStatisticsEnabled\ setting from the Scala compiler global, enabling the profiler to check if statistics collection is active for this specific compiler version.
plugin/src/main/scala-2.12.18, plugin/src/main/scala-2.13.14 · high confidence
Added Scala 2.13.15-specific settings operations
A new \SettingsOps\ utility object has been added for the Scala 2.13.15 toolchain, providing a method to check if statistics are enabled via the compiler's global settings.
plugin/src/main/scala-2.13.15 · high confidence
Automated documentation generation with dynamic Scala version lists
The documentation build process now automatically generates site variables for supported Scala 2.12 and 2.13 versions, sorting them in descending order to display the most recent versions first. This change introduces a new entry point in the docs-gen module that prepares these version lists and passes them to mdoc, ensuring the generated documentation always reflects the current set of cross-compiled Scala versions without manual updates.
docs-gen · high confidence
Refactor profiler internals with new logging and robust quantity access
The profiler plugin introduces a new Logger utility for structured debug and info output and replaces the previous method of accessing compiler statistics with a QuantitiesHijacker that safely retrieves registered quantities by falling back to method invocation if field access fails. These changes improve the reliability of internal data collection and provide better visibility into profiler operations.
plugin/src/main/scala/ch/epfl/scala/profilers · high confidence
Repository configuration and documentation overhaul
The repository has been restructured with new configuration files and documentation to improve developer experience and project clarity. A \.gitignore\ file was added to exclude build artifacts, IDE settings, and generated files. The \.scalafmt.conf\ was updated to version 3.11.5 with stricter formatting rules, including preserved trailing commas and specific docstring styles. A \.jvmopts\ file was introduced to set JVM memory and code cache limits for consistent builds. Documentation was significantly expanded: a new \HISTORICALCONTEXT.md\ details the project's origins and goals, \PROPOSAL.md\ outlines the original performance profiling proposal, and \IDEAS.md\ lists future optimization concepts. The \README.md\ was updated with installation instructions, maintenance status, and links to external resources. Additionally, a \.git-blame-ignore-revs\ file was created to ignore formatting commits, and a \.gitmodules\ file was added to include the FlameGraph submodule.
(repo-wide) · high confidence
Fixes
Add Scala 2.12.19-specific SettingsOps utility
A new SettingsOps object has been added for the Scala 2.12.19 plugin variant, providing a helper method to check if statistics are enabled via the compiler's global settings.
plugin/src/main/scala-2.12.19 · high confidence
Test coverage
Added sbt integration tests for compiler warmup profiling; Added shapeless HList test fixture for compiler profiling; Added test infrastructure and implicit resolution tests.
Dependencies
Added FlameGraph submodule
The repository now includes the FlameGraph tool as a Git submodule (commit 85f58b8), making it available for use within the project's external directory.
external · high confidence
Upgrade build infrastructure and update dependencies
The build system has been significantly restructured and updated. Key dependency upgrades include sbt-assembly to 2.4.1, sbt-ci-release to 1.12.1, sbt-scalafmt to 2.6.2, sbt-mdoc to 2.9.2, sbt-buildinfo to 0.13.2, sbt-git to 2.2.0, sbt-protoc to 1.0.8, sbt-ghpages to 0.10.0, junit to 4.13.2, junit-interface to 0.13.3, and pprint to 0.9.0. The project now supports Scala 2.12.18–2.12.21 and 2.13.14–2.13.18, replacing the previous limited version support. The build also introduces a new \profiledb\ module for handling profiling data and updates the main plugin to use \scala-compiler\ directly with improved cross-compilation settings.
(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 59 → 63 (+3.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 75 → 75 (+0.0)
- Architecture 94 → 94 (+0.0)
- Maturity 48 → 56 (+8.0)
- Readiness 56 → 60 (+3.7)
- Security 85 → 75 (-10.2)
Resolved (6)
- Duplicate intent across types: Both ProfilingSbtPlugin and ProfilingPluginImplementation expose identical lifecycle methods/properties (globalSettings, buildSettings, projectSettings) that return the same type (Seq[Setting[_]]). In an sbt plugin architecture, these methods typically serve the same purpose of registering settings, but their existence in two separate public types suggests redundant implementation or unclear ownership of the configuration logic.
- Inconsistent naming and intent for warmup configuration: BuildKeys defines keys for 'profilingWarmupDuration' and 'profilingWarmupCompiler', while BuildDefaults provides implementations for 'profilingWarmupCompiler', 'profilingWarmupDuration', and 'profilingWarmupCommand'. The presence of 'profilingWarmupCommand' in BuildDefaults but not in BuildKeys suggests a mismatch in what is considered a 'key' vs a 'default value'. Additionally, 'profilingWarmupCompiler' appears in both, but one is a key and the other is a task initialization, which is standard, but the naming 'WarmupCompiler' vs 'WarmupCommand' is ambiguous—are they related? The duplication of 'profilingWarmupCompiler' and 'profilingWarmupDuration' across keys and defaults is expected, but the addition of 'profilingWarmupCommand' only in defaults without a corresponding key in BuildKeys is inconsistent.
- Outdated: com.github.alexarchambault:case-app_2.12
- Outdated: com.lihaoyi:pprint_2.12
- Outdated: com.thesamet.scalapb:compilerplugin_2.12
- Outdated: io.get-coursier:interface
New (1)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
Changes since last survey
- 2 commits — 2 feature/other, 0 fixes
By area
- (repo) — 1 commit
- project/build.properties — 1 commit
Notable commits
- change: Merge pull request #278 from scala-steward/update/sbt-1.13.1
- change: Update sbt, scripted-plugin to 1.13.1
Architecture
- Unchanged — 0 containers · 2 contexts · 1 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
scalacenter/scalac-profiling 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 7 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 133d35bbba5f364a3bfb7f746ce41693ae58306a — 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-110e4fee044f.