pmo

pmoutils (0.2.5)

Published 2026-11-12 01:28:33 +01:00 by eric

Installation

[registries.forgejo]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true
cargo add pmoutils@0.2.5 --registry forgejo

About this package

Utilitaires système pour la gestion des adresses IP et des processus

pmoutils

Crates.io Docs.rs

Pmo Crates Docs.rs

Utilitaires système pour la gestion des adresses IP réseau et des processus.

Fonctionnalités

  • Gestion des adresses IP : Détection et listing des interfaces réseau
  • Surveillance des processus : Identification des processus utilisant un port spécifique
  • Informations système : Détection de l'OS et de sa version

Installation

Via Cargo (recommandé)

Ajoutez cette dépendance à votre Cargo.toml :

[dependencies]
pmoutils = "0.2"

Depuis la source

git clone https://github.com/coissac/pmo.git
cd pmo/pmoutils
cargo build --release

Documentation

La documentation complète est disponible sur docs.rs.

Gestion des adresses IP

use pmoutils::guess_local_ip;

// Devine l'adresse IPv4 locale utilisée pour les connexions sortantes
// (erreur s'il n'y a pas de route vers Internet : pas de repli sur 127.0.0.1)
let ip = guess_local_ip()?;
println!("Adresse IP locale: {}", ip);

// Liste les adresses IP non-loopback, dans la famille demandée (V4, V6 ou Both)
use pmoutils::ip_utils::{list_all_ips, IpFamily};

let ips = list_all_ips(IpFamily::V4)?;
for (interface, addresses) in &ips {
    println!("Interface {}: {:?}", interface, addresses);
}

Surveillance des processus

use pmoutils::{find_process_using_port, TransportProtocol};

// Trouve le processus qui écoute sur un port spécifique
let info = find_process_using_port(8080, TransportProtocol::Tcp);

if let Some(process_info) = info {
    println!("PID: {}", process_info.pid);
    println!("Nom: {}", process_info.process_name);
    println!("Propriétaire: {}", process_info.owner);
}

Informations système

use pmoutils::get_os_string;

// Obtient le nom et la version du système d'exploitation
let os_info = get_os_string();
println!("Système: {}", os_info); // Ex: "Linux/6.5.0" ou "macOS/15.1"

API

Modules

  • ip_utils : Utilitaires pour la gestion des adresses IP

    • guess_local_ip() → Devine l'IPv4 locale (io::Result<Ipv4Addr>)
    • list_all_ips(IpFamily) → Liste les IPs non-loopback par interface (io::Result)
    • IpFamily → Famille demandée : V4, V6 ou Both
  • process : Utilitaires pour la gestion des processus

    • find_process_using_port() → Trouve un processus par port
    • ProcessPortInfo → Structure contenant les informations du processus
    • TransportProtocol → Énumération TCP/UDP

Types : u32 pour les PID, u16 pour les ports, String pour les noms de processus et propriétaires (possédés). Une absence de résultat se rend par Option (find_process_using_port → Option<ProcessPortInfo>). Cibles : systèmes Unix (macOS, Linux) ; la lecture des sockets passe par netstat2, au support Windows limité ; la détection de l'OS est portable (os_info).

Fonctions publiques

  • get_os_string() → Retourne une chaîne décrivant l'OS et sa version

Exemples complets

Voir la documentation API pour plus d'exemples.

Platformes supportées

  • macOS (x86_64, ARM64)
  • Linux (x86_64, ARM64)
  • Windows (limité - certaines fonctionnalités peuvent ne pas être disponibles)

Développement

Prérequis

  • Rust 1.88+ (edition 2024 ; les if … && let … utilisés dans ip_utils.rs sont stables depuis la 1.88)
  • Cargo (inclus dans Rust)
  • Pour les cibles d'API et de release : cargo-public-api et cargo-semver-checks (cargo install cargo-public-api cargo-semver-checks --locked) ; pour make wiki : cargo-doc-md (cargo install cargo-doc-md --locked)

Compilation

cargo build --release

Tests

cargo test

Documentation locale

cargo doc --no-deps

Ouvrez target/doc/pmoutils/index.html dans votre navigateur.

Commandes du kit (make)

Les commandes de développement viennent du dépôt crate-kit (copie dans .crate-kit/, mise à jour par make kit-update ; ne pas modifier .crate-kit/ ici). make help les liste. Les principales :

Commande Effet
make ci fmt-check, clippy, tests, documentation
make api-level l'API publique a-t-elle changé depuis la dernière version ? (unchanged, additive, breaking)
make api-snapshot enregistre l'API de la version courante dans api/
make wiki publie la documentation de l'API dans le wiki Forgejo (DRY_RUN=1 : sans push)
make jjrelease version déduite de l'API, instantané, notes, push, tag, publication, wiki

Le numéro de version suit l'API publique : en 0.x une rupture passe à 0.y+1.0, sinon patch ; dès 1.0, une rupture passe à x+1.0.0, un ajout à x.y+1.0, sinon patch.

Dépendances

  • if-addrs : Détection des adresses d'interfaces réseau
  • os_info : Détection multiplateforme de l'OS
  • netstat2 : Mapping des sockets et processus
  • sysinfo : Informations système et processus
  • users : Résolution des utilisateurs par UID

License

Ce logiciel est régi par la licence CeCILL version 2.1.

Ce logiciel est un programme informatique servant à la gestion des adresses IP réseau et des processus système. Il est distribué sous la licence CeCILL telle que publiée par le CEA, le CNRS et l'INRIA.

Vous pouvez utiliser, modifier et/ou redistribuer ce programme sous les termes de la licence CeCILL telle que publiée par CEA, CNRS et INRIA à l'adresse suivante : https://cecill.info

See the LICENSE file for the full license text.

Dependencies

ID Version
if-addrs ^0.15
netstat2 ^0.11
os_info ^3.15
sysinfo ^0.40
users ^0.11

Keywords

network ip process system
Details
Cargo
2026-11-12 01:28:33 +01:00
1
CECILL-2.1
725 KiB
Assets (1)
Versions (11) View all
0.2.7 2026-11-14
0.2.6 2026-11-12
0.2.5 2026-11-12
0.2.4 2026-11-08
0.2.3 2026-11-08