debtmap 0.18.0

Code complexity and technical debt analyzer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Unified analysis module with pure core and effects-based orchestration.
//!
//! This module implements the "Pure Core, Imperative Shell" pattern:
//!
//! - **Pure computation modules** (`phases/`): No I/O, no progress reporting
//! - **Orchestration layer** (`orchestration.rs`): Effects-based composition
//! - **Options builder** (`options.rs`): Type-safe configuration
//!
//! # Module Organization
//!
//! ```text
//! unified_analysis/
//! ├── mod.rs              - This file, re-exports
//! ├── options.rs          - Configuration builder
//! ├── orchestration.rs    - Effects-based composition
//! └── phases/
//!     ├── call_graph.rs   - Pure call graph computation
//!     ├── file_analysis.rs - Pure file-level analysis
//!     ├── god_object.rs   - Pure god object detection
//!     ├── scoring.rs      - Pure debt scoring
//!     └── coverage.rs     - Coverage loading (I/O)
//! ```
//!
//! # Usage
//!
//! The main entry point is `perform_unified_analysis_with_options()` which
//! orchestrates all phases while maintaining backward compatibility.
//!
//! For new code, prefer using the pure functions directly from the `phases`
//! module for better testability.

pub mod options;
pub mod orchestration;
pub mod phases;

// Re-export options builder for convenient access
pub use options::{ConfigError, UnifiedAnalysisConfig, UnifiedAnalysisConfigBuilder};

// Re-export orchestration types
pub use orchestration::{AnalysisContext, AnalysisTimings};

// Re-export commonly used pure functions
pub use phases::call_graph::{
    CallGraphConfig, CallGraphEnrichmentResult, apply_trait_patterns, build_initial_call_graph,
    enrich_metrics_with_call_graph, find_test_only_functions, is_closure, is_test_function,
    is_trivial_function, should_process_metric,
};
pub use phases::coverage::{
    calculate_coverage_percent, get_overall_coverage, has_coverage_data, load_coverage_data,
    load_coverage_file,
};
pub use phases::file_analysis::{
    ProcessedFileData, aggregate_file_metrics, calculate_uncovered_lines, create_file_debt_item,
    detect_file_context, enhance_metrics_with_line_count, group_functions_by_file,
    process_file_metrics, should_include_file,
};
pub use phases::god_object::{
    analyze_file_git_context, calculate_god_object_risk, create_god_object_debt_item,
    create_god_object_recommendation, enrich_god_analysis_with_aggregates,
};
pub use phases::scoring::{
    PriorityConfig, ScoringWeights, calculate_average_complexity, calculate_total_complexity,
    create_debt_items_from_metric, create_function_mappings, metrics_to_purity_map,
    process_metrics_to_debt_items, setup_debt_aggregator,
};