bkeepers/dotenv
60.8
Adequate · 14 November 2026
699
lines of production code
Ruby
primary language
7
measurements over time
What this system is
Features
Add dotenv executable entry point
A new executable script has been added to the bin directory, serving as the entry point for the dotenv CLI. This script loads the Ruby environment and invokes the existing Dotenv::CLI class, allowing users to run the tool directly from the command line.
bin · high confidence
Support for shell command and variable substitution in dotenv values
The dotenv library now supports dynamic value substitution for both shell commands and environment variables within .env files. Users can now use syntax like \$(command)\ to execute shell commands and interpolate their output, as well as reference other variables (e.g., \https://$HOST\) with proper escaping and precedence handling. This enables more flexible configuration patterns where values are computed at load time.
lib/dotenv/substitutions · high confidence
Behavioural changes
Adopts StandardRB and updates project configuration files
The project has migrated from Rubocop to StandardRB for code style enforcement, reflected in the new .standard.yml configuration and updated Rakefile tasks. Additionally, the repository now includes a .gitignore with updated exclusions (e.g., .ruby-version, tmp, vendor), a Guardfile for automated test running, and an OWNERS file defining project maintainers.
(repo-wide) · high confidence
Major refactor of the dotenv library with new modular architecture
The library has been restructured into a modular architecture, introducing new classes such as a dedicated Parser, CLI, Diff, and LogSubscriber. The Rails integration is now handled by a new \Dotenv::Rails\ class (replacing the old \Dotenv::Railtie\), which supports environment-specific files, automatic ENV restoration in test suites, and logging of loaded variables. The CLI now supports an \--overwrite\ flag and template generation, while the core \Environment\ class now delegates parsing to the new \Parser\ class, allowing for more robust handling of variable substitution and line break modes.
lib/dotenv · high confidence
Refactor Dotenv API and add thread-safe modification
The Dotenv module was refactored to support multiple filenames, variable overwrite modes, and thread-safe environment modification. Users can now pass multiple files to \Dotenv.load\ and control overwrite behavior via the \overwrite\ option. A new \Dotenv.modify\ method was added to safely update ENV variables within a block using a monitor for thread safety. Additionally, \Dotenv.parse\ was introduced to allow custom processing of parsed environment variables, and the internal API was restructured to reduce duplication and improve clarity.
lib · medium confidence
Test coverage
Added benchmark scripts for parsing performance; Added comprehensive test coverage for CLI, parser, and Rails integration; Added test coverage for ENV variable restoration; Expanded test coverage for Dotenv load and overwrite behaviors; Updated test fixtures for .env file parsing.
Dependencies
Rails integration and Ruby version requirements updated
The dotenv-rails gem is now a separate package that depends on railties \>= 6.1, allowing Rails 6.1, 7.0, and 7.1 applications to use dotenv. The main dotenv gem now requires Ruby 3.0 or higher and includes metadata for changelog and funding links. Development dependencies have been updated to include rake, standard, and other testing tools.
(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 62 → 61 (-1.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 76 → 74 (-1.9)
- Architecture 69 → 69 (+0.0)
- Maturity 49 → 49 (+0.0)
- Readiness 76 → 76 (+0.0)
- Security 81 → 71 (-9.7)
- Performance 80 → 80 (+0.0)
Findings
- No change — the same findings as the prior survey.
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
bkeepers/dotenv 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 14 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 34156bf400cd67387fa6ed9f146778f6a2f5f743 — the exact code this score is about.
- Scored under rubric-2026.11.4 — 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.65+preprod-36d4cd83012f.