ytti/oxidized
55.4
Adequate · 14 November 2026
13.1k
lines of production code
Ruby
primary language
5
measurements over time
What this system is
Features
Add --support diagnostic command with sensitive data redaction
Users can now run the new --support option to generate a comprehensive system diagnostic report. This output includes the Oxidized version, OS details, Ruby environment, installed gems, and Rugged SSH support status. Crucially, the command automatically redacts sensitive information from environment variables (such as passwords, tokens, and keys) and configuration files before printing, helping users safely share diagnostics for troubleshooting.
lib/oxidized/cli · high confidence
Add CLI entry point and interactive console script
The bin directory now includes a new executable script (bin/oxidized) that serves as the primary command-line interface, instantiating and running the Oxidized::CLI class while handling errors by warning the user and exiting with a non-zero status code if debug mode is disabled. Additionally, a bin/console script has been added to facilitate interactive development by loading the library and starting a Pry session.
bin · high confidence
Add configurable node execution statistics tracking
A new stats module has been added to the Node component to track job execution history, including start/end times, duration, and success/failure counts. The history size is configurable via the application config (defaulting to 10 entries), and modification times are now recorded to reflect the last update.
lib/oxidized/node · high confidence
Add device models for ACME Packet, A10 ACOS, Cisco ACE, AddPack, Adtran, ADVA, Accedian, AireOS, Airfiber, AirOS, Alteon, Alvarion, AOS, AOS7, ArubaOS-CX, and AOSW
New configuration backup models have been added for a wide range of network and security devices, including ACME Packet, A10 ACOS, Cisco ACE, AddPack, Adtran, ADVA, Accedian, Cisco AireOS, Ubiquiti Airfiber and AirOS, Alteon, Alvarion, Alcatel-Lucent AOS and AOS7, ArubaOS-CX, and Aruba AOSW. These models define the specific prompts, commands, and secret-filtering rules required to successfully collect and sanitize configurations from these platforms.
lib/oxidized/model · high confidence
Initial release of the hook notification system
Introduces a new extensible hook framework that allows Oxidized to trigger external actions upon configuration changes. The initial set of supported hooks includes SlackDiff for posting colorized diffs to Slack channels, CiscoSparkDiff for Cisco Spark notifications, XMPPDiff for XMPP Multi-User Chat alerts, AwsSns for publishing messages to AWS SNS topics, GithubRepo for pushing configuration changes to remote Git repositories, and Exec for running arbitrary external commands with configurable timeouts and environment variables.
lib/oxidized/hook · high confidence
New example hooks for dynamic model and IP mapping
Added three example Ruby hooks in the \extra/hooks\ directory that demonstrate how to use the \source\_node\_transform\ event to modify node attributes before configuration retrieval. \modelrules.rb\ provides a basic example of overriding a device's model based on vendor and group. \modelrulesadvanced.rb\ offers a more flexible, generic implementation that matches rules against any mapped node field (such as name, IP, or vendor) to dynamically assign models. \srcipmap.rb\ illustrates how to override a node's IP address based on specific attributes like role. These files serve as templates for users to customize node data handling.
extra/hooks · high confidence
New operational scripts and deployment examples for Oxidized
This update adds a collection of utility scripts and configuration examples to the 'extra' directory to support common operational tasks and deployment patterns. Key additions include a syslog monitor (extra/syslog.rb) that listens for configuration change events from network devices and triggers updates via the REST API, and a Nagios check script (extra/nagios\_check\_failing\_nodes.rb) for monitoring backup health with critical, warning, and OK statuses. For version control integration, new hooks are provided: gitdiff-msteams.sh posts configuration diffs to Microsoft Teams webhooks, and oxidized-report-git-commits emails git diffs for configuration changes. Additionally, a device2yaml.rb script is introduced to simulate device interactions for model testing, and an auto-reload-config.runit script enables automatic configuration reloading. The update also includes deployment examples for systemd, upstart, runit, supervisord, init.d, and reverse proxies (Nginx, Apache, HAProxy), along with logrotate and CA certificate update helpers.
extra · high confidence
Output subsystem refactored with new GitCrypt and HTTP outputs
The output subsystem has been restructured to support new output types and improve existing ones. A new GitCrypt output plugin was added, enabling encrypted configuration storage in Git repositories using the git-crypt tool. An HTTP output plugin was introduced, allowing configurations to be pushed to remote web APIs via POST requests, with support for SSL verification and custom headers. The existing Git output was migrated from the Grit library to Rugged for better performance and stability, and the File output was refactored to support group-based directory structures and cleaning of obsolete node configurations. The base Output class now uses SemanticLogger for logging and provides a standardized interface for all output plugins.
lib/oxidized/output · high confidence
Behavioural changes
Introduces String refinements and migrates to SemanticLogger
The library now includes a new \lib/refinements.rb\ module that adds string manipulation methods (\cut\_tail\, \cut\_head\, \cut\_both\, \keep\_lines\, \reject\_lines\) and command processing helpers to the \String\ class via Ruby refinements. Additionally, the core \lib/oxidized.rb\ file has been updated to require and include \SemanticLogger\, replacing the previous custom logging implementation with a standardized logging framework, while also removing the obsolete \lib/tst\ test script.
lib · high confidence
Oxidized 0.37.0: Hook system, SemanticLogger, and configurable job scheduling
This release upgrades the logging infrastructure to SemanticLogger, enabling flexible appenders (file, syslog, stderr) and signal-based log-level changes, while deprecating the legacy 'log' and 'use\_syslog' config keys. A new extensible Hook system allows users to register callbacks for events like node\_success, node\_fail, post\_store, and source\_node\_transform. Job scheduling is now more robust with configurable thread limits (use\_max\_threads), a rolling average for duration estimation, and a timelimit per job to prevent hangs. The CLI gains a --support diagnostic flag, and the node resolution logic now supports IP addresses with netmasks and configurable DNS resolution.
lib/oxidized · high confidence
Refactored configuration variable resolution and removed legacy bootstrap logic
The configuration system now uses a dedicated \lib/oxidized/config/vars.rb\ module to handle variable lookups, implementing a specific precedence order (node, group-model, group, model, global) and explicitly ignoring nil values during resolution. This change accompanies the removal of the legacy \bootstrap.rb\ and \core.rb\ files, which previously handled configuration loading via OpenStruct and YAML, indicating a shift in how the application initializes and persists its settings.
lib/oxidized/config · high confidence
Refactored input modules with shared base classes and new debug logging
The input modules have been restructured to improve code reuse and debugging capabilities. SSH and SCP inputs now inherit from a new SSHBase class, which centralizes connection logic, proxy support, and SSH-specific options (such as key exchange, encryption, and host key verification). A new Exec input allows running arbitrary shell commands, while FTP and TFTP inputs are implemented as standalone classes. The CLI input module now provides a generic login mechanism that handles username and password prompts, supporting both regex-based detection and block-based post-login/pre-logout hooks. Additionally, new DebugText and DebugYAML classes enable detailed I/O logging for troubleshooting, writing session data to text or YAML files in the debug directory.
lib/oxidized/input · high confidence
Source modules refactored to support node variables, GPG decryption, and regexp mapping
The source modules (CSV, SQL, JSONFile, and the new HTTP source) have been refactored to support node-specific variables via a new \vars\_map\ configuration option, allowing dynamic values to be interpolated into node data. GPG decryption is now supported for CSV and JSONFile sources when the \gpg\ config option is enabled, with decrypted content handled via a unified \open\_file\ method. Model and group mapping now supports regular expressions in addition to exact string matches, enabling more flexible node classification. The HTTP source adds pagination support, configurable read timeouts, and basic authentication. These changes improve flexibility and security for node discovery and configuration management.
lib/oxidized/source · high confidence
Test coverage
Added test coverage for config vars, SSH/SCP inputs, and HTTP input; Added test coverage for file and git output plugins; Added unit tests for source configuration validation and features; Added unit tests for the GitHubRepo hook; Expanded model unit tests and ATOMS framework; Initial test suite for Oxidized core components; Updated environment variable stubbing in CLI support tests for Ruby 4.1+ compatibility.
Dependencies
Migrate to gemspec-based dependency management and update runtime requirements
The project has replaced the explicit Gemfile with a gemspec-driven approach, consolidating dependency declarations into oxidized.gemspec. This change updates the minimum supported Ruby version to 3.0 and significantly refreshes the dependency tree: it removes legacy gems like grit, sqlite3, and rspec, while adding modern runtime dependencies such as net-ssh (\~\> 7.3), rugged (\~\> 1.6), and asetus (\~\> 0.4). Development dependencies have also been updated to include newer versions of rubocop, minitest, and mocha, ensuring compatibility with current Ruby ecosystems.
(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 57 → 55 (-1.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 53 → 50 (-2.8)
- Architecture 86 → 98 (+11.6)
- Maturity 55 → 58 (+2.1)
- Readiness 75 → 75 (+0.0)
- Security 53 → 51 (-2.5)
Resolved (11)
- Off-boarding risk: anonymized user #1
- Orphaned file (extra/syslog.rb)
- Orphaned file (lib/oxidized/model/asa.rb)
- Orphaned file (lib/oxidized/model/awplus.rb)
- Orphaned file (lib/oxidized/model/ciscosmb.rb)
- Orphaned file (lib/oxidized/model/procurve.rb)
- Projects may be oversized for their cohesion
- Rotate the exposed credentials — git history can't be un-committed
- Secret: password-hash-credential (examples/device-simulation/yaml/opnsense_nano_23.7.yaml)
- Secret: password-hash-credential (examples/device-simulation/yaml/opnsense_nano_23.7.yaml)
- Secret: password-hash-credential (examples/device-simulation/yaml/pfSense_CE_2.7.2.yaml)
New (10)
- Edited copy of a member (15 corresponding lines) (lib/oxidized/output/git.rb)
- Edited copy of a member (15 corresponding lines) (lib/oxidized/source/csv.rb)
- Edited copy of a member (26 corresponding lines) (lib/oxidized/output/git.rb)
- Edited copy of a member (27 corresponding lines) (lib/oxidized/source/csv.rb)
- Edited copy of a member (30 corresponding lines) (lib/oxidized/hook/ciscosparkdiff.rb)
- Hotspot: lib/oxidized/input/sshbase.rb (lib/oxidized/input/sshbase.rb)
- No ADRs found (oxidized.gemspec)
- Off-boarding risk: anonymized user #1
- SSHBase.make_ssh_opts (cognitive 16) (lib/oxidized/input/sshbase.rb)
- SSHBase.make_ssh_opts (cyclomatic 16) (lib/oxidized/input/sshbase.rb)
Changes since last survey
- 66 commits — 58 feature/other, 8 fixes
By area
- (repo) — 23 commits
- (root) — 19 commits
- lib/oxidized — 8 commits
- spec/model — 8 commits
- .github/workflows — 5 commits
- .github/PULL_REQUEST_TEMPLATE.md — 1 commit
- docs/Release.md — 1 commit
- docs/Ruby-API.md — 1 commit
Notable commits
- fix: Fix CHANGELOG.md
- fix: Fix fil permissions
- fix: Merge branch 'master' into fix/PR-3964-skipped-test
- fix: Merge pull request #3952 from ytti/fix/3922-junos-virtual-chassis
- fix: Merge pull request #3961 from ytti/fix/3919-awplus-bell
- fix: Merge pull request #3962 from ytti/fix/fixed-ci-image
- fix: Merge pull request #3970 from ytti/fix/PR-3964-skipped-test
- fix: Merge pull request #3971 from ytti/fix/3958-vrp-significant-changes
- change: ATOMS: fail instead of skip when test data cannot be loaded
- change: Add examples to the Ruby API documentation
- change: Don't set proxy with an empty ssh_proxy
- change: Fix findings in the PR
- change: Make ssh invalid variables fail with a warning
- change: Merge branch 'master' into device2port
- change: Merge branch 'master' into lantronix-itmgos
- change: Merge pull request #3840 from thanegill/rstrip-procurve
- change: Merge pull request #3949 from ytti/dependabot/github_actions/master/github/codeql-action-4.39.1
- change: Merge pull request #3950 from ytti/dependabot/github_actions/master/docker/login-action-4.7.0
- change: Merge pull request #3951 from ytti/feat/garderos-hardware
- change: Merge pull request #3953 from ryanhoggpm/lantronix-itmgos
- …and 46 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
ytti/oxidized 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 52c7767f5381fd7ca68cb722cb916e5e2d2530d7 — 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-e1a3b69fc8ee.