pmoutils (0.2.0)
Installation
[registries.forgejo]
index = "sparse+ " # Sparse index
# index = " " # Git
[net]
git-fetch-with-cli = truecargo add pmoutils@0.2.0 --registry forgejoAbout this package
pmoutils
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 IPguess_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,V6ouBoth
-
process: Utilitaires pour la gestion des processusfind_process_using_port()→ Trouve un processus par portProcessPortInfo→ Structure contenant les informations du processusTransportProtocol→ Énumération TCP/UDP
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 dansip_utils.rssont stables depuis la 1.88) - Cargo (inclus dans Rust)
- Pour les cibles d'API et de release :
cargo-public-apietcargo-semver-checks(cargo install cargo-public-api cargo-semver-checks --locked) ; pourmake 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
get_if_addrs: Detection des adresses d'interfaces réseauos_info: Détection multiplateforme de l'OSnetstat2: Mapping des sockets et processussysinfo: Informations système et processususers: 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 |
|---|---|
| get_if_addrs | ^0.5.3 |
| netstat2 | ^0.11 |
| os_info | ^3.8 |
| sysinfo | ^0.30 |
| users | ^0.11 |