portforge 0.2.1

Modern cross-platform port inspector & manager for developers
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use portforge::models::*;
use portforge::scanner;

#[test]
fn test_sort_entries_by_port() {
    let mut entries = vec![
        create_entry(8080, "b-app", Status::Healthy),
        create_entry(3000, "a-app", Status::Unknown),
        create_entry(5000, "c-app", Status::Zombie),
    ];

    scanner::sort_entries(&mut entries, SortField::Port, SortDirection::Ascending);
    assert_eq!(entries[0].port, 3000);
    assert_eq!(entries[1].port, 5000);
    assert_eq!(entries[2].port, 8080);

    scanner::sort_entries(&mut entries, SortField::Port, SortDirection::Descending);
    assert_eq!(entries[0].port, 8080);
    assert_eq!(entries[2].port, 3000);
}

#[test]
fn test_sort_entries_by_status() {
    let mut entries = vec![
        create_entry(3000, "app1", Status::Healthy),
        create_entry(3001, "app2", Status::Zombie),
        create_entry(3002, "app3", Status::Unknown),
    ];

    scanner::sort_entries(&mut entries, SortField::Status, SortDirection::Ascending);
    // Zombie (0) < Unknown (3) < Healthy (4)
    assert_eq!(entries[0].status, Status::Zombie);
    assert_eq!(entries[2].status, Status::Healthy);
}

#[test]
fn test_sort_entries_by_process_name() {
    let mut entries = vec![
        create_entry(3000, "Zebra", Status::Healthy),
        create_entry(3001, "alpha", Status::Healthy),
        create_entry(3002, "Beta", Status::Healthy),
    ];

    scanner::sort_entries(&mut entries, SortField::Process, SortDirection::Ascending);
    assert_eq!(entries[0].process_name, "alpha");
    assert_eq!(entries[1].process_name, "Beta");
    assert_eq!(entries[2].process_name, "Zebra");
}

#[test]
fn test_sort_entries_by_memory() {
    let mut entries = vec![
        create_entry_with_mem(3000, "a", 100.0),
        create_entry_with_mem(3001, "b", 50.0),
        create_entry_with_mem(3002, "c", 200.0),
    ];

    scanner::sort_entries(&mut entries, SortField::Memory, SortDirection::Descending);
    assert_eq!(entries[0].port, 3002); // 200MB
    assert_eq!(entries[2].port, 3001); // 50MB
}

// ─── Helpers ───

fn create_entry(port: u16, name: &str, status: Status) -> PortEntry {
    PortEntry {
        port,
        protocol: Protocol::Tcp,
        pid: 1000 + port as u32,
        process_name: name.to_string(),
        command: String::new(),
        cwd: None,
        memory_mb: 50.0,
        cpu_percent: 1.0,
        uptime_secs: 100,
        project: None,
        docker: None,
        git: None,
        tunnel: None,
        status,
        health_check: None,
    }
}

fn create_entry_with_mem(port: u16, name: &str, mem: f64) -> PortEntry {
    let mut e = create_entry(port, name, Status::Healthy);
    e.memory_mb = mem;
    e
}

#[test]
fn test_sort_entries_by_cpu() {
    let mut entries = vec![
        create_entry(3000, "a", Status::Healthy),
        create_entry(3001, "b", Status::Healthy),
        create_entry(3002, "c", Status::Healthy),
    ];
    entries[0].cpu_percent = 10.0;
    entries[1].cpu_percent = 50.0;
    entries[2].cpu_percent = 30.0;

    scanner::sort_entries(&mut entries, SortField::Cpu, SortDirection::Descending);
    assert_eq!(entries[0].port, 3001); // 50%
    assert_eq!(entries[1].port, 3002); // 30%
    assert_eq!(entries[2].port, 3000); // 10%
}

#[test]
fn test_sort_entries_by_process_case_insensitive() {
    let mut entries = vec![
        create_entry(3000, "ZEBRA", Status::Healthy),
        create_entry(3001, "apple", Status::Healthy),
        create_entry(3002, "Banana", Status::Healthy),
    ];

    scanner::sort_entries(&mut entries, SortField::Process, SortDirection::Ascending);
    assert_eq!(entries[0].process_name, "apple");
    assert_eq!(entries[1].process_name, "Banana");
    assert_eq!(entries[2].process_name, "ZEBRA");
}

#[test]
fn test_sort_entries_empty_list() {
    let mut entries: Vec<PortEntry> = Vec::new();
    scanner::sort_entries(&mut entries, SortField::Port, SortDirection::Ascending);
    assert!(entries.is_empty());
}