fujiapple852/trippy
63.4
Adequate · 14 November 2026
28.9k
lines of production code
Rust
primary language
5
measurements over time
What this system is
Features
Add hello-world example using Trippy public API
A new hello-world example has been added to demonstrate the public API of the Trippy library. The example shows how to build and run a traceroute to a specified IP address (1.1.1.1) using the Builder pattern and print the results.
examples/hello-world · high confidence
Added toy-traceroute example
A new example application named 'toy-traceroute' has been added to demonstrate a basic traceroute implementation using the trippy core library. This example provides a simplified, BSD4.3-style traceroute tool for educational purposes, allowing users to trace network paths with configurable parameters such as TTL range, port, and interface.
examples/toy-traceroute · high confidence
New TUI frontend crate with customizable key bindings, columns, and theming
The \trippy-tui\ crate introduces a new terminal user interface that allows users to customize the application's appearance and interaction. Users can now configure a comprehensive set of keyboard shortcuts for navigation, settings, and privacy controls (such as \expand-privacy\ and \contract-privacy\), toggle the visibility and order of hops table columns (including new columns like ASN, DSCP, ECN, and NAT status), and apply detailed color themes to various UI components like the hops table, charts, and dialogs.
crates/trippy-tui/src/frontend · high confidence
New Trippy TUI application with comprehensive layout and visualization
This change introduces the \trippy-tui\ crate, providing a complete terminal user interface for the Trippy traceroute tool. The new TUI features a structured layout with a header (showing target, status, and clock), a body area that dynamically switches between a hops table, a ping history chart, a frequency histogram, and a geographic world map, and a footer for additional charts. It includes support for multiple trace targets via tabs, a navigable flow bar chart for visualizing individual trace flows, and an information bar displaying runtime configuration status (protocol, privacy, ASN lookup, etc.). The interface also features a blue screen of death for errors, a help dialog, and a detailed settings dialog with tabs for TUI, trace, DNS, GeoIP, bindings, theme, and column configuration.
crates/trippy-tui/src/frontend/render · high confidence
New report output formats in trippy-tui
The trippy-tui crate now includes a comprehensive set of report generators, allowing users to export trace data in multiple formats. New capabilities include CSV, JSON, DOT (graphviz), Markdown table, pretty table, flow listing, and silent (no-output) reports. The JSON report specifically includes start and end timestamps, NAT detection status, and TOS values for each hop, while the DOT report visualizes the network topology as a directed graph.
crates/trippy-tui/src/report · high confidence
New trippy-packet crate for network packet parsing and building
The \trippy-packet\ crate has been introduced to handle network packet wire format parsing and building. It provides structs and accessor methods for IP, ICMPv4, ICMPv6, IPv4, IPv6, UDP, TCP, and ICMP extension packets, along with checksum calculation functions for IPv4/IPv6 ICMP, UDP, and TCP. The implementation uses a \Buffer\ abstraction to manage mutable and immutable byte slices, ensuring network byte order (big-endian) is handled correctly while exposing host-byte-order accessors.
crates/trippy-packet · high confidence
New trippy-privilege crate for cross-platform privilege management
A new \trippy-privilege\ crate has been introduced to handle platform-specific privilege discovery and management for sending ICMP packets. It provides a \Privilege\ struct with methods to discover current privileges (\discover\), acquire necessary permissions (\acquire\_privileges\), and drop privileges (\drop\_privileges\). The implementation is cross-platform: on Linux, it manages \CAP\_NET\_RAW\ capabilities; on other Unix systems, it checks for root access; and on Windows, it verifies elevated process tokens. This change also includes updates to support \windows-sys@0.61.2\ and bumps the Minimum Supported Rust Version (MSRV) to 1.85 with an edition upgrade to 2024.
crates/trippy-privilege · high confidence
Trippy core library restructured with new public API and tracing capabilities
The \trippy-core\ crate has been refactored into a modular library with a new public API, introducing a \Builder\ for configuring tracers and exposing core types like \Tracer\, \State\, and \Round\. This update adds support for capturing DSCP and ECN values from probe responses, implements NAT detection for IPv4/UDP/Dublin strategy traces, and calculates forward and backward loss heuristics. The default initial sequence number for traces has changed to 33434, and the library now handles socket errors more gracefully to prevent crashes. Configuration options have been renamed, such as \tui-max-samples\ and \tui-max-flows\ becoming \max-samples\ and \max-flows\.
crates/trippy-core/src · high confidence
Removals
Removed placeholder main.rs entry point
The placeholder \src/main.rs\ file containing the default "Hello, world!" print statement has been removed from the source tree.
src · high confidence
Architecture
Trippy TUI application restructured into a dedicated crate
The Trippy TUI application has been reorganized into a new \crates/trippy-tui\ crate, consolidating the core application logic, configuration, and frontend rendering into a single, cohesive module. This change introduces a new entry point (\lib.rs\) that manages argument parsing, privilege handling, and action dispatching (such as printing themes, bindings, or shell completions). The \app.rs\ module now orchestrates the tracing lifecycle, including DNS resolution, GeoIP lookup initialization, and tracer spawning, while \frontend.rs\ handles the interactive terminal interface using \ratatui\. Additionally, the new structure includes dedicated modules for internationalization (\locale.rs\), GeoIP database parsing (\geoip.rs\), and report generation (\report.rs\), providing a cleaner separation of concerns for the TUI experience.
crates/trippy-tui/src · high confidence
Trippy restructured into a multi-crate workspace with a unified public API
The Trippy codebase has been split into multiple crates, introducing a new \trippy-tui\ crate for the terminal UI and a \trippy\ crate that serves as the main entry point and public API facade. The \trippy\ crate now re-exports core functionality (core, dns, privilege, packet) from their respective sub-crates, allowing users to depend on a single crate to access all features. The main binary simply delegates to \trippy\_tui::trippy()\, and a symlinked README ensures documentation consistency across the workspace.
crates/trippy · high confidence
Behavioural changes
DNS resolver configuration and resolution strategy overhaul
The DNS resolver now uses a dedicated \Config\ struct and \Builder\ to manage resolution settings, introducing a new \IpAddrFamily::System\ option that defaults to IPv4-then-IPv6 for non-system resolvers. The resolver supports multiple resolution methods (System, Resolv, Google, Cloudflare) and enforces a configurable time-to-live (TTL) for cached DNS entries. Additionally, the \DnsEntry\ type now exposes an iterator for resolved hostnames, and the underlying \dns-lookup\ dependency has been upgraded to version 3.0.1.
crates/trippy-dns · high confidence
New Ubuntu PPA build infrastructure targeting Resolute
The project now includes a dedicated \ubuntu-ppa\ directory containing the complete build system for Ubuntu Personal Package Archives. This replaces the previous Debian packaging setup and shifts the target distribution from Ubuntu Jammy/Noble to Resolute, utilizing Rust 1.88 for compilation. The new infrastructure includes a Dockerfile for reproducible builds, a \release.sh\ script that vendors dependencies to ensure offline builds, and standard Debian packaging files (control, rules, changelog) configured for the Resolute series.
ubuntu-ppa · high confidence
New localization infrastructure and sample config symlink
The TUI now uses a new in-tree localization system managed via a \locales.toml\ file and a \build.rs\ script, replacing the previous \rust-i18n\ dependency. This change introduces translation support for Traditional Chinese (zh-TW) and Japanese (ja) alongside existing languages, and adds a symlink for \trippy-config-sample.toml\ to simplify configuration distribution.
crates/trippy-tui · high confidence
Refactored network layer with new Channel abstraction and improved error handling
The network implementation in \crates/trippy-core/src/net\ has been restructured to replace the previous \TracerChannel\ with a new \Channel\ struct that manages probe dispatch and response reception for ICMP, UDP, and TCP protocols across IPv4 and IPv6. This change introduces dedicated configuration structs for IPv4 and IPv6, separating address and socket setup logic. Error handling has been refined to distinguish between \AddressInUse\ and \AddrNotAvailable\ conditions, and to prevent crashes on certain socket errors (such as double-close on Windows) by using a custom \ErrorKind\ and \ErrorMapper\ utility. Additionally, the code now supports setting TOS/TClass for IPv6 UDP probes and captures ICMP extensions (like MPLS labels) from probe responses.
crates/trippy-core/src/net · high confidence
Refactored network platform abstraction with cross-platform byte-order handling
The network platform implementation has been restructured into a modular, cross-platform abstraction. A new \byte\_order.rs\ module introduces runtime detection of IPv4 header byte-order requirements (host vs. network) for non-Linux Unix systems, ensuring correct packet construction across different OS versions. Platform-specific logic is now cleanly separated into \unix.rs\ and \windows.rs\, with the Windows implementation updated to use \socket2\ 0.6.0 and \windows-sys\ 0.61.2, including fixes for \WSARecvFrom\ flag handling and buffer safety. This refactoring improves reliability on Windows and ensures compatibility with diverse Unix-like systems by dynamically adapting to OS-specific socket behaviors.
crates/trippy-core/src/net/platform · high confidence
Trippy TUI configuration system restructured with expanded customization
The Trippy TUI configuration has been reorganized into a modular system within the \trippy-tui\ crate, introducing dedicated modules for bindings, columns, themes, and file parsing. Users can now customize keyboard shortcuts via the new \bindings\ configuration section, define the hops table columns using the \tui-custom-columns\ setting (which now supports additional columns like ASN, DSCP, ECN, and loss heuristics), and apply detailed color theming through the \theme\_colors\ section. Configuration files are read from standard locations including the XDG config directory (\$XDG\_CONFIG\_HOME/trippy/trippy.toml\), and all CLI options are now supported via environment variables.
crates/trippy-tui/src/config · high confidence
Test coverage
Added IPinfo sample database resources for testing; Added simulation-based integration tests for IPv4 and IPv6 tracing; Updated snapshot tests for CLI help, completions, and man page.
Dependencies
Trippy is restructured into a multi-crate workspace with optional feature flags
The project has been split from a single crate into a workspace containing \trippy-core\, \trippy-tui\, \trippy-dns\, \trippy-packet\, and \trippy-privilege\. The main \trippy\ binary crate now exposes optional features (\tui\, \core\, \privilege\, \dns\, \packet\) to allow users to build only the components they need, such as a headless library or a minimal TUI. The workspace also sets the Rust edition to 2024 and the MSRV to 1.88, and the binary is now explicitly named \trip\.
(dependencies) · high confidence
Housekeeping
Added spell-checking configuration and dictionary
A new spell-checking configuration file (.config/spellcheck.toml) and a custom dictionary (.config/trippy.dic) have been added to the project. This enables automated spelling checks for source code and documentation, ensuring consistency in technical terms and proper nouns specific to the Trippy application.
.config · 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 64 → 63 (-0.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 69 → 64 (-4.9)
- Architecture 90 → 90 (+0.1)
- Maturity 55 → 60 (+4.4)
- Readiness 74 → 73 (-0.8)
- Security 71 → 62 (-9.1)
Resolved (6)
- Change coupling: report.rs ↔ main.rs (crates/trippy-tui/src/report.rs)
- Duplicated block (10 lines × 2) (crates/trippy-core/src/net/ipv4.rs)
- Duplicated block (12 lines × 2) (crates/trippy-dns/src/lazy_resolver.rs)
- Duplicated block (7 lines × 3) (crates/trippy-dns/src/lazy_resolver.rs)
- Medium vulnerability: [GHSA redacted] (Cargo.lock)
- No ADRs found
New (82)
- Duplicated block (12 lines × 2) (crates/trippy-dns/src/lazy_resolver.rs)
- Duplicated block (17 lines × 2) (crates/trippy-core/src/net/ipv4.rs)
- Duplicated block (32 lines × 2) (crates/trippy-core/src/net/ipv4.rs)
- Duplicated block (7 lines × 3) (crates/trippy-dns/src/lazy_resolver.rs)
- Edited copies of one member (3 members, 12+ corresponding lines) (crates/trippy-core/src/net/platform/unix.rs)
- Edited copies of one member (3 members, 13+ corresponding lines) (crates/trippy-dns/src/lazy_resolver.rs)
- Edited copies of one member (4 members, 4+ corresponding lines) (crates/trippy-packet/src/icmp_extension.rs)
- Edited copy of a member (11 corresponding lines) (crates/trippy-core/src/net/platform/unix.rs)
- Edited copy of a member (11 corresponding lines) (crates/trippy-core/src/net/platform/windows.rs)
- Edited copy of a member (12 corresponding lines) (crates/trippy-core/src/net/ipv4.rs)
- Edited copy of a member (12 corresponding lines) (crates/trippy-tui/src/frontend/tui_app.rs)
- Edited copy of a member (13 corresponding lines) (crates/trippy-core/src/net/ipv4.rs)
- Edited copy of a member (13 corresponding lines) (crates/trippy-core/src/net/platform/unix.rs)
- Edited copy of a member (13 corresponding lines) (crates/trippy-core/src/net/platform/windows.rs)
- Edited copy of a member (13 corresponding lines) (crates/trippy-packet/src/tcp.rs)
- Edited copy of a member (13 corresponding lines) (crates/trippy-packet/src/udp.rs)
- Edited copy of a member (14 corresponding lines) (crates/trippy-core/src/net/ipv4.rs)
- Edited copy of a member (14 corresponding lines) (crates/trippy-core/src/net/ipv4.rs)
- Edited copy of a member (14 corresponding lines) (crates/trippy-tui/src/config/binding.rs)
- Edited copy of a member (14 corresponding lines) (crates/trippy-tui/src/frontend/tui_app.rs)
- …and 62 more
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- (root) — 9 commits
- examples/toy-traceroute — 1 commit
Notable commits
- change: chore: allow multiple hickory advisories
- change: chore: bump MSRV to 1.92 (#1917)
- change: chore: bump test-case from 3.4.0 to 3.4.1
- change: chore: bump tokio from 1.53.3 to 1.54.1
- change: chore: bump toml from 1.1.8+spec-1.1.0 to 1.2.1+spec-1.1.0
- change: chore: bump tun-rs from 2.8.13 to 2.8.18
- change: chore: clippy lints for Rust 1.100.0
- change: chore: update dependencies to latest semver compatible version
- change: chore: upgrade comfy-table to 8.0.1
- change: chore: upgrade maxminddb to 0.33.0
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
fujiapple852/trippy 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 2dd303a14f50b51e985abb1322d5090026b44f9b — 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.